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

更新说明 ​

2026-10-23 · 门户 1.5.87 ​

同步测试、生产 API 1.5.169。订单查询补齐客户标题、说明和处理建议,保留旧接口业务字段及状态码;补充 HTTP 410、SM4、报告就绪及回调说明。接口参考、字段下载和示例同步更新;历史原件样本保留真实来源版本,不标为本次重新采集。

2026-10-19 · 门户 1.5.86 ​

按当前生产 API 1.5.162 修复接入文档与示例,网页、接口契约和下载同步生成。

  • 字段页按所选表显示采集要求;社保等附表同时生成授权与取数参数。
  • 标准字段显示模块编码和可复制的完整响应路径。
  • 标准完整响应改用单个历史批次按生产代码重建的脱敏数据,保留金额、期间及空值;逐字段样例独立标注。
  • 创建授权补齐配对的最小请求与默认响应,订单和产品查询补齐处理中、成功、部分可用及失败示例。
  • 跳转地址说明覆盖渠道非 HTTPS 开关;在线调用明确区分生产与测试,契约、请求地址和签名密钥随环境对应。

2026-10-19 · 门户 1.5.85 ​

优化首页标题、接入流程和功能入口,版本提示、卡片及次要按钮统一浅灰边框。继续提供 API 1.5.162 的接口参考、字段字典和下载资料。

2026-10-19 · 门户 1.5.84 ​

同步 API 1.5.162:纳税信用等级明确显示“未评级”时原样返回;有效值为 A、B、M、C、D、未评级。缺失、无效或冲突仍为空,不使用年度信用评价记录补值。字段字典、OpenAPI、示例说明及下载同步更新。

2026-10-18 · 门户 1.5.83 ​

按 API 1.5.161 的固定源码核对 22 个客户接口,并同步接口页、OpenAPI、字段字典、示例与下载。

  • 完整数据字典按原始报文排列数据表、字段和嵌套层级;未出现在主报文中的字段保留定义,并注明排序来源。
  • 纳税人基本信息补齐纳税信用等级,标准数据共 30 个模块、391 个模块字段和 2 个查询范围字段;响应结构示例复用已审阅字段值,缺失和暂不取值保持空值。
  • 补齐取消授权、附表未启用、发票快照未就绪、兼容协议顶层错误代码的定义,以及 RAW 文件内容类型、范围下载和大记录片段说明。
  • 快速接入统一测试环境,并分别说明产品可下载、数据质量和订单整体结果;Bruno、CSV、JSON、手册与 PDF 同步生成。

2026-10-18 · 门户 1.5.82 ​

标准数据“纳税人基本信息”新增“纳税信用等级”(NSXYDJ),取 001 文件“基本信息”中“资格类型”显示的等级。生产和测试字段字典、JSON、CSV、接口定义及示例同步至 API 1.5.161。

有效等级为 A、B、M、C、D;缺失、无效或冲突时为空,不使用年度信用评价记录补值。

2026-10-18 · 门户 1.5.81 ​

按生产平台 1.5.202、API 1.5.160 的实际源码重新核对 22 个接口、接入指南、字段字典、下载和授权手册。生产部署源码与本地固定提交逐文件比对,保持现有文档站架构。

  • 修正附表采集范围、结果复用、报告类型与失败状态,补充收入交叉核验和恢复方式。
  • 补齐订单资料说明、回调原始文件类型、异步处理错误和资料期限,纠正 HTML 下载的断点续传与摘要说明。
  • 统一 STANDARD 公开字典版本与响应边界;历史真实样例保留重建版本,明确本次契约结构校验范围。
  • Bruno 同时检查 HTTP 状态与业务结果,防止 success=false 被误判为成功;网页、接口契约和下载材料同步生成。

2026-10-18 · 门户 1.5.80 ​

统一全站页面宽度、标题、面板、按钮、输入框、表格与状态提示。接口参考和调试窗口使用简体中文,切换明暗主题保留已填写的调试参数;问题目录、字段筛选和下载提供一致的清空、加载和重试操作。

首页、指南、字段字典、下载和手册共用版本来源;生产与测试契约分别核对后同步至 API 1.5.160。创建授权链接移除已废弃的兼容请求参数,税务与发票数据的 Compatible_V1 继续保留。手册沿用来源文件完全相同的原始截图,保留拍摄日期和版本,并同步说明核对记录及 PDF。

2026-10-16 · 门户 1.5.77 ​

