Transmission EDI et API pour la facturation électronique DGI au Maroc

La conformité à la facturation électronique marocaine ne s'arrête pas au format XML : elle exige un canal de transmission fiable entre votre logiciel et la plateforme nationale de la DGI. Deux familles de protocoles dominent les échanges B2G et B2B à grande échelle : l'EDI (Échange de Données Informatisé) historique et les API REST modernes. Comprendre leurs forces, leurs contraintes et leur articulation avec le modèle clearance est indispensable pour les DSI, responsables EDI et éditeurs de logiciels. Ce guide compare les approches et propose une méthode de choix adaptée au contexte marocain.

API REST : la voie privilégiée des éditeurs cloud et PME

Les API REST exposées par la plateforme DGI — ou par les prestataires certifiés (CSP) mandatés — permettent d'envoyer une facture structurée via HTTPS, de recevoir synchroniquement ou par callback un accusé de réception ou un rejet, et de récupérer l'UUID ainsi que les données pour le QR code. Ce modèle convient aux logiciels SaaS de facturation, aux PME sans infrastructure EDI et aux intégrations légères ERP via connecteur middleware. L'authentification repose typiquement sur des certificats, des clés API ou OAuth selon les spécifications DGI ; la documentation technique accompagne la charte de facturation électronique.

Les bonnes pratiques API incluent : idempotence des requêtes (éviter les doublons en cas de retry), journalisation des payloads et des réponses, gestion des timeouts et file d'attente pour les pics de fin de mois, et monitoring des taux de rejet par code d'erreur. Croisez votre implémentation avec le guide d'émission conforme et formez les équipes support à interpréter les erreurs listées dans notre article sur les erreurs fréquentes DGI.

EDI : robustesse pour les volumes industriels

L'EDI reste la référence des grands groupes, de la distribution et de l'industrie pour échanger des milliers de documents par jour avec traçabilité inter-entreprises. Les messages transitent via un VAN (Value Added Network) ou une plateforme d'échange, souvent au format EDIFACT, X12 ou XML encapsulé. Au Maroc, l'EDI vers la plateforme DGI peut transiter directement ou via un CSP qui assure la conversion vers le format charte et la signature électronique. L'investissement initial est plus lourd — mapping, tests, contrats réseau — mais l'automatisation bout-en-bout est supérieure pour les flux récurrents à haut volume.

• API REST : déploiement rapide, coût d'entrée faible, idéal SaaS et PME
• EDI : volumes massifs, intégration supply chain, SLA entreprise
• CSP certifié : abstraction des protocoles pour l'entreprise utilisatrice
• Sécurité : TLS, certificats, gestion des secrets et rotation des clés
• Supervision : tableaux de bord rejets, alertes, rapprochement comptable

Rôle des prestataires certifiés dans la transmission

De nombreuses entreprises ne se connecteront pas directement à la DGI : elles passeront par un éditeur agréé ou un CSP qui mutualise la connectivité, maintient la conformité aux évolutions de la charte et fournit un support métier en français. Le CSP reçoit la facture via API depuis votre logiciel, exécute les contrôles, signe si mandaté, transmet à la plateforme et retourne le statut. Ce modèle simplifie la vie des PME tout en concentrant l'expertise technique chez des acteurs audités par l'administration.

Architecture cible et scénarios d'intégration ERP

Cartographiez vos flux : ERP central, points de vente, filiales, outils métier satellites. Définissez un hub de facturation qui centralise la numérotation, les contrôles mentions obligatoires et l'appel au connecteur DGI. Évitez les connexions multiples non coordonnées qui provoquent des doublons de numéros ou des séries parallèles. Pour les groupes, harmonisez EDI inter-filiales et API vers le CSP marocain. Testez les scénarios de charge avant les périodes critiques — clôture mensuelle, soldes Ramadan, pics e-commerce.

Documentez les contrats d'interface entre ERP, connecteur et plateforme : formats acceptés (UBL, CII, Factur-X), codes retour, délais SLA et procédure d'escalade. Le guide facturation électronique Maroc structure cette démarche projet.

Sécurité et conformité des échanges API/EDI

Les canaux de transmission vers la plateforme DGI transportent des données fiscales sensibles : montants, identifiants fiscaux, historique commercial. Chiffrez les flux en transit (TLS 1.2 minimum), stockez les clés API et certificats dans un coffre sécurisé et appliquez une politique de rotation périodique. Journalisez chaque requête et réponse sans conserver de données personnelles au-delà de la durée légale. Un audit annuel du connecteur — droits d'accès, logs, procédure d'incident — réduit le risque de fuite ou d'usurpation d'identité émettrice.

Dimensionnement pour les pics de fin de mois

Les pics de facturation en fin de mois, de trimestre ou pendant les soldes commerciales peuvent saturer un connecteur mal dimensionné. Prévoyez une file d'attente persistante, des workers parallèles et des alertes si le délai moyen de clearance dépasse un seuil défini. Testez la charge en recette avec un volume représentatif de votre pic réel — multiplié par deux pour la marge — avant la mise en production.

Questions fréquentes sur EDI et API DGI