Qeasy Cloud
Get Started

领星ERP 查询促销活动列表 - 管理促销 API

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

查询促销活动列表 - 管理促销

POST/basicOpen/promotionalActivities/manage/list
Factory
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/promotionalActivities/manage/list"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "90930764718445a4af61b88a655ef10b.1694510506428",
    "response_time": "2023-09-12 17:21:47",
    "data": [
      {
        "name": "sss测试",
        "sid": 31,
        "promotion_type": 4,
        "currency_icon": "JP¥",
        "origin_status": "EXPIRED",
        "promotion_code": "不需要",
        "sales_amount": "0.00",
        "sales_volume": "0",
        "participate_condition": "At least this quantity of items\n80",
        "participate_condition_num": "80",
        "buyer_gets": "Percent off\n1",
        "buyer_gets_num": "1",
        "purchase_product": "测试1",
        "discount_product": "测试1",
        "exclude_product": "",
        "exchange_limit": "0",
        "promotion_start_time": "2023-01-10 10:00:00",
        "promotion_end_time": "2023-01-10 23:59:00",
        "first_sync_time": "2023-02-22 11:53:04",
        "last_sync_time": "2023-02-23 17:34:32",
        "remark": ""
      }
    ],
    "total": 1
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1start_date开始日期【活动时间】string—Optional开始日期【活动时间】,站点时间,闭区间,格式:Y-m-d,时间间隔最长不超过90天
2end_date结束日期【活动时间】string—Optional结束日期【活动时间】,站点时间,闭区间,格式:Y-m-d,时间间隔最长不超过90天
3sids店铺idarray<any>—Optional店铺id ,对应查询亚马逊店铺列表接口对应字段【sid】
4offset分页偏移量integer—Optional分页偏移量,默认0
5length分页长度integer—Optional分页长度,默认20,上限200

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0 成功
2message消息提示stringsuccessRequired消息提示
3error_details错误信息array<any>—Required错误信息
4request_id请求链路idstring77ac259a67d5462594c83b80669b6eae.1692331008758Required请求链路id
5response_time响应时间string2023-08-18 11:56:49Required响应时间
6total总数integer200Required总数
7data响应数据array<object>—Required响应数据
7.1promotion_id促销活动idstring—Required促销活动id
7.2name内部描述stringSave $1 on swi... VPC-1-138675244 CouponRequired内部描述
7.3sid店铺idinteger2Required店铺id
7.4promotion_type活动类型integer4Required活动类型: 3 买一赠一 4 购买折扣 5 一口价 8 社媒促销
7.5currency_icon货币iconstring—Required货币icon
7.6origin_status活动状态stringEXPIREDRequired活动状态: ACTIVE 进行中 CANCELED 已取消 EXPIRED 已过期 PENDING 未开始
7.7promotion_code优惠码string不需要Required优惠码
7.8sales_amount活动总销售额string0Required活动总销售额
7.9sales_volume活动总销量string0Required活动总销量
7.10participate_condition参与条件stringAt least this quantity of items\n80Required参与条件
7.11participate_condition_num参与条件数值string0Required参与条件数值
7.12buyer_gets买家获得stringPercent off\n1Required买家获得
7.13buyer_gets_num买家获得值string0Required买家获得值
7.14purchase_product需购买商品string足球Required需购买商品
7.15discount_product优惠商品string计算机Required优惠商品
7.16exclude_product排除商品string遥控器Required排除商品
7.17exchange_limit是否限制兑换integer0Required是否限制兑换: 1 是 0 否
7.18promotion_start_time活动开始时间【站点时间】string2022-08-26 02:00:00Required活动开始时间【站点时间】
7.19promotion_end_time活动结束时间【站点时间】string2022-08-26 23:00:59Required活动结束时间【站点时间】
7.20first_sync_time首次同步时间【站点时间】string2022-10-11 10:17:26Required首次同步时间【站点时间】
7.21last_sync_time最后同步时间【站点时间】string2022-10-11 10:17:26Required最后同步时间【站点时间】
7.22remark备注string—Required备注

The 查询促销活动列表 - 管理促销 API (/basicOpen/promotionalActivities/manage/list) 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.