Taiwan eGUI POS Receipt
Taiwan B2C eGUI uniform-invoice POS receipt with carrier and donation-code printing, QR codes and barcode
台灣 B2C 電子發票 POS 收據
在零售銷售點開立合規的 B2C 電子統一發票(eGUI)證明聯 — 含載具與愛心碼列印、雙 QR Code 與 Code-39 條碼
本模組功能
台灣對消費者(B2C)銷售的零售業者須開立電子發票證明聯。 本模組將任一筆銷售轉為完整格式化、符合財政部規定的收據:自您配發的 字軌範圍配給下一個統一發票號碼、加蓋 ROC(民國)日期與 4 位隨機碼,並組建 收據必備的三組機器可讀碼:左方 QR Code、 右方 QR Code 與一組 Code-39 一維條碼。
買方可將發票存於載具 — 手機條碼、自然人憑證或賣方會員 載具 — 或經由愛心碼將其捐贈給已登錄的 慈善機構。本模組會在收據上列印載具或捐贈碼,並自動設定正確的 PrintMark。
主要功能
合規收據與 QR Code
- 左方 QR 依財政部固定欄位順序組建:發票號碼、ROC 日期、隨機碼、未稅與含稅金額(十六進位)、買賣方統編、AES 區塊。
- 右方 QR(
**前綴)承載溢出的商品明細列。 - Code-39 一維條碼編碼期別 + 發票號碼 + 隨機碼。
- 含期別、總額與稅額的人類可讀收據文字。
載具與捐贈
- 支援手機條碼(3J0002)、自然人憑證(CQ0001)與會員載具(1K0001)。
- 各載具條碼的結構驗證。
- 愛心碼(3–7 位)列印。
- 載具與捐贈互斥 — 自動強制執行。
號碼/字軌管理
- 依雙月期別登錄您財政部配發的 2 字母字軌與序號範圍。
- 以列鎖定進行原子化配號 — 多收銀台並行時無重複序號。
- 即時剩餘數量與用罄範圍追蹤。
驗證與安全
- 官方統一編號檢核碼驗證。
- 自足的 AES-128-CBC 用於加密 QR 區塊,以 FIPS-197 測試向量驗證。
- 快速單筆銷售精靈,供臨時登錄收據之用。
左方 QR 欄位配置(財政部 v1.8)
| 欄位 | 長度 | 內容 |
|---|---|---|
| 發票號碼 | 10 | 2 字母 + 8 數字 |
| 日期 | 7 | ROC YYYMMDD |
| 隨機碼 | 4 | 隨機碼 |
| 銷售金額 | 8 | 未稅,十六進位 |
| 總計金額 | 8 | 十六進位 |
| 買方統編 | 8 | 消費者為 00000000 |
| 賣方統編 | 8 | 您的統一編號 |
| AES 區塊 | ≥24 | 發票號碼 + 隨機碼之 Base64 |
自帶金鑰傳輸界線
本模組為格式產生器。它產生 B2C 收據、其 QR Code 與條碼。 它不向政府傳輸任何資料,亦非經認證之 turnkey、加值中心或整合商。底層統一發票訊息上傳至財政部電子發票平台, 係由您自己的 turnkey/加值中心帳號、用您自己 的憑證與 AES 金鑰執行(BYOK)。您的 AES 金鑰留存於您的資料庫,僅用於在本機 組建加密 QR 區塊。
相容性
Odoo 18, 19 與 20,Community 與 Enterprise。僅相依於社群版 account
模組。不需外部 Python 函式庫。
In English
Taiwan B2C eGUI POS Receipt
Issue compliant B2C electronic uniform-invoice (eGUI) receipts at retail point of sale — dual QR codes and a Code-39 barcode
Taiwan retailers selling to consumers must issue an electronic uniform-invoice receipt. This module allocates the next invoice number from your track (字軌) range, stamps the ROC date and a 4-digit random number (隨機碼), and builds the three machine-readable codes: the left QR, the right QR and a Code-39 barcode. Buyers can store the invoice on a carrier (mobile barcode / natural-person certificate / member) or donate it via a love code (愛心碼); the receipt prints it and sets the correct PrintMark automatically.
Receipt, carrier & numbers
Left QR in the exact MOF fixed-field order (invoice no., ROC date, random no., hex amounts, buyer/seller BAN, AES block); right QR for spill-over lines; Code-39 barcode; carrier and donation support (mutually exclusive); atomic row-locked track-number allocation with live remaining counts.
Security & BYOK
Official BAN checksum validation; self-contained AES-128-CBC for the encrypted QR block, verified against FIPS-197 vectors. A format generator — it transmits nothing and is not a certified turnkey/integrator; upload is done by your own account with your own credentials and AES key, which stays in your database. Odoo 18, 19 & 20; depends only on account.
Screenshots
Quick Receipt
Egui Receipts
Invoice Tracks
Update date: 2026-10-03
User guides (PDF)
Related modules
Taiwan eGUI B2C Carrier
Taiwan B2C cloud uniform-invoice carrier registration, donation (love code) workflow and lottery prize check (eGUI)
Taiwan eGUI Inbound
Parse received Taiwan eGUI MIG 4.0 invoice XML into draft vendor bills, matched to the supplier by BAN.
Taiwan eGUI Void Message
Generate Taiwan eGUI void / cancellation messages (MIG 4.0 C0501/C0701/D0501 -> F0501/F0701/G0501) for MOF submission