发票状态查询 - 用票管理

请求参数

Header 参数

nsrsbh

string

密钥所有方税号

可选

access_token

string

可选

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

fplx

string

可选

必传固定值“jxfp”

默认值:

jxfp

Body 参数application/json

fpdm

string

发票代码

可选

当若发票代码号码为空，则数电票号码必传。

<= 12 字符

fphm

string

发票号码

可选

当若发票代码号码为空，则数电票号码必传。

<= 8 字符

qdfphm

string

数电票号码

可选

当若数电票号码为空，则发票代码号码必传。

<= 20 字符

rqq

string

开票日期起

必需

yyyy-MM-dd

<= 10 字符

rqz

string

开票日期止

必需

yyyy-MM-dd

<= 10 字符

kjbq

string

开具标签

可选

1：开具，2：取得，不传默认查询取得

<= 2 字符

示例

{
    "fpdm": "string",
    "fphm": "string",
    "qdfphm": "string",
    "rqq": "string",
    "rqz": "string",
    "kjbq": "st"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://skynjweb.com:7443/hx/api/fp/51ys.jx.taxdigital.query.invoicequery' \
--header 'nsrsbh;' \
--header 'access_token;' \
--header 'fplx: jxfp' \
--header 'Content-Type: application/json' \
--data-raw '{
    "fpdm": "string",
    "fphm": "string",
    "qdfphm": "string",
    "rqq": "string",
    "rqz": "string",
    "kjbq": "st"
}'

返回响应

🟢200成功

application/json

Body

qdfphm

string

数电票号码

可选

<= 20 字符

fphm

string

发票号码

可选

<= 8 字符

fpdm

string

发票代码

可选

<= 12 字符

hjje

可选

hjse

可选

fply

string

发票来源

可选

1:增值税发票管理系统 2:电子发票服务平台

<= 1 字符

fplx

string

票种

可选

81 数电票（增值税专用发票）82 数电票（普通发票）85 数电纸质发票（增值税专用发票）86 数电纸质发票（普通发票）08 增值税电子专用发票10增值税电子普通发票增值税电子普通发票 01 增值税专用发票 04 增值税普通发票 03 机动车销售统一发票 15 二手车销售统一发票 11 增值税普通发票（卷式）14 道路通行费电子普通发票 61 数电票（航空运输电子客票行程单）51 数电票（铁路电子客票）

<= 2 字符

fpzt

string

发票状态

可选

01:正常 02:已作废 03:已红冲-全额 04:已红冲-部分

<= 2 字符

sflzfp

string

是否为蓝字发票

可选

Y:蓝字发票 N:红字发票

<= 1 字符

lzfphm

string

蓝字发票号码

可选

xfsbh

string

销方纳税人识别号

可选

<= 20 字符

xfnsrmc

string

销方名称

可选

<= 200 字符

gfsbh

string

购方纳税人识别号

可选

<= 20 字符

gfnsrmc

string

购方名称

可选

<= 200 字符

gfssjswjgdm

string

购方省级税务机构代码

可选

<= 11 字符

gfssjswjgmc

string

购方省级税务机构名称

可选

<= 50 字符

gfdz

string

购方地址

可选

<= 200 字符

gflxdh

string

购方联系电话

可选

<= 20 字符

gfnsryh

string

购方开户银行

可选

<= 200 字符

gfnsryhzh

string

购方开户银行账号

可选

<= 100 字符

xhfdz

string

销方地址

可选

<= 200 字符

xhflxdh

string

销方联系电话

可选

<= 20 字符

Xfnsryh

string

销方开户银行

可选

<= 200 字符

Xfnsryhzh

string

销方开户银行账号

可选

<= 100 字符

xfsskssq

string

消费税勾选属期

可选

企业当前所属期当前所属期 yyyyMM

<= 6 字符

zzsskssq

string

增值税勾选属期

可选

企业当前所属期当前所属期 yyyyMM

<= 6 字符

xfsytmc

string

消费税用途标签

可选

<= 10 字符

zzsytmc

string

增值税用途标签

可选

"未使用":发票未勾选，"已勾选（抵扣）":发票抵扣类勾选，"不抵扣不退税不代办退税":发票不抵扣勾选，"已抵扣":发票已认证，"待抵扣":当期已勾选（已确认签名状态），"已勾选（退税）":退税勾选，"待退税":当期以退税勾选（已确认签名状态），"已退税"

<= 30 字符

fprzztmc

string

发票入账状态

可选

<= 10 字符

rzsj

string

发票入账时间

可选

<= 6 字符

fpxzcs

string

发票下载次数

可选

Kprq

string

Kprq

可选

fxdjdm

string

fxdjdm

可选

示例

{
    "qdfphm": "91110000710927388B",
    "fphm": "8*****04",
    "fpdm": "0440****211",
    "Kprq": "2022-07-04 09:48:00",
    "hjje": 801,
    "hjse": 0,
    "fply": "1",
    "fplx": "10",
    "fxdjdm ": "01",
    "fpzt": "01",
    "sflzfp": "Y",
    "lzfphm": "",
    "xfsbh": "9244********T9P3XY",
    "xfnsrmc": "XXX有限公司",
    "gfsbh": "91110000710927388B ",
    "gfnsrmc": "XXX有限公司",
    "gfssjswjgdm": "14400000000",
    "gfssjswjgmc": "国家税务总局广***",
    "gfdz": "广州市********",
    "gflxdh": "020-89312788",
    "gfnsryh": "中国工商银行 XXX支行",
    "gfnsryhzh": "3602********6739",
    "xhfdz": "广州市********",
    "xhflxdh": "159****7108",
    "Xfnsryh": "中信银行股份有限公司 XXX支行",
    "Xfnsryhzh": "8110**********4270",
    "xfsskssq": "",
    "zzsskssq": "",
    "xfsytmc": "未使用",
    "zzsytmc": "未使用",
    "fprzztmc": "未入账",
    "fpxzcs": "0",
    "rzsj": "未入账"
}