增值税发票查验

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

uid

string

必需

传入的请求ID，用于标识一次调用，传入前先保存，需保证唯一性。排查接口异常时，可提供该字段方便定位

>= 16 字符<= 36 字符

checkInvoiceItmes

array [object {4}] | null

增值税发票集合

可选

invoiceCode

string | null

发票代码

可选

正则匹配:

^[\s\d]*$|^\d{10}$|^\d{12}$

invoiceNumber

string

发票号码

必需

>= 1 字符

正则匹配:

^\d{8}$|^\d{20}$

invoiceDate

string

必需

开票日期格式为 yyyy-MM-dd

>= 1 字符

正则匹配:

^\d{4}\-\d{2}\-\d{2}$

value

string

必需

增值税发票管理系统

（1）增值税专用发票、增值税电子专用发票：发票代码、发票号码、开票日期、校验项 => 开具金额（不含税）
（2）增值税普通发票、增值税电子普通发票（含通行费发票）、增值税普通发票（卷票）：发票代码、发票号码、开票日期、校验项 => 校验码后六位
（3）机动车销售统一发票：发票代码、发票号码、开票日期、校验项 => 不含税价
（4）二手车销售统一发票：发票代码、发票号码、开票日期、校验项 => 车价合计

电子发票服务平台

（1）电子发票（增值税专用发票）、电子发票（普通发票）、电子发票（机动车销售统一发票）、电子发票（二手车销售统一发票）：发票号码（20位）、开票日期、校验项 => 价税合计
（2）电子发票服务平台开具的纸质增值税专用发票：发票代码、发票号码、开票日期、校验项 => 开具金额（不含税）
（3）电子发票服务平台开具的纸质增值税普通发票：发票代码、发票号码、开票日期、校验项 => 密码区发票号码后六位
（4）电子发票 (铁路电子客票)：发票号码（20位）、开票日期、校验项 => 票价
（5）电子发票 (航空运输电子客票行程单)：票号码（20位）、开票日期、校验项 => 开票金额（价税合计）

>= 1 字符

示例

{
  "uid": "stringstringstri",
  "checkInvoiceItmes": [
    {
      "invoiceCode": "string",
      "invoiceNumber": "string",
      "invoiceDate": "string",
      "value": "string"
    }
  ]
}

返回响应

🟢200增值税发票查验返回成功

application/json

Body

result

object

必需

successInvoiceOutputs

array [object {23}] | null

发票查验成功信息

必需

failureInvoiceOutputs

array [object {3}] | null

发票查验失败信息

必需

status

integer

状态

必需

errorMessage

string

必需

示例

成功示例成功示例

{
  "result": {
    "successInvoiceOutputs": [
      {
        "queryTime": "2024-10-10 19:07:04",
        "queryCount": "23",
        "taxBureau": "海南",
        "invStatus": "2",
        "invoiceType": "08",
        "invoiceCode": "046******113",
        "invoiceNumber": "00****01",
        "invoiceDate": "2021-01-21 00:00:00",
        "checkCode": "0802080*******934466",
        "machineNumber": "5170***28105",
        "buyName": "海口鑫润***科技有限公司",
        "buyTaxNumber": "9146010*****GFF20E",
        "buyAddressPhone": "海南省海口市***府城镇城东***坎*路",
        "buyBankAccount": "工行海口市琼山支行2201025******199345",
        "amount": "1300.00",
        "taxAmount": "117.00",
        "sumAmount": "1417.00",
        "saleName": "海口壹优****有限公司",
        "saleTaxNumber": "91460*****5TUKMQ30",
        "saleAddresPhone": "海南省海口市琼山区城西下街****144号133*****381",
        "saleBankAccount": "工行琼山支行000000000000000000000000",
        "redInvoices": [],
        "invoiceItems": [
          {
            "sequence": "1",
            "goodName": "*水果*橙",
            "unit": "kg",
            "quantity": "100",
            "price": "13.00",
            "amount": "1300.00",
            "taxRate": "9",
            "taxAmount": "117.00"
          }
        ]
      }
    ],
    "failureInvoiceOutputs": []
  },
  "status": 200,
  "errorMessage": ""
}

🟢200电子发票查验返回成功

🟢200增值税普通发票（卷票）查验成功返回

🟢200道路通行费电子普通发票查验返回成功

🟢200数电票（航空运输电子客票行程单）查验返回成功

🟢200数电票（铁路客票）查验返回成功

🟢200机动车销售统一发票返回成功

🟢200二手车销售统一发票查验返回成功

请求参数

示例代码

返回响应