訂單管理
訂單管理提供餐廳所有訂單的查詢、篩選、狀態更新與退款處理功能。適合管理人員在後台進行每日訂單核對、異常處理及業績追蹤，與 POS 介面的即時點餐操作互補。
進入路徑
後台左側 餐飲 POS → 訂單管理。
訂單狀態說明
| 狀態 | 說明 |
|---|---|
| 待付款（pending） | 訂單已建立但尚未結帳，常見於「點餐 + 等客人吃完再結」流程 |
| 準備中（preparing） | 已送後廚，等待備餐（部分流程不會走此狀態） |
| 已完成（completed） | 訂單結帳完成 |
| 已取消（cancelled） | 訂單取消（退單操作會走此狀態） |
| 已退款（refunded） | 已完成結帳但執行退款 |
訂單列表操作
篩選與搜尋
訂單列表頂部提供「狀態」篩選下拉（全部 / 待付款 / 準備中 / 已完成 / 已取消 / 已退款）。列表預設按建立時間倒序，分頁每頁 20 筆，右上角顯示總筆數。
依當前門市顯示（多分店租戶） 訂單列表依畫面左上角「當前門市」切換器顯示該店訂單（2026-08-02 起，頁內不再有獨立的「門市」下拉）；切換頂部門市即同步換店。分店綁定帳號只看得到自己分店的訂單。 多店尚未選門市時會提示「請先在頁面頂部『當前門市』選擇分店」。列表仍保留一欄「分店」顯示每筆訂單所屬門市。單店租戶不顯示切換器與此欄（系統自動隱藏）。
若需依日期、付款方式、桌號做更細的篩選與匯出，可至 日結報表 / 報表 - 明細 頁面查詢與下載。
訂單編號格式
- 單店租戶：
{類型}{日期}-{序號}，例如D20260718-0001（維持原格式不變）。 - 多分店租戶：訂單編號前面自動加上「門市代碼-」前綴，各分店序號各自獨立，例如中山店（代碼 ZS）為
ZS-D20260718-0001。
新編號只對新單生效
查看訂單明細
點擊操作欄的 詳情 按鈕開啟詳情 modal，顯示品項清單、贈品標籤、備註、付款方式、結帳時間等。
拆單付款的訂單，詳情裡的付款方式會列出全部（2026-08-21 起）。例如客人先匯 $1,000、餘額刷卡，會顯示信用卡＋匯款。在此之前只會顯示其中一種，看不出來還有另一筆錢。顯示順序是固定排列，不代表店員實際輸入的先後。要一次匯出多筆帶付款方式的資料，請用報表 - 明細的匯出 CSV。
內用訂單詳情區另外顯示：
- 桌號：例如「桌：A3」或併桌時「桌：A1+A2」
- 用餐人數：例如「4 位」（取自建單時填的
guest_count）
外帶 / 外送訂單不顯示這兩個欄位。對帳時可一眼看出該桌人均消費。
訂單來源徽章
訂單若由顧客 LIFF 自助點餐建立，會在訂單編號旁顯示「自助」徽章，方便辨識自助訂單與店員代點訂單。
補印按鈕（列表與詳情）
本頁（後台訂單管理）的列表「操作」欄與詳情 modal 都提供補印按鈕：
| 訂單狀態 | 列表「操作」欄按鈕 |
|---|---|
| 待付款（pending） | 點餐單（補印給廚房） |
| 已完成 / 已退款 | 結帳單（補印給客人） |
詳情 modal 內固定顯示 印點餐單 + 印結帳單 兩個按鈕；pending 狀態下 印結帳單 會被 disable。
點按鈕後系統會依門市是否啟用出單站模式走不同路徑：
| 門市設定 | 按下補印後 | 由誰印出 |
|---|---|---|
| 沒開出單站模式 | 這台電腦直接送印表機 | 您正在操作的這台電腦 |
| 有開出單站模式 | 畫面顯示「已送出單站」 | 出單站那台固定電腦 |
平板 / iPad 上按補印也印得出來了（2026-08-11 起）
補印按一次就印一張，不要連按
常用場景：
- 廚房漏掉某單 → 進訂單管理找該單 → 按「點餐單」
- 客人要副本 → 進訂單管理找該單 → 按「結帳單」
- 帳單紙卡掉 → 同上，重印一張
POS 端的補印按鈕不一樣（2026-08-13 起）
補印一共有四個入口，分成兩組，按鈕不同、用途不同：
| 入口 | 有哪些補印按鈕 |
|---|---|
| 後台 訂單管理（本頁）、POS 桌位時間表 訂單詳情 | 點餐單（廚房單）、結帳單 |
| POS 結帳中（結桌帳）、POS 訂單查詢 | 核對單（兩顆，見下）、結帳單 |
POS 的兩個現場入口已把「補印點餐單（廚房單）」拿掉，改成 補印核對單：
- 核對單 是印給客人核對「我點了什麼」用的：整張單的所有品項與數量印在同一張，而且不會再通知廚房做一次菜。
- 現場店員最常見的需求是客人問「我剛剛點了什麼」，過去按下「點餐單」等於把廚房單再出一次，有讓後廚誤以為要重做的風險，所以改成這張專門給客人看的核對單。
核對單有「無金額」與「含金額」兩顆（2026-08-13 起）
兩顆並排，櫃台當下自己選要印哪一張：
| 按鈕 | 印出來長什麼樣 | 什麼時候用 |
|---|---|---|
| 核對單（無金額）<br/>（結帳中頁標示為「核對單」） | 只列品項與數量，完全不印金額 | 客人問「我剛剛點了什麼」、上菜前對單、確認有沒有漏點 |
| 核對單（含金額）<br/>（結帳中頁標示為「核對單含價」） | 同樣的品項明細，另外含單價與金額 | 客人想順便看看目前大概多少錢、要先對帳再結帳 |
兩張走同一台印表機、同一套規則，差別只在有沒有印金額；兩張都不會出廚房單。出單站的列印紀錄會分別標示「核對單」與「核對單含金額」，事後查得出印的是哪一版。
印出來的抬頭也不一樣：無金額版是「點餐核對單」，含金額版是「點餐核對單（含金額）」，桌上兩張放一起分得出來。
核對單要先指定印表機
發票狀態與補開 / 補印
後台與 POS 端訂單頁皆可補開 / 補印
餐飲 → 訂單查詢，路徑 /pos/restaurant/orders）點訂單詳情也提供，兩邊行為一致（補開限已結帳、補印限已開立且會提醒同號）。POS 端補印發票按鈕與補印核對單 / 補印結帳單並排，方便收銀當場處理。以下說明兩處通用。若租戶有開通發票模組（pos_invoice），訂單列表與詳情會顯示每筆訂單的發票狀態徽章：
| 徽章 | 意義 |
|---|---|
| 未開發票 | 尚未替此訂單開立發票 |
| 已開(統編) / 已開(載具) / 已開(紙本) | 已成功開立，括號內為開立方式 |
| 開立失敗 | 曾嘗試開立但失敗（發票停在草稿狀態，可重試補開） |
| 已作廢 | 該發票已作廢 |
開票失敗的紅點與「只看開票失敗」（2026-08-25 起）
除了徽章之外，發票欄還會出現一個小紅點，代表這張單真的開票失敗過、而且系統留有失敗原因。
- 列表 紅點就在發票徽章右側，滑鼠移上去（或長按）顯示失敗原因。
- 詳情 點 詳情 開啟訂單，會看到紅底的「開票失敗原因」區塊，顯示原因全文與失敗時間。
- 篩選 列表頂部「狀態」下拉旁的 只看開票失敗 勾選框，勾起來只列開票失敗的訂單。沒有開通發票模組的租戶不會看到這個勾選框。
以上三件事後台訂單管理與 POS 訂單查詢頁都有，行為一致。
按「重試補開發票」之前，先看一眼失敗原因
紅點 ≠ 「開立失敗」徽章
發票管理 → 發票列表 最上方的紅色橫幅（見「發票列表 → 開票失敗，事後查得到嗎」）。詳情 modal 依發票狀態提供兩個按鈕：
補開發票
未開 / 開立失敗的訂單，詳情 modal 會出現 補開發票 按鈕（開立失敗時文字為「重試補開發票」）。點擊會跳出與結帳相同的發票視窗，選發票開立方式（手機載具 / 統一編號 / 索取紙本）後開立；統編 與 紙本 會一併印出發票證明聯，載具 只開立不印。
- 僅已結帳訂單可補開（未結帳沒有金額憑證意義）。
- 若該訂單已開過發票，補開會被擋下（請改用「補印發票」，不重開新號）。
補印發票
已開立發票的訂單，詳情 modal 會出現 補印發票 按鈕，用於重印同一張發票證明聯（不產生新號、不作廢）。
點擊會先跳確認提醒：
補印會再印一張「相同號碼」的發票證明聯。若原本那張發票要作廢，請先用「發票管理」作廢後再重開，避免同號重複憑證。
確認後才會重印。
補印 ≠ 重開
退款處理
於已完成訂單的詳細頁，點擊 退款 按鈕（紅色），跳出原因輸入框（選填）→ 確認後執行整單退款。系統會：
- 訂單狀態變更為「已退款」
- 退款原因寫入
refund_reason欄位（詳情 modal 可看到） - 若該單掛了會員，同步回沖該會員的累計消費額（total_spent）與已賺得的點數（回扣值＝MIN(當初賺的點數, 會員目前還有的點數)，避免扣成負的）
- 這張單當初扣的菜品庫存自動整單回補（送單時扣多少、退款就補回多少）；若門市開了店倉獨立庫存模式，對應分店的庫存也會一併補回
退款注意事項
這張單有發票時會跳「發票提醒」
如果被退款 / 取消的訂單有一張已開立且未作廢的發票，動作成功後系統會跳出一個必須按掉的提醒，內容包含該張發票號碼、原發票金額、已折讓金額、尚可折讓金額。
退錢不等於處理掉發票，系統不會自動開折讓
發票管理 → 發票列表 對該張發票手動開立折讓單。
另外注意：作廢發票只在同期別內有效，跨期退款與部分退貨不能作廢，只能開折讓。詳見發票管理的「折讓紀錄」章節。會跳提醒的入口共 4 個，涵蓋所有能退款 / 退單的地方：
| 位置 | 觸發動作 | 提醒形式 |
|---|---|---|
後台 餐飲 POS → 訂單管理 | 退款、取消訂單 | 彈窗；尚可折讓 > 0 時另有 前往開立折讓單 按鈕，可直接跳到該張發票的折讓畫面 |
| POS 介面 → 訂單查詢 | 退款 | 提示視窗（只有「我知道了」一顆鈕） |
| POS 介面 → 結帳中（結桌帳） | 退單 | 同上 |
| POS 介面 → 桌位時刻表 | 退單 | 同上 |
POS 端這個提示「關不掉」是刻意的
為什麼 POS 端沒有「前往開立折讓單」按鈕
發票模組沒啟用、或該訂單沒有有效發票時，不會有任何提醒，退款流程完全不變。
還原待結單（退錯帳重結）
若店員結錯帳（付款方式選錯、金額按錯、結太早），可把已結帳訂單退回「待結單」重新結一次，不用整單退款重開。
此功能需先於 POS 功能設定 開啟「允許還原待結單（退錯帳）」開關（per-store，見 POS 功能設定），且限店長以上權限：
- 開啟後，「訂單查詢」頁已結帳訂單的操作欄會出現 還原待結單 按鈕。
- 點按跳確認：「
將此訂單還原為「待結單」？（會退回已結帳的集點與消費額，桌位不會重占，還原後可重新結帳）」。 - 確認後：訂單狀態由「已完成」退回「待付款（pending）」、清掉原結帳資訊、退回該筆已發的會員集點與消費額（total_spent），桌位不會重新占用；接著就能重新走結帳流程結對。
- 每次還原都寫稽核紀錄（
pos_order_reopen），可追誰在何時還原哪張單。
還原有發票的單，系統會自動作廢舊發票、重結時開一張新號
發票管理 → 發票列表 依提示處理（開折讓／換期別），再回來還原。
這和上一段「退款 / 取消時系統不自動開折讓」不同：還原是要重結、必須換一張新發票，所以直接作廢舊的；退款則是把錢退掉、發票怎麼處理由人決定。原本就是草稿 / 已作廢 / 開立失敗的發票不需作廢，還原時一併清掉關聯即可。還原 vs 退款 vs 校正金額
訂單金額校正（對帳修正）
如果店員點錯品項單價、或對帳時發現實收金額與訂單不符，可使用 校正金額（對帳修正） 功能：
- 詳情 modal → 點 校正金額 進入校正模式（背景變琥珀色）
- 編輯每筆品項的「單價」，右側即時預覽變動後的小計、總計
- 在「校正原因」欄填寫原因（會寫進 audit_logs，例如「對帳：實收 1800 vs 訂單 1100」）
- 點 儲存校正 完成；點 取消編輯 不存退出
校正不影響點數
pending 與 completed 狀態可進入校正模式。常見問題
Q1 找不到特定訂單
請確認日期範圍篩選條件已涵蓋目標訂單日期，預設僅顯示當日訂單。若已設定正確日期仍無法找到，請嘗試以訂單編號搜尋。
Q2 pending 訂單一直沒結帳怎麼辦
pending 表示訂單尚未結帳，常見於「點餐 → 等客人吃完」場景。請至 POS 介面 → 結桌帳 找到該桌完成結帳；若客人已離開未結，可在訂單詳情按 退款 取消整單（或先用「校正金額」修正）。
Q3 退款金額需要拆分至不同品項
目前退款僅支援整單退款，請於退款原因欄說明退款項目。若需逐品項退款紀錄，建議另建內部追蹤文件。
其他問題協助