国际发票识别

POST

/ai/knowledge/nlpService/document/analyze

本接口用于各类文件智能处理，支持根据不同的templateId进行不同的文档处理逻辑，须购买发票云《文档智能取数服务流量包公有云》才能使用

templateId=0 发票云发票的识别
支持语言：支持中文、英语、日语、越南语，支持付费定制语言
支持类型：发票号码、购销方信息、交易金额俱全的版式印刷打印发票，不支持手写发票
单图多票：不支持
单文件多票：不支持
单票多页：目前每一页独立识别，独立返回数据不做合并处理
docType：调用默认当invoice
invoiceNumber：发票唯一号码，invoice#、invoice no、invoice number等，越南语Số (No)
invoiceDate：发票日期，目前无法“格式化”，年月能可能顺序无法确定，只按识别的字符和票面一样即是正确，另外格式不同也是正确“1/11/2019”=“2019-1-11”=“2019-01-11”=“2019/01/11”
billTo：受票方信息可能为缩写，也可能为全称，接收方需要做后处理
billFrom：开具方信息可能为缩写，也可能为全称，接收方需要做后处理
totalAmount：可能带有千分号，比如1,799.00=1799.00。没有总金额的情况下，会返回""
taxAmount：没有总税额的情况下会返回""

请求参数

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

curl --location -g --request POST '/ai/knowledge/nlpService/document/analyze?access_token={{access_token}}' \
--header 'client-platform: common' \
--form 'templateId="0"' \
--form 'language="auto"' \
--form 'fileHash="fc434b5ee3ca876973634d99ca0159e2"' \
--form 'cutImage="false"'

返回响应

🟢200成功

application/json

Body

errcode

string

必需

0000 代表正常返回成功

description

string

返回描述

必需

data

array [object {11}]

返回结果

必需

fileHash

string

文件hash值

必需

文件唯一值

docType

enum<string>

文件类型

可选

枚举值:

invoicereceiptother

示例值:

invoice

invoiceNumber

string

发票号码

可选

invoiceDate

string

发票日期

可选

currency

string

币种

可选

识别票面币别或总金额币别，转ISO4271:2015的币别代码输出

示例值:

CNY

totalAmount

string

总金额

可选

billToName

string

收票方名称

可选

billFromName

string

开票方名称

可选

totalTaxAmount

string

总税额

可选

orientation

string

旋正角度

可选

仅cutImage=true返回，切割识别后返回旋正角度，如90，即逆时针旋转90度能旋正图像

示例值:

regionArr

string

原图坐标

可选

仅cutImage=true返回，混贴切割后，本切图在原图的坐标区域

示例值:

[23,75,1611,556]

traceId

string

必需

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

示例

{
  "errcode": "string",
  "description": "string",
  "data": [
    {
      "fileHash": "string",
      "docType": "invoice",
      "invoiceNumber": "string",
      "invoiceDate": "string",
      "currency": "CNY",
      "totalAmount": "string",
      "billToName": "string",
      "billFromName": "string",
      "totalTaxAmount": "string",
      "orientation": "90",
      "regionArr": "[23,75,1611,556]"
    }
  ],
  "traceId": "string"
}

修改于 2025-03-18 10:57:47

token获取

文档信息识别（反馈）