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

国际发票识别(明细)

POST
/ai/knowledge/nlpService/document/analyze
本接口用于各类文件智能处理,支持根据不同的templateId进行不同的文档处理逻辑,暂未完成发文和上架流程,使用前需要与发票云基础部门确认可用的templateId
templateId=1 发票云发票的明细识别,仅白名单客户可用
支持语言:中文、英语、日语、越南语;
支持类型:标题带invoice且invoice no、购销方信息、total amount俱全的印刷打印版式票据,不支持手写发票
单图多票:不支持
单文件多票:不支持
单票多页:目前每一页独立识别,独立返回数据不做合并处理
docType:暂时无法判定是否为发票,调用默认当invoice

请求参数

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_”开头
示例值:
1
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="1"' \
--form 'language="auto"' \
--form 'fileHash="fc434b5ee3ca876973634d99ca0159e2"' \
--form 'cutImage="false"'

返回响应

🟢200成功
application/json
Body
errcode
string 
必需
0000 代表正常返回成功
description
string 
返回描述
必需
data
array [object {4}] 
返回结果
必需
header
object 
表头信息
必需
detail
object 
明细信息
可选
orientation
string 
旋正角度
可选
仅cutImage=true返回,逆时针旋正角度
示例值:
90
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"
}
上一页
国际发票识别
下一页
文档信息识别(反馈)
Built with