發票列表
發票管理集中顯示已建立的電子發票草稿與正式發票,提供新增草稿、開立、作廢、列印、CSV 匯出等操作,並依當前服務商設定顯示目前的開立模式。
進入路徑
後台左側 發票管理 → 發票列表。
主要功能
服務商模式徽章 頁面頂端顯示目前模式(正式 / 測試 / 離線字軌 / 尚未設定 / 未知)以及服務商名稱。
「尚未設定」代表「現在開不出發票」,不是「會用模擬的號碼開出來」。2026-08-21 起,服務商沒選或金鑰沒填齊時,系統一律拒絕開立並回報原因,不會再默默用本系統自編的號碼開出一張假發票;此時列表上不會出現開立按鈕,改為顯示前往設定的連結。詳見「發票參數」章節。 (此前徽章顯示的是mock/sandbox/production三個英文代號,mock一個字混了「沒設定」與「離線字軌」兩件完全不同的事,已拆開改為中文。)
測試環境常駐橫幅 若目前這家分店勾了「使用測試 / 沙箱環境」,本頁(以及發票管理底下每一頁、POS 收銀畫面)最上方會出現一條紅色橫幅,寫明現在開出的發票不具效力。沒勾測試時完全不顯示。看到這條橫幅而您正在正式營業,請立刻到「發票參數 → 服務商設定」取消勾選。
測試發票標籤 在測試模式下開出來的發票,列表上會標一個紅色的「測試」標籤。這些發票不會被隱藏(藏起來只會變成「我剛開的那張去哪了」,而且看不見的資料無法稽核),但不計入首頁的發票統計;匯出 CSV 有 is_test 欄可自行過濾,正式發票與舊資料該欄為空。
狀態與日期篩選 可依「草稿 / 已開立 / 已作廢」狀態與起迄日期篩選;搜尋欄位支援買受人姓名、買受人統編。
新增發票(草稿) 手動建立 B2C / B2B / 捐贈 三種類型的發票草稿。
開立與作廢 草稿列上有一顆開立按鈕,按鈕文字會直接寫出這次會走哪一條路(例如「開立(Amego)」「開立(離線字軌)」);已開立的發票可作廢。
列印 / 補印 已開立的發票可直接送到出單機列印,不會再跳出瀏覽器的列印對話框。印過一次之後,按鈕會變成「補印」,旁邊顯示已印次數,滑鼠移上去可看上次列印時間。
匯出 CSV 依當前日期區間匯出發票清單。
操作流程
新增發票草稿
點擊頁面右上角 新增發票,填寫:
買受人類型 個人 (B2C)、公司 (B2B) 或捐贈。
買受人名稱 B2B 為公司全銜(必填),B2C 為姓名(選填)。
統一編號 B2B 時必填,8 碼數字。
載具 B2C 時可選載具類型(手機條碼 / 會員載具)與載具編號(選填)。
手機條碼的格式:/加 7 碼大寫英數,例:/ABC12+-(可用字元為0-9、A-Z、.、+、-)。格式不對會直接擋在輸入當下、送不出去,畫面上會寫出正確格式。小寫會自動轉大寫、空白會自動去掉。 自然人憑證 2026-09-04 起不再提供新的選擇。若某一筆既有資料本來就是自然人憑證,編輯時它會以「(既有值,不再提供新選擇)」留在下拉中,不會被偷偷改成別的值;改成其他類型之後就不再出現。
捐贈碼 捐贈類型時必選,選項來自「捐贈碼」頁面中啟用的項目。
金額(未稅) / 稅額 / 總計 金額與總計必填。
關聯訂單 ID 選填 UUID,可從訂單頁複製貼上。
確認後送出,建立的草稿出現於列表中,狀態為「草稿」。
開立發票
於草稿列上按開立按鈕。實際走哪一條路,一律以「發票參數 → 服務商設定」選定的服務商為準,按鈕上的文字與確認訊息會直接寫出這一次會發生什麼:
| 服務商設定 | 草稿列上看到什麼 | 按下去會發生什麼 |
|---|---|---|
| Amego / EZPAY,且金鑰齊全並已啟用 | 開立(Amego) / 開立(EZPAY) | 真實呼叫服務商 API 開立 |
| Amego / EZPAY,但金鑰不齊或未勾啟用 | 沒有開立按鈕,改為「前往發票設定」連結 | — |
| 離線字軌 | 開立(離線字軌) | 從「離線字軌」的號碼池配號(不上傳服務商) |
| 尚未設定 | 沒有開立按鈕,改為「前往發票設定」連結 | — |
| 未知(此視角讀不到該店設定) | 開立 | 由該分店的設定決定,不預先宣稱 |
開立成功後,系統會直接把證明聯送到出單機(載具發票除外,見下方「列印 / 補印」)。
2026-08-21 起:不再有第二顆「開立(mock)」按鈕
0 元的訂單不會開發票
作廢發票
於已開立的發票列點擊 作廢。
兩種情況系統會擋下作廢(2026-08-21 起):
這張發票已經開過折讓單 訊息會列出是哪幾張折讓單。折讓是「對一張有效發票的部分沖銷」,原發票被作廢後那些折讓單就失去依附對象,帳會對不起來。要全額沖銷請改開折讓;真的要作廢,請先把折讓單作廢再試。
已經跨申報期別 統一發票以雙月期別申報(1-2 月 / 3-4 月 / …),期別一結算就不能再作廢那期的發票。訊息會告訴您該發票屬於哪一期、現在是哪一期。這種情況只能開折讓。
作廢只在同期別內有效。 跨期退款、部分退貨不能作廢,只能開立折讓單 —— 見下方「折讓」與說明書的「折讓紀錄」章節。
折讓
於已開立的發票列點擊 折讓,可對該張發票開立折讓單(部分或全額)。適用於:
- 該期別已結,無法作廢的跨期退款
- 只退部分品項,原發票仍需有效的部分退貨
彈窗會顯示「原發票金額 / 已折讓 / 本次 / 剩餘」,累計折讓金額不得超過原發票金額;已全額折讓的發票,此按鈕會停用。詳細操作見「折讓紀錄」章節。
列印 / 補印
於已開立的發票列點擊 列印,系統會把證明聯直接送到出單機(Print Bridge), 不會跳出瀏覽器的列印對話框、也不需要您選印表機。
印過的那張按鈕會變成「補印」,旁邊顯示「已印 N 次」,滑鼠移上去可看上次列印時間。 補印會再出一張一模一樣的證明聯(同一個發票號碼),連按兩次就是兩張。
只有真的印出來才會算一次
發票要從哪一台出單機出
到 餐飲 POS → 設定 → 出單機,在那台機器的功能勾選 發票。
沒有任何一台勾選「發票」時,系統會用該分店的收據結帳單那台 (多數店只有一台熱感機,證明聯本來就跟收據同一台)—— 這種情況發票列表頂端會用琥珀色明白寫出「未指定發票印表機,目前會從『某某機』出」, 不會讓您自己猜。若連收據機都沒有,頁面會用紅色標示「發票目前印不出來」並告訴您去哪裡設定。
載具發票不會印紙本
顧客用手機條碼等載具索取的發票,依規定不印紙本證明聯(發票已存進顧客的載具裡)。 按「列印」時系統會告訴您這是正常情況,不是故障。 只有顧客中獎要兌獎時才需要列印,此時確認框會提供「仍要列印(中獎兌獎)」。
查看服務商回應
已開立或已作廢的發票會顯示 服務商回應 按鈕,點開後是一份看得懂的摘要,不需要懂技術:
- 開立結果:開立成功/開立失敗。失敗時會直接把服務商回的原因寫出來(例如金額不符、格式錯誤)
- 發票號碼與隨機碼:這兩個就是對帳、查詢中獎時會用到的號碼
- 開立時間:已換算成台灣時間
- 品項摘要:從發票 QR 碼裡讀出來的品名/數量/單價。
QR 碼容量有限,服務商常把整單彙總成一筆「商品一批」,所以這裡不等同訂單的完整明細
視窗左下角的 顯示原始資料 可以展開服務商回應的原始內容,需要跟服務商客服對帳時用得到。
已作廢的舊發票會寫「已不可考」
兩種特別的標示
匯出 CSV
點擊右上角 匯出 CSV,會依當前的「起始日期 / 結束日期」匯出發票清單,檔名為 invoices_YYYY-MM-DD.csv。
常見問題
Q1 頂端徽章顯示「尚未設定」,代表什麼?
代表服務商尚未選擇、尚未啟用,或 EZPAY / Amego 必填欄位未填齊 —— 也就是現在開不出發票。此時草稿列上不會出現開立按鈕,改為顯示「前往發票設定」連結,不會有任何發票產生。
請至「發票參數 → 服務商設定」完成設定並勾選「啟用此服務商串接」。這是刻意的保護:以前系統會在這個狀態下用自己編的號碼開出發票並印給顧客,那張紙不是有效憑證,事後收不回來。
Q1-1 開票失敗,事後查得到嗎?在哪裡看?
查得到。開票成功與失敗都會留下紀錄,而且從 2026-08-25 起,這些紀錄有三個地方看得到。
在此之前,失敗原因雖然有記在訂單上,卻沒有任何畫面把它顯示出來 —— 等於什麼都沒發生。若您先前累積了一批久未處理的草稿,現在可以用下面第一個入口一次看完。
入口一:發票列表最上方的紅色橫幅
本頁(發票管理 → 發票列表)只要該店還有沒開成的訂單,最上方就會出現一條紅色橫幅:
有 N 筆訂單開立發票失敗,尚未處理
點橫幅右側的 展開明細,會逐筆列出「單號 / 分店 / 金額 / 失敗時間 / 失敗原因全文」。橫幅裡也有一個連結直接跳到訂單管理。
這條橫幅刻意不受頁面上的日期與狀態篩選影響
入口二:後台訂單管理的紅點與「只看開票失敗」
餐飲 POS → 訂單管理:
- 列表「發票」欄的紅點 發票狀態徽章旁多一個小紅點,滑鼠移上去(或長按)會顯示失敗原因。
- 詳情裡的「開票失敗原因」區塊 點 詳情 開啟訂單,會看到紅底區塊顯示失敗原因全文與失敗時間。
- 「只看開票失敗」篩選 列表頂部狀態下拉旁的勾選框,勾起來只列出開票失敗的訂單。未安裝發票模組的租戶不會看到這個勾選框。
入口三:POS 訂單查詢(收銀台當場處理用)
POS 端 餐飲 → 訂單查詢(/pos/restaurant/orders)有完全相同的三件事:列表紅點、詳情裡的失敗原因全文、頂部的「只看開票失敗」勾選框。
補開之前請先看一眼失敗原因
紅點和「開立失敗」徽章不是同一件事
| 判斷依據 | 意思 | |
|---|---|---|
| 開立失敗 徽章 | 發票停在草稿狀態 | 推測這張可能沒開成 |
| 紅點 | 訂單上真的留有失敗原因 | 確實失敗過,而且看得到原因 |
所以有徽章不一定有紅點(例如手動建立、還沒送出的草稿)。
補開成功後,訂單上的失敗原因會自動清掉,紅點與橫幅的數字跟著減少。
另外,使用記錄也查得到
可至 系統管理 → 使用記錄 查開立成功 / 失敗的軌跡。
橫幅沒出現,不代表一定沒有失敗
Q1-2 發票金額和訂單總額對不起來(服務費、折扣)
2026-08-21 已修正:以前發票金額只算商品品項,服務費與整單折扣都沒有進到發票裡,因此加收一成服務費的餐廳,發票金額會比實收金額少。
現在服務費會以獨立品項(例如「服務費 10%」)呈現在發票上,整單折扣則以負數金額的品項呈現,發票總額與訂單總額一致。系統在送出前會再核對一次,金額對不起來就中止不送,不會開出一張數字錯的發票。
2026-08-25 補:上面那次修正只改了「送去服務商的內容」,印出來給顧客的那張紙沒有跟著改 —— 紙上的品項明細仍只列商品,合計卻是含服務費的金額,於是品項相加對不上合計。現在列印與網頁列印頁也走同一份明細,紙上會跟著多出「服務費 10%」與「折扣」這兩行。詳見「本機列印 → 兩張紙的內容」。
這個修正只影響之後開立的發票,先前已開出的發票不會被改動;若涉及金額差異需要更正,請依一般程序作廢(同期別)或開立折讓(跨期別)。
Q1-3 顧客站在櫃檯等紙本,但沒印出來
若該分店沒有設定可用的收據印表機,或列印失敗,系統會在結帳畫面明白告訴您「發票已開立,但證明聯未列印」。
請注意訊息裡的「已開立」三個字:發票本身已經成功開出去了,不要重開一張。請至 訂單管理 找到該筆訂單,開啟詳情後點 補印發票(補印的是同一個號碼,不會產生新號)。
在此之前這種情況是完全靜默的 —— 發票照開、紙沒出來、店員毫不知情。新店開幕、剛換印表機時特別容易遇到,請先確認印表機已設定完成。
Q2 搜尋為什麼找不到我輸入的關鍵字?
頁面內的「搜尋」欄位目前僅比對「買受人姓名」與「買受人統編」兩個欄位。若要找特定日期的發票,請改用上方「起始日期 / 結束日期」篩選。
Q3 已開立的發票可以修改品項嗎?
不行。發票一旦開立,金額與買受人資訊就鎖定,需要更正時請先作廢後重新建立草稿與開立。
其他問題協助