跳转到正文

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

API 1.5.169 · 接入指南、接口参考与字段字典

当前适配版本

本站统一提供生产环境的字段和接口契约。税务完整数据使用独立业务对象,字段范围以当前字段字典为准。 字段目录、CSV 和 JSON 示例按同一生产契约生成。授权链接最长 15 天,接口按秒传入 1296000。 详见生产环境与凭据和完整业务对象。

环境文档契约源码提交契约下载线上核对
生产环境1.5.16907e96bed正在核对线上版本…

接口总览 ​

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

23 / 23

授权与订单

报告

税务数据

发票数据

大批量发票交付

接入路线 ​

mermaid
flowchart LR
  A[创建授权链接] --> B[用户在授权页登录税局]
  B --> C{采集}
  C -->|回调通知| D[保存结果]
  C -->|状态查询兜底| D
  D --> E[获取数据 / 下载报告]
  1. 创建授权 —— 服务端声明采集范围与输出类型,拿到 authorization_url。
  2. 引导用户 —— 前端直接跳转该地址,用户在平台授权页完成税局登录。
  3. 等待结果 —— 优先接收回调,未及时收到时按 15–30 秒轮询订单状态。
  4. 获取数据 —— 确认产品 SUCCEEDED 且 available=true 后取数。

先读哪一篇

第一次接入请按 快速开始 → 创建授权 → 回调通知 → 获取数据 的顺序阅读, 上线前对照检查清单逐项确认。 文中遇到不熟悉的词(幂等、验签、游标……),随时查术语对照表。

文档契约 API 1.5.169