2.4.2新版发票查验接口 - 百旺金穗云-SaaS标准化接口

对接税局查验平台，根据发票基本票面元素进行发票真伪性查验。查验成功后可返回发票全票面信息。仅对增值税类发票进行查验。详情可查看：【采集发票业务类型代码】。可查验前提：网关密钥正确，企业识别查验剩余次数充足。
通道支持情况：
增值税发票查验平台

请求参数

Header 参数

Content-Type

string

必需

默认值:

application/json

Date

string

必需

默认值:

host

string

必需

默认值:

x-htjs-nonce

string

必需

默认值:

x-htjs-ua

string

必需

默认值:

Authorization

string

必需

默认值:

Body 参数application/json

czlsh

string

操作流水号，不允许为空，长度32以内，建议UUID

必需

jtNsrsbh

string

集团税号，填写集团计次或计费税号

必需

nsrsbh

string

纳税人税号，填写操作企业税号

必需

nsrmc

string

纳税人名称，填写操作企业名称

必需

czr

string

操作人

必需

fplxdm

string

发票类型代码

必需

fpdm

string

发票代码（数电票可为空）

可选

fphm

string

发票号码

必需

kprq

string

开票日期，格式yyyyMMdd

必需

hjje

string

合计金额，专票不能为空

可选

jshj

string

价税合计，全电票不能为空

可选

jym

string

校验码，与开具金额二选一传递,税控普票时填写校验码后六位（区块链发票时，校验码传后五位）

可选

示例

{
  "czlsh": "1111",
  "jtNsrsbh": "",
  "nsrsbh": "",
  "nsrmc": "",
  "czr": "",
  "fplxdm": "",
  "fpdm": "",
  "fphm": "",
  "kprq": "",
  "hjje": "",
  "jshj": "",
  "jym": ""
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

success

boolean

操作是否成功，true 表示成功

必需

code

integer

返回码，0 表示成功，其他值表示失败

必需

msg

string

提示信息

必需

data

object

返回的报文数据

必需

fpzlid

string

发票种类 ID

必需

fpzlmc

string

发票种类名称

必需

fpdm

string

发票代码

必需

fphm

string

发票号码

必需

jym

string

校验码

必需

kprq

string

开票日期

必需

gfmc

string

购方名称

必需

gfsh

string

购方税号

必需

gfyhzh

string

购方银行账号

必需

gfdzdh

string

购方地址电话

必需

xfmc

string

销方名称

必需

xfsh

string

销方税号

必需

xfyhzh

string

销方银行账号

必需

xfdzdh

string

销方地址电话

必需

hjje

string

合计金额

必需

hjse

string

合计税额

必需

jshj

string

价税合计

必需

string

备注

必需

tdysType

string

特定要素类型

必需

provinceName

string

省份名称

必需

invoiceStatus

string

发票状态代码

必需

invoiceStatusDesc

string

发票状态描述

必需

checkTimes

string

查验次数

必需

checkTimeStr

string

查验时间

必需

cyptBase64Str

string

查验平台截图（Base64 编码）

必需

cyjg

string

查验结果

必需

msg

string

查验返回信息

必需

spmxList

array [object {9}]

商品明细列表

必需

vatCarInvoiceDetailsDTO

object

机动车发票详情

必需

escDetail

object

二手车发票详情

必需

txfmxList

array [object {8}]

通行费发票详情

必需

示例

{
	"success": true,
  "code": 0,
	"msg": "操作成功",
	"data": {
		"fpzlid": "09",
		"fpzlmc": "河南增值税电子普通发票",
		"fpdm": "",
		"fphm": "24412*****2733318",
		"jym": "244120********2733318",
		"kprq": "20***216",
		"gfmc": "广*****司",
		"gfsh": "91******34W",
		"gfyhzh": "",
		"gfdzdh": "",
		"xfmc": "",
		"xfsh": "",
		"xfyhzh": "",
		"xfdzdh": "",
		"hjje": "397.35",
		"hjse": "51.65",
		"jshj": "449.00",
		"bz": "",
		"kpr": ,
		"fhr": ,
		"skr": ,
		"tdysType": "",
		"provinceName": "河南",
		"invoiceStatus": "0",
		"invoiceStatusDesc": "",
		"checkTimes": "6",
		"checkTimeStr": "2024-06-20 09:48:37",
		"cyptBase64Str": "",
    "cyjg":"查验结果",
    "msg":"查验返回信息",
		"spmxList": [{
			"xh": "1",
			"spmc": "*乙醇汽油*95号车用乙醇汽油（E10）VIB",
			"ggxh": "95#",
			"jldw": "升",
			"dj": "7.3982300884956",
			"sl": "53.7081339712919",
			"je": "397.35",
			"slv": "13.0",
			"se": "51.65"
		}],
		"vatCarInvoiceDetailsDTO": {
			"carType": "",
			"brandModel": "",
			"producer": "",
			"certificate": "",
			"importCertificateNo": "",
			"taxPaymentCertificateNo": "",
			"commodityInspectionNo": "",
			"engineNo": "",
			"frameNo": "",
			"telNo": ,
			"tonnage": "",
			"personNum": "",
			"carTaxRate": "",
			"bak1": ,
			"bak2": 
		},
		"escDetail": {
			"cpzh": "",
			"djzh": "",
			"cllx": "",
			"cjh": "",
			"cpxh": "",
			"zrdclgls": "",
			"jydw": "",
			"jydwdz": "",
			"jydwnsrsbh": "",
			"jydwkhyhzh": "",
			"jydwdh": "",
			"escsc": "",
			"escnsrsbh": "",
			"escdz": "",
			"esckhyhzh": "",
			"escdh": ""
		},
		"txfmxList": [{
			"xmmc": "",
			"cph": "",
			"lx": "",
			"txrqq": "",
			"txrqz": "",
			"je": "",
			"slv": "",
			"se": ""
		}]
	}	
}