票据识别

  • url：/common/invoices/recognize
  • method：POST
  • 数据格式：JSON

说明

  • 异步批量票据识别接口。
  • 可以用票据识别结果轮询接口查看本批次票据的完成情况。
  • 接口支持普通票据识别、海关票识别。
  • 接口单次调用最多传入100份附件url。
  • 接口处理发票文件验签，请配置好相关文件验签配置。
  • 接口处理税额相关计算，请配置好相关税额配置。
  • 接口会进行发票抬头校验，请配置好相关发票抬头校验配置。
  • 接口会检查是否重复导入，对于重复导入票据会记录查验失败和错误信息invoice_message。

请求参数

字段名称 字段类型 字段描述 是否必填
bizId String 业务唯一识别码 true
data Object 本次识别参数 true
data.user_name String 用户名 用户名和员工号选填一个
data.employee_number String 员工号 用户名和员工号选填一个
data.language String 语言（默认zh_CN） false
data.file_name String[] 附件url（不能超过一百个） true
data.ocr_type String 具体请看识别类型 false
data.purchase_invoice String 采购发票（为Y时代表该票据放入采购发票池, 默认N） false

响应参数

字段名称 字段类型 字段描述
bizId String 业务唯一识别码（使用入参bizId返回）
resCode Integer 响应状态 （200000代表处理成功）
resMsg String 错误信息 （处理失败时会返回错误信息）
data Object 本次识别返回参数
data.identification_id String 本次批量识别的标识id

请求&响应结构示例

通用识别请求示例

{
  "bizId": "33f03b40-abcb-4cc8-b1c0-358c022abb74",
  "data": {
    "employee_number": "yrhch6@163.com",
    "file_name": [
      "3bbe052a-94b8-403a-a911-c6c23f17c0f7.pdf",
      "31d7ab96-12f9-413f-90e1-5bfd0d37fb45.png"
    ]
  }
}

海关票识别请求示例

{
  "bizId": "33f03b40-abcb-4cc8-b1c0-358c022abb74",
  "data": {
    "employee_number": "yrhch6@163.com",
    "file_name": [
      "3bbe052a-94b8-403a-a911-c6c23f17c0f7.pdf",
      "31d7ab96-12f9-413f-90e1-5bfd0d37fb45.png"
    ],
    "ocr_type": "customs"
  }
}

处理成功时响应示例

{
  "bizId": "33f03b40-abcb-4cc8-b1c0-358c022abb74",
  "resCode": 200000,
  "resMsg": "导入票据成功！",
  "data": {
    "identification_id": "69f0022e-ef21-4ba3-b60b-0c031bd2babf"
  }
}

处理失败时响应示例

需要注意的是，不同的失败情况会提供不同的resCode与resMsg

{
  "bizId": "33f03b40-abcb-4cc8-b1c0-358c022abb74",
  "resCode": 500000, 
  "resMsg": "导入票据失败！"
}

其它

识别类型

类型 描述
common 通用票据识别（默认的识别方式）
customs 海关票识别（弃用，已经迁移到通用票据识别）

results matching ""

    No results matching ""