轻易云
注册体验

领星ERP查询Mercado在线商品接口

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
多平台 · POST · 请求参数 23 个(必填 1) · 响应参数 44 个 · 限流令牌桶容量 1
更新日期
2026-11-21

查询Mercado在线商品

POST/basicOpen/multiplatform/mercado/list
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/multiplatform/mercado/list"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/mercado/list?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"offset\": 0,\n    \"length\": 20,\n    \"principalUids\": [10001],\n    \"storeIds\": [1, 2],\n    \"productType\": 1,\n    \"searchField\": 6,\n    \"searchSingleValue\": \"商品A\"\n}'",
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
    "response_time": "2026-07-14 12:00:00",
    "data": {
      "count": 35,
      "list": [
        {
          "id": 1,
          "productUniqueId": 10001,
          "principalUids": [
            10001
          ],
          "principalName": "张三",
          "performanceUid": 10002,
          "performanceName": "李四",
          "variantUniqueId": 20001,
          "rowType": "parent",
          "itemId": "ITEM001",
          "variationId": "VAR001",
          "familyName": "Family-A",
          "mskuId": "MSKU001",
          "msku": "msku-test",
          "title": "示例商品标题",
          "status": "active",
          "statusName": "在售",
          "siteName": "Brazil",
          "siteCode": "MLB",
          "currency": "BRL",
          "currencyIcon": "R$",
          "imgUrl": "https://img.example.com/1.jpg",
          "variantAttribute": "红色/XL",
          "available": 50,
          "price": 199.9,
          "logisticType": "fulfillment",
          "productType": "normal",
          "url": "https://www.mercadolivre.com/item001",
          "createTime": "2026-01-01 10:00:00",
          "updateTime": "2026-01-05 10:00:00",
          "storeId": 1,
          "storeName": "我的店铺",
          "pname": "商品A",
          "sku": "SKU001",
          "pid": 1001,
          "children": []
        }
      ]
    },
    "total": 35
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1principalUids负责人用户ID列表array<any>—可选负责人用户ID列表;传[-1]表示仅查询未分配负责人,-1不能与其他UID混传
2offset偏移量integer—可选偏移量,默认0
3length每页条数integer—可选每页条数,默认20,最大200
4storeIds店铺ID列表array<any>—可选店铺ID列表
5pairingStatus配对状态integer—可选配对状态 0=未配对 1=已配对
6searchSingleValue模糊搜索值string—可选模糊搜索值
7searchValues精确搜索值列表array<any>—可选精确搜索值列表
8searchField搜索字段integer—可选搜索字段: 1=商品ID 2=标题 3=变体ID 4=父体 5=Family Name 6=MSKU 7=SKU 8=品名
9sortType排序方式string—可选排序方式:asc/desc
10sortField排序字段string—可选排序字段
11categoryIds分类ID列表array<any>—可选分类ID列表
12brandIds品牌ID列表array<any>—可选品牌ID列表
13productType商品类型integer—必填商品类型
14siteIdList站点ID列表array<any>—可选站点ID列表
15statusList状态列表array<any>—可选状态列表
16logisticTypeList物流类型列表array<any>—可选物流类型列表
17timeType时间筛选类型integer—可选时间筛选类型
18start开始时间(yyyy-MM-dd)string—可选开始时间(yyyy-MM-dd)
19end结束时间(yyyy-MM-dd)string—可选结束时间(yyyy-MM-dd)
20price金额筛选值number—可选金额筛选值
21priceCondition金额筛选条件integer—可选金额筛选条件: 1=大于 2=小于
22quantity库存数筛选值integer—可选库存数筛选值
23quantityCondition库存筛选条件integer—可选库存筛选条件: 1=大于 2=小于

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0:成功
2message消息提示stringsuccess必填消息提示
3error_details数据校验失败时的错误详情array<any>—必填数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583必填请求链路id
5response_time响应时间string2026-07-14 12:00:00必填响应时间
6data响应数据object—必填响应数据
6.1count总数integer35必填总数
6.2list列表数据array<object>—必填列表数据
6.2.1principalUids负责人用户ID列表array<any>[10001]可选负责人用户ID列表
6.2.2principalName负责人名称string张三可选负责人名称
6.2.3performanceUid业绩归属人用户IDinteger10002可选业绩归属人用户ID
6.2.4performanceName业绩归属人名称string李四可选业绩归属人名称
6.2.5ididinteger1必填ID
6.2.6productUniqueId商品唯一IDinteger10001必填商品唯一ID
6.2.7variantUniqueId变体唯一IDinteger20001必填变体唯一ID
6.2.8rowType行类型stringparent必填行类型
6.2.9itemId商品IDstringITEM001必填商品ID
6.2.10variationId变体IDstringVAR001必填变体ID
6.2.11familyNameFamily NamestringFamily-A必填Family Name
6.2.12mskuIdMSKU IDstringMSKU001必填MSKU ID
6.2.13mskumskustringmsku-test必填MSKU
6.2.14title标题string示例商品标题必填标题
6.2.15status状态stringactive必填状态
6.2.16statusName状态名称string在售必填状态名称
6.2.17siteName站点名称stringBrazil必填站点名称
6.2.18siteCode站点编码stringMLB必填站点编码
6.2.19currency币种stringBRL必填币种
6.2.20currencyIcon币种符号stringR$必填币种符号
6.2.21imgUrl图片URLstringhttps://img.example.com/1.jpg必填图片URL
6.2.22variantAttribute变体属性string红色/XL必填变体属性
6.2.23available可用库存integer50必填可用库存
6.2.24price价格number199.9必填价格
6.2.25logisticType物流类型stringfulfillment必填物流类型
6.2.26productType商品类型stringnormal必填商品类型
6.2.27url商品链接stringhttps://www.mercadolivre.com/item001必填商品链接
6.2.28createTime创建时间string2026-01-01 10:00:00必填创建时间
6.2.29updateTime更新时间string2026-01-05 10:00:00必填更新时间
6.2.30storeId店铺IDinteger1必填店铺ID
6.2.31storeName店铺名称string我的店铺必填店铺名称
6.2.32pname品名string商品A必填品名
6.2.33skuskustringSKU001必填SKU
6.2.34pid本地产品IDinteger1001必填本地产品ID
6.2.35children子变体列表array<any>—必填子变体列表
7total总数integer35必填总数

领星ERP的接口:查询Mercado在线商品(/basicOpen/multiplatform/mercado/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。