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) · 响应参数 25 个 · 限流令牌桶容量 1
Updated At
2026-11-21

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

POST/basicOpen/promotionalActivities/coupon/list
Factory
{
  "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": ""
      }
    ]
  }
}

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

The 查询促销活动列表 - 优惠券 API (/basicOpen/promotionalActivities/coupon/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.