查询异步识别票据数据

接口说明

  • url: /common/invoices/result
  • method: POST
  • 数据格式: JSON
  • 限流信息:100次每天和50次每小时
  • 多语言环境:在接口请求头中添加Key为locale,Value值为语言环境,目前支持的语言有zh_CN(中文)、en_US(英文)、ja_JP(日文)、zh_TW(繁体),请选取其中一种
  • 接口说明:票据识别任务编号查询,常与票据异步识别和票据异步识别结果查询 搭配使用。该接口返回已在系统中创建的消费记录和票据查询 VO,不返回 Loki/Thanos 原始 OCR 或查验 DTO。

请求参数

字段名称 字段类型 字段描述 是否必填 长度限制(字节)
bizId String 当前次接口同步的唯一标识 TRUE
timestamp long 当前次接口同步对应的时间戳 TRUE
data JSON 查询的参数 TRUE
data.identification_ids String[] 票据识别任务列表 TRUE
data.language String 语言 TRUE

响应参数

字段名称 字段类型 字段描述
bizId String 当前次接口同步的唯一标识
resCode Integer 响应状态,200000 代表处理成功
resMsg String 返回信息描述
data Object 票据识别结果对象
data.expenses Array 识别结果列表
data.expenses[].expense_id String 消费记录 ID
data.expenses[].receipts Array 已创建的票据列表
data.expenses[].identification_id String 票据识别任务 ID
data.expenses[].creation_date String 创建日期
data.expenses[].created_by String 票据拥有人
data.expenses[].receipts[].invoice_num String 发票号码
data.expenses[].receipts[].invoice_code String 发票代码
data.expenses[].receipts[].invoice_type String 发票类型
data.expenses[].receipts[].invoice_status String 发票识别查验状态
data.expenses[].receipts[].invoice_attachments Array 票据附件列表
data.expenses[].receipts[].invoice_attachments[].file_name String 附件文件名

请求示例

{
  "bizId" : "634899ef-d591-4829-ac18-0bcc135251ff",
  "timestamp" : 1597910515274,
  "data" : {
    "identification_ids": ["123", "456", "789"],
    "language": "zh_CN"
  }
}

响应示例

处理成功时响应

{
  "resCode" : 200000,
  "resMsg" : "票据识别结果查询成功",
  "bizId" : "c40f1bf0-e757-4a72-8863-fd6749821584",
  "data" : {
    "expenses": [
      {
        "expense_id": 123,
        "receipts": [
          {
            "invoice_num": "123",
            "invoice_code": "456",
            "invoice_type": "01",
            "invoice_attachments": [
              {
                "file_name": "abcdefg"
              },...],
            "invoice_status": "Y"
          }
        ],
        "identification_id": "34334",
        "creation_date": "2020-09-18",
        "created_by": "test"
      }]
  }
}

处理失败时响应

{
    "resCode": 500000,
    "resMsg": "票据识别结果查询失败!",
    "bizId": "d629d829-d53c-4221-8cb1-4340949f67b6"
}

results matching ""

    No results matching ""