补齐旧版税务渠道的 37 个 DTO 数组及 699 个已定义字段,将说明同步到接口模型和下载字典,并提供真实脱敏记录片段。默认新版、旧版渠道及 Compatible_V1 分别按对应字段读取。

真实订单利润表的 SQJE 同时存在数值和字符串载体,接口定义、字段字典及下载说明同步保留原始类型,不再误标为只能是数字。

2026-10-16 · 门户 1.5.76 ​

同步 API 1.5.156 的财务报表表头处理与失败诊断定义。selection.tables 在失败时可带 errorCode、message,用于定位未映射表头或转换错误;原有成功字段不变。两套文档分别绑定实际运行环境,样例保留其真实来源版本。

2026-10-16 · 门户 1.5.75 ​

  • 使用生产、测试现有真实订单核对税务和发票 ALL、STANDARD,包含新版、旧版发票字段和 SM4 响应。
  • 接口页与字段字典共用税务字段说明,补齐欠税已缴税额、缴纳地点、来源字段及未限定类型的含义;缺失和 null 不补零。
  • 修正旧版发票渠道的响应模型,补齐来源、状态和作废、红冲等兼容字段;明确 invoice.flat-fields.v3.1 与默认 v4 的适用范围,字段示例下载同步中文说明、空值与约束。
  • 生产与测试环境同步 API 1.5.155 的税务 ALL 渠道字段切换说明;原始样例保留真实采集时点和版本,按页面环境选择对应文档。

2026-10-16 · 门户 1.5.74 ​

本次发布时生产与测试接口均为 API 1.5.154。门户版本表示文档发布版本,接口版本表示服务端契约;最新绑定关系见环境与凭据。以下记录按发布时点保留,旧版本数量不作为当前字段范围。

  • 全面核对 22 个客户接口及接入指南,统一两环境地址、鉴权、HTTP 与业务错误、产品就绪条件、报告和资料期限。
  • 修正回调幂等说明:完整 event_id 可包含 attempt_id,新执行批次须独立处理;同步 OpenAPI 回调模型和示例。
  • 补齐税务 STANDARD 查询日期、历史财表列含义、投资方与报表冲突、独立欠税记录及已恢复字段说明;不能确认的值为空,其他正常数据继续保留。
  • 同步发票 STANDARD 汇总准备状态、金额范围、普通分页和快照续读边界,明确旧版发票 ALL 渠道设置与 Compatible_V1 的区别。
  • 下载中心补齐两类 STANDARD 字典及 CSV、签名取数客户端、SM4 解密向量和税务分页重组工具,清理不属于当前 STANDARD 的原表入口及未交付占位。
  • 真实 ALL 样例、字段示例、接口结构示例分别说明来源;授权网页手册与 17 页 PDF 核对当前版本,保留原截图日期和演示边界。

2026-10-16 · 门户 1.5.72–1.5.73 ​

同步两环境 API 1.5.154 与平台 1.5.195;税务 STANDARD 增加 taxCollQryStartDate、taxCollQryEndDate。修复原件表头识别、字段取值及局部来源冲突,字段页与脱敏样例随契约同步。可确认的更正前申报号、月报上期金额、刚性负债比和注册币种正常返回,缺少可靠来源仍为空。

1.5.71 ​

  • 生产文档同步 API 1.5.152:税务 STANDARD 为 30 个模块、390 个业务字段,增加独立月报及财务附表附注对象;补齐所得税原表组合行的应补退税额。
  • 发票 STANDARD 保留 13 个加工汇总模块、175 个业务字段;未知金额按维度保留 null,可靠金额继续统计,榜单明确可确认交易范围,内部质量信息不进入公开对象。
  • 字段页面、JSON/CSV 下载和接口示例使用同一契约;新增财务字段提供真实脱敏项目行。测试文档继续对应 API 1.5.151,ALL 功能和真实样例保持。

1.5.70 ​

  • ALL 接口参考、字段字典与下载按环境对齐:生产 API 1.5.150、测试 API 1.5.151。测试版本仅增加渠道授权跳转配置,两环境外部接口及 ALL、STANDARD 业务定义一致。税务 v3、发票 v4 均提供真实脱敏数据重建的完整响应。
  • 新增同一订单的税务整包、发票首页和末页、组合结果与全量业务文件,公开样本来源、脱敏范围与校验值。
  • 清理旧列值展开说明;区分真实业务响应、传输状态示例和多原件字段覆盖资料。
  • 真实样例保留原始来源版本与校验值,不因测试环境升级改写来源记录。

