/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
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | sellerSku | seller_sku(msku) | string | — | 必填 | seller_sku(msku) |
| 2 | promotionType | 促销类型 | array<any> | — | 可选 | 促销类型 |
| 3 | status | 促销状态 | array<any> | — | 可选 | 促销状态: 0 其他 1 进行中 2 已过期 3 未开始 |
| 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 | 必填 | 状态码,0 成功 |
| 2 | message | 消息提示 | string | success | 必填 | 消息提示 |
| 3 | error_details | 错误信息 | array<any> | [] | 必填 | 错误信息 |
| 4 | request_id | 请求链路id | string | 9ed6f7bca84d4768a1c374ef8865e263.1752196903523 | 必填 | 请求链路id |
| 5 | response_time | 响应时间 | string | 2025-07-11 09:21:44 | 必填 | 响应时间 |
| 6 | data | data | object | — | 必填 | |
| 6.1 | 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 | hasPreviousPage | hasPreviousPage | boolean | false | 必填 | |
| 6.7 | hasNextPage | hasNextPage | boolean | false | 必填 | |
| 6.8 | records | records | array<object> | — | 必填 | |
| 6.8.1 | promotionId | 优惠券id | string | aec82146-b1c3-46ed-b044-05d4b0e8baf5 | 必填 | 优惠券id |
| 6.8.2 | name | 优惠券名称 | string | Save 5% on asdfasdfa | 必填 | 优惠券名称 |
| 6.8.3 | storeId | 店铺id | string | 43 | 必填 | 店铺id |
| 6.8.4 | storeName | 店铺名 | string | uboss-US | 必填 | 店铺名 |
| 6.8.5 | regionName | 国家/地区 | string | 美国 | 必填 | 国家/地区 |
| 6.8.6 | currencyIcon | 货币icon | string | $ | 必填 | 货币icon |
| 6.8.7 | status | 商品状态 | number | 2 | 必填 | 商品状态:1 active,2 draft,3 archived,4 deleted |
| 6.8.8 | needsAttention | 状态 | boolean | false | 必填 | 状态 |
| 6.8.9 | statusText | 状态 | string | 已过期 | 必填 | 状态 |
| 6.8.10 | originStatus | 活动状态 | string | EXPIRED | 必填 | 活动状态: ACTIVE 进行中 CANCELED 已取消 EXPIRED 已过期 RUNNING 生效中 NEEDS ACTION 需要注意 EXPIRING SOON 即将过期 SUBMITTED 已提交 FAILED 失败 |
| 6.8.11 | originStatusText | 活动状态 | string | 已过期 | 必填 | 活动状态 |
| 6.8.12 | discount | 折扣 | string | 5.00% | 必填 | 折扣 |
| 6.8.13 | budget | 预算 | string | $100 | 必填 | 预算 |
| 6.8.14 | cost | 支出 | number | 0 | 必填 | 支出 |
| 6.8.15 | drawQuantity | 领取数 | number | 0 | 必填 | 领取数 |
| 6.8.16 | exchangeQuantity | 兑换数 | number | 0 | 必填 | 兑换数 |
| 6.8.17 | exchangeRate | 兑换率 | number | 0 | 必填 | 兑换率 |
| 6.8.18 | salesAmount | 活动总销售额 | number | 0 | 必填 | 活动总销售额 |
| 6.8.19 | salesAmountUsd | 活动总销售额 | number | 0 | 必填 | 活动总销售额,换算成美元 |
| 6.8.20 | salesVolume | 活动总销量 | number | 0 | 必填 | 活动总销量 |
| 6.8.21 | promotionStartTime | 活动开始时间 | string | 2024-09-10 00:00:00 | 必填 | 活动开始时间 |
| 6.8.22 | promotionStartTimeUtc | 活动开始时间UTC时间 | string | null | 必填 | 活动开始时间UTC时间 |
| 6.8.23 | promotionEndTime | 活动结束时间 | string | 2024-09-12 00:00:00 | 必填 | 活动结束时间 |
| 6.8.24 | firstSyncTime | 首次同步时间 | string | 2024-11-07 10:36:28 | 必填 | 首次同步时间 |
| 6.8.25 | lastSyncTime | 最后同步时间 | string | 2024-11-07 17:25:19 | 必填 | 最后同步时间 |
| 6.8.26 | remark | 备注 | string | — | 必填 | 备注 |
| 7 | total | 总数 | number | 1 | 必填 | 总数 |
领星ERP的接口:查询商品折扣详情 - 列表 - 优惠券(/basicOpen/promotion/listingDetailCoupon),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。