发票信息查询（数电板式和全票面信息）

1.概述：

本接口用于实时查询发票信息、板式文件下载地址、发票用途信息。针对数电试点企业包含：全票面信息，版式文件（包含OFD、PDF、XML）下载地址，附加信息，特定要素信息等；非数电试点企业（综服企业）：仅能获取数电发票的板式文件（包含OFD、PDF、XML）下载地址。

接口：ip:port/invoice/S000522
使用电票平台开具的数电发票板式文件（ofd、pdf、xml）需要鉴权查询，支持数电专票、数电普票、数电（铁路），数电（航空），调用S000522获取。
税务ukey开具的电子发票板式文件（pdf、ofd）只需要查验即可获取。
第三方电子发票平台开具的，暂时不能直接获取板式文件。
新增查询发票状态信息，包含发票状态、入账状态、增值税用票状态、消费税用票状态。
新增模式，可按需选择是否需要全票面信息、板式文件下载地址、发票用途信息。

2.请求数据：

数据格式

json

{
  "appid": "xxx",
  "serviceid": "S000522",
  "jtnsrsbh": "xxxxxxx",
  "nsrsbh": "xxxxxxx",
  "content": "",
  "signature": "xxxxxxxxxxxxxxxxx",
  "signType": "0"
}

其中：content样例:

json

{
  "InvoiceCode": "011001700112",
  "InvoiceNumber": "15323546",
  "BillingDate": "2019-06-20"
}

字段说明

ID	名称	长度	必须	说明
InvoiceCode	发票代码	12	是	全电发票时可为空
InvoiceNumber	发票号码	8	是	全电发票时为20位
BillingDate	开票日期	19	是	若有时分秒，则传：YYYY-MM-DD HH:mm:ss若没有时分秒，则传：YYYY-MM-DD
DataType	数据类型	2	是	1：进项 2：销项默认值1,如果查销项发票，本字段请传2
IsQd	是否获取全电发票板式	2	否	该字段用于获取综服中的全电发票板式文件 0：获取增值税发票主信息 1：获取板式文件,默认值0 全电试点企业获取可不传。
InvoiceType	发票类型	6	否	该字段用于获取综服中的全电发票板式文件时必填 31：全电专票 32：全电普票，综服还不支持获取数电火车票和数电飞机票板式文件全电试点企业获取可不传。
returnsjurl	返回税局地址	1	否	该字段用于获取数电试点企业中的全电发票板式文件,若传值为1，则返回税局的板式文件下载地址。传0，则返回封装后地址。默认1
useNew	是否使用新方式	1	否	1新方式，0原有方式。该字段用于选择是否使用新方式，新方式可自由组合全票面、数电板式、发票用途信息
dtInvoiceDetail	不需要明细信息	1	否	新方式时才生效, 1不需要，0需要，默认0
dtInvoiceFile	不需要板式文件	1	否	新方式时才生效, 1不需要，0需要，默认0
wtInvoiceUsage	需要发票用途信息	1	否	新方式时才生效, 1需要（结果返回用途信息），0不需要，默认0

3.请求方式：

POST

4.返回数据：

ID	名称	长度	必须	说明
fpdm	发票代码	12	是
fphm	发票号码	8	是
kprq	开票日期	10	是	YYYY-MM-DD
je	金额	20	是
se	税额	20	是
jshj	价税合计	20	是
jym	校验码	25	是
fplx	发票类型	2	是	详见4.1 发票类型代码表
fpzt	发票状态	2	是	0正常 1作废 2红冲 3失控 4异常 80红字发票待确认 7部分红冲 8全额红冲
gfsh	购方税号	20	是
gfmc	购方名称	100	是
gfdzdh	购方地址电话	200	否
gfyhzh	购方银行账号	200	否
xfsh	销方税号	20	是
xfmc	销方名称	100	是
xfdzdh	销方地址电话	200	是
xfyhzh	销方银行账号	200	是
kpr	开票人	10	是
fhr	复核人	10	否
skr	收款人	10	否
jqbh	机器编号	20	否
bz	备注	200	否
ewmFile	收票二维码地址	500	否	全电发票时返回
ofdFile	Ofd文件地址	500	否	全电发票时返回，若为综服全电发票，则只返回ofdFile、pdfFile、xmlFile
pdfFile	Pdf文件地址	500	否	全电发票时返回
xmlFile	Xml文件地址	500	否	全电发票时返回
lzfphm	蓝字发票号码	30	否	数电试点企业-数电负数发票时返回。
fpxx	发票全票面信息	JsonObject	否	发票全票面信息 useNew=0时返回；useNew=1并且dtInvoiceDetail=0时返回
invoiceUsage	发票用途信息	JsonObject	否	发票用途信息 useNew=0时返回；useNew=1并且wtInvoiceUsage=1时返回

