增值税发票核验
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 增值税发票核验 > API 文档 > 增值税发票核验

增值税发票核验

最近更新时间：2023-12-28 10:18:52

我的收藏

本页目录：

1. 接口描述

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

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。
参数名称
必选
类型
描述
Action
是
String
公共参数，本接口取值：VatInvoiceVerify。
Version
是
String
公共参数，本接口取值：2018-11-19。
Region
是
String
公共参数，详见产品支持的 地域列表，本接口仅支持其中的: ap-beijing, ap-guangzhou, ap-hongkong, ap-shanghai, na-toronto
InvoiceCode
是
String
发票代码， 一张发票一天只能查询5次。
InvoiceNo
是
String
发票号码（8位）。
InvoiceDate
是
String
开票日期（不支持当天发票查询，只支持一年以内），如：2019-12-20。
Additional
是
String
金额/发票校验码后6位（根据票种传递对应值，如果报参数错误，请仔细检查每个票种对应的值）
增值税专用发票：开具金额（不含税）
增值税普通发票、增值税电子普通发票（含通行费发票）、增值税普通发票（卷票）：校验码后6位
机动车销售统一发票：不含税价
货物运输业增值税专用发票：合计金额
二手车销售统一发票：车价合计

3. 输出参数

参数名称
类型
描述
Invoice
增值税发票信息，详情请单击左侧链接。
RequestId
String
唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 增值税发票核验示例代码

输入示例

https://ocr.tencentcloudapi.com/?Action=VatInvoiceVerify
&InvoiceCode=1300000000
&InvoiceNo=04000000
&InvoiceDate=2019-12-11
&Additional=88.50
&<公共请求参数>

输出示例

{
  "Response": {
    "Invoice": {
      "Code": "1300000000",
      "Number": "04000000",
      "Date": "20191211",
      "BuyerName": "栾城区xxx厂",
      "BuyerTaxCode": "92XXXXMAXXXXXX",
      "BuyerAddressPhone": "栾城区北留营村1501****678",
      "BuyerBankAccount": "中国农业银行股份有限公司xx分理处xx",
      "SellerName": "石家庄市XXX石油经销有限公司",
      "SellerTaxCode": "911301047981234567",
      "SellerAddressPhone": "石家庄市桥西区师范街xx号 0311-1****678",
      "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"
        }
      ]
    },
    "RequestId": "163b7f97-0b1f-4054-b8e5-bdfb5a6c213f"
  }
}

5. 开发者资源

API Explorer

该工具提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力，能显著降低使用云 API 的难度，推荐使用。
API 3.0 Explorer

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。
Tencent Cloud SDK 3.0 for Python
Tencent Cloud SDK 3.0 for Java
Tencent Cloud SDK 3.0 for PHP
Tencent Cloud SDK 3.0 for Go
Tencent Cloud SDK 3.0 for NodeJS
Tencent Cloud SDK 3.0 for .NET

命令行工具

Tencent Cloud CLI 3.0

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码 。
错误码
描述
FailedOperation.ArrearsError
账号已欠费。
FailedOperation.CountLimitError
今日次数达到限制。
FailedOperation.InvoiceMismatch
发票数据不一致。
FailedOperation.UnKnowError
未知错误。
FailedOperation.UnOpenError
服务未开通。
InvalidParameterValue.InvalidParameterValueLimit
参数值错误。
ResourceNotFound.NoInvoice
发票不存在。
?
中国站


http://www.vxiaotou.com