轻易云
注册体验

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

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

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

POST/promotionApi/open/promotion/couponAllDetailBatch
加工厂
{
  "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
        }
      }
    ]
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1itemListitemListarray<object>—必填批量请求详情itemList个数最小为1最大为20
1.1promotionId活动idstring—必填活动id,唯一标识
1.2storeId店铺idstring—必填店铺id
1.3orderPageNum活动订单分页页数number—必填活动订单分页页数,最小为1
1.4orderPageSize活动订单分页大小number—必填活动订单分页大小,最小为1,最大为200
1.5listingPageNum活动listing分页页数number—必填活动listing分页页数,最小为1
1.6listingPageSize活动listing分页大小number—必填活动listing分页大小,最小为1,最大为200

接口响应参数

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

领星ERP的接口:查询优惠券详情+listing+订单(批量)(/promotionApi/open/promotion/couponAllDetailBatch),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

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