快速入门

1 注册账户

访问平台门户首页，点击"注册"按钮，填写手机号和密码完成注册。

注册后自动获得免费试用套餐（15天有效期，每日50次查询，赠送300次开票）。

2 授权税号

在控制台 → 税号管理页面，提交纳税人识别号（税号）和企业名称进行授权申请。

需要填写税局登录账号和密码（用于自动登录税局系统），并上传授权文件。

管理员审核通过后，该税号即可用于开票、查询等操作。

3 配置 SMS 映射（可选）

税局登录时需要短信验证码。在控制台 → Webhook & SMS 页面，为已授权税号创建 SMS 映射。

系统会生成一个 SMS 接收 Token，将手机短信转发到平台后，系统自动提取验证码完成登录。

详见 SMS 映射配置。

4 创建 API Key

在控制台 → API Key 页面，创建生产环境或沙箱环境的 API Key。

生产 Key 前缀为 sk-live-，沙箱 Key 前缀为 sk-sandbox-。

详见 API Key 管理。

5 沙箱测试

使用沙箱 API Key 先进行接口测试，沙箱环境完全仿真，不调用税局引擎、不计费。

所有沙箱响应携带 "env": "sandbox" 标识。

详见 Sandbox 沙箱环境。

6 购买套餐

免费试用到期前，在套餐与订单页面购买正式套餐。

一期仅支持对公转账：下单后向平台收款账户汇款，管理员确认到账后套餐生效。

详见 套餐与订单。

7 调用开票接口

使用生产 API Key 调用 POST /open/v1/lzfpkj 开具蓝字发票。

接口为异步模式：提交后返回 task_id，通过 GET /open/v1/rwzt/{task_id} 查询任务状态。

详见 蓝字开票接口。

8 配置 Webhook 回调（可选）

在控制台 → Webhook & SMS 页面配置回调地址，开票任务完成后平台会主动推送结果。

详见 Webhook 配置。