查验接口

请求地址：/api/invoice/check

http请求方式：POST

接口诞生版本：

所属系统：π平台

接口说明：用于企业查验票据

单次调用最大条数：1

使用场景

当前支持查验的发票类型：增值税普通发票（卷票）/11、机动车销售统一发票/12、二手车销售统一发票/13、增值税专用发票/14、增值税专用发票（成品油）/15、增值税普通发票/16、增值税电子普通发票/17、增值税电子普通发票（通行费）/18、区块链发票/19、增值税电子专用发票/21、电子发票（普通发票）/31、电子发票（增值税专用发票）/32、电子发票（航空运输电子客票行程单）/38、电子发票（铁路电子客票）/39等等。其中，全电纸质发票(增值税专用发票)映射至增值税专用发票/14，全电纸质发票(增值税普通发票)映射到增值税电子普通发票/17、

请求报文

请求参数：
派平台
字段编码	类型	是否必填	字段名称	说明
billingNo	String	是	发票代码	长度10位或12位，全电发票非必填
billingCode	String	是	发票号码	长度8位或20位
billingTime	String	是	开票时间	格式为yyyy-MM-dd
checkCode	String	否	校验码	增值税普通发票、增值税电子普通发票、增值税普通发票（卷式）、增值税电子普通发票（通行费）必填，为校验码后六位；区块链必填，为五位
feeWithoutTax	String	否	发票金额	增值税专用发票、增值税电子专用发票、机动车销售统一发票、区块链发票必填，为不含税金额；二手车销售统一发票、全电发票必填，为价税合计
feeWithoutTax	String	否	发票金额
billTypeInvoice	String	否	发票类型	区块链发票/19电子发票（普通发票）/31电子发票（增值税专用发票）/32增值税电子专用发票/21增值税专用发票/14增值税专用发票（成品油）/15增值税普通发票（卷票）/11增值税普通发票/16增值税电子普通发票/17增值税电子普通发票（通行费）/18机动车销售统一发票/12二手车销售统一发票/13电子发票（航空运输电子客票行程单）/38电子发票（铁路电子客票）/39 区块链发票查验、全电票查验时必填；
sellerNumber	String	否	销售方识别号	当为云南区块链发票时，必传；

请求报文范例

{
	"data": {
		"billingCode": "75955966",
		"feeWithoutTax": "30.48",
		"fee": "30.48",
		"groupId": "e966a40d481b19f55d3d31302e350ad2",
		"billingTime": "2021-12-02",
		"billingNo": "012002100111",
		"billTypeInvoice": "17",
		"tax": "0.00",
		"checkCode": "460834"
	},
	"appId": "ztefssc",
	"format": "json",
	"sign": "BAx9Y/WMup6Lxz25Satrm/QCajA=",
	"version": "V2.0",
	"noncestr": "9896f066-41c4-42e1-80ee-466966ad538b",
	"timestamp": "2024-06-20 16:48:01"
}

响应报文

