/basicOpen/promotion/listingDetailManage{
"operation": {
"method": "POST",
"path": "/basicOpen/promotion/listingDetailManage"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": {
"sellerSku": "31-250J-NKH6",
"promotionType": [],
"status": [],
"storeId": "132",
"startTime": "2023-01-01",
"endTime": "2023-01-31",
"sortField": "startTime",
"sortType": "desc",
"pageNum": 1,
"pageSize": 20
},
"responseExample": {
"code": 0,
"message": "success",
"error_details": [],
"request_id": "c6ed840963a24d3e9805ca03b269f51b.1752205194893",
"response_time": "2025-07-11 11:40:01",
"data": {
"total": 1,
"size": 20,
"pageCount": 1,
"current": 1,
"currentSize": 1,
"hasNextPage": false,
"hasPreviousPage": false,
"records": [
{
"promotionId": "VPC-6-14498719 Coupon",
"name": "",
"trackingId": "VPC-6-14498719 Coupon",
"storeId": "132",
"storeName": "feifan-JP1",
"regionName": "日本",
"currencyIcon": "JP¥",
"status": 2,
"statusText": "已过期",
"originStatus": "EXPIRED",
"originStatusText": "已过期",
"promotionType": 0,
"promotionTypeText": "未定义类型",
"promotionCode": "",
"promotionCodeType": null,
"salesAmount": 0,
"salesAmountUsd": 0,
"salesVolume": 0,
"participateCondition": "",
"participateConditionNum": 0,
"buyerGets": "",
"buyerGetsNum": 0,
"purchaseProduct": "",
"discountProduct": "",
"excludeProduct": "",
"exchangeLimit": 0,
"promotionStartTime": "2023-01-02 00:00:00",
"promotionStartTimeUtc": null,
"promotionEndTime": "2023-01-03 23:59:00",
"firstSyncTime": "2023-03-06 18:15:41",
"lastSyncTime": "2024-01-09 14:13:20",
"remark": ""
}
]
},
"total": 1
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | sellerSku | seller_sku(msku) | string | — | 必填 | seller_sku(msku) |
| 2 | promotionType | 促销类型 | array<any> | — | 可选 | 促销类型 |
| 3 | status | 促销状态 | array<any> | — | 可选 | 促销状态 |
| 4 | storeId | 店铺id | string | — | 必填 | 店铺id |
| 5 | startTime | 活动开始时间 | string | — | 必填 | 活动开始时间 |
| 6 | endTime | 活动结束时间 | string | — | 必填 | 活动结束时间 |
| 7 | sortField | 排序项("cost" | string | — | 必填 | 排序项("cost", "drawQuantity", "exchangeQuantity", "exchangeRate","startTime","salesVolume","salesAmount","startTime") |
| 8 | sortType | 排序类型 asc desc | string | — | 必填 | 排序类型 asc desc |
| 9 | pageNum | 分页页码 | number | — | 必填 | 分页页码 |
| 10 | pageSize | 分页大小 | number | — | 必填 | 分页大小 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 消息提示 | number | 0 | 必填 | 消息提示 |
| 2 | message | 消息 | string | success | 必填 | 消息 |
| 3 | error_details | 错误信息 | array<any> | [] | 必填 | 错误信息 |
| 4 | request_id | 请求id | string | c6ed840963a24d3e9805ca03b269f51b.1752205194893 | 必填 | 请求id |
| 5 | response_time | 响应时间 | string | 2025-07-11 11:40:01 | 必填 | 响应时间 |
| 6 | data | data | object | — | 必填 | |
| 6.1 | total | total | number | 1 | 必填 | |
| 6.2 | size | size | number | 20 | 必填 | |
| 6.3 | pageCount | pageCount | number | 1 | 必填 | |
| 6.4 | current | current | number | 1 | 必填 | |
| 6.5 | currentSize | currentSize | number | 1 | 必填 | |
| 6.6 | hasNextPage | hasNextPage | boolean | false | 必填 | |
| 6.7 | hasPreviousPage | hasPreviousPage | boolean | false | 必填 | |
| 6.8 | records | records | array<object> | — | 必填 | |
| 6.8.1 | promotionId | 活动id | string | VPC-6-14498719 Coupon | 必填 | 活动id,唯一标识 |
| 6.8.2 | name | 名称-内部描述 | string | — | 必填 | 名称-内部描述 |
| 6.8.3 | trackingId | 追踪编码 | string | VPC-6-14498719 Coupon | 必填 | 追踪编码 |
| 6.8.4 | storeId | 店铺id | string | 132 | 必填 | 店铺id |
| 6.8.5 | storeName | 店铺名 | string | feifan-JP1 | 必填 | 店铺名 |
| 6.8.6 | regionName | 国家/地区名 | string | 日本 | 必填 | 国家/地区名 |
| 6.8.7 | currencyIcon | 货币icon | string | JP¥ | 必填 | 货币icon |
| 6.8.8 | status | 状态 | number | 2 | 必填 | 状态 |
| 6.8.9 | statusText | 状态 | string | 已过期 | 必填 | 状态 |
| 6.8.10 | originStatus | 促销活动平台状态 | string | EXPIRED | 必填 | 促销活动平台状态 |
| 6.8.11 | originStatusText | 促销活动平台状态 | string | 已过期 | 必填 | 促销活动平台状态 |
| 6.8.12 | promotionType | 促销类型 | number | 0 | 必填 | 促销类型 |
| 6.8.13 | promotionTypeText | 促销类型 | string | 未定义类型 | 必填 | 促销类型 |
| 6.8.14 | promotionCode | 优惠码 | string | — | 必填 | 优惠码 |
| 6.8.15 | promotionCodeType | 优惠码类型 | string | null | 必填 | 优惠码类型,1优先型,2无限型 |
| 6.8.16 | salesAmount | 活动总销售额 | number | 0 | 必填 | 活动总销售额 |
| 6.8.17 | salesAmountUsd | 活动总销售额 | number | 0 | 必填 | 活动总销售额,换算成美元 |
| 6.8.18 | salesVolume | 活动总销量 | number | 0 | 必填 | 活动总销量 |
| 6.8.19 | participateCondition | 参与条件 | string | — | 必填 | 参与条件 |
| 6.8.20 | participateConditionNum | 参与条件数值 | number | 0 | 必填 | 参与条件数值 |
| 6.8.21 | buyerGets | 买家获得 | string | — | 必填 | 买家获得 |
| 6.8.22 | buyerGetsNum | 买家获得值 | number | 0 | 必填 | 买家获得值 |
| 6.8.23 | purchaseProduct | 需购买商品 | string | — | 必填 | 需购买商品 |
| 6.8.24 | discountProduct | 优惠商品 | string | — | 必填 | 优惠商品 |
| 6.8.25 | excludeProduct | 排除商品 | string | — | 必填 | 排除商品 |
| 6.8.26 | exchangeLimit | 是否限制兑换 | number | 0 | 必填 | 是否限制兑换,1是0否 |
| 6.8.27 | promotionStartTime | 活动开始时间 | string | 2023-01-02 00:00:00 | 必填 | 活动开始时间 |
| 6.8.28 | promotionStartTimeUtc | 活动开始时间Utc | string | null | 必填 | 活动开始时间Utc |
| 6.8.29 | promotionEndTime | 活动结束时间 | string | 2023-01-03 23:59:00 | 必填 | 活动结束时间 |
| 6.8.30 | firstSyncTime | 首次同步时间 | string | 2023-03-06 18:15:41 | 必填 | 首次同步时间 |
| 6.8.31 | lastSyncTime | 最后同步时间 | string | 2024-01-09 14:13:20 | 必填 | 最后同步时间 |
| 6.8.32 | remark | 备注 | string | — | 必填 | 备注 |
| 7 | total | total | number | 1 | 必填 |
领星ERP的接口:查询商品折扣详情 - 列表 - 管理促销(/basicOpen/promotion/listingDetailManage),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。