税务发票数据开放平台

主题

生产环境文档契约 1.5.169
正在核对线上版本…
下载接口契约环境与版本

税务数据说明 ​

本页介绍税务 ALL 与 STANDARD 两种业务输出，来自同一次采集，用途不同。需要原始文件时，按授权选择 WORKER_RAW，见获取数据。

ALLSTANDARD
接口POST /api/channel/data/tax/allPOST /api/channel/data/tax/standardTable
返回结构tax-all-business.v3 完整对象tax-standard-business.v2 业务结构：企业名称 companyName 与业务对象 data
基础结构按表交付；每条记录直接包含自身字段和值30 个业务模块，另含 2 个查询日期字段
字段范围按当前字段目录及附表选择交付30 个模块内字段共 391 个，另含 2 个查询日期字段
语义保留业务原值、完整记录和嵌套明细平台加工后的标准化结构
成功业务码200200

原生 ALL 使用 tax-all-business.v3 完整业务对象。表单对象身份、局部字段含义、空值与单位的读取方式见 完整业务对象。实际环境版本以该环境的健康状态和发布清单为准，当前范围见环境与凭据。

STANDARD 的业务版本只用于字典和发布标识，不在响应中增加 schemaVersion 字段。

纳税人基本信息与人员信息 ​

API 1.5.161 新增纳税信用等级 NSXYDJ，取 001 文件“基本信息”sheet 的“资格类型”原文，例如“一般纳税人信用等级：B级”取 B。接受 A、B、M、C、D 和原件明确提供的“未评级”；来源缺失、无效或冲突时返回 null，不使用年度信用评价记录补值。

API 1.5.133 起，测试和生产按以下规则输出；完整表结构、字段类型和样例见字段字典。

模块结构与字段数规则
NSRJBXX 纳税人基本信息对象，21 个业务字段注册日期 ZCRQ 与税务登记日期 SWDJRQ 分开；缺失返回 null，不能相互替代。
RYXX 人员信息数组，每条 9 个业务字段同一角色可以返回多位人员；同一人兼任不同角色时分别返回。

注册资本 ZCZB 保留来源金额，不自动折算单位；币种见 ZCZBBZ。本次已移除 ZCZBDW，解释金额时以原表单位为准。

人员角色代码 RYLXDM："01" 法定代表人、"02" 财务负责人、"03" 办税人。 身份合并优先使用角色和未脱敏证件；证件缺失或脱敏时，只有姓名唯一匹配且其他信息不冲突才补充合并，否则保留独立记录。 同一明确身份的信息互相冲突仍会披露失败，不以多人支持掩盖来源冲突。人员快照按模块整体替换，不再对外提供内部业务编号。

生产完整样例包含两位办税人。 该结构示例用于说明模块和规则，部分字段已补充真实脱敏值，可能来自不同企业或期间，不是一家企业的完整采集结果。历史冻结交付不因文档发布自动重建。

纳税申报与免税销售额 ​

API 1.5.140 起，纳税申报数据采用以下已审阅口径；字段定义和下载以当前生产契约为准。

