| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Invoicing (account)
• Point of Sale (point_of_sale) • Discuss (mail) • Inventory (stock) |
| Lines of code | 356 |
| Technical Name |
fiscobridge_pos |
| License | LGPL-3 |
| Website | https://fiscobridge.com |
| Versions | 17.0 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Invoicing (account)
• Point of Sale (point_of_sale) • Discuss (mail) • Inventory (stock) |
| Lines of code | 356 |
| Technical Name |
fiscobridge_pos |
| License | LGPL-3 |
| Website | https://fiscobridge.com |
| Versions | 17.0 18.0 19.0 |
FiscoBridge POS
Real-time fiscalization for Odoo Point of Sale
When a FiscoBridge SDC URL is configured on the POS, sales and refunds are signed by the SDC at validation time and the fiscal block — invoice number, signature, and verification QR code — is appended to the customer receipt automatically. With no SDC URL set, the module stays dormant and POS validation runs unchanged.
Supported jurisdictions: the FiscoBridge SDC currently provides fiscalization in Fiji, Samoa, and Vanuatu, so this module can be used by Odoo POS operators in those countries.
Features
- Fiscalizes every POS sale through the FiscoBridge SDC when an SDC URL is configured on the POS.
- Blocks the sale if the SDC is unreachable while fiscalization is active — no unsigned receipts ever leave the till.
- Refunds are linked to the original fiscal invoice and rejected if the original sale wasn't fiscalized.
- Per-tax mapping to SDC fiscal labels (G, A, F, …).
- Receipt prints fiscal journal text and a verification QR code.
- Full SDC response stored on the order for audit and reprint.
- Opt-in by configuration: with no SDC URL set, the module is dormant and standard POS validation runs unchanged.
Screenshots
Fiscal receipt
POS configuration
Tax label mapping
Setup
- Point of Sale → Configuration → Point of Sale: set the FiscoBridge SDC URL and request timeout for each POS.
- Accounting → Configuration → Taxes: set the FiscoBridge Tax Label on every tax used by the POS. The authoritative label list lives in the FiscoBridge SDC under Integrations → Odoo POS.
- Open a session and validate a sale — the customer receipt now ends with the fiscal block.
Requirements
- Odoo 18.0 — Community or Enterprise.
- A reachable FiscoBridge SDC instance (this module is the Odoo front-end; the SDC does the actual fiscal signing).
- An operating jurisdiction supported by the FiscoBridge SDC. Currently: Fiji, Samoa, and Vanuatu.
- Depends on the standard
point_of_saleandaccountmodules.
Data shared with the FiscoBridge SDC
Fiscalization runs at sale validation time and sends the data needed to sign a fiscal receipt to the SDC endpoint configured on each POS (Point of Sale → Configuration → Point of Sale → FiscoBridge SDC URL). No data is sent until that URL is set, and the operator chooses where the SDC is hosted.
Transmitted with every sale or refund
- Odoo order ID and reference
- Transaction type (Sale or Refund) and, for refunds, the referent fiscal invoice number
- Order timestamp and currency code
- Cashier name (the Odoo user validating the sale)
- Line items: product display name, quantity, unit price, total, and the mapped FiscoBridge tax label
- Payment amounts and method names
- Customer tax/VAT number — only if a partner with a VAT field is attached to the order
Not transmitted
- Customer name, address, phone, or email
- Odoo login credentials or API keys
- Any data from orders that have already been validated
Stored back on the order
- Fiscal invoice number, signature, SDC timestamp,
verification URL, QR code, and the full SDC response — all
on the standard
pos.orderrecord, owned by your Odoo database
The module makes no other outbound network calls. It does not contact FiscoBridge servers, send telemetry, or require an activation key.
Installation note
Install via Odoo's standard addons_path — copy the
fiscobridge_pos folder into your addons directory and
restart the server. Do not use Apps → Import Module;
it only loads XML/CSV data and will fail because this module also
adds Python fields.
Testing this module
This module is the Odoo front-end for fiscalization. The actual fiscal signing is performed by the FiscoBridge SDC — a separate application that drives a fiscal smart card connected to the host machine. Both are required for a full end-to-end fiscal sale, and operators in regulated jurisdictions already provision them.
The module is designed to be safe to install with or without an SDC available. Reviewers can verify behavior in three ways:
1. Stock POS path
Install the module, open a POS session, ring up and validate a sale. The sale completes normally. The FiscoBridge SDC URL on the POS config is empty by default, so the module stays dormant and POS behaves exactly as standard Odoo.
2. Fiscal-block path
On the POS config, set FiscoBridge SDC URL to any
unreachable URL (for example
http://localhost:8888/api/v3/pos/fiscalize). Ring
up a sale and click Validate — a Fiscal Device Unreachable
dialog appears and the sale is blocked. This is the correct
behavior: no sale may complete without a valid fiscal
signature.
3. Full end-to-end
Requires a running FiscoBridge SDC and a provisioned fiscal smart card. Contact contact@fiscobridge.com for a reviewer trial build of the SDC and a sandbox fiscalization endpoint.
Please log in to comment on this module