UGOMK 操作手冊
01 章 / 共 7

發票列表

發票管理集中顯示已建立的電子發票草稿與正式發票,提供新增草稿、開立、作廢、列印、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-9A-Z.+-)。格式不對會直接擋在輸入當下、送不出去,畫面上會寫出正確格式。小寫會自動轉大寫、空白會自動去掉。 自然人憑證 2026-09-04 起不再提供新的選擇。若某一筆既有資料本來就是自然人憑證,編輯時它會以「(既有值,不再提供新選擇)」留在下拉中,不會被偷偷改成別的值;改成其他類型之後就不再出現。

捐贈碼 捐贈類型時必選,選項來自「捐贈碼」頁面中啟用的項目。

金額(未稅) / 稅額 / 總計 金額與總計必填。

關聯訂單 ID 選填 UUID,可從訂單頁複製貼上。

確認後送出,建立的草稿出現於列表中,狀態為「草稿」。

開立發票

於草稿列上按開立按鈕。實際走哪一條路,一律以「發票參數 → 服務商設定」選定的服務商為準,按鈕上的文字與確認訊息會直接寫出這一次會發生什麼:

服務商設定草稿列上看到什麼按下去會發生什麼
Amego / EZPAY,且金鑰齊全並已啟用開立(Amego) / 開立(EZPAY)真實呼叫服務商 API 開立
Amego / EZPAY,但金鑰不齊或未勾啟用沒有開立按鈕,改為「前往發票設定」連結
離線字軌開立(離線字軌)從「離線字軌」的號碼池配號(不上傳服務商)
尚未設定沒有開立按鈕,改為「前往發票設定」連結
未知(此視角讀不到該店設定)開立由該分店的設定決定,不預先宣稱

開立成功後,系統會直接把證明聯送到出單機(載具發票除外,見下方「列印 / 補印」)。

2026-08-21 起:不再有第二顆「開立(mock)」按鈕

此前每一列有兩顆按鈕,其中一顆標示 mock、確認訊息寫著「將分配本地字軌號」—— 但它呼叫的是同一個功能,在已串接服務商的店按下去會真的開出一張正式發票,文案與實際後果完全相反。另一種情況(服務商設定不完整)則是按下去必定失敗。 現在改成:走得通就給一顆說得出實情的按鈕,走不通就不給按鈕、直接告訴您缺什麼、往哪裡去設。若您要的是本系統配號的離線發票,請到「發票參數 → 服務商」明確選擇「離線字軌」。

0 元的訂單不會開發票

金額為 0 的訂單(全額招待、全額折抵)系統不會建立發票草稿、也不會開票,結帳照常完成。原因是 0 元電子發票產不出 QRcode,開出來既印不了正本、事後也補印不了,留著只會變成一筆永遠處理不掉的異常。

作廢發票

於已開立的發票列點擊 作廢

兩種情況系統會擋下作廢(2026-08-21 起):

這張發票已經開過折讓單 訊息會列出是哪幾張折讓單。折讓是「對一張有效發票的部分沖銷」,原發票被作廢後那些折讓單就失去依附對象,帳會對不起來。要全額沖銷請改開折讓;真的要作廢,請先把折讓單作廢再試。

已經跨申報期別 統一發票以雙月期別申報(1-2 月 / 3-4 月 / …),期別一結算就不能再作廢那期的發票。訊息會告訴您該發票屬於哪一期、現在是哪一期。這種情況只能開折讓。

作廢只在同期別內有效。 跨期退款、部分退貨不能作廢,只能開立折讓單 —— 見下方「折讓」與說明書的「折讓紀錄」章節。

折讓

於已開立的發票列點擊 折讓,可對該張發票開立折讓單(部分或全額)。適用於:

  • 該期別已結,無法作廢的跨期退款
  • 只退部分品項,原發票仍需有效的部分退貨

彈窗會顯示「原發票金額 / 已折讓 / 本次 / 剩餘」,累計折讓金額不得超過原發票金額;已全額折讓的發票,此按鈕會停用。詳細操作見「折讓紀錄」章節。

列印 / 補印

於已開立的發票列點擊 列印,系統會把證明聯直接送到出單機(Print Bridge), 不會跳出瀏覽器的列印對話框、也不需要您選印表機

印過的那張按鈕會變成「補印」,旁邊顯示「已印 N 次」,滑鼠移上去可看上次列印時間。 補印會再出一張一模一樣的證明聯(同一個發票號碼),連按兩次就是兩張。

只有真的印出來才會算一次

