Qeasy Cloud
Get Started

领星ERP 查询优惠券详情+listing+订单(批量) API

Platform
领星ERP
Type
WebAPI
Effect
QUERY
API Version
1.0
Adapter
\Adapter\LingXing\LXQueryAdapter
Auth Mode
OTHER
Description
销售 / 促销管理 · POST · 请求参数 7 个(必填 7) · 响应参数 79 个
Updated At
2026-11-21

查询优惠券详情+listing+订单(批量)

POST/promotionApi/open/promotion/couponAllDetailBatch
Factory
{
  "operation": {
    "method": "POST",
    "path": "/promotionApi/open/promotion/couponAllDetailBatch"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "requestExample": "{\n    \"itemList\": [\n        {\n            \"promotionId\": \"2577860007635320832\",\n            \"storeId\": \"32\",\n            \"orderPageNum\": 1,\n            \"orderPageSize\": 20,\n            \"listingPageNum\": 2,\n            \"listingPageSize\": 1\n        }\n    ]\n}",
  "responseExample": {
    "code": 0,
    "message": "操作成功",
    "error_details": [],
    "request_id": "",
    "response_time": "",
    "total": 0,
    "data": [
      {
        "promotionId": "bbdcdae5-57a1-4777-9ad6-3d901ea6fa74",
        "storeId": "A23VOKJ3KY8G48",
        "coupon": {
          "promotionId": "bbdcdae5-57a1-4777-9ad6-3d901ea6fa74",
          "name": "5%の割引 cj001",
          "storeId": "A23VOKJ3KY8G48",
          "storeName": "非凡-JP",
          "regionName": "日本",
          "currencyIcon": "JP¥",
          "budget": "JP¥10000.0",
          "cost": 0,
          "discount": 5,
          "drawQuantity": 0,
          "exchangeQuantity": 0,
          "exchangeRate": 0,
          "status": 2,
          "statusText": "已过期",
          "originStatus": "",
          "promotionType": 6,
          "salesAmount": 0,
          "salesVolume": 0,
          "promotionStartTime": "2024-07-18 00:00:00",
          "promotionEndTime": "2024-09-18 00:00:00"
        },
        "listingPage": {
          "total": 2,
          "size": 1,
          "pageCount": 2,
          "current": 2,
          "currentSize": 1,
          "records": [
            {
              "storeId": "31",
              "storeName": "非凡-JP",
              "regionName": "日本",
              "currencyIcon": "JP¥",
              "sellerSku": "09-CJWX-DFQH",
              "asin": "B09SBF3H99",
              "asinUrl": "https://www.amazon.co.jp/dp/B09SBF3H99",
              "smallImageUrl": "https://m.media-amazon.com/images/I/51f8M9Z0O5L._SL75_.jpg",
              "itemName": "シンプルなハート型ワックス編みカップルブレスレット (Red)",
              "coupon": {
                "salesPrice": 2889,
                "discountPrice": 0,
                "salesVolume": 0,
                "salesAmount": 0
              }
            }
          ],
          "hasNextPage": false,
          "hasPreviousPage": true
        },
        "orderPage": {
          "total": 1,
          "size": 20,
          "pageCount": 1,
          "current": 1,
          "currentSize": 1,
          "records": [
            {
              "amazonOrderId": "nnxn-397437",
              "storeId": "31",
              "storeName": "非凡-JP",
              "regionName": "日本",
              "currencyIcon": "JP¥",
              "orderItems": [
                {
                  "sellerSku": "09-CJWX-DFQH",
                  "asin": "B09SBF3H99",
                  "asinUrl": "https://www.amazon.co.jp/dp/B09SBF3H99",
                  "smallImageUrl": "https://m.media-amazon.com/images/I/51f8M9Z0O5L._SL75_.jpg",
                  "itemName": "シンプルなハート型ワックス編みカップルブレスレット (Red)",
                  "localName": "KT7XL",
                  "localSku": "SKUKT7XL",
                  "promotionId": "bbdcdae5-57a1-4777-9ad6-3d901ea6fa74"
                }
              ],
              "purchaseDate": "2022-06-30 00:00:00",
              "orderTotalAmount": 0,
              "orderStatus": "CANCELLED"
            }
          ],
          "hasNextPage": false,
          "hasPreviousPage": false
        }
      }
    ]
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1itemListitemListarray<object>—Required批量请求详情itemList个数最小为1最大为20
1.1promotionId活动idstring—Required活动id,唯一标识
1.2storeId店铺idstring—Required店铺id
1.3orderPageNum活动订单分页页数number—Required活动订单分页页数,最小为1
1.4orderPageSize活动订单分页大小number—Required活动订单分页大小,最小为1,最大为200
1.5listingPageNum活动listing分页页数number—Required活动listing分页页数,最小为1
1.6listingPageSize活动listing分页大小number—Required活动listing分页大小,最小为1,最大为200

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code0成功number1Required0成功
2messagemessagestring操作成功Required
3error_detailserror_detailsarray<any>—Optional
4request_idrequest_idstring—Required
5response_timeyyyy-MM-dd HHstring—Requiredyyyy-MM-dd HH:mm:ss
6totaltotalinteger—Required
7datadataarray<object>—Required
7.1promotionId活动idstringbbdcdae5-57a1-4777-9ad6-3d901ea6fa74Required活动id
7.2storeId店铺idstringA23VOKJ3KY8G48Required店铺id
7.3coupon优惠券信息object—Required优惠券信息
7.3.1promotionId活动idstringbbdcdae5-57a1-4777-9ad6-3d901ea6fa74Required活动id,唯一标识
7.3.2name名称string5%の割引 cj001Required名称
7.3.3storeId店铺IDstringA23VOKJ3KY8G48Required店铺ID
7.3.4storeName店铺名string非凡-JPRequired店铺名
7.3.5regionName国家/地区名string日本Required国家/地区名
7.3.6currencyIcon货币iconstringJP¥Required货币icon
7.3.7budget预算stringJP¥10000.0Required预算
7.3.8cost支出number0Required支出
7.3.9discount折扣number5Required折扣
7.3.10drawQuantity领取数number0Required领取数
7.3.11exchangeQuantity兑换数number0Required兑换数
7.3.12exchangeRate兑换率number0Required兑换率
7.3.13statusstatusnumber2Required状态 0其他 1进行中 2已过期 3未开始 4已取消
7.3.14statusText状态说明string已过期Required状态说明
7.3.15originStatus促销活动平台状态string—Required促销活动平台状态
7.3.16promotionType促销类型number6Required促销类型
7.3.17salesAmount活动总销售额number0Required活动总销售额
7.3.18salesVolume活动总销量number0Required活动总销量
7.3.19promotionStartTime活动开始时间string2024-07-18 00:00:00Required活动开始时间
7.3.20promotionEndTime活动结束时间string2024-09-18 00:00:00Required活动结束时间
7.4listingPage优惠券涉及的Listing信息object—Required优惠券涉及的Listing信息
7.4.1total总数number2Required总数
7.4.2size每页大小number1Required每页大小
7.4.3pageCount总页数number2Required总页数
7.4.4current当前页数number2Required当前页数
7.4.5currentSize当前页条数number1Required当前页条数
7.4.6records当前页数据array<object>—Required当前页数据
7.4.6.1storeId店铺idstring31Required店铺id
7.4.6.2storeName店铺名string非凡-JPRequired店铺名
7.4.6.3regionName国家/地区名string日本Required国家/地区名
7.4.6.4currencyIcon货币iconstringJP¥Required货币icon
7.4.6.5sellerSkusellerSkustring09-CJWX-DFQHRequiredseller_sku
7.4.6.6asinasinstringB09SBF3H99Requiredasin
7.4.6.7asinUrlasin跳转亚马逊前台链接stringhttps://www.amazon.co.jp/dp/B09SBF3H99Requiredasin跳转亚马逊前台链接
7.4.6.8smallImageUrl商品缩略图stringhttps://m.media-amazon.com/images/I/51f8M9Z0O5L._SL75_.jpgRequired商品缩略图
7.4.6.9itemName商品标题stringシンプルなハート型ワックス編みカップルブレスレット (Red)Required商品标题
7.4.6.10coupon优惠券主要信息object—Required优惠券主要信息
7.4.6.10.1salesPrice优惠价number2889Required优惠价
7.4.6.10.2discountPrice折后价number0Required折后价
7.4.6.10.3salesVolume销量number0Required销量
7.4.6.10.4salesAmount销售额number0Required销售额
7.4.7hasNextPage是否有下一页booleanfalseRequired是否有下一页
7.4.8hasPreviousPage是否有上一页booleantrueRequired是否有上一页
7.5orderPage优惠券涉及的订单信息object—Required优惠券涉及的订单信息
7.5.1total总数number1Required总数
7.5.2size每页大小number20Required每页大小
7.5.3pageCount总页数number1Required总页数
7.5.4current当前页数number1Required当前页数
7.5.5currentSize当前页条数number1Required当前页条数
7.5.6records当前页数据array<object>—Required当前页数据
7.5.6.1amazonOrderId亚马逊订单号stringnnxn-397437Required亚马逊订单号
7.5.6.2storeId店铺idstring31Required店铺id
7.5.6.3storeName店铺名string非凡-JPRequired店铺名
7.5.6.4regionName国家/地区名string日本Required国家/地区名
7.5.6.5currencyIcon货币iconstringJP¥Required货币icon
7.5.6.6orderItems订单商品信息array<object>—Required订单商品信息
7.5.6.6.1sellerSkusellerSkustring09-CJWX-DFQHRequiredseller_sku
7.5.6.6.2asinasinstringB09SBF3H99Requiredasin
7.5.6.6.3asinUrlasin跳转亚马逊前台链接stringhttps://www.amazon.co.jp/dp/B09SBF3H99Requiredasin跳转亚马逊前台链接
7.5.6.6.4smallImageUrl商品缩略图stringhttps://m.media-amazon.com/images/I/51f8M9Z0O5L._SL75_.jpgRequired商品缩略图
7.5.6.6.5itemName商品标题stringシンプルなハート型ワックス編みカップルブレスレット (Red)Required商品标题
7.5.6.6.6localName品名stringKT7XLRequired品名
7.5.6.6.7localSkulocalSkustringSKUKT7XLRequiredlocalSku
7.5.6.6.8promotionId促销IDstringbbdcdae5-57a1-4777-9ad6-3d901ea6fa74Required促销ID
7.5.6.7purchaseDate订购时间string2022-06-30 00:00:00Required订购时间
7.5.6.8orderTotalAmount订单总金额number0Required订单总金额
7.5.6.9orderStatus订单状态stringCANCELLEDRequired订单状态
7.5.7hasNextPage是否有下一页booleanfalseRequired是否有下一页
7.5.8hasPreviousPage是否有上一页booleanfalseRequired是否有上一页

The 查询优惠券详情+listing+订单(批量) API (/promotionApi/open/promotion/couponAllDetailBatch) 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.