Appearance
当期申报表下载结果查询 S004-S009
使用查询接口当期申报表下载结果状态
请求参数
appKey | 客户唯一标识 | 用户申请,后台自动分配 | string(32) | 必填 | |
jsonData | 请求参数 | 参数请求体 | json | 必填 | |
serviceId | 服务ID | 选择对应的接口服务,参考接口列表 | string | 必填 | |
nsrsbh | 纳税人识别号 | 请求参数,位置在jsonData里面 | string | 必填 | |
sbzlbh | 申报种类编码 | 请求参数,位置在jsonData里面,具体值参考码表 | string | 必填 | |
nsqxdm | 纳税期限代码 | 请求参数,位置在jsonData里面,01:按次、02:月度、03:季度、04:年度、05:半年度 | string | 必填 | |
skssqq | 所属期起 | 请求参数,位置在jsonData里面,格式yyyy-MM-dd | string | 必填 | |
skssqz | 所属期止 | 请求参数,位置在jsonData里面,格式yyyy-MM-dd | string | 必填 | |
wybh | 唯一编号 | 请求参数,位置在jsonData里面,按次以及部分税种需要,存在校验 | string | 必填 | |
needScreenshot | 是否需要截图 | 传值"1",表示需要,其余值均默认为不需要;目前只有以下状态的记录才支持截图:D1,D2,E1,E2(编码含义参考码表查询-申报状态) 备注:截图平台仅保留2天,请及时获取 | string | 必填 |
响应参数
tatus | 状态编码:200表示正常 | 无 | string | 必定返回 | |
---|---|---|---|---|---|
code | 业务编码:T0000表示成功,其他编码均为异常编码 | 无 | string | 必定返回 | |
msg | 返回信息 | 无 | string | 必定返回 | |
stackTrace | 错误堆栈信息 | 无 | string | 必定返回 | |
data | 返回对象 | 无 | json | 必定返回 | |
statusCode | 查询成功时候返回,申报状态编码 "statusCode": "T0"(处理中);"T1"(处理成功);"T2"(处理失败)。 | 是返回对象data中的内容 | string | 非必定返回 | |
statusMsg | 申报状态描述 | 是返回对象data中的内容 | string | 非必定返回 | |
bbxzContent | 报表下载内容,文件的二进制数据base64以后的字符串 | 是返回对象data中的内容 | string | 非必定返回 | |
bbxzFileType | 报表下载文件类型,如:pdf | 是返回对象data中的内容 | string | 非必定返回 | |
bbxzFileName | 下载报表名称 | 是返回对象data中的内容 | string | 非必定返回 |
请求示例
{
"jsonData": {
"nsrsbh": "税号",
"skssqz": "税款所属期止,如:2023-11-30",
"nsqxdm": "纳税期限代码 01:次、02:月度、03:季度、04:年度、05:半年度",
"serviceId": "S009",
"sbzlbh": "申报种类编码",
"skssqq": "税款所属期起,如:2023-11-01",
"wybh": "部分税种需要"
},
"appKey": "a3534d0a8b264350bbdbfe7656eb6caf",
"serviceId": "S004"
}
响应成功示例
{
"status": 200,
"code": "T0000",
"msg": "执行成功!",
"stackTrace": null,
"data": {
"bbxzFileType": "pdf",
"statusMsg": "报表数据获取成功!",
"bbxzContent": "base64",
"bbxzFileName": "名称.pdf",
"statusCode": "T1"
}
}
响应失败示例
{
"status": 200,
"code": "T0000",
"msg": "执行成功!",
"stackTrace": null,
"data": {
"statusMsg": "授权超时, 获取授权失败,未找到可用的授权信息",
"stackTrace": null,
"statusCode": "T2"
}
}
注意事项
返回编码"T0000"表示查询成功,但不表示申报成功,具体的成功需要根据statusCode来判断; 返回其他编码的时候,表示业务失败,msg会进行消息提示; 备注: statusCode:T0(处理中);T1(处理成功);T2(处理失败)