| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Invoicing (account) |
| Community Apps Dependencies | Show |
| Lines of code | 2830 |
| Technical Name |
l10n_sn_dgid_einvoice |
| License | OPL-1 |
| Website | https://gencbaris.com/odoo_plugins/ |
| Versions | 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Invoicing (account) |
| Community Apps Dependencies | Show |
| Lines of code | 2830 |
| Technical Name |
l10n_sn_dgid_einvoice |
| License | OPL-1 |
| Website | https://gencbaris.com/odoo_plugins/ |
| Versions | 18.0 19.0 |
Senegal DGID e-Invoice
DGID eTAX 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 rolled out under the 2025 finance law on the eTAX platform. 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.
eTAX clearance scaffold (BYOK)
Authentication, invoice clearance, status query and cancellation over the documented CTC REST shape. Sandbox and production endpoints, paths and the QR verification URL are editable; 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.
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.
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