┌─────────────────────────────────────────────────────────────┐
│ ① 工作底稿数据接口 │
│ POST /declareDataFile │
│ (上传工作底稿 XML,需验签) │
└───────────────────────────────┬─────────────────────────────┘
│ 返回 FileNo(文件编码)
▼
┌─────────────────────────────────────────────────────────────┐
│ ② 文件编码查询结果接口(JSON) │
│ POST /declarationResultController/queryResultByFileNo │
│ (用 FileNo 查询进数/申报结果,需验签) │
└───────────────────────────────┬─────────────────────────────┘
│ 返回 Data[](各税种结果明细)
▼
解析结果(generateStatus / declareStatusCode ...)| 项目 | 内容 |
|---|---|
| 端点 | POST /declareDataFile |
| 服务标识 | declareDataFile |
| 分类 | 数据接入类 |
| 输入 | 二进制流(UTF-8),XML 报文 |
| 是否验签 | 是 |
| 加解密 | 支持 AES 加密、HMACMD5 防篡改(通过 Header 传递) |
| 参数 | 说明 | 必填 |
|---|---|---|
| AccessKeyID | 用户名称 | 是 |
| TimeStamp | 时间戳,格式 yyyy-MM-dd'T'HH:mm:ss'Z' | 是 |
| SignatureNonce | 随机数(32 位 UUID) | 是 |
| Signature | 签名串(HMAC-SHA1 + MD5) | 是 |
| Version | 版本号,固定 1.0 | 是 |
验签细节见《接口验签说明》。
<?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>| 字段 | 类型 | 说明 |
|---|---|---|
| FileNo | string | 文件编码(后续查询的关键入参) |
| HostID | string | 财云通平台服务标识 |
| Code | string | 响应码(200 / 400 / 403 / 410 / 411 / 412 / 413 / 500) |
| Message | string | 返回信息 |
处理状态枚举:0=处理成功,1=处理中,2=处理失败。
| 项目 | 内容 |
|---|---|
| 端点 | POST /declarationResultController/queryResultByFileNo |
| 服务标识 | declarationResultController |
| 分类 | 结果查询类 |
| 输入 | query 参数(含 FileNo + 验签参数) |
| 是否验签 | 是 |
| 参数 | 说明 | 必填 |
|---|---|---|
| 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": "错误信息"
}
]
}
]
}| 字段 | 说明 |
|---|---|
| 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 ... │FileNo 直接作为 ② 的入参。TimeStamp、SignatureNonce、Signature。Data 数组中,按税种(taxTypes[])展开。