三单匹配-异步结果查询

一、接口描述

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

二、路径参数

1. taskId： 任务的唯一标识符，用于查询该任务的匹配结果。

三、主要输出参数

1.data: 输出结果。

taskId：任务唯一标识。

status：任务状态。

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

PROCESSING：任务还在处理中。

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

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。

请求参数

Path 参数

taskId

string

必需

任务的唯一标识符，用于查询该任务的匹配结果。

示例值:

8a99a18a3ca66a8fb332c66130b09f44

Query 参数

access_token

string

必需

授权token,由前置脚本生成，失效的调用一下获取授权接口即可

示例值:

Header 参数

client-platform

string

必需

示例值:

common

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

接口返回的完整数据结构

errcode

string

必需

接口返回的错误码，0000代表正常返回成功

description

string

接口返回描述

必需

data

object

必需

数据部分，包含匹配的入库单信息和明细

taskId

string

任务的唯一标识符

必需

status

string

必需

任务的状态，包含COMPLETED，PROCESSING，FAILED

result

object

可选

匹配结果，状态为COMPLETED的情况下，会返回

error

string

可选

错误描述，状态为FAILED的情况下，会返回

traceId

string

必需

请求唯一标识，用于追踪和关联一次请求的整个生命周期

示例

成功示例-任务完成状态成功示例-处理中状态成功示例-失败状态

{
    "errcode": "0000",
    "description": "Success",
    "data": {
        "taskId": "c5a2e4ac8db8c605e5e150f40ff2a643",
        "status": "COMPLETED",
        "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"
}

一、接口描述#

二、路径参数#

三、主要输出参数#

请求参数

示例代码

返回响应

一、接口描述

二、路径参数

三、主要输出参数