跳转到正文
生产环境文档契约 1.5.169
正在核对线上版本…

数据字段字典

查字段含义、业务口径、示例及对应代码。

查看授权范围内采集到的业务明细。税务包含申报主表及附表,发票包含票面及商品明细。

已开启旧版字段的渠道,请读取对应的旧版税务字典或旧版发票字典。

接口格式:默认格式已有接口对接可切换

新接入使用默认格式。已按 Compatible_V1 对接的系统选择“兼容旧接口”;两种接口的字段不同。

以下路径从响应 data 对象开始,省略最外层 data. 前缀。

正在读取字段资料…
如何获取这份数据授权选择 → 查询参数 → 完整读取

001、002、003 每条记录都是完整独立对象,直接读取字段和值,保留期间、单位和空值状态。

1. 创建授权

将以下采集范围加入授权请求,企业名称、税号及业务单号等必填项见创建授权。

{
  "collect_tax": true,
  "collect_invoice": false,
  "tax_data_types": [
    "ALL"
  ]
}

2. 采集完成后查询

POST /api/channel/data/tax/all
{
  "channelCode": "YOUR_CHANNEL",
  "channelOrderNo": "YOUR_BUSINESS_ORDER",
  "orderNo": "ORDER_QUERY_RETURNED_ID"
}

替换渠道与订单标识;使用 X-Channel-Key,启用签名时同时携带签名请求头。鉴权说明

3. 读取与校验

不传 pagination 时读取整包;大数据使用分页交付,并在完整保存、校验后确认接收。附表范围由授权及 additionalTables 决定。

示例用于说明结构,不代表真实企业数据。缺失、空值与数值 0 分别处理;SM4 订单先解密 JSON 信封。

文档契约 API 1.5.169