日結單列印

日結單（X-out）提供當日營業數據快速彙整，可在 POS 訂單頁一鍵列印到收據機。適合店長交班、夜間打烊對帳，或店員每隔幾小時印一張盤點現金。

進入路徑

POS 介面左側 sidebar 點 訂單查詢（路徑 /pos/restaurant/orders），右上角的紫色按鈕 列印日結單。

營收算哪一天、哪些單算營收

日結單是店家對帳的基準，所以先把兩件事講清楚。

一、算哪一天

所有單別一視同仁，不再分單別（2026-08-22 起）。

• 8/1 開單、8/20 客人來取貨付款的預購單 → 算在 8/20，不是 8/1。算在 8/1 等於「錢還沒收到就先認列營收」。
• 跨午夜的內用單不會被切成兩天：23:30 開檯、00:15 才結帳的那一桌仍然整餐留在開檯那一天。做法是下面的「營業日換日點」，不是把它算回開單日。

此規則全系統一致：日結單、訂單彙總表、訂單明細表、結算報表、品項分析、促銷成效、連鎖月結與總覽、後台首頁都用同一套。

一之二、幾點算換日（營業日）

一天的結束不一定是午夜。系統預設凌晨 5:00 才換日：

• 22:00 前打烊的店完全不受影響 —— 那個時段本來就沒有交易。
• 做到凌晨的店（例如熱炒、居酒屋、夜間營業的分店）才會用到：凌晨 1 點結的帳留在前一天，跟店家自己的認知一致。
• 可以各分店設定不同的值（跨夜的分店設 5、不跨夜的分店設 0 都可以）。沒設分店值就沿用全品牌那一份，全品牌也沒設就是 5。

二、哪些單算營收

日結單的銷售統計==只算已完成結帳==的訂單（未結帳、退款、作廢都不計入銷售總額）。未結帳的金額另外印在「補充欄 → 未結帳金額」提醒您去結桌。

報表內容

點按鈕後系統會即時統計今日（台北時區 00:00 至列印當下） 所有訂單，並印出以下分區：

抬頭

• 商店名稱（如該帳號綁定分店）
• 日結單標題
• 日期 / 列印時間 / 收銀員（自動帶當前登入帳號）

訂單概況

類型分析

依訂單類型（內用 / 外帶 / 外送）顯示已完成訂單的件數與金額。

用餐人數總計（2026-06-16 新）

日結單會加印當日內用已完成訂單的用餐人數總計：

內用人數總計    32 位

統計範圍：status = completed 且 order_type = dine_in，加總 guest_count 欄位。可用於：

• 估算人均消費（淨營收 / 人數）
• 預估明日備餐量
• 對比座位週轉率（人數 ÷ 桌數）

外帶 / 外送不計入此數，因無「人數」概念。

午市 / 晚市（2026-08-13 新）

日結單會多印一段 【午市 / 晚市】，把當日已完成訂單拆成兩段各自統計單數與金額：

切點固定為台北時間 16:00，歸段依據與「算哪一天」同一個時間＝結帳時間。

每一段各印出單數與金額，該段若有內用客人，下方會再縮排一行顯示該段的用餐人數。

只統計已完成訂單，與上方「訂單概況」的完成單數口徑一致；未結帳、退款、作廢不進這段，所以午市 + 晚市會等於當日已完成訂單的銷售總額。

金額統計

付款方式

依「付款方式」設定分組顯示各類型金額，並以金額由大到小排序。系統會自動合併以下兩種來源：

1. 拆單付款：客人用兩種以上方式付款，從 pos_order_payments 表撈
2. 單一付款：客人付一筆，從訂單本身的 payment_method_id 撈

分成三段印（2026-08-13 新）　付款方式改為依序印出 午市 (~16:00) → 晚市 (16:00~) → 全日合計，分段規則與上方「午市 / 晚市」相同（切點台北 16:00；一律依結帳時間歸段）。

先印分段、最後印全日合計，是因為店家實際的動作是「每個時段各數一次抽屜」，看自己那一段最省事；全日合計放最後當交叉核對 —— 兩段相加應該等於全日合計，對不上就知道是哪一段有問題。

