国际发票异步识别（新版）

根据当前 doc-ai 代码编写。对外通过 Query 参数 access_token 传递令牌。默认网关模式由网关鉴权并注入 client_id（兼容 client-id）；此模式身份取请求头，表单或 JSON 中的 clientId 不能替代网关注入身份。直连模式由服务端校验 access_token，客户端归属以令牌为准。

该处理器成功与业务失败均返回 HTTP 200，以 errcode 判断调用结果；legacyErrcode 为兼容旧码的辅助排查字段。

上传文件后返回 taskId，由后台排队处理，再调用 POST /doc-ai/ai/knowledge/nlpService/tasks/query 获取结果。提交成功仅代表任务受理，不代表识别完成。响应没有 traceId 和 docPages。

file 支持 PDF、PNG、JPG、JPEG、XLSX，默认上限 20 MB，实际以部署 MAX_UPLOAD_SIZE_MB 为准；空文件、格式异常、内容损坏或存储失败会在受理阶段拒绝。templateId 必须是当前租户可用的数字模板 ID，国家由该模板对应 API 配置决定。调用需要具备识别权益。

fileHash 省略时由服务端计算上传原件 SHA-256。即使 OCR 缓存命中，本次任务仍会入队并执行当前查验与响应组装。callbackUrl 当前只存储，不触发回调，请使用任务查询接口轮询。language、cutImage 等旧参数未在此入口读取，不作为有效入参。

errcode	说明	legacyErrcode
0000	提交成功	0000
A0301	鉴权失败、模板不存在/无权/不可用、识别权益不足或不可用	4004
A0410	缺少文件或文件为空	4008
A0700	表单读取、文件类型/大小/内容校验、文件存储失败	空字符串
1999	队列已满、当前客户端排队数超限或创建任务失败	5000

任务处理阶段失败通过查询结果的 status=FAILED 和 errorMessage 表达，不应把查询接口本身的 errcode=0000 当作任务识别成功。

提交成功（示意数据）

{
  "errcode": "0000",
  "description": "成功",
  "data": {
    "taskId": "11111111-1111-4111-8111-111111111111"
  },
  "legacyErrcode": "0000"
}

提交失败：缺少文件（示意数据）

{
  "errcode": "A0410",
  "description": "The file is required.",
  "data": null,
  "legacyErrcode": "4008"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Bodyapplication/json

示例

{
    "errcode": "0000",
    "description": "成功",
    "data": {
        "taskId": "11111111-1111-4111-8111-111111111111"
    },
    "legacyErrcode": "0000"
}

提交成功（示意数据）

提交失败：缺少文件（示意数据）

请求参数

请求示例代码

返回响应

国际发票异步识别（新版）

提交成功（示意数据）#

提交失败：缺少文件（示意数据）#

请求参数

请求示例代码

返回响应

提交成功（示意数据）

提交失败：缺少文件（示意数据）