| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Lines of code | 1375 |
| Technical Name |
aminitech_ebms_base |
| License | OPL-1 |
| Website | https://www.aminitechsolutions.com |
EBMS Base — Moteur central OBR Burundi
La fondation gratuite de la famille EBMS : un client API OBR eBMS complet avec file de transmission asynchrone, environnements Test / Production, interrupteur de pause et validation des NIF. Installez, connectez une seule fois — chaque application EBMS s'y branche directement.
English speaker? Full documentation in EN · FR · SW · AR · PT at docs.aminitechsolutions.com/ebms
Un seul moteur, tous les services web OBR
Le Burundi exige des contribuables disposant de leur propre système de facturation la transmission des documents à l'OBR eBMS en temps réel. EBMS Base est la tuyauterie qui rend cela fiable : un client API robuste couvrant les sept services web de l'OBR, une file d'attente en arrière-plan qui réessaie jusqu'à l'accusé de réception, et une configuration contribuable propre, par société. Seul, il ne transmet rien — les applications Facture, PdV et Stock de la famille s'appuient dessus.
Client API complet
login, checkTIN, getInvoice, addInvoice_confirm, cancelInvoice, AddStockMovement et AddStockMovementImporters — avec cache de jeton et messages d'erreur lisibles.
File asynchrone
Les documents sont mis en file et envoyés en arrière-plan, avec réessais à délai croissant. Vos utilisateurs n'attendent jamais le serveur OBR — et rien n'est jamais perdu.
Test & Production
Identifiants séparés pour le serveur de test et le serveur de production de l'OBR. Validez tout le flux en mode Test, puis basculez en Production en un clic.
Pause / Reprise de la transmission
Suspendez l'envoi à tout moment — les documents s'accumulent en sécurité dans la file. Reprendre & Vider envoie tout dans l'ordre chronologique.
Validation des NIF (checkTIN)
Vérifiez le NIF de tout client ou fournisseur auprès de l'OBR depuis la fiche contact. Le nom du contribuable enregistré est conservé comme preuve.
Tâches auto-réparatrices
Un chien de garde réactive les tâches désactivées, récupère les entrées bloquées et sonde l'API OBR toutes les 30 minutes. Le moniteur de santé ne dort jamais.
Configurez une fois, oubliez pour toujours
Prouvez en Test, basculez en Production
L'OBR vous remet des identifiants distincts pour ses serveurs de test et de production. EBMS Base conserve les deux jeux ; un seul sélecteur décide où partent les documents — avec une bannière impossible à manquer indiquant le mode actif. Chaque entrée de la file est marquée de l'environnement dans lequel elle a été créée.
- ✔Deux jeux d'identifiants — rien à ressaisir au passage en production
- ✔Bouton Tester la connexion — vérifie l'environnement actif instantanément
- ✔Badges d'environnement — sur les réglages, la file et les factures
Votre identité OBR, sur une seule page de réglages
NIF, registre de commerce, centre fiscal (DGC / DMC / DPMC), secteur d'activité, forme juridique, adresse complète et les indicateurs TVA / taxe de consommation / PFL — tout ce que l'OBR attend dans le bloc tp_* de chaque envoi, saisi une fois par société. Les identifiants restent dans votre base de données et ne sont visibles que des administrateurs.
- ✔Multi-sociétés — chaque société a son propre compte OBR
- ✔Nom légal du contribuable — le nom commercial peut différer du nom enregistré
- ✔Contrôle de complétude — les champs manquants sont signalés avant tout envoi
Chaque envoi, chaque tentative, consignés
Chaque document destiné à l'OBR passe par la file : la charge JSON exacte, chaque tentative avec son erreur, l'accusé de réception de l'OBR avec numéro d'enregistrement, date et signature électronique. Les échecs réessaient automatiquement — 5 minutes, puis 15, 45… jusqu'à toutes les 12 heures — jusqu'à acceptation.
- ✔Envoyer maintenant / Réessayer / Réinitialiser — le contrôle manuel quand vous le voulez
- ✔Vidage chronologique — la continuité des séquences OBR est préservée
- ✔Piste d'audit complète — charge et réponse conservées mot pour mot
Suspendez quand il le faut, videz quand vous êtes prêt
Maintenance annoncée de l'OBR ? Souci de connexion ? Passez la transmission en Pause : l'activité continue, les documents s'accumulent en sécurité dans la file, et rien ne quitte votre serveur. Un clic sur Reprendre & Vider envoie l'arriéré, du plus ancien au plus récent.
- ✔Zéro perte de données — les charges sont construites et stockées à la validation
- ✔Interrupteur par société — suspendez une société, pas tout le serveur
Un mauvais NIF fait rejeter la facture. Attrapez-le avant.
L'OBR rejette les factures dont le NIF client lui est inconnu. Le bouton Vérifier le NIF, présent sur chaque contact, interroge directement l'OBR et enregistre sur la fiche le statut de validation, le nom du contribuable et la date du contrôle.
- ✔Un clic — depuis la fiche contact, ou en lot
- ✔Traçabilité — chaque contrôle journalisé avec son résultat
La famille OBR eBMS complète pour Odoo
Chaque application ci-dessous se branche sur cet EBMS Base gratuit — une seule configuration OBR, une seule file de transmission, un seul jeu de rôles de sécurité. Achetez n'importe quelle combinaison, configurez une fois. Toutes sont couvertes par un même portail de documentation (FR, EN, SW, AR, PT).
Nos autres services Odoo
Questions fréquentes
Cette application est-elle vraiment gratuite ?
Oui. EBMS Base est le moteur commun de la famille et ne coûte rien, pour toujours. Les applications métier (Facture, PdV, Stock…) sont des achats uniques qui la requièrent.
Y a-t-il des limites de factures ou des plafonds ?
Non. Rien dans la famille ne compte, ne plafonne, ni n'expire. Achat unique, documents illimités, utilisateurs illimités.
Où obtenir mes identifiants OBR ?
Auprès de l'OBR : facture.electronique@obr.gov.bi ou +257 22 28 24 59. Vous recevez d'abord les identifiants du serveur de test ; ceux de production sont délivrés une fois vos essais concluants.
Mes identifiants quittent-ils mon serveur ?
Jamais. Ils sont stockés dans votre propre base de données, visibles des seuls administrateurs, et servent exclusivement à appeler l'API OBR depuis votre serveur. AminiTech est un éditeur indépendant, sans affiliation avec l'OBR.
Que se passe-t-il si Internet tombe ?
Les documents restent en file locale et le moteur de réessai les transmet automatiquement au retour de la connexion — dans l'ordre chronologique, exactement comme l'OBR l'exige.
Parlons-en dès aujourd'hui
EBMS Base — Burundi OBR core engine (Free)
The free foundation of the EBMS family: a complete OBR eBMS API client with an asynchronous submission queue, Test / Production environments, a transmission pause switch and NIF validation. Install it, connect once — every EBMS app plugs straight in.
Complete API client
login, checkTIN, getInvoice, addInvoice_confirm, cancelInvoice, AddStockMovement and AddStockMovementImporters — with token caching and readable errors.
Asynchronous queue
Documents queue and send in the background with growing-delay retries. Users never wait on the OBR — and nothing is ever lost.
Test & Production
Separate credential sets for the OBR test and production servers. Validate in Test, switch to Production in one click.
Pause / Resume
Pause sending at any time — documents accumulate safely. Resume & Flush sends everything chronologically.
NIF validation
Check any customer or supplier NIF against the OBR from the contact form; the registered name is stored as proof.
Self-healing crons
A watchdog re-activates disabled jobs, recovers stuck entries and probes the OBR API. The health monitor never sleeps.
Frequently asked questions
Is this app really free?
Yes — free forever, updates included. The document apps (Invoice, POS, Stock…) are one-time purchases that require it.
Any invoice limits or caps?
No. Nothing in the family counts, caps or expires.
Where do I get OBR credentials?
From the OBR: facture.electronique@obr.gov.bi or +257 22 28 24 59 — test credentials first, production after your tests succeed.
Do my credentials leave my server?
Never. Stored in your own database, visible to administrators only, used solely to call the OBR from your server.
What happens when the internet drops?
Documents queue locally and the retry engine transmits them chronologically once connectivity returns.
Facturation électronique Burundi · OBR eBMS connector for Odoo · electronic invoicing Burundi
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Lines of code | 1375 |
| Technical Name |
aminitech_ebms_base |
| License | OPL-1 |
| Website | https://www.aminitechsolutions.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