Documentation de l'API de facturation électronique
Gardez votre logiciel. Ajoutez juste la conformité.
EFact est le middleware de facturation électronique Maroc-DGI 2026. Il s'insère entre votre application existante (ERP, SaaS, logiciel métier) et la plateforme DGI marocaine : vous envoyez une facture en JSON, EFact la convertit en XML UBL 2.1, la signe et suit sa clairance. Commencez par le quickstart, puis consultez la référence de l'API REST et les SDK.
SDKs & Quickstart
Node.js
TypeScript / JavaScript
Quick startPython
Python 3.9+
Bientôt disponibleJava
JVM / Spring Boot
Bientôt disponiblePHP
Laravel / Symfony
Bientôt disponible.NET
C# / ASP.NET
Bientôt disponibleToute la documentation
GETTING STARTED
- Quickstart
Première facture conforme DGI en quelques minutes : installation du SDK, clé API, création d'une facture.
- Authentication
Authentification par clé API (en-tête Authorization), portée par organisation, rotation des clés.
- Tester votre intégration
Environnement de test EFact : le simulateur DGI est le mode test par défaut. Scénarios testables et gestion d'erreurs.
API
- Overview
Vue d'ensemble de l'API REST : ressources, cycle de vie d'une facture, statuts, pagination, erreurs.
- Invoices
Créer, récupérer et annuler des factures ; format JSON en entrée, XML UBL 2.1 signé en sortie.
- Webhooks
Recevoir les changements de statut des factures par webhook : événements, signature HMAC-SHA256, relances, rotation du secret.
SDK
- Node SDK
SDK officiel Node.js/TypeScript (@itzenata/efact-node) : installation, configuration, exemples.
- Python SDK
SDK Python (efact, publication PyPI en cours) : installation, configuration, exemples.
PLATEFORME
- Security
Sécurité EFact : chiffrement, certificats qualifiés, conformité CNDP loi 09-08, archivage 10 ans.
- Architecture
Architecture de la plateforme : normalisation UBL 2.1, signature XAdES, transmission et clearance DGI.