国内通用票据识别 - Banas 开放平台

该接口用于票据识别。目前支持：
0-未知发票
01-增值税专用发票
03-机动车销售统一发票
04-增值税普通发票
08-增值税电子专用发票
10-增值税电子普通发票
11-增值税普通发票（卷票）
14-增值税电子普通发票（通行费）
15-二手车销售统一发票
90-电子发票（增值税专用发票）
09-电子发票（普通发票）
83-数电票（机动车销售统一发票）
84-数电票（二手车销售统一发票）
85-数电纸质发票（增值税专用发票）
86-数电纸质发票（普通发票）
87-数电纸质发票（机动车销售统一发票）
88-数电纸质发票（二手车销售统一发票）
51-数电票（铁路电子客票）
61-数电票（航空运输电子客票行程单）
21-区块链电子发票
33-出租车发票
34-火车票
35-飞机行程单
36-机打发票
37-通用机打发票
38-通用定额发票
39-旅客运输普票
40-公路客运发票
41-医疗费发票
42-非税收入统一发票
43-停车费发票
44-船运客票
45-过路过桥费发票

注意，目前支持jpg, png, pdf, ofd等格式，文件大小不超过 10M，图像宽高须介于 20 和 10000（像素）之间。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

access_token

string

可选

通过调用access_token接口返回的access_token值

content-Type

string

可选

示例值:

application/json

Body 参数application/json

uid

string

必需

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

>= 16 字符<= 36 字符

fileString

string

必需

发票文件数据（Base64）

示例

{
    "uid": "string",
    "fileString": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200多张发票识别成功

application/json

Body

result

object

必需

ocrDataList

array [object {2}]

必需

status

integer

必需

errorMessage

string | null

必需

示例

[
    {
        "type": "90",
        "data": {
            "invoiceType": "90",
            "qrCode": "01,31,,21317*********00001,164.00,20211201,,A84F,",
            "invoiceNumber": "21*******00000000001",
            "invoiceDate": "2021-12-01",
            "buyName": "上海**物流有限公司",
            "buyTaxNumber": "9131011****307***9",
            "saleName": "港航**(上海)数字科技有限公司",
            "saleTaxNumber": "9131****351****62H",
            "amount": "154.71",
            "taxAmount": "9.29",
            "sumAmount": "164.0",
            "remark": "提单号: ZIM***V981331; 船名航次: *****LORETTA/14W",
            "drawer": "华*玮",
            "invoiceItems": [
                {
                    "goodName": "*物流辅助服务*港口设施**费(代收)",
                    "model": "无",
                    "unit": "件",
                    "quantity": "1",
                    "price": "11.32",
                    "amount": "11.32",
                    "taxRate": "6",
                    "taxAmount": "0.68"
                },
                {
                    "goodName": "*物流辅助服务*货物**费(代收)",
                    "model": "无",
                    "unit": "件",
                    "quantity": "1",
                    "price": "64.15",
                    "amount": "64.15",
                    "taxRate": "6",
                    "taxAmount": "3.85"
                },
                {
                    "goodName": "*物流辅助服务*库场**费(代收)",
                    "model": "无",
                    "unit": "件",
                    "quantity": "1",
                    "price": "15.09",
                    "amount": "15.09",
                    "taxRate": "6",
                    "taxAmount": "0.91"
                },
                {
                    "goodName": "*物流辅助服务*港口作业**费(代收)",
                    "model": "无",
                    "unit": "件",
                    "quantity": "1",
                    "price": "64.15",
                    "amount": "64.15",
                    "taxRate": "6",
                    "taxAmount": "3.85"
                }
            ]
        }
    }
]

🟢200增值税发票识别成功

🟢200电子发票识别成功

🟢200增值税普通发票（卷票）识别成功

🟢200道路通行费电子普通发票识别成功

🟢200机动车销售统一发票识别成功

🟢200二手车销售统一发票识别成功

🟢200区块链电子发票识别成功

🟢200数电票（航空运输电子客票行程单）识别成功

🟢200数电票（铁路电子客票）识别成功

🟢200出租车发票识别成功

🟢200火车票识别成功

🟢200飞机行程单识别成功

🟢200过路过桥费发票识别成功

🟢200通用机打发票识别成功

🟢200通用定额发票、停车费发票识别成功

🟢200旅客运输普票、公路客运发票识别成功

🟢200船运客票识别成功

🟢200非税收入统一发票识别成功

🟢200医疗发票识别成功