发票识别API开发文档

小太阳

发票识别API开发文档

一、接口简介

1、版权说明：

未经翔云人工智能开放平台授权，不得擅自进行使用。

2、调用客户端运行环境

当客户端使用的编程语言为Java时，请使用1.5及以上版本JRE。

3、服务主要功能描述

翔云发票识别服务，支持增值税发票识别、火车票识别、机动车销售统一发票识别、PDF电子发票识别（仅支持PDF格式识别）、定额发票识别、出租车发票识别、航空运输电子客票行程单识别，并支持自动分类。识别速度快，支持扫描件识别和拍照识别。

1) 通过https协议post方法上传各种发票图像文件，通过https接口进行识别；

2) 将识别结果以XML或json格式返回给用户；

4、服务调用约束

在调用发票识别接口前，请您确保客户端程序或设备网络连接通畅，要求图像文件大小在200KB左右，扫描图像建议分辨率为300DPI，图像小于3M。

二、前提准备

1、用户登录 注册账号，如图:

2、输入注册信息，确认无误后点击同意条款并注册，如图:

file:///C:\Users\ADMINI~1\AppData\Local\Temp\ksohtml21404\wps19.jpg

3、注册成功后点击右上角的账号名称-个人中心，进入管理页面:

file:///C:\Users\ADMINI~1\AppData\Local\Temp\ksohtml21404\wps20.jpg

4、点击“用户管理-基础信息”，查看OCRKey以及OCRSecret：

file:///C:\Users\ADMINI~1\AppData\Local\Temp\ksohtml21404\wps21.jpg

5、点击“服务列表”，查看服务次数及余额(每调用一次https接口消耗一次)，可点击立即购买直接跳转到购买页面购买API服务次数：

file:///C:\Users\ADMINI~1\AppData\Local\Temp\ksohtml21404\wps22.jpg

6、购买成功后,会显示购买的总次数及剩余次数，例如下图所示：

file:///C:\Users\ADMINI~1\AppData\Local\Temp\ksohtml21404\wps23.jpg

7、设置剩余条数提醒，进入个人中心-用户管理-剩余条数提醒，设置提醒下线、通知手机号及服务类型，设置成功后到达用户设置的服务剩余条数下限，系统会发短息至预留手机号。

file:///C:\Users\ADMINI~1\AppData\Local\Temp\ksohtml21404\wps24.jpg

三、接口说明

接口地址，图片为base64流：

图片为file格式：

（注：调用图片为base64流接口时传参数img，调用图片为file格式接口传参数file）

接口调用方法：post

3、请求参数

名称	类型	必填	说明
img	String	是	上传的文件(图片的base64流)
key	String	是	用户ocrKey
file	MultipartFile	是	上传的文件(上传文件的字段名必须是“file”)
secret	String	是	用户ocrSecrert
typeId	Integer	是	识别类型（增值税发票2009；机动车发票20094；火车票20092； 自动分类20090；PDF电子票20093；定额票20095；出租车20096；行程单20097）
outvalue	String	是	输出选项(0为全部返回)
format	String	是	返回格式(xml或者json)，如果format为空，则默认返回xml

识别结果字符串
<status/>标签显示了识别状态，大于等于“0”代表识别成功【“0”代表查询成功，“1”代表未查到数据，“2”代表查询失败】，小于“0”代表识别失败，失败的原因在<value/>中描述。

调用错误码

status值	描述
-1	用户已屏蔽
-2	用户key或secret验证错误
-3	服务次数不足
-4	用户未找到
-6	系统异常
-7	图片不可为空，参数不可为空
-8	类型错误

识别错误码1

status值	描述
-1	识别失败

识别错误码2

value值	描述
InvoiceRecognizeImage4	裁切图像失败
InvoiceRecognizeImage5	加载图像失败
InvoiceRecognizeImage6	识别失败
Interface call error	接口调用错误

调用方式(java客户端基于httpclient4.3)
1.依赖库: \java客户端\httpClient4.3库\

2.示例程序代码详见: \java客户端\httpClientDemo\中的Client类

在main方法定义参数，并传入 doPost(url, file, key, secret, typeId,outvalue, format)方法中。