三单匹配-异步匹配任务提交

一、接口说明

异步提交三单匹配任务，通过 requestScene 选择业务场景。提交成功返回 data.taskId，再调用异步匹配结果查询接口获取结果。

请先选择场景，再按对应文档准备请求参数和 CSV。 各场景独立维护文件字段、业务规则与示例。

场景	用途	反馈	详细文档
normal（默认）	正常使用；按 settings 匹配	仅 enableFeedback=true 时建立反馈任务	normal 正常匹配场景
init	初始化匹配；按 settings 匹配	不建立反馈任务，传 true 也按 false 执行	init 初始化匹配场景
refine（规划中）	已确定整张发票的候选集合，进一步分配到发票行	不建立反馈任务；旧结果仅作参考	refine 指定候选集合精配场景

refine 尚未实现，当前为接口契约，不能据此调用。 normal、init 沿用现有对外字段与规则。

二、请求参数与场景适用范围

请求方式：POST /ai/knowledge/nlpService/item/match/push；Body：application/json。鉴权 Query 与 Header 参数见下方参数表。

字段	类型	normal	init	refine（规划中）
clientId	string	必填	必填	必填、非空
supplierId	string	必填	必填	必填、非空
targetUrl	string	必填，普通发票 CSV	必填，初始化发票 CSV	必填，单张发票 CSV，按 refine 独立规则
candidateUrl	string	必填，普通候选 CSV	必填，初始化候选 CSV	必填，本张发票选定且必须全部分配的入库单明细集合，含 is_adjustment
requestScene	string	normal，可省略	必须显式传 init	必须显式传 refine
enableFeedback	boolean	选填，默认 false	忽略	忽略
useVectorStore	boolean	选填，默认 false	忽略	忽略
settings	object	选填，按 normal 场景配置	选填，按 init 场景配置	忽略全部内容，不执行普通配置校验
previousMatchDetails	array	无需传	无需传	必填；回传旧 matchDetails，无旧结果传 []

normal、init 的 CSV 字段、必填条件、容差与匹配策略见各自场景文档，不使用 refine 的字段规则。refine 不应用普通匹配的容差、过滤及返回模式；其候选全部消耗、允许差额、调整行、旧关系复用与连线变更标识详见 refine 文档。

三、异步返回与查询

三个场景使用同一提交响应结构，成功时返回 data.taskId。使用该 ID 调用异步匹配结果查询接口，传 {"taskId":"..."} 查询，完成结果位于 data.result。提交成功表示任务已受理，不代表匹配已完成。

normal：仅启用反馈时，taskId 可作为反馈来源。

init：taskId 仅用于查询，不可作为反馈来源。

refine（规划中）：taskId 用于查询，不建立反馈任务；结果包含全部发票行和全部候选的分配，包含 isAdjustment、changeStatus 等场景字段，详见 refine 文档。

请求参数

Query 参数

Header 参数

Body 参数application/json

示例

{
    "clientId": "string",
    "supplierId": "string",
    "enableFeedback": true,
    "useVectorStore": true,
    "requestScene": "normal",
    "targetUrl": "string",
    "candidateUrl": "string",
    "settings": {
        "priceTolerance": 0,
        "priceToleranceType": "string",
        "quantityTolerance": 0,
        "quantityToleranceType": "string",
        "amountTolerance": 0,
        "amountToleranceType": "string",
        "matchMode": "string",
        "matchRelation": "string",
        "returnMode": "string",
        "priorityStrategy": "string",
        "unitMode": "string",
        "allowSignMismatch": true
    },
    "previousMatchDetails": [
        {
            "targetItemId": "string",
            "candidateItem": [
                {
                    "candidateDocId": "string",
                    "candidateItemId": "string",
                    "allocatedAmount": 0,
                    "allocatedQuantity": 0
                }
            ]
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Bodyapplication/json

示例

{
    "errcode": "0000",
    "description": "Success",
    "data": {
        "taskId": "8a99a18a3ca66a8fb332c66130b09f44"
    },
    "traceId": "f83d76a391634567853ebe1105a26adf"
}

一、接口说明#

二、请求参数与场景适用范围#

三、异步返回与查询#

请求参数

请求示例代码

返回响应

一、接口说明

二、请求参数与场景适用范围

三、异步返回与查询