列印次數只在「出單機確實收到並印出」時才 +1。以下情況不會被記成已印,按鈕也會維持「列印」: - 這台電腦沒有啟動 Print Bridge(畫面會明說「Print Bridge 未啟動」) - 出單機不通、印表機關機 - 這家分店還沒設定發票/收據印表機 因為「畫面寫著補印、紙卻從來沒出來」比沒有這個功能更容易誤導。

發票要從哪一台出單機出

餐飲 POS → 設定 → 出單機,在那台機器的功能勾選 發票

沒有任何一台勾選「發票」時,系統會用該分店的收據結帳單那台 (多數店只有一台熱感機,證明聯本來就跟收據同一台)—— 這種情況發票列表頂端會用琥珀色明白寫出「未指定發票印表機,目前會從『某某機』出」, 不會讓您自己猜。若連收據機都沒有,頁面會用紅色標示「發票目前印不出來」並告訴您去哪裡設定。

載具發票不會印紙本

顧客用手機條碼等載具索取的發票,依規定不印紙本證明聯(發票已存進顧客的載具裡)。 按「列印」時系統會告訴您這是正常情況,不是故障。 只有顧客中獎要兌獎時才需要列印,此時確認框會提供「仍要列印(中獎兌獎)」。

查看服務商回應

已開立或已作廢的發票會顯示 服務商回應 按鈕,點開後是一份看得懂的摘要,不需要懂技術:

  • 開立結果:開立成功/開立失敗。失敗時會直接把服務商回的原因寫出來(例如金額不符、格式錯誤)
  • 發票號碼隨機碼:這兩個就是對帳、查詢中獎時會用到的號碼
  • 開立時間:已換算成台灣時間
  • 品項摘要:從發票 QR 碼裡讀出來的品名/數量/單價。

QR 碼容量有限,服務商常把整單彙總成一筆「商品一批」,所以這裡不等同訂單的完整明細

視窗左下角的 顯示原始資料 可以展開服務商回應的原始內容,需要跟服務商客服對帳時用得到。

已作廢的舊發票會寫「已不可考」

2026-08-25 之前作廢的發票,作廢時會把開立當下的資料整包覆蓋掉, 因此隨機碼、開立時間、品項摘要已經永久遺失,視窗會明白寫出「已不可考」。 這不是系統壞掉,也不是「本來就沒有」—— 是曾經有但被洗掉了,所以不用再去別的地方找。 發票號碼與金額存在另外的欄位,沒有受影響。這個問題已於 2026-08-25 修正, 之後作廢的發票會同時保留開立資料與作廢結果。

兩種特別的標示

- 離線字軌:號碼由本系統的字軌池配發,服務商端沒有這張發票,因此沒有隨機碼。它仍是正式發票。 - 模擬發票:服務商尚未設定完成,系統沒有真的送出開立請求,財政部端不存在這張發票,請勿拿去對帳或交付顧客。

匯出 CSV

點擊右上角 匯出 CSV,會依當前的「起始日期 / 結束日期」匯出發票清單,檔名為 invoices_YYYY-MM-DD.csv

常見問題

Q1 頂端徽章顯示「尚未設定」,代表什麼?

代表服務商尚未選擇、尚未啟用,或 EZPAY / Amego 必填欄位未填齊 —— 也就是現在開不出發票。此時草稿列上不會出現開立按鈕,改為顯示「前往發票設定」連結,不會有任何發票產生。

請至「發票參數 → 服務商設定」完成設定並勾選「啟用此服務商串接」。這是刻意的保護:以前系統會在這個狀態下用自己編的號碼開出發票並印給顧客,那張紙不是有效憑證,事後收不回來。

Q1-1 開票失敗,事後查得到嗎?在哪裡看?

查得到。開票成功與失敗都會留下紀錄,而且從 2026-08-25 起,這些紀錄有三個地方看得到

在此之前,失敗原因雖然有記在訂單上,卻沒有任何畫面把它顯示出來 —— 等於什麼都沒發生。若您先前累積了一批久未處理的草稿,現在可以用下面第一個入口一次看完。

入口一:發票列表最上方的紅色橫幅

本頁(發票管理 → 發票列表)只要該店還有沒開成的訂單,最上方就會出現一條紅色橫幅

有 N 筆訂單開立發票失敗,尚未處理

點橫幅右側的 展開明細,會逐筆列出「單號 / 分店 / 金額 / 失敗時間 / 失敗原因全文」。橫幅裡也有一個連結直接跳到訂單管理。

這條橫幅刻意不受頁面上的日期與狀態篩選影響

它回答的是「這間店現在總共有幾張沒開成」,不是「這一頁列出的發票裡有幾張失敗」。所以就算您把日期縮到今天,橫幅上的數字仍是全部未處理的筆數。 明細一次最多列 50 筆;超過時最後一行會寫「另有 N 筆未列出」,請改用下面的入口二看完整清單。

