开放平台

Appearance

申报初始化结果查询 S004-S002 ​

该接口用于查询申报初始化结果的状态。

请求参数 ​

参数名称描述备注类型是否必填
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-ddstring必填
skssqz所属期止请求参数，位置在jsonData里面，格式yyyy-MM-ddstring必填
wybh唯一编号请求参数，位置在jsonData里面，按次及部分税种需要，存在校验string非必填
serviceId服务ID查询目标结果的serviceId，如S002、S003，与最外层serviceId不同string必填

响应参数 ​

参数名称描述备注类型是否必定返回
status状态编码：200表示正常无string必定返回
code业务编码：T0000表示成功，其他编码均为异常编码无string必定返回
msg返回信息无string必定返回
stackTrace错误堆栈信息无string必定返回
data返回对象无json必定返回
statusCode查询成功时返回的申报状态编码：T0处理中、T1处理成功、T2处理失败是返回对象data中的内容string非必定返回
statusMsg申报状态描述是返回对象data中的内容string非必定返回
initData状态为【初始化成功】时返回的字段，存放初始化报文，Base64字符串是返回对象data中的内容string非必定返回
processImgUrls过程截图申报过程中的截图，图片为Base64字符串，数组类型array非必定返回
imageType图片类型返回图片格式，如pngstring非必定返回
imageFileList返回结果图片返回最后图片的地址，图片为Base64字符串，数组类型array非必定返回

请求示例 ​

json
{
    "jsonData": {
        "nsrsbh": "税号",
        "skssqz": "税款所属期止，如：2023-11-30",
        "nsqxdm": "纳税期限代码 01:次、02:月度、03:季度、04:年度、05:半年度",
        "serviceId": "S002",
        "sbzlbh": "申报种类编码",
        "skssqq": "税款所属期起，如：2023-11-01",
        "wybh": "部分税种需要"
    },
    "appKey": "a3534d0a8b264350bbdbfe7656eb6caf",
    "serviceId": "S004"
}

响应示例 ​

处理中：

json
{
    "status": 200,
    "code": "T0000",
    "msg": "执行成功!",
    "stackTrace": null,
    "data": {
        "statusMsg": "初始化信息获取中,请等待!",
        "statusCode": "T0"
    }
}

成功：

json
{
    "status": 200,
    "code": "T0000",
    "msg": "执行成功!",
    "stackTrace": null,
    "data": {
        "initData": "base64",
        "statusMsg": "初始化信息获取成功!",
        "processImgUrls": [
            "图片地址1",
            "图片地址2"
        ],
        "imageFileList": [
            "图片地址"
        ],
        "imageType": "png",
        "statusCode": "T1"
    }
}

失败：

json
{
    "status": 200,
    "code": "T0000",
    "msg": "执行成功!",
    "stackTrace": null,
    "data": {
        "statusMsg": "失败授权超时",
        "statusCode": "T2"
    }
}

注意事项 ​

  • 返回编码T0000表示查询成功，但不表示申报成功，具体成功需根据statusCode判断。
  • 返回其他编码时表示业务失败，msg会提示具体信息。
  • 状态码说明：
    • T0：处理中
    • T1：处理成功
    • T2：处理失败