发票查询

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[]	1	验签结果 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[]	30	开票终端标识
fplxdm	否	string[]	3	发票类型代码 004：增值税专用发票 007：增值税普通发票 025：卷式发票 026：增值税电子普通发票 005：机动车发票 006：二手车销售统一发票 028：增值税电子专用发票 81：电子发票(增值税专用发票) 82：电子发票(增值税普通发票) 85 纸质专票(全电) 86纸质普票(全电)
fpzt	否	string[]	2	发票状态 00：已开具的正数发票 01：已开具的负数发票 02：未开具发票的作废发票 03：已开具正数发票的作废发票 04：已开具负数发票的作废发票
fply	否	string[]	2	发票来源 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		发票请求流水号

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	20	购货单位识别号
ghdwmc	否	string	128	购货单位名称
ghdwdzdh	否	string	128	购货单位地址电话
ghdwyhzh	否	string	128	购货单位银行帐号
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	16	开票申请人
kpr	否	string	40	开票人
bz	否	string	1000	备注
url	否	string	255	电子普通发票版式式文件地址
qdbz	否	string	1	清单标志 0：无清单 1：带清单
xhdwmc	否	string	128	销方单位名称
zsfs	否	string	2	征税方式 0：普通征税 2：差额征税
pdfurl	否	string	255	pdfurl（数电返回）
ewmurl	否	string	255	二维码路径（数电返回）
ofdurl	否	string	255	ofdurl（数电返回）
xmlurl	否	string	255	xmlurl（数电返回）
sdfphm	否	string	20	数电发票号码
gwmc	否	string	100	岗位名称
fpqqlsh	否	string	255	发票请求流水号
sbyy	否	string	255	失败原因

application/json

Body

code

integer

返回代码

必需

返回代码

msg

string

返回消息

必需

返回消息

data

object

返回数据

可选

返回数据

count

integer

必需

pageNum

integer

必需

dataList

array [object {32}]

必需

示例

{
  "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": "失败原因"
      }
    ]
  }
}

1、接口及场景描述#

2、请求参数#

3、返回参数#

请求参数

返回响应

1、接口及场景描述

2、请求参数

3、返回参数