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

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

POST/basicOpen/promotion/listingDetailManage
Factory
{
  "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
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1sellerSkuseller_sku(msku)string—Requiredseller_sku(msku)
2promotionType促销类型array<any>—Optional促销类型
3status促销状态array<any>—Optional促销状态
4storeId店铺idstring—Required店铺id
5startTime活动开始时间string—Required活动开始时间
6endTime活动结束时间string—Required活动结束时间
7sortField排序项("cost"string—Required排序项("cost", "drawQuantity", "exchangeQuantity", "exchangeRate","startTime","salesVolume","salesAmount","startTime")
8sortType排序类型 asc descstring—Required排序类型 asc desc
9pageNum分页页码number—Required分页页码
10pageSize分页大小number—Required分页大小

Response Parameters

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

The 查询商品折扣详情 - 列表 - 管理促销 API (/basicOpen/promotion/listingDetailManage) 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.