接口申报调用流程

1. 总体调用顺序（泳道图）

2. 主流程接口

第 1 步：准备签名参数

接口调用前，先准备公共签名请求头。文档中的“快速获取签名参数”接口只建议测试联调使用；正式环境应在客户系统内按签名规则生成签名，避免明文传递密码。

GET /assembleSignatureController/get/{AccessKeyID}/{password}
接口：快速获取签名参数
用途：测试环境快速生成 AccessKeyID、TimeStamp、SignatureNonce、Signature、Version 等参数

后续业务接口通常需要在请求头中携带：

请求头	说明
`AccessKeyID`	接口用户名
`TimeStamp`	时间戳
`SignatureNonce`	随机数
`Signature`	签名串
`Version`	版本号
`encrypt`	可选，加密相关
`tamperProof`	可选，防篡改相关
`tamperProofSigna`	可选，防篡改比对串

第 2 步：预填数据采集（可选）

如需先从税局侧采集预填数据，先发起采集任务，再等待平台回调客户系统。

接口	方法和路径	说明
预填数据采集	`POST /preData/collection`	提交税号、平台号、任务类型、申报年月、回调地址。
预填数据采集-回调参数	`POST /preData/callback`	平台回调客户系统，返回采集状态、申报期、认定等预填数据。

下一步：进入税费种认定，或直接准备业务数据上传。

第 3 步：税费种认定

先采集企业适用的税费种、申报期限、申报表等认定信息；后续可按企业查询已采集的认定结果。

接口	方法和路径	说明
采集认定	`POST /approvalGtbtController/submitApproval`	提交企业税费种、申报期限、申报表等认定信息。
采集认定查询	`POST /approvalGtbtController/getApprovalData`	查询企业已采集的税费种认定信息。

下一步：根据认定结果，准备对应税种的申报基础数据。

第 4 步：上传业务基础数据

根据企业申报范围选择对应接口，不是所有企业都需要全部调用。

数据类型	接口	方法和路径	请求格式
科目余额	科目余额表上传	`POST /subjectBalance/submit`	`application/xml`
增值税	其他扣税凭证	`POST /invoice/orgJxCarriageInvoice/submit`	`application/json`
增值税	进项增值税转出	`POST /invoice/orgJxVatOut/submit`	`application/json`
增值税	视同销售虚拟发票	`POST /invoice/orgJxTreatInvoice/submit`	`application/json`
印花税	印花税合同	`POST /stamp/contract/ledger`	`text/plain`

下一步：进入申报数据处理。

第 5 步：发起申报数据处理

有两种方式，按对接模式选择其一。

方式	接口	方法和路径	请求格式	说明
工作底稿方式	工作底稿数据上传接口	`POST /declareDataFile/submit`	`application/xml`	上传工作底稿 XML，适合按底稿结构生成申报数据。
纯接口文件方式	申报文件上传	`POST /api/uploadDeclareFile`	`multipart/form-data`	表单方式上传申报附件，同时传入税务信息与登录信息。

工作底稿方式需要参考：

文档	说明
工作底稿数据格式说明	说明 XML `TaskSet`、企业信息、登录信息、税种、报表等结构。
工作底稿数据加密和防篡改说明	说明加密、防篡改相关处理。

第 6 步：上传验证码（按需）

申报过程中如税局触发短信验证码或验证码校验，客户收到或确认验证码后，通过上传短信接口将验证码内容回传平台。

接口	方法和路径	说明
上传短信	`POST /smsController/uploadSms`	将客户收到或确认的验证码短信内容回传平台。

下一步：验证码上传完成后，继续查询底稿处理结果。

第 7 步：查询底稿处理结果

工作底稿方式上传后，需要查询底稿处理结果。

POST /declarationResultController/declareFileNoResultQuery
接口：工作底稿数据结果查接口（xml结构）
格式：application/xml
用途：查询工作底稿上传后的处理结果

查询报文结构参考“工作底稿数据查询格式说明”。

第 8 步：下载申报资料

申报完成后，按需下载申报表、完税凭证等资料。

GET /externalCompanyController/companyDataFile
接口：凭证资料下载
用途：按申报日期、企业信息、资料类型下载申报表或完税凭证等资料

3. 辅助流程：验证码/短信

验证码/短信接口通常用于税局登录、申报确认或其他验证交互。若申报过程中触发验证码，只需要通过上传短信接口将验证码内容回传平台。

顺序	接口	方法	路径	说明
S1	上传短信	`POST`	`/smsController/uploadSms`	将验证码短信内容回传平台。

接口申报流程

接口申报调用流程#

1. 总体调用顺序（泳道图）#

2. 主流程接口#

第 1 步：准备签名参数#

第 2 步：预填数据采集（可选）#

第 3 步：税费种认定#

第 4 步：上传业务基础数据#

第 5 步：发起申报数据处理#

第 6 步：上传验证码（按需）#

第 7 步：查询底稿处理结果#

第 8 步：下载申报资料#

3. 辅助流程：验证码/短信#