/basicOpen/multiplatform/coupang/list{
"operation": {
"method": "POST",
"path": "/basicOpen/multiplatform/coupang/list"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/coupang/list?access_token=value×tamp=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 \"pairingStatus\": 1,\n \"searchField\": 4,\n \"searchSingleValue\": \"商品A\"\n}'",
"responseExample": {
"code": 0,
"message": "success",
"error_details": [],
"request_id": "a0d54debf93140f3b58d1ed81e8e3583",
"response_time": "2026-07-14 12:00:00",
"data": {
"count": 50,
"list": [
{
"id": 1,
"productUniqueId": 10001,
"principalUids": [
10001
],
"principalName": "张三",
"performanceUid": 10002,
"performanceName": "李四",
"variantUniqueId": 20001,
"rowType": "parent",
"sellerProductId": "SP001",
"vendorItemId": "VI001",
"sellerProductItemId": "SPI001",
"itemId": "ITEM001",
"mskuId": "MSKU001",
"msku": "msku-test",
"title": "示例商品标题",
"productStatus": "ACTIVE",
"productStatusDisplay": "销售中",
"registrationTypeDisplay": "自发货",
"shippingModeDisplay": "自发货",
"shippingMode": "NORMAL",
"inventoryReadOnly": false,
"itemName": "红色/XL",
"imgUrl": "https://img.example.com/1.jpg",
"maximumBuyCount": 100,
"salePrice": 29900,
"originalPrice": 39900,
"currency": "KRW",
"currencyIcon": "₩",
"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": 50
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | principalUids | 负责人用户ID列表 | array<any> | — | 可选 | 负责人用户ID列表;传[-1]表示仅查询未分配负责人,-1不能与其他UID混传 |
| 2 | offset | 偏移量 | integer | — | 可选 | 偏移量,默认0 |
| 3 | length | 每页条数 | integer | — | 可选 | 每页条数,默认20,最大200 |
| 4 | storeIds | 店铺ID列表 | array<any> | — | 可选 | 店铺ID列表 |
| 5 | pairingStatus | 配对状态 | integer | — | 可选 | 配对状态 0=未配对 1=已配对 |
| 6 | searchSingleValue | 模糊搜索值 | string | — | 可选 | 模糊搜索值 |
| 7 | searchValues | 精确搜索值列表 | array<any> | — | 可选 | 精确搜索值列表 |
| 8 | searchField | 搜索字段 | integer | — | 可选 | 搜索字段: 1=父体sellerProductId 2=标题 3=商品ID/vendorItemId 4=MSKU 5=本地SKU 6=品名 |
| 9 | sortType | 排序方式 | string | — | 可选 | 排序方式:asc/desc |
| 10 | sortField | 排序字段 | string | — | 可选 | 排序字段 |
| 11 | categoryIds | 分类ID列表 | array<any> | — | 可选 | 分类ID列表 |
| 12 | brandIds | 品牌ID列表 | array<any> | — | 可选 | 品牌ID列表 |
| 13 | statusList | 状态列表 | array<any> | — | 可选 | 状态列表 |
| 14 | timeField | 时间类型 | integer | — | 可选 | 时间类型: 1=创建时间 2=更新时间 |
| 15 | startTime | 开始时间(yyyy-MM-dd HH | string | — | 可选 | 开始时间(yyyy-MM-dd HH:mm:ss) |
| 16 | endTime | 结束时间(yyyy-MM-dd HH | string | — | 可选 | 结束时间(yyyy-MM-dd HH:mm:ss) |
| 17 | priceValue | 价格筛选值 | number | — | 可选 | 价格筛选值 |
| 18 | priceOp | 价格筛选条件 | string | — | 可选 | 价格筛选条件:gt/lt/eq |
| 19 | originalPriceValue | 原价筛选值 | number | — | 可选 | 原价筛选值 |
| 20 | originalPriceOp | 原价筛选条件 | string | — | 可选 | 原价筛选条件:gt/lt/eq |
| 21 | inventoryValue | 库存筛选值 | integer | — | 可选 | 库存筛选值 |
| 22 | inventoryOp | 库存筛选条件 | string | — | 可选 | 库存筛选条件:gt/lt/eq |
| 23 | shippingModeList | 发货模式筛选(父行维度) | array<any> | — | 可选 | 发货模式筛选(父行维度): 空/null=自发货 RFM=火箭仓 NORMAL=自发货/火箭仓 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | 必填 | 状态码,0:成功 |
| 2 | message | 消息提示 | string | success | 必填 | 消息提示 |
| 3 | error_details | 数据校验失败时的错误详情 | array<any> | — | 必填 | 数据校验失败时的错误详情 |
| 4 | request_id | 请求链路id | string | a0d54debf93140f3b58d1ed81e8e3583 | 必填 | 请求链路id |
| 5 | response_time | 响应时间 | string | 2026-07-14 12:00:00 | 必填 | 响应时间 |
| 6 | data | 响应数据 | object | — | 必填 | 响应数据 |
| 6.1 | count | 总数 | integer | 50 | 必填 | 总数 |
| 6.2 | list | 列表数据 | array<object> | — | 必填 | 列表数据 |
| 6.2.1 | principalUids | 负责人用户ID列表 | array<any> | [10001] | 可选 | 负责人用户ID列表 |
| 6.2.2 | principalName | 负责人名称 | string | 张三 | 可选 | 负责人名称 |
| 6.2.3 | performanceUid | 业绩归属人用户ID | integer | 10002 | 可选 | 业绩归属人用户ID |
| 6.2.4 | performanceName | 业绩归属人名称 | string | 李四 | 可选 | 业绩归属人名称 |
| 6.2.5 | id | id | integer | 1 | 必填 | ID |
| 6.2.6 | productUniqueId | 商品唯一ID | integer | 10001 | 必填 | 商品唯一ID |
| 6.2.7 | variantUniqueId | 子体维度分布式ID | integer | 20001 | 必填 | 子体维度分布式ID |
| 6.2.8 | rowType | 行类型 | string | parent | 必填 | 行类型:parent/child |
| 6.2.9 | sellerProductId | 父体商品ID | string | SP001 | 必填 | 父体商品ID |
| 6.2.10 | vendorItemId | 商品ID Option ID | string | VI001 | 必填 | 商品ID Option ID |
| 6.2.11 | sellerProductItemId | sellerProductItemId | string | SPI001 | 必填 | sellerProductItemId |
| 6.2.12 | itemId | itemId | string | ITEM001 | 必填 | itemId |
| 6.2.13 | mskuId | MSKU ID | string | MSKU001 | 必填 | MSKU ID |
| 6.2.14 | msku | msku | string | msku-test | 必填 | MSKU |
| 6.2.15 | title | 标题 | string | 示例商品标题 | 必填 | 标题 |
| 6.2.16 | productStatus | 父体状态 | string | ACTIVE | 必填 | 父体状态 |
| 6.2.17 | productStatusDisplay | 父体状态中文 | string | 销售中 | 必填 | 父体状态中文 |
| 6.2.18 | registrationTypeDisplay | 发货模式(父行) | string | 自发货 | 必填 | 发货模式(父行):自发货/火箭仓/自发货/火箭仓 |
| 6.2.19 | shippingModeDisplay | 发货方式(子行) | string | 自发货 | 必填 | 发货方式(子行):自发货/火箭仓 |
| 6.2.20 | shippingMode | 子行发货方式原始值 | string | NORMAL | 必填 | 子行发货方式原始值 |
| 6.2.21 | inventoryReadOnly | 火箭仓行库存是否不可编辑 | boolean | false | 必填 | 火箭仓行库存是否不可编辑 |
| 6.2.22 | itemName | 变体属性 | string | 红色/XL | 必填 | 变体属性 |
| 6.2.23 | imgUrl | 图片URL | string | https://img.example.com/1.jpg | 必填 | 图片URL |
| 6.2.24 | maximumBuyCount | 库存 | integer | 100 | 必填 | 库存 |
| 6.2.25 | salePrice | 售价 | number | 29900 | 必填 | 售价 |
| 6.2.26 | originalPrice | 原价 | number | 39900 | 必填 | 原价 |
| 6.2.27 | currency | 币种 | string | KRW | 必填 | 币种 |
| 6.2.28 | currencyIcon | 币种符号 | string | ₩ | 必填 | 币种符号 |
| 6.2.29 | createTime | 创建时间 | string | 2026-01-01 10:00:00 | 必填 | 创建时间 |
| 6.2.30 | updateTime | 更新时间 | string | 2026-01-05 10:00:00 | 必填 | 更新时间 |
| 6.2.31 | storeId | 店铺ID | integer | 1 | 必填 | 店铺ID |
| 6.2.32 | storeName | 店铺名称 | string | 我的店铺 | 必填 | 店铺名称 |
| 6.2.33 | pname | 品名 | string | 商品A | 必填 | 品名 |
| 6.2.34 | sku | sku | string | SKU001 | 必填 | SKU |
| 6.2.35 | pid | 本地产品ID | integer | 1001 | 必填 | 本地产品ID |
| 6.2.36 | children | 子行列表 | array<any> | — | 必填 | 子行列表 |
| 7 | total | 总数 | integer | 50 | 必填 | 总数 |
领星ERP的接口:查询Coupang在线商品(/basicOpen/multiplatform/coupang/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。