发票主体信息下载

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:不抵扣勾选(海关缴款书返回信息)
Copyright © Shanghai Aisino Co.,Ltd 版权所有 侵权必究该文件修订时间: 2025-03-31 16:08:29

results matching ""

    No results matching ""