2026-10-15 保留发票标准加工汇总字典 ​

发票 STANDARD 沿用 13 个加工汇总模块和 175 个业务字段,保留既有字段编码、路径、年度识别字段、主统计字段及兼容别名。月度前十客户和商品继续逐行返回,同月合计随行保留。仅从公开业务对象移除加工质量及技术元数据,来源定位和空值原因独立保存于内部审计;字段字典、下载示例和实际输出同步更新。

2026-10-15 清理内部兼容目录 ​

门户 1.5.63 从业务目录、字段字典、下载字段表和字段示例中移除内部兼容与预留分组,统一税务、发票及两环境的展示。真实空表定义保留;完整响应契约和底层兼容处理保持不变。

2026-10-15 完整表头与空值定义 ​

门户 1.5.61 同步 API 1.5.147:补齐全部真实原件中的年度信息、表头、页眉与页脚字段,修正真实空值类型。两环境接口定义、字段字典、下载字段表和示例同步;无数据仍返回空数组。

普通接口分页与发票格式 ​

门户 1.5.60 同步 API 1.5.146:发票完整数据默认返回 FLAT 平铺记录,普通接口使用 pageNum、pageSize 翻页;游标和分片包继续使用专用接口。字段字典、示例、下载与两环境接口参考同步更新。

2026-10-15 补齐空表对象定义 ​

字典站 1.5.59 同步 API 1.5.145:按真实表头补齐只有表头、没有记录的业务对象,接口定义、字段字典、下载字段表和示例保持一致;无数据返回空数组。

2026-10-15 精简示例值展示 ​

字典站 1.5.58 统一移除示例列中的样本说明与无样本提示,缺少示例时只显示“—”。

2026-10-15 精简字段字典下载区 ​

字典站 1.5.57 统一移除字段字典顶部的响应示例下载入口及其样本说明,保留字段表、字段示例和取数说明入口。

2026-10-15 精简数据表标题区 ​

字典站 1.5.56 统一移除各格式数据表标题下的对象说明、样本来源、记录数量及样本覆盖链接,标题区只显示表名与接口代码。

2026-10-15 字段目录分类切换 ​

字典站 1.5.55 将一级分类平铺为可切换按钮,选中后列出该分类的全部数据表,不再折叠或在目录内单独滚动。税务、发票的完整数据、标准数据及兼容协议统一使用此交互,搜索覆盖当前格式的全部分类与数据表。选择长目录末尾的数据表时,页面自动回到字段详情。

2026-10-14 字段目录分类与平铺导航 ​

字典站 1.5.54 将数据表目录改为常显的分类标题和表名列表,取消分类折叠。税务、发票的完整数据、标准数据及兼容协议统一整理业务分类与顺序,分类名称可直接搜索。字段、下载内容和 API 契约保持当前已验证版本。

2026-10-14 完整对象字典与下载补齐 ​

字典站 1.5.53 按实际 JSON 路径展示税务 ALL 全部 178 张合同数据表及嵌套字段,不再因当前样本为空而隐藏表,也不再用原表列编号替代接口属性。页面、JSON 字段目录和 CSV 字段表使用同一字段集合;原表业务说明单独标明对应关系。税务 STANDARD、发票完整和标准数据、两类兼容协议一并核对,补齐父容器、模块状态和分页字段。响应示例区分真实完整对象、结构示例和空值结构示例,逐表注明真实样本覆盖。废弃的旧字段表、投影视图和旧字段压缩资料从当前站点移除。API 保持 1.5.144,接口地址和参数不变。

2026-10-14 税务完整独立对象 ​

API 1.5.144:001、002、003 每条记录直接交付完整对象,嵌套明细在本对象内;移除 38 个被替代旧数组。接口地址和参数不变。读取方式见完整业务对象;字典展示与下载补齐见本页 1.5.53 说明。旧压缩分页交付返回 DELIVERY_SCHEMA_CHANGED,重新请求生成当前对象结构。

2026-10-14 兼容字段业务说明改写 ​

字典站 1.5.44 将全部 474 个兼容字段的业务含义改为面向业务人员的解释,说明这是什么、对应什么期间及应如何理解。原始列名和转换规则收纳到展开的取数说明中,CSV 增加独立业务含义列,JSON 与页面保持一致。

