/basicOpen/multiplatform/rakuten/list{
"operation": {
"method": "POST",
"path": "/basicOpen/multiplatform/rakuten/list"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/rakuten/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 \"searchField\": 5,\n \"searchSingleValue\": \"商品A\",\n \"siteCode\": \"JP\",\n \"statusList\": [1]\n}'",
"responseExample": {
"code": 0,
"message": "success",
"error_details": [],
"request_id": "a0d54debf93140f3b58d1ed81e8e3583",
"response_time": "2026-07-14 12:00:00",
"data": {
"count": 20,
"list": [
{
"id": 1,
"productUniqueId": 10001,
"principalUids": [
10001
],
"principalName": "张三",
"performanceUid": 10002,
"performanceName": "李四",
"variantUniqueId": 20001,
"rowType": "parent",
"manageNumber": "MNG001",
"itemNumber": "ITEM001",
"mskuId": "MSKU001",
"msku": "msku-test",
"title": "示例商品标题",
"imgUrl": "https://img.example.com/1.jpg",
"status": "1",
"statusName": "在售",
"siteCode": "JP",
"price": 5980,
"referencePrice": 7980,
"currency": "JPY",
"currencyIcon": "¥",
"inventory": 50,
"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": 20
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | principalUids | 负责人用户ID列表 | array<any> | — | 可选 | 负责人用户ID列表;传[-1]表示仅查询未分配负责人,-1不能与其他UID混传 |
| 2 | offset | 偏移量 | integer | — | 可选 | 偏移量,默认0 |
| 3 | length | 每页数量 | integer | — | 可选 | 每页数量,默认20,最大1000 |
| 4 | storeIds | 店铺ID列表 | array<any> | — | 可选 | 店铺ID列表 |
| 5 | pairingStatus | 配对状态 | integer | — | 可选 | 配对状态: 0=未配对 1=已配对 |
| 6 | searchSingleValue | 搜索值(单个) | string | — | 可选 | 搜索值(单个) |
| 7 | searchValues | 搜索值列表(精确搜索) | array<any> | — | 可选 | 搜索值列表(精确搜索) |
| 8 | searchField | 搜索字段 | integer | — | 可选 | 搜索字段: 1=变体ID 2=标题 3=父体/manageNumber 4=商品番号 5=MSKU 6=SKU 7=品名 |
| 9 | sortType | 排序方式 | string | — | 可选 | 排序方式:asc/desc |
| 10 | sortField | 排序字段 | string | — | 可选 | 排序字段 |
| 11 | categoryIds | 分类ID列表 | array<any> | — | 可选 | 分类ID列表 |
| 12 | brandIds | 品牌ID列表 | array<any> | — | 可选 | 品牌ID列表 |
| 13 | siteCode | 站点代码 | string | — | 可选 | 站点代码:JP=日本站 |
| 14 | statusList | 状态 | array<any> | — | 可选 | 状态: 1=在售 2=仓库 0=已删除 |
| 15 | timeField | 时间字段 | integer | — | 可选 | 时间字段 |
| 16 | startTime | 开始时间 | string | — | 可选 | 开始时间 |
| 17 | endTime | 结束时间 | string | — | 可选 | 结束时间 |
| 18 | priceValue | 价格值 | number | — | 可选 | 价格值 |
| 19 | priceOp | 价格比较操作符 | string | — | 可选 | 价格比较操作符 |
| 20 | referencePriceValue | 参考价格值 | number | — | 可选 | 参考价格值 |
| 21 | referencePriceOp | 参考价格比较操作符 | string | — | 可选 | 参考价格比较操作符 |
| 22 | inventoryValue | 库存值 | integer | — | 可选 | 库存值 |
| 23 | inventoryOp | 库存比较操作符 | string | — | 可选 | 库存比较操作符 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 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 | 20 | 必填 | 总数 |
| 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 | 必填 | 行类型 |
| 6.2.9 | manageNumber | 管理番号 | string | MNG001 | 必填 | 管理番号 |
| 6.2.10 | itemNumber | 商品番号 | string | ITEM001 | 必填 | 商品番号 |
| 6.2.11 | mskuId | MSKU ID | string | MSKU001 | 必填 | MSKU ID |
| 6.2.12 | msku | msku | string | msku-test | 必填 | MSKU |
| 6.2.13 | title | 标题 | string | 示例商品标题 | 必填 | 标题 |
| 6.2.14 | imgUrl | 图片链接 | string | https://img.example.com/1.jpg | 必填 | 图片链接 |
| 6.2.15 | status | 状态 | string | 1 | 必填 | 状态 |
| 6.2.16 | statusName | 状态名称 | string | 在售 | 必填 | 状态名称 |
| 6.2.17 | siteCode | 站点代码 | string | JP | 必填 | 站点代码 |
| 6.2.18 | price | 价格 | number | 5980 | 必填 | 价格 |
| 6.2.19 | referencePrice | 参考价格 | number | 7980 | 必填 | 参考价格 |
| 6.2.20 | currency | 货币 | string | JPY | 必填 | 货币 |
| 6.2.21 | currencyIcon | 货币符号 | string | ¥ | 必填 | 货币符号 |
| 6.2.22 | inventory | 库存 | integer | 50 | 必填 | 库存 |
| 6.2.23 | createTime | 创建时间 | string | 2026-01-01 10:00:00 | 必填 | 创建时间 |
| 6.2.24 | updateTime | 更新时间 | string | 2026-01-05 10:00:00 | 必填 | 更新时间 |
| 6.2.25 | storeId | 店铺ID | integer | 1 | 必填 | 店铺ID |
| 6.2.26 | storeName | 店铺名称 | string | 我的店铺 | 必填 | 店铺名称 |
| 6.2.27 | pname | 品名 | string | 商品A | 必填 | 品名 |
| 6.2.28 | sku | sku | string | SKU001 | 必填 | SKU |
| 6.2.29 | pid | 本地商品ID | integer | 1001 | 必填 | 本地商品ID |
| 6.2.30 | children | 子体列表 | array<any> | — | 必填 | 子体列表 |
| 7 | total | 总数 | integer | 20 | 必填 | 总数 |
领星ERP的接口:查询Rakuten在线商品(/basicOpen/multiplatform/rakuten/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。