入口二:後台訂單管理的紅點與「只看開票失敗」

餐飲 POS → 訂單管理

  • 列表「發票」欄的紅點 發票狀態徽章旁多一個小紅點,滑鼠移上去(或長按)會顯示失敗原因。
  • 詳情裡的「開票失敗原因」區塊 點 詳情 開啟訂單,會看到紅底區塊顯示失敗原因全文與失敗時間
  • 「只看開票失敗」篩選 列表頂部狀態下拉旁的勾選框,勾起來只列出開票失敗的訂單。未安裝發票模組的租戶不會看到這個勾選框。

入口三:POS 訂單查詢(收銀台當場處理用)

POS 端 餐飲 → 訂單查詢/pos/restaurant/orders)有完全相同的三件事:列表紅點、詳情裡的失敗原因全文、頂部的「只看開票失敗」勾選框。

補開之前請先看一眼失敗原因

POS 訂單詳情裡,失敗原因就顯示在 重試補開發票 按鈕的正上方 —— 這是刻意的。 背景自動開票失敗時,店員與店長在畫面上看不到任何提示(連那個幾秒就消失的錯誤訊息都沒有)。不知道上一次為什麼失敗,就只會用同樣的資料再失敗一次。常見原因例如買方統編填錯、載具號格式不對,這些要先改草稿內容才補得成功。

紅點和「開立失敗」徽章不是同一件事

判斷依據意思
開立失敗 徽章發票停在草稿狀態推測這張可能沒開成
紅點訂單上真的留有失敗原因確實失敗過,而且看得到原因

所以有徽章不一定有紅點(例如手動建立、還沒送出的草稿)。

補開成功後,訂單上的失敗原因會自動清掉,紅點與橫幅的數字跟著減少。

另外,使用記錄也查得到

可至 系統管理 → 使用記錄 查開立成功 / 失敗的軌跡。

橫幅沒出現,不代表一定沒有失敗

少數尚未完成升級的租戶讀不到失敗紀錄欄位,這種情況橫幅不會出現(而不是顯示「0 筆」)。系統刻意把「這個租戶還沒有這個功能」與「這個租戶沒有失敗」分成兩件事。若您有草稿長期未處理卻看不到橫幅,請聯繫客服。

Q1-2 發票金額和訂單總額對不起來(服務費、折扣)

2026-08-21 已修正:以前發票金額只算商品品項,服務費與整單折扣都沒有進到發票裡,因此加收一成服務費的餐廳,發票金額會比實收金額少。

現在服務費會以獨立品項(例如「服務費 10%」)呈現在發票上,整單折扣則以負數金額的品項呈現,發票總額與訂單總額一致。系統在送出前會再核對一次,金額對不起來就中止不送,不會開出一張數字錯的發票。

2026-08-25 補:上面那次修正只改了「送去服務商的內容」,印出來給顧客的那張紙沒有跟著改 —— 紙上的品項明細仍只列商品,合計卻是含服務費的金額,於是品項相加對不上合計。現在列印與網頁列印頁也走同一份明細,紙上會跟著多出「服務費 10%」與「折扣」這兩行。詳見「本機列印 → 兩張紙的內容」。

這個修正只影響之後開立的發票,先前已開出的發票不會被改動;若涉及金額差異需要更正,請依一般程序作廢(同期別)或開立折讓(跨期別)。

Q1-3 顧客站在櫃檯等紙本,但沒印出來

若該分店沒有設定可用的收據印表機,或列印失敗,系統會在結帳畫面明白告訴您「發票已開立,但證明聯未列印」。

請注意訊息裡的「已開立」三個字:發票本身已經成功開出去了,不要重開一張。請至 訂單管理 找到該筆訂單,開啟詳情後點 補印發票(補印的是同一個號碼,不會產生新號)。

在此之前這種情況是完全靜默的 —— 發票照開、紙沒出來、店員毫不知情。新店開幕、剛換印表機時特別容易遇到,請先確認印表機已設定完成。

Q2 搜尋為什麼找不到我輸入的關鍵字?

頁面內的「搜尋」欄位目前僅比對「買受人姓名」與「買受人統編」兩個欄位。若要找特定日期的發票,請改用上方「起始日期 / 結束日期」篩選。

Q3 已開立的發票可以修改品項嗎?

不行。發票一旦開立,金額與買受人資訊就鎖定,需要更正時請先作廢後重新建立草稿與開立。

其他問題協助

若遇本說明未涵蓋的問題,請透過後台右下角 LINE 客服 @ugomk 聯繫真人專員協助處理。