国际发票识别（明细） - 发票云（智能特性）

本接口用于各类文件智能处理，支持根据不同的templateId进行不同的文档处理逻辑，暂未完成发文和上架流程，使用前需要与发票云基础部门确认可用的templateId

templateId=1 发票云发票的明细识别，仅白名单客户可用
支持语言：中文、英语、日语、越南语；
支持类型：标题带invoice且invoice no、购销方信息、total amount俱全的印刷打印版式票据，不支持手写发票
单图多票：不支持
单文件多票：不支持
单票多页：目前每一页独立识别，独立返回数据不做合并处理
docType：暂时无法判定是否为发票，调用默认当invoice

请求参数

Query 参数

access_token

string

必需

授权token,由前置脚本生成，失效的调用一下获取授权接口即可

示例值:

Header 参数

client-platform

string

必需

示例值:

common

Body 参数multipart/form-data

file

必需

输入文件的文件流，支持'jpg', 'png', 'jpeg', 'pdf'，文件大小上限6MB

示例值:

[]

templateId

string

必需

模板id,默认为“0”，明细接口必须传入。不可以以“FB_”开头

示例值:

language

string

可选

文档语言，默认为"auto",自动识别语言（当前不支持）;“chs”:“中文”,“cht”:“繁体中文” ,“eng”:“英语”,“jpn”:“日语”, “kor”:’韩语’, “vie”:”越南语”, “tha”:”泰语”, “spa”:”西班牙语”, “deu”:”德语”, “fra”:”法语”, “rus”:”俄语”, “nld”:”荷兰语”,”ita”:”意大利语” , “por”:”葡萄牙语”

示例值:

auto

fileHash

string

可选

文件hash值，可不传入，不传入的话会自动生成

示例值:

fc434b5ee3ca876973634d99ca0159e2

cutImage

boolean

必需

是否需要混贴识别，混贴识别会使接口处理时长增加

默认值:

false

示例值:

false

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

errcode

string

必需

0000 代表正常返回成功

description

string

返回描述

必需

data

array [object {4}]

返回结果

必需

header

object

表头信息

必需

detail

object

明细信息

可选

orientation

string

旋正角度

可选

仅cutImage=true返回，逆时针旋正角度

示例值:

regionArr

string

原图坐标

可选

仅cutImage=true返回，发票在原图的位置坐标

traceId

string

必需

请求唯一标识，用于追踪和关联一次请求的整个生命周期

示例

{
    "errcode": "string",
    "description": "string",
    "data": [
        {
            "header": {
                "basic": {
                    "sourceFileHash": "string",
                    "docType": "string",
                    "nameOfInvoice": "string",
                    "invoiceNumber": "string",
                    "invoiceCode": "string",
                    "invoiceDate": "string",
                    "totalNetAmount": "string",
                    "totalAmount": "string",
                    "totalTaxAmount": "string",
                    "currency": "string"
                },
                "billTo": {
                    "billToComposite": "string",
                    "billToName": "string",
                    "billToCity": "string",
                    "billToStateOrProvince": "string",
                    "billToCountry": "string",
                    "billToFax": "string",
                    "billToPostalCode": "string",
                    "billToTelephone": "string",
                    "billToTaxIdentificationNumber": "string",
                    "billToRecipient": "string",
                    "billToBankAccount": "string",
                    "billToBankOfAccount": "string",
                    "billToEmail": "string"
                },
                "billFrom": {
                    "billFromComposite": "string",
                    "billFromName": "string",
                    "billFromCity": "string",
                    "billFromStateOrProvince": "string",
                    "billFromCountry": "string",
                    "billFromFax": "string",
                    "billFromPostalCode": "string",
                    "billFromTelephone": "string",
                    "billFromTaxIdentificationNumber": "string",
                    "billFromBankAccount": "string",
                    "billFromBankOfAccount": "string",
                    "billFromEmail": "string"
                },
                "bussiness": {
                    "purchaseOrderNumber": "string",
                    "contractNumber": "string",
                    "startDate": "string",
                    "endDate": "string"
                },
                "payment": {
                    "paymentMethod": "string",
                    "paymentStatus": "string",
                    "paymentTerms": "string",
                    "dueDate": "string",
                    "paymentCurrency": "string",
                    "exchangeRate": "string",
                    "paidAmount": "string"
                }
            },
            "detail": {
                "detailOfGoodsOrServices": [
                    {
                        "articlelD": "string",
                        "articleName": "string",
                        "quantity": "string",
                        "unitOfMeasure": "string",
                        "unitPrice": "string",
                        "netAmount": "string",
                        "taxRate": "string",
                        "tax": "string",
                        "grossAmount": "string",
                        "description": "string",
                        "orderNumber": "string"
                    }
                ],
                "detailOfTaxSummary": [
                    {
                        "taxCategory": "string",
                        "taxRate": "string",
                        "netTAxableAmount": "string",
                        "tax": "string"
                    }
                ]
            },
            "orientation": "90",
            "regionArr": "string"
        }
    ],
    "traceId": "string"
}