# 财务票据混贴分类检测

版本 V1.0.0

# 1. 接口定义

# 1.1 接口

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

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

# 1.2 描述

财务票据混贴识别服务支持多张、多类票据一次混合分类，系统自动完成多种票据的切割和分类，适用于财务报销，发票验证，个人账单管理等多种场景。

# 1.3 HTTP请求格式

# 1.3.1 请求参数

属性	参数名称	必选	类型	可选值	默认值	参数描述
固定列	image	和url二选一	String	无	无	图像base64编码后的字符串，图像需是JPG、PNG、BMP其中之一的格式
	url	和image二选一	String	无	无	图片url地址，url与image两者填一个即可，同时赋值时，则以url指定的图像作为输入
	session_id	否	String	无	无	用户自定义的唯一会话id
可变	ret_image	否	String	crop\none	crop	是否返回各票据的单张切图，默认返回， "crop"：返回混贴票据的单张切图 "none"：不返回混贴票据的单张切图
	classify_type	否	Int32	0,1	1	0 不返回单张票据类别， 1 返回单张票据类别（默认返回票据类别）
	enable_pdf_recognize	否	Bool	false\true	true	是否开启pdf识别，默认开启
	pdf_page_index	否	Int32	[0,正无穷）	0	pdf页码，从0开始，默认为0

# 1.3.2 请求示例

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

1
2
3
4

# 1.3.3 返回参数

属性	参数	是否必然返回	类型	参数说明
固定列	errorcode	是	Int32	错误码
	errormsg	是	string	错误码消息
	session_id	否	string	相应请求的session标识符，可用于结果查询
items	angle	是	Float	图片旋转角度（角度制），文本的水平方向为0°；顺时针为正，逆时针为负
	image	是	string	返回单张图片的base64编码后的字符串
	type	是	string	识别出的图片从属的财务票据类型，type值类型对应如下： type=0，出租车票 type=1，定额发票 type=2，火车票 type=3，增值税发票 type=4，客运限额发票 type=5，机票行程单 type=6，酒店账单 type=7，购置税发票/完税证明 type=8，通用机打发票 type=9，客运发票 type=10，轮船票 type=11，增值税发票（卷票) type=12，机动车销售统一发票 type=13，过路费发票 type=14，购物小票
	itemconf	是	Float	置信度
	itemcoord	是	Object	识别出的图片在财务票据混贴图片中的位置信息，表示为(左上角x, 左上角y，宽width，高height)

# 1.3.4 返回示例

{
  "errorcode": 0,
    "errormsg": "OK",
    "items": [
        {
          "itemcoord": {
              "x": 531,
              "y": 157,
              "width": 219,
              "height": 601
          },
          "itemconf": 0.9995145797729492,
          "type": 0,
          "angle": 3.69921875，
          "image": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wB……"
        },
        {
            "itemcoord": {
                "x": 28,
                "y": 187,
                "width": 234,
                "height": 591
            },
            "itemconf": 0.9994513392448425,
            "type": 0,
            "angle": 0.0,
            "image": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wB……"
        }],
    "session_id": ""
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

# 1.3.5 接口错误码说明

错误码	错误码消息	错误码说明
-5208	OCR_SERVER_INTERN_ERROR	服务器内部错误
-1102	SDK_IMAGE_DECODE_FAILED	图片解码失败
-1400	ERROR_OCR_TEMPLATE_NOT_MATCH	模板不匹配
-9003	GLOCR_RECOG_FAILED	识别失败
-9907	OCR_ERROR_PDF_PAGE_INDEX	pdf页码超出范围

← 财务票据混贴识别发票查验 →