发票列表查询（蓝\红票）（金三+金四）

请求参数

Header 参数

nsrsbh

string

接口调用方税号

可选

access_token

string

可选

通过“获取access_token”接口获取，除“获取access_token”接口外，其余接口访问均需携带此参数

Body 参数application/json

gjbq

string

归集标签（查询类型）需有值

必需

1 开具的发票2 取得的发票

<= 20 字符

fpzt_dm

string

发票状态代码

可选

发票的状态代码"01": "正常","02": "已作废","03": "已红冲-全额","04": "已红冲-部分"

<= 2 字符

fply_dm

string

发票来源代码

必需

发票来源代码"0": "全部","1": "增值税发票管理系统","2": "电子发票服务平台"

<= 1 字符

fplx_dm

string

发票类型代码（发票种类）

可选

发票类型代码（发票种类）电子发票服务平台（金四发票）：81=数电票（增值税专用发票）82=数电票（普通发票）83=数电票（机动车销售电子统一发票）84=数电票（二手车销售电子统一发票）85=数电纸质发票（增值税专用发票）86=数电纸质发票（普通发票）87=数电纸质发票（机动车销售统一发票）88=数电纸质发票（二手车销售统一发票）61=数电票（航空运输电子客票行程单）51=数电票（铁路电子客票）增值税发票管理系统（金三发票）:08=增值税电子专用发票10=增值税电子普通发票01=增值税专用发票04=增值税普通发票03=机动车销售统一发票15=二手车销售统一发票11=增值税普通发票（卷式）14=道路通行费电子普通发票

<= 2 字符

kprqq

string

开票日期起

必需

开票起始日期格式：yyyy-mm-dd

<= 10 字符

kprqz

string

开票日期止

必需

开票日期止格式：yyyy-mm-dd

<= 10 字符

tfrqq

string

填发日期起

可选

填发日期起格式：yyyy-mm-dd

<= 10 字符

tfrqz

string

填发日期止

可选

填发日期止格式：yyyy-mm-dd

<= 10 字符

fp_hm

string

发票号码

可选

/20 否数电发票号码

<= 18 字符

zzfpdm

string

纸质发票代码

可选

/12 否

<= 10 字符

zzfphm

string

纸质发票号码

可选

<= 8 字符

dfnsrsbh

string

对方纳税人识别号

可选

dfnsrmc

string

对方纳税人名称

可选

ghf_nsrsbh

string

购买方纳税人识别号

可选

ghf_mc

string

购买方名称

可选

query_dj_flag

string

查询标志

可选

查询标志；true:查电局false:查本地；默认查税局

qyswjg_dm

string

企业税务机关代码

可选

根据企业归属地信息查询接口返回的税务机关代码进行传值；如查询湖北，则传14200000000；这个参数只支持查税局。

cxym

integer

查询页码

必需

integer

页大小

必需

最多 100条

<= 18

示例

{
    "gjbq": "string",
    "fpzt_dm": "st",
    "fply_dm": "s",
    "fplx_dm": "st",
    "kprqq": "string",
    "kprqz": "string",
    "tfrqq": "string",
    "tfrqz": "string",
    "fp_hm": "string",
    "zzfpdm": "string",
    "zzfphm": "string",
    "dfnsrsbh": "string",
    "dfnsrmc": "string",
    "ghf_nsrsbh": "string",
    "ghf_mc": "string",
    "query_dj_flag": "string",
    "qyswjg_dm": "string",
    "cxym": 0,
    "ts": 18
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

cxym

integer

当前页码

可选

当前页码

integer

页大小

可选

页大小

total

integer

总条数

可选

总条数List 发票集合

List

array [object {28}]

可选

gjbq

string

归集标志（查询类型）

可选

1-开具发票2-取得发票

<= 1 字符

fp_hm

string

发票号码

可选

数电发票号码

<= 20 字符

zzfphm

string

纸质发票代码

可选

，12 否

<= 10 字符

zzfp_dm

string

纸质发票号码

可选

<= 8 字符

fply_dm

string

发票来源代码

可选

0-全部1-增值税发票管理系统2-电子发票服务平台

fplx_dm

string

发票类型代码

可选

81-数电发票（增值税专用发票）82-数电发票（普通发票)

