增值税发票

版本 V1.0.0

1. 接口定义

1.1 接口

URL = http://ip:port/hex/ocrapi/invoiceocr

其中 ip 为部署机器的 ip 地址，port 为对应服务器的端口

1.2 描述

增值税发票 OCR 基于业界领先的深度学习技术，支持增值税专用发票、增值税普通发票、增值税电子发票全字段内容检测识别功能，包括发票号码、发票代码、合计金额、合计税额等字段，可以应用于财务报销、账单核对等各种需要提取增值税发票信息的场景

1.3 HTTP请求格式

1.3.1 请求参数

参数名称	必选	类型	参数描述
image	和url二选一	String	图像base64编码后的字符串，图像需是JPG、PNG、BMP其中之一的格式
url	和image二选一	String	图片url地址，url与image两者填一个即可，同时赋值时，则以url指定的图像作为输入
session_id	否	String	用户自定义的唯一会话id

1.3.2 请求示例

{
  "image": 填写Base64编码后的图片数据,
  "session_id": 填写对应的session_id
}

1.3.3 返回参数

参数	是否必然返回	类型	参数说明
errorcode	是	Int32	错误码
errormsg	是	string	错误码消息
session_id	否	string	相应请求的session标识符，可用于结果查询
angle	是	Float	图片旋转角度（角度制），文本的水平方向为0°；顺时针为正，逆时针为负
item	是	string	识别出的字段名称（关键字）
itemstring	是	string	识别出的字段名称对应的值，也就是字段item对应的字符串结果
itemconf	是	Float	置信度
itemcoord	是	Object	文本行在旋转纠正之后的图像中的像素坐标，表示为（左上角x, 左上角y，宽width，高height）
col	是	Int32	字段属于第几列，用于相同字段的排版(默认值为-1，表示无列排版)
row	是	Int32	字段属于第几行，用于相同字段的排版(默认值为-1，表示无列排版)

1.3.4 返回示例

{
  "session_id": "",
  "angle": 0,
  "errormsg": "OK",
  "errorcode": 0,
  "items": [
    {
      "itemstring": "上海致宇信息技术有限公司",
      "item": "销售方名称",
      "itemconf": 0.9633997678756714,
      "itemcoord": {
        "y": 310,
        "x": 92,
        "height": 13,
        "width": 115
      },
      "col": -1,
      "row": -1
    }
  ]
}

1.3.5 接口错误码说明

错误码	错误码消息	错误码说明
-5208	OCR_SERVER_INTERN_ERROR	服务器内部错误，初始化失败
-1102	SDK_IMAGE_DECODE_FAILED	图片解码失败
-1400	ERROR_OCR_TEMPLATE_NOT_MATCH	模板不匹配
-9003	GLOCR_RECOG_FAILED	识别失败