Skip to content

完税凭证下载结果查询 S004-S008

使用该接口查询完税凭证结果

请求参数

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必填
zspm征收品目如果有存在多个缴款信息,可以通过次字段做更精确的匹配string非必填
jkje缴款金额如果有存在多个缴款信息,可以通过次字段做更精确的匹配string非必填
dzsphm电子税票号码如果有存在多个缴款信息,可以通过次字段做更精确的匹配string非必填
wszmlx完税证明类型完税证明类型(0:表格式,1:文书式,默认是0 )string必填
kjlx开具类型开具类型, 0:明细,1:汇总,默认0。当完税证明类型为文书式时,该参数选填。string条件必填

响应参数

status状态编码:200表示正常string必定返回
code业务编码:T0000表示成功,其他编码均为异常编码string必定返回
msg返回信息string必定返回
stackTrace错误堆栈信息string必定返回
data返回对象json必定返回
statusCode查询成功时候返回,申报状态编码 "statusCode": "T0"(处理中);"T1"(处理成功);"T2"(处理失败)。是返回对象data中的内容string非必定返回
statusMsg申报状态描述是返回对象data中的内容string非必定返回
wspzFileType完税凭证文件类型,如:pdf是返回对象data中的内容string非必定返回
wspzFileName完税凭证文件名称是返回对象data中的内容string非必定返回
wspzContent完税凭证文件二进制数据流程base64字符串。是返回对象data中的内容string非必定返回
请求示例
{
    "appKey": "a3534d0a8b264350bbdbfe7656eb6caf",
    "serviceId": "S004",
    "jsonData": {
        "nsrsbh": "税号",
        "nsqxdm": "纳税期限代码 01:次、02:月度、03:季度、04:年度、05:半年度",
        "serviceId": "S008",
        "sbzlbh": "申报种类编码",
        "skssqz": "税款所属期止,如:2023-10-31",
        "skssqq": "税款所属期起,如:2023-11-01",
        "wybh": "部分税种需要",
        "zspm": "非必填,征收品目",
        "jkje": "非必填,缴款金额",
        "dzsphm": "非必填,电子税票号码",
        "wszmlx": "0 必填,完税证明类型,如:0:表格式,1:文书式,默认是0 ",
        "kjlx": "条件必填,开具类型(0:明细,1:汇总,默认0,当完税证明类型为文书式时,该参数选填)"
    }
}
响应成功示例
{
    "status": 200,
    "code": "T0000",
    "msg": "执行成功!",
    "stackTrace": null,
    "data": {
        "wspzFileName": "完税凭证名称.pdf",
        "statusMsg": "完税凭证获取成功!",
        "wspzFileType": "pdf",
        "statusCode": "T1",
        "wspzContent": "完税凭证内容base64"
    }
}
响应失败示例
{
    "status": 200,
    "code": "T0000",
    "msg": "执行成功!",
    "stackTrace": null,
    "data": {
        "statusMsg": "授权超时, 获取授权失败,未找到可用的授权信息",
        "stackTrace": null,
        "statusCode": "T2"
    }
}
注意事项

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