# 完税证明
版本 V1.0.0
# 1. 接口定义
# 1.1 接口
URL = http://ip:port/hex/ocrapi/invoiceocr_taxpayment
其中 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
2
3
4
2
3
4
# 1.3.3 返回参数
| 参数 | 是否必然返回 | 类型 | 参数说明 | 
|---|---|---|---|
| errorcode | 是 | Int32 | 错误码 | 
| errormsg | 是 | string | 错误码消息 | 
| session_id | 否 | string | 相应请求的session标识符,可用于结果查询 | 
| 可 变 | angle | 是 | Float | 
| item | 是 | string | 识别出的字段名称(关键字) | 
| itemstring | 是 | string | 识别出的字段名称对应的值,也就是字段item对应的字符串结果 | 
| itemconf | 是 | Float | 置信度 | 
| itemcoord | 是 | Object | 文本行在旋转纠正之后的图像中的像素坐标,表示为(左上角x, 左上角y,宽width,高height) | 
# 1.3.4 返回示例
{
  "session_id": "",
  "angle": 0,
  "errorcode": 0,
  "errormsg": "OK",
  "items": [
    {
      "item": "纳税人名称",
      "itemcoord": {
        "x": 632,
        "y": 184,
        "width": 26,
        "height": 16
      },
      "itemconf": 0.9999209046363831,
      "itemstring": "李明"
    }
  ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
# 1.3.5 接口错误码说明
| 错误码 | 错误码消息 | 错误码说明 | 
|---|---|---|
| -5208 | OCR_SERVER_INTERN_ERROR | 服务器内部错误 | 
| -1102 | SDK_IMAGE_DECODE_FAILED | 图片解码失败 | 
| -1400 | ERROR_OCR_TEMPLATE_NOT_MATCH | 模板不匹配 | 
| -9003 | GLOCR_RECOG_FAILED | 识别失败 | 
