1. 财云通平台数据接入接口
智能申报
  • 默认模块
    • 接口申报流程
      • 接口申报流程
    • 纯接口文件申报
      • 申报文件上传
    • 签名
      • 快速获取签名参数
    • 短信
      • 上传短信
      • 获取短信
      • 获取短信数量
    • 预填数据采集
      • 预填数据采集
      • 预填数据采集-回调参数
    • 税源
      • 房产税推送数据接口
      • 土地税推送数据接口
      • 房产税、土地税结果查询接口
      • 印花税合同
    • 科目余额
      • 科目余额表上传
    • 增值税
      • 其他扣税凭证
      • 进项增值税转出
      • 视同销售虚拟发票
    • 税费种核定
      • 采集认定
      • 采集认定查询
    • 工作底稿
      • 工作底稿数据上传接口说明
        • 工作底稿数据格式说明
        • 工作底稿数据加密和防篡改说明
      • 工作底稿数据结果查询接口说明
        • 工作底稿数据查询格式说明
      • 工作底稿数据上传接口
      • 工作底稿数据结果查接口(xml结构)
    • 申报结果
      • 申报清册
      • 申报清册通用接口
    • 申报资料
      • 凭证资料下载
    • 附录
      • 税种编码
      • 申报期限编码
      • 状态码信息
      • 申报状态
      • 扣款状态
      • 生成状态
      • 处理状态
      • 增量全量标识
      • 申报类型
      • 扣款类型
      • 报表简称
  • 财云通平台数据接入接口
    • 接口验签说明
    • 标准申报接口调用流程
    • 工作底稿进数流程
    • 数据接入类
      • 纳税申报数据接口
      • 工作底稿数据接口
      • 科目余额表上传接口(XML)
      • 科目余额表上传接口(JSON)
      • 进项增值税转出接口
      • 视同销售虚拟发票接口
      • 其他扣税凭证接口
      • 印花税合同台账接口
      • 账簿数据接口
      • 进项发票数据接口
      • 销项发票数据接口
      • 红字通知单数据接口
      • 即征即退数据接口
      • 台账接口
      • 财务报表接口
      • 标准申报数据接口
    • 扣款类
      • 扣款接口
      • 标准申报扣款接口
    • 结果查询类
      • 申报流水号查询接口
      • 税号与税种编码查询申报结果接口
      • 文件编码查询结果接口
      • 税号与税种编码查询底稿结果接口
      • 即征即退FileNo查询结果接口
      • 文件编码查询结果接口(JSON)
      • 标准申报结果查询接口
      • 标准申报结果其他参数查询接口
    • 申报数据查询类
      • 申报数据查询接口
    • 凭证资料类
      • 凭证资料下载-URL
      • 凭证资料下载-文件流
      • 获取凭证资料数据接口
    • 基础资料类
      • 通过账簿编码获取公司税号接口
    • 申报类
      • 标准申报下发接口
      • 标准申报弹窗放过接口
    • 公司类
      • 公司登录验证接口
    • 数据模型
      • 申报状态
      • 扣款状态
      • 审核状态
      • 码表信息
      • 响应码
      • 税种编码
      • 生成状态
      • 转出项目
      • 即征即退标识
      • 其他扣税发票类型
      • 征收项目
      • 计算状态
      • 云平台扣款标识
      • 申报审核状态
      • 云平台申报标识
      • 扣款审核状态
      • 工作底稿处理状态
      • 弹窗错误状态
      • 即征即退处理状态
      • 弹窗是否可放状态
      • 即征即退申请状态
      • 增量全量标识
      • 字典表
  1. 财云通平台数据接入接口

工作底稿进数流程

基于 财云通平台数据接入接口 文档,描述「工作底稿数据接口」进数并查询结果的完整流程。

流程概览#

┌─────────────────────────────────────────────────────────────┐
│  ① 工作底稿数据接口                                          │
│     POST /declareDataFile                                   │
│     (上传工作底稿 XML,需验签)                               │
└───────────────────────────────┬─────────────────────────────┘
                                │ 返回 FileNo(文件编码)
                                ▼
┌─────────────────────────────────────────────────────────────┐
│  ② 文件编码查询结果接口(JSON)                                 │
│     POST /declarationResultController/queryResultByFileNo   │
│     (用 FileNo 查询进数/申报结果,需验签)                     │
└───────────────────────────────┬─────────────────────────────┘
                                │ 返回 Data[](各税种结果明细)
                                ▼
                        解析结果(generateStatus / declareStatusCode ...)

① 工作底稿数据接口#

项目内容
端点POST /declareDataFile
服务标识declareDataFile
分类数据接入类
输入二进制流(UTF-8),XML 报文
是否验签是
加解密支持 AES 加密、HMACMD5 防篡改(通过 Header 传递)

请求参数(query,验签参数)#

参数说明必填
AccessKeyID用户名称是
TimeStamp时间戳,格式 yyyy-MM-dd'T'HH:mm:ss'Z'是
SignatureNonce随机数(32 位 UUID)是
Signature签名串(HMAC-SHA1 + MD5)是
Version版本号,固定 1.0是
验签细节见《接口验签说明》。

请求体(XML)#

