Lingxing
切换旧版

批量查询本地产品已保存的1688配对

POST/erp/sc/routing/product/batchGetAlibabaMatch

查询本地产品已保存的1688配对,不实时请求1688。ids 与 skus 二者必填一项;ids 生效时忽略 skus,不参与校验、查询或补充。生效数组最多100项,超限返回提示,不截取,请分批查询。

接口信息

API Path请求协议请求方式
/erp/sc/routing/product/batchGetAlibabaMatchHTTPSPOST

请求参数

idsarray<any>
本地产品ID数组,与skus二者必填一项;优先于skus生效,最多100项。
skusarray<any>
本地SKU数组;ids生效时忽略本字段。生效数组最多100项。

请求示例

{
  "ids": [
    "10001"
  ]
}

请求cURL示例

curl --location 'https://openapi.lingxing.com/erp/sc/routing/product/batchGetAlibabaMatch?app_key=value&timestamp=value&sign=value' \
--header 'Authorization: Bearer <access_token>' \
--header 'Content-Type: application/json' \
--data '{"ids":["10001"]}'

返回结果

Json Object

codeinteger必填
状态码,0成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
错误信息
示例 []
request_idstring必填
请求链路ID
示例 52688b81-2398-4e60-9617-619fc2cf5b1e
response_timestring必填
响应时间
示例 2026-11-17 10:00:00
totalinteger必填
返回产品总数
示例 1
dataarray<object>必填
响应数据
隐藏子属性
product_idstring必填
本地产品ID
skustring必填
本地SKU
product_namestring必填
品名
supplier_listarray<object>必填
供应商列表
隐藏子属性
supplier_idstring必填
供应商ID
supplier_namestring必填
供应商名称
is_primaryinteger必填
首选供应商标记:0 否,1 是;缺报价关系时为null。
match_listarray<object>必填
同一SKU在此供应商下的全部配对共同参与采购。
隐藏子属性
match_idstring必填
配对记录ID
match_modeinteger必填
0普通,1高级。
offer_idstring必填
1688商品ID
spec_idstring必填
无规格或缺失时为空串。
sku_idstring必填
1688商品SKU
alibaba_supplier_namestring必填
1688供应商名称
alibaba_product_namestring必填
1688商品名称
product_urlstring必填
1688商品链接
attributesarray<object>必填
属性
隐藏子属性
attribute_idstring必填
属性ID
attribute_namestring必填
属性名称
attribute_valuestring必填
属性值
local_product_qtystring必填
本地数量原值。
alibaba_product_qtystring必填
1688数量原值。
matched_numstring必填
现有配对数量
price_infoobject必填
保存的1688价格;缺价格或无成本权限时整个对象null。
隐藏子属性
currencystring必填
货币
unitstring必填
1688销售单位,缺失为空串。
retail_pricestring必填
一件起批价,当前规格优先,商品销售级兜底。
price_rangesarray<object>必填
阶梯价格
隐藏子属性
start_quantitystring必填
1688销售单位的阶梯起订量,缺失或异常时null。
pricestring必填
保留源精度和真实0价。

返回成功示例

{
  "code": 0,
  "message": "success",
  "error_details": [],
  "request_id": "52688b81-2398-4e60-9617-619fc2cf5b1e",
  "response_time": "2026-11-17 10:00:00",
  "total": 1,
  "data": [
    {
      "product_id": "10001",
      "sku": "SKU-001",
      "product_name": "示例商品",
      "supplier_list": [
        {
          "supplier_id": "20001",
          "supplier_name": "示例供应商",
          "is_primary": 1,
          "match_list": [
            {
              "match_id": "30001",
              "match_mode": 0,
              "offer_id": "168800000001",
              "spec_id": "",
              "sku_id": "168800000002",
              "alibaba_supplier_name": "示例1688供应商",
              "alibaba_product_name": "示例商品",
              "product_url": "https://detail.1688.com/offer/168800000001.html",
              "attributes": [
                {
                  "attribute_id": "1",
                  "attribute_name": "颜色",
                  "attribute_value": "蓝色"
                }
              ],
              "local_product_qty": "1",
              "alibaba_product_qty": "1",
              "matched_num": "1",
              "price_info": {
                "currency": "CNY",
                "unit": "件",
                "retail_price": "10.00",
                "price_ranges": [
                  {
                    "start_quantity": "1",
                    "price": "10.00"
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  ]
}