发起下载完税证明任务
接口描述
根据税费种的yzpzzlDm、年月和起止日期发起从税局获完税证明数据进行归档。
下载完税证明任务执行完后，可以通过查询下载完税证明接口进行查询，节点完税证明Url获取文件地址。
请求地址
Header 参数
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
Timestamp | String | 必选 | 公共参数。 |
SecretId | String | 必选 | 公共参数。 |
Signature | String | 必选 | 公共参数。 |
Algorithm | String | 可选 | 公共参数。 |
Content-Type | String | 必选 | 取值：application/json |
Body 请求参数
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
aggOrgId | String | 必选 | 企业Id |
accountId | String | 可选 | 账号ID 账号ID（多账号场景使用） |
tdztswjgmc | String | 可选 | 特定主体税务机关名称 |
year | Integer | 必选 | 年 |
period | Integer | 必选 | 月 |
zsxmDtos | [] | 可选 |
zsxmDtos
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
ssqQ | String | 可选 | 所属期起 格式为yyyy-MM-dd；所属起止和缴款日期起止必须有一类请求 |
ssqZ | String | 可选 | 所属期止 格式为yyyy-MM-dd；所属起止和缴款日期起止必须有一类请求 |
jkrqq | String | 可选 | 缴款日期起 格式为yyyy-MM-dd 缴款日期起止不能跨年；所属起止和缴款日期起止必须有一类请求 |
jkrqz | String | 可选 | 缴款日期止 格式为yyyy-MM-dd 缴款日期起止不能跨年；所属起止和缴款日期起止必须有一类请求 |
yzpzzlDm | String | 必选 | 应征凭证种类代码 参考申报附录应征凭证种类代码 |
zspmDm | String | 可选 | 征收品目代码 文化事业建设费时，征收品目代码为必传项 |
zsxmDm | String | 可选 | 征收项目代码 工会经费=39900/水利建设专项收入=30221 合并下载则可以为空 |
bsswjg | String | 可选 | 跨区域上传税务机关名称 （上传格式 省|市|区 如“湖南省|湘潭市|岳塘区”） |
kqyswjgmc | String | 可选 | 跨区域税局机关名称 税局账户中心-跨区域切换中的税务机关名称 |
返回参数
公共返回结构
| 参数名称 | 类型 | 说明 |
|---|---|---|
code | Integer | 200 表示请求成功，其他参见错误码 |
message | String | 错误提示信息 |
startTime | long | 开始时间 |
endTime | long | 结束时间 |
callId | long | 调用记录标识 |
data | Object | 返回数据 |
data 内容说明
| 参数名称 | 类型 | 说明 |
|---|---|---|
aggOrgId | String | 企业Id |
taskId | String | 任务id，供查询下载完税证明任务结果时使用 |
taskIds | [] | 各税种下载任务明细 |
各税种下载任务明细
| 参数名称 | 类型 | 说明 |
|---|---|---|
yzpzzlDm | String | 应征凭证种类代码 |
ssqQ | String | 所属期起 |
ssqZ | String | 所属期止 |
zspmDm | String | 征收品目代码 |
taskId | String | 任务id |
错误码
若请求错误，服务器将返回的JSON文本包含以下参数：
- code：错误码。
- message：错误描述信息，帮助理解和解决发生的错误。
| 错误码 | 描述 |
|---|---|
| PARAMETER_ERROR | 企业不存在 |
| PARAMETER_ERROR | 请求参数year和month不为空！ |
| 5001 | 税款所属期 最早起+最晚止 不可跨自然年! |
| 5003 | 应征凭证种类代码不支持超过20条！ |
| 5002 | 应征凭证种类代码+税款所属期起止入参不可多条重复！ |
| 5002 | 财报不支持下载完税证明！ |
| 5002 | 税款所属期起止不能为空！ |
| 5002 | 应征凭证种类代码不能为空！ |
| 5002 | 应征凭证种类代码为文化事业建设费时，征收品目代码不能为空！ |