增值税发票

一、接口描述

1. 功能描述

基于深度学习技术的增值税发票ocr,识别字段包括:密码区、校验码、打印校验码、代开、发票代码 、打印发票代码 、右侧打印发票代码、开票人、增值税发票No号码、发票号码等字段

2. 接口数据要求:

  1. 图片格式:base64编码

  2. 图片类型: jpg/jpeg/png/bmp

  3. 图片大小: 小于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 未知错误
Copyright © JD AI Platform all right reserved,powered by GitbookFile Modify: 2021-05-21 22:10:38

results matching ""

    No results matching ""