三单匹配-异步数据入库

一、接口描述

用于批量提交商品数据并异步写入向量库，支持 Upsert（更新或插入）语义：

当 product_name + specification_model 相同时：

已存在 → 执行更新

不存在 → 执行新增

任务提交成功后返回 taskId，通过查询接口轮询任务状态。

数据过期策略：入库物料默认 60 天后自动过期，每次 upsert 会刷新过期时间。可通过请求参数 ttlDays 覆盖单次入库的保留天数，传 -1 表示永不过期。过期物料会从向量库中自动删除，匹配时无法被召回，若出现候选物料匹配率下降，请先确认相关物料是否已过期，必要时重新入库。

⚠️ 注意事项

仅在“向量库匹配模式”下，本数据才会生效

单次请求的请求体 不超过 10MB

二、请求参数

1. 输入参数

参数名	类型	是否必填	说明
requestScene	String	否	请求场景标识。normal 代表正常使用场景（高优），init 代表初始化场景（低优）。不传默认按 normal 处理。
items	Array	是	商品数据列表
ttlDays	integer	否	物料保留天数：不传则使用服务端默认配置 60天；传 `-1` 表示不设置过期；传正整数覆盖默认值；传 `0` 或其他非法值返回参数错误

2. 单条商品数据结构（Item Object）

每个元素代表一条物料记录：

字段名	类型	是否必填	说明
client_id	string	是	租户标识
supplier_id	string	是	供应商标识
product_code	String	否	商品编码（唯一标识）
product_name	String	是	商品名称
specification_model	String	否	规格型号（可为空字符串或不传）

📌 请求示例

{
  "items": [
    {
      "client_id": "client_001",
      "supplier_id": "supplier_001",
      "product_code": "P001",
      "product_name": "螺丝",
      "specification_model": "M3*10"
    },
    {
      "client_id": "client_001",
      "supplier_id": "supplier_001",
      "product_code": "P002",
      "product_name": "螺母",
      "specification_model": ""
    }
  ]
}

三、响应参数（同步返回）

返回字段说明

参数名	类型	是否必返	说明
errcode	String	是	返回码（"0000" 表示提交成功）
description	String	是	操作信息描述
data	Object	是	返回数据
data.taskId	String	是	异步任务唯一标识
traceId	String	是	请求唯一标识（用于链路追踪）

application/json

Bodyapplication/json

示例

{
    "errcode": "0000",
    "description": "Success",
    "data": {
        "taskId": "ec6fa3c4-f1a3-43b1-bde4-d13552dee144"
    },
    "traceId": "abf23ef9bde547789193e5338b622cad"
}

一、接口描述

⚠️ 注意事项

二、请求参数

1. 输入参数

2. 单条商品数据结构（Item Object）

📌 请求示例

三、响应参数（同步返回）

请求参数

请求示例代码

返回响应

三单匹配-异步数据入库

一、接口描述#

⚠️ 注意事项#

二、请求参数#

1. 输入参数#

2. 单条商品数据结构（Item Object）#

📌 请求示例#

三、响应参数（同步返回）#

请求参数

请求示例代码

返回响应

一、接口描述

⚠️ 注意事项

二、请求参数

1. 输入参数

2. 单条商品数据结构（Item Object）

📌 请求示例

三、响应参数（同步返回）