折扣碼與分潤
客人結帳時輸入折扣碼,訂單就多一列負數的應收明細。折扣碼也可以同時記下要分給推廣者的分潤。
建立折扣碼
在「後台 → 內容與行銷 → 折扣碼」新增。表單分三區:
基本
| 欄位 | 說明 |
|---|---|
| 折扣碼 | 客人結帳時輸入的字串。不分大小寫,不能重複。 |
| 名稱 / 活動 | 後台辨識用,例如「秋季合作推廣」。 |
| 折抵方式 | 固定金額或百分比(1–100)。 |
| 分潤 | 無分潤、固定金額或百分比,並填分潤收款對象。 |
| 啟用 | 停用後客人無法套用。 |
固定金額可以再選計算方式:
| 計算方式 | 例 |
|---|---|
| 整張訂單折一次 | 折 500 |
| 每 N 位旅客折一次 | 每 1 位折 300:4 人折 1,200。只用在行程訂單。 |
| 每滿 N 元折一次 | 每滿 28,000 折 1,000:56,000 折 2,000 |
人數或金額不到 N 時,這個碼不能用。百分比只能整張訂單折一次。
使用條件
- 有效期間:起訖日。留空表示不限。
- 累計使用次數上限,以及每位客人的使用次數上限。
- 最低消費門檻:折扣前的金額未達門檻時不能用。
- 最低旅客人數:行程算旅客數,住宿算入住人數。住宿的入住人數是客人自報,不影響房價。
- 適用行程:全部行程,或指定行程。
- 價格通路:直客或同業。促銷價不是通路,促銷價的直客單仍算直客。
- 客戶分類:直客或同業窗口。
試算與備註:輸入示例人數與金額,先看折扣、分潤與淨收。備註只給內部看。
說明
修改折扣碼不會改到已成立的訂單。每次使用時,系統已記下當下的折扣金額、規則與分潤對象。
使用規則
- 一張訂單只能用一個折扣碼。 表單上的併用設定目前不生效。
- 折扣不能讓訂單變成 0 元。 折後金額小於或等於 0 時,這個碼不能用。
- 百分比折扣無條件捨去到整數元。
- 名額在建單當下才扣。 試算不佔名額。兩個人同時用最後一個名額時,只有一個會成功。
- 訂單取消時歸還名額。 每位客人的使用次數也一起歸還。
折扣怎麼記在訂單上
建單時,系統先記團費等正數的應收明細,再記一列負數的折扣。訂單的應收因此直接是折後金額,收款計畫的訂金與尾款也依折後金額計算。
訂單頁「款項」分頁的「金額明細」顯示折扣碼、已折扣、需分潤與折扣碼淨收。
說明
自建前台或串接時,不要自己算折後金額。一律讀訂單回傳的應收與尚欠。
換梯時的折扣碼
承辦做跨行程換梯,或客人自助換梯時,系統依當天的設定與新團費重新檢查原本的折扣碼:
- 仍適用:繼續使用,不再扣名額,折抵金額重算。
- 不再適用:折扣退出,名額歸還一次。之後取消也不會再歸還,再換梯也不會恢復。
同行程的承辦換梯保留原折扣,不重新檢查。詳見換梯與拆單。
分潤
折扣碼可以同時當作推廣分潤的依據。設了分潤,每次使用時就記下一筆應分潤金額與收款對象。
- 固定金額分潤:不超過折後金額。
- 百分比分潤:以折後金額計算,四捨五入到整數元。
把分潤轉成請款單
- 在折扣碼明細頁看「分潤報表彙總」:使用這個碼的訂單、折扣、需分潤與折後售價。
- 在「分潤付款」區勾選待轉分潤,轉成一張請款單。
- 請款單照一般流程核簽與出款,見請款與出款批次。
待轉分潤只算分潤大於 0、訂單沒取消也沒退款、還沒轉過的使用紀錄。已轉過的不能再轉。請款單取消後,對應的分潤可以重新轉單。
注意
分潤是付給推廣者的錢,不是退給客人的錢。退客人錢走取消與退款。
›折扣碼 API 與欄位
| 欄位 | 意義 |
|---|---|
code / label | 折扣碼/名稱 |
discountType / discountValue | fixed(台幣)或 percentage(1–100) |
discountBasis / discountStep | per_order(預設)、per_travelers、per_amount;後兩者只限 fixed,discountStep 為 N |
isActive | 是否啟用 |
validFrom / validUntil | 起訖日 YYYY-MM-DD,留空不限 |
maxRedemptions / redemptionCount | 總使用上限/已使用次數 |
maxRedemptionsPerCustomer | 每位客人使用上限 |
minOrderTwd / minTravelerCount | 最低金額/最低人數 |
appliesToAll / tripIds | 全部行程,或指定行程 |
allowedPriceChannels | direct、agency;空陣列不限 |
allowedCustomerTypes | direct、agency_contact;空陣列不限 |
stackable | 保留欄位,結帳不讀 |
profitShareType / profitShareValue / profitSharePayee | 分潤方式、數值與對象 |
管理折扣碼:
GET /discount-codes、GET /discount-codes/{id}(含適用行程與使用紀錄)。POST /discount-codes建立,需要discount.manage。PATCH /discount-codes/{id}更新(送完整欄位)。POST /discount-codes/{id}/set-active啟用或停用。
試算與套用:
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 } }分潤:
GET /discount-codes/{id}/redemptions:每筆使用的orderNumber、originalTotalTwd、discountTwd、profitShareTwd、orderStatus,以及totalDiscountTwd、totalProfitShareTwd、totalPaidTwd。GET /discount-codes/profit-shares:待轉清單與依收款對象的彙總。POST /discount-codes/profit-shares/convert:把選定的分潤轉成一張請款單,payeeType為staff_commission或other。需要payable.create。staff_commission的請款單可併入出款批次。- 從折扣碼明細開啟已轉出的請款單,需要
payable.read。
相關指南
- 訂單與金流模型:折扣是應收明細的一列。
- 付款流程:折後金額怎麼向客人收款。
- 換梯與拆單:換梯時折扣碼怎麼處理。
- discount-codes API · CLI discount-codes。