发票云（智能特性）
旗舰版标准版智能特性生态版
旗舰版标准版智能特性生态版
  1. 三单匹配
  • 整体介绍
  • 开发指南
  • 授权
    • token获取
      POST
  • 智能特性
    • 文档信息识别
      • 国际发票识别
      • 国际发票识别（明细）
      • 文档信息识别（反馈）
      • 银行回单识别
    • 三单匹配
      • 三单匹配-normal 正常匹配场景
      • 三单匹配-init 初始化匹配场景
      • 三单匹配-refine 指定候选集合精配场景（规划中）
      • 三单匹配-同步接口
        POST
      • 三单匹配-异步匹配任务提交
        POST
      • 三单匹配-异步匹配结果查询
        POST
      • 三单匹配-异步数据入库
        POST
      • 三单匹配-异步数据入库结果查询
        POST
      • 三单匹配-异步标注数据导入
        POST
      • 三单匹配-异步标注数据导入结果查询
        POST
      • 三单匹配-异步训练接口
        POST
      • 三单匹配-异步训练结果查询
        POST
      • 三单匹配-异步模型一键部署接口
        POST
      • 三单匹配-异步模型一键部署查询接口
        POST
    • 统一反馈
      • 三单匹配反馈详细说明
      • 算法服务统一反馈接口
    • 文档分类（区分发票、附件）
      POST
    • 智能赋码税收分类编码识别
      POST
  • 文档中心
    • 外部文件上传接口
      POST
  • 国际发票
  • 数据模型
    • 示例数据模型
      • Pet
      • Category
      • Tag
  1. 三单匹配

三单匹配-异步匹配结果查询

POST
/ai/knowledge/nlpService/item/match/query

一、接口描述#

三单匹配异步接口的结果查询接口

二、请求参数#

请求体（JSON）字段：
taskId（string，必填）：任务的唯一标识符，用于查询该任务的匹配结果。

三、主要输出参数#

1.data: 输出结果。
taskId： 任务唯一标识。
status：任务状态。
COMPLETED：任务已完成。可以直接获取result字段的匹配结果。
PROCESSING：任务还在处理中。
FAILED：任务失败。可以查看error字段的错误原因。
taskTraceId：该任务执行时的trace_id,用于追踪该任务的执行过程
result: 三单匹配结果，只有 status = COMPLETED 才会返回。
error: 任务错误原因，只有 status = FAILED 才会返回。
normal / init 的 result 参数详解：
包含匹配的单据信息和每一行发票明细的匹配情况。如果没有匹配到单据，matchDocIds/matchDetails 返回空列表；如果匹配到单据，则返回发票与单据的匹配信息。匹配信息包含以下字段：
matchDocIds: 该发票匹配的单据 IDs。若无匹配，返回空列表；若有匹配，返回一个包含所有匹配单据 ID 的数组。单据 ID 来源于单据文件中的 doc_id 字段。
matchDetails: 发票与单据的明细匹配信息列表。每个明细项包含以下字段：
targetItemId: 发票的明细 ID，来源于发票文件中的 item_id 字段。
candidateItem: 候选单据明细信息列表。每个候选项是一个对象，包含：
candidateDocId: 该明细所属的单据 ID。(doc_id)
candidateItemId: 该明细的 ID。
score: 该入库单明细商品和当前的发票明细商品的匹配置信度，取值 [0, 1]，越大越可能是正确匹配。（不同模型分值可能都不一样，仅供参考）
allocatedAmount: 该入库单明细被分配到当前发票明细的金额。明细金额缺失时是 null
allocatedQuantity: 该入库单明细被分配到当前发票明细的数量。明细数量缺失时是 null

四、按提交场景理解结果#

查询请求仍只需 taskId，不需要再次传 requestScene。任务状态与错误位置沿用上述规则，结果语义以提交时选择的场景为准。
提交场景result 规则详细文档
normal沿用上述普通匹配结果；按 settings 返回匹配结果normal 场景
init沿用上述普通匹配结果；不建立反馈任务init 场景
refine（规划中，尚未实现）成功时包含全部发票行和全部候选分配；不要求配平，不返回未覆盖的部分结果冒充成功refine 场景及完整返回示例
refine 的 data.result.matchDetails[].candidateItem[] 除候选 ID、分配金额和数量外，还包含 isAdjustment（是否调整行）与 changeStatus（UNCHANGED / MODIFIED / ADDED）。本场景不要求返回 score；分配维度缺失时为 null，数量使用候选原生单位。普通匹配的“无匹配返回空列表”不适用于 refine 的成功结果。精确字段及变更比较规则见 refine 场景文档。

请求参数

Query 参数

Header 参数

Body 参数application/json

示例
{
    "taskId": "string"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --globoff '/ai/knowledge/nlpService/item/match/query?access_token={{access_token}}' \
--header 'client-platform: common' \
--header 'Content-Type: application/json' \
--data '{
    "taskId": "string"
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "errcode": "0000",
    "description": "Success",
    "data": {
        "taskId": "c5a2e4ac8db8c605e5e150f40ff2a643",
        "status": "COMPLETED",
        "taskTraceId": "d4e5e33e57bf0237",
        "result": {
            "matchDocIds": [
                "100134098"
            ],
            "matchDetails": [
                {
                    "targetItemId": "24322000000227078655_1",
                    "candidateItem": [
                        {
                            "candidateDocId": "100134098",
                            "candidateItemId": "100134098_1",
                            "score": 0.8712,
                            "allocatedAmount": 128.50,
                            "allocatedQuantity": 10.0
                        }
                    ]
                }
            ]
        }
    },
    "traceId": "21c996b57d834de9bfc10f7b8312f530"
}
修改于 2026-10-15 03:35:45
上一页
三单匹配-异步匹配任务提交
下一页
三单匹配-异步数据入库
Built with