Skip to content

Odoo integration

Two lightweight Odoo 19 modules connect an Odoo database to Tax-Bridge. Certificates stay in the Bridge vault — Odoo holds only a Base URL, an API key and a Shop ID.

Module Technical name Does
Tax-Bridge Fiscalization cw_taxcore_bridge Customer invoices and credit notes (Fiscalize (Tax-Bridge) button on the posted invoice); owns the connection settings and the tax-label field
Tax-Bridge Fiscalization — POS cw_taxcore_bridge_pos Point of Sale orders, fiscal receipt at the till, offline reconciliation (5-minute retry job)

Install

  1. Copy both module folders from connectors/odoo/ into a directory on your Odoo addons_path and restart Odoo.
  2. Developer mode → Apps → Update Apps List → search Tax-Bridge → install Tax-Bridge Fiscalization, then Tax-Bridge Fiscalization — POS if you use a till.
  3. Accounting → Configuration → Tax-Bridge: Base URL https://tax-bridge.cloud, your API key (Console → API keys) and the Shop ID (Console → Shops).
  4. Accounting → Configuration → Taxes: set the Tax-Bridge Label on each tax (unmapped taxes default to D).
  5. Point of Sale → Configuration → Payment Methods: set the Tax-Bridge Payment Type on each method.

Behaviour

  • Accounting invoices post with ?sync=true and store the SDC invoice number, journal, QR and verification URL on the invoice.
  • POS orders use the async 202 contract. An interim non-fiscal slip prints if signing takes more than a few seconds; the fiscal receipt (journal → QR → closing line) is auto-reprinted the moment the SDC responds.
  • Credit notes and POS refunds are sent as REFUND with a reference to the original fiscal invoice.
  • Offline: orders queue in the POS and are fiscalized on reconnect; a scheduled action retries anything the Bridge could not accept. The idempotent request id guarantees each order is fiscalized exactly once.

The complete, step-by-step procedure — server preparation, installation, configuration, acceptance test and troubleshooting — is the Odoo Setup Guide (docs/odoo-setup-guide.md / docs/pdf/odoo-setup-guide.pdf).

Coexists with the direct module

This is a separate, Bridge-connected addon. Any existing direct Odoo fiscalization module is unaffected.