toko

訂房產品線

訂房賣的是「某個房型的某一晚」,不是梯次名額。成交後一樣是一張訂單,收款與退款規則和行程訂單相同。

訂房屬訂房模組。未開通時,後台看不到「旅宿」。

訂房和行程有什麼不同

行程訂房
賣什麼梯次的名額某個房型的每一晚
客人選什麼出發梯次入住日與退房日
主檔行程、梯次旅宿、房型

兩者成交後都是一張訂單。

旅宿與房型

在後台 →「資源」→「旅宿」的「旅宿列表」分頁按「新增旅宿」。建好旅宿後,進旅宿頁新增房型。

旅宿是一處自家住宿,例如露營地或旅館。重點欄位:

  • 類型: 旅館或露營地。
  • 用途: 決定這間旅宿在哪些通路販售。
用途散客訂房行程配套後台代訂
直售可不可可
套裝行程不可可不可
兩用可可可
不販售(內部據點)不可不可不可
  • 網址代稱: 前台旅宿頁的網址,建立後不能改。內部據點可以留空。
  • 海外旅宿、地點、地址與聯絡、入住與政策、設施、SEO 與分享: 顯示在前台旅宿頁。

房型是旅宿底下可賣的單位。重點欄位:

  • 庫存單位: 整間賣,或按床位賣。
  • 總單元數: 共幾間或幾床。
  • 每單元人數: 一間或一床可住幾人。
  • 基準晚價: 沒有另外調價的晚上用這個價格。
  • 低水位門檻: 剩餘量低於這個數字時,房況標黃提醒。留空表示不提醒。

旅宿與房型都可以封存。封存後不再販售,歷史訂房保留。

每晚房況

每個房型的每一晚都有一筆房況:容量、已訂、當晚價。它是訂房庫存唯一的依據。

調整房況: 進房型頁,在「批次調整房況」填起始日、結束日,再填要改的項目:

  • 當晚價: 平日、假日、旺季用不同價格時調整。
  • 當晚容量: 留空表示用房型的總單元數。不能降到比該晚已訂數量還少。
  • 販售狀態: 開放或封房。

留空的項目不會變動。

看房況: 旅宿頁的「房況總覽」用顏色區分每晚狀態:可訂、低水位、已滿、封房。房型頁的月曆再分開顯示每晚被哪個來源佔用:散客直訂、梯次配套、出發前夜住宿。

散客訂房

散客訂房有兩個入口:

  • 前台: 客人在前台選旅宿、房型與日期,用信用卡或 ATM 付款。送出付款時保留房間。
  • 後台代訂: 在「旅宿」頁首按「代訂旅宿」,替客人建單。

後台代訂的步驟:

  1. 選旅宿、房型、入住日、退房日。
  2. 填間數(或床數)與入住人數。入住人數不能超過房型可住人數。
  3. 填訂房人 Email。訂房人必須是已註冊的會員,不能是員工帳號。
  4. 選付款方式:
付款方式結果
銀行匯款 / ATM人工對帳,建單後另行通知客人
現場現金建單時直接標成已收。可指定收款帳戶,不指定就是未歸戶
虛擬 ATM目前以人工方式記錄

規則:

  • 日期區間不含退房日。住 3/1、退 3/3 是兩晚。
  • 價格是每一晚的當晚價加總,不是「晚數 × 單一價」。
  • 每一晚都要有空房才成立。 任一晚不足或封房,整筆訂房不成立。
  • 一筆訂房最多 60 晚。
  • 取消訂房會釋回每晚房況,但不會自動退款。退款走訂單的退款流程。
  • 目前沒有改入住日期或改房型的功能。要改就取消後重訂。

訂房單在「旅宿」的「訂房單」分頁,可依狀態與旅宿篩選。

行程配套

把住宿綁進行程,例如滑雪團的飯店。在行程編輯頁的「配套住宿」,替每個梯次整塊預留:

  1. 選梯次、旅宿、房型、入住日、退房日。
  2. 填預留間數。畫面依梯次人數與每間人數建議間數,可按「套用建議」。
  3. 按「預留配套」。

