轻易云
注册体验

领星ERP查询商品折扣详情 - 列表 - 会员折扣接口

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

查询商品折扣详情 - 列表 - 会员折扣

POST/basicOpen/promotion/listingDetailPrimeDiscount
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/promotion/listingDetailPrimeDiscount"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "requestExample": {
    "sellerSku": "a_test_sku_x3",
    "promotionType": [],
    "status": [],
    "storeId": "43",
    "startTime": "2025-01-07",
    "endTime": "2025-03-17",
    "sortField": "startTime",
    "sortType": "desc",
    "pageNum": 1,
    "pageSize": 20
  },
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "fe02741c80d3418bb2ebebaacd2a4728.1752196754425",
    "response_time": "2025-07-11 09:19:20",
    "data": {
      "total": 3,
      "size": 20,
      "pageCount": 1,
      "current": 1,
      "currentSize": 3,
      "hasNextPage": false,
      "hasPreviousPage": false,
      "records": [
        {
          "promotionId": "0be5992b-cad8-4c9a-b104-c3980ecdf691",
          "customerTarget": "PRIME_EXCLUSIVE",
          "name": "会员折扣测试-固定折扣",
          "storeId": "43",
          "storeName": "uboss-US",
          "regionName": "美国",
          "currencyIcon": "$",
          "status": 1,
          "statusText": "进行中",
          "errorCount": "0",
          "originStatus": "RUNNING",
          "originStatusText": "生效中",
          "productQuantity": 0,
          "promotionStartTime": "2025-01-07 00:30:32",
          "promotionStartTimeUtc": null,
          "promotionEndTime": "2025-03-17 00:30:32",
          "salesVolume": 2,
          "salesAmount": 21,
          "salesAmountUsd": 21,
          "pageView": "200",
          "exchangeRate": 1,
          "firstSyncTime": "2025-02-28 16:16:59",
          "lastSyncTime": "2025-02-28 16:16:59",
          "remark": "假数据"
        },
        {
          "promotionId": "0be5992b-cad8-4c9a-b104-c3980ecdf692",
          "customerTarget": "PRIME_EXCLUSIVE",
          "name": "会员折扣测试-百分比折扣",
          "storeId": "43",
          "storeName": "uboss-US",
          "regionName": "美国",
          "currencyIcon": "$",
          "status": 1,
          "statusText": "进行中",
          "errorCount": "0",
          "originStatus": "RUNNING",
          "originStatusText": "生效中",
          "productQuantity": 0,
          "promotionStartTime": "2025-01-07 00:30:32",
          "promotionStartTimeUtc": null,
          "promotionEndTime": "2025-03-17 00:30:32",
          "salesVolume": 1,
          "salesAmount": 28,
          "salesAmountUsd": 28,
          "pageView": "100",
          "exchangeRate": 1,
          "firstSyncTime": "2025-02-28 16:16:59",
          "lastSyncTime": "2025-02-28 16:16:59",
          "remark": "假数据"
        },
        {
          "promotionId": "0be5992b-cad8-4c9a-b104-c3980ecdf693",
          "customerTarget": "ALL CUSTOMERS",
          "name": "价格折扣测试-固定折扣",
          "storeId": "43",
          "storeName": "uboss-US",
          "regionName": "美国",
          "currencyIcon": "$",
          "status": 1,
          "statusText": "进行中",
          "errorCount": "0",
          "originStatus": "RUNNING",
          "originStatusText": "生效中",
          "productQuantity": 0,
          "promotionStartTime": "2025-01-07 00:30:32",
          "promotionStartTimeUtc": null,
          "promotionEndTime": "2025-03-17 00:30:32",
          "salesVolume": 2,
          "salesAmount": 21,
          "salesAmountUsd": 21,
          "pageView": "200",
          "exchangeRate": 1,
          "firstSyncTime": "2025-02-28 16:16:59",
          "lastSyncTime": "2025-02-28 16:16:59",
          "remark": "假数据"
        }
      ]
    },
    "total": 3
  }
}

接口请求参数

序号字段名称类型默认值必填描述
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请求idstringfe02741c80d3418bb2ebebaacd2a4728.1752196754425必填请求id
5response_time响应时间string2025-07-11 09:19:20必填响应时间
6data消息提示object—必填消息提示
6.1totaltotalnumber3必填
6.2sizesizenumber20必填
6.3pageCountpageCountnumber1必填
6.4currentcurrentnumber1必填
6.5currentSizecurrentSizenumber3必填
6.6hasNextPagehasNextPagebooleanfalse必填
6.7hasPreviousPagehasPreviousPagebooleanfalse必填
6.8recordsrecordsarray<object>—必填
6.8.1promotionId活动idstring0be5992b-cad8-4c9a-b104-c3980ecdf691必填活动id,唯一标识
6.8.2customerTargetcustomerTargetstringPRIME_EXCLUSIVE必填消费群体类型 PRIME_EXCLUSIVE会员折扣 ALL CUSTOMERS价格折扣
6.8.3name折扣名称string会员折扣测试-固定折扣必填折扣名称
6.8.4storeId店铺idstring43必填店铺id
6.8.5storeName店铺名stringuboss-US必填店铺名
6.8.6regionName国家/地区名string美国必填国家/地区名
6.8.7currencyIcon货币iconstring$必填货币icon
6.8.8status状态number1必填状态
6.8.9statusText状态string进行中必填状态
6.8.10errorCounterrorCount>0时string0必填errorCount>0时 ,代表“需要注意”状态
6.8.11originStatus促销活动平台状态stringRUNNING必填促销活动平台状态
6.8.12originStatusText促销活动平台状态string生效中必填促销活动平台状态
6.8.13productQuantity商品数量number0必填商品数量
6.8.14promotionStartTime活动开始时间(productQuantity)string2025-01-07 00:30:32必填活动开始时间(productQuantity)
6.8.15promotionStartTimeUtc活动开始时间UTCstringnull必填活动开始时间UTC
6.8.16promotionEndTime活动结束时间string2025-03-17 00:30:32必填活动结束时间
6.8.17salesVolume活动总销量number2必填活动总销量
6.8.18salesAmount活动总销售额number21必填活动总销售额
6.8.19salesAmountUsd活动总销售额number21必填活动总销售额,换算成美元
6.8.20pageView浏览量string200必填浏览量
6.8.21exchangeRate转化率number1必填转化率
6.8.22firstSyncTime首次同步时间string2025-02-28 16:16:59必填首次同步时间
6.8.23lastSyncTime最后同步时间string2025-02-28 16:16:59必填最后同步时间
6.8.24remark备注string假数据必填备注
7total总数number3必填总数

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

需要对接这个接口?

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