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) · 响应参数 41 个
Updated At
2026-11-21

查询商品折扣详情 - 列表 - 优惠券

POST/basicOpen/promotion/listingDetailCoupon
Factory
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/promotion/listingDetailCoupon"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "requestExample": {
    "sellerSku": "7T-2COF-AV9I",
    "promotionType": [],
    "status": [],
    "storeId": "43",
    "startTime": "2024-09-10",
    "endTime": "2024-09-12",
    "sortField": "startTime",
    "sortType": "desc",
    "pageNum": 1,
    "pageSize": 20
  },
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "9ed6f7bca84d4768a1c374ef8865e263.1752196903523",
    "response_time": "2025-07-11 09:21:44",
    "data": {
      "total": 1,
      "size": 20,
      "pageCount": 1,
      "current": 1,
      "currentSize": 1,
      "hasPreviousPage": false,
      "hasNextPage": false,
      "records": [
        {
          "promotionId": "aec82146-b1c3-46ed-b044-05d4b0e8baf5",
          "name": "Save 5% on asdfasdfa",
          "storeId": "43",
          "storeName": "uboss-US",
          "regionName": "美国",
          "currencyIcon": "$",
          "status": 2,
          "needsAttention": false,
          "statusText": "已过期",
          "originStatus": "EXPIRED",
          "originStatusText": "已过期",
          "discount": "5.00%",
          "budget": "$100",
          "cost": 0,
          "drawQuantity": 0,
          "exchangeQuantity": 0,
          "exchangeRate": 0,
          "salesAmount": 0,
          "salesAmountUsd": 0,
          "salesVolume": 0,
          "promotionStartTime": "2024-09-10 00:00:00",
          "promotionStartTimeUtc": null,
          "promotionEndTime": "2024-09-12 00:00:00",
          "firstSyncTime": "2024-11-07 10:36:28",
          "lastSyncTime": "2024-11-07 17:25:19",
          "remark": ""
        }
      ]
    },
    "total": 1
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1sellerSkuseller_sku(msku)string—Requiredseller_sku(msku)
2promotionType促销类型array<any>—Optional促销类型
3status促销状态array<any>—Optional促销状态: 0 其他 1 进行中 2 已过期 3 未开始
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状态码,0 成功
2message消息提示stringsuccessRequired消息提示
3error_details错误信息array<any>[]Required错误信息
4request_id请求链路idstring9ed6f7bca84d4768a1c374ef8865e263.1752196903523Required请求链路id
5response_time响应时间string2025-07-11 09:21:44Required响应时间
6datadataobject—Required
6.1total总数number1Required总数
6.2sizesizenumber20Required
6.3pageCountpageCountnumber1Required
6.4currentcurrentnumber1Required
6.5currentSizecurrentSizenumber1Required
6.6hasPreviousPagehasPreviousPagebooleanfalseRequired
6.7hasNextPagehasNextPagebooleanfalseRequired
6.8recordsrecordsarray<object>—Required
6.8.1promotionId优惠券idstringaec82146-b1c3-46ed-b044-05d4b0e8baf5Required优惠券id
6.8.2name优惠券名称stringSave 5% on asdfasdfaRequired优惠券名称
6.8.3storeId店铺idstring43Required店铺id
6.8.4storeName店铺名stringuboss-USRequired店铺名
6.8.5regionName国家/地区string美国Required国家/地区
6.8.6currencyIcon货币iconstring$Required货币icon
6.8.7status商品状态number2Required商品状态:1 active,2 draft,3 archived,4 deleted
6.8.8needsAttention状态booleanfalseRequired状态
6.8.9statusText状态string已过期Required状态
6.8.10originStatus活动状态stringEXPIREDRequired活动状态: ACTIVE 进行中 CANCELED 已取消 EXPIRED 已过期 RUNNING 生效中 NEEDS ACTION 需要注意 EXPIRING SOON 即将过期 SUBMITTED 已提交 FAILED 失败
6.8.11originStatusText活动状态string已过期Required活动状态
6.8.12discount折扣string5.00%Required折扣
6.8.13budget预算string$100Required预算
6.8.14cost支出number0Required支出
6.8.15drawQuantity领取数number0Required领取数
6.8.16exchangeQuantity兑换数number0Required兑换数
6.8.17exchangeRate兑换率number0Required兑换率
6.8.18salesAmount活动总销售额number0Required活动总销售额
6.8.19salesAmountUsd活动总销售额number0Required活动总销售额,换算成美元
6.8.20salesVolume活动总销量number0Required活动总销量
6.8.21promotionStartTime活动开始时间string2024-09-10 00:00:00Required活动开始时间
6.8.22promotionStartTimeUtc活动开始时间UTC时间stringnullRequired活动开始时间UTC时间
6.8.23promotionEndTime活动结束时间string2024-09-12 00:00:00Required活动结束时间
6.8.24firstSyncTime首次同步时间string2024-11-07 10:36:28Required首次同步时间
6.8.25lastSyncTime最后同步时间string2024-11-07 17:25:19Required最后同步时间
6.8.26remark备注string—Required备注
7total总数number1Required总数

The 查询商品折扣详情 - 列表 - 优惠券 API (/basicOpen/promotion/listingDetailCoupon) 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.