<?xml version="1.0" encoding="utf-8"?>
<Root>
  <TaskSet>
    <OrgInfo>
      <OrgName>自动化测试公司</OrgName>
      <OrgTaxNum>ZDHCS00000011111</OrgTaxNum>
    </OrgInfo>
    <LoginInfo>
      <Item LoginName="" LoginPassword=""/>
    </LoginInfo>
    <TaxInfo>
      <TableSet id="700000" taxType="" ssqs="2025-10-01"
                ssqz="2025-10-31" ssqType="1" type="SB" declareDate="">
        <Table name="资产负债表">
          <Param>
            <Item location="LN04005">21217135.91</Item>
            <Item location="LN04006">6428332.83</Item>
            ...
          </Param>
        </Table>
      </TableSet>
    </TaxInfo>
  </TaskSet>
</Root>

响应字段#

字段类型说明
FileNostring文件编码(后续查询的关键入参)
HostIDstring财云通平台服务标识
Codestring响应码(200 / 400 / 403 / 410 / 411 / 412 / 413 / 500)
Messagestring返回信息
处理状态枚举:0=处理成功,1=处理中,2=处理失败。

② 文件编码查询结果接口(JSON)#

项目内容
端点POST /declarationResultController/queryResultByFileNo
服务标识declarationResultController
分类结果查询类
输入query 参数(含 FileNo + 验签参数)
是否验签是

请求参数(query)#

除验签参数(AccessKeyID、TimeStamp、SignatureNonce、Signature、Version)外,额外包含:
参数说明必填
FileNo文件编码(来自 ① 的响应)是

响应字段#

{
  "HostID": "https://tdm-fp.bigfintax.com",
  "Code": "200",
  "Message": "申报结果查询成功!",
  "Data": [
    {
      "orgName": "公司名称",
      "taxNum": "纳税人识别号",
      "taxCode": "表套编码",
      "taxName": "表套名称",
      "projectCode": "项目编码(仅供增值税预缴使用)",
      "generateStatus": "生成状态",
      "processCode": "处理状态",
      "processMessage": "处理信息",
      "taxTypes": [
        {
          "typeName": "类型名称",
          "taxAmounts": [
            { "levyName": "征税名称", "levyAmount": "税额" }
          ],
          "lastUpdateDate": "最后更新时间",
          "declareTypeName": "申报方式: 月/季/年/次/半年",
          "reportPeriodBegin": "税款所属期起",
          "reportPeriodEnd": "税款所属期止",
          "declareStatusCode": "申报状态编码",
          "declareStatusInfo": "申报状态信息",
          "taxStatusCode": "扣款状态编码",
          "taxStatusInfo": "扣款状态信息",
          "taxAmountDid": "实际扣款税额",
          "paymentTypeCode": "扣款类型编码",
          "paymentTypeInfo": "扣款类型信息",
          "declareWayCode": "申报类型编码",
          "declareWayInfo": "申报类型信息",
          "errorMessage": "错误信息"
        }
      ]
    }
  ]
}

Data 字段说明#

字段说明
orgName公司名称
taxNum纳税人识别号
taxCode / taxName表套编码 / 表套名称
generateStatus生成状态(参考「生成状态」枚举)
processCode / processMessage处理状态 / 处理信息
taxTypes[]各税种明细
taxTypes[] 内字段:
字段说明
typeName类型名称
taxAmounts[]征税项(levyName 征税名称、levyAmount 税额)
declareStatusCode / declareStatusInfo申报状态编码 / 信息
taxStatusCode / taxStatusInfo扣款状态编码 / 信息
taxAmountDid实际扣款税额
paymentTypeCode / paymentTypeInfo扣款类型编码 / 信息
declareWayCode / declareWayInfo申报类型编码 / 信息
reportPeriodBegin / reportPeriodEnd税款所属期起 / 止
errorMessage错误信息

完整调用时序#

调用方                                         财云通平台
  │                                                │
  │──── ① POST /declareDataFile ─────────────────→ │  上传工作底稿(XML)
  │     ?AccessKeyID=...&TimeStamp=...             │
  │      &SignatureNonce=...&Version=1.0           │
  │      &Signature=...                            │
  │←─── { FileNo, Code, Message } ──────────────── │
  │                                                │
  │──── ② POST /declarationResultController/      │
  │         queryResultByFileNo ─────────────────→ │  按文件编码查询结果
  │     ?FileNo={FileNo}&AccessKeyID=...           │
  │      &TimeStamp=...&SignatureNonce=...         │
  │      &Version=1.0&Signature=...                │
  │←─── { HostID, Code, Message, Data[] } ──────── │
  │                                                │
  │  解析 Data[] → 各税种 generateStatus /          │
  │               declareStatusCode ...            │

关键点#

1.
FileNo 是两接口的桥梁 — ① 响应的 FileNo 直接作为 ② 的入参。
2.
两个接口均需验签 — 每个请求都要重新生成 TimeStamp、SignatureNonce、Signature。
3.
① 输入为 XML 二进制流 — 报文格式 UTF-8;② 输入为 query 参数。
4.
② 返回 JSON — 结果在 Data 数组中,按税种(taxTypes[])展开。
修改于 2026-08-14 07:25:26
上一页
标准申报接口调用流程
下一页
纳税申报数据接口
Built with