三单匹配-异步结果查询

一、接口描述

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

二、请求参数

请求体（JSON）字段：

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

三、主要输出参数

1.data: 输出结果。

taskId：任务唯一标识。

status：任务状态。

COMPLETED：任务已完成。可以直接获取result字段的匹配结果。

PROCESSING：任务还在处理中。

FAILED：任务失败。可以查看error字段的错误原因。

taskTraceId：该任务执行时的trace_id,用于追踪该任务的执行过程

result: 三单匹配结果，只有 status = COMPLETED 才会返回。

error: 任务错误原因，只有 status = FAILED 才会返回。

result参数详解：
包含匹配的单据信息和每一行发票明细的匹配情况。如果没有匹配到单据，matchDocIds/matchDetails 返回空列表；如果匹配到单据，则返回发票与单据的匹配信息。匹配信息包含以下字段：

matchDocIds: 该发票匹配的单据 IDs。若无匹配，返回空列表；若有匹配，返回一个包含所有匹配单据 ID 的数组。单据 ID 来源于单据文件中的 doc_id 字段。

matchDetails: 发票与单据的明细匹配信息列表。每个明细项包含以下字段：

targetItemId: 发票的明细 ID，来源于发票文件中的 item_id 字段。

candidateItem: 候选单据明细信息列表。每个候选项是一个对象，包含：

candidateDocId: 该明细所属的单据 ID。(doc_id)

candidateItemId: 该明细的 ID。

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

成功示例-任务完成状态成功示例-任务处理中状态成功示例-任务失败状态失败示例-查询不存在的taskId

{
    "errcode": "0000",
    "description": "Success",
    "data": {
        "taskId": "c5a2e4ac8db8c605e5e150f40ff2a643",
        "status": "COMPLETED",
        "taskTraceId": "d4e5e33e57bf0237",
        "result": {
            "matchDocIds": [
                "100134098",
                "100128678",
                "100134926",
                "100134921",
                "100133644"
            ],
            "matchDetails": [
                {
                    "targetItemId": "24322000000227078655_1",
                    "candidateItem": [
                        {
                            "candidateDocId": "100134098",
                            "candidateItemId": "100134098_1"
                        }
                    ]
                },
                {
                    "targetItemId": "24322000000227078655_2",
                    "candidateItem": [
                        {
                            "candidateDocId": "100128678",
                            "candidateItemId": "100128678_1"
                        }
                    ]
                },
                {
                    "targetItemId": "24322000000227078655_3",
                    "candidateItem": [
                        {
                            "candidateDocId": "100134921",
                            "candidateItemId": "100134921_1"
                        }
                    ]
                },
                {
                    "targetItemId": "24322000000227078655_4",
                    "candidateItem": [
                        {
                            "candidateDocId": "100133644",
                            "candidateItemId": "100133644_1"
                        }
                    ]
                },
                {
                    "targetItemId": "24322000000227078655_5",
                    "candidateItem": [
                        {
                            "candidateDocId": "100134926",
                            "candidateItemId": "100134926_1"
                        }
                    ]
                }
            ]
        }
    },
    "traceId": "21c996b57d834de9bfc10f7b8312f530"
}

一、接口描述#

二、请求参数#

三、主要输出参数#

请求参数

示例代码

返回响应

一、接口描述

二、请求参数

三、主要输出参数