/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
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | sellerSku | seller_sku(msku) | string | — | Required | seller_sku(msku) |
| 2 | promotionType | 促销类型 | array<any> | — | Optional | 促销类型 |
| 3 | status | 促销状态 | array<any> | — | Optional | 促销状态 |
| 4 | storeId | 店铺id | string | — | Required | 店铺id |
| 5 | startTime | 活动开始时间 | string | — | Required | 活动开始时间 |
| 6 | endTime | 活动结束时间 | string | — | Required | 活动结束时间 |
| 7 | sortField | 排序项("cost" | string | — | Required | 排序项("cost", "drawQuantity", "exchangeQuantity", "exchangeRate","startTime","salesVolume","salesAmount","startTime") |
| 8 | sortType | 排序类型 asc desc | string | — | Required | 排序类型 asc desc |
| 9 | pageNum | 分页页码 | number | — | Required | 分页页码 |
| 10 | pageSize | 分页大小 | number | — | Required | 分页大小 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 消息提示 | number | 0 | Required | 消息提示 |
| 2 | message | 消息 | string | success | Required | 消息 |
| 3 | error_details | 错误信息 | array<any> | [] | Required | 错误信息 |
| 4 | request_id | 请求id | string | c6ed840963a24d3e9805ca03b269f51b.1752205194893 | Required | 请求id |
| 5 | response_time | 响应时间 | string | 2025-07-11 11:40:01 | Required | 响应时间 |
| 6 | data | data | object | — | Required | |
| 6.1 | total | total | number | 1 | Required | |
| 6.2 | size | size | number | 20 | Required | |
| 6.3 | pageCount | pageCount | number | 1 | Required | |
| 6.4 | current | current | number | 1 | Required | |
| 6.5 | currentSize | currentSize | number | 1 | Required | |
| 6.6 | hasNextPage | hasNextPage | boolean | false | Required | |
| 6.7 | hasPreviousPage | hasPreviousPage | boolean | false | Required | |
| 6.8 | records | records | array<object> | — | Required | |
| 6.8.1 | promotionId | 活动id | string | VPC-6-14498719 Coupon | Required | 活动id,唯一标识 |
| 6.8.2 | name | 名称-内部描述 | string | — | Required | 名称-内部描述 |
| 6.8.3 | trackingId | 追踪编码 | string | VPC-6-14498719 Coupon | Required | 追踪编码 |
| 6.8.4 | storeId | 店铺id | string | 132 | Required | 店铺id |
| 6.8.5 | storeName | 店铺名 | string | feifan-JP1 | Required | 店铺名 |
| 6.8.6 | regionName | 国家/地区名 | string | 日本 | Required | 国家/地区名 |
| 6.8.7 | currencyIcon | 货币icon | string | JP¥ | Required | 货币icon |
| 6.8.8 | status | 状态 | number | 2 | Required | 状态 |
| 6.8.9 | statusText | 状态 | string | 已过期 | Required | 状态 |
| 6.8.10 | originStatus | 促销活动平台状态 | string | EXPIRED | Required | 促销活动平台状态 |
| 6.8.11 | originStatusText | 促销活动平台状态 | string | 已过期 | Required | 促销活动平台状态 |
| 6.8.12 | promotionType | 促销类型 | number | 0 | Required | 促销类型 |
| 6.8.13 | promotionTypeText | 促销类型 | string | 未定义类型 | Required | 促销类型 |
| 6.8.14 | promotionCode | 优惠码 | string | — | Required | 优惠码 |
| 6.8.15 | promotionCodeType | 优惠码类型 | string | null | Required | 优惠码类型,1优先型,2无限型 |
| 6.8.16 | salesAmount | 活动总销售额 | number | 0 | Required | 活动总销售额 |
| 6.8.17 | salesAmountUsd | 活动总销售额 | number | 0 | Required | 活动总销售额,换算成美元 |
| 6.8.18 | salesVolume | 活动总销量 | number | 0 | Required | 活动总销量 |
| 6.8.19 | participateCondition | 参与条件 | string | — | Required | 参与条件 |
| 6.8.20 | participateConditionNum | 参与条件数值 | number | 0 | Required | 参与条件数值 |
| 6.8.21 | buyerGets | 买家获得 | string | — | Required | 买家获得 |
| 6.8.22 | buyerGetsNum | 买家获得值 | number | 0 | Required | 买家获得值 |
| 6.8.23 | purchaseProduct | 需购买商品 | string | — | Required | 需购买商品 |
| 6.8.24 | discountProduct | 优惠商品 | string | — | Required | 优惠商品 |
| 6.8.25 | excludeProduct | 排除商品 | string | — | Required | 排除商品 |
| 6.8.26 | exchangeLimit | 是否限制兑换 | number | 0 | Required | 是否限制兑换,1是0否 |
| 6.8.27 | promotionStartTime | 活动开始时间 | string | 2023-01-02 00:00:00 | Required | 活动开始时间 |
| 6.8.28 | promotionStartTimeUtc | 活动开始时间Utc | string | null | Required | 活动开始时间Utc |
| 6.8.29 | promotionEndTime | 活动结束时间 | string | 2023-01-03 23:59:00 | Required | 活动结束时间 |
| 6.8.30 | firstSyncTime | 首次同步时间 | string | 2023-03-06 18:15:41 | Required | 首次同步时间 |
| 6.8.31 | lastSyncTime | 最后同步时间 | string | 2024-01-09 14:13:20 | Required | 最后同步时间 |
| 6.8.32 | remark | 备注 | string | — | Required | 备注 |
| 7 | total | total | number | 1 | Required |
The 查询商品折扣详情 - 列表 - 管理促销 API (/basicOpen/promotion/listingDetailManage) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.
Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.