1. 接口描述
此接口处于预下线状态 。
预计下线时间:2024-09-23 17:08:59
接口请求域名: ocr.tencentcloudapi.com 。
已上线VatInvoiceVerifyNew,VatInvoiceVerify需要下线,产品在官网已发通告
本接口支持增值税发票的准确性核验,您可以通过输入增值税发票的关键字段提供所需的验证信息,接口返回真实的票面相关信息,包括发票代码、发票号码、开票日期、金额、消费类型、购方名称、购方税号、销方名称、销方税号等多个常用字段。支持多种发票类型核验,包括增值税专用发票、增值税普通发票(含电子普通发票、卷式发票、通行费发票)、全电发票、机动车销售统一发票、货物运输业增值税专用发票、二手车销售统一发票。
默认接口请求频率限制:20次/秒。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
Action | 是 | String | 公共参数,本接口取值:VatInvoiceVerify。 |
Version | 是 | String | 公共参数,本接口取值:2018-11-19。 |
Region | 否 | String | 公共参数,此参数为可选参数。 |
InvoiceCode | 是 | String | 发票代码, 一张发票一天只能查询5次。 示例值:1300000000 |
InvoiceNo | 是 | String | 发票号码(8位) 示例值:04000000 |
InvoiceDate | 是 | String | 开票日期(不支持当天发票查询,支持五年以内开具的发票),格式:“YYYY-MM-DD”,如:2019-12-20。 示例值:2019-12-11 |
Additional | 是 | String | 根据票种传递对应值,如果报参数错误,请仔细检查每个票种对应的值 增值税专用发票:开具金额(不含税) 增值税普通发票、增值税电子普通发票(含通行费发票)、增值税普通发票(卷票):校验码后6位 区块链发票:不含税金额/校验码,例如:“285.01/856ab” 机动车销售统一发票:不含税价 货物运输业增值税专用发票:合计金额 二手车销售统一发票:车价合计 示例值:88.50 |
3. 输出参数
参数名称 | 类型 | 描述 |
---|---|---|
Invoice | VatInvoice | 增值税发票信息,详情请点击左侧链接。 |
VehicleInvoiceInfo | VehicleInvoiceInfo | 机动车销售统一发票信息 |
UsedVehicleInvoiceInfo | UsedVehicleInvoiceInfo | 二手车销售统一发票信息 |
RequestId | String | 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 增值税发票核验示例代码
增值税发票核验示例代码
输入示例
POST / HTTP/1.1
Host: ocr.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: VatInvoiceVerify
<公共请求参数>
{
"InvoiceNo": "04000000",
"InvoiceCode": "1300000000",
"InvoiceDate": "2019-12-11",
"Additional": "88.50"
}
输出示例
{
"Response": {
"Invoice": {
"Code": "1300000000",
"Number": "04000000",
"Date": "20191211",
"BuyerName": "栾城区一厂",
"BuyerTaxCode": "921467MA773940",
"BuyerAddressPhone": "栾城区北留营村15012345678",
"BuyerBankAccount": "中国农业银行股份有限公司第一分理处",
"SellerName": "石家庄市第一石油经销有限公司",
"SellerTaxCode": "911301047981234567",
"SellerAddressPhone": "石家庄市桥西区师范街01号 0311-12345678",
"SellerBankAccount": "",
"Remark": "",
"MachineNo": "661510100000",
"Type": "01",
"CheckCode": "85518065011000000000",
"IsAbandoned": "",
"HasSellerList": "",
"SellerListTitle": "",
"SellerListTax": "",
"AmountWithoutTax": "88.50",
"TaxAmount": "11.50",
"AmountWithTax": "100.00",
"Items": [
{
"LineNo": "1",
"Name": "*乙醇汽油*92#汽油",
"Spec": "",
"Unit": "升",
"Quantity": "15.479876160990711",
"UnitPrice": "5.716814159292035",
"AmountWithoutTax": "88.50",
"TaxRate": "13%",
"TaxAmount": "11.50",
"TaxClassifyCode": ""
}
],
"TaxBureau": "",
"TrafficFreeFlag": ""
},
"VehicleInvoiceInfo": {
"MotorBankAccount": "",
"VinNo": "",
"MotorBankName": "",
"BizCheckFormNo": "",
"PlateModel": "",
"BuyerNo": "",
"CarType": "",
"TaxtationOrgName": "",
"TaxtationOrgCode": "",
"EngineNo": "",
"PayTaxesNo": "",
"Tonnage": "",
"MotorTaxRate": "",
"CertificateNo": "",
"ProduceAddress": "",
"LimitCount": "",
"ImportNo": "",
"SellerTel": "",
"SellerAddress": ""
},
"UsedVehicleInvoiceInfo": {
"BuyerTel": "",
"MarketBankAccount": "",
"BuyerNo": "",
"ManagementOffice": "",
"Seller": "",
"MarketAddress": "",
"SellerNo": "",
"BuyerAddress": "",
"Buyer": "",
"AuctioneerTel": "",
"AuctioneerAddress": "",
"MarketTaxpayerNum": "",
"VehicleIdentifyNo": "",
"VehicleLicenseNo": "",
"AuctioneerTaxpayerNum": "",
"MarketTel": "",
"AuctioneerBankAccount": "",
"Auctioneer": "",
"VehicleTotalPrice": "",
"RegisterNo": "",
"SellerAddress": "",
"TaxBureau": "",
"SellerTel": "",
"Market": ""
},
"RequestId": "163b7f97-0b1f-4054-b8e5-bdfb5a6c213f"
}
}
5. 开发者资源
腾讯云 API 平台
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
API Inspector
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。
SDK
云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python: GitHub Gitee
- Tencent Cloud SDK 3.0 for Java: GitHub Gitee
- Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
- Tencent Cloud SDK 3.0 for Go: GitHub Gitee
- Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
- Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
- Tencent Cloud SDK 3.0 for C++: GitHub Gitee
- Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
错误码 | 描述 |
---|---|
FailedOperation.ArrearsError | 账号已欠费。 |
FailedOperation.CountLimitError | 今日次数达到限制。 |
FailedOperation.InvoiceMismatch | 发票数据不一致。温馨提示:新版发票核验接口功能更完整,请尽快切换,如已切换请忽略。 |
FailedOperation.UnKnowError | 未知错误。 |
FailedOperation.UnOpenError | 服务未开通。 |
InvalidParameterValue.InvalidParameterValueLimit | 参数值错误。 |
InvalidParameterValue.PriceOrVerificationParameterValueLimit | 开票金额或校验码参数值错误。 |
InvalidParameterValue.TicketDateParameterValueLimit | 开票日期参数值错误。 |
ResourceNotFound.NoInvoice | 发票不存在。温馨提示:新版发票核验接口功能更完整,请尽快切换,如已切换请忽略。 |
ResourceNotFound.NotSupportCurrentInvoiceQuery | 不支持当天发票查询。 |
ResourceUnavailable.InArrears | 账号已欠费。 |
ResourceUnavailable.ResourcePackageRunOut | 账号资源包耗尽。 |
ResourceUnavailable.TaxNetworkError | 税务局网络异常,请稍后访问。 |
ResourcesSoldOut.ChargeStatusException | 计费状态异常。 |