Senegal DGID e-Invoice
DGID electronic invoicing for Odoo — structured facture/avoir, NINEA validation, TVA breakdown & QR
Prepare Odoo for the Senegal DGID (Direction Générale des Impôts et des Domaines) e-invoicing programme written into the General Tax Code by the 2025 finance law. The DGID already runs an online tax-declaration portal branded eTAX; its dedicated e-invoicing clearance gateway is still being defined (exact name and technical spec not yet published). Customer invoices and credit notes (factures / avoirs) are turned into the DGID structured-invoice document with the full TVA breakdown, validated against the DGID business rules, and submitted for clearance over a bring-your-own-key connection.
Structured invoice generation
S / R / Z / E TVA bucketing (18% standard, 10% reduced, zero-rated export, exempt), per-line détail with désignation and references, whole-franc XOF rounding and credit-note (avoir) referencing of the original facture — produced as a canonical, deterministic document.
Control reference + QR
After clearance the DGID authority id, signature and timestamp are captured. A verification QR resolving to the DGID portal is generated and rendered to a PNG for the printed invoice; an offline JSON QR is produced before clearance.
Real NINEA validation
A 10-character structural validator (nine digits plus the CO.FI. legal-form letter, e.g. 001234567G) runs on the company and on partners, with legal-form detection and an advisory check-letter typo guard.
DGID business-rule validation
A Senegal rule set layered on the engine's EN 16931-style core: seller and B2B-buyer NINEA, valid TVA categories, XOF currency, line désignations and credit-note referencing — surfaced before you submit.
DGID clearance scaffold (BYOK)
Authentication, invoice clearance, status query and cancellation over a REST shape modelled on CTC clearance. Because the DGID clearance-gateway contract is not yet final, the sandbox/production endpoints, paths and the QR verification URL are editable defaults (not certified production URLs); requests retry with exponential backoff and every call is logged. Your API token and client id are stored only on your database.
Onboarding & automation
A guided onboarding wizard validates the NINEA and writes the company, TVA regime and connection settings in one place. An optional cron drains posted documents to the DGID in batches.
Honest pre-mandate scope
Senegal's e-invoicing mandate is in pre-enforcement rollout: the DGID has not yet published a final, stable technical schema or the production endpoint contract. This module generates a complete and correct structured invoice with the fields the DGID has signalled, and ships a BYOK transmission scaffold whose endpoints, paths and verification URL are editable defaults. No value is faked — every field is computed from the source document — and the response parser reads the control reference defensively so it keeps working as the contract is finalised. We are not the DGID, an integrator or a certified intermediary: the module produces the structured-invoice format and submits over a bring-your-own-key connection using the credentials you obtain from the DGID. The Senegalese standard VAT (TVA) rate is 18%.
Nous ne sommes ni la DGID, ni un intégrateur, ni un intermédiaire agréé : le module génère le format de facture structurée et l'envoie via une connexion « apportez votre propre clé » (BYOK) avec les identifiants obtenus auprès de la DGID. Le taux de TVA standard sénégalais est de 18%.
Built on the e-Invoice Core Engine
This connector reuses the shared engine (canonical JSON builder, validation framework, BYOK REST transport and the e-Invoicing document model). No engine functionality is duplicated — only the Senegal profile, generator and DGID client are added. Compatible with Odoo 18 and Odoo 19.
Screenshots
Sn Dgid Invoice Form
Sn Dgid Einvoice Document
Update date: 2026-07-12