/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×tamp=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
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | principalUids | 负责人用户ID列表 | array<any> | — | 可选 | 负责人用户ID列表 |
| 2 | store_ids | 店铺Id | array<any> | — | 可选 | 店铺Id |
| 3 | status | 状态 | array<any> | — | 可选 | 状态 1、Active 2、Draft 3、Archived 4、Deleted |
| 4 | inventory_policy | 库存策略 | array<any> | — | 可选 | 库存策略 1、不跟踪库存 2、缺货停止销售 3、缺货继续销售 |
| 5 | type_id | 分类Id | array<any> | — | 可选 | 分类Id |
| 6 | offset | 分页偏移量 | integer | — | 可选 | 分页偏移量 |
| 7 | length | 分页长度 | integer | — | 可选 | 分页长度,上限1000 |
| 8 | search_field | 搜索维度 | integer | — | 可选 | 搜索维度 |
| 9 | search_single_value | 模糊搜索值 | string | — | 可选 | 模糊搜索值 |
| 10 | search_values | 精确搜索列表 | array<any> | — | 可选 | 精确搜索列表,上限200个 |
| 11 | quantity | 库存数量 | string | — | 可选 | 库存数量 |
| 12 | quantity_condition | 库存数量大于或小于 | integer | — | 可选 | 库存数量大于或小于 1、大于 2、小于 |
| 13 | price | 售价 | integer | — | 可选 | 售价 |
| 14 | price_condition | 售价大于或小于 | integer | — | 可选 | 售价大于或小于 1、大于 2、小于 |
| 15 | listing_time_field | 时间维度 | integer | — | 可选 | 时间维度 |
| 16 | listing_start_time | 开始时间 | string | — | 可选 | 开始时间 |
| 17 | listing_end_time | 结束时间 | string | — | 可选 | 结束时间 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | 必填 | 状态码,0:成功 |
| 2 | message | 消息提示 | string | success | 必填 | 消息提示 |
| 3 | error_details | 数据校验失败时的错误详情 | array<any> | — | 必填 | 数据校验失败时的错误详情 |
| 4 | request_id | 请求链路id | string | — | 必填 | 请求链路id |
| 5 | response_time | 响应时间 | string | 2024-09-10 10:19:07 | 必填 | 响应时间 |
| 6 | data | 响应数据 | object | — | 必填 | 响应数据 |
| 6.1 | count | 总数 | number | 13 | 必填 | 总数 |
| 6.2 | list | list | array<object> | — | 必填 | |
| 6.2.1 | weight | 重量 | string | 0 | 必填 | 重量 |
| 6.2.2 | item_id | 商品Id | string | 6700083839169 | 必填 | 商品Id |
| 6.2.3 | item_url | 商品链接 | string | — | 必填 | 商品链接 |
| 6.2.4 | product_unique_id | 产品uid | string | 901286166546538496 | 必填 | 产品uid |
| 6.2.5 | variant_unique_id | 子体uid | string | 901286161295692288 | 必填 | 子体uid |
| 6.2.6 | company_id | 企业Id | string | 901157321452879872 | 必填 | 企业Id |
| 6.2.7 | parent_picture_url | 父图链接 | string | — | 必填 | 父图链接 |
| 6.2.8 | picture_url | 图片链接 | string | — | 必填 | 图片链接 |
| 6.2.9 | parent_msku | 父MSKU | string | — | 必填 | 父MSKU |
| 6.2.10 | msku | msku | string | custom003 | 必填 | MSKU |
| 6.2.11 | parent_attribute | 母体属性 | string | Size/Color | 必填 | 母体属性 |
| 6.2.12 | attribute | 变体属性 | string | 42 / red | 必填 | 变体属性 |
| 6.2.13 | title | 标题 | string | 定制产品 | 必填 | 标题 |
| 6.2.14 | local_sku | local_sku | string | test061302sku | 必填 | SKU |
| 6.2.15 | pid | 本地商品id | string | — | 必填 | 本地商品id |
| 6.2.16 | local_name | 品名 | string | test061302pm | 必填 | 品名 |
| 6.2.17 | store_id | 店铺Id | string | 110000000018002001 | 必填 | 店铺Id |
| 6.2.18 | store_name | 店铺名称 | string | — | 必填 | 店铺名称 |
| 6.2.19 | price | 售价 | string | 900.00 | 必填 | 售价 |
| 6.2.20 | quantity | 库存 | string | 111 | 必填 | 库存 |
| 6.2.21 | currency_icon | 货币图标 | string | ¥ | 必填 | 货币图标 |
| 6.2.22 | has_variant | 是否有子体 | boolean | false | 必填 | 是否有子体 |
| 6.2.23 | listing_start_time | 开始时间 | string | 2021-05-10 11:07:44 | 必填 | 开始时间 |
| 6.2.24 | listing_end_time | 结束时间 | string | 2021-10-26 17:26:08 | 必填 | 结束时间 |
| 6.2.25 | status | 商品状态 | number | 1 | 必填 | 商品状态: 1 active 2 draft 3 archived 4 deleted |
| 6.2.26 | status_name | 商品状态 | string | active | 必填 | 商品状态: 1 active 2 draft 3 archived 4 deleted |
| 6.2.27 | inventory_policy | 库存策略 | integer | 3 | 必填 | 库存策略: 1不跟踪库存 2缺货停止销售 3缺货继续销售 |
| 6.2.28 | inventory_policy_name | 库存策略 | string | 缺货继续销售 | 必填 | 库存策略: 1不跟踪库存 2缺货停止销售 3缺货继续销售 |
| 6.2.29 | type_id | 商品分类Id | string | 0 | 必填 | 商品分类Id |
| 6.2.30 | type_name | 商品分类名 | string | — | 必填 | 商品分类名 |
| 6.2.31 | requires_shipping | 是否需要运输 | boolean | true | 必填 | 是否需要运输 0、否 1、是 |
| 6.2.32 | taxable | 出售产品变体时是否要征税 | boolean | true | 必填 | 出售产品变体时是否要征税 0、否 1、是 |
| 6.2.33 | min_weight | 最小重量 | integer | — | 必填 | 最小重量 |
| 6.2.34 | max_weight | 最大重量 | integer | — | 必填 | 最大重量 |
| 6.2.35 | weight_unit | 重量单位 | string | kg | 必填 | 重量单位 |
| 6.2.36 | location_infos | 商品所在地详细信息 | array<object> | — | 必填 | 商品所在地详细信息 |
| 6.2.36.1 | quantity_adjust_after | 库存调整后的值 | string | — | 必填 | 库存调整后的值 |
| 6.2.36.2 | quantity_adjust_before | 库存调整前的值 | string | — | 必填 | 库存调整前的值 |
| 6.2.36.3 | quantity_user_id | 库存调整操作人id | string | — | 必填 | 库存调整操作人id |
| 6.2.36.4 | quantity_user_id_name | 库存调整操作人名字 | string | — | 必填 | 库存调整操作人名字 |
| 6.2.36.5 | quantity_queue_type | 库存队列类型 | integer | 0 | 必填 | 库存队列类型 |
| 6.2.36.6 | quantity_queue_status | 库存队列状态 | string | 0 | 必填 | 库存队列状态 |
| 6.2.36.7 | location_name | 商品所在地名称 | string | — | 必填 | 商品所在地名称 |
| 6.2.36.8 | location_quantity | location库存 | string | 111 | 必填 | location库存 |
| 6.2.36.9 | location_id | 商品所在地id | string | 64418349246 | 必填 | 商品所在地id |
| 7 | total | 总数 | integer | 0 | 必填 | 总数 |
领星ERP的接口:查询Shopify在线商品(/basicOpen/multiplatform/shopify/variantList),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。