toko

折扣碼與分潤

客人結帳時輸入折扣碼,訂單就多一列負數的應收明細。折扣碼也可以同時記下要分給推廣者的分潤。

建立折扣碼

在「後台 → 內容與行銷 → 折扣碼」新增。表單分三區:

基本

欄位說明
折扣碼客人結帳時輸入的字串。不分大小寫,不能重複。
名稱 / 活動後台辨識用,例如「秋季合作推廣」。
折抵方式固定金額或百分比(1–100)。
分潤無分潤、固定金額或百分比,並填分潤收款對象。
啟用停用後客人無法套用。

固定金額可以再選計算方式:

計算方式例
整張訂單折一次折 500
每 N 位旅客折一次每 1 位折 300:4 人折 1,200。只用在行程訂單。
每滿 N 元折一次每滿 28,000 折 1,000:56,000 折 2,000

人數或金額不到 N 時,這個碼不能用。百分比只能整張訂單折一次。

使用條件

  • 有效期間:起訖日。留空表示不限。
  • 累計使用次數上限,以及每位客人的使用次數上限。
  • 最低消費門檻:折扣前的金額未達門檻時不能用。
  • 最低旅客人數:行程算旅客數,住宿算入住人數。住宿的入住人數是客人自報,不影響房價。
  • 適用行程:全部行程,或指定行程。
  • 價格通路:直客或同業。促銷價不是通路,促銷價的直客單仍算直客。
  • 客戶分類:直客或同業窗口。

試算與備註:輸入示例人數與金額,先看折扣、分潤與淨收。備註只給內部看。

使用規則

  • 一張訂單只能用一個折扣碼。 表單上的併用設定目前不生效。
  • 折扣不能讓訂單變成 0 元。 折後金額小於或等於 0 時,這個碼不能用。
  • 百分比折扣無條件捨去到整數元。
  • 名額在建單當下才扣。 試算不佔名額。兩個人同時用最後一個名額時,只有一個會成功。
  • 訂單取消時歸還名額。 每位客人的使用次數也一起歸還。

折扣怎麼記在訂單上

建單時,系統先記團費等正數的應收明細,再記一列負數的折扣。訂單的應收因此直接是折後金額,收款計畫的訂金與尾款也依折後金額計算。

訂單頁「款項」分頁的「金額明細」顯示折扣碼、已折扣、需分潤與折扣碼淨收。

換梯時的折扣碼

承辦做跨行程換梯,或客人自助換梯時,系統依當天的設定與新團費重新檢查原本的折扣碼:

  • 仍適用:繼續使用,不再扣名額,折抵金額重算。
  • 不再適用:折扣退出,名額歸還一次。之後取消也不會再歸還,再換梯也不會恢復。

同行程的承辦換梯保留原折扣,不重新檢查。詳見換梯與拆單。

分潤

折扣碼可以同時當作推廣分潤的依據。設了分潤,每次使用時就記下一筆應分潤金額與收款對象。

  • 固定金額分潤:不超過折後金額。
  • 百分比分潤:以折後金額計算,四捨五入到整數元。

把分潤轉成請款單

  1. 在折扣碼明細頁看「分潤報表彙總」:使用這個碼的訂單、折扣、需分潤與折後售價。
  2. 在「分潤付款」區勾選待轉分潤,轉成一張請款單。
  3. 請款單照一般流程核簽與出款,見請款與出款批次。

待轉分潤只算分潤大於 0、訂單沒取消也沒退款、還沒轉過的使用紀錄。已轉過的不能再轉。請款單取消後,對應的分潤可以重新轉單。

›折扣碼 API 與欄位
欄位意義
code / label折扣碼/名稱
discountType / discountValuefixed(台幣)或 percentage(1–100)
discountBasis / discountStepper_order(預設)、per_travelers、per_amount;後兩者只限 fixed,discountStep 為 N
isActive是否啟用
validFrom / validUntil起訖日 YYYY-MM-DD,留空不限
maxRedemptions / redemptionCount總使用上限/已使用次數
maxRedemptionsPerCustomer每位客人使用上限
minOrderTwd / minTravelerCount最低金額/最低人數
appliesToAll / tripIds全部行程,或指定行程
allowedPriceChannelsdirect、agency;空陣列不限
allowedCustomerTypesdirect、agency_contact;空陣列不限
stackable保留欄位,結帳不讀
profitShareType / profitShareValue / profitSharePayee分潤方式、數值與對象

管理折扣碼:

試算與套用:

  • GET /discount-codes/preview:帶 code、kind、total,視情況加 tripId、priceChannel、customerType、userId、travelerCount。有人數門檻或按人數折的碼,沒帶 travelerCount 一律拒絕。回 { ok: true, discountTwd, newTotalTwd, profitShareTwd } 或 { ok: false, reason }。
  • POST /orders/quote(CLI:orders quote --data <json>):帶 departureId、customerType、partySize、paymentPlan,選填 code 與 primaryEmail。回傳與建單相同的計算:單價、小計、折扣、總計與訂金/尾款。折扣碼被拒時仍回 200 與不折扣的金額,discount.reason 帶理由。梯次沒有訂金規則、或訂金不小於總計時,paymentPlan 回 full。試算不保留名額,也不保留價格。
  • POST /orders/discount-preview:只要折扣結果時用,保留舊的回應形狀。
  • POST /orders 建單時送 discountCode(CLI:orders create --discount-code <code>)。碼被拒時回 422,error.code 是 DISCOUNT_CODE_* 理由,例如 DISCOUNT_CODE_RESULTS_ZERO、DISCOUNT_CODE_MIN_ORDER、DISCOUNT_CODE_MIN_TRAVELERS。不要送自己算的總額或折扣,未知欄位回 422。
txt
{ quote: { unitPriceTwd, subtotalTwd, discountTwd, totalTwd, paymentPlan, depositDueTwd, balanceDueTwd, … },
  discount: { status: 'none' } | { status: 'applied' } | { status: 'rejected', reason } }

分潤:

相關指南

Command Palette

Search for a command to run...