| 调用VerifyVATInvoice进行发票核验 | 您所在的位置：网站首页 › 发票验票失败是什么意思呀 › 调用VerifyVATInvoice进行发票核验 |
调用VerifyVATInvoice进行发票核验
|
发票核验接口支持包括：增值税专用发票、增值税普通发票（折叠票）、增值税普通发票（卷票）、增值税电子普通发票（含收费公路通行费增值税电子普通发票）、机动车销售统一发票、二手车销售统一发票多种类型发票核验。您可以通过输入发票的关键验证字段，返回真实的票面信息，包括发票类型、发票代码、发票号码、作废标志、开票日期、购方税号及其他发票信息等。当天开具发票当日可查验（T+0）。注意：可能有几小时到十几小时的延迟。 接口说明如何开通/购买本服务 步骤概述1开通 票证核验 服务。开通后您可享 50 次免费额度。2购买发票核验资源包。您也可以不购买资源包，系统会通过“按量付费”方式按实际调用量自动扣款。3可以参照调试页面提供的代码示例完成 API 接入开发。接入完成后，调用 API 获取识别结果。如果使用子账号调用接口，需要阿里云账号（主账号）对 RAM 账号进行授权。创建 RAM 用户的具体操作，请参考：创建 RAM 用户。文字识别服务提供一种系统授权策略，即 AliyunOCRFullAccess。具体授权操作，请参见在用户页面为 RAM 用户授权。调试您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。  调试授权信息当前API暂无授权信息透出。请求参数名称类型必填描述示例值InvoiceCodestring否发票代码。数电发票（发票类型代码为 31，32）时可为空（发票类型代码见发票类型代码说明）。 044032100311InvoiceNostring是发票号码。 66932410InvoiceDatestring是开票日期（日期格式为：YYYYMMDD）。 20220617InvoiceSumstring否发票类型代码为 01，03，15，20，31，32 时必填：为 01，03，20 时填写发票不含税金额；为 15 时填写发票车价合计；为 31，32 时填写含税金额；为区块链发票（InvoiceKind=1）时填写 不含税金额。 其它类型可为空（详见发票类型代码说明）。 102VerifyCodestring否机器验证码，取后 6 位。发票类型代码为 04，10，11，14 时必填，为区块链发票（InvoiceKind=1）时必填，其他发票种类可为空（详见发票类型代码说明）。 980769InvoiceKindinteger否发票类型。用来区分是否为 区块链发票。 InvoiceKind=0 或不填，表示 非区块链发票。 InvoiceKind=1，表示 区块链发票。注意，如果核验区块链发票，则 InvoiceCode，InvoiceNumber，InvoiceDate，InvoiceSum，VerifyCode 这 5 个入参均为必传参数。 0 发票类型代码说明 发票类型代码发票类型说明01增值税专用发票02货运运输业增值税专用发票03机动车销售统一发票04增值税普通发票10增值税普通发票（电子）11增值税普通发票（卷式）14增值税普通发票（通行费）15二手车销售统一发票20增值税电子专用发票31数电发票（增值税专用发票）32数电发票（增值税普通发票）85数电发票（纸质专用发票）86数电发票（纸质普通发票）返回参数名称类型描述示例值objectSchema of Response RequestIdstring请求唯一 ID 43A29C77-405E-4CC0-BC55-EE694AD00655Datastring返回数据 { "code": "001", "data": { "afterTaxCode": "", "allTax": "9.67", "allValoremTax": "332.00", "blueInvoiceCode": "", "blueInvoiceNo": "", "brandVersion": "", "businessUnit": "", "businessUnitTaxNo": "", "busmessUnitAddress": "", "busmessUnitBankAndAccount": "", "busmessUnitPhone": "", "carPrice": "", "carType": "", "carTypeAndNumber": "", "carframeCode": "", "carrierName": "", "carrierTaxNo": "", "checkCode": "07122942791187744XXXX", "code": "", "consignorName": "", "consignorTaxNo": "", "cyjgxx": "查验成功发票一致", "detailList": [ { "allTax": "9.67", "detailAmount": "322.33", "detailNo": "1", "expenseItem": "", "goodsName": "*餐饮服务*餐费", "netValue": "322.330097", "num": "1", "plate_no": "", "rowNo": "1", "standard": "", "taxClassifyCode": "0", "taxDetailAmount": "", "taxRate": "3", "taxUnitPrice": "", "trafficDateEnd": "", "trafficDateStart": "", "type": "", "unit": "" } ], "draweeName": "", "draweeTaxNo": "", "engineCode": "", "idCard": "", "importLicense": "", "inspectionAmount": "", "inspectionNumber": "", "invalidMark": "N", "invoiceCode": "01100180XXXX", "invoiceDate": "2018XXXX", "invoiceMoney": "322.XX", "invoiceNumber": "3531XXXX", "invoiceType": "10", "lemonMarket": "", "lemonMarketAddress": "", "lemonMarketBankAndAccount": "", "lemonMarketPhone": "", "lemonMarketTaxNo": "", "licenseCode": "", "licensePlate": "", "limitAmount": "", "machineCode": "49992273XXXX", "note": "机器编号：49992273XXXX", "producingArea": "", "purchaserAddressOrPhone": "杭州余杭区XXXX0571-8502XXXX", "purchaserBankAndNumber": "招商银行杭州高新支行571906593XXXXXX", "purchaserName": "XXXX软件有限公司", "purchaserPhone": "", "purchaserTaxpayerNumber": "913301007682XXXXXX", "purchaserUnitOrIndividual": "", "purchaserUnitOrIndividualAddress": "", "purchaserUnitcodeOrIdNo": "", "receiveName": "", "receiveTaxNo": "", "registrationNo": "", "salerAddress": "", "salerAddressOrPhone": "北京市海淀区XXX8211XXXX", "salerBankAccount": "中国银行海淀支行345456XXXXXX", "salerBankAndNumber": "中国银行海淀支行345456XXXXXX", "salerBankName": "", "salerName": "北京市XXX酒家", "salerPhone": "", "salerTaxpayerNumber": "911101081020XXXXXX", "sellerPhone": "", "sellerUnitCodeOrIdno": "", "sellerUnitOrIndividual": "北京市XXX酒家", "sellerUnitOrIndividualAddress": "", "taxDiskNumber": "", "taxRate": "", "taxUnitCode": "", "taxUnitName": "", "throughAddress": "", "trafficFeeFlag": "", "transferredVehicleOffice": "", "transportGoodsInfo": "", "unit": "", "vehicleTonnage": "", "zeroTaxRateFlag": "" }, "msg": "成功" } 返回结果字段描述 字段名称字段类型描述codestring状态码msgstring状态信息datastring发票信息（只有查验成功，此字段才不为空） 返回结果 data 字段描述（非区块链发票) 序号字段名称字段描述字段类型字段最大长度是否一定返回说明1invoiceType发票种类string2是2invoiceCode发票代码string20是3invoiceNumber发票号码string8是4inspectionAmount查验次数string100否5salerName销方名称string100否6salerTaxpayerNumber销方税号string20否7salerAddressOrPhone销方地址、电话string100否8salerBankAndNumber销方开户行及账号string100否9purchaserTaxpayerNumber购方税号string20否10purchaserName购方名称string100否11purchaserAddressOrPhone购方地址、电话string100否12purchaserBankAndNumber购方开户行及账号string100否13invoiceDate开票日期string8否格式：yyyymmdd14invoiceMoney发票金额string20否15allTax发票税额string20否16allValoremTax价税合计string16否17note备注string200否18machineCode机器编号string20否19checkCode校验码string20否20blueInvoiceCode蓝票发票代码string12否21blueInvoiceNo蓝票发票号码string8否22invalidMark作废标志string1否N：未作废，Y：已作废，H：冲红，7：部分冲红，8：全额冲红23idCard购方身份证号/组织机构代码string20否机动车、二手车发票返回该信息24carType车辆类型string80否机动车、二手车发票返回该信息25brandVersion厂牌型号string100否机动车、二手车发票返回该信息26producingArea产地string80否机动车发票返回该信息27licenseCode合格证号string100否机动车发票返回该信息28inspectionNumber商检单号string80否机动车发票返回该信息29engineCode发动机号string120否机动车发票返回该信息30carframeCode车辆识别代号/车架号码string40否机动车、二手车发票返回该信息31importLicense进口证明书号string80否机动车发票返回该信息32taxUnitCode主管税务机关代码string11否机动车发票返回该信息33afterTaxCode完税凭证号码string32否机动车发票返回该信息34limitAmount限乘人数string40否机动车发票返回该信息35taxUnitName主管税务机关名称string160否机动车发票返回该信息36unit吨位string40否机动车发票返回该信息37taxRate税率string32否机动车发票返回该信息38salerAddress销方地址string160否机动车发票返回该信息39salerPhone销方电话string80否机动车发票返回该信息40salerBankName销方开户银行string160否机动车发票返回该信息41salerBankAccount销方开户账号string80否机动车发票返回该信息42carrierName承运人名称string20否货物发票返回信息43carrierTaxNo承运人识别号string80否货物发票返回信息44draweeName受票方名称string20否货物发票返回信息45draweeTaxNo受票方识别号string80否货物发票返回信息46receiveName收货人名称string20否货物发票返回信息47receiveTaxNo收货人识别号string80否货物发票返回信息48consignorName发货人名称string20否货物发票返回信息49consignorTaxNo发货人识别号string80否货物发票返回信息50transportGoodsInfo运输货物信息string32否货物发票返回信息51throughAddress起运地、经由、到达地string32否货物发票返回信息52taxDiskNumber税控盘号string32否货物发票返回信息53carTypeAndNumber车种车号string15否货物发票返回信息54vehicleTonnage车船吨位string200否货物发票返回信息55trafficFeeFlag通行费标准string2否通行费发票返回信息Y：可抵扣通行费。N：不可抵扣通行费56zeroTaxRateFlag零税率标识string2否通行费发票返回信息为空表示非零税率1：税率栏位显示“免税”2：税率栏位显示“不征税”3：零税率57licensePlate车牌照号string100否二手车发票返回信息58registrationNo登记证号string100否二手车发票返回信息59carPrice车价合计string32否二手车发票返回信息60transferredVehicleOffice转入地车辆车管所名称string240否二手车发票返回信息61purchaserUnitOrIndividual买方单位/个人string240否二手车发票返回信息62purchaserUnitcodeOrIdno买方单位代码/身份证号string44否二手车发票返回信息63purchaserUnitOrIndividualAddress买方单位/个人住址string240否二手车发票返回信息64purchaserPhone买方电话string100否二手车发票返回信息65sellerUnitOrIndividual卖方单位/个人string240否二手车发票返回信息66sellerUnitCodeOrIdno卖方单位代码/身份证号string44否二手车发票返回信息67sellerUnitOrIndividualAddress卖方单位/个人住址string240否二手车发票返回信息68sellerPhone卖方电话string100否二手车发票返回信息69businessUnit经营、拍卖单位string240否二手车发票返回信息70busmessUnitAddress经营、拍卖单位地址string240否二手车发票返回信息71businessUnitTaxNo经营、拍卖单位纳税人识别号string44否二手车发票返回信息72busmessUnitBankAndAccount开户银行及账号string100否二手车发票返回信息73busmessUnitPhone经营、拍卖单位电话string100否二手车发票返回信息74lemonMarket二手车市场string240否二手车发票返回信息75lemonMarketTaxNo二手车市场纳税人识别号string44否二手车发票返回信息76lemonMarketAddress二手车市场地址string240否二手车发票返回信息77lemonMarketBankAndAccount二手车市场开户银行及账号string100否二手车发票返回信息78lemonMarketPhone二手车市场电话string100否二手车发票返回信息79cyjgxx验真结果string100否验真结果 返回结果 data 字段描述（区块链发票） 序号字段名称字段描述字段类型说明1invoiceCode发票代码string2invoiceNo发票号码string3checkCode校验码string4billingDate开票日期string5txHash交易哈希string6amount不含税总金额string7totalAmount含税总金额string8taxAmount税额string9sellerName销方名称string10sellerTaxpayerId销方纳税人识别号string11sellerAddress销方地址string12sellerPhone销方电话string13sellerBankInfo销方开户银行名称string14buyerAddress购方地址string15buyerPhone购方电话string16buyerName购方名称string17sellerBankAccount销方开户银行账号string18buyerTaxpayerId购方纳税人识别号string19buyerType购买方类型string20status发票状态string0：正常，1：失控，2：作废，3：红冲，4：异常21checkedBy复核人string22reviewedBy审核人string23remark开票备注string24drawer开票人string25time开票时间string26platformCode平台编码string27platformName平台名称string28orderId订单流水号string29payId支付流水号string30digitPaymentSign电子支付标识string31invalidMark是否作废string32item发票明细集合list（以下为 item 字段的说明）1+code货物或应税劳务、服务编码string2+name货物或应税劳务、服务名称string3+subName商品名称string4+specModel规格型号string5+unit计量单位string6+count数量string7+unitPrice单价string8+amount金额string9+taxFlag含税标记string10+taxRate税率string11+taxAmount税额string12+taxPreferMark是否享受税收优惠标识string13+taxPreferDescrip享受税收优惠的具体说明string14+zeroTaxRateMark零税率标识string15+deduction差额开票时，从总额中扣除的金额string 返回结果 detailList 字段描述 序号字段名称字段描述字段类型说明1detailNo明细编号string2goodsName货物名称string3detailAmount金额string4num数量string5taxRate税率string6allTax税额string7taxUnitPrice含税单价string8taxDetailAmount含税金额string9netValue不含税单价string10standard规格型号string11unit计量单位string12expenseItem费用项目string货物发票返回信息13plate_no车牌号string通行费发票返回信息14type类型string通行费发票返回信息15trafficDateStart通行日期起string通行费发票返回信息16trafficDateEnd通行日期止string通行费发票返回信息17taxClassifyCode税收分类编码string18rowNo行号string code（状态码）和 msg（状态信息）对应关系，以及是否计费说明 codemsg是否计费001成功是002超过该张票当天查验次数否005请求不合法否006发票信息不一致是009所查发票不存在是104已超过最大查验量否105查询发票不规范。可能是以下原因导致： 接口参数传入不完整或错误。 发票类型不支持（例如区块链发票）。 发票不是真实有效的。否106查验异常否108参数不为空否109参数长度不正确否110参数"InvoiceCode"的格式或取值范围错误否111参数"InvoiceSum"的格式或取值范围错误否112参数"VerifyCode"的格式或取值范围错误否113参数"InvoiceNo"的格式或取值范围错误否114校验码不正确，应为后六位否115超过服务有效期限限制否1005请核对四要素是否符合发票规范是1010日期格式不正确(请检查日期是否符合格式 YYYYMMDD)否1011请求参数不完整否1021网络超时，税局升级维护否10014日期当天不能查验否10015开票金额：不合法的格式否10016检验码：不能为空否10017超过五年的不能查验否10018检验码：不合法的长度否10020没有查验权限否000000成功是000001查询无数据否101000系统异常否111000参数不能为空否111001参数格式不正确否121000内部处理失败否121001内部处理限流否121002内部处理超时否131002接口无权限否131003接口调用次数过限否131004接口已到期否131005接口调用频率过高否152000超过用户 QPS 调用阈值否171000数据源业务异常否示例正常返回示例 JSON格式 { "RequestId": "43A29C77-405E-4CC0-BC55-EE694AD00655", "Data": "{\n \"code\": \"001\",\n \"data\": {\n \"afterTaxCode\": \"\",\n \"allTax\": \"9.67\",\n \"allValoremTax\": \"332.00\",\n \"blueInvoiceCode\": \"\",\n \"blueInvoiceNo\": \"\",\n \"brandVersion\": \"\",\n \"businessUnit\": \"\",\n \"businessUnitTaxNo\": \"\",\n \"busmessUnitAddress\": \"\",\n \"busmessUnitBankAndAccount\": \"\",\n \"busmessUnitPhone\": \"\",\n \"carPrice\": \"\",\n \"carType\": \"\",\n \"carTypeAndNumber\": \"\",\n \"carframeCode\": \"\",\n \"carrierName\": \"\",\n \"carrierTaxNo\": \"\",\n \"checkCode\": \"07122942791187744XXXX\",\n \"code\": \"\",\n \"consignorName\": \"\",\n \"consignorTaxNo\": \"\",\n \"cyjgxx\": \"查验成功发票一致\",\n \"detailList\": [\n {\n \"allTax\": \"9.67\",\n \"detailAmount\": \"322.33\",\n \"detailNo\": \"1\",\n \"expenseItem\": \"\",\n \"goodsName\": \"*餐饮服务*餐费\",\n \"netValue\": \"322.330097\",\n \"num\": \"1\",\n \"plate_no\": \"\",\n \"rowNo\": \"1\",\n \"standard\": \"\",\n \"taxClassifyCode\": \"0\",\n \"taxDetailAmount\": \"\",\n \"taxRate\": \"3\",\n \"taxUnitPrice\": \"\",\n \"trafficDateEnd\": \"\",\n \"trafficDateStart\": \"\",\n \"type\": \"\",\n \"unit\": \"\"\n }\n ],\n \"draweeName\": \"\",\n \"draweeTaxNo\": \"\",\n \"engineCode\": \"\",\n \"idCard\": \"\",\n \"importLicense\": \"\",\n \"inspectionAmount\": \"\",\n \"inspectionNumber\": \"\",\n \"invalidMark\": \"N\",\n \"invoiceCode\": \"01100180XXXX\",\n \"invoiceDate\": \"2018XXXX\",\n \"invoiceMoney\": \"322.XX\",\n \"invoiceNumber\": \"3531XXXX\",\n \"invoiceType\": \"10\",\n \"lemonMarket\": \"\",\n \"lemonMarketAddress\": \"\",\n \"lemonMarketBankAndAccount\": \"\",\n \"lemonMarketPhone\": \"\",\n \"lemonMarketTaxNo\": \"\",\n \"licenseCode\": \"\",\n \"licensePlate\": \"\",\n \"limitAmount\": \"\",\n \"machineCode\": \"49992273XXXX\",\n \"note\": \"机器编号：49992273XXXX\",\n \"producingArea\": \"\",\n \"purchaserAddressOrPhone\": \"杭州余杭区XXXX0571-8502XXXX\",\n \"purchaserBankAndNumber\": \"招商银行杭州高新支行571906593XXXXXX\",\n \"purchaserName\": \"XXXX软件有限公司\",\n \"purchaserPhone\": \"\",\n \"purchaserTaxpayerNumber\": \"913301007682XXXXXX\",\n \"purchaserUnitOrIndividual\": \"\",\n \"purchaserUnitOrIndividualAddress\": \"\",\n \"purchaserUnitcodeOrIdNo\": \"\",\n \"receiveName\": \"\",\n \"receiveTaxNo\": \"\",\n \"registrationNo\": \"\",\n \"salerAddress\": \"\",\n \"salerAddressOrPhone\": \"北京市海淀区XXX8211XXXX\",\n \"salerBankAccount\": \"中国银行海淀支行345456XXXXXX\",\n \"salerBankAndNumber\": \"中国银行海淀支行345456XXXXXX\",\n \"salerBankName\": \"\",\n \"salerName\": \"北京市XXX酒家\",\n \"salerPhone\": \"\",\n \"salerTaxpayerNumber\": \"911101081020XXXXXX\",\n \"sellerPhone\": \"\",\n \"sellerUnitCodeOrIdno\": \"\",\n \"sellerUnitOrIndividual\": \"北京市XXX酒家\",\n \"sellerUnitOrIndividualAddress\": \"\",\n \"taxDiskNumber\": \"\",\n \"taxRate\": \"\",\n \"taxUnitCode\": \"\",\n \"taxUnitName\": \"\",\n \"throughAddress\": \"\",\n \"trafficFeeFlag\": \"\",\n \"transferredVehicleOffice\": \"\",\n \"transportGoodsInfo\": \"\",\n \"unit\": \"\",\n \"vehicleTonnage\": \"\",\n \"zeroTaxRateFlag\": \"\"\n },\n \"msg\": \"成功\"\n}" }错误码HTTP status code错误码错误信息503ServiceUnavailableThe request has failed due to a temporary failure of the server访问错误中心查看更多错误码。 变更历史变更时间变更内容概要操作2024-03-15OpenAPI 错误码发生变更、OpenAPI 入参发生变更查看变更详情 |
【本文地址】
公司简介
联系我们