Skip to Content

Taiwan eGUI POS Receipt

by
Odoo

$ 118.99

v 19.0 Third Party
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Invoicing (account)
• Discuss (mail)
Lines of code 1547
Technical Name l10n_tw_egui_pos_receipt
LicenseOPL-1
Websitehttps://gencbaris.com/odoo_plugins/
Versions 18.0 19.0
You bought this module and need support? Click here!
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Invoicing (account)
• Discuss (mail)
Lines of code 1547
Technical Name l10n_tw_egui_pos_receipt
LicenseOPL-1
Websitehttps://gencbaris.com/odoo_plugins/
Versions 18.0 19.0

台灣 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）

欄位長度內容
發票號碼102 字母 + 8 數字
日期7ROC 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

Quick Receipt

Egui Receipts

Egui Receipts

Invoice Tracks

Invoice Tracks

Odoo Proprietary License v1.0

This software and associated files (the "Software") may only be used (executed,
modified, executed after modifications) if you have purchased a valid license
from the authors, typically via Odoo Apps, or if you have received a written
agreement from the authors of the Software (see the COPYRIGHT file).

You may develop Odoo modules that use the Software as a library (typically
by depending on it, importing it and using its resources), but without copying
any source code or material from the Software. You may distribute those
modules under the license of your choice, provided that this license is
compatible with the terms of the Odoo Proprietary License (For example:
LGPL, MIT, or proprietary licenses similar to this one).

It is forbidden to publish, distribute, sublicense, or sell copies of the Software
or modified copies of the Software.

The above copyright notice and this permission notice must be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author or have a question related to your purchase, please use the support page.