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
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Invoicing (account) |
| Community Apps Dependencies | Show |
| Lines of code | 2869 |
| Technical Name |
l10n_sn_dgid_einvoice |
| License | OPL-1 |
| Website | https://pokutsoft.com/ |
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