税务发票数据开放平台客户 API 开发者文档

接口总览 ​

平台向渠道客户开放 17 个接口，按职责分为五组。点击任一接口进入它的独立参考页 （含完整 Schema、示例与在线调用）；接入流程见下方接入路线。

接入路线 ​

flowchart LR
  A[创建授权链接] --> B[用户在授权页登录税局]
  B --> C{采集}
  C -->|回调通知| D[结果落库]
  C -->|状态查询兜底| D
  D --> E[获取数据 / 下载报告]

1. 创建授权 —— 服务端声明采集范围与输出类型，拿到 authorization_url。
2. 引导用户 —— 前端直接跳转该地址，用户在平台授权页完成税局登录。
3. 等待结果 —— 优先接收回调，未及时收到时按 15–30 秒轮询订单状态。
4. 获取数据 —— 确认产品 SUCCEEDED 且 available=true 后取数。