字段业务含义
SBBID 申报表种类代码用于区分申报表种类的代码。
ZSXM 征收项目本次申报的税种或税费种，现包括增值税、企业所得税、印花税、城建税、教育费附加、地方教育附加。
ZSXMDM 征收项目代码征收项目对应的分类代码。
SBRQ 申报日期向税务机关提交申报的日期。
SSSQQ 所属期起这笔业务所属期间的开始日期。
SSSQZ 所属期止这笔业务所属期间的结束日期。
YNSE 应纳税额增值税：同一申报的两个本期业务分栏相加，缺栏不当零，不含核定税额。所得税：预缴取本年累计，年报取年度金额。附加税：各税费种本期金额。印花税：取原始应纳税额，未提供则为空。
JMSE 减免税额增值税：减征栏两个本期分栏相加，不含本期免税额。所得税：预缴取本年累计，年报取年度金额。附加税：只取减免税费额，不含另列六税两费减征、抵免。印花税：原始值缺失则为空。
YJSJE 预缴税金额增值税取本期预缴：一般纳税人合计分次预缴和出口专用缴款书预缴，小规模合计两个业务分栏。所得税取原始预缴总额，注明本期或累计。已缴税额不替代；没有预缴原值则为空。
QBXSE 全部销售额增值税：本期各类销售额合计，不重复加其中项。所得税：预缴为本年累计营业收入减上期累计，首期直接取；年报为全年营业收入。附加税及印花税不填。缺少必要原值或存在重复疑问时为空。
YSXSSR 应税销售收入增值税：一般纳税人合计本期第1、5栏，小规模合计本期第1、4、7栏的适用分栏，不重复加发票子项；核定销售额不另加，两个本期核定税额均为零时正常取应税主栏，负数保留。所得税：同一期间明确需要缴税的收入明细相加，不含免税、不征税收入。月报、季报用本期累计减相邻上期累计；年初首期直接取累计，年报取全年。主表及部分附表已采到，但不足以确认全部收入的应税性质，留空。附加税及印花税不填。
SBQX 申报截止日期税局规定的最晚申报日期。无单独期限时查年度征期日历；示例为2025年第四季度的申报期限。
YBTSE 应补（退）税额只取原表唯一可靠的应补缴或应退税额；不等于实际缴款或退款。生产环境的 A200000 组合行，按原件勾选的实际利润额或上年平均额预缴方式取本期金额，即使金额列标题为累计；其他方法、不适用、缺失或冲突时为空。更正前原表的 YYBTSE 使用相同规则。
JMXSE 免税销售额增值税主表本期免税销售额，平台合计适用业务分栏；小规模合计货物劳务与服务栏，一般纳税人的即征即退格明确不适用时只取一般项目本月数。不重复加累计及其中项，必要原值缺失时为空；其他税种不适用。
BX 申报表型申报所用的表型，如一般纳税人申报表或小规模纳税人申报表。

金额为两位小数字符串或 null；缺失不填零，来源明确为零时才返回 0.00。内部业务编号不再对外展示。

税务 ALL ​

001、002、003 每条记录都是完整独立对象。顶层按表名返回数组，数组中的每条记录直接包含自身字段和值。地址和请求参数不变。

创建授权时，additionalTables 决定默认表以外本单需要采集的税务表种；取数时只可在已采范围内选择，省略时使用授权中的选择。追加未采表会返回 TABLES_NOT_COLLECTED_RECOLLECTION_REQUIRED，需要重新采集。STANDARD 不提供结果模块筛选，但也使用本次实际采集的来源，不能把未采附表加工出来。

读取结构 ​

直接读取 data.表名[记录下标].字段名。期间、申报标识、金额、单位、状态和原表说明保留在相应记录中；嵌套明细直接读取对象或对象列表，无需解析列值或引用其他记录。

缴款读取 taxCompanyPaymentRecordListDtoPageResult，信用扣分明细读取父信用对象的 creditDeductionRecords。来源缺字段、null、空字符串、真实零值分别保留，不补零。

完整规则见完整业务对象。下载税务完整响应、完整业务数据和字段字典。响应来自同一真实订单保留资料，经脱敏并按来源版本重建，通过当前契约的结构校验；没有按最新代码重新回放原件，也不是重新采集后的线上响应。来源和覆盖范围见真实脱敏样例。

申报与人员字段 ​

企业扩展信息、申报经办信息仍保留独有业务内容，例如核算方式、人员电话与邮箱、声明人、经办人及证件、银行账号、代理机构、受理人员及日期。 一般纳税人的“是否代理申报”与小规模的“是否自行申报”保留各自语义，不互相取反推导。 期间费用保留销售、管理、财务费用及对应境外支付金额，明确存在的空业务行、文字、零和负数均保留。

申报更正仅保留有明确更正证据的业务记录。更正前日期、金额或历史次数缺失时保持原空值，不使用当前申报值替代。 社保、税务变更、稽查和银税互动等表种是否取得，须按本地区、本次订单的采集证据核对。目录已定义某表不表示本单已采集，空数组不能解释为企业没有相关记录。

兼容与历史交付 ​

渠道开启“旧版税务 ALL 字段”后，同一接口返回 tax-all-legacy.v1 的原 DTO 数组，对已有和新建订单均生效。使用旧版字段字典和接口中的 TaxAllLegacyData 模型；真实记录片段展示原字段及取值。默认字段页展示新版完整对象，不能用于解析旧版；切换后从首页重新取数。STANDARD 不受此开关影响。

