开放平台

Appearance

申报表下载结果查询 S004-S010 ​

该接口查询申报表下载（S010）的下载结果状态

请求参数 ​

appKey客户唯一标识用户申请,后台自动分配string(32)必填
jsonData请求参数参数请求体json必填
serviceId服务ID选择对应的接口服务,参考接口列表string必填
nsrsbh纳税人识别号请求参数,位置在jsonData里面string必填
sbrqq申报日期起请求参数,位置在jsonData里面,格式yyyy-MM-ddstring必填
sbrqz申报日期止请求参数,位置在jsonData里面,格式yyyy-MM-ddstring必填
skssqq税款所属期起税款所属期起，传参规则保持和发起请求S010税款所属期起一致即可。string条件必填
skssqz税款所属期止税款所属期止，传参规则保持和发起请求S010税款所属期止一致即可。string条件必填

响应参数 ​

status状态编码:200表示正常无string必定返回
code业务编码:T0000表示成功,其他编码均为异常编码无string必定返回
msg返回信息无string必定返回
stackTrace错误堆栈信息无string必定返回
data返回对象无json必定返回
statusCode查询成功时候返回,申报状态编码 "statusCode": "T0"（处理中）；"T1"（处理成功）；"T2"（处理失败）是返回对象data中的内容string非必定返回
statusMsg申报状态描述是返回对象data中的内容string非必定返回
declareList返回对象，是包含多个获取到的历史报表详细信息的集合是返回对象data的内容，其内容为json的集合array非必定返回
result返回对象，是包含多个文件地址和名称的集合是返回对象declareList中的内容，其内容为json的集合array非必定返回
nsrsbh纳税人申报号是返回对象declareList中的内容string非必定返回
fileNo文件编号是返回对象declareList中的内容，文件编号、用于获取文件解析数据string非必定返回
szname税种名称是返回对象declareList中的内容string非必定返回
skssqq税款所属期起是返回对象declareList中的内容，格式：yyyy-MM-ddstring非必定返回
skssqz税款所属期止是返回对象declareList中的内容，格式：yyyy-MM-ddstring非必定返回
ybtse应补退税额是返回对象declareList中的内容string非必定返回
sbzlbh申报种类编码是返回对象declareList中的内容，可在“码表查询”查询string非必定返回
pdfpdf获取地址是返回对象result中的内容string非必定返回
name报表名称是返回对象result中的内容string非必定返回
请求示例 ​
{
    "appKey": "0831679e-xxxx-4ad6-aa5a-127ad56a78d0",
    "serviceId": "S004",
    "jsonData": {
        "sbrqq": "申报所属起 如：2023-01-01",
        "nsrsbh": "税号",
        "serviceId": "S010",
        "sbrqz": "申报所属止 如：2023-11-30"
    }
}
响应处理中示例 ​
{
    "status": 200,
    "code": "T0000",
    "msg": "执行成功!",
    "stackTrace": null,
    "data": {
        "statusMsg": "报表数据获取中,请等待!",
        "statusCode": "T0"
    }
}
响应成功示例 ​
{
    "status": 200,
    "code": "T0000",
    "msg": "执行成功!",
    "stackTrace": null,
    "data": {
        "statusMsg": "报表数据获取成功!",
        "declareList": [
            {
                "result": [
                    {
                        "pdf": "pdf地址",
                        "name": "报表名称"
                    }
                ],
                "nsrsbh": "税号",
                "fileNo": "文件编号",
                "szname": "税种名称",
                "skssqz": "所属期起 2022-12-31",
                "ybtse": "0.0",
                "sbzlbh": "30218",
                "skssqq": "所属期止 2022-01-01"
            },
            {
                "result": [
                    {
                        "pdf": "pdf地址",
                        "name": "报表名称"
                    }
                ],
                "nsrsbh": "税号",
                "fileNo": "文件编号",
                "szname": "税种名称",
                "skssqz": "所属期起 如：2023-09-30",
                "ybtse": "0.0",
                "sbzlbh": "申报种类编码",
                "skssqq": "所属期止 如：2023-07-01"
            }
        ],
        "statusCode": "T1"
    }
}
响应失败示例 ​
{
    "status": 200,
    "code": "T0000",
    "msg": "执行成功!",
    "stackTrace": null,
    "data": {
        "statusMsg": "采集前置失败授权超时，采集前置失败",
        "stackTrace": null,
        "statusCode": "T2"
    }
}
注意事项 ​

返回编码"T0000"表示查询成功,但不表示申报成功,具体的成功需要根据statusCode来判断; 返回其他编码的时候,表示业务失败,msg会进行消息提示; 备注: statusCode:T0（处理中）；T1（处理成功）；T2（处理失败）