Appearance
完税凭证下载结果查询 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-dd | string | 必填 | |
skssqz | 所属期止 | 请求参数,位置在jsonData里面,格式yyyy-MM-dd | string | 必填 | |
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(处理失败)