resultFormat=Compatible_V1 仍按兼容格式读取。STANDARD 按本页业务字段结构读取。 新建分页交付重组后仍为完整对象。旧压缩交付返回 DELIVERY_SCHEMA_CHANGED，移除 deliveryId 与 cursor 后重新请求。历史分片保留，不原地修改。 采集质量继续查看订单/产品的 qualityStatus、qualityIssues、dataQuality 和 selection，完整对象结构不改变质量结论。

原始 Excel 转标准字段的边界 ​

  • 原件可读取但入库记录缺失时，接口返回业务码 60002、data: null，错误信息列出不完整的工作表及预期、实际记录数。应从保留原件恢复入库后重试，不能保存为空成功结果。
  • 现金流量表不同活动段可能使用相同的“小计”名称，按原始行次和所属活动段匹配；同名不代表同一项目。
  • 投资者的可见证件片段不同时保留独立身份；姓名相同或证件部分脱敏不足以证明同一人。来源冲突须保留问题状态，不擅自合并。
  • 违法违章的处理状态、状态代码和案件状态分别取值；缺少案件状态时不从处理状态推断结案。
  • 滚动统计以实际采集时间及已证明的查询覆盖为依据；部分年度覆盖不足不影响其他完整年度的独立结论。缺失、待核验与真实零值须分开读取。

字段目录说明的是合同范围，真实版式覆盖见采集与历史交付边界。采集质量通过订单及产品的质量信息核对；STANDARD 中未返回某个模块，不代表企业没有该类业务。

税务 STANDARD ​

请求与响应外层 ​

请求不提供模块筛选参数。接口成功信封的 data 中仅包含企业名称和业务对象：

json
{
  "companyName": "示例企业",
  "data": {
    "taxCollQryStartDate": null,
    "taxCollQryEndDate": null
  }
}

data 固定包含两个可空查询日期字段，另外只包含本次有记录的业务模块。NSRJBXX 是对象，其他模块是对象数组；不返回空模块占位。字段名使用现有编码，金额、期间、单位、企业信息及记录内的 null、空数组和真实零值按原值保留。

完整示例见标准数据 JSON。字段字典中的示例用于说明每个字段，可以来自不同企业或期间。

业务模块 ​

业务字段名称统一使用拼音大写缩写，协议级字段保留英文驼峰命名。

代码模块
NSRJBXX纳税人基本信息
RYXX人员信息
TZFXX企业投资方信息
NSSBXX纳税申报数据
JKXX缴款信息
QSXX当前欠税信息
SBGZ申报更正
NSXYDJLS纳税信用等级历史
SSWFWZXX税收违法违章信息
LRBNB利润表年报
LRBJB利润表季报
ZCFZBNB资产负债表年报
ZCFZBJB资产负债表季报
XJLLBNB现金流量表年报
XJLLBJB现金流量表季报
LRBYB利润表月报
ZCFZBYB资产负债表月报
XJLLBYB现金流量表月报
CWFZMX财务附表及附注明细
MYSJSEHJ每月实缴税额合计
JDSJSETJ已缴税额按季度统计
QYCWZBXX企业财务指标
JQSWZB近期税务指标
LNSJSETJ历年实缴金额及变动率
ZYGD12YSJTB逐月滚动实缴同比
ZNGD12YSJTB逐年滚动实缴同比
J12YSJSEMX近12个月实缴明细
J12YZZSXSSRMX近12个月销售明细
J24YSJSEMX近24个月实缴明细
J24YZZSXSSRMX近24个月销售明细

近期与滚动统计按采集基准日计算完整月份，纳税额、实缴额、销售额分别遵循原字段税种和日期口径。近12／24个月实缴明细按缴款日期读取增值税及企业所得税；销售明细按完整所属期读取增值税主表本期全部销售额。逐月滚动每次移动1个月，逐年滚动每次移动12个月；来源不足、分母为零或缺少可比期间时不推算同比。

当前标准字段字典展示 30 个业务模块、391 个模块内字段，另含 2 个查询日期字段。生产与测试使用同一字段契约，各自的凭据和数据隔离。原表业务数据通过 ALL 读取。

税务采集查询范围 ​

