訂單管理（管理端）

管理端「訂單管理」是老闆 / 店長視角的 POS 訂單總覽：跨分店看所有開過的單，可篩選、查詢、退款、取消、校正金額。對應的 POS 端「訂單」頁是店員平板版（深色），這裡是後台網頁版（淺色）。

提示：sidebar 入口為「訂單管理」（路徑 /dashboard/modules/beauty/orders）。如要看「預約」（未結帳前的排程），請至「預約看板」。

進入路徑

後台左側 美業預約 → 訂單管理。

篩選列

頂部一排篩選條件，預設為當月 1 號到今天：

下方有統計列：本頁筆數 / 總筆數、本頁「已完成」加總金額、含儲值金扣抵金額。

訂單列表

每一列顯示：時間、訂單號、分店（連鎖才有）、會員 / 客戶、服務員、付款方式、金額、狀態。儲值金扣抵金額會以藍色小字顯示在主金額下方。

點任一列即開詳情 modal。

每頁 50 筆，可下方分頁切換。

訂單詳情 modal

點開後可看到完整明細：

• 基本資訊：訂單號、建單時間、會員 / 散客、服務員、付款方式、預約 ID（若從預約轉）
• 服務明細列：每項服務的單價 × 數量、副選項 / 指定設計師加價
• 小計 / 折扣 / 總計 / 加點數 / 儲值金扣抵
• 訂單備註

三大操作

校正金額　進入校正模式，可逐項改單價 → 預覽新小計 / 總計 → 確認後寫進 audit_logs（不可逆，建議只用於對帳修正）。

退款　status=completed 的訂單可點「退款」按鈕：

• prompt 填退款原因（可留空）
• 寫入 refund_reason + refunded_at，訂單狀態改 refunded
• 自動回扣會員之前加的點數（寫進 points_log，type=refund；若會員目前點數不夠扣，只扣到剩餘的量）
• 自動回沖會員的累計消費金額（total_spent）——會員等級門檻與 RFM 報表的基礎
• 若這筆訂單有用儲值金付款，退回的儲值金會自動加回會員的儲值金餘額，同時建立儲值交易紀錄並推播 LINE 通知會員

取消　status=pending（未結帳）的訂單可點「取消」：

• prompt 填取消原因
• 訂單狀態改 cancelled，不留交易紀錄

哪些是系統自動處理、哪些不是：點數、累計消費額、儲值金餘額這三項是系統自動回沖的資料面異動。但退款動作本身不會自動退現金／刷退信用卡——若客人是用現金或刷卡付款（沒有動用儲值金），實際的金流退款（退現金、刷退、轉帳）仍要由店家依當下的付款方式自行處理。

常見問題

Q1　退款後會員的點數會自動扣回去嗎

會。系統會把該訂單當時加的 points_earned 從會員餘額扣回（不足額時只扣到剩餘的量），並在 points_log 留一筆 type=refund、description 含訂單號的紀錄；同時累計消費金額（total_spent）也會一併回沖，若原單有用儲值金付款，儲值金也會自動退回會員餘額並推播 LINE 通知。

Q2　「校正金額」跟「退款」有什麼差別

校正金額用於「對帳發現單價輸錯」的情境，直接改 unit_price 並重算 subtotal / total，audit_logs 留紀錄；訂單狀態仍維持 completed。退款是把整張單作廢、回扣點數，狀態變 refunded。

Q3　可以批量退款 / 批量取消嗎

目前不支援批量操作，需逐筆進詳情處理。

Q4　「訂單管理」跟「預約看板」差在哪

• 預約看板：管未結帳前的預約排程（待確認 / 已確認 / 等待中 / 服務中）
• 訂單管理：POS 結帳後的訂單（已完成 / 已退款 / 待結帳 pending POS 單）

兩個看的是預約生命週期的不同階段。