轻易云
注册体验

领星ERP查询促销活动列表 - 优惠券接口

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

查询促销活动列表 - 优惠券

POST/basicOpen/promotionalActivities/coupon/list
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/promotionalActivities/coupon/list"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "067547ee9d7b437d8247d0117bbb3234.1694486464787",
    "response_time": "2023-09-12 10:41:06",
    "total": 2553,
    "data": [
      {
        "name": "表示価格より ¥11 OFF c23085",
        "sid": 31,
        "currency_icon": "JP¥",
        "origin_status": "FAILED",
        "discount": "JP¥11.00",
        "budget": "JP¥10084.0",
        "cost": "0.00",
        "draw_quantity": "0",
        "exchange_quantity": "0",
        "exchange_rate": "0.00",
        "sales_amount": "0.00",
        "sales_volume": "0",
        "promotion_start_time": "2023-04-08 00:00:00",
        "promotion_end_time": "2023-04-09 00:00:00",
        "first_sync_time": "2023-08-22 11:30:27",
        "last_sync_time": "2023-08-22 11:30:27",
        "remark": ""
      }
    ]
  }
}

接口请求参数

序号字段名称类型默认值必填描述
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优惠券名称stringnnn必填优惠券名称
7.3sid店铺idinteger2必填店铺id
7.4currency_icon货币iconstringJP¥必填货币icon
7.5origin_status活动状态stringFAILED必填活动状态: ACTIVE 进行中 CANCELED 已取消 EXPIRED 已过期 RUNNING 生效中 NEEDS ACTION 需要注意 EXPIRING SOON 即将过期 SUBMITTED 已提交 FAILED 失败
7.6discount折扣stringJP¥11.00必填折扣
7.7budget预算stringJP¥10084.0必填预算
7.8cost支出string0必填支出
7.9draw_quantity领取数string0必填领取数
7.10exchange_quantity兑换数string0必填兑换数
7.11exchange_rate兑换率string15必填兑换率
7.12sales_amount活动总销售额string0必填活动总销售额
7.13sales_volume活动总销量string0必填活动总销量
7.14promotion_start_time活动开始时间【站点时间】string2022-10-14 14:16:48必填活动开始时间【站点时间】
7.15promotion_end_time活动结束时间【站点时间】string2022-10-14 14:17:01必填活动结束时间【站点时间】
7.16first_sync_time首次同步时间【站点时间】string2022-10-14 14:17:34必填首次同步时间【站点时间】
7.17last_sync_time最后同步时间【站点时间】string2022-10-14 14:17:37必填最后同步时间【站点时间】
7.18remark备注stringremark必填备注

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

需要对接这个接口?

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