主题
税务完整业务对象
原生税务 ALL 的 001、002、003 均返回 tax-all-business.v3 完整独立对象。每条记录直接包含自身的业务字段和值,嵌套明细保留在当前对象内。接口地址和参数不变。
返回范围
| 接口 | 当前结构 |
|---|---|
/api/channel/data/tax/all | 按表名返回对象数组,按默认主表和所选附表交付 |
/api/channel/data/tax/standardTable | 企业名称与业务对象,30 个业务模块、391 个模块内字段及 2 个查询日期字段;只返回有记录的业务模块 |
/api/channel/data/tax/results | 按授权和请求组合返回 ALL / STANDARD;也支持 WORKER_RAW 原始文件索引 |
ALL 合同版本为 tax-all-business.v3,不需要请求版本参数。每条业务记录无需附加 schema,当前环境版本见环境与凭据。附表选择见创建授权。
授权中的 additionalTables 会进入本单采集计划。取数时可缩小到已采表种,不能借此追加未采表;需要新增采集范围时重新采集。STANDARD 没有模块筛选参数,仍以本单实际采到的来源加工。
直接读取完整记录
从接口响应的 data 开始,按 表名[记录下标].字段名 读取。例如缴款金额位于 data.taxCompanyPaymentRecordListDtoPageResult[0].paidAmount。
每个对象独立包含自身字段和值,不依赖公共属性、列顺序或其他对象还原。信用扣分明细保存在父信用对象的 creditDeductionRecords 中,每项直接包含 targetCode、targetName、targetDeduction 及来源实际存在的其他字段。
税务完整响应保留接口成功外壳与该订单全部业务对象;完整业务数据只有 data 内容。两份文件来自同一真实订单,按来源说明中的版本脱敏重建,并通过当前契约的结构校验;没有按最新代码重新回放原件。完整来源与覆盖说明见真实脱敏样例。
表单、期间和空值
001 基础业务、002 财务报表、003 纳税申报均直接交付完整对象。每条记录保留自身的所属期、表单、金额、单位及业务属性。通用表单对象中的 metadataFields 和 rows[].fields[] 也直接包含字段名称、值、类型及单位。
来源缺字段、明确 null、空字符串和真实零值是不同状态;不能互相替换,也不能补零。标识代码保留前导零,金额保留来源精度和量级,单位或币种缺失时不猜测。信用扣分字段的来源为 null 或空字符串时原样保留,不补造空列表。
财报不同期间、所得税主附表、一般与小规模增值税、当前与被更正申报分别保留。相同金额或项目名称不表示同一记录,不能重复累加,也不能据此删除记录。
通用表单的 documentId 标识当前对象;sourceLayoutId 和 fieldCodeScope 说明本对象局部字段的含义范围。这些标识随完整对象保留,读取值不需要关联其他记录。原件路径、文件定位与单元格坐标留在服务端。采集状态查看 selection 及订单/产品质量信息;空数组不表示企业没有相关业务。
历史交付与加工边界
新分页交付重组后仍为完整对象,分页传输和校验见税务分页交付。旧压缩交付返回 DELIVERY_SCHEMA_CHANGED;移除 deliveryId 和 cursor 后重新请求,服务端保留历史分片及哈希。
只有历史加工结果而没有原始表单时,接口明确返回加工错误,需从保留原件重新加工。不能把剔除旧字段后的空结果当成成功交付。
税务默认查询本年及前三年,具体范围以本单可信采集清单为准。全量保留原件回放不代表企业完整存续期;当前未接入采集的表种也不能通过空数组推定业务不存在。STANDARD 与 Compatible_V1 按各自合同读取。
字典和下载
- 字段字典与 ALL 字段 JSON、CSV列出同一合同中的完整 JSON 路径,包括对象内部的嵌套字段。业务目录包含 177 张表;有真实表头但暂无记录的表保留字段定义,无数据返回空数组。
- 生产 ALL 字典直接说明对象中的字段。
- 生产 OpenAPI列出当前响应及对象模型。
- 同一订单真实脱敏响应供接口解析与业务落库验证。
- 001、002、003 的字段覆盖资料见下载中心。字段样本覆盖清单逐表列出数量和缺样原因;此类逐字段资料可汇集多份真实原件,不应当成同一订单响应,其中的空数组也不能证明企业没有业务。
字段目录表示合同范围,不代表每个企业都有数据。原件回放结果、真实企业采集结果和示例覆盖范围分别核对。
通用表单中的 SOURCE_… 是 rows[].fields[].fieldCode 等字段的取值,用来区分当前表单内的原表栏位,不是对象的顶层属性名。读取时直接使用同一字段对象中的 fieldName、value、valueType、presence 和单位;字段字典中的接口路径与原表业务含义分别说明。