data.taxCollQryStartDate、data.taxCollQryEndDate 位于标准对象的 data 内、业务模块之前；完整响应路径为 data.data.taxCollQryStartDate 和 data.data.taxCollQryEndDate。日期格式为 YYYY-MM-DD，无法确认时返回 null。

只读取本次可信采集清单确认的年度查询范围，取起始年度 1 月 1 日与截止年度 12 月 31 日；不从业务明细最早／最晚日期、当天日期或滚动指标期间推算。范围合并不代表每个税种都查了相同期间，也不代表数据完整；本年截止日期可能晚于采集日。

财务期间与附注 ​

完整自然月报放入 LRBYB/ZCFZBYB/XJLLBYB，不归入季报。金额保留原单位；本月数、本期数、本年累计数分别读取原列，不能用累计差额或其他报表补造。期间无法确认时保留 null。

CWFZMX 保留权益表、附表及附注的业务项目；SZ 是对象数组，每项使用 LM 表示完整原列含义、Z 表示原业务值。空白与明确零分别保留，不跨列加总。查看新增财务模块真实脱敏样本，各模块可能来自不同企业。

原件冲突与可确认值 ​

当前取数按字段、期间和独立记录处理原件差异：

情形STANDARD 处理客户读取方式
同一投资方比例或地址互相冲突仅对应字段为 null；能确认的身份、比例及其他投资方保留不按姓名合并，也不把来源行数当作投资方数量
同期间财务报表存在不同版本有明确版本证据时按证据选择；无法判定的冲突金额为空，一致的值和其他期间保留不自行选最大值、最新文件或把两个版本相加
历史财表缺少金额列标题仅在官方表型、表代码和列布局可唯一确认时读取，否则金额为空不凭列位置猜本期、累计或上期
欠税记录缺少原始 ID保留可区分的独立原始记录，QSJLID 为空不伪造税局 ID；相同税种或期间不代表同一笔

这些规则不改写原始 ALL 和 Worker 文件；不能因为某个字段冲突就丢弃其他正常数据。需要追溯时用同一授权、job_id、attempt_id 的 ALL 和原件核对，不把不同批次混成一份结果。

已恢复的原始取值 ​

  • NSRJBXX.NSXYDJ：只取 001 基本信息“资格类型”中的纳税信用等级，允许 A、B、M、C、D 和原件明确提供的“未评级”。缺失、无效或相互冲突时为空；不使用 NSXYDJLS 年度信用评价记录补值。

  • SBGZ.GZQYWZJ：仅取原件明确的更正前申报记录号；不拿当前申报号、表代码或候选顺序代替。

  • LRBYB.SQJE：取原表明确的上期金额；若只明确金额而没有上期起止日期，金额保留，SQJEQJ 仍为空，不猜上月或上年同期。

  • QYCWZBXX.GXFZB：可靠期末短期借款、长期借款、应付债券、一年内到期非流动负债和租赁负债合计，占同期负债合计的百分数；必要科目无法确认或分母无效时为空。

  • NSRJBXX.ZCZBBZ：取原件明确币种；注册资本金额不在缺少单位证据时自行换算。

逐字段取数规则和已具备的脱敏样例见字段字典。当前样本没有非空值，只能说明样本未证明该值，不能据此删除字段或填零。

空值与缺少模块 ​

字段为 null 表示没有可靠取值，不能当作零。只有来源明确为零时才返回 0.00。 模块未返回时，需结合 ALL、原始资料和订单/产品质量信息核对是否缺少采集来源，不能据此认定企业没有相关业务。

几个模块的统计规则 ​

JKXX · 缴款信息

直接从 Worker RAW 加工，不经过 ALL 或 queryTaxInfo。 当前 Worker 按本年及前三年的范围，按「缴款日期」逐年分页查询， 并在税务采集清单中证明连续年度和返回记录数；服务端还会反查清单起始年度、 记录数和 RAW 缴款日期；必要来源不足时不补造缴款记录。

  • 缺失实缴金额不会被填成零。

最近四年范围不能当作企业完整存续历史；历史接口兼容样本不会自动扩大默认采集范围。 只有完整年度清单与记录数共同证明零记录时，才能认定该范围确实没有缴款。

QSXX · 欠税信息

