發票參數
發票設定分為三個分頁：發票參數（控制模組是否啟用、稅率、預設載具等行為）、服務商設定（EZPAY 或 Amego 串接憑證）與證明聯版面（在證明聯最上方加 logo、最下方加自訂文字）。完成服務商設定並勾選啟用後，發票開立才會走真實 API。
服務商沒設好，系統不會替您開發票
進入路徑
後台左側 發票管理 → 發票參數。
設定範圍（可全店共用，也可各分店獨立）
發票設定支援多分店各自獨立。後端以 key-value 方式儲存於 pos_invoice_settings 表，每筆帶 store_id：
- 全店共用預設：未選定特定分店（或該分店尚未覆寫）時，讀寫的是「全店共用」那一份。所有分店預設沿用這一份。
- 分店專屬覆寫：切換到某一分店後在本頁儲存，會建立該分店專屬的發票參數 / 服務商設定，只影響該店，不動其他分店與全店共用預設。
切換分店用左上角的分店切換器；切換後本頁會重新載入該店的設定，並在頁面上方顯示目前是「沿用全店共用」還是「此分店已設定專屬」。
各分店可設不同賣方統編 / 賣方名稱 / Amego 帳號
分頁一 發票參數
啟用發票模組 這是本店的發票總開關。取消勾選並儲存之後，所有開立路徑一律停止：餐飲 POS 結帳彈窗、結帳後自動開立、發票列表的手動開立與補開、電商訂單、儲值加值、零售 POS，全部都不會再開出任何一張發票。
停用之後仍然做得到的事
停用時操作畫面會看到什麼
2026-09-01 之前這一格是無效的
訂單結帳後自動開立發票 勾選後，POS 結帳完成將自動在背景建立並開立發票（不跳窗）。
結帳後跳出發票視窗 預設關。開啟後，餐飲 POS 與零售 POS 結帳按下「確認結帳」都會先彈出發票視窗，讓收銀當場選擇本次發票開立方式；未開啟則維持原本結帳流程、不跳窗。此為「啟用發票模組 + 本開關」雙條件，兩者皆開才會跳窗。
彈窗內容兩業態不完全一樣：兩邊都可選手機載具 / 統一編號 / 索取紙本，該店有設定捐贈碼時兩邊都會多一顆「捐贈」。差異只在——零售多一顆「會員載具」、統一編號不能填買方名稱、也沒有「不開發票」這個選項（餐飲有）。零售的彈窗會把收銀台掃描列「發票」鈕（「發票設定」視窗）已選的內容帶進來預填，確認後再寫回去。詳細操作見餐飲 POS 的「結帳自動開發票」與零售 POS 的「收銀檯」說明。
稅率 0 至 1 之間的小數，預設 0.05（即 5%）。開立與折讓都讀這一格，兩邊算出來的稅額一致。
售價一律是含稅價
預設載具類型 不指定 / 手機條碼 / 會員載具，決定結帳發票視窗一打開時預先選在哪一格。收銀當下仍可改成別的。
「不指定」是這一格沒有被設定過
自然人憑證 2026-09-04 起不再提供新的選擇
掃碼後自動送出 勾選框，預設關閉，每間分店可各自設定。指的是結帳發票視窗裡的「手機條碼載具」欄位——掃碼槍掃完會自己送出一個 Enter：
| 設定 | 行為 |
|---|---|
| 開啟 | 掃到的載具格式正確時，等同按下「確認」，直接完成結帳，收銀不必再點一次 |
| 關閉（預設） | 掃到的值只填進欄位，仍要收銀自己按「確認」 |
格式不正確時兩種設定都不會送出，一律停在欄位讓人重掃。
開之前請想清楚
設定完成後點擊 儲存發票參數。
分頁二 服務商設定
先選「服務商」，共四個選項
| 選項 | 意思 |
|---|---|
| 尚未設定（不會開立發票） | 預設值。這個狀態下開不出任何發票，結帳時會明確報錯。新開通的租戶都是這一個 |
| EZPAY 簡單付 | 走 EZPAY 真實 API |
| Amego 光貿（雲端發票機） | 走 Amego 真實 API，實體發票機會自動印出 |
| 離線字軌（不串服務商，號碼由本系統配發） | 發票號碼由本系統從「離線字軌」的號碼池配發，不會上傳任何服務商、也不會上傳財政部。僅供測試或紙本手開流程使用 |
「離線字軌」是刻意選的，不是設定沒填好的替代品
頂端狀態徽章
徽章顯示在「發票列表」頁面頂端，共五種（2026-08-21 起改為中文，此前顯示的是 mock / sandbox / production 三種英文代號）：
| 徽章 | 意思 |
|---|---|
| 尚未設定（紅） | 還沒選服務商，或選了 EZPAY / Amego 但必填欄位未填齊或未勾「啟用」。這個狀態下開不出發票，列表上也不會出現開立按鈕，改為顯示前往設定的連結 |
| 測試（黃） | 已啟用且勾選「使用測試 / 沙箱環境」。這個狀態下開出來的發票沒有稅務效力。<br>EZPAY：呼叫 EZPAY 沙箱站台。<br>Amego：改用光貿的公開測試帳號（統編 12345678），完全不會用到您自己填的 APP_ID / APP_KEY（見下方「共用選項」與 Q2） |
| 正式（綠） | 已啟用且未勾選測試；呼叫正式 API，發票具法律效力，請謹慎操作 |
| 離線字軌 | 在服務商下拉明確選了「離線字軌」，號碼由本系統的字軌池配發，不送服務商 |
| 未知 | 這個視角讀不到該店的服務商設定（例如總部視角尚未切到分店）。此時仍保留開立按鈕，實際走哪一條由該分店的設定決定；作廢一律以真實作廢送出 |
服務商設定只有「租戶管理員」能看與能改（2026-09-03 起）
發票管理 → 發票列表 頁上方的狀態標籤（正式環境 / 測試環境 / 離線字軌 / 無法開立），那一列不含任何金鑰，所有角色都看得到。金鑰只進不出：畫面上不會再顯示完整金鑰
abcd••••••••wxyz」。
- 留空直接儲存 ＝ 維持原本的金鑰，不會被清掉。可以放心只改賣方名稱、字軌或勾選項再存檔。
- 要更換金鑰才在欄位輸入新的那一串。
- 分店第一次建立「專屬設定」時同理：留空即沿用全店共用那一份的金鑰。EZPAY 簡單付
需填寫：
商店代號 Merchant ID
Hash Key 32 碼。
Hash IV 16 碼。
Amego 光貿（雲端發票機）
需填寫：
APP_ID 光貿識別碼 / 會員號。
APP_KEY API 金鑰，可於光貿後台 → 我的帳戶 → API 設定取得。
賣方統編（Seller Identifier） 8 碼公司統編。
字軌（InvoiceTrack） 自動配號時可留空。
自動配號 勾選後由 Amego 後台配發發票字軌號（推薦）。
共用選項
使用測試 / 沙箱環境 勾選後，這一格的設定範圍（該分店或全店共用）開出來的發票沒有稅務效力，是給您試開來看的。
勾了就要記得取消 —— 忘記取消是這個功能最大的風險
12345678）送出，完全不會用到您自己填的 APP_ID / APP_KEY。統編與字軌會一起換成測試帳號那一組，證明聯上的賣方名稱會印成「測試發票（光貿測試帳號）」。
- EZPAY：連到 EZPAY 的沙箱站台。
- 離線字軌：不受這一格影響（它本來就不送任何服務商）。
測試完務必回到本頁取消勾選並儲存。 忘記取消的後果是：真實營業的每一張發票都開在測試帳號底下，而且沒有任何錯誤訊息，通常要到月底對帳才會發現 —— 那時候發票已經跟著客人走了。
系統為此做了三道提醒，但它們都只是提醒，不會替您取消勾選：
1. 勾選當下，勾選框下方會立刻出現紅字說明會發生什麼事。
2. 勾選期間，後台「發票管理」每一頁與 POS 收銀畫面上方都會掛一條常駐紅色橫幅（沒勾時完全不出現）。
3. 這個範圍已經開過正式發票時，要打開測試模式會被擋下並跳出二次確認框，明白告訴您已經開過幾張正式發票 —— 那幾乎一定是誤操作。詳見 Q2-1。
勾選期間開出的每一張發票，在發票列表上都會標上紅色的「測試」標籤；匯出 CSV 也有 is_test 欄可以過濾。測試發票不會被隱藏（藏起來只會變成「我剛開的那張去哪了」），但不計入首頁的發票統計。您自己填的正式金鑰不會被覆蓋：測試帳號的替換只發生在「送出去的那一刻」，資料庫裡存的一直是您填的那一組，取消勾選就立刻恢復。
詳見「發票開通清單」第 5 項。
啟用此服務商串接 必勾。未勾選時徽章為「尚未設定」，代表開票會被擋下並回報「服務商尚未設定完成」。
設定完成後點擊 儲存服務商設定。
賣方名稱（證明聯抬頭）
選完服務商後有一個「賣方名稱（證明聯抬頭）」欄位，填的是印在電子發票證明聯上的公司抬頭。四種服務商選項都適用。
留空即可：留空時沿用全店共用設定，全店共用也沒填則用系統裡的商家名稱 —— 也就是 2026-08-21 之前的行為。既有商家不填任何東西，印出來的內容完全不變。
什麼時候要填：連鎖店的各分店若是不同法人（各自有不同的公司登記名稱與統編），請切到該分店後分別填寫。賣方統編本來就已經可以各店分別設定，但名稱此前一律取全公司那一個，於是分店的證明聯會印出「本店統編 + 別家公司名稱」，是一張自相矛盾的憑證。
這個欄位只影響列印與畫面顯示，不影響申報
統編檢核（僅 Amego）
啟用 Amego 後會出現 測試統編檢核 按鈕，會跳出輸入框讓您輸入任一買方統編（8 碼），呼叫 Amego ban_query 即時驗證，並顯示對應公司名稱，便於確認服務商連線正常。
檢核問的是財政部的公司登記資料，與是哪一間分店無關；系統會自動找一組可用的服務商金鑰去問，多分店租戶不需要切到特定分店才能檢核。
檢核通過代表「光貿連得上」，不代表「這一家分店設好了」
服務商 = Amego + 勾「啟用此服務商串接」 + APP_ID + APP_KEY 都有），不是看檢核綠不綠。完整說明見「發票開通清單」驗收 A。還沒設好服務商時，會明講「無法檢核」，不會當成通過
分頁三 證明聯版面
在電子發票證明聯的最上方加一張店家 logo、最下方加自訂文字（例如「歡迎再度光臨」、訂位專線）。
法定欄位不能改
最上方 logo
按「選擇圖片」上傳 PNG / JPG。
畫面上顯示的就是實際印出來的樣子（不是原圖）——出單機是單色熱感機，彩色圖片會印成黑白剪影，所以系統在上傳當下就先轉好給您看。
- 太寬的圖會等比縮小到紙寬（384 點），不會被裁掉；高度上限 240 點。
- 若轉出來太黑或太淡，拉「黑白門檻」調整；照片型 logo 可勾「網點模式」讓它有層次（線稿 / 文字 logo 不要勾，會出現雜點）。
- 想暫時不印但保留圖片，取消勾選「列印 logo」即可，不必重新上傳。
- 調整黑白效果必須重新選一次圖片：已轉好的點陣再轉一次只會越轉越糊。
底部自訂文字
兩個欄位，分別對應兩張紙：
| 欄位 | 印在哪 | 說明 |
|---|---|---|
| 證明聯底部文字 | 財政部二維條碼下方 | 法定區塊之後，最多 8 行 |
| 消費明細底部文字 | 第二張「消費明細」最下方 | 消費明細不是法定文件，內容可自由填寫 |
一行一句，可設定靠左 / 置中 / 靠右。
出單預覽
右側預覽是實際出單程式產生的版面，不是示意圖：設定改了，預覽與印出來會一起變。金額與品項是固定範例，賣方抬頭與統編則取自本店的服務商設定 —— 多分店法人不同時，可在這裡確認抬頭印的是不是該店的公司名稱。
預覽下方會顯示紙寬、編碼與指令集，方便現場對照出單機設定。
這一頁也是分店獨立的
與其他兩個分頁相同：切到某分店後儲存，會建立該分店專屬的證明聯版面，不影響其他分店。沒設定過的分店沿用全店共用那一份；全店共用也沒設，就是完全不印 logo 與自訂文字（＝這個功能出現之前的樣子）。
常見問題
Q1 如何確認服務商設定已生效？
儲存後，回到「發票列表」頁面，頂端徽章會顯示「正式」／「測試」／「離線字軌」及目前服務商名稱；若仍顯示「尚未設定」，請檢查是否勾選「啟用此服務商串接」，以及 EZPAY 三欄或 Amego 兩個必填欄位是否完整。
徽章顯示「尚未設定」就等於「現在開不出發票」，此時發票列表上的開立按鈕會換成一條前往本頁的連結，請務必在開始營業前處理掉。
Q1-1 結帳時出現「尚未設定發票服務商 / 服務商尚未設定完成」怎麼辦？
代表本店（或全店共用）的服務商設定不完整，系統為了避免開出假發票而中止了開立。請依訊息處理：
「尚未設定發票服務商」 服務商下拉還停在「尚未設定」，請選擇正確的服務商。
「（Amego）尚未設定完成」 APP_ID / APP_KEY 沒填齊，或「啟用此服務商串接」沒勾。
「（EZPAY）尚未設定完成」 MerchantID / HashKey / HashIV 沒填齊，或沒勾啟用。
多分店租戶請特別確認是切到那一間店在看設定 —— 開票用的是「該張發票所屬分店」的那一份。
補好設定後，可至 發票管理 → 發票列表 找到停在「草稿」的那筆，手動補開。
Q2 測試環境與正式環境如何切換？
於「服務商設定」分頁勾選 / 取消「使用測試 / 沙箱環境」再儲存即可。
勾選 = 試開模式：開出來的發票沒有稅務效力。Amego 會改走光貿公開測試帳號（統編 12345678），EZPAY 會連到沙箱站台。想確認流程跑得通、確認紙印得出來，用這個模式試開最安全。
取消 = 正式營業：開出來的是真發票。
測試完一定要取消勾選。 這是整個發票設定裡最容易造成實質損失的一格 —— 忘記取消，真實營業的發票會全部開在測試帳號下，客人的發票無效、貴店的營業發票紀錄是空的，而且沒有任何錯誤訊息。詳細後果與系統提供的三道提醒見「服務商設定 → 共用選項」。
想試但不想承擔忘記取消的風險？先用「測試統編檢核」
Q2-1 打開測試環境時跳出「此分店已開立過 N 張正式發票」，是什麼意思？
代表這個設定範圍（該分店或全店共用）已經在正式營業開票了，此時要切到測試模式幾乎一定是誤操作，所以系統會擋下來要您再確認一次。
框裡的張數是後端即時算出來的（只算已開立、不含測試發票），不是畫面上那一頁的筆數。
- 確實要切（例如要重新驗收某項流程）→ 按確認，並當場記下待辦：測完要取消勾選。
- 不是故意勾的 → 按取消，把「使用測試 / 沙箱環境」取消勾選後再儲存。
還沒開過任何正式發票的新店不會跳這個框（沒有東西可以搞砸），直接儲存即可。
Q3 可以同時設定 EZPAY 與 Amego 嗎？
服務商欄位為單選下拉。同一時間只會以下拉中選定的服務商運作；切換時舊服務商的憑證會保留，可隨時切回。
切換到 production 前必確認
併桌發票預設（餐飲）
餐飲 POS 多桌一起結帳時，發票可以「合併開一張」或「分開各開」。這裡設定的是結帳時的預設值：
- 分開各開（預設）：併桌結帳時，每張訂單各自開自己的發票。
- 合併開一張：併桌結帳時，預設開立一張涵蓋所有訂單的發票。
此為逐店設定（多分店各自獨立）。無論預設為何，收銀在結帳彈窗當下都能覆蓋這個選擇。實際併桌結帳操作見餐飲 POS 的 結桌帳。
其他問題協助