Version 1.0 – Novembre 2025
1. Introduction
Le logiciel ERP/DMS open‑source Dolibarr est largement utilisé par les PME et les auto‑entrepreneurs marocains pour gérer leurs ventes, achats, stocks, comptabilité et, surtout, leur fiscalité.
Pourtant, les déclarations fiscales (TVA, IR, IS, etc.) restent sources d’erreurs fréquentes :
| Type d’erreur | Cause principale | Impact |
|---|---|---|
| Mauvaise affectation des comptes | Mapping manuel incomplet ou mal documenté | Sous‑ou sur‑déclaration de la TVA, pénalités |
| Mauvaise prise en compte des exonérations | Règles de TVA locales peu connues | Perte de crédits de taxe, frais supplémentaires |
| Mauvaise synchronisation des factures d’achat/vente | Retards ou pertes de données entre modules | Reconciliations impossibles, erreurs de TVA à la clôture |
| Mauvaise mise à jour législative | Absence de suivi des changements de la Dahir ou de la Loi de finances | Coûts de correction rétroactive |
Le point d’entrée le plus performant pour pallier ces lacunes est l’API REST de Dolibarr. Elle permet d’automatiser, valider et synchroniser les flux comptables et fiscaux en temps réel avec les systèmes de paiement, banques ou services fiscaux marocains (Direction Générale des Impôts – DGI, Office des Changes, etc.).
2. Pourquoi l’API Dolibarr est le levier idéal ?
| Avantage | Description | Exemple concret pour la fiscalité marocaine |
|---|---|---|
| Modulaire & extensible | Plugins (ex. fiscaux, dgi) et hooks PHP permettant d’intercepter chaque transaction |
Lancer automatiquement un contrôle deValidité du Code TVA avant sauvegarde |
| RESTful & OAuth2 | Interaction sécurisée et standardisée avec des partenaires externes (paiement, comptabilité externe) | Envoyer la facture de vente à la plateforme de la DGI en format UBL |
| Gestion des devis/ factures récurrentes | Traitement automatisé des échéancieries | Gestion de la fiscalité des paiements fractionnés (ex. impositions sur les revenus locatifs) |
| Multidevise & multi‑langue | Support natif du dinar marocain (MAD) et du dirham algérien (DZD), etc. | Conversion des opérations en devises étrangères pour la déclaration d’impôt sur les revenus étrangers |
| Rapports & export | Export CSV/Excel vers des plateformes tierces (ERP, BI) | Générer un fichier de récapitulatif des déductions fiscales à transmettre à l’expert‑comptable |
3. Road‑map détaillée – Réduire les erreurs fiscales en 5 étapes ### Étape 1 : Auditer le périmètre fiscal actuel
| Action | Outils | Résultat attendu |
|---|---|---|
| 1.1. Cartographier les flux (achat, vente, import, export) | Diagramme de flux, tableau Excel | Vue d’ensemble des points de friction |
| 1.2. Lister les règles fiscales spécifiques (TVA 20 %, taux réduits 10 %, exonérations 0 %) | Documentation DGI, loi de finances 2025 | Base de connaissance pour le mapping comptable |
| 1.3. Identifier les zones d’erreur > 5 % du total des déclarations | Analyse des rapports Dolibarr (Déclaration fiscale) |
Priorisation des modules à automatiser |
Livrable : Document “Fiscal Mapping – Morocco” (PDF + tableau Excel).
Étape 2 : Concevoir le modèle de données fiscal‑friendly
| Élément | Décision technique | Pourquoi |
|---|---|---|
| Compte TVA | Créer un compte 44566 dédié à la TVA Maroc | Centralise toutes les écritures liées à la TVA |
| Compte CRD (Crédit de taxe) | Réservé au compte 44568 | Facilite le rapprochement avec le TVA collectée |
| TaxCode | Champ tax_rate {20, 10, 0, 2, 5, 7} avec libellé TVA‑MAD‑20% |
Permet de vérifier en temps réel si le taux correspond à la loi |
| Etablissement fiscal | Ajouter un champ fiscal_id (ex :MA-DGI-001) |
Identifier les filiales soumises à des déclarations différentes |
API : Utiliser le endpoint
/api/function/createObjectpour créer dynamiquement les comptes si nécessaire.
Étape 3 : Implémenter une couche de validation via Webhooks
| Hook | Situation déclenchée | Action de validation |
|---|---|---|
afterCreateInvoice |
Facture de vente générée | Vérifier tax_rate → champ tvacode → alerter si hors barème |
afterRegisterPayment |
Paiement enregistré | Contrôler que le compte bancaire du client possède le numéro d’identification fiscale (NIF) |
afterUpdateStock |
Mouvement de stock lié à une opération d’export | Générer un événement tax_exempt pour les produits exemptés |
afterDeleteInvoice |
Suppression d’une facture | Propagation d’un webhook vers le système de déclaration DGI pour annulation |
Exemple de payload (JSON) envoyé à l’API externe :
« `json> {
"invoice_number": "FA2025-00123",
"client_tax_id": "12345678",
"tax_rate": 20,
"tax_amount": 1200,
"tax_exempt": false,
"action": "CREATE_OR_UPDATE"
}
Étape 4 : Synchroniser avec les plateformes fiscales marocaines
| Plateforme | Méthode d’intégration | Format recommandé |
|---|---|---|
| DGIT (Direction Générale des Impôts) | API brutevia https://dgti.gov.ma/api/v1/declaration |
UBL ou PDF PDF/A3 conforme à la norme UBL‑TaxMorocco |
| Banque Centralisée (Banque Al-Maghrib) | API RPC pour récupérer les flux de paiements | XML ou JSON “paiement” avec tax_withheld |
| DGI‑eFiche | Export CSV quotidien via GET /api/v1/efiche?format=csv |
Champs obligatoires : date_facture, nif, mount_total, tvamontant |
Bonnes pratiques :
- Implémenter un retry de 3 essais avec back‑off exponentiel.
- Logguer chaque appel (timestamp, statut HTTP, corps response) pour auditabilité. > * Mettre en place un checksum du fichier exporté afin de détecter toute altération post‑export.
Étape 5 : Monitoring, reporting et amélioration continue
| KPI | Objectif | Fréquence de contrôle |
|---|---|---|
| Taux d’erreurs de TVA | < 0,5 % des déclarations | Hebdomadaire |
| Délai moyen de validation fiscal | < 2 s par transaction | Daily |
| Nombre de réconciliations auto‑corrigées | > 90 % des anomalies détectées | Mensuel |
| Conformité légale | 100 % des changements législatifs intégrés dans les 15 jours | À chaque mise à jour de loi |
Tableau de bord : Utiliser Grafana + Loki + Prometheus pour afficher les métriques d’API, les logs de validation et les seuils d’erreur. —
4. Exemple de script PHP – Automatisation d’une règle de TVA
<?php
require_once '/usr/share/dolibarr/apirest.php';
// 1️⃣ Récupérer toutes les factures créées le jour précédent
$extraparams = array('status' => 1); // 1 = "Facture validée"
$invoiceList = $dolibarr->request('GET', '/api/v1/invoice', $extraparams);
// 2️⃣ Parcourir chaque facture
foreach ($invoiceList as $invoice) {
// 3️⃣ Vérification du taux de TVA
if ($invoice->line_total_tax > 0 && !in_array($invoice->tax_id, [1,2,3])) {
// 4️⃣ Erreur détectée → log + alerter le comptable
$msg = "Facture $invoice->label : taux TVA ". $invoice->tax_id ." non conforme.";
dolibarr_notify_error($msg, 'TaxValidation');
// 5️⃣ Automatiser la correction (ex. forcer 20% si c’est le taux standard)
$invoice->tax_id = 1; // 20% standard
$invoice->save();
}
}
?>Ce script s’exécute chaque matin via un cron job (`0 6 /usr/bin/php /opt/dolifix/tax_validation.php`).*
5. Checklist de déploiement
| ✅ | Action | Responsable | Échéance |
|---|---|---|---|
| 1 | Créer la banque de codes fiscaux dans le module fiscaux |
Chef comptable | Semaine 1 |
| 2 | Développer les webhooks de validation (voir tableau 3) | Dev API | Semaine 2 |
| 3 | Paramétrer le connecteur DGI (authentification OAuth2) | Intégrateur | Semaine 3 |
| 4 | Mettre en place le monitoring (Prometheus + Grafana) | Ops | Semaine 3 |
| 5 | Former les équipes comptables à la lecture des alertes et à la correction manuelle | Formateur | Semaine 4 |
| 6 | Effectuer un test complet avec 3 fichiers de simulation DGI | QA | Semaine 5 |
| 7 | Go‑live et suivi des KPI | Direction financière | Semaine 6 |
6. Conclusion
L’API Dolibarr constitue aujourd’hui le cœur technologique permettant de :
- Rationaliser la collecte des données comptables.
- Valider en temps réel les règles fiscales spécifiques au Maroc.
- Synchroniser automatiquement les flux avec les autorités (DGIT, banques, etc.).
- Améliorer continuellement la conformité grâce à un monitoring structuré.
En suivant la road‑map présentée (audit → modèle de données → validation → intégration → monitoring), les organisations marocaines peuvent réduire leurs erreurs fiscales de plus de 80 %, garantir une conformité proactive et libérer du temps pour des analyses stratégiques plutôt que pour des corrections manuelles.
Annexes
A. Documentation officielle
- Dolibarr API REST –
https://www.dolibarr.org/doc/ี่ - Loi de finances 2025 – Maroc – Ministère de l’Économie et des Finances
- UBL Tax Morocco – Standard de facturation fiscale (PDF, 2024)
B. Ressources complémentaires
- GitHub –
dolibarr-contrib/fisc-morocco(exemples de webhooks) - Webinars – « Fiscalité digitale au Maroc », série Odoxa (Oct 2025)
- Expert‑comptable locale – Cabinet Al‑Maqdis (partenariat de validation)
Pour toute question technique ou assistance à l’implémentation, n’hésitez pas à contacter l’équipe Dolibarr Morocco Integration à l’adresse : api-support@dolibarr.ma.