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 · 请求参数 10 个(必填 1) · 响应参数 42 个 · 限流令牌桶容量 1
Updated At
2026-11-21

查询商品折扣列表

POST/basicOpen/promotion/listingList
Factory
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/promotion/listingList"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "e320d07cd2b24dfd8e075677c0eee622.159.16982279070474519",
    "response_time": "2023-10-25 17:58:32",
    "data": [
      {
        "item_name": "Multifunctional short wallet antimagnetic wallet men's wallet",
        "sid": "119",
        "store_name": "uboss-US",
        "region_name": "美国",
        "currency_icon": "$",
        "small_image_url": "https://m.media-amazon.com/images/I/31geVbfb-UL._SL75_.jpg",
        "asin": "B09335DXBV",
        "asin_url": "https://www.amazon.com/dp/B0xxxxDXBV",
        "seller_sku": "BN-Q83M-S7I3",
        "promotion_list": [
          {
            "promotion_id": "f88a4358-695b-493d-81d5-9757b4afd715",
            "name": "Save $2 on 1115满减类型(优惠券) BV",
            "status": "0",
            "origin_status": "FAILED",
            "category": "1",
            "category_text": "优惠券",
            "promotion_type": "7",
            "promotion_type_text": "金额",
            "discount_price": "0.00",
            "discount_rate": "0.00",
            "promotion_start_time": "2022-11-15 00:00:00",
            "promotion_end_time": "2022-12-31 00:00:00"
          }
        ],
        "promotion_combo_num": "1",
        "sales_price": "8.11",
        "sales_price_usd": "8.10",
        "avg_deal_price": "0.00",
        "discount_price_min": "0.00",
        "discount_rate_rate": "0.00",
        "principal_list": [
          "jack"
        ],
        "listing_tags": [
          {
            "global_tag_id": "907202235307626941",
            "tag_name": "家电大卖",
            "color": "#5A8BF0"
          }
        ],
        "afn_fulfillable_quantity": "0",
        "quantity": "0"
      }
    ],
    "total": 1
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1site_date站点时间string—Required站点时间,格式:Y-m-d
2start_time开始时间【活动时间】string—Optional开始时间【活动时间】,双闭区间,格式:Y-m-d,时间间隔最长不超过90天
3end_time结束时间【活动时间】string—Optional结束时间【活动时间】,双闭区间,格式:Y-m-d,时间间隔最长不超过90天
4offset分页偏移量integer—Optional分页偏移量,默认0
5length分页长度integer—Optional分页长度,默认20,上限200
6is_overlay是否优惠叠加integer—Optional是否优惠叠加: 0 否 1 是
7sids店铺idarray<any>—Optional店铺id ,对应查询亚马逊店铺列表接口对应字段【sid】
8status促销状态array<any>—Optional促销状态: 0 其他 1 进行中 2 已过期 3 未开始
9product_status商品状态array<any>—Optional商品状态: -1 已删除 0 停售 1 在售
10promotion_category促销类型array<any>—Optional促销类型: 1 优惠券 2 秒杀 3 管理促销 4 会员折扣

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0 成功
2message消息提示stringsuccessRequired消息提示
3error_details错误信息array<any>—Required错误信息
4request_id请求链路idstringC3D9F541-8083-E376-EB5C-606A872F5C89Required请求链路id
5response_time响应时间string2022-12-08 18:27:13Required响应时间
6total总数integer0Required总数
7data响应数据array<object>—Required响应数据
7.1item_name商品标题stringwallet men's walletRequired商品标题
7.2sid店铺idstring119Required店铺id
7.3store_name店铺名称stringuboss-USRequired店铺名称
7.4region_name国家/地区string美国Required国家/地区
7.5currency_icon货币符号string$Required货币符号
7.6small_image_url商品缩略图地址stringhttps://xxx.com/75.jpgRequired商品缩略图地址
7.7asinasinstringB0xxxxDXBVRequiredASIN
7.8asin_urlASIN跳转地址stringhttps://www.amazon.com/dp/B0xxxxDXBVRequiredASIN跳转地址
7.9seller_skuseller_skustringBN-Q83M-S7I3RequiredMSKU
7.10promotion_list商品优惠券array<object>—Required商品优惠券
7.10.1promotion_id优惠券idstringf88a4358-695b-493d-81d5-9757b4afd715Required优惠券id
7.10.2name优惠券名称stringSave $2 on 1115满减类型(优惠券) BVRequired优惠券名称
7.10.3status优惠券状态string0Required优惠券状态: 0 其他 1 进行中 2 已过期 3 未开始
7.10.4origin_status优惠券平台原始状态stringFAILEDRequired优惠券平台原始状态
7.10.5category促销活动类别string1Required促销活动类别: 1 优惠券 2 秒杀 3 管理促销 4 促销折扣
7.10.6category_text促销活动类型说明string优惠券Required促销活动类型说明
7.10.7promotion_type促销类型string7Required促销类型
7.10.8promotion_type_text促销类型说明string金额Required促销类型说明
7.10.9discount_price折扣价格string0.00Required折扣价格
7.10.10discount_rate折扣率string0.00Required折扣率
7.10.11promotion_start_time促销开始时间string2022-11-15 00:00:00Required促销开始时间
7.10.12promotion_end_time促销结束时间string2022-12-31 00:00:00Required促销结束时间
7.11promotion_combo_num折扣叠加数量integer1Required折扣叠加数量
7.12sales_price优惠价string8.11Required优惠价
7.13sales_price_usd优惠券【美元】string8.10Required优惠券【美元】
7.14avg_deal_price平均成交价string0.00Required平均成交价
7.15discount_price_min最低折扣价string0.00Required最低折扣价
7.16discount_rate_rate最低折扣率string0.00Required最低折扣率
7.17principal_listlisting负责人array<any>["jack"]Requiredlisting负责人
7.18listing_tagslisting标签列表string—Requiredlisting标签列表
7.18.1global_tag_id标签idstring907202235307626941Required标签id
7.18.2tag_name标签名string条目Required标签名
7.18.3color标签颜色string#5A8BF0Required标签颜色
7.19afn_fulfillable_quantityFBA可售string0RequiredFBA可售
7.20quantityFBM可售string0RequiredFBM可售

The 查询商品折扣列表 API (/basicOpen/promotion/listingList) 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.