返回参数：
派平台
字段编码	类型	字段名称	说明
id	String	发票ID
appId	String	应用ID
billingNo	String	发票代码
billingCode	String	发票号码
billingTime	String	开票日期	格式yyyy-MM-dd
checkCode	String	校验码（全电发票号码）
invoiceTypeName	String	发票类型名称
invoiceTypeCode	String	发票类型编码	发票类型：01：增值税（专用发票）02：增值税（货运运输业专用发票）03：增值税（机动车销售统一发票）04：增值税（普通发票）08：增值税（电子专用发票）10：增值税（电子普通发票）11：增值税（卷式普通发票）14：增值税（电子普通[通行费]发票）15：增值税（二手车销售统一发票）32：区块链发票09：全电专票（电子发票[专用发票]）90：全电普票（电子发票[普通发票]）38：电子发票（航空运输电子客票行程单）39：电子发票（铁路电子客票）
feeWithoutTax	String	不含税金额
tax	String	税额
fee	String	价税合计
sellerName	String	销方名称
sellerNumber	String	销方识别号
sellerAddressAndPhone	String	销方地址电话
sellerBankAccount	String	销方开户行及账号
buyerName	String	购方名称
buyerNumber	String	购方识别号
buyerAddressAndPhone	String	购方地址电话
buyerBankAccount	String	购方开户行及账号
hasSellerList	String	是否有销货清单	Y：是 N：否
sellerAddress	String	卖方单位/个人地址	机动车票、二手车票
sellerTel	String	卖方单位电话	机动车票、二手车票
sellerBank	String	卖方开户行	机动车票
sellerAccount	String	卖方开户行账号	机动车票
buyerIdOrOrginCode	String	买方单位代码/身份证号码	机动车票、二手车票
vehicleType	String	车辆类型	机动车票、二手车票
carModel	String	厂牌型号
city	String	产地	机动车票
certificateNumber	String	合格证号	机动车票
inspectionOrder	String	商检单号	机动车票
carEngineCode	String	发动机号	机动车票
carCode	String	车辆识别代号/车架号码	机动车票、二手车票
importCertif	String	进口证明书号	机动车票
taxAuthorityCode	String	主管税务机关代码	机动车票
taxAuthorityName	String	主管税务机关名称	机动车票
taxOfficeName	String	主管税务机关名称及代码	机动车票
taxReceiptCode	String	完税证明号	机动车票
limitNum	String	限乘人数	机动车票
tonnage	String	吨位	机动车票
taxRate	String	税率	机动车票
tollSign	String	通行费标志	通行费票，Y-是，N-否
tollSignName		通行费标志名称	通行费票
sellerIdOrOrginCode	String	卖方单位代码/身份证号码	二手车票
buyerAddress	String	买方单位/个人地址	二手车票
buyerTel	String	买方单位电话	二手车票
licensePlate	String	车照牌号	二手车票
registrationNumber	String	登记证号	二手车票
vehicleOfficeName	String	转入地车辆管理所名称	二手车票
auctionUnitName	String	经营、拍卖单位	二手车票
auctionUnitAddress	String	经营、拍卖单位地址	二手车票
auctionUnitNo	String	经营、拍卖单位纳税人识别号	二手车票
auctionUnitBankAccount	String	经营、拍卖单位开户银行及账号	二手车票
auctionUnitTel	String	经营、拍卖单位电话	二手车票
marketName	String	二手车市场名称	二手车票
marketNumber	String	二手车市场纳税人识别号	二手车票
marketAddress	String	二手车市场地址	二手车票
marketBankAccount	String	二手车市场开户银行及账号	二手车票
marketTel	String	二手车市场电话	二手车票
sellerListTitle	String	销货清单标题
sellerListTax	String	销货清单税额
taxBureau	String	所属税局
blockChain	String	区块链发票标记	1：是
checkCount	String	查验次数
blueBillingNo	String	蓝票发票代码
blueBillingCode	String	蓝票发票号码
carrierName	String	承运人名称	货运发票
carrierTaxNo	String	承运人识别号	货运发票
draweeName	String	受票方名称	货运发票
draweeTaxNo	String	受票方识别号	货运发票
receiveName	String	收货人名称	货运发票
receiveTaxNo	String	收货人识别号	货运发票
consignorName	String	发货人名称	货运发票
consignorTaxNo	String	发货人识别号	货运发票
transportGoodsInfo	String	运输货物信息	货运发票
throughAddress	String	起运地、经由、到达地	货运发票
taxDiskNumber	String	税控盘号	货运发票
carNumber	String	车种车号	货运发票
vehicleTonnage	String	车船吨位	货运发票
zeroTaxRateFlag	String	零税率标志
cashier	String	收款人
maker	String	开票人
fuhr	String	复核人
voidMark	String	是否作废	0：正常 1：作废 3：已红冲 7：部分红冲 8：全额红冲
remarks	String	备注
isBillMark	String	是否清单票	Y-是，N-否
makeType	String	开具类型	1自开 2代开
specialTicketType	String	特殊票种代码	02农产品收购发票 08成品油发票
taxDiskCode	String	机器编号
isDeduct	String	是否收费	Y收费，N不收费
ok	boolean	接口响应标识
message	String	接口响应描述
code	String	接口响应代码
validState	String	查验标识	Y成功，N失败
validFailedCode	String	查验错误代码	详见附录A.3，validState为N时有值
validFailedMsg	String	查验错误描述	validState为N时有值
invoiceDetail	List	发票商品明细	见下方说明
deductionMark	String	抵扣标志	（电子发票（航空运输电子客票行程单））
dfMark	String	国内国际标识	国内、国际（电子发票（航空运输电子客票行程单））
gpForm	String	GP单	（电子发票（航空运输电子客票行程单））
passengerName	String	旅客姓名	（电子发票（航空运输电子客票行程单）&全电发票（铁路电子客票））
idNo	String	有效身份证件号码	（电子发票（航空运输电子客票行程单）&全电发票（铁路电子客票））
electronicTicketNo	String	电子客票号码	（电子发票（航空运输电子客票行程单））
ticketCategory	String	票种	（电子发票（航空运输电子客票行程单））
totalCn	String	价税合计（中文大写）	（电子发票（航空运输电子客票行程单））
typeOfBusiness	String	业务类型	0退 1售（（电子发票（航空运输电子客票行程单））
carriage	String	车厢	（电子发票（航空运输电子客票行程单））
seatNo	String	席位	（电子发票（航空运输电子客票行程单））
返回参数：invoiceDetail
派平台
字段编码	类型	字段名称	说明
id	String	明细ID
invoiceId	String	发票ID
lineNum	String	行号
goodserviceName	String	项目（商品）名称
model	String	型号
unit	String	项目单位
number	String	项目数量
price	String	单价
taxUnitPrice	String	含税单价
expenseItem	String	费用项目	货运发票
sum	String	金额
taxRate	String	税率
tax	String	税额
zeroTaxRateFlag	String	零税率标志
plateNo	String	通行费车牌号	通行费票
passStartDate	String	通行日期起	通行费票
passEndDate	String	通行日期止	通行费票
taxClassifyCode	String	税收分类编码
legNo	String	航段序号	（电子发票（航空运输电子客票行程单）&全电发票（铁路电子客票））
depStation	String	始发站	（电子发票（航空运输电子客票行程单））
destStation	String	目的站	（电子发票（航空运输电子客票行程单）&全电发票（铁路电子客票））
carrier	String	承运人	（电子发票（航空运输电子客票行程单））
flightNo	String	航班号	（电子发票（航空运输电子客票行程单））
seatClass	String	座位等级	（电子发票（航空运输电子客票行程单））
travelDate	String	承运日期	格式yyyy-MM-dd（电子发票（航空运输电子客票行程单）&全电发票（铁路电子客票））
depTime	String	起飞时间	格式HH:MM（电子发票（航空运输电子客票行程单）&全电发票（铁路电子客票））
ticketClass	String	客票级别/客票类别	（电子发票（航空运输电子客票行程单））

