发票查询

1、接口及场景描述

接口描述：根据查询条件获取企业的发票信息
是否支持数电及税控发票：全部支持

2、请求参数

字段名称	必选	类型	长度	字段含义及备注
pageNum	否	integer		页码 [大小： 1~] 默认为1
pageSize	否	integer		每页显示数量 [大小： 1~5000] 默认为10
request	是	object		请求对象
sfhlgwcxtj	否	string	1	是否忽略岗位查询条件发票查询列表，默认查询的是当前岗位的发票信息，若忽略，则不只查询当前岗位的信息 0:不忽略 1:忽略默认为：0
gwmc	否	string	255	岗位名称当“sfhlgwcxtj”字段传0时：【1】“gwmc”字段如果传值时，则按照传入的岗位名称进行查询【2】“gwmc”字段为空时，则按照该账号下默认岗位进行查询
yqjg	否	string[]		验签结果 0：验签失败 1：验签成功 2：待验签 99：无需验签 00: 乐企上传成功 01: 乐企上传中 02: 乐企上传失败（上传失败状态的发票数据） 03: 乐企未上传 04: 乐企重复上传
kprqq	否	string		开票日期起格式：yyyy-MM-dd
kprqz	否	string		开票日期止格式：yyyy-MM-dd
djlsh	否	string	100	单据流水号（模糊查询）
ghdwmc	否	string	128	购货单位名称（模糊查询）
ghdwsbh	否	string	20	购货单位识别号（模糊查询）
fphm	否	string	20	发票号码
fpdm	否	string	20	发票代码
bz	否	string	100	备注（模糊查询）
kpsqr	否	string	16	开票申请人（模糊查询）
kpr	否	string	40	开票人（模糊查询）
kpzdbs	否	string[]		开票终端标识
fplxdm	否	string[]		发票类型代码 004：增值税专用发票 007：增值税普通发票 025：卷式发票 026：增值税电子普通发票 005：机动车发票 006：二手车销售统一发票 028：增值税电子专用发票 81：电子发票(增值税专用发票) 82：电子发票(增值税普通发票) 85 纸质专票(全电) 86纸质普票(全电)
fpzt	否	string[]		发票状态 00：已开具的正数发票 01：已开具的负数发票 02：未开具发票的作废发票 03：已开具正数发票的作废发票 04：已开具负数发票的作废发票
fply	否	string[]		发票来源 0：待开导入 1：待开接口对接 2：单据导入 3：单据接口对接 4：发票填开 5：发票修复 6：发票库存查询 7：发票查询 8：红字确认单
zsfs	否	string	1	征税方式 0：普通征税 2：差额征税
sdfphm	否	string	20	数电发票号码
hjjeq	否	string		合计金额起
hjjez	否	string		合计金额止
hjseq	否	string		合计税额起
hjsez	否	string		合计税额止
jshjq	否	string		价税合计起
jshjz	否	string		价税合计止
sjly	否	string	255	数据来源
fpqqlsh	否	string		发票请求流水号
tszt	否	string		推送状态 0:未推送 1:已推送

3、返回参数