規則:

  • 客人報名的是行程,住宿由這筆整塊預留涵蓋,報名時不再逐筆扣房況。
  • 預留後,系統自動產生分房用的房間,接上梯次的分房作業。
  • 單次預留最多 60 晚(不含退房日)。更長的檔期請拆成多筆。
  • 不需要時按「釋回」,預留的間數退回庫存。
  • 前台行程頁會顯示這間旅宿的設施、房型與照片,只供參考,不能在行程頁另外訂房。

內部據點與出發前夜住宿

用途設成「不販售(內部據點)」的旅宿,只供公司內部使用。它不出現在任何販售通路,也不顯示價格。

內部據點目前的用途是出發前夜住宿:旅客在出發前一晚住進公司據點。線控在梯次的出團準備裡登記,或產生免登入連結讓旅客自己登記。登記不產生應收,清潔費只在現場收取。詳見出團準備與線控。

內部據點的編輯頁可設「可入住時間」的起與迄,例如 19:00~23:00。設了之後,旅客自助登記頁只能選這段時間,欄位旁寫出時段;線控登記、改抵達時間與 API 送出超出時段的抵達時間會被拒絕,API 回 400(代碼 arrival_outside_window)。兩格都清空就不限時間。起要早於迄,不支援跨午夜。已登記的抵達時間不會回頭檢查,下次修改時才套用。API 用 PATCH /api/v1/lodging/properties/{id} 的 pretripArrivalFrom 與 pretripArrivalUntil,兩欄要一起送。

收款與退款

訂房單就是一張普通訂單,套用訂單與金流模型的所有規則:

  • 每一晚是一筆獨立的應收。折扣、加價、退款都是另外的明細。
  • 線上付款、現金、匯款的入帳方式和行程訂單相同,見付款流程。
›API 與 CLI 對應

所有端點見 lodging API。

動作端點
列出、新增旅宿GET /api/v1/lodging/properties、POST /api/v1/lodging/properties
讀取、修改旅宿GET /api/v1/lodging/properties/{id}、PATCH /api/v1/lodging/properties/{id}
封存旅宿POST /api/v1/lodging/properties/{id}/archive
列出、新增房型GET /api/v1/lodging/properties/{id}/room-types、POST /api/v1/lodging/properties/{id}/room-types
修改房型PATCH /api/v1/lodging/room-types/{id}
封存房型POST /api/v1/lodging/room-types/{id}/archive
查可訂量與報價GET /api/v1/lodging/room-types/{id}/availability
查每晚佔用來源GET /api/v1/lodging/room-types/{id}/availability/breakdown
批次調整房況POST /api/v1/lodging/room-types/{id}/nights/override
列出、建立訂房單GET /api/v1/lodging/bookings、POST /api/v1/lodging/bookings
讀取訂房單GET /api/v1/lodging/bookings/{orderId}
取消訂房單POST /api/v1/lodging/bookings/{orderId}/cancel
旅宿營運概況GET /api/v1/lodging/stats

權限: 讀取要 lodging.read。新增或修改旅宿、房型、房況要 lodging.manage。建訂房單要 order.create,取消要 order.update。寫入另需訂房模組,未開通回 403 module_disabled。

旅宿欄位: kind(camp、hotel)、isOverseas、usageHint(direct 直售、package 套裝行程、both 兩用、internal 不販售)、slug(只有 internal 可省略)。

房型欄位: inventoryUnit(room 整間、bed 床位)、unitsTotal、capacityPerUnit、lowAvailabilityThreshold(null 表示不提醒)、basePriceTwd。

查可訂量: 帶 checkIn、checkOut(YYYY-MM-DD,不含退房日)。回傳 available(區間內每晚剩餘量的最小值)、nights、totalPriceTwd、perNight[]。分源明細回傳 directBooked、packageBooked、pretripBooked。

建訂房單: propertyId、roomTypeId、checkIn、checkOut、units、guestCount、bookerEmail、paymentMethod(manual 匯款、cash 現金、atm 虛擬 ATM),選填 receivingAccountId、notes。訂房單是 kind='lodging' 的訂單。

錯誤: 區間超過 60 晚回 422 validation。庫存不足或含封房日時不建單。容量調到低於已訂數回 409。

相關指南

Command Palette

Search for a command to run...