发起下载完税证明并解析任务

接口描述

根据税费种的yzpzzlDm、年月和起止日期发起从税局获完税证明数据进行归档。支持单税种，多税种同时下载。

下载完税证明任务执行完后，可以通过查询下载完税证明接口进行查询，节点完税证明Url获取文件地址；同时根据完税证明url解析文件中的pdf文件，将pdf中的数据以json格式返回。

错误码

错误代码	错误信息	解决方案
PARAMETER_ERROR	企业不存在
PARAMETER_ERROR	请求参数year和month不为空！
5001	税款所属期最早起+最晚止不可跨自然年!
5003	应征凭证种类代码不支持超过20条！
5002	应征凭证种类代码+税款所属期起止入参不可多条重复！
5002	财报不支持下载完税证明！
5002	税款所属期起止不能为空！
5002	应征凭证种类代码不能为空！
5002	应征凭证种类代码为文化事业建设费时，征收品目代码不能为空！

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

access_token

string

必需

通过调用access_token接口返回的access_token值

示例值:

req_date

string

必需

当前时间转为的毫秒数

示例值:

req_sign

string

签名算法得到的签名

必需

示例值:

Body 参数application/json

aggOrgId

string

企业Id

必需

accountId

string

账号ID

可选

账号ID（多账号场景使用）

year

integer

年

必需

period

integer

月

必需

zsxmDtos

array [object {6}]

必需

ssqQ

string

日期起

必需

格式为yyyy-MM-dd

ssqZ

string

日期止

必需

格式为yyyy-MM-dd

yzpzzlDm

string

应征凭证种类代码

必需

参考申报附录应征凭证种类代码

zspmDm

string

征收品目代码

可选

文化事业建设费时，征收品目代码为必传项

zsxmDm

string

征收项目代码

必需

工会经费=39900/水利建设专项收入=30221 合并下载则可以为空

bsswjg

string

跨区域上传税务机关名称

可选

（上传格式省|市|区如“湖南省|湘潭市|岳塘区”）

示例

{
  "aggOrgId": 452681066557440,
  "year": 2023,
  "period": 3,
  "zsxmDtos": [
    {
      "ssqQ": "2023-02-01",
      "ssqZ": "2023-02-28",
      "yzpzzlDm": "BDA0610606",
      "zspmDm": ""
    }
  ]
}

返回响应

🟢200成功

application/json

Body

reqId

string

请求id

必需

由服务器端生成的唯一标识，对应每次请求。排查接口异常时，可提供该字段方便定位

code

string | null

错误码

必需

错误码

success

boolean

是否成功标记

必需

接口是否成功（是否发生业务异常）

message

string | null

错误信息

必需

data

object (发起下载完税证明出参)

业务数据

可选

aggOrgId

string

企业 id

可选

taskId

string

任务id

可选

任务id；可以通过查询任务状态接口来查询任务执行的情况

taskIds

array [object {5}] | null

任务明细集合

可选

示例

企业不存在发起任务成功

{
  "reqId": "7f1dbfb3adbd46589b3d9c203458fe75",
  "code": "PARAMETER_ERROR",
  "success": true,
  "message": "没有找到对应的企业！",
  "data": null
}

发起下载完税证明并解析任务

接口描述#

错误码#

请求参数

返回响应

接口描述

错误码