发起下载当期PDF任务
接口描述
根据税费种的yzpzzlDm和税种所属期发起从税局获取申报的PDF文件及结构化数据进行归档。
支持发起获取当期的各税种的PDF文件。---此校验去掉。 2026年7月：最新能力此接口当期和往期PDF下载都可以下载，无需再单独对接往期PDF接口
下载PDF任务执行完后，可以通过查询下载PDF任务结果接口进行查询，节点screenshot获取文件地址及结构化数据。
请求地址
Header 参数
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
Timestamp | String | 必选 | 公共参数。 |
SecretId | String | 必选 | 公共参数。 |
Signature | String | 必选 | 公共参数。 |
Algorithm | String | 可选 | 公共参数。 |
Content-Type | String | 必选 | 取值：application/json |
Body 请求参数
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
aggOrgId | String | 必选 | 企业id |
accountId | String | 可选 | 账号ID（多账号场景使用） |
tdztswjgmc | String | 可选 | 特定主体税务机关名称 |
year | Integer | 必选 | 年 （当前年度） |
period | Integer | 必选 | 月（当前申报月份） |
analysisPdf | String | 可选 | 解析pdf Y-解析 N-不解析；支持解析税种：增值税小规模 、增值税一般人、企业所得税预缴（月季报）、财务报表月季报/年报、印花税、房产税、土地、房土合并 （财行税21年6月实行之前的报表不支持解析）、通用申报、残疾人保障金、文化事业建设费、金融类财务报表、汇算清缴（2025年前报表不支持解析） |
zsxmList | [] | 必选 | 税种明细列表 |
zsxmList
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
yzpzzlDm | String | 必选 | 应征凭证种类代码 |
ssqQ | String | 必选 | 所属期起，格式yyyy-MM-dd |
ssqZ | String | 必选 | 所属期止，格式yyyy-MM-dd |
zspmDm | String | 可选 | 征收品目代码，文化事业建设费时必传字段，用来区分文化业还是娱乐业，302170100娱乐业文化事业建设费、302170200广告业文化事业建设费。（税报） |
zlbsxlDm | String | 可选 | 资料报送小类（财报必须传）ZL1001001:一般企业会计准则、 ZL1001002:企业会计制度、 ZL1001003:小企业会计准则 |
templateCode | String | 可选 | 资料报送子类（【一般企业会计准则】类型时必填，1:适用未执行新金融准则、新收入准则和新租赁准则的 一般企业、2:适用已执行新金融准则、新收入准则和新租赁准则的一般企业） |
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 | [] | 任务列表 |
任务列表 taskIds
| 参数名称 | 类型 | 说明 |
|---|---|---|
yzpzzlDm | String | 应征凭证种类代码 |
ssqQ | String | 所属期起 |
ssqZ | String | 所属期止 |
zspmDm | String | 征收品目代码，文化事业建设费时，用来区分文化业还是娱乐业，302170100娱乐业文化事业建设费、302170200广告业文化事业建设费。 |
taskId | String | 任务id |
错误码
若请求错误，服务器将返回的JSON文本包含以下参数：
- code：错误码。
- message：错误描述信息，帮助理解和解决发生的错误。
| 错误码 | 描述 |
|---|---|
| PARAMETER_ERROR | 企业Id(aggOrgId)不能为空！ |
| PARAMETER_ERROR | 请求参数year或period不能为空！ |
| PARAMETER_ERROR | 请求参数year或period不合法！ |
| PARAMETER_ERROR | 应征凭证种类代码为BDA0611033的企业所得税A类（2018年版）（查账征收）已停用， 请改用应征凭证种类代码BDA0611159来标志企业所得税A类（2021年版A类）（查账征收) |
| BUSINESS_ERROR | 任务不支持待上线 |