发票云(智能特性)
旗舰版标准版智能特性
旗舰版标准版智能特性
🤖 AI Support​​
  1. 文档信息识别
  • 整体介绍
  • 开发指南
  • 授权
    • token获取
      POST
  • 智能特性
    • 文档信息识别
      • 国际发票识别
        POST
      • 国际发票识别(明细)
        POST
      • 文档信息识别(反馈)
        POST
      • 银行回单识别
        POST
    • 文档分类(区分发票、附件)
      POST
    • 智能赋码税收分类编码识别
      POST
    • 三单匹配-同步接口
      POST
    • 三单匹配-异步任务提交
      POST
    • 三单匹配-异步结果查询
      GET
  • 文档中心
    • 外部文件上传接口
      POST
  • 国际发票
  1. 文档信息识别

国际发票识别

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,由前置脚本生成,失效的调用一下获取授权接口即可
示例值:
{{access_token}}
Header 参数
client-platform
string 
必需
示例值:
common
Body 参数multipart/form-data
file
file 
必需
输入文件的文件流,支持'jpg', 'png', 'jpeg', 'pdf',文件大小上限6MB
示例值:
[]
templateId
string 
必需
模板id,默认为"0"。不可以以“FB_”开头
示例值:
0
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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
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度能旋正图像
示例值:
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"
}
上一页
token获取
下一页
国际发票识别(明细)
Built with