轻易云
注册体验

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

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

查询Shopify在线商品

POST/basicOpen/multiplatform/shopify/variantList
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/multiplatform/shopify/variantList"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/shopify/variantList?access_token=value&sign=value&timestamp=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"principalUids\": [10001,10002],\n    \"store_ids\": [\"value\"],\n    \"status\": [\"value\"],\n    \"inventory_policy\": [\"value\"],\n    \"offset\": value,\n    \"length\": value,\n    \"search_field\": value,\n    \"search_single_value\": \"value\",\n    \"quantity\": \"value\",\n    \"quantity_condition\": value,\n    \"price\": \"value\",\n    \"price_condition\": value,\n    \"listing_time_field\": value,\n    \"listing_start_time\": \"value\",\n    \"listing_end_time\": \"value\"\n}'",
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583.148.17261287335766689",
    "response_time": "2024-09-12 16:12:14",
    "data": {
      "count": 1,
      "list": [
        {
          "weight": "2",
          "item_id": "6768632430804",
          "item_url": "",
          "product_unique_id": "9012162617856",
          "variant_unique_id": "9019162671616",
          "company_id": "9011572879872",
          "parent_picture_url": "",
          "picture_url": "",
          "parent_msku": null,
          "msku": "B0106008",
          "parent_attribute": "SHIP TO/Color",
          "attribute": "EU / Blue",
          "title": "ERYONE PETG Filament, 1.75mm ±0.03mm Filament for 3D Printer, 1KG(2.2LBS)/ Spool",
          "local_sku": "test061302sku",
          "pid": null,
          "local_name": "test061302pm",
          "store_id": "110000000018002001",
          "store_name": "shopify测试店铺",
          "price": "27.99",
          "quantity": "17",
          "currency_icon": "¥",
          "has_variant": false,
          "listing_start_time": "2021-09-10 15:40:51",
          "listing_end_time": "2022-04-12 11:46:56",
          "status": 1,
          "status_name": "active",
          "inventory_policy": 2,
          "inventory_policy_name": "缺货停止销售",
          "type_id": "901235959162748928",
          "type_name": "PETG",
          "requires_shipping": true,
          "taxable": false,
          "min_weight": null,
          "max_weight": null,
          "weight_unit": "lb",
          "location_infos": []
        }
      ]
    },
    "total": 0
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1principalUids负责人用户ID列表array<any>—可选负责人用户ID列表
2store_ids店铺Idarray<any>—可选店铺Id
3status状态array<any>—可选状态 1、Active 2、Draft 3、Archived 4、Deleted
4inventory_policy库存策略array<any>—可选库存策略 1、不跟踪库存 2、缺货停止销售 3、缺货继续销售
5type_id分类Idarray<any>—可选分类Id
6offset分页偏移量integer—可选分页偏移量
7length分页长度integer—可选分页长度,上限1000
8search_field搜索维度integer—可选搜索维度
9search_single_value模糊搜索值string—可选模糊搜索值
10search_values精确搜索列表array<any>—可选精确搜索列表,上限200个
11quantity库存数量string—可选库存数量
12quantity_condition库存数量大于或小于integer—可选库存数量大于或小于 1、大于 2、小于
13price售价integer—可选售价
14price_condition售价大于或小于integer—可选售价大于或小于 1、大于 2、小于
15listing_time_field时间维度integer—可选时间维度
16listing_start_time开始时间string—可选开始时间
17listing_end_time结束时间string—可选结束时间

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0:成功
2message消息提示stringsuccess必填消息提示
3error_details数据校验失败时的错误详情array<any>—必填数据校验失败时的错误详情
4request_id请求链路idstring—必填请求链路id
5response_time响应时间string2024-09-10 10:19:07必填响应时间
6data响应数据object—必填响应数据
6.1count总数number13必填总数
6.2listlistarray<object>—必填
6.2.1weight重量string0必填重量
6.2.2item_id商品Idstring6700083839169必填商品Id
6.2.3item_url商品链接string—必填商品链接
6.2.4product_unique_id产品uidstring901286166546538496必填产品uid
6.2.5variant_unique_id子体uidstring901286161295692288必填子体uid
6.2.6company_id企业Idstring901157321452879872必填企业Id
6.2.7parent_picture_url父图链接string—必填父图链接
6.2.8picture_url图片链接string—必填图片链接
6.2.9parent_msku父MSKUstring—必填父MSKU
6.2.10mskumskustringcustom003必填MSKU
6.2.11parent_attribute母体属性stringSize/Color必填母体属性
6.2.12attribute变体属性string42 / red必填变体属性
6.2.13title标题string定制产品必填标题
6.2.14local_skulocal_skustringtest061302sku必填SKU
6.2.15pid本地商品idstring—必填本地商品id
6.2.16local_name品名stringtest061302pm必填品名
6.2.17store_id店铺Idstring110000000018002001必填店铺Id
6.2.18store_name店铺名称string—必填店铺名称
6.2.19price售价string900.00必填售价
6.2.20quantity库存string111必填库存
6.2.21currency_icon货币图标string¥必填货币图标
6.2.22has_variant是否有子体booleanfalse必填是否有子体
6.2.23listing_start_time开始时间string2021-05-10 11:07:44必填开始时间
6.2.24listing_end_time结束时间string2021-10-26 17:26:08必填结束时间
6.2.25status商品状态number1必填商品状态: 1 active 2 draft 3 archived 4 deleted
6.2.26status_name商品状态stringactive必填商品状态: 1 active 2 draft 3 archived 4 deleted
6.2.27inventory_policy库存策略integer3必填库存策略: 1不跟踪库存 2缺货停止销售 3缺货继续销售
6.2.28inventory_policy_name库存策略string缺货继续销售必填库存策略: 1不跟踪库存 2缺货停止销售 3缺货继续销售
6.2.29type_id商品分类Idstring0必填商品分类Id
6.2.30type_name商品分类名string—必填商品分类名
6.2.31requires_shipping是否需要运输booleantrue必填是否需要运输 0、否 1、是
6.2.32taxable出售产品变体时是否要征税booleantrue必填出售产品变体时是否要征税 0、否 1、是
6.2.33min_weight最小重量integer—必填最小重量
6.2.34max_weight最大重量integer—必填最大重量
6.2.35weight_unit重量单位stringkg必填重量单位
6.2.36location_infos商品所在地详细信息array<object>—必填商品所在地详细信息
6.2.36.1quantity_adjust_after库存调整后的值string—必填库存调整后的值
6.2.36.2quantity_adjust_before库存调整前的值string—必填库存调整前的值
6.2.36.3quantity_user_id库存调整操作人idstring—必填库存调整操作人id
6.2.36.4quantity_user_id_name库存调整操作人名字string—必填库存调整操作人名字
6.2.36.5quantity_queue_type库存队列类型integer0必填库存队列类型
6.2.36.6quantity_queue_status库存队列状态string0必填库存队列状态
6.2.36.7location_name商品所在地名称string—必填商品所在地名称
6.2.36.8location_quantitylocation库存string111必填location库存
6.2.36.9location_id商品所在地idstring64418349246必填商品所在地id
7total总数integer0必填总数

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

需要对接这个接口?

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