增值税发票
一、接口描述
1. 功能描述
基于深度学习技术的增值税发票ocr,识别字段包括:密码区、校验码、打印校验码、代开、发票代码 、打印发票代码 、右侧打印发票代码、开票人、增值税发票No号码、发票号码等字段
2. 接口数据要求:
图片格式:base64编码
图片类型: jpg/jpeg/png/bmp
图片大小: 小于5M
3. 接口使用:
我们为每个API提供试用体验服务,您在AI市场选择“免费试用5次”规格下单后,即可开始体验业内领先的人工智能API服务。 如需更多的服务数量,您可以按需购买,我们有多种优惠方案供您选择。
在获得使用权限后,您可使用已经封装好的SDK/参照接口鉴权规则进行相应开发,整体流程详见 接入流程
用户需要使用增值税发票图片base64编码去做请求,使用其他图片的base64编码请求成功时也会加入计费。
二、请求说明
1. 接口地址 :
https://aiapi.jd.com/INTSIG/invoice
2. 请求方式:
post
三、返回字段描述
(1)公共返回参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
code | string | 1000 | 参见下方错误码-系统级错误码 |
charge | boolean | false 或 true | false:不扣费, true:扣费 |
remainTimes | long | 1305 | 剩余调用次数;免费api:每天剩余调用次数;收费api:剩余次数;无限制时为-1 |
remainSeconds | long | 1223456 | 剩余调用时间(s);免费api:-1;收费api:剩余调用时间;无限制时为-1 |
msg | string | 查询成功 | 参见下方错误码-系统级错误码 |
result | object | {...} | 查询结果 |
(2)业务返回参数
字段 | 说明 |
---|---|
code | 返回状态码。200:正常返回; 500:服务器内部错误 |
message | 返回对应code的状态说明 |
cost_time | 识别耗时 |
result | 图片结果信息 |
+rotated_image_width | 旋转后图片宽度 |
+rotated_image_height | 旋转后图片高度 |
+image_angle | 图片旋转角度(顺时针) |
+kind_description | 图片票据大类类型 |
+kind | 票据使用类型 |
+type | 图片票据具体类型 |
+type_description | type字段对应的中文描述 |
+item_list | OCR识别结果 |
++key | 识别字段类型 |
++value | 识别字段结果 |
++position | 识别字段在原图中的坐标位置 |
++confidence | key字段对应的置信度 |
++description | key字段对应的中文描述 |
type返回的类型列表:
字段 | 说明 |
---|---|
vat_special_invoice | 增值税专用发票 |
vat_electronic_invoice | 增值税电子发票 |
vat_common_invoice | 增值税普通发票 |
key返回的类型列表:
字段 | 说明 | |
---|---|---|
vat_invoice_correct_code | 校验码 | |
vat_invoice_daima | 发票代码 | |
vat_invoice_haoma | 发票号码 | |
vat_invoice_haoma_large_size | 增值税发票No号码 | |
vat_invoice_issue_date | 开票日期 | |
vat_invoice_rate_payer_id | 纳税人识别号 | |
vat_invoice_total | 合计 | |
vat_invoice_tax_rate | 增值税税率 | |
vat_invoice_seller_name | 销售方名称 | |
vat_invoice_seller_bank_account | 销售方开户行及帐号 | |
vat_invoice_seller_id | 销售方纳税人识别号 | |
vat_invoice_seller_addr_tell | 销售方地址、电话 | |
vat_invoice_payer_name | 购买方名称 | |
vat_invoice_payer_bank_account | 购买方开户行及帐号 | |
vat_invoice_payer_addr_tell | 购买方地址、电话 | |
vat_invoice_total_cover_tax | 价税合计大写 | |
vat_invoice_total_cover_tax_digits | 价税合计小写 | |
vat_invoice_tax_total | 税额合计 | |
vat_invoice_goods_list | 货物或服务名称 | |
vat_invoice_price_list | 金额明细 | |
vat_invoice_tax_rate_list | 税率明细 | |
vat_invoice_tax_list | 税额明细 | |
vat_invoice_zhuan_yong_flag | 专票/普票 | |
vat_invoice_dai_kai_flag | 代开(非代开条目为空) | |
vat_invoice_plate_specific | 规格型号明细 | |
vat_invoice_electrans_unit | 单位明细 | |
vat_invoice_electrans_quantity | 数量明细 | |
vat_invoice_electrans_unit_price | 单价明细 | |
vat_invoice_daima_right_side | 右侧打印发票代码 | |
vat_invoice_haoma_right_side | 右侧打印发票号码 | |
vat_invoice_page_number | 抵扣联/发票联 | |
vat_invoice_type | 发票类型 | |
vat_invoice_total_note | 备注 | |
vat_invoice_cipher_field | 密码区 | |
vat_invoice_drawer | 开票人 | |
vat_invoice_review | 复核 | |
vat_invoice_payee | 收款人 | |
exist_stample | 盖章存在性判断 | |
vat_invoice_headline_page_number | 标题发票联 | |
vat_invoice_corrent_code_print | 打印校验码 | |
vat_invoice_total_print | 打印合计 | |
vat_invoice_note_correct_code | 备注校验码 | |
vat_invoice_machine_no | 机器编号 | |
vat_invoice_daima_print | 打印发票代码 | |
vat_invoice_elec_payment_id | 电子支付标识 | |
vat_invoice_issue_date_print | 右侧打印开票日期 | |
vat_invoice_qr_code | qr码 |
正常返回示例(业务参数)
{
"cost_time":3423,
"result":{
"image_angle":0,
"type_description":"增值税普通发票",
"rotated_image_width":1920,
"rotated_image_height":1080,
"kind":"service",
"item_list":[
{
"value":"3100171320",
"description":"发票代码",
"position":[
159,
32,
463,
32,
463,
277,
159,
277
],
"key":"vat_invoice_daima",
"confidence":1
},
{
"value":"64802685",
"description":"发票号码",
"position":[
159,
32,
463,
32,
463,
277,
159,
277
],
"key":"vat_invoice_haoma",
"confidence":1
},
{
"value":"76698073222551741143",
"description":"校验码",
"position":[
159,
32,
463,
32,
463,
277,
159,
277
],
"key":"vat_invoice_correct_code",
"confidence":1
},
{
"value":"2017年06月06日",
"description":"开票日期",
"position":[
159,
32,
463,
32,
463,
277,
159,
277
],
"key":"vat_invoice_issue_date",
"confidence":1
},
{
"value":"76698073222551741143",
"description":"打印校验码",
"position":[
444,
224,
713,
224,
713,
246,
444,
246
],
"key":"vat_invoice_corrent_code_print",
"confidence":0.97642469406128
},
{
"value":"发票联",
"description":"标题发票联",
"position":[
834,
174,
1027,
174,
1027,
231,
834,
231
],
"key":"vat_invoice_headline_page_number",
"confidence":0.9528129696846
},
{
"value":"64802685",
"description":"增值税发票No号码",
"position":[
1284,
115,
1465,
115,
1465,
154,
1284,
154
],
"key":"vat_invoice_haoma_large_size",
"confidence":0.99693238735199
},
{
"value":"3100171320",
"description":"右侧打印发票代码",
"position":[
1522,
135,
1652,
135,
1652,
155,
1522,
155
],
"key":"vat_invoice_daima_right_side",
"confidence":0.98691093921661
},
{
"value":"64802685",
"description":"右侧打印发票号码",
"position":[
1504,
166,
1649,
166,
1649,
190,
1504,
190
],
"key":"vat_invoice_haoma_right_side",
"confidence":0.97550439834595
},
{
"value":"2017年06月06日",
"description":"右侧打印开票日期",
"position":[
1429,
206,
1624,
206,
1624,
232,
1429,
232
],
"key":"vat_invoice_issue_date_print",
"confidence":0.99282705783844
},
{
"value":"杭州每刻科技有限公司",
"description":"购买方名称",
"position":[
435,
267,
698,
267,
698,
294,
435,
294
],
"key":"vat_invoice_payer_name",
"confidence":0.93650209903717
}
],
"class":"nation_tax_invoice",
"type": "vat_common_invoice"
},
"code": 200,
"message": "success"
}
失败返回示例
{
"code": 40101,
"message": "App does not exist"
}
四、接入参考代码
说明
本文档提供了HTTP的接入示例代码,所有代码仅供参考,请酌情使用。
HTTP Request 示例
https://aiapi.jd.com/INTSIG/invoice
请求方式:post
Request Body: (图像的二进制数据)
五、错误码信息
1.系统级错误码
2.业务错误码
code | message | 含义 |
---|---|---|
200 | Success | 请求成功 |
500 | Server error | 服务器内部错误 |
40001 | Access server error | 验证服务器错误,请再次请求, 如果持续出现此类错误,请联系技术支持团队 |
40002 | Service temporarily unavailable | 服务暂不可用,请再次请求, 如果持续出现此类错误,请联系技术支持团队 |
40003 | Unsupported openapi method | 调用的API不存在,请检查后重新尝试 |
40004 | Open api request limit reached | 集群超限额 |
40017 | Open api daily request limit reached | 每天请求量超限额 |
40018 | Open api qps request limit reached | QPS超限额 |
40019 | Open api total request limit reached | 请求总量超限额 |
40020 | Open api daily testing limit reached. | 今日测试次数已达上限 |
40100 | Empty App key or app secret | app_key 或 app_secret 为空 |
40101 | App does not exist | 实例不存在,请检查 app_key |
40102 | Invalid app secret | 实例验证失败,请检查 app_secret |
40103 | Invalid App | 实例已失效 |
40104 | App has expired | 实例已超过有效期 |
40105 | Invalid IP source | 无效的IP来源 |
40106 | App does not match service | 实例与service不匹配 |
40107 | App has been overdrawn by 5% of the total count. Please use it after recharging. | 实例额度已透支总额度的5%,请充值后使用 |
40110 | App key or app secret invalid | app_key 或 app_secret无效 |
40200 | Internal error | 服务器内部错误 |
40201 | Not enough param | 缺少必须的参数,请检查参数是否有遗漏 |
40202 | Service not support | 请求了不支持的服务,请检查调用的url |
40300 | Empty image | 图片为空,请检查后重新尝试 |
40301 | Image format error | 上传的图片格式错误,现阶段我们支持的图片格式为:PNG、JPG、JPEG、BMP,请进行转码或更换图片 |
40302 | Image size error | 上传的图片大小错误 |
40303 | File type unsupport | 文件类型不支持 |
40400 | Recognize error | 识别错误,请再次请求 |
40401 | Image recognize error | 图像识别错误 |
40500 | Classify failed | 未能成功分类 |
40600 | Missing request body | 缺少 request body |
50001 | Time out | 超时 |
90099 | Unknown error | 未知错误 |