/basicOpen/promotion/listingDetailCoupon{
"operation": {
"method": "POST",
"path": "/basicOpen/promotion/listingDetailCoupon"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"requestExample": {
"sellerSku": "7T-2COF-AV9I",
"promotionType": [],
"status": [],
"storeId": "43",
"startTime": "2024-09-10",
"endTime": "2024-09-12",
"sortField": "startTime",
"sortType": "desc",
"pageNum": 1,
"pageSize": 20
},
"responseExample": {
"code": 0,
"message": "success",
"error_details": [],
"request_id": "9ed6f7bca84d4768a1c374ef8865e263.1752196903523",
"response_time": "2025-07-11 09:21:44",
"data": {
"total": 1,
"size": 20,
"pageCount": 1,
"current": 1,
"currentSize": 1,
"hasPreviousPage": false,
"hasNextPage": false,
"records": [
{
"promotionId": "aec82146-b1c3-46ed-b044-05d4b0e8baf5",
"name": "Save 5% on asdfasdfa",
"storeId": "43",
"storeName": "uboss-US",
"regionName": "美国",
"currencyIcon": "$",
"status": 2,
"needsAttention": false,
"statusText": "已过期",
"originStatus": "EXPIRED",
"originStatusText": "已过期",
"discount": "5.00%",
"budget": "$100",
"cost": 0,
"drawQuantity": 0,
"exchangeQuantity": 0,
"exchangeRate": 0,
"salesAmount": 0,
"salesAmountUsd": 0,
"salesVolume": 0,
"promotionStartTime": "2024-09-10 00:00:00",
"promotionStartTimeUtc": null,
"promotionEndTime": "2024-09-12 00:00:00",
"firstSyncTime": "2024-11-07 10:36:28",
"lastSyncTime": "2024-11-07 17:25:19",
"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 | 促销状态: 0 其他 1 进行中 2 已过期 3 未开始 |
| 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 | 状态码,0 成功 |
| 2 | message | 消息提示 | string | success | Required | 消息提示 |
| 3 | error_details | 错误信息 | array<any> | [] | Required | 错误信息 |
| 4 | request_id | 请求链路id | string | 9ed6f7bca84d4768a1c374ef8865e263.1752196903523 | Required | 请求链路id |
| 5 | response_time | 响应时间 | string | 2025-07-11 09:21:44 | Required | 响应时间 |
| 6 | data | data | object | — | Required | |
| 6.1 | 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 | hasPreviousPage | hasPreviousPage | boolean | false | Required | |
| 6.7 | hasNextPage | hasNextPage | boolean | false | Required | |
| 6.8 | records | records | array<object> | — | Required | |
| 6.8.1 | promotionId | 优惠券id | string | aec82146-b1c3-46ed-b044-05d4b0e8baf5 | Required | 优惠券id |
| 6.8.2 | name | 优惠券名称 | string | Save 5% on asdfasdfa | Required | 优惠券名称 |
| 6.8.3 | storeId | 店铺id | string | 43 | Required | 店铺id |
| 6.8.4 | storeName | 店铺名 | string | uboss-US | Required | 店铺名 |
| 6.8.5 | regionName | 国家/地区 | string | 美国 | Required | 国家/地区 |
| 6.8.6 | currencyIcon | 货币icon | string | $ | Required | 货币icon |
| 6.8.7 | status | 商品状态 | number | 2 | Required | 商品状态:1 active,2 draft,3 archived,4 deleted |
| 6.8.8 | needsAttention | 状态 | boolean | false | Required | 状态 |
| 6.8.9 | statusText | 状态 | string | 已过期 | Required | 状态 |
| 6.8.10 | originStatus | 活动状态 | string | EXPIRED | Required | 活动状态: ACTIVE 进行中 CANCELED 已取消 EXPIRED 已过期 RUNNING 生效中 NEEDS ACTION 需要注意 EXPIRING SOON 即将过期 SUBMITTED 已提交 FAILED 失败 |
| 6.8.11 | originStatusText | 活动状态 | string | 已过期 | Required | 活动状态 |
| 6.8.12 | discount | 折扣 | string | 5.00% | Required | 折扣 |
| 6.8.13 | budget | 预算 | string | $100 | Required | 预算 |
| 6.8.14 | cost | 支出 | number | 0 | Required | 支出 |
| 6.8.15 | drawQuantity | 领取数 | number | 0 | Required | 领取数 |
| 6.8.16 | exchangeQuantity | 兑换数 | number | 0 | Required | 兑换数 |
| 6.8.17 | exchangeRate | 兑换率 | number | 0 | Required | 兑换率 |
| 6.8.18 | salesAmount | 活动总销售额 | number | 0 | Required | 活动总销售额 |
| 6.8.19 | salesAmountUsd | 活动总销售额 | number | 0 | Required | 活动总销售额,换算成美元 |
| 6.8.20 | salesVolume | 活动总销量 | number | 0 | Required | 活动总销量 |
| 6.8.21 | promotionStartTime | 活动开始时间 | string | 2024-09-10 00:00:00 | Required | 活动开始时间 |
| 6.8.22 | promotionStartTimeUtc | 活动开始时间UTC时间 | string | null | Required | 活动开始时间UTC时间 |
| 6.8.23 | promotionEndTime | 活动结束时间 | string | 2024-09-12 00:00:00 | Required | 活动结束时间 |
| 6.8.24 | firstSyncTime | 首次同步时间 | string | 2024-11-07 10:36:28 | Required | 首次同步时间 |
| 6.8.25 | lastSyncTime | 最后同步时间 | string | 2024-11-07 17:25:19 | Required | 最后同步时间 |
| 6.8.26 | remark | 备注 | string | — | Required | 备注 |
| 7 | total | 总数 | number | 1 | Required | 总数 |
The 查询商品折扣详情 - 列表 - 优惠券 API (/basicOpen/promotion/listingDetailCoupon) 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.