Lingxing
切换旧版

查询管理促销详情+listing+订单(批量)

POST/promotionApi/open/promotion/managementAllDetailBatch

接口信息

API Path请求协议请求方式令牌桶容量
/promotionApi/open/promotion/managementAllDetailBatchHTTPSPOST1

请求参数

itemListarray<object>必填
批量请求详情itemList个数最小为1最大为20
隐藏子属性
promotionIdstring必填
活动id
storeIdstring必填
店铺id
orderPageNumnumber必填
活动订单分页页数，最小1
orderPageSizenumber必填
活动订单分页大小，最小为1，最大为200
listingPageNumnumber必填
活动listing分页页数，最小1
listingPageSizenumber必填
活动listing分页大小，最小为1，最大为200

请求示例

{
  "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
    }
  ]
}

返回结果

Json Object

codenumber必填
0成功
示例 0
messagestring必填
error_detailsarray<any>
request_idstring必填
response_timestring必填
yyyy-MM-dd HH:mm:ss
totalinteger必填
dataarray<object>必填
示例 详见返回成功示例
隐藏子属性
promotionIdstring必填
活动id
storeIdstring必填
店铺id
managementobject必填
管理促销信息
隐藏子属性
storeIdstring必填
店铺ID
storeNamestring必填
店铺名称
regionNamestring必填
国家/地区名
currencyIconstring必填
货币icon
promotionIdstring必填
活动id
namestring必填
名称
statusnumber必填
状态 0其他 1进行中 2已过期 3未开始 4已取消
示例 0
statusTextstring必填
状态说明
originStatusstring必填
促销活动平台状态
promotionTypenumber必填
活动类型 0未定义 1Best Deal 2Lightning Deal 3买一赠一 4购买折扣 5一口价 6折扣 7金额 8社媒促销 9金额
示例 0
promotionTypeTextstring必填
活动类型说明
promotionStartTimestring必填
活动开始时间
promotionEndTimestring必填
活动结束时间
promotionCodestring必填
优惠码
exchangeLimitnumber必填
是否限制兑换，1是0否
示例 0
participateConditionstring必填
兑换限制条件
buyerGetsstring必填
买家获得
purchaseProductstring必填
需购买商品
discountProductstring必填
优惠商品
excludeProductstring必填
排除商品
trackingIdstring必填
追踪编码
displayOnDetailPagenumber必填
是否显示在详情页，1是0否
salesAmountnumber必填
活动总销售额
示例 0
salesVolumenumber必填
活动总销量
示例 0
promotionPageLinkstring必填
营销页面链接
listingPageobject必填
管理促销涉及的Listing信息
隐藏子属性
currentnumber必填
示例 0
currentSizenumber必填
示例 0
hasNextPageboolean必填
示例 true
hasPreviousPageboolean必填
示例 true
pageCountnumber必填
示例 0
recordsarray<object>必填
示例 详见返回成功示例
隐藏子属性
asinstring必填
asin
asinUrlstring必填
asin跳转亚马逊前台链接
currencyIconstring必填
货币icon
itemNamestring必填
商品标题
managementobject必填
管理促销基本信息
隐藏子属性
discountPricenumber必填
折后价
示例 0
salesAmountnumber必填
销售额
示例 0
salesPricenumber必填
优惠价
示例 0
salesVolumenumber必填
销量
示例 0
regionNamestring必填
国家/地区名
sellerSkustring必填
seller_sku
smallImageUrlstring必填
商品缩略图
storeIdnumber必填
店铺id
示例 0
storeNamestring必填
店铺名
sizenumber必填
示例 0
totalnumber必填
示例 0
orderPageobject必填
管理促销涉及的订单信息
隐藏子属性
currentnumber必填
示例 0
currentSizenumber必填
示例 0
hasNextPageboolean必填
示例 true
hasPreviousPageboolean必填
示例 true
pageCountnumber必填
示例 0
recordsarray<object>必填
示例 详见返回成功示例
隐藏子属性
amazonOrderIdstring必填
亚马逊订单号
currencyIconstring必填
货币icon
orderItemsarray<object>必填
订单商品信息
示例 [{"asin":"","asinUrl":"","itemName":"","localName":"","localSku":"","promotionId":"","sellerSku":"","smallImageUrl":""}]
隐藏子属性
asinstring必填
asin
asinUrlstring必填
asin跳转亚马逊前台链接
itemNamestring必填
商品标题
localNamestring必填
品名
localSkustring必填
localSku
promotionIdstring必填
促销ID
sellerSkustring必填
seller_sku
smallImageUrlstring必填
商品缩略图
orderStatusstring必填
订单状态
orderTotalAmountnumber必填
订单总金额
示例 0
purchaseDatestring必填
订购时间
regionNamestring必填
国家/地区名
storeIdnumber必填
店铺id
示例 0
storeNamestring必填
店铺名
sizenumber必填
示例 0
totalnumber必填
示例 0

返回成功示例

{
  "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.50,
        "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.80,
              "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.70,
              "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
      }
    }
  ]
}