轻易云
注册体验

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

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
销售 / 促销管理 · POST · 请求参数 7 个(必填 7) · 响应参数 84 个 · 限流令牌桶容量 1
更新日期
2026-11-21

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

POST/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
        }
      }
    ]
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1itemListitemListarray<object>—必填批量请求详情itemList个数最小为1最大为20
1.1promotionId活动idstring—必填活动id
1.2storeId店铺idstring—必填店铺id
1.3orderPageNum活动订单分页页数number—必填活动订单分页页数,最小1
1.4orderPageSize活动订单分页大小number—必填活动订单分页大小,最小为1,最大为200
1.5listingPageNum活动listing分页页数number—必填活动listing分页页数,最小1
1.6listingPageSize活动listing分页大小number—必填活动listing分页大小,最小为1,最大为200

接口响应参数

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

领星ERP的接口:查询管理促销详情+listing+订单(批量)(/promotionApi/open/promotion/managementAllDetailBatch),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。