/ocr/vat_invoice

• 1.接口描述
• 2.请求参数
• 3.返回参数
• 4.错误码
• 5.输入示例

1.接口描述

该 API 用于对增值税发票图片进行OCR识别，并提取关键信息。

• 图片要求：
  1. 格式为 JPG(JPEG)，PNG
  2. 宽和高大于 15px，小于等于 6000px
  3. 小于等于 5 MB

请求方式

POST

请求 URL

http://cloudapi.deepfinch.com/ocr/vat_invoice

调试工具

Debugging Tool

2.请求参数

2.1 请求头域

2.2 请求体

请求参数 file与url 必须选择其中的一个。

url 中含有特殊字符，若将 URL 放入 Query String 中则需要对这些字符进行转义，所有中文和特殊字符必需以UTF-8编码转义。
目前支持 http/https 协议的网络地址。下载限时 5s，超时后仍未下载完成则属于失败。
参数 file 需把图片文件的内容以 multipart/form-data 的形式放到 POST 消息体中。

3.返回参数

result信息

其中commodities的字段列表：

其中medical_expands的字段列表：

其中payments_info的字段列表

其中cost_categories的字段列表

其中cost_detail_list的字段列表

其中payments_info中name的取值字段列表

以下字段如票面中不包含或未提取到,不做输出

以上字段不同地区票面打印内容不一致,我方将含义一致的词进行了统一化处理,不同增值税发票相同含义词均按以下词表中的词固定输出,如需对应的词库请联系商务索取

返回结果示例

{
  "request_id": "TID70f62bf2c0a24e758ec3578b82725f8f",
  "status": "OK",
  "result": {
    "invoice_no": "00362801",
    "invoice_code": "3200153160",
    "seller_name": "江苏省常州地方税务局第一税务分局",
    "seller_bank": "凭证",
    "checker": "李四",
    "total_amount": "19417.48",
    "invoice_date": "2016年04月26日",
    "purchaser_name": "北京畅联电子有限公司",
    "purchaser_bank": "江南农商行1234567890123",
    "remarks": "开发区雨虹电子有限公司。代开企业税号39999",
    "password": "/78>/01686<+29654/57951<>9+80>54209<6<5*>7>7<87/0/--88>>33><米10+39<7<9*>6>7<5+80/><284<-65774>56485770/<826",
    "seller_address": "宁波市海南略24号甲5866666",
    "purchaser_address": "北京市海淀区绕灌里1号623499999",
    "purchaser_register_num": "110101259999999",
    "payee": "张三",
    "note_drawer": "王五",
    "amount_in_words": "万圆整",
    "amount_in_figures": "20000.00",
    "total_tax": "582.52",
    "invoice_type": "专用发票",
    "seller_register_num": "320400099999",
    "commodities": [
      {
        "name": "商品房",
        "spec": "",
        "price": "19417.475728",
        "unit": "",
        "num": "1",
        "tax": "582.52",
        "amount": "19417.48",
        "tax_rate": "3%"
      }
    ],
    "medical_expands": {
      "patient_name": "深智",
      "note_no": "711196782",
      "note_code": "021111100104",
      "check_code": "0279911113719152212",
      "billing_date": "2024-04-26",
      "total_cost": 216.0,
      "hospital_name": "自营医院有限公司",
      "treatment_date": "2024-04-26",
      "payments_info": [
        {
          "name": "个人现金支付",
          "cost": 216.0
        }
      ],
      "start_hospital_date": null,
      "end_hospital_date": null,
      "cost_categories": [
        {
          "name": "医疗服务",
          "cost": 216.0
        }
      ],
      "cost_detail_list": [
        {
          "ocr_name": "X线计算机体层(CT)螺旋扫描（4-64层，不含64层）",
          "class": "医疗服务",
          "amount": 1.0,
          "cost": 216.0
        }
      ]
    }
  }
}

4.错误码

备注: 以上40X系列错误描述请参考reason字段

输出样例

{
  "status": "UNAUTHORIZED",
  "reason": "authentication failed",
  "request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e"
}

5.输入示例