該段若完全沒有該時段的訂單，那一段就不會印出來（不會出現空白區塊）。

商品銷售 TOP 15

依販售數量由多到少列出當日已完成訂單最熱銷的 15 個品項，附帶銷售金額。可用於：

• 判斷哪些品項要補備料
• 找出滯銷品做菜單微調
• 發掘搭配組合（搭配「訂單明細表」交叉看）

當日銷售明細（預設不印）

列出當日全部品項的數量與金額（不只前 15 名）。 這個區塊預設是關的，要印請到：

餐飲 POS → 設定 → 出單機 → 列印格式 → 店家預設・日結報表單版面

勾選「當日銷售明細（全品項）」後右側預覽會馬上反應。設定是逐分店的。

三個子選項：

這張單能自己對帳

明細最下方的「明細合計」等於【金額統計】的「商品小計」。 兩個數字來自同一組訂單、同一個欄位，所以一定對得起來 —— 就算只印前 10 名也一樣（剪掉的那些會以「其餘 N 項」帶著金額補回來）。

⚠️ 明細合計不等於「銷售總額」。銷售總額還要再扣整單折扣、加服務費：

銷售總額 = 商品小計（= 明細合計）- 折扣 + 服務費

若真的印出「※ 與商品小計差 $X」這一行，代表該日資料有異常，請截圖回報 —— 這行在正常情況下永遠不會出現。

哪些單會被算進去

跟「商品小計」完全一致，不另外訂規則：

• 只算已完成（completed）的單—— 退款單 / 作廢單 / 未結帳單都不進明細
• 贈品（招待）：數量照算、金額是 $0（送出去幾份看得到，但不算營收）
• 預購單：依取貨結帳當天歸戶（同日結單其他區塊）
• 日界線依貴店設的營業日換日點（非午夜 12 點）

58mm 紙的限制

58mm 出單機一行只有 32 個半形字（約 16 個中文）。扣掉右側的數量與金額後， 品名大約只剩 8～9 個中文，過長的品名會被截斷並加上 `..`。 存檔前可先把預覽右上的「預覽紙寬」切到 58mm 看實際效果。

想看完整品名請換 80mm 出單機，或改看後台的「訂單明細表」。

已經開了「當日銷售明細」的話，上方的「商品銷售 TOP 15」就重複了， 可以在同一頁把 TOP 關掉省紙。

補充欄

• 未結帳金額：當日仍 pending 的訂單金額（提醒店員去結桌）
• 集點發出：當日已發出的點數總數

多分店帳號的行為

常見問題

Q1　按下按鈕後沒列印

請依序檢查：

1. 出單機 IP 設定是否正確（餐飲 POS → 出單機）
2. POS 主機的 Print Bridge 是否啟動（系統匣應有 icon）
3. 印表機電源 / 紙張是否正常
4. 印表機與 POS 主機是否在同一網段

失敗時系統會顯示「Print Bridge 未啟動」或「日結單 X/Y 成功」提示。

Q2　想印昨天 / 特定日期的日結單

目前 UI 只支援今日。若需查歷史日期，可改打 API：

GET /api/pos-restaurant/daily-report?date=2026-06-06

或使用「訂單彙總表」用自訂日期範圍查詢。

Q3　數字跟訂單彙總表不一致

可能原因：

• 時區差：日結單以台北時區算，彙總表若用日曆控件選日期也是台北時區，理論上一致。若不一致請回報並附兩張畫面截圖。
• 狀態差異：日結單僅 completed 進銷售統計；彙總表如有 include 其他 status 則會偏多。
• 退款金額：日結單把退款獨立顯示，彙總表可能合併計算。

和後台首頁「今日營收」對不上是正常的：首頁含尚未結帳的單，日結單不含，首頁通常比較大。說明見上方哪些單算營收。

Q4　日結單可以自動定時列印嗎

目前需手動按按鈕。如有自動排程需求（例：每晚 23:59 自動印一張結班），可另外開發定時任務。