Qeasy Cloud
Get Started

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

Platform
领星ERP
Type
WebAPI
Effect
QUERY
API Version
1.0
Adapter
\Adapter\LingXing\LXQueryAdapter
Auth Mode
OTHER
Description
销售 / 促销管理 · POST · 请求参数 7 个(必填 7) · 响应参数 84 个 · 限流令牌桶容量 1
Updated At
2026-11-21

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

POST/promotionApi/open/promotion/managementAllDetailBatch
Factory
{
  "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
        }
      }
    ]
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1itemListitemListarray<object>—Required批量请求详情itemList个数最小为1最大为20
1.1promotionId活动idstring—Required活动id
1.2storeId店铺idstring—Required店铺id
1.3orderPageNum活动订单分页页数number—Required活动订单分页页数,最小1
1.4orderPageSize活动订单分页大小number—Required活动订单分页大小,最小为1,最大为200
1.5listingPageNum活动listing分页页数number—Required活动listing分页页数,最小1
1.6listingPageSize活动listing分页大小number—Required活动listing分页大小,最小为1,最大为200

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code0成功number0Required0成功
2messagemessagestring—Required
3error_detailserror_detailsarray<any>—Optional
4request_idrequest_idstring—Required
5response_timeyyyy-MM-dd HHstring—Requiredyyyy-MM-dd HH:mm:ss
6totaltotalinteger—Required
7datadataarray<object>详见返回成功示例Required
7.1promotionId活动idstring—Required活动id
7.2storeId店铺idstring—Required店铺id
7.3management管理促销信息object—Required管理促销信息
7.3.1storeId店铺IDstring—Required店铺ID
7.3.2storeName店铺名称string—Required店铺名称
7.3.3regionName国家/地区名string—Required国家/地区名
7.3.4currencyIcon货币iconstring—Required货币icon
7.3.5promotionId活动idstring—Required活动id
7.3.6name名称string—Required名称
7.3.7statusstatusnumber0Required状态 0其他 1进行中 2已过期 3未开始 4已取消
7.3.8statusText状态说明string—Required状态说明
7.3.9originStatus促销活动平台状态string—Required促销活动平台状态
7.3.10promotionTypepromotionTypenumber0Required活动类型 0未定义 1Best Deal 2Lightning Deal 3买一赠一 4购买折扣 5一口价 6折扣 7金额 8社媒促销 9金额
7.3.11promotionTypeText活动类型说明string—Required活动类型说明
7.3.12promotionStartTime活动开始时间string—Required活动开始时间
7.3.13promotionEndTime活动结束时间string—Required活动结束时间
7.3.14promotionCode优惠码string—Required优惠码
7.3.15exchangeLimit是否限制兑换number0Required是否限制兑换,1是0否
7.3.16participateCondition兑换限制条件string—Required兑换限制条件
7.3.17buyerGets买家获得string—Required买家获得
7.3.18purchaseProduct需购买商品string—Required需购买商品
7.3.19discountProduct优惠商品string—Required优惠商品
7.3.20excludeProduct排除商品string—Required排除商品
7.3.21trackingId追踪编码string—Required追踪编码
7.3.22displayOnDetailPage是否显示在详情页number—Required是否显示在详情页,1是0否
7.3.23salesAmount活动总销售额number0Required活动总销售额
7.3.24salesVolume活动总销量number0Required活动总销量
7.3.25promotionPageLink营销页面链接string—Required营销页面链接
7.4listingPage管理促销涉及的Listing信息object—Required管理促销涉及的Listing信息
7.4.1currentcurrentnumber0Required
7.4.2currentSizecurrentSizenumber0Required
7.4.3hasNextPagehasNextPagebooleantrueRequired
7.4.4hasPreviousPagehasPreviousPagebooleantrueRequired
7.4.5pageCountpageCountnumber0Required
7.4.6recordsrecordsarray<object>详见返回成功示例Required
7.4.6.1asinasinstring—Requiredasin
7.4.6.2asinUrlasin跳转亚马逊前台链接string—Requiredasin跳转亚马逊前台链接
7.4.6.3currencyIcon货币iconstring—Required货币icon
7.4.6.4itemName商品标题string—Required商品标题
7.4.6.5management管理促销基本信息object—Required管理促销基本信息
7.4.6.5.1discountPrice折后价number0Required折后价
7.4.6.5.2salesAmount销售额number0Required销售额
7.4.6.5.3salesPrice优惠价number0Required优惠价
7.4.6.5.4salesVolume销量number0Required销量
7.4.6.6regionName国家/地区名string—Required国家/地区名
7.4.6.7sellerSkusellerSkustring—Requiredseller_sku
7.4.6.8smallImageUrl商品缩略图string—Required商品缩略图
7.4.6.9storeId店铺idnumber0Required店铺id
7.4.6.10storeName店铺名string—Required店铺名
7.4.7sizesizenumber0Required
7.4.8totaltotalnumber0Required
7.5orderPage管理促销涉及的订单信息object—Required管理促销涉及的订单信息
7.5.1currentcurrentnumber0Required
7.5.2currentSizecurrentSizenumber0Required
7.5.3hasNextPagehasNextPagebooleantrueRequired
7.5.4hasPreviousPagehasPreviousPagebooleantrueRequired
7.5.5pageCountpageCountnumber0Required
7.5.6recordsrecordsarray<object>详见返回成功示例Required
7.5.6.1amazonOrderId亚马逊订单号string—Required亚马逊订单号
7.5.6.2currencyIcon货币iconstring—Required货币icon
7.5.6.3orderItems订单商品信息array<object>[{"asin":"","asinUrl":"","itemName":"","localName":"","localSku":"","promotionId":"","sellerSku":"","smallImageUrl":""}]Required订单商品信息
7.5.6.3.1asinasinstring—Requiredasin
7.5.6.3.2asinUrlasin跳转亚马逊前台链接string—Requiredasin跳转亚马逊前台链接
7.5.6.3.3itemName商品标题string—Required商品标题
7.5.6.3.4localName品名string—Required品名
7.5.6.3.5localSkulocalSkustring—RequiredlocalSku
7.5.6.3.6promotionId促销IDstring—Required促销ID
7.5.6.3.7sellerSkusellerSkustring—Requiredseller_sku
7.5.6.3.8smallImageUrl商品缩略图string—Required商品缩略图
7.5.6.4orderStatus订单状态string—Required订单状态
7.5.6.5orderTotalAmount订单总金额number0Required订单总金额
7.5.6.6purchaseDate订购时间string—Required订购时间
7.5.6.7regionName国家/地区名string—Required国家/地区名
7.5.6.8storeId店铺idnumber0Required店铺id
7.5.6.9storeName店铺名string—Required店铺名
7.5.7sizesizenumber0Required
7.5.8totaltotalnumber0Required

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.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.