Special Price

Description

取得商品特價金額

依門市、銷售方式、取貨時間、會員群組與客戶端裝置，計算商品可套用的特賣特價。 - 特賣有限定適用平台時，僅限定平台的客戶端裝置可取得特價；未限定平台的特賣各裝置皆可套用。 - 未帶 client_device 時不依平台篩選。 - 無可套用特賣時，spe_price 回傳 null。

Resource

POST /v1/promotion

Authorization

採用 OAuth 2.0 Bearer Token，詳細使用流程請參考 Auth Login。

Request Body Parameters

Name	Type	Description
shop_id	string	門市代碼
products	array	商品清單（需含 prod_id 商品代碼、price1 售價、iscomb 是否套餐、ispack 是否單品組合）
sale_method	integer	銷售方式代碼（999 = 全部）
pickup_datetime	string	取貨時間 EXAMPLE "2026-09-29 12:00:00"
vip_group_id	string	會員群組 (optional)
client_device	string	客戶端裝置 (optional) EXAMPLE KIOSK、PWA、EC_QUICK_ORDER 特價依此裝置套用特賣的適用平台；未帶則不依平台篩選

Request Example

{
    "shop_id": "000030",
    "products": [
        {
            "prod_id": "A0001",
            "price1": 100,
            "iscomb": "0",
            "ispack": "0"
        }
    ],
    "sale_method": 999,
    "pickup_datetime": "2026-09-29 12:00:00",
    "vip_group_id": "",
    "client_device": "PWA"
}

Response Body Parameters

Name	Type	Description
product	array	商品清單（沿用 Request 帶入的商品欄位，並回填 spe_price）

Response Body Parameters - Product

Name	Type	Description
prod_id	string	商品代碼
price1	float	售價
spe_price	float	特價；無可套用特賣時為 null

Response Example

{
    "product": [
        {
            "prod_id": "A0001",
            "price1": 100.0,
            "iscomb": "0",
            "ispack": "0",
            "spe_price": 90.0
        }
    ]
}