/promotionApi/open/promotion/managementAllDetailBatch{
"operation": {
"method": "POST",
"path": "/promotionApi/open/promotion/managementAllDetailBatch"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": {
"itemList": [
{
"promotionId": "PROMO123456",
"storeId": "STORE789",
"orderPageNum": 1,
"orderPageSize": 50,
"listingPageNum": 1,
"listingPageSize": 100
},
{
"promotionId": "PROMO654321",
"storeId": "STORE987",
"orderPageNum": 2,
"orderPageSize": 100,
"listingPageNum": 1,
"listingPageSize": 200
}
]
},
"responseExample": {
"code": 0,
"message": "success",
"error_details": [],
"request_id": "a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8",
"response_time": "2023-05-15 14:30:45",
"total": 1,
"data": [
{
"promotionId": "PROMO123456",
"storeId": "STORE789",
"management": {
"storeId": "STORE789",
"storeName": "BestSeller Store",
"regionName": "United States",
"currencyIcon": "$",
"promotionId": "PROMO123456",
"name": "Summer Sale 2023",
"status": 1,
"statusText": "进行中",
"originStatus": "ACTIVE",
"promotionType": 4,
"promotionTypeText": "购买折扣",
"promotionStartTime": "2023-05-01 00:00:00",
"promotionEndTime": "2023-05-31 23:59:59",
"promotionCode": "SUMMER20",
"exchangeLimit": 1,
"participateCondition": "Buy 2 items",
"buyerGets": "20% off",
"purchaseProduct": "All eligible items",
"discountProduct": "Selected items",
"excludeProduct": "Clearance items",
"trackingId": "TRACK789",
"displayOnDetailPage": 1,
"salesAmount": 1250.5,
"salesVolume": 45,
"promotionPageLink": "https://www.amazon.com/promos/PROMO123456"
},
"listingPage": {
"current": 1,
"currentSize": 2,
"hasNextPage": false,
"hasPreviousPage": false,
"pageCount": 1,
"records": [
{
"asin": "B08N5KWB9H",
"asinUrl": "https://www.amazon.com/dp/B08N5KWB9H",
"currencyIcon": "$",
"itemName": "Wireless Bluetooth Headphones",
"management": {
"discountPrice": 59.99,
"salesAmount": 1199.8,
"salesPrice": 59.99,
"salesVolume": 20
},
"regionName": "United States",
"sellerSku": "WH-2023-BLUE",
"smallImageUrl": "https://m.media-amazon.com/images/I/71+6m.jpg",
"storeId": 789,
"storeName": "BestSeller Store"
},
{
"asin": "B07PGL2ZKV",
"asinUrl": "https://www.amazon.com/dp/B07PGL2ZKV",
"currencyIcon": "$",
"itemName": "Portable Charger 10000mAh",
"management": {
"discountPrice": 25.99,
"salesAmount": 50.7,
"salesPrice": 25.99,
"salesVolume": 2
},
"regionName": "United States",
"sellerSku": "PC-2023-BLK",
"smallImageUrl": "https://m.media-amazon.com/images/I/61+9m.jpg",
"storeId": 789,
"storeName": "BestSeller Store"
}
],
"size": 10,
"total": 2
},
"orderPage": {
"current": 1,
"currentSize": 1,
"hasNextPage": false,
"hasPreviousPage": false,
"pageCount": 1,
"records": [
{
"amazonOrderId": "112-1234567-8901234",
"currencyIcon": "$",
"orderItems": [
{
"asin": "B08N5KWB9H",
"asinUrl": "https://www.amazon.com/dp/B08N5KWB9H",
"itemName": "Wireless Bluetooth Headphones",
"localName": "蓝牙无线耳机",
"localSku": "LOCAL-BT-001",
"promotionId": "PROMO123456",
"sellerSku": "WH-2023-BLUE",
"smallImageUrl": "https://m.media-amazon.com/images/I/71+6m.jpg"
}
],
"orderStatus": "Shipped",
"orderTotalAmount": 119.98,
"purchaseDate": "2023-05-10 15:30:22",
"regionName": "United States",
"storeId": 789,
"storeName": "BestSeller Store"
}
],
"size": 10,
"total": 1
}
}
]
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | itemList | itemList | array<object> | — | Required | 批量请求详情itemList个数最小为1最大为20 |
| 1.1 | promotionId | 活动id | string | — | Required | 活动id |
| 1.2 | storeId | 店铺id | string | — | Required | 店铺id |
| 1.3 | orderPageNum | 活动订单分页页数 | number | — | Required | 活动订单分页页数,最小1 |
| 1.4 | orderPageSize | 活动订单分页大小 | number | — | Required | 活动订单分页大小,最小为1,最大为200 |
| 1.5 | listingPageNum | 活动listing分页页数 | number | — | Required | 活动listing分页页数,最小1 |
| 1.6 | listingPageSize | 活动listing分页大小 | number | — | Required | 活动listing分页大小,最小为1,最大为200 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 0成功 | number | 0 | Required | 0成功 |
| 2 | message | message | string | — | Required | |
| 3 | error_details | error_details | array<any> | — | Optional | |
| 4 | request_id | request_id | string | — | Required | |
| 5 | response_time | yyyy-MM-dd HH | string | — | Required | yyyy-MM-dd HH:mm:ss |
| 6 | total | total | integer | — | Required | |
| 7 | data | data | array<object> | 详见返回成功示例 | Required | |
| 7.1 | promotionId | 活动id | string | — | Required | 活动id |
| 7.2 | storeId | 店铺id | string | — | Required | 店铺id |
| 7.3 | management | 管理促销信息 | object | — | Required | 管理促销信息 |
| 7.3.1 | storeId | 店铺ID | string | — | Required | 店铺ID |
| 7.3.2 | storeName | 店铺名称 | string | — | Required | 店铺名称 |
| 7.3.3 | regionName | 国家/地区名 | string | — | Required | 国家/地区名 |
| 7.3.4 | currencyIcon | 货币icon | string | — | Required | 货币icon |
| 7.3.5 | promotionId | 活动id | string | — | Required | 活动id |
| 7.3.6 | name | 名称 | string | — | Required | 名称 |
| 7.3.7 | status | status | number | 0 | Required | 状态 0其他 1进行中 2已过期 3未开始 4已取消 |
| 7.3.8 | statusText | 状态说明 | string | — | Required | 状态说明 |
| 7.3.9 | originStatus | 促销活动平台状态 | string | — | Required | 促销活动平台状态 |
| 7.3.10 | promotionType | promotionType | number | 0 | Required | 活动类型 0未定义 1Best Deal 2Lightning Deal 3买一赠一 4购买折扣 5一口价 6折扣 7金额 8社媒促销 9金额 |
| 7.3.11 | promotionTypeText | 活动类型说明 | string | — | Required | 活动类型说明 |
| 7.3.12 | promotionStartTime | 活动开始时间 | string | — | Required | 活动开始时间 |
| 7.3.13 | promotionEndTime | 活动结束时间 | string | — | Required | 活动结束时间 |
| 7.3.14 | promotionCode | 优惠码 | string | — | Required | 优惠码 |
| 7.3.15 | exchangeLimit | 是否限制兑换 | number | 0 | Required | 是否限制兑换,1是0否 |
| 7.3.16 | participateCondition | 兑换限制条件 | string | — | Required | 兑换限制条件 |
| 7.3.17 | buyerGets | 买家获得 | string | — | Required | 买家获得 |
| 7.3.18 | purchaseProduct | 需购买商品 | string | — | Required | 需购买商品 |
| 7.3.19 | discountProduct | 优惠商品 | string | — | Required | 优惠商品 |
| 7.3.20 | excludeProduct | 排除商品 | string | — | Required | 排除商品 |
| 7.3.21 | trackingId | 追踪编码 | string | — | Required | 追踪编码 |
| 7.3.22 | displayOnDetailPage | 是否显示在详情页 | number | — | Required | 是否显示在详情页,1是0否 |
| 7.3.23 | salesAmount | 活动总销售额 | number | 0 | Required | 活动总销售额 |
| 7.3.24 | salesVolume | 活动总销量 | number | 0 | Required | 活动总销量 |
| 7.3.25 | promotionPageLink | 营销页面链接 | string | — | Required | 营销页面链接 |
| 7.4 | listingPage | 管理促销涉及的Listing信息 | object | — | Required | 管理促销涉及的Listing信息 |
| 7.4.1 | current | current | number | 0 | Required | |
| 7.4.2 | currentSize | currentSize | number | 0 | Required | |
| 7.4.3 | hasNextPage | hasNextPage | boolean | true | Required | |
| 7.4.4 | hasPreviousPage | hasPreviousPage | boolean | true | Required | |
| 7.4.5 | pageCount | pageCount | number | 0 | Required | |
| 7.4.6 | records | records | array<object> | 详见返回成功示例 | Required | |
| 7.4.6.1 | asin | asin | string | — | Required | asin |
| 7.4.6.2 | asinUrl | asin跳转亚马逊前台链接 | string | — | Required | asin跳转亚马逊前台链接 |
| 7.4.6.3 | currencyIcon | 货币icon | string | — | Required | 货币icon |
| 7.4.6.4 | itemName | 商品标题 | string | — | Required | 商品标题 |
| 7.4.6.5 | management | 管理促销基本信息 | object | — | Required | 管理促销基本信息 |
| 7.4.6.5.1 | discountPrice | 折后价 | number | 0 | Required | 折后价 |
| 7.4.6.5.2 | salesAmount | 销售额 | number | 0 | Required | 销售额 |
| 7.4.6.5.3 | salesPrice | 优惠价 | number | 0 | Required | 优惠价 |
| 7.4.6.5.4 | salesVolume | 销量 | number | 0 | Required | 销量 |
| 7.4.6.6 | regionName | 国家/地区名 | string | — | Required | 国家/地区名 |
| 7.4.6.7 | sellerSku | sellerSku | string | — | Required | seller_sku |
| 7.4.6.8 | smallImageUrl | 商品缩略图 | string | — | Required | 商品缩略图 |
| 7.4.6.9 | storeId | 店铺id | number | 0 | Required | 店铺id |
| 7.4.6.10 | storeName | 店铺名 | string | — | Required | 店铺名 |
| 7.4.7 | size | size | number | 0 | Required | |
| 7.4.8 | total | total | number | 0 | Required | |
| 7.5 | orderPage | 管理促销涉及的订单信息 | object | — | Required | 管理促销涉及的订单信息 |
| 7.5.1 | current | current | number | 0 | Required | |
| 7.5.2 | currentSize | currentSize | number | 0 | Required | |
| 7.5.3 | hasNextPage | hasNextPage | boolean | true | Required | |
| 7.5.4 | hasPreviousPage | hasPreviousPage | boolean | true | Required | |
| 7.5.5 | pageCount | pageCount | number | 0 | Required | |
| 7.5.6 | records | records | array<object> | 详见返回成功示例 | Required | |
| 7.5.6.1 | amazonOrderId | 亚马逊订单号 | string | — | Required | 亚马逊订单号 |
| 7.5.6.2 | currencyIcon | 货币icon | string | — | Required | 货币icon |
| 7.5.6.3 | orderItems | 订单商品信息 | array<object> | [{"asin":"","asinUrl":"","itemName":"","localName":"","localSku":"","promotionId":"","sellerSku":"","smallImageUrl":""}] | Required | 订单商品信息 |
| 7.5.6.3.1 | asin | asin | string | — | Required | asin |
| 7.5.6.3.2 | asinUrl | asin跳转亚马逊前台链接 | string | — | Required | asin跳转亚马逊前台链接 |
| 7.5.6.3.3 | itemName | 商品标题 | string | — | Required | 商品标题 |
| 7.5.6.3.4 | localName | 品名 | string | — | Required | 品名 |
| 7.5.6.3.5 | localSku | localSku | string | — | Required | localSku |
| 7.5.6.3.6 | promotionId | 促销ID | string | — | Required | 促销ID |
| 7.5.6.3.7 | sellerSku | sellerSku | string | — | Required | seller_sku |
| 7.5.6.3.8 | smallImageUrl | 商品缩略图 | string | — | Required | 商品缩略图 |
| 7.5.6.4 | orderStatus | 订单状态 | string | — | Required | 订单状态 |
| 7.5.6.5 | orderTotalAmount | 订单总金额 | number | 0 | Required | 订单总金额 |
| 7.5.6.6 | purchaseDate | 订购时间 | string | — | Required | 订购时间 |
| 7.5.6.7 | regionName | 国家/地区名 | string | — | Required | 国家/地区名 |
| 7.5.6.8 | storeId | 店铺id | number | 0 | Required | 店铺id |
| 7.5.6.9 | storeName | 店铺名 | string | — | Required | 店铺名 |
| 7.5.7 | size | size | number | 0 | Required | |
| 7.5.8 | total | total | number | 0 | Required |
The 查询管理促销详情+listing+订单(批量) API (/promotionApi/open/promotion/managementAllDetailBatch) 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.