/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
}
}
]
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | itemList | itemList | array<object> | — | 必填 | 批量请求详情itemList个数最小为1最大为20 |
| 1.1 | promotionId | 活动id | string | — | 必填 | 活动id |
| 1.2 | storeId | 店铺id | string | — | 必填 | 店铺id |
| 1.3 | orderPageNum | 活动订单分页页数 | number | — | 必填 | 活动订单分页页数,最小1 |
| 1.4 | orderPageSize | 活动订单分页大小 | number | — | 必填 | 活动订单分页大小,最小为1,最大为200 |
| 1.5 | listingPageNum | 活动listing分页页数 | number | — | 必填 | 活动listing分页页数,最小1 |
| 1.6 | listingPageSize | 活动listing分页大小 | number | — | 必填 | 活动listing分页大小,最小为1,最大为200 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 0成功 | number | 0 | 必填 | 0成功 |
| 2 | message | message | string | — | 必填 | |
| 3 | error_details | error_details | array<any> | — | 可选 | |
| 4 | request_id | request_id | string | — | 必填 | |
| 5 | response_time | yyyy-MM-dd HH | string | — | 必填 | yyyy-MM-dd HH:mm:ss |
| 6 | total | total | integer | — | 必填 | |
| 7 | data | data | array<object> | 详见返回成功示例 | 必填 | |
| 7.1 | promotionId | 活动id | string | — | 必填 | 活动id |
| 7.2 | storeId | 店铺id | string | — | 必填 | 店铺id |
| 7.3 | management | 管理促销信息 | object | — | 必填 | 管理促销信息 |
| 7.3.1 | storeId | 店铺ID | string | — | 必填 | 店铺ID |
| 7.3.2 | storeName | 店铺名称 | string | — | 必填 | 店铺名称 |
| 7.3.3 | regionName | 国家/地区名 | string | — | 必填 | 国家/地区名 |
| 7.3.4 | currencyIcon | 货币icon | string | — | 必填 | 货币icon |
| 7.3.5 | promotionId | 活动id | string | — | 必填 | 活动id |
| 7.3.6 | name | 名称 | string | — | 必填 | 名称 |
| 7.3.7 | status | status | number | 0 | 必填 | 状态 0其他 1进行中 2已过期 3未开始 4已取消 |
| 7.3.8 | statusText | 状态说明 | string | — | 必填 | 状态说明 |
| 7.3.9 | originStatus | 促销活动平台状态 | string | — | 必填 | 促销活动平台状态 |
| 7.3.10 | promotionType | promotionType | number | 0 | 必填 | 活动类型 0未定义 1Best Deal 2Lightning Deal 3买一赠一 4购买折扣 5一口价 6折扣 7金额 8社媒促销 9金额 |
| 7.3.11 | promotionTypeText | 活动类型说明 | string | — | 必填 | 活动类型说明 |
| 7.3.12 | promotionStartTime | 活动开始时间 | string | — | 必填 | 活动开始时间 |
| 7.3.13 | promotionEndTime | 活动结束时间 | string | — | 必填 | 活动结束时间 |
| 7.3.14 | promotionCode | 优惠码 | string | — | 必填 | 优惠码 |
| 7.3.15 | exchangeLimit | 是否限制兑换 | number | 0 | 必填 | 是否限制兑换,1是0否 |
| 7.3.16 | participateCondition | 兑换限制条件 | string | — | 必填 | 兑换限制条件 |
| 7.3.17 | buyerGets | 买家获得 | string | — | 必填 | 买家获得 |
| 7.3.18 | purchaseProduct | 需购买商品 | string | — | 必填 | 需购买商品 |
| 7.3.19 | discountProduct | 优惠商品 | string | — | 必填 | 优惠商品 |
| 7.3.20 | excludeProduct | 排除商品 | string | — | 必填 | 排除商品 |
| 7.3.21 | trackingId | 追踪编码 | string | — | 必填 | 追踪编码 |
| 7.3.22 | displayOnDetailPage | 是否显示在详情页 | number | — | 必填 | 是否显示在详情页,1是0否 |
| 7.3.23 | salesAmount | 活动总销售额 | number | 0 | 必填 | 活动总销售额 |
| 7.3.24 | salesVolume | 活动总销量 | number | 0 | 必填 | 活动总销量 |
| 7.3.25 | promotionPageLink | 营销页面链接 | string | — | 必填 | 营销页面链接 |
| 7.4 | listingPage | 管理促销涉及的Listing信息 | object | — | 必填 | 管理促销涉及的Listing信息 |
| 7.4.1 | current | current | number | 0 | 必填 | |
| 7.4.2 | currentSize | currentSize | number | 0 | 必填 | |
| 7.4.3 | hasNextPage | hasNextPage | boolean | true | 必填 | |
| 7.4.4 | hasPreviousPage | hasPreviousPage | boolean | true | 必填 | |
| 7.4.5 | pageCount | pageCount | number | 0 | 必填 | |
| 7.4.6 | records | records | array<object> | 详见返回成功示例 | 必填 | |
| 7.4.6.1 | asin | asin | string | — | 必填 | asin |
| 7.4.6.2 | asinUrl | asin跳转亚马逊前台链接 | string | — | 必填 | asin跳转亚马逊前台链接 |
| 7.4.6.3 | currencyIcon | 货币icon | string | — | 必填 | 货币icon |
| 7.4.6.4 | itemName | 商品标题 | string | — | 必填 | 商品标题 |
| 7.4.6.5 | management | 管理促销基本信息 | object | — | 必填 | 管理促销基本信息 |
| 7.4.6.5.1 | discountPrice | 折后价 | number | 0 | 必填 | 折后价 |
| 7.4.6.5.2 | salesAmount | 销售额 | number | 0 | 必填 | 销售额 |
| 7.4.6.5.3 | salesPrice | 优惠价 | number | 0 | 必填 | 优惠价 |
| 7.4.6.5.4 | salesVolume | 销量 | number | 0 | 必填 | 销量 |
| 7.4.6.6 | regionName | 国家/地区名 | string | — | 必填 | 国家/地区名 |
| 7.4.6.7 | sellerSku | sellerSku | string | — | 必填 | seller_sku |
| 7.4.6.8 | smallImageUrl | 商品缩略图 | string | — | 必填 | 商品缩略图 |
| 7.4.6.9 | storeId | 店铺id | number | 0 | 必填 | 店铺id |
| 7.4.6.10 | storeName | 店铺名 | string | — | 必填 | 店铺名 |
| 7.4.7 | size | size | number | 0 | 必填 | |
| 7.4.8 | total | total | number | 0 | 必填 | |
| 7.5 | orderPage | 管理促销涉及的订单信息 | object | — | 必填 | 管理促销涉及的订单信息 |
| 7.5.1 | current | current | number | 0 | 必填 | |
| 7.5.2 | currentSize | currentSize | number | 0 | 必填 | |
| 7.5.3 | hasNextPage | hasNextPage | boolean | true | 必填 | |
| 7.5.4 | hasPreviousPage | hasPreviousPage | boolean | true | 必填 | |
| 7.5.5 | pageCount | pageCount | number | 0 | 必填 | |
| 7.5.6 | records | records | array<object> | 详见返回成功示例 | 必填 | |
| 7.5.6.1 | amazonOrderId | 亚马逊订单号 | string | — | 必填 | 亚马逊订单号 |
| 7.5.6.2 | currencyIcon | 货币icon | string | — | 必填 | 货币icon |
| 7.5.6.3 | orderItems | 订单商品信息 | array<object> | [{"asin":"","asinUrl":"","itemName":"","localName":"","localSku":"","promotionId":"","sellerSku":"","smallImageUrl":""}] | 必填 | 订单商品信息 |
| 7.5.6.3.1 | asin | asin | string | — | 必填 | asin |
| 7.5.6.3.2 | asinUrl | asin跳转亚马逊前台链接 | string | — | 必填 | asin跳转亚马逊前台链接 |
| 7.5.6.3.3 | itemName | 商品标题 | string | — | 必填 | 商品标题 |
| 7.5.6.3.4 | localName | 品名 | string | — | 必填 | 品名 |
| 7.5.6.3.5 | localSku | localSku | string | — | 必填 | localSku |
| 7.5.6.3.6 | promotionId | 促销ID | string | — | 必填 | 促销ID |
| 7.5.6.3.7 | sellerSku | sellerSku | string | — | 必填 | seller_sku |
| 7.5.6.3.8 | smallImageUrl | 商品缩略图 | string | — | 必填 | 商品缩略图 |
| 7.5.6.4 | orderStatus | 订单状态 | string | — | 必填 | 订单状态 |
| 7.5.6.5 | orderTotalAmount | 订单总金额 | number | 0 | 必填 | 订单总金额 |
| 7.5.6.6 | purchaseDate | 订购时间 | string | — | 必填 | 订购时间 |
| 7.5.6.7 | regionName | 国家/地区名 | string | — | 必填 | 国家/地区名 |
| 7.5.6.8 | storeId | 店铺id | number | 0 | 必填 | 店铺id |
| 7.5.6.9 | storeName | 店铺名 | string | — | 必填 | 店铺名 |
| 7.5.7 | size | size | number | 0 | 必填 | |
| 7.5.8 | total | total | number | 0 | 必填 |
领星ERP的接口:查询管理促销详情+listing+订单(批量)(/promotionApi/open/promotion/managementAllDetailBatch),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。