轻易云
注册体验

领星ERP查询商品折扣列表接口

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

查询商品折扣列表

POST/basicOpen/promotion/listingList
加工厂
{
  "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
  }
}

接口请求参数

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

接口响应参数

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

领星ERP的接口:查询商品折扣列表(/basicOpen/promotion/listingList),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

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