在财税数字化进程中，增值税发票验真已成为企业自动化报销、税务合规和风控的关键环节。发票查验API支持通过标准接口实时核验发票真实性及状态（如正常、作废、红冲等）。然而，接口返回的状态码直接影响调用结果的判断与业务逻辑处理。准确理解各类状态码的含义，有助于开发者高效集成、快速定位问题并提升系统稳定性。本文将简要说明增值税发票查验接口常见状态码及其技术含义。
1、集成参数：
1.1接口地址https://******/verapi/v2/verInvoice.do
调用方式：post
1.2接口接收参数：
1.3接口返回值、发票查验种类与状态：
2、接口返回示例
2.1增值税专用发票
"code": "<状态码>",
"msg": "<消息>",
"data": {
"invoiceType": "<发票类型>",
"administrativeDivisionName": "<所属行政区名称>",
"invoiceCode": "<发票代码>",
"invoiceNumber": "<发票号码>",
"billingDate": "<开票日期：YYYY-MM-DD>",
"purchaserName": "<购方名称",
"purchaserTaxNo": "<购方税号>",
"purchaserAddressPhone": "<购方地址电话>",
"purchaserBank": "<购方开户行账户>",
"salesName": "<销方名称>",
"salesTaxNo": "<销方税号>",
"salesAddressPhone": "<销方地址电话>",
"salesBankAndNo": "<销方开户行地址>",
"totalAmount": "<合计金额>",
"totalTax": "<合计税额>",
"amountTax": "<价税合计>",
"amountTaxCN": "<价税合计_中文>",
"remarks": "<备注>",
"machineCode": "<机器编码>",
"checkCode": "<校验码>",
"state": "<发票状态>",
"checkNum": "<查验次数>",
"invoiceLists": [<发票明细>
{
"commodityName": "<货物或应税劳务名称>",
"specificationModel": "<规格型号>",
"unit": "<单位>",
"quantity": "<数量>",
"unitPrice": "<单价>",
"amount": "<金额>",
"taxRate": "<税率>",
"tax": "<税额>"
}
],
"hzLists": [<红字清单>
{
"invoiceCodeHZ": "<红字发票代码>",
"invoiceNumberHZ":"<红字发票号码>",
"billingDateHZ":"<红字发票开票日期>",
"stateHZ":"<红字发票状态>"
},
]
}
}
2.2机动车销售统一发票
"code": "<状态码>",
"msg": "<消息>",
"data": {
"checkNum": "<查验次数>",
"administrativeDivisionName": "<所属行政区名称>",
"invoiceType": "<发票类型>",
"invoiceCode": "<发票代码>",
"invoiceNumber": "<发票号码>",
"billingDate": "<开票日期：YYYY-MM-DD>",
"totalAmount": "<合计金额>",
"amountTax": "<价税合计>",
"purchaserName": "<购方名称>",
"purchaserTaxNo": "<购方税号/身份证号码>",
"salesName": "<销方名称>",
"salesTaxNo": "<销方税号/身份证号码>",
"totalTax": "<合计税额>",
"amountTaxCN": "<价税合计_中文>",
"state": "<发票状态>",
"machineCode": "<机器编码>",
"idCardNo": "<身份证号码>",
"vehicleType": "<车辆类型>",
"brandModel": "<品牌型号>",
"originPlace": "<产地>",
"certificateNo": "<合格证号>",
"importCertificateNo": "<进口证明书号>",
"inspectionListNo": "<商检单号>",
"engineNo": "<发动机号码>",
"vehicleNo": "<车架号>",
"salesPhone": "<销方联系电话>",
"salesBankNo": "<销方开户银行账号>",
"salesAddress": "<销方地址>",
"salesBank": "<销方开户银行>",
"taxRate": "<税率>",
"taxAuthorityName": "<主管税务机关名称>",
"taxAuthorityNo": "<主管税务机关代码>",
"paymentVoucherNo": "<完税凭证号码>",
"tonnage": "<吨位>",
"passengersLimited": "<准予载客人数>",
"hzLists": [<红字清单>
{
"invoiceCodeHZ": "<红字发票代码>",
"invoiceNumberHZ":"<红字发票号码>",
"billingDateHZ":"<红字发票开票日期>",
"stateHZ":"<红字发票状态>"
},
]
}
}
2.3增值税普通发票
"code": "<状态码>",
"msg": "<消息>",
"data": {
"checkNum": "<查验次数>",
"administrativeDivisionName": "<所属行政区名称>",
"invoiceType": "<发票类型>",
"invoiceCode": "<发票代码>",
"invoiceNumber": "<发票号码>",
"billingDate": "<开票日期：YYYY-MM-DD>",
"totalAmount": "<合计金额>",
"checkCode": "<校验码>",
"amountTax": "<价税合计>",
"purchaserName": "<购方名称>",
"purchaserTaxNo": "<购方税号>",
"purchaserAddressPhone": "<购方地址电话>",
"purchaserBank": "<购方开户行账户>",
"salesName": "<销方名称>",
"salesTaxNo": "<销方税号>",
"salesAddressPhone": "<销方地址电话>",
"salesBankAndNo": "<销方开户行地址>",
"totalTax": "<合计税额>",
"amountTaxCN": "<价税合计_中文>",
"state": "<发票状态>",
"machineCode": "<机器编码>",
"tollSign": "<通行费标志>",
"oilMark": "<成品油标志>",
"invTaxSign": "<代扣代缴税款标志>",
"remarks": "<备注>",
"invoiceLists": [
{
"commodityCode": "<商品编码>",
"commodityName": "<货物或应税劳务名称>",
"specificationModel": "<规格型号>",
"unit": "<单位>",
"quantity": "<数量>",
"unitPrice": "<单价>",
"amount": "<金额>",
"taxRate": "<税率>",
"tax": "<税额>"
}
],
"hzLists": [<红字清单>
{
"invoiceCodeHZ": "<红字发票代码>",
"invoiceNumberHZ":"<红字发票号码>",
"billingDateHZ":"<红字发票开票日期>",
"stateHZ":"<红字发票状态>"
},
]
}
}
2.4增值税电子专用发票
"code": "<状态码>",
"msg": "<消息>",
"data": {
"checkNum": "<查验次数>",
"administrativeDivisionName": "<所属行政区名称>",
"invoiceType": "<发票类型>",
"invoiceCode": "<发票代码>",
"invoiceNumber": "<发票号码>",
"billingDate": "<开票日期：YYYY-MM-DD>",
"totalAmount": "<合计金额>",
"checkCode": "<校验码>",
"amountTax": "<价税合计>",
"purchaserName": "<购方名称>",
"purchaserTaxNo": "<购方税号>",
"purchaserAddressPhone": "<购方地址电话>",
"purchaserBank": "<购方开户行账户>",
"salesName": "<销方名称>",
"salesTaxNo": "<销方税号>",
"salesAddressPhone": "<销方地址电话>",
"salesBankAndNo": "<销方开户行地址>",
"totalTax": "<合计税额>",
"amountTaxCN": "<价税合计_中文>",
"state": "<发票状态>",
"machineCode": "<机器编码>",
"tollSign": "<通行费标志>",
"oilMark": "<成品油标志>",
"invTaxSign": "<代扣代缴税款标志>",
"remarks": "<备注>",
"invoiceLists": [
{
"commodityCode": "<商品编码>",
"commodityName": "<货物或应税劳务名称>",
"specificationModel": "<规格型号>",
"unit": "<单位>",
"quantity": "<数量>",
"unitPrice": "<单价>",
"amount": "<金额>",
"taxRate": "<税率>",
"tax": "<税额>"
}
],
"hzLists": [<红字清单>
{
"invoiceCodeHZ": "<红字发票代码>",
"invoiceNumberHZ":"<红字发票号码>",
"billingDateHZ":"<红字发票开票日期>",
"stateHZ":"<红字发票状态>"
},
]
}
}
2.5电子发票（专用发票）
"code": "<状态码>",
"msg": "<消息>",
"data": {
"checkNum": "<查验次数>",
"administrativeDivisionName": "<所属行政区名称>",
"invoiceType": "<发票类型>",
"invoiceCode": "<发票代码>",
"invoiceNumber": "<发票号码>",
"billingDate": "<开票日期：YYYY-MM-DD>",
"totalAmount": "<合计金额>",
"checkCode": "<校验码>",
"amountTax": "<价税合计>",
"purchaserName": "<购方名称>",
"purchaserTaxNo": "<购方税号>",
"purchaserAddressPhone": "<购方地址电话>",
"purchaserBank": "<购方开户行账户>",
"salesName": "<销方名称>",
"salesTaxNo": "<销方税号>",
"salesAddressPhone": "<销方地址电话>",
"salesBankAndNo": "<销方开户行地址>",
"totalTax": "<合计税额>",
"amountTaxCN": "<价税合计_中文>",
"state": "<发票状态>",
"machineCode": "<机器编码>",
"tollSign": "<通行费标志>",
"oilMark": "<成品油标志>",
"invTaxSign": "<代扣代缴税款标志>",
"remarks": "<备注>",
"receiverName": "<收款人>",
"recheckName": "<复核人>",
"specialTag": "<特殊标识>",
"invoiceLists": [
{
"commodityCode": "<商品编码>",
"commodityName": "<货物或应税劳务名称>",
"specificationModel": "<规格型号>",
"unit": "<单位>",
"quantity": "<数量>",
"unitPrice": "<单价>",
"amount": "<金额>",
"taxRate": "<税率>",
"tax": "<税额>"
}
],
"hzLists": [<红字清单>
{
"invoiceCodeHZ": "<红字发票代码>",
"invoiceNumberHZ":"<红字发票号码>",
"billingDateHZ":"<红字发票开票日期>",
"stateHZ":"<红字发票状态>"
},
]
}
}
