异常状态发票信息下载
API说明:下载发票状态是异常状态的发票概要信息(仅支持接入数字账户云服务)。
调用方式:HTTP协议
API编码:jx.rz.full.invoiceInfo
调用方法:POST
数据格式:json
请求报文规范
{
"batchNo": "批次号",
"fpdm": "发票代码",
"fphm": "发票号码",
"qdfphm": "数电票号码",
"fpzt": "发票状态",
"fplx": "发票类型",
"kprqq": "开票日期起",
"kprqz": "开票日期止",
"jeq": "金额起",
"jez": "金额止",
"dfnsrsbh": "对方纳税人识别号",
"dfnsrmc": "对方纳税人名称",
"pageNum": "当前页码",
"pageSize": "每页条数"
}
字段说明
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| batchNo | 批次号 | varchar | 32 | 是 | 32位,代表一次请求。 |
| fpdm | 发票代码 | varchar | 12 | 否 | |
| fphm | 发票号码 | varchar | 8 | 否 | |
| qdfphm | 数电票号码 | varchar | 20 | 否 | qdfphm和fpdm、fphm不可同时有值 |
| fpzt | 发票状态 | array | 否 | 不传默认是[],代表不选择发票状态,表示全部发票状态,同["02","03","04"]。 "02":已作废 "03":已红冲-全额 "04":已红冲-部分 |
|
| fplx | 发票类型 | varchar | 2 | 否 | 不传默认查询全部。 01:增值税专用发票; 03:机动车销售统一发票; 04:增值税普通发票; 08:增值税电子专用发票; 10:增值税电子普通发票; 11:增值税普通发票(卷式); 14:道路通行费电子普通发票; 15:二手车销售统一发票; 51:数电票(铁路电子客票); 59:数电票(通行费发票) 61:数电票(航空运输电子客票行程单); 81:数电票(增值税专用发票); 82:数电票(普通发票); 83:数电票(机动车销售统一发票); 84:数电票(二手车销售统一发票); 85:数电纸质发票(增值税专用发票); 86:数电纸质发票(普通发票); 87:数电纸质发票(机动车销售统一发票); 88:数电纸质发票(二手车销售统一发票); |
| kprqq | 开票日期起 | varchar | 10 | 是 | 格式:yyyy-MM-dd kprqq、kprqz不支持跨月查询。 |
| kprqz | 开票日期止 | varchar | 10 | 是 | 格式:yyyy-MM-dd |
| jeq | 金额起 | varchar | 20 | 否 | |
| jez | 金额止 | varchar | 20 | 否 | |
| dfnsrsbh | 对方纳税人识别号 | varchar | 20 | 否 | |
| dfnsrmc | 对方纳税人名称 | varchar | 50 | 否 | |
| pageNum | 当前页码 | varchar | 10 | 否 | |
| pageSize | 每页条数 | varchar | 10 | 否 | 为空时,默认每页请求10条。最多不超过100条 |
返回报文规范
{
"pageNum": "当前页码",
"pageSize": "每页条数",
"total": "总数量",
"invoicesData": [
{
"xfsbh": "销方税号",
"xfmc": "销方名称",
"gfsbh": "购方税号",
"gfmc": "购方名称",
"fpdm": "发票代码",
"fphm": "发票号码",
"qdfphm": "数电票号码",
"kprq": "开票日期",
"fplx": "发票类型",
"fpzt": "发票状态",
"kpr": "开票人",
"je": "金额",
"se": "税额",
"jshj": "价税合计"
}
]
}
字段说明
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| pageNum | 当前页码 | varchar | 10 | 是 | |
| pageSize | 每页条数 | varchar | 10 | 是 | |
| total | 总数量 | varchar | 10 | 是 | |
| invoicesData | 发票信息 | List | 以数组形式返回发票信息。 | ||
| xfsbh | 销方税号 | varchar | 20 | 是 | |
| xfmc | 销方名称 | varchar | 50 | 是 | |
| gfsbh | 购方税号 | varchar | 20 | 是 | |
| gfmc | 购买名称 | varchar | 50 | 是 | |
| fpdm | 发票代码 | varchar | 12 | 否 | |
| fphm | 发票号码 | varchar | 8 | 否 | |
| qdfphm | 数电票号码 | varchar | 20 | 否 | |
| kprq | 开票日期 | varchar | 20 | 是 | 格式:yyyy-MM-dd HH:mm:ss |
| fplx | 发票类型 | varchar | 2 | 是 | |
| fpzt | 发票状态 | varchar | 2 | "02":已作废 "03":已红冲-全额 "04":已红冲-部分 |
|
| kpr | 开票人 | varchar | 20 | ||
| je | 金额 | varchar | 20 | 不含税金额,保留2位小数。 | |
| se | 税额 | varchar | 20 | 保留2位小数。 | |
| jshj | 价税合计 | varchar | 20 | 保留2位小数。 |