轻易云
注册体验

领星ERP查询商品折扣详情 - 列表 - 管理促销接口

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

查询商品折扣详情 - 列表 - 管理促销

POST/basicOpen/promotion/listingDetailManage
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/promotion/listingDetailManage"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": {
    "sellerSku": "31-250J-NKH6",
    "promotionType": [],
    "status": [],
    "storeId": "132",
    "startTime": "2023-01-01",
    "endTime": "2023-01-31",
    "sortField": "startTime",
    "sortType": "desc",
    "pageNum": 1,
    "pageSize": 20
  },
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "c6ed840963a24d3e9805ca03b269f51b.1752205194893",
    "response_time": "2025-07-11 11:40:01",
    "data": {
      "total": 1,
      "size": 20,
      "pageCount": 1,
      "current": 1,
      "currentSize": 1,
      "hasNextPage": false,
      "hasPreviousPage": false,
      "records": [
        {
          "promotionId": "VPC-6-14498719 Coupon",
          "name": "",
          "trackingId": "VPC-6-14498719 Coupon",
          "storeId": "132",
          "storeName": "feifan-JP1",
          "regionName": "日本",
          "currencyIcon": "JP¥",
          "status": 2,
          "statusText": "已过期",
          "originStatus": "EXPIRED",
          "originStatusText": "已过期",
          "promotionType": 0,
          "promotionTypeText": "未定义类型",
          "promotionCode": "",
          "promotionCodeType": null,
          "salesAmount": 0,
          "salesAmountUsd": 0,
          "salesVolume": 0,
          "participateCondition": "",
          "participateConditionNum": 0,
          "buyerGets": "",
          "buyerGetsNum": 0,
          "purchaseProduct": "",
          "discountProduct": "",
          "excludeProduct": "",
          "exchangeLimit": 0,
          "promotionStartTime": "2023-01-02 00:00:00",
          "promotionStartTimeUtc": null,
          "promotionEndTime": "2023-01-03 23:59:00",
          "firstSyncTime": "2023-03-06 18:15:41",
          "lastSyncTime": "2024-01-09 14:13:20",
          "remark": ""
        }
      ]
    },
    "total": 1
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1sellerSkuseller_sku(msku)string—必填seller_sku(msku)
2promotionType促销类型array<any>—可选促销类型
3status促销状态array<any>—可选促销状态
4storeId店铺idstring—必填店铺id
5startTime活动开始时间string—必填活动开始时间
6endTime活动结束时间string—必填活动结束时间
7sortField排序项("cost"string—必填排序项("cost", "drawQuantity", "exchangeQuantity", "exchangeRate","startTime","salesVolume","salesAmount","startTime")
8sortType排序类型 asc descstring—必填排序类型 asc desc
9pageNum分页页码number—必填分页页码
10pageSize分页大小number—必填分页大小

接口响应参数

序号字段名称类型默认值必填描述
1code消息提示number0必填消息提示
2message消息stringsuccess必填消息
3error_details错误信息array<any>[]必填错误信息
4request_id请求idstringc6ed840963a24d3e9805ca03b269f51b.1752205194893必填请求id
5response_time响应时间string2025-07-11 11:40:01必填响应时间
6datadataobject—必填
6.1totaltotalnumber1必填
6.2sizesizenumber20必填
6.3pageCountpageCountnumber1必填
6.4currentcurrentnumber1必填
6.5currentSizecurrentSizenumber1必填
6.6hasNextPagehasNextPagebooleanfalse必填
6.7hasPreviousPagehasPreviousPagebooleanfalse必填
6.8recordsrecordsarray<object>—必填
6.8.1promotionId活动idstringVPC-6-14498719 Coupon必填活动id,唯一标识
6.8.2name名称-内部描述string—必填名称-内部描述
6.8.3trackingId追踪编码stringVPC-6-14498719 Coupon必填追踪编码
6.8.4storeId店铺idstring132必填店铺id
6.8.5storeName店铺名stringfeifan-JP1必填店铺名
6.8.6regionName国家/地区名string日本必填国家/地区名
6.8.7currencyIcon货币iconstringJP¥必填货币icon
6.8.8status状态number2必填状态
6.8.9statusText状态string已过期必填状态
6.8.10originStatus促销活动平台状态stringEXPIRED必填促销活动平台状态
6.8.11originStatusText促销活动平台状态string已过期必填促销活动平台状态
6.8.12promotionType促销类型number0必填促销类型
6.8.13promotionTypeText促销类型string未定义类型必填促销类型
6.8.14promotionCode优惠码string—必填优惠码
6.8.15promotionCodeType优惠码类型stringnull必填优惠码类型,1优先型,2无限型
6.8.16salesAmount活动总销售额number0必填活动总销售额
6.8.17salesAmountUsd活动总销售额number0必填活动总销售额,换算成美元
6.8.18salesVolume活动总销量number0必填活动总销量
6.8.19participateCondition参与条件string—必填参与条件
6.8.20participateConditionNum参与条件数值number0必填参与条件数值
6.8.21buyerGets买家获得string—必填买家获得
6.8.22buyerGetsNum买家获得值number0必填买家获得值
6.8.23purchaseProduct需购买商品string—必填需购买商品
6.8.24discountProduct优惠商品string—必填优惠商品
6.8.25excludeProduct排除商品string—必填排除商品
6.8.26exchangeLimit是否限制兑换number0必填是否限制兑换,1是0否
6.8.27promotionStartTime活动开始时间string2023-01-02 00:00:00必填活动开始时间
6.8.28promotionStartTimeUtc活动开始时间Utcstringnull必填活动开始时间Utc
6.8.29promotionEndTime活动结束时间string2023-01-03 23:59:00必填活动结束时间
6.8.30firstSyncTime首次同步时间string2023-03-06 18:15:41必填首次同步时间
6.8.31lastSyncTime最后同步时间string2024-01-09 14:13:20必填最后同步时间
6.8.32remark备注string—必填备注
7totaltotalnumber1必填

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

需要对接这个接口?

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