增值税发票查验 - Banas 开放平台

请求参数

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"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢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二手车销售统一发票查验返回成功