发票识别API开发文档

发票识别API开发文档

一、接口简介
1、版权说明：
未经翔云人工智能开放平台授权，不得擅自进行使用。
2、调用客户端运行环境
当客户端使用的编程语言为Java时，请使用1.5及以上版本JRE。
3、服务主要功能描述
翔云发票识别服务，支持增值税发票识别、火车票识别、机动车销售统一发票识别、PDF电子发票识别（仅支持PDF格式识别）、定额发票识别、出租车发票识别、航空运输电子客票行程单识别，并支持自动分类。识别速度快，支持扫描件识别和拍照识别。

1. 通过https协议post方法上传各种发票图像文件，通过https接口进行识别；
2. 将识别结果以XML或json格式返回给用户；
   4、服务调用约束
   在调用发票识别接口前，请您确保客户端程序或设备网络连接通畅，要求图像文件大小在200KB左右，扫描图像建议分辨率为300DPI，图像小于3M。
   二、前提准备
   1、用户登录 https://www.netocr.com/register.html注册账号，如图:
   2、输入注册信息，确认无误后点击同意条款并注册，如图:

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

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

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

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

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

三、接口说明
接口地址，图片为base64流：https://netocr.com/api/recogInvoiveBase64.do
图片为file格式：https://netocr.com/api/recogInvoive.do
（注：调用图片为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
识别结果字符串
标签显示了识别状态，大于等于“0”代表识别成功【“0”代表查询成功，“1”代表未查到数据，“2”代表查询失败】，小于“0”代表识别失败，失败的原因在中描述。
调用错误码
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)方法中。如图:

执行main方法返回识别结果如下：

增值税发票：
{
“message”:{
“status”:0,
“value”:“识别完成”
},
“cardsinfo”:[
{
“type”:“2009”,
“items”:[
{
“nID”:null,
“index”:null,
“desc”:“发票代码”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“发票号码”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“开票日期”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“机器编号”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“购方税号”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“销方税号”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“金额”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“税额”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“合计金额”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“校验码”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“二维码”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“密文”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“购方名称”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“销方名称”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“大写金额”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“购方地址、电话”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“购方开户行及账号”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“销方地址、电话”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“销方开户行及账号”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“收款人”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“复核”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“开票人”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“备注”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“发票联”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“明细内容”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“印刷发票代码”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“印刷发票号码”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“票据属性”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“二维码发票代码”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“二维码发票号码”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“指定区域二维码”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“发票综合代码”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“发票综合号码”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“是否有印章”,
“content”:""
},
{
“nID”:null,
“index”:null,
“desc”:“发票类型”,
“content”:""
}]
}]
}

机动车发票：
{
“message”: {
“status”: 0,
“value”: “识别完成”
},
“cardsinfo”: [
{
“type”: “20094”,
“items”: [
{
“nID”: null,
“index”: null,
“desc”: “税控码”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “发票代码”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “发票号码”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “机器编号”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “开票日期”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “销方税号”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “主管税务机关代码”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “购方税号”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “税率”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “车架号码”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “价税合计”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “税额”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “大写金额”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “销方名称”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “购方名称”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “购方身份证号”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “车辆类型”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “厂牌型号”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “产地”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “合格证号”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “进口证明”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “商检单号”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “发动机号”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “电话”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “账号”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “地址”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “开户行”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “主管税务机关”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “限乘人数”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “开票人”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “不含税金额小写”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “发票类型”,
“content”: “机动车销售统一发票”
}
]
}
]
}

