有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

1. 接口描述

接口请求域名: ocr.tencentcloudapi.com 。

本接口支持增值税发票的准确性核验,您可以通过输入增值税发票的关键字段提供所需的验证信息,接口返回真实的票面相关信息,包括发票代码、发票号码、开票日期、金额、消费类型、购方名称、购方税号、销方名称、销方税号等多个常用字段。支持多种发票类型核验,包括增值税专用发票、增值税普通发票(含电子普通发票、卷式发票、通行费发票)、全电发票、机动车销售统一发票、货物运输业增值税专用发票、二手车销售统一发票。

默认接口请求频率限制:20次/秒。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:VatInvoiceVerify。
Version String 公共参数,本接口取值:2018-11-19。
Region String 公共参数,详见产品支持的 地域列表,本接口仅支持其中的: ap-beijing, ap-guangzhou, ap-hongkong, ap-shanghai, na-toronto 。
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。

命令行工具

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 计费状态异常。