三单匹配-异步数据入库

一、接口描述

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

当 client_id + supplier_id + product_code + product_name + specification_model 相同时：

已存在 → 执行更新

不存在 → 执行新增

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

⚠️ 注意事项

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

单次请求最多支持 500 条数据

二、请求参数

1. 输入参数

参数名	类型	是否必填	说明
requestScene	String	否	请求场景标识。normal 代表正常使用场景（高优），init 代表初始化场景（低优）。不传默认按 normal 处理。
items	Array	是	商品数据列表，最多 500 条

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

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

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

📌 请求示例

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

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

返回字段说明

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

请求参数

Query 参数

Header 参数

Body 参数application/json

示例

{
    "requestScene": "string",
    "items": [
        {
            "client_id": "string",
            "supplier_id": "string",
            "product_code": "string",
            "product_name": "string",
            "specification_model": "string"
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Bodyapplication/json

示例

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

一、接口描述#

⚠️ 注意事项#

二、请求参数#

1. 输入参数#

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

📌 请求示例#

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