发票风险信息查询
API说明:企业业务系统通过此接口查询企业取得的发票被红冲、作废或被认定为异常凭证的状态。
调用方式:HTTP协议
API编码:qdfp.jx.fpfxxx
调用方法:POST
数据格式:json
请求报文规范
{
"nsrsbh": "纳税人识别号",
"fplx": "发票类型",
"qsrq": "起始日期",
"zzrq": "终止日期",
"pagesize": "每页数量",
"currpage": "页码"
}
字段说明
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| nsrsbh | 纳税人识别号 | varchar | 20 | 是 | |
| fplx | 发票类型 | varchar | 2 | 是 | 01:增值税专用发票 02:货物运输业增值税专用发票 03:机动车销售统一发票 04:增值税普通发票 08:增值税电子专用发票 10:增值税电子普通发票 11:卷式发票 14:通行费发票 15:二手车销售统一发票 51:电子发票(铁路电子客票) 61:电子发票(航空运输客票电子行程单) 81:电子发票(增值税专用发票) 82:电子发票(普通发票) 83:机动车销售电子统一发票 84:二手车销售电子统一发票 85:纸质发票(增值税专用发票) 86:纸质发票(普通发票) 87:纸质发票(机动车销售统一发票) 88:纸质发票(二手车销售统一发票) |
| qsrq | 起始日期 | varchar | 8 | 是 | YYYYMMDD(认定异常日期,起止日期不能跨月) |
| zzrq | 终止日期 | varchar | 8 | 是 | YYYYMMDD(认定异常日期,起止日期不能跨月) |
| pagesize | 每页数量 | int | 10 | 是 | 每页不超过100 |
| currpage | 页码 | int | 10 | 是 | 初始页码1 |
返回报文规范
{
"count": "总数量",
"currpage": "页码",
"fptxxxmx": [
{
"fpdm": "发票代码",
"fphm": "发票号码",
"kprq": "开票日期",
"fpzt": "发票状态",
"ycpzzt": "异常凭证状态",
"hzsdbs ": "红字锁定标识",
"bgrq": "变更日期"
}
]
}
字段说明
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| count | 总数量 | varchar | 10 | 是 | |
| currpage | 页码 | int | 10 | 否 | 下次请求时使用 |
| fptxxxmx | 发票头信息明细 | json | - | 否 | 以数组形式提交发票头信息明细 |
| fpdm | 发票代码 | varchar | 12 | 否 | 数电发票可为空 |
| fphm | 发票号码 | varchar | 20 | 是 | 数电发票,发票号码20位。 |
| kprq | 开票日期 | varchar | 19 | 是 | 格式:yyyy-MM-dd HH:mm:ss |
| fpzt | 发票状态 | varchar | 1 | 否 | 0:正常 2:作废 3:已红冲 7:部分红冲 8:全额冲红 |
| ycpzzt | 异常凭证状态 | varchar | 1 | 否 | 01:正常 02:异常凭证 03:疑似异常凭证 |
| hzsdbs | 红字锁定标识 | varchar | 1 | 否 | Y:锁定 N:未锁定 |
| bgrq | 变更日期 | varchar | 8 | 否 | 格式:yyyy-MM-dd HH:mm:ss |