从 Worker 当前欠税接口 RAW 生成，不合并历史欠税。 入库时要求清单条数与「欠税信息」RAW 行数完全一致。

  • QSJLID 只使用税局真实 ID；
  • YBTSE 只使用当前欠缴金额；
  • SKZL / YZPZLMC 分别表示税款种类和应征凭证种类；
  • 缺失字段保持 null。

NSRJBXX.DQSFQS 按欠税采集快照日判断，不按客户取数当天重新计算。只有可靠快照确认欠缴金额为正，且具体缴款期限早于快照日时为 true；期限当日不算逾期。完整查询证明所有记录均未逾期时为 false，证据不足或冲突时为 null。

仅有“欠税”“逾期”文字，缺少可靠金额、期限或快照日期，不能确认欠税；状态写“逾期”但期限尚未到达时也返回 null。明确的零金额、缺失金额和无记录须结合各自的状态及完整性证据判断，不能互相替换。

旧文件没有欠税工作表不能解释为「无欠税」。

SBGZ · 申报更正

只输出有明确更正证据的申报记录。

税局「申报更正与作废」页面首先返回的是可供用户选择处理的已申报表， 并不表示这些申报都发生过更正。新版 Worker 因此将该 RAW 明确命名为 「申报更正候选申报列表」，完整分页并继续入库，但候选来源缺失或查询不完整 不会阻断其他税务数据入库。

  • 没有更正次数或更正标志的候选行不会写入 SBGZ。
  • 候选列表的当前申报日期绝不冒充原申报日期。
  • 原件明确标记为「被更正申报表」、来源角色为历史更正表且原始更正类型一致时，读取历史增值税／所得税主表的原申报日期、税期及原金额，写入 SBGZ；历史表不并入当前申报和当前税额汇总。
  • 税局没有返回实际更正次数时，GZCS 保持 null；历史版本数和主附表数量不能替代更正次数，历史范围不完整时不补造更正次数。

只有候选列表而没有真实更正历史证明时，不生成更正记录。

组合获取 ​

POST /api/channel/data/tax/results 可组合返回已授权的 WORKER_RAW、ALL 和 STANDARD；以下请求只选择两种业务输出：

json
{
  "channelCode": "BANK",
  "channelOrderNo": "BANK-20260812-0001",
  "orderNo": "1e3f2f55-8da4-4ba9-b941-84860eb1d243",
  "taxDataTypes": ["ALL", "STANDARD"]
}

data 的键即请求的输出类型。下载仅请求 ALL 的组合完整响应，多输出请求规则见获取数据。

完整字段字典 ​

本页说明的是统计规则与数据边界。逐字段的类型、必填性与取值范围以交付包内的 税务 ALL / STANDARD 字段字典为准， 请求/响应 Schema 以接口参考为准。

企业投资方信息的来源口径 ​

TZFXX 为数组，业务字典展示 10 个字段：投资方名称、持股比例、证件类型代码和名称、证件号码、投资方经济性质代码和名称、国家或地区及代码、投资方地址。

  • ZGB 使用 0～100 的百分数，35 表示 35%。
  • TZFJJXZDM、GJDQDM 和 ZJLXDM 可查询对应字典，代码保留前导零。
  • 保留原始投资方记录，不按姓名随意合并。没有可靠来源的字段为空；页面逐字段示例可以来自不同企业或期间。

纳税申报金额与真实样例 ​

增值税应纳税额、减免税额和销售额按已确认的本期栏次读取，合并互不重复的业务分栏；YJSJE 只取原始预缴金额。企业所得税收入字段按上文逐字段规则读取，本期收入需要可靠的相邻累计端点；应纳税额等字段保留其已明确的累计或年度口径，不统一做差。不能确定的金额为 null，只有原件明确为零时返回 0.00。

利润表、资产负债表和现金流量表分别支持年度、季度与完整自然月，以及原件中出现的不同会计制度和表型；保留报表代码、实例、单位及金额期间含义。真实样例按字段脱敏展示，不把缺少原件或缺少可比期间当作零。

财税汇总与指标、缴款与销售明细已按全部现有真实资料核对。财务指标保留字段及缺少累计端点的所得税指标不填造数据。

文档契约 API 1.5.169

税务发票数据开放平台