字段名称	是否必返回	类型	长度	字段含义及备注
code	是	integer		返回代码
msg	是	string		返回消息
data	否	object		返回数据
id	否	string	20	发票唯一编码（由发票代码和发票号码组成）
yqjg	否	string	2	验签结果 0：验签失败 1：验签成功 2：待验签 99：无需验签 00: 乐企上传成功 01: 乐企上传中 02: 乐企上传失败（上传失败状态的发票数据） 03: 乐企未上传 04: 乐企重复上传
kprq	否	string	14	开票日期格式：yyyyMMddHHmmss
djlsh	否	string	100	单据流水号
fpdm	否	string	20	发票代码
fphm	否	string	20	发票号码
ghdwsbh	否	string		购货单位识别号
ghdwmc	否	string		购货单位名称
ghdwdzdh	否	string		购货单位地址电话
ghdwyhzh	否	string		购货单位银行帐号
hjje	否	string	32	合计金额
hjse	否	string	32	合计税额
jshj	否	string	32	价税合计
fpzt	否	string	2	发票状态 00：已开具的正数发票 01：已开具的负数发票 02：未开具发票的作废发票 03：已开具正数发票的作废发票 04：已开具负数发票的作废发票
kpzdbs	否	string	30	开票终端标识
fplxdm	否	string	3	发票类型代码 004：增值税专用发票 007：增值税普通发票 025：卷式发票 026：增值税电子普通发票 005：机动车发票 006：二手车销售统一发票 028：增值税电子专用发票 81：电子发票(增值税专用发票) 82：电子发票(增值税普通发票)
fply	否	string	2	发票来源 0：待开导入 1：待开接口对接 2：单据导入 3：单据接口对接 4：发票填开 5：发票修复 6：发票库存查询 7：发票查询 8：红字确认单
kpsqr	否	string		开票申请人
kpr	否	string		开票人
bz	否	string		备注
url	否	string		电子普通发票版式式文件地址
qdbz	否	string	1	清单标志 0：无清单 1：带清单
xhdwmc	否	string		销方单位名称
zsfs	否	string	1	征税方式 0：普通征税 2：差额征税
pdfurl	否	string		pdfurl（数电返回）
ewmurl	否	string		二维码路径（数电返回）
ofdurl	否	string		ofdurl（数电返回）
xmlurl	否	string		xmlurl（数电返回）
sdfphm	否	string	20	数电发票号码
gwmc	否	string		岗位名称
fpqqlsh	否	string		发票请求流水号
sbyy	否	string		失败原因
tszt	否	string		推送状态 0:未推送 1:已推送
yx	否	string		推送邮箱
sjh	否	string		推送手机号
zrrzjlxDm	否	string	16	自然人证件类型代码 201:居民身份证 208:外国护照 210:港澳居民来往内地通行证 213:台湾居民来往大陆通行证 227:中国护照 233:外国人永久居留身份证（外国人永久居留证） 237:中华人民共和国港澳居民居住证 238:中华人民共和国台湾居民居住证 299:其他个人证件(机动车、二手车统一销售票时有)
zrrzjhm	否	string	16	自然人证件号码

application/json

Body

示例

{
    "code": 0,
    "msg": "成功",
    "data": {
        "count": 1,
        "pageNum": 1,
        "dataList": [
            {
                "id": "发票唯一编码",
                "yqjg": "验签结果",
                "kprq": "开票日期",
                "djlsh": "单据流水号",
                "fpdm": "发票代码",
                "fphm": "发票号码",
                "ghdwsbh": "购货单位识别号",
                "ghdwmc": "购货单位名称",
                "ghdwdzdh": "购货单位地址电话",
                "ghdwyhzh": "购货单位银行帐号",
                "hjje": "合计金额",
                "hjse": "合计税额",
                "jshj": "价税合计",
                "fpzt": "发票状态",
                "kpzdbs": "开票终端标识",
                "fplxdm": "发票类型代码",
                "fply": "发票来源",
                "kpsqr": "开票申请人",
                "kpr": "开票人",
                "bz": "备注",
                "url": "电子普通发票版式式文件地址",
                "qdbz": "清单标志",
                "xhdwmc": "销方单位名称",
                "zsfs": "征税方式",
                "pdfurl": "pdfurl（全电有）",
                "ewmurl": "二维码路径（全电有）",
                "ofdurl": "ofdurl（全电有）",
                "xmlurl": "xmlurl（全电有）",
                "sdfphm": "数电发票号码",
                "gwmc": "岗位名称",
                "fpqqlsh": "发票请求流水号",
                "sbyy": "失败原因",
                "tszt": "推送状态",
                "yx": "推送邮箱",
                "sjh": "推送手机号",
                "zrrzjlxDm": "自然人证件类型代码",
                "zrrzjhm": "自然人证件号码"
            }
        ]
    }
}

1、接口及场景描述#

2、请求参数#

3、返回参数#

请求参数

返回响应

1、接口及场景描述

2、请求参数

3、返回参数