火车票：
{
“message”: {
“status”: “0”,
“value”: “识别完成”
},
“cardsinfo”: [
{
“type”: “20092”,
“items”: [
{
“nID”: null,
“index”: “null”,
“desc”: “车次”,
“content”: “”,
},
{
“nID”: null,
“index”: “null”,
“desc”: “出发站”,
“content”: “”
},
{
“nID”: null,
“index”: “null”,
“desc”: “终点站”,
“content”: “”
},
{
“nID”: null,
“index”: “null”,
“desc”: “日期”,
“content”: “”
},
{
“nID”: null,
“index”: “null”,
“desc”: “时间”,
“content”: “”
},
{
“nID”: null,
“index”: “null”,
“desc”: “座位”,
“content”: “”
},
{
“nID”: null,
“index”: “null”,
“desc”: “座位类型”,
“content”: “”
},
{
“nID”: null,
“index”: “null”,
“desc”: “票价”,
“content”: “”
},
{
“nID”: null,
“index”: “null”,
“desc”: “证件号码”,
“content”: “”
},
{
“nID”: null,
“index”: “null”,
“desc”: “姓名”,
“content”: “”
},
{
“nID”: null,
“index”: “null”,
“desc”: “编号”,
“content”: “”
},
{
“nID”: null,
“index”: “null”,
“desc”: “发票类型”,
“content”: “火车票”
}
]
}
]
}

PDF电子发票：
{
“message”: {
“status”: 0,
“value”: “识别完成”
},
“cardsinfo”: [
{
“type”: “20093”,
“items”: [
{
“nID”: null,
“index”: null,
“desc”: “发票代码”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “发票号码”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “开票日期”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “机器编号”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “购方税号”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “销方税号”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “金额”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “税额”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “合计金额”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “校验码”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “二维码”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “密文”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “购方名称”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “销方名称”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “大写金额”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “购方地址、电话”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “购方开户行及账号”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “销方地址、电话”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “销方开户行及账号”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “收款人”,
“content”: “刘杰”
},
{
“nID”: null,
“index”: null,
“desc”: “复核”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “开票人”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “备注”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “发票联”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “明细内容”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “印刷发票代码”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “印刷发票号码”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “票据属性”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “二维码发票代码”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “二维码发票号码”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “发票类型”,
“content”: “PDF电子发票”
}
]
}
]
}

定额发票：
{
“message”: {
“status”: 0,
“value”: “识别完成”
},
“cardsinfo”: [
{
“type”: “20095”,
“items”: [
{
“nID”: null,
“index”: null,
“desc”: “发票代码”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “发票号码”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “票面金额”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “公司印章”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “省份”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “城市”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “发票类型”,
“content”: “定额发票”
}
]
}
]
}

出租车发票：
{
“message”: {
“status”: 0,
“value”: “识别完成”
},
“cardsinfo”: [
{
“type”: “20096”,
“items”: [
{
“nID”: null,
“index”: null,
“desc”: “发票代码”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “发票号码”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “所属行政区名称”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “开票日期”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “票面金额”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “上车时间”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “下车时间”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “里程”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “省份”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “城市”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “车牌号”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “发票类型”,
“content”: “出租车发票”
}
]
}
]
}

航空运输电子客票行程单：
{
“message”: {
“status”: 0,
“value”: “识别完成”
},
“cardsinfo”: [
{
“type”: “20097”,
“items”: [
{
“nID”: null,
“index”: null,
“desc”: “乘客姓名”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “乘客证件号码”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “印刷序号”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “电子客票号码”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “校验码”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “开票日期”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “填开单位”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “销售单位代号”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “合计金额”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “合计税额”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “燃油附加费”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “民航发展基金”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “保险费”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “航班信息”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “国内国际标签”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “票面金额”,
“content”: “”
},
{
“nID”: null,
“index”: null,
“desc”: “发票类型”,
“content”: “航空运输电子客票行程单”
}
]
}
]
}

剩余条数查询接口(所有产品类型)
接口地址： https://netocr.com/api/accountLift.do
接口调用方法： post
接口接收参数：
String key： 用户ocrKey
String secret： 用户ocrSecret
String format： 返回格式(xml或者json)，如果format为空，则默认返回xml

本文来自互联网用户投稿，文章观点仅代表作者本人，不代表本站立场，不承担相关法律责任。如若转载，请注明出处。 如若内容造成侵权/违法违规/事实不符，请点击【内容举报】进行投诉反馈！