数电试点企业的fpxx节点信息：

ID	名称	类型	必须	说明	备注
bz	备注	string	是
ewm	二维码	string	是
fplxdm	发票类型代码	string	是	详见码表《4.1 发票类型代码表》
tdyslxdm	特定要素类型代码	string	是	详见码表《4.2 特定要素类型代码》
fhr	复核人	string	是		2023-06-12
fpdm	发票代码	string	否	数电纸票或增值税发票	2023-06-29
fphm	全电发票号码	string	是	数电票或增值税发票	2023-06-29
fjxxList	附加信息集合	array	否
fjxxmc	附加信息名称	string	否
fjxxnr	附加信息内容	string	否
gmfdzdh	购买方地址电话	string	是	仅用于增值税发票	2023-06-12
gmfdz	购买方地址	string	是	仅用于数电票
gmflxdh	购买方联系电话	string	是
gmfkhhzh	购买方开户行账号	string	是	仅用于增值税发票	2023-06-12
gmfkhh	购买方开户行	string	是	仅用于数电票	2023-06-12
gmfyhzh	购买方银行账号	string	是
gmfmc	购买方名称	string	是
gmfnsrsbh	购买方税号	string	是
hjje	合计金额	string	是
hjse	合计税额	string	是
jshj	价税合计	string	是
jym	校验码	string	是	增值税发票必填
kce	扣除额	string	否
kjlx	开具类型	string	是	0-蓝票 1-红票
kpr	开票人	string	是
kprq	开票日期	string	是	格式：yyyy-MM-dd HH:mm:ss
xsfdz	销售方地址	string	是
xsfdzdh	销售方地址电话	string	是	仅用于增值税发票	2023-06-29
xsflxdh	销售方联系电话	string	是
xsfkhh	销售方开户行	string	是
xsfkhhjzh	销售方开户行及账号	string	是	仅用于增值税发票	2023-06-29
xsfyhzh	销售方银行账号	string	是
xsfmc	销售方名称	string	是
xsfnsrsbh	销售方税号	string	是
yfpdm	原发票代码	string	否	仅用于增值税发票	2023-07-25
yfphm	原发票号码	string	否	仅用于增值税发票	2023-07-25
zzfphm	数电纸质发票号码	string	否		2023-06-29
zzsFpdm	增值税发票代码	string	否		2023-06-29
zzsFphm	增值税发票号码	string	否		2023-06-2
jdcxsTdysList	机动车特定要素列表	jsonArray	否	发票类型为03时返回，详见jdcxsTdysList说明	2024-02-29
escTdysList	二手车特定要素列表	jsonArray	否	发票类型为04时返回，详见escTdysList说明	2024-02-29
DzfpKpywTdysTldzkp	铁路电子客票信息	jsonObject	否	发票类型为51时返回，详见DzfpKpywTdysTldzkp说明	2024-02-29
HkysdzkpxcdVO	航空电子客票信息	jsonObject	否	发票类型为61时返回，详见HkysdzkpxcdVO说明	2024-12-20
mxList	明细集合	jsonArr	是
tdywxx	特定业务信息	jsonObject	否	详见：旅客运输服务 lkysfw 说明
BdcTdysfpList	不动产租赁	jsonArray	否	详见BdcTdysfpList说明	2024-12-23

发票信息查询（数电板式和全票面信息） ​

1.概述： ​

2.请求数据： ​

数据格式 ​

字段说明 ​

3.请求方式： ​

4.返回数据： ​

数电试点企业的fpxx节点信息： ​

发票信息查询（数电板式和全票面信息）

1.概述：

2.请求数据：

数据格式

字段说明

3.请求方式：

4.返回数据：

数电试点企业的fpxx节点信息：