响应报文范例

{
	"invoiceTypeName": "增值税（电子普通发票）",
	"invoiceDetail": [{
		"goodserviceName": "*运输服务*客运服务费",
		"number": "1",
		"taxRate": "0%",
		"unit": "次",
		"taxClassifyCode": "3010101020102000000",
		"price": "30.480000",
		"lineNum": "1",
		"sum": "30.48",
		"tax": "0.00",
		"zeroTaxRateFlag": "1"
	}],
	"taxBureau": "天津",
	"feeWithoutTax": "30.48",
	"buyerBankAccount": "中信银行深圳市民中心支行8110301013100278455",
	"fee": "30.48",
	"sellerName": "滴滴出行科技有限公司",
	"sellerAddressAndPhone": "天津经济技术开发区第一大街79号泰达MSD-C区C2座21层2103室022-59002850",
	"buyerNumber": "91440300MA5EXWHW6F",
	"validState": "Y",
	"sellerNumber": "911201163409833307",
	"buyerAddressAndPhone": "深圳市前海深港合作区前湾一路1号A栋201室0755-86541249",
	"appId": "ztefssc",
	"id": "5524582ec6ac48259bf449c10389605e",
	"ok": true,
	"isDeduct": "Y",
	"makeType": "1",
	"billingTime": "2021-12-02",
	"checkCount": "1",
	"billingNo": "012002100111",
	"tax": "0.00",
	"buyerName": "深圳市中兴新云服务有限公司",
	"message": "查验成功",
	"checkCode": "13147596112003460834",
	"billingCode": "75955966",
	"paiResponseId": "1ce8474a602e4ba1bfed3ca5d2a1a48b",
	"voidMark": "0",
	"extendCategory": "",
	"paiResponseCost": 1656,
	"sellerBankAccount": "招商银行股份有限公司天津自由贸易试验区分行122905939910401",
	"invoiceTypeCode": "10",
	"taxDiskCode": "499099800918",
	"paiResponseTime": "2024-06-20 16:48:03"
}

A.1:错误代码

错误码	收费	场景说明	提示语	需求说明
	是		查验成功
201	是	所查发票不存在	所查发票不存在	201&216&243三种失败状态，前端系统会触发自动查验
202	是	超过该张票当天查验次数	超过该张票当天查验次数
211		参数不合法		其他错误码，保持原逻辑，取厂商返回的错误信息
212	是	发票信息不一致	发票信息不一致
213		服务器异常，请稍后重试	保持原逻辑，取厂商返回的错误信息	213&500二种失败状态，会自动触发降级查验
216		当日开具发票可于次日进行查验	保持原逻辑，取厂商返回的错误信息
217		超过五年不能查验	保持原逻辑，取厂商返回的错误信息
241		没有查验权限	保持原逻辑，取厂商返回的错误信息
242		已超过最大查验量	保持原逻辑，取厂商返回的错误信息
243		查验异常	保持原逻辑，取厂商返回的错误信息
221		当前查验未完成	保持原逻辑，取厂商返回的错误信息
500		未知异常，请联系管理员	保持原逻辑，取厂商返回的错误信息	除与供应商映射错误信息外，还包含其他未知错误，属于兜底错误码，错误信息为“未知异常，请联系管理员”

查验接口

关联知识库

查验接口

关于作者

关联知识库

目录