2026-10-14 兼容旧接口字段口径核对 ​

字典站 1.5.42 按当前兼容转换器逐项核对税务 430 个、发票 44 个字段。页面、JSON 和 CSV 同步补充来源、期间、单位、代码和空值规则,修正本期金额、年初余额、限改状态及发票票种等中文名称。

兼容分类完整列出 474 个字段及 4 个固定空数组节点;未填充字段明确标注,不因当前样本无值而隐藏。仅更新文档,不修改接口键、类型或实际取值,也不重建历史交付。详见兼容字段口径。

2026-10-13 税务历史结构 ​

此前的压缩业务表已由 API 1.5.144 完整对象取代,当前接入请按完整业务对象读取。历史文件保留为服务端证据,不作为当前接口定义。

2026-10-13 纳税申报字段与免税销售额 ​

API 1.5.136、字典站 1.5.14:纳税申报字段改为可靠原始取值,缺失日期且原始编号有效时保留记录;金额不加总、不反推,明确本期或累计。JMXSE 和 ZZSSBMX.MSXSE 统一说明为“免税销售额”。两环境字段字典、JSON/CSV、OpenAPI、完整样例与逐条缺失说明同步更新,详见纳税申报与免税销售额。

2026-10-12 企业投资方原始金额与字段补齐 ​

API 1.5.134、字典站 1.5.13:企业投资方信息新增投资方地址和国家或地区代码,共 19 个字段;业务文本统一为字符串或空值。STANDARD 和 ALL 的投资金额均停止按投资总额乘比例推算,缺失保留空值。样例展示两位投资方,投资金额为 null,并明确 tzzb 是比例。

2026年10月12日 ​

门户 1.5.12 同步两环境 API 1.5.133 的两张业务表修正:纳税人基本信息新增税务登记日期、注册资本单位与币种;人员信息支持同角色多人,人员业务主键随身份规则更新,刷新时应整体替换人员模块。字段字典、OpenAPI、JSON/CSV、说明和多人样例一并更新,详见两张表说明。各环境保留独立发布提交,当前版本见环境与凭据。

2026年10月9日 ​

门户 1.5.7 同步生产与测试的 API 1.5.128(a711f982),两环境契约独立生成,当前版本见环境与凭据。

  • 字段字典、接口参考、示例与下载中心统一支持环境选择;测试契约不再复制生产版本。
  • 同步8项申报更正字段说明和2项交易对手地区说明;本次已覆盖生产和测试。
  • 补齐8个税务滚动统计模块;业务模块32个,完整输出211个。目录数量直接从当前契约生成。
  • 修正创建授权文档的默认发票期间为本年度及前2年,补充两环境的渠道固定期限优先规则。
  • 发布前同时核对两环境在线版本、提交与字段文件;已打开页面需要的旧脚本与字段分片随发布保留。

2026年10月8日 ​

门户 1.5.4 同步 API 1.5.124 / Platform 1.5.157。测试与生产已部署同一平台提交 7726ca4ec2092b3c99b8fed290765378dd5412ee。可通过环境与凭据中的地址核对当前版本。

本次同步包含以下变化:

  • 原始 Excel 与兼容模式:补充票头保留、缺明细、主体无法确认和冻结分页规则。成功返回的 contentWarnings 必须与记录一起保存,不能把可读取解释成内容已核验。兼容字段说明
  • 税务字段:ALL 协议目录为 215 个数组,STANDARD 为 211 个模块。说明原表入库不完整的失败响应、现金流行次、投资者身份、违法违章状态和滚动期间的取值边界。税务说明
  • 发票字段:平铺字段版本为 invoice.flat-fields.v3.1,结构化版本保持 invoice.structured.v4。STANDARD 保留 13 个业务模块,SJZL 提供 78 项质量字段定义,补充单独列示航空基金等统计边界。发票说明
  • 授权使用手册:区分授权验证、采集、部分完成、待核验、报告生成和取消确认,同步网页与 PDF。使用手册
  • 接口与下载:OpenAPI、在线字段字典、JSON/CSV、请求示例和 Bruno 下载包由同一平台提交生成。下载中心

目录或字段数量表示协议范围,不表示每个企业都有数据,也不表示所有历史订单的每份原件均已重新验收。已有冻结交付和历史订单不会因本次文档发布自动重建。示例是构造数据;截图保留真实拍摄日期,不作为真实企业采集证明。

文档契约 API 1.5.169