<= 2 字符

fpzl_dm

string

发票种类代码

可选

01：增值税专用发票（对应全电发票类型代码81）02：普通发票（对应全电发票类型代码 82）03：机动车统一销售发票（对应全电发票类型代码 83）04：二手车统一销售发票（对应全电发票类型代码 84）05：铁路电子客票06：航空运输客票电子行程单

<= 2 字符

tdyslx_dm

string

特定元素代码

可选

特定要素类型代码01-成品油发票,02-稀土发票,03-建筑服务发票,04-货物运输服务发票,05-不动产销售服务发票,06-不动产经营租赁服务,07-代收车船税,08-通行费,09-旅客运输服务发票10-医疗服务（住院）发票,11-医疗服务（门诊）发票,12-自产农产品销售发票,13-拖拉机和联合收割机发票,14-机动车,15-二手车,16-农产品收购发票,17-光伏收购发票,18-卷烟发票,

<= 2 字符

fpzt_dm

string

发票状态代码

可选

发票的状态代码01-正常,02-已作废,03-已红冲-全额,04-已红冲-部分

<= 2 字符

sflzfp

string

是否蓝字发票

可选

Y-蓝字发票N-非蓝字发票

<= 1 字符

kjhzfpdydlzfphm

string

开具红字发票对应的蓝字发票号码

可选

数电发票号码

<= 20 字符

kpfnsrsbh

string

开票方纳税人识别号

可选

<= 20 字符

xhf_nsrsbh

string

销售方纳税人识别号

可选

<= 20 字符

xhf_mc

string

销售方名称

可选

ghf_nsrsbh

string

购买方纳税人识别号

可选

ghf_mc

string

购买方名称

可选

kprq

string

开票日期

可选

开票日期格式：yyyy-mm-ddHH:mm:ss

<= 19 字符

hjje

string

合计金额

可选

hjse

string

合计税额

可选

cezslx_dm

string

差额征税类型代码

可选

fpkjfs_dm

string

发票开具方式代码

可选

fpkjfxlx_dm

string

发票开具风险类型代码

可选

01 正常02 异常03 疑点

<= 2 字符

kpr

string

开票人

可选

jshj

string

价税合计

可选

,2 否

<= 16 字符

gmfjbr

string

购买方经办人

可选

gmrzrrbz

string

购买方自然人标志

可选

Y 是自然人N 不是自然人

gmfssjswjgdm

string

购买方省市级税务机关代码

可选

31, xsfssjswjgdm 销售方省市级税务机关代码varchar 否

xsfssjswjgdm

string

xsfssjswjgdm

可选

示例

{
    "cxym": "当前页码",
    "ts": "页大小",
    "total": "总条数",
    "List": [
        {
            "gjbq": "归集标志（查询类型）",
            "fp_hm": "发票号码",
            "zzfphm": "纸质发票代码",
            "zzfp_dm": "纸质发票号码",
            "fply_dm": "发票来源代码",
            "fplx_dm": "发票类型代码",
            "fpzl_dm": "发票种类代码",
            "tdyslx_dm": "",
            "fpzt_dm": "发票状态代码",
            "sflzfp": "是否蓝字发票",
            "kjhzfpdydlzfphm": "开具红字发票对应的蓝字发票号码",
            "kpfnsrsbh": "开票方纳税人识别号",
            "xhf_nsrsbh": "销售方纳税人识别号",
            "xhf_mc": "销售方名称",
            "ghf_nsrsbh": "购买方纳税人识别号",
            "ghf_mc": "购买方名称",
            "kprq": "开票日期 格式：yyyy-mm-dd hh:mm:ss",
            "hjje": "合计金额",
            "hjse": "合计税额",
            "cezslx_dm": "差额征税方式代码",
            "fpkjfs_dm": "发票开具方式代码",
            "fpkjfxlx_dm": "发票风险类型代码",
            "kpr": "开票人",
            "jshj": "价税合计",
            "gmfjbr": "购买方经办人",
            "gmrzrrbz": "购买方自然人标志",
            "gmfssjswjgdm": "购买方省市级税务机关代码",
            "xsfssjswjgdm": "销售方省市级税务机关代码"
        }
    ]
}