booking.config.get
read讀取預約系統時區、預約間隔、最早最遲預約、付款、提醒及改期取消基本設定。
建議先讀取
-
治理與審批
只讀；可作所有預約寫入前的基準設定。
安全說明
不得回傳 payment secret、API key 或私人備註。
線上預約系統 MCP 工具
線上預約系統 MCP 工具按預約營運 workflow 設計，覆蓋服務、地點、員工、房間設備、時段、黑名/封鎖規則、客戶、預約、訂金付款、改期取消政策、套票扣次、提醒通知、候補名單、出席 no-show、容量分析及 audit。
booking.services.list
read列出可預約服務、分類、時長、基本價格、容量、訂金及套票扣次規則。
建議先讀取
booking.config.get
治理與審批
只讀；用於建立可預約時段或客戶預約前核對服務規則。
安全說明
只顯示啟用或授權可見服務，避免泄露內部草稿服務。
booking.service.get
read讀取單一服務的時長、緩衝時間、可用資源、價格、訂金、取消及改期限制。
建議先讀取
booking.services.list
治理與審批
只讀；服務調整或預約建立前必須先核對。
安全說明
不得暴露未授權成本、員工佣金或內部利潤欄位。
booking.locations.list
read列出分店、服務地點、營業時間、地址、時區及可用服務範圍。
建議先讀取
booking.config.get
治理與審批
只讀；用於按地點搜尋可預約時段。
安全說明
隱藏內部倉庫、員工專用地點或未公開地址。
booking.resources.list
read列出員工、房間、設備、容量及可配對服務，支援避免撞期。
建議先讀取
booking.services.list, booking.locations.list
治理與審批
只讀；開放時段及分配預約前使用。
安全說明
按權限遮蔽員工私人資料及內部資源成本。
booking.staff_schedules.list
read查詢員工班表、休假、可接服務、每日上限及已安排預約。
建議先讀取
booking.resources.list
治理與審批
只讀；用於時段開放、改期及人手調配。
安全說明
只回傳工作相關 availability，不暴露薪酬或私人行程。
booking.blackout_rules.list
read讀取公眾假期、維修、內部活動、臨時封鎖及最短預約通知規則。
建議先讀取
booking.config.get, booking.locations.list
治理與審批
只讀；搜尋或開放時段前必須套用。
安全說明
只顯示必要原因，避免披露敏感內部安排。
booking.availability.search
read按服務、地點、員工、日期、容量及價格規則搜尋可預約時段。
建議先讀取
booking.service.get, booking.staff_schedules.list, booking.blackout_rules.list
治理與審批
只讀；客戶自助預約及 staff 代客預約前使用。
安全說明
不得顯示其他客戶姓名；只提供容量和可預約狀態。
booking.slot.get
read讀取指定時段的服務、資源、容量、已預約數、候補、價格及付款要求。
建議先讀取
booking.availability.search
治理與審批
只讀；建立、改期、封鎖或釋放時段前核對。
安全說明
預設不回傳完整客戶名單，除非 staff 權限允許。
booking.bookings.list
read按日期、服務、員工、地點、狀態、付款狀態或客戶查詢預約。
建議先讀取
booking.config.get
治理與審批
只讀；營運查詢、提醒、改期及 no-show 處理前使用。
安全說明
客戶 PII 需按角色遮蔽；避免大量匯出。
booking.booking.get
read讀取單一預約的客戶、服務、時段、資源、付款、提醒、改期及 audit 紀錄。
建議先讀取
booking.bookings.list
治理與審批
只讀；任何取消、改期、退款、扣次或出席更新前必須先讀。
安全說明
只向授權 staff 顯示聯絡資料及備註。
booking.customers.search
read按電話、電郵、姓名或會員編號搜尋預約客戶。
建議先讀取
booking.config.get
治理與審批
只讀；代客建立預約或查詢歷史前使用。
安全說明
搜尋結果需限量並遮蔽部分電話電郵。
booking.customer.get
read讀取客戶預約歷史、偏好、no-show 記錄、同意狀態及套票餘額摘要。
建議先讀取
booking.customers.search
治理與審批
只讀；預約、提醒或套票扣次前核對。
安全說明
醫療、未成年人或敏感備註須受額外權限保護。
booking.packages.list
read查詢客戶套票、剩餘次數、有效期、適用服務及扣次限制。
建議先讀取
booking.customer.get, booking.service.get
治理與審批
只讀；扣次、預約確認或退款前使用。
安全說明
不得向非授權角色披露付款金額或合約條款。
booking.payment_settings.get
read讀取 Stripe、PayMe、FPS、訂金比例、退款窗口及付款到期規則。
建議先讀取
booking.config.get
治理與審批
只讀；付款收取、訂金退款及預約確認前使用。
安全說明
不得回傳 secret key、完整交易卡資料或銀行敏感資料。
booking.payments.list
read查詢預約付款、訂金、餘額、退款、付款證明及 gateway 狀態。
建議先讀取
booking.booking.get, booking.payment_settings.get
治理與審批
只讀；退款、追款或確認付款前使用。
安全說明
遮蔽交易參考以外的敏感付款資料。
booking.reminder_rules.list
read讀取預約確認、改期、取消、服務前提醒及 no-show follow-up 規則。
建議先讀取
booking.config.get
治理與審批
只讀；發送或更新提醒規則前使用。
安全說明
不得暴露 WhatsApp token 或訊息供應商 secret。
booking.reschedule_policy.get
read讀取最遲改期、取消收費、退款、候補及人工批核政策。
建議先讀取
booking.service.get, booking.payment_settings.get
治理與審批
只讀；改期、取消及退款 preview 前必須套用。
安全說明
政策例外需標示來源，不可自行推斷免罰。
booking.waitlist.list
read查詢候補名單、偏好時段、通知狀態、到期時間及排序原因。
建議先讀取
booking.slot.get, booking.customer.get
治理與審批
只讀；釋放名額或 offer slot 前使用。
安全說明
候補排序需可解釋，避免暴露其他客戶 PII。
booking.booking_summary.get
read讀取預約量、成交、取消率、no-show、收入、訂金及退款摘要。
建議先讀取
booking.bookings.list, booking.payments.list
治理與審批
只讀；營運報告及改善建議使用。
安全說明
報告需聚合處理，不應顯示單一客戶敏感資料。
booking.capacity_summary.get
read讀取熱門時段、容量使用率、員工使用率、房間設備負載及等候需求。
建議先讀取
booking.availability.search, booking.bookings.list
治理與審批
只讀；用於下月時段開放及人手安排。
安全說明
避免以個別員工績效作公開比較。
booking.audit_logs.list
read查詢預約、付款、退款、改期、取消、扣次及提醒的操作紀錄。
建議先讀取
booking.booking.get
治理與審批
只讀；用於追蹤爭議、錯誤或審批紀錄。
安全說明
audit 只供授權管理員查看，不應公開。
booking.slot_release.preview
preview預覽批量開放下月時段後的員工、房間、容量、價格及撞期影響。
建議先讀取
booking.services.list, booking.resources.list, booking.staff_schedules.list, booking.blackout_rules.list, booking.capacity_summary.get
治理與審批
必須先 preview；只有批核後才可 open slot。
安全說明
不得自動覆蓋封鎖日、員工休假或容量限制。
booking.create_booking.preview
preview預覽建立預約會否撞期、需要訂金、扣套票、加入候補或觸發提醒。
建議先讀取
booking.slot.get, booking.customer.get, booking.payment_settings.get, booking.packages.list
治理與審批
代客或 AI 建立預約前需確認 preview 結果。
安全說明
不得繞過客戶同意、訂金要求或黑名單限制。
booking.reschedule.preview
preview預覽改期後的舊時段釋放、新時段可用性、費用、提醒及候補影響。
建議先讀取
booking.booking.get, booking.reschedule_policy.get, booking.availability.search
治理與審批
改期前需取得客戶或 staff 批核。
安全說明
不得在政策限制外自動改期；晚改需人工批核。
booking.cancellation.preview
preview預覽取消後的退款、訂金沒收、名額釋放、候補通知及提醒取消。
建議先讀取
booking.booking.get, booking.reschedule_policy.get, booking.payments.list, booking.waitlist.list
治理與審批
取消及退款動作需按政策或管理員批核。
安全說明
不得自行豁免取消費或退款限制。
booking.deposit_refund.preview
preview預覽訂金或付款退款金額、gateway 狀態、手續費、可退款期限及會計影響。
建議先讀取
booking.booking.get, booking.payment_settings.get, booking.payments.list
治理與審批
退款必須經授權角色批核。
安全說明
不得重複退款；必須檢查 gateway transaction 狀態。
booking.package_deduction.preview
preview預覽預約確認或出席後的套票扣次、有效期及餘額變化。
建議先讀取
booking.booking.get, booking.packages.list
治理與審批
扣次前需確認服務適用、餘額足夠及客戶身份。
安全說明
避免重複扣次；需要 idempotency key。
booking.reminders.preview
preview預覽確認、改期、取消、服務前提醒及候補通知內容、渠道和收件人。
建議先讀取
booking.booking.get, booking.reminder_rules.list, booking.customer.get
治理與審批
大量或客製訊息發送前需確認內容及收件人。
安全說明
遵守同意狀態、退訂及訊息模板限制。
booking.service.upsert
write新增或更新服務的名稱、時長、容量、價格、訂金、資源要求及可預約規則。
建議先讀取
booking.service.get, booking.payment_settings.get
治理與審批
服務公開資料或價格變更需批核後生效。
安全說明
保留版本紀錄；不得影響既有預約價格除非明確指定。
booking.resource_availability.upsert
write新增或更新員工、房間、設備的可預約時間、容量、服務配對及封鎖規則。
建議先讀取
booking.resources.list, booking.staff_schedules.list, booking.blackout_rules.list
治理與審批
會影響公開時段或既有預約時需批核。
安全說明
不得移除已被預約佔用的資源而不提示衝突。
booking.slot_batch.open
write批量開放指定日期範圍的可預約時段，套用員工、房間、容量及價格規則。
建議先讀取
booking.slot_release.preview
治理與審批
必須基於已批核 preview 執行。
安全說明
需 idempotency；避免重複開放或覆蓋封鎖日。
booking.slot.block
write封鎖指定時段作休息、維修、內部活動或臨時不可預約。
建議先讀取
booking.slot.get, booking.bookings.list
治理與審批
如已有預約，必須先處理客戶通知、改期或退款批核。
安全說明
不得靜默取消客戶預約。
booking.booking.create
write建立客戶預約，鎖定時段、服務、資源、訂金要求及通知任務。
建議先讀取
booking.create_booking.preview
治理與審批
需客戶確認或授權 staff 代客確認。
安全說明
檢查容量、同意狀態、付款要求及 idempotency。
booking.booking.confirm
write確認暫存或待付款預約，更新付款、訂金、套票及提醒狀態。
建議先讀取
booking.booking.get, booking.payments.list, booking.package_deduction.preview
治理與審批
確認前需核對付款或套票扣次。
安全說明
避免 unpaid booking 被錯誤確認。
booking.booking.reschedule
write將預約改到新時段，釋放舊時段，更新資源、費用、提醒及 audit。
建議先讀取
booking.reschedule.preview
治理與審批
需客戶或授權 staff 批核；晚改期需管理員批核。
安全說明
不可在未確認新時段可用前釋放舊時段。
booking.booking.cancel
write取消預約，處理退款、訂金沒收、時段釋放、候補及通知。
建議先讀取
booking.cancellation.preview
治理與審批
按政策或管理員批核後執行。
安全說明
取消原因、操作者及退款決策必須留 audit。
booking.booking.check_in
write標記客戶到場，觸發套票扣次、尾款處理或服務完成流程。
建議先讀取
booking.booking.get, booking.package_deduction.preview
治理與審批
前線 staff 可按權限執行；扣次需可追溯。
安全說明
避免同一預約重複 check-in 或重複扣次。
booking.booking.mark_no_show
write標記 no-show，更新客戶紀錄、訂金處理、候補釋放及 follow-up 通知。
建議先讀取
booking.booking.get, booking.reschedule_policy.get, booking.payments.list
治理與審批
如涉及扣費或封鎖客戶，需管理員批核。
安全說明
保留 staff 記錄及時間，避免誤標 no-show。
booking.deposit.capture
write收取或確認預約訂金、全額付款或付款證明，並更新預約付款狀態。
建議先讀取
booking.booking.get, booking.payment_settings.get, booking.payments.list
治理與審批
線下付款確認需授權 staff；online capture 需 gateway 狀態確認。
安全說明
不得儲存完整卡資料；防止重複收款。
booking.refund.create
write按已批核 preview 建立退款，更新付款、預約及會計紀錄。
建議先讀取
booking.deposit_refund.preview
治理與審批
必須由授權角色批核退款金額和原因。
安全說明
使用 idempotency，檢查 gateway 是否已退款。
booking.package_session.deduct
write為已確認或已出席預約扣減套票次數，記錄餘額及扣次來源。
建議先讀取
booking.package_deduction.preview
治理與審批
按服務和套票規則執行；例外需批核。
安全說明
必須防止同一 booking 重複扣次。
booking.waitlist.offer_slot
write向候補客戶提供釋放時段，設定接受期限並暫時鎖定名額。
建議先讀取
booking.waitlist.list, booking.slot.get, booking.reminders.preview
治理與審批
按候補排序或 staff 批核後發送。
安全說明
不得同時向過多客戶永久鎖定同一名額。
booking.staff.assign
write為預約指派或更換負責員工，檢查資格、班表和撞期。
建議先讀取
booking.booking.get, booking.staff_schedules.list, booking.slot.get
治理與審批
更換已確認預約 staff 需按權限或管理員批核。
安全說明
不得指派無資格、休假或已滿負荷員工。
booking.reminder.send
write發送預約確認、付款、改期、取消、服務前提醒、候補或 no-show follow-up。
建議先讀取
booking.reminders.preview
治理與審批
自動提醒按規則發送；人工或大量發送需確認。
安全說明
遵守同意、退訂、頻率限制及模板審批。
booking.reminder_rule.upsert
write新增或更新提醒規則、渠道、發送時間、模板及適用服務。
建議先讀取
booking.reminder_rules.list, booking.reminders.preview
治理與審批
影響大量客戶通知的規則需管理員批核。
安全說明
防止短時間重複發送或違反 template policy。
booking.analytics_snapshot.record
write保存預約量、容量、收入、取消、no-show 及渠道成效的營運快照。
建議先讀取
booking.booking_summary.get, booking.capacity_summary.get
治理與審批
只寫入聚合報告資料；不改動客戶或預約。
安全說明
避免把個人資料寫入 analytics snapshot。
booking.action_request.status
status查詢預約系統寫入請求、批核、執行、失敗、重試及 audit 狀態。
建議先讀取
booking.audit_logs.list
治理與審批
只讀狀態；用於追蹤 slot release、退款、改期及通知。
安全說明
不得透過 status endpoint 重新執行寫入。