台灣 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，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; depends only on account.
Screenshots
Quick Receipt
Egui Receipts
Invoice Tracks
Update date: 2026-07-02