发票主体信息下载
API说明:下载发票主体信息,基于综合服务平台的可勾选的进项发票资源,包含未勾选、已勾选和已认证发票信息
调用方式:HTTP协议
API编码:jx.rz.invoices.mainQuery
调用方法:POST
数据格式:json
请求报文规范
{
"batchNo":"批次号",
"fplx":"发票类型",
"jkshm":"海关缴款书号码",
"fpdm":"发票代码",
"fphm":"发票号码",
"rkrqq":"入库日期起",
"rkrqz":"入库日期止",
"kprqq":"开票日期起",
"kprqz":"开票日期止",
"gxzt":"勾选状态",
"rzzt":"认证状态",
"startRow":"开始行号"
}
字段说明
数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
---|---|---|---|---|---|
batchNo | 批次号 | varchar | 32 | 是 | 32位。代表一次请求,每次请求批次号不重复。如果数据一次性获取完成,批次号需要更换。如果一次性数据获取不完,批次号需保持一致。 |
fplx | 发票类型 | varchar | 10 | 是 | 0:海关缴款书 1:非海关缴款书 |
jkshm | 海关缴款书号码 | varchar | 50 | 否 | fplx为0且填入时查询单张海关缴款书 |
fpdm | 发票代码 | varchar | 12 | 否 | fplx为1且填入时查询单张发票信息 |
fphm | 发票号码 | varchar | 20 | 否 | fplx为1且填入时查询单张发票信息 |
rkrqq | 入库日期起 | varchar | 19 | 是/否 | yyyy-MM-dd HH:mm:ss |
rkrqz | 入库日期止 | varchar | 19 | 是/否 | yyyy-MM-dd HH:mm:ss |
kprqq | 开票日期起 | varchar | 10 | 是/否 | yyyy-MM-dd |
kprqz | 开票日期止 | varchar | 10 | 是/否 | yyyy-MM-dd |
gxzt | 勾选状态 | varchar | 2 | 否 | 0:未勾选 1:已勾选 -1:全部 |
rzzt | 认证状态 | varchar | 2 | 否 | 0:未认证 1:已认证 -1:全部 |
startRow | 开始行号 | varchar | 10 | 是 | 查询结果从第几条记录开始返回,第一次请求时为1 |
返回报文规范
{
"totalRows":"查询发票总条数",
"startRow":"开始行数",
"contentRows":"本次返回发票数量",
"invoicesData":[{
"fpdm":"发票代码",
"fphm":"发票号码",
"fplx":"发票类型",
"kprq":"开票日期",
"nsrsbh":"购方纳税人识别号",
"xfsbh":"销方税号",
"xfnsrmc":"销方名称",
"buyerName":"购方名称",
"buyerTaxNo":"购方税号",
"fpje":"发票金额",
"fpse":"发票税额",
"yxse":"有效税额",
"fpzt":"发票状态",
"gxzt":"勾选状态",
"gxsj":"勾选时间",
"rzzt":"认证状态",
"rzlx":"认证类型",
"rzrq":"认证日期",
"ssq":"认证所属期",
"xxly":"信息来源",
"glzt":"管理状态",
"bdkyy":"不抵扣原因",
"rkrq":"入电子底账库日期",
"jkshm":"缴款书号码(海关缴款书)",
"sqhdzt":"是否录入不符项(海关缴款书)",
"yt":"用途(海关缴款书)"
},{}]
}
字段说明
数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
---|---|---|---|---|---|
totalRows | 查询发票总条数 | varchar | 10 | 是 | |
startRow | 开始行数 | varchar | 10 | 是 | 满足查询调节的发票总量的第几行开始返回 |
contentRows | 本次返回的发票数量 | varchar | 10 | 是 | 本次返回的发票数量 |
invoicesData | 发票信息 | List | 以数组形式返回发票信息 | ||
fpdm | 发票代码 | varchar | 12 | ||
fphm | 发票号码 | varchar | 20 | ||
fplx | 发票类型 | varchar | 2 | 01:增值税专用发票 03:机动车销售统一发票 04:增值税普通发票 08:增值税电子专用发票或数电专票 10:增值税电子普票或数电普票 11:增值税普通发票(卷式) 14:通行费电子发票 15:二手车销售统一发票 85:数电纸质发票(增值税专用发票) 86:数电纸质发票(普通发票) 17:海关缴款书 51:电子发票(铁路电子客票) 71:电子发票(航空运输客票电子行程单) |
|
kprq | 开票日期 | varchar | 10 | yyyy-MM-dd | |
nsrsbh | 购方纳税人识别号 | varchar | 20 | ||
xfsbh | 销方税号 | varchar | 20 | ||
xfnsrmc | 销方名称 | varchar | 100 | ||
buyerName | 购方名称 | varchar | 100 | ||
buyerTaxNo | 购方税号 | varchar | 20 | ||
fpje | 发票金额 | varchar | 20 | (保留两位小数) | |
fpse | 发票税额 | varchar | 20 | (保留两位小数) | |
yxse | 有效税额 | varchar | 20 | (保留两位小数),该张发票要抵扣的税额,需小于等于发票税额 | |
fpzt | 发票状态 | varchar | 2 | 0:正常 1:已失控 2:已作废 3:已红冲 4:异常 5:认证异常 |
|
gxzt | 勾选状态 | varchar | 2 | 0:未勾选 1:抵扣已勾选 2:不抵扣已勾选 3:退税已勾选 |
|
gxsj | 勾选时间 | varchar | 10 | yyyy-MM-dd | |
rzzt | 认证状态 | varchar | 2 | 0:未认证 1:已认证 |
|
rzlx | 认证类型 | varchar | 2 | 1:抵扣 2:退税 4:不抵扣 |
|
rzrq | 认证日期 | varchar | 10 | 格式:yyyyMMdd(发票返回信息) | |
ssq | 认证所属期 | varchar | 6 | yyyyMM | |
xxly | 信息来源 | varchar | 2 | 0:扫描认证 1:系统推送 2:不予退税 3:数据采集 |
|
glzt | 管理状态 | varchar | 2 | 0:正常 1:异常 |
|
bdkyy | 不抵扣原因 | varchar | 2 | 1:用于非应税项目 2:用于免税项目 3:用于集体福利或者个人消费 4:遭受非正常损失 5:其他 |
|
rkrq | 入电子抵账库日期 | varchar | 10 | yyyy-MM-dd | |
jkshm | 海关缴款书号码 | varchar | 2 | (海关缴款书返回信息) | |
sqhdzt | 是否录入不符项 | varchar | 1 | 0:否 1:是(海关缴款书返回信息) |
|
yt | 用途 | varchar | 1 | 1:抵扣勾选 2:不抵扣勾选(海关缴款书返回信息) |