轻易云
注册体验

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

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

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

POST/basicOpen/promotionalActivities/manage/list
加工厂
{
  "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
  }
}

接口请求参数

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

接口响应参数

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

领星ERP的接口:查询促销活动列表 - 管理促销(/basicOpen/promotionalActivities/manage/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

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