Dolibarr 23 ERP/CRM pour TPE-PME francophone : SYSCOHADA, Mobile Money, FNE — guide 2026

Toute TPE francophone qui dépasse cinq salariés se retrouve coincée entre deux contraintes administratives qui se télescopent. D’un côté, la digitalisation fiscale impose désormais des factures électroniques normalisées (Facture Normalisée Électronique, FNE en Côte d’Ivoire ; e-Facture au Sénégal en cours de déploiement ; e-Tax au Mali). De l’autre, les paiements clients basculent en Mobile Money à 70 % ou plus en zone urbaine, et l’encaissement Wave, Orange Money, MTN MoMo ou Free Money doit se réconcilier automatiquement avec la comptabilité. Les ERP propriétaires (Sage, EBP, Cegid) coûtent entre 800 000 et 3 000 000 XOF la première année et n’intègrent ni la FNE ni les paiements mobiles ouest-africains. Dolibarr, en revanche, est gratuit, modulaire, modifiable et déjà déployé chez plusieurs centaines de PME au Sénégal, en Côte d’Ivoire et au Mali.

Ce guide pose l’architecture complète d’un Dolibarr 23 adapté au contexte francophone ouest-africain : choix de l’hébergement, modules essentiels, plan comptable SYSCOHADA, branchement Mobile Money via les API officielles, génération de factures FNE conformes à la DGI ivoirienne, intégration avec un site WooCommerce, et exploitation au quotidien. Quatre tutoriels techniques creusent les sous-sujets les plus complexes : installation Coolify, module Mobile Money custom, génération FNE, et synchronisation comptable bidirectionnelle.

Pourquoi Dolibarr et pas Odoo ou ERPNext

Le marché ERP open source compte trois leaders sérieux. Odoo Community offre la fonctionnalité la plus large mais sa version gratuite a été progressivement amputée des modules les plus utiles (e-mail marketing, comptabilité avancée, signature électronique) qui ne sont disponibles que dans la version Enterprise commerciale facturée 31 USD par utilisateur et par mois. Pour une PME de quinze utilisateurs, cela représente plus de 5 000 USD par an, sans compter le coût de modification du code. ERPNext (basé sur Frappe Framework) est techniquement remarquable mais sa courbe d’apprentissage reste raide, son écosystème de modules sectoriels en français est limité, et sa configuration comptable demande des compétences pointues que peu de prestataires locaux maîtrisent.

Dolibarr occupe le créneau pragmatique : 100 % open source GPLv3 sans version commerciale castrée, écrit en PHP donc déployable sur n’importe quel hébergement mutualisé à 5 000 XOF/mois, interface en français natif depuis sa création (le projet est né à Marseille en 2003), plus de 250 modules disponibles dont une centaine maintenue par la communauté ouest-africaine. La version 23 publiée en avril 2026 stabilise la nouvelle interface bootstrap 5, intègre nativement le moteur de templates Twig, et améliore significativement les performances sur la facturation récurrente.

Le choix Dolibarr s’impose particulièrement quand la PME a besoin de modifier le code pour intégrer des spécificités locales — module FNE custom, connecteur Wave, états SYSCOHADA personnalisés. Le code PHP procédural utilisé reste lisible par n’importe quel développeur web junior, contre du framework Python complexe chez Odoo et ERPNext. Pour 80 % des cas d’usage TPE-PME en Afrique de l’Ouest, Dolibarr suffit largement et coûte cinq à dix fois moins cher en TCO sur trois ans.

Architecture cible et hébergement

Dolibarr tient sur un serveur LAMP minimaliste. Pour une TPE de cinq à quinze utilisateurs, un VPS Hetzner CX22 à 4,51 € HT/mois (2 vCPU, 4 Go RAM, 40 Go SSD) traite confortablement la charge avec une base MariaDB embarquée. Au-delà de quinze utilisateurs ou quand le catalogue produit dépasse 10 000 références, basculer sur un CCX13 (4 vCPU, 16 Go RAM) garantit la fluidité. Pour un déploiement souverain au Sénégal, plusieurs hébergeurs locaux comme Wagaden ou des datacenters Sonatel proposent des VPS équivalents — le surcoût est de l’ordre de 30 à 50 % pour des performances en général équivalentes, justifié si la PME impose une localisation des données sur le territoire.

Le déploiement le plus efficace en 2026 passe par Coolify ou Dokploy qui automatisent l’installation Docker de Dolibarr en moins de dix minutes. Une stack docker-compose complète comprend trois conteneurs : l’image officielle dolibarr/dolibarr:23, MariaDB 11 LTS pour la base, et Caddy ou Traefik pour le reverse-proxy avec certificat Let’s Encrypt automatique. Le volume dolibarr_documents persistant sur SSD stocke les pièces jointes (factures PDF, devis, justificatifs) et doit être inclus dans la stratégie de sauvegarde quotidienne via Restic vers un bucket S3-compatible.

Pour la sécurité, exposer uniquement HTTPS sur le port 443, désactiver l’accès admin depuis l’extérieur (restreindre /admin/ par IP whitelist), activer la 2FA TOTP native (module disponible depuis Dolibarr 17), forcer les mots de passe à 14 caractères minimum, et configurer Fail2ban avec un filtre Dolibarr dédié pour bannir les bruteforce sur la page de login. Les sauvegardes Restic vers Hetzner Storage Box ou Bunny Storage assurent un RPO de 24 heures et un RTO inférieur à une heure pour une TPE.

Modules Dolibarr essentiels pour une TPE-PME

Dolibarr expose plus de 80 modules natifs activables d’un clic. En réalité, une TPE bien équipée n’en active activement qu’une vingtaine. Le triptyque commercial (Tiers, Devis, Factures) constitue le socle : gestion clients-fournisseurs, génération de devis avec workflow d’approbation, transformation automatique en facture après acceptation, suivi des règlements partiels. Le module Produits-Services gère le catalogue avec variantes, lots, numéros de série, et plusieurs prix par segment client.

Le module Stocks devient indispensable dès qu’on tient un magasin physique : entrées-sorties par bon, transferts entre dépôts, alertes de seuil minimum, valorisation FIFO ou PMP. Le module Comptabilité (réécrit en profondeur depuis la version 19) gère désormais le plan SYSCOHADA Révisé applicable depuis 2018 dans toute la zone OHADA. Les écritures sont générées automatiquement à partir des factures clients, factures fournisseurs et règlements bancaires importés via OFX ou CSV.

Le module Projets structure les missions de service (cabinets de conseil, agences digitales) avec ventilation des temps passés, génération de factures à partir des feuilles de temps, et marge réelle par projet. Le module Ressources Humaines couvre les bases : contrats, congés, notes de frais, fiches de paie simples (pour un calcul plus poussé conforme CNPS, CNSS ou IPRES, voir nos articles dédiés au paramétrage paie ouest-africain).

Côté connectivité, le module API REST expose toutes les entités Dolibarr en JSON authentifié par token, ce qui permet une intégration native avec WooCommerce, un site vitrine, une application mobile dédiée ou un CRM tiers. Le module Workflow déclenche des actions automatiques sur événement (envoi d’email à la validation d’un devis, création d’une tâche projet à la signature d’un contrat). Enfin, le module ECM (Electronic Content Management) transforme Dolibarr en GED pour archiver tous les documents commerciaux avec recherche plein texte.

Plan comptable SYSCOHADA Révisé

La compatibilité comptable est le critère de validation par l’expert-comptable d’une PME ouest-africaine. SYSCOHADA Révisé, applicable dans les 17 pays de l’OHADA depuis le 1er janvier 2018, définit les classes de comptes (Classe 1 ressources durables, Classe 2 immobilisations, Classe 3 stocks, Classe 4 tiers, Classe 5 trésorerie, Classe 6 charges, Classe 7 produits, Classe 8 hors activités ordinaires). Dolibarr fournit un module communautaire SYSCOHADA mature qui charge le plan comptable détaillé, avec les sous-comptes obligatoires pour la TVA, les retenues à la source, les acomptes clients-fournisseurs.

L’installation se fait via le menu Configuration → Modules → Comptabilité. Charger ensuite le plan SYSCOHADA depuis le menu Comptabilité → Configuration → Compte comptable → Importer un plan comptable type. Les codes comptables principaux à mémoriser : 411 Clients, 401 Fournisseurs, 521 Banque, 571 Caisse, 707 Ventes de marchandises, 706 Services vendus, 4434 TVA collectée, 4452 TVA récupérable. Configurer ensuite la TVA selon la juridiction : 18 % au Sénégal et au Mali, 18 % en Côte d’Ivoire pour le régime normal (avec des taux réduits dans certains secteurs comme l’hôtellerie à 10 %).

L’export comptable mensuel se fait via le module Comptabilité → Exports → Format expert-comptable. Dolibarr produit un fichier conforme au format demandé par les principaux logiciels d’expert-comptable utilisés en Afrique francophone : Sage Compta, Cador, EBP, Saari Comptabilité. L’expert récupère ce fichier, le rapproche de ses propres écritures et produit la liasse fiscale annuelle.

Intégration Mobile Money et facturation FNE

Le moyen de paiement dominant pour les transactions B2C en zone urbaine ouest-africaine, c’est le Mobile Money. Wave (Sénégal et CI), Orange Money (toute la sous-région), MTN MoMo (Côte d’Ivoire et reste de l’Afrique), Free Money (Sénégal) et Moov Money (Mali, Bénin) totalisent plus de 90 % des transactions hors espèces dans le secteur informel et 50 % dans le formel. Dolibarr ne gère pas nativement le Mobile Money, mais quatre voies d’intégration existent : module communautaire wave-dolibarr (encore expérimental), agrégateur Paydunya/CinetPay/HUB2 (factuelle de 1 à 3 %), API directes des opérateurs (gratuite mais réservée aux entreprises agréées), ou développement custom d’un module qui pollue la base via webhook.

Le tutoriel dédié au module Mobile Money custom détaille la voie agrégateur Paydunya, qui couvre les cinq principaux opérateurs avec une API REST unique, en moins de 200 lignes de PHP intégrées dans Dolibarr. Le webhook reçoit les confirmations de paiement, marque la facture correspondante comme réglée, et génère l’écriture comptable au crédit du compte 521 Banque (sous-compte par opérateur) avec contrepartie 411 Client. Le rapprochement bancaire devient ainsi automatique.

Côté facturation FNE en Côte d’Ivoire, la DGI ivoirienne impose depuis 2022 que toutes les factures professionnelles passent par la plateforme FNE pour authentification. Le tutoriel dédié explique comment signer chaque facture Dolibarr avec un certificat fiscal délivré par la DGI, transmettre la facture XML au système FNE, recevoir le numéro fiscal en retour, et imprimer la facture PDF avec le QR code FNE conforme. Une démarche similaire s’installe progressivement au Sénégal (e-Facture pilotée par la DGID) et au Mali, avec des évolutions à anticiper en 2026-2027.

Tutoriels techniques de cette série

• Installer Dolibarr 23 sur Coolify avec MariaDB et HTTPS — déploiement docker-compose, paramétrage initial, sauvegarde Restic, monitoring uptime.
• Développer un module Mobile Money custom pour Dolibarr (Wave, Orange Money, MTN MoMo) — webhook Paydunya, marquage des factures, écritures SYSCOHADA automatiques.
• Générer des factures FNE conformes DGI Côte d’Ivoire avec Dolibarr — certificat fiscal, signature XML, transmission API, QR code et numéro fiscal.
• Synchroniser Dolibarr avec WooCommerce et la comptabilité expert — connecteur WooCommerce, mapping produits, export FEC SYSCOHADA mensuel.

Adaptation au contexte ouest-africain

Trois ajustements spécifiques améliorent significativement l’usage. Premièrement, configurer le module multi-devises pour gérer XOF, XAF, USD et EUR : les exportateurs et les agences qui facturent à l’international jonglent quotidiennement entre francs CFA et devises. Deuxièmement, traduire les libellés de modèles PDF en wolof, bambara ou pular pour les factures destinées aux clients qui préfèrent ces langues — Dolibarr supporte la traduction des templates ODT/PDF par simple édition. Troisièmement, prévoir un mode dégradé pour les coupures internet : une instance Dolibarr locale sur un mini-PC posé dans le bureau, synchronisée chaque nuit avec l’instance principale via rsync chiffré, permet de continuer à émettre devis et factures même sans connexion.

Pour les ETI qui s’étendent à plusieurs pays, le module Multicompany de Dolibarr (payant, 99 €) permet de gérer plusieurs sociétés dans une même instance avec cloisonnement des données, plans comptables différenciés et consolidation. Alternative gratuite : déployer une instance Dolibarr par société et les synchroniser via API pour la consolidation manuelle.

Erreurs fréquentes à éviter

Foire aux questions

Quel coût total annuel pour une TPE de huit utilisateurs ?

Hébergement Hetzner CX22 à 54 €/an, sauvegarde Storage Box 28 €/an, certificat Let’s Encrypt gratuit, prestation locale d’installation et formation entre 350 000 et 800 000 XOF (one-shot), maintenance corrective 200 000 XOF/an. Total premier exercice autour de 1 200 000 XOF, exercices suivants autour de 350 000 XOF — soit cinq fois moins qu’un Sage ou EBP équivalent.

Dolibarr remplace-t-il complètement un expert-comptable ?

Non, Dolibarr produit les écritures et les états SYSCOHADA, mais l’expert-comptable reste indispensable pour la déclaration fiscale, le contrôle de cohérence, la liasse annuelle et le conseil. Dolibarr divise la charge de saisie de 70 % mais ne fait pas disparaître le besoin d’expertise comptable et fiscale.

Peut-on migrer depuis Sage Saari ou EBP ?

Oui via export CSV des tiers et des produits. La reprise des écritures historiques se fait sur l’année en cours par import FEC ou par saisie d’écriture d’à-nouveau au 1er janvier. Les factures historiques restent archivées dans Sage et consultables par l’expert-comptable — pas besoin de les rapatrier dans Dolibarr.

Dolibarr est-il adapté à un cabinet médical ou juridique ?

Oui via les modules Projets, Agenda et ECM. Plusieurs cabinets dakarois et abidjanais l’utilisent pour facturer les consultations, suivre les dossiers et archiver les documents avec contrôle d’accès par utilisateur. Pour des besoins très spécifiques (DPI médical, gestion d’audience), des modules sectoriels existent en marketplace ou se développent en quelques semaines.

Quelle compatibilité avec WooCommerce ?

Excellente via le connecteur officiel WooCommerce sync qui synchronise automatiquement clients, produits, stocks et commandes. Une commande WooCommerce génère automatiquement une facture Dolibarr et déclenche le rapprochement Mobile Money si le paiement est validé. Voir le tutoriel dédié à la synchronisation pour le paramétrage détaillé.

Workflow type d’une PME ouest-africaine sous Dolibarr

Pour visualiser concrètement la valeur d’usage, voici le déroulé d’une journée type dans une PME de huit salariés équipée de Dolibarr 23. Le matin, le commercial reçoit une demande de devis par WhatsApp Business. Il ouvre Dolibarr depuis sa tablette, crée un nouveau tiers en deux minutes (les coordonnées passent automatiquement par l’OCR de la carte de visite jointe), génère un devis détaillé avec sa marge habituelle, l’envoie par e-mail directement depuis l’interface. Le client valide en cliquant sur le lien sécurisé reçu. La transformation en commande est automatique, le stock est réservé, l’équipe production reçoit une notification.

L’après-midi, la facture est générée d’un clic depuis la commande. Le PDF intègre un QR code Mobile Money. Le client scanne, paie en Wave, le webhook arrive dans les secondes qui suivent, la facture passe en statut Réglée, l’écriture comptable est créée au crédit du compte 521-Wave avec contrepartie 411-Client. La comptable ouvre Dolibarr en fin de journée, vérifie que la balance des comptes 411 reflète les encaissements du jour, lance un export FEC partiel pour contrôler les écritures de la semaine. Aucune saisie manuelle, aucune erreur de transcription.

En fin de mois, le dirigeant ouvre les rapports : chiffre d’affaires par client, marge par produit, top 10 des produits les plus vendus, ratio de transformation devis-commande. Ces tableaux de bord sortent en PDF en moins d’une minute et alimentent la réunion mensuelle de pilotage. L’expert-comptable récupère le FEC SYSCOHADA, l’importe dans Sage Compta, valide les écritures, dépose les déclarations fiscales du mois. La PME a gagné l’équivalent de deux mi-temps administratifs sur le mois.

Performance et passage à l’échelle

Dolibarr tient sans difficulté la charge d’une TPE jusqu’à environ 50 000 factures par an et 100 000 produits au catalogue, à condition de respecter trois règles d’optimisation. Premièrement, activer l’opcache PHP avec une mémoire dédiée d’au moins 256 Mo : opcache.memory_consumption=256 dans php.ini. L’opcache cache le bytecode PHP en mémoire et divise le temps de réponse par trois ou quatre sur les pages les plus chargées (liste de factures, recherche multi-critères).

Deuxièmement, dimensionner correctement MariaDB. Le paramètre innodb_buffer_pool_size doit représenter 60 % à 70 % de la RAM totale du serveur dédié à la base. Sur un VPS 16 Go, allouer 10 Go au buffer pool maintient la quasi-totalité des index et des données chaudes en mémoire vive. La latence des requêtes complexes (rapports croisés sur plusieurs années) chute alors d’une dizaine de secondes à moins d’une seconde. Activer aussi le slow query log pour identifier les requêtes lentes et créer les index manquants — Dolibarr en propose nativement quelques-uns mais une instance personnalisée bénéficie souvent d’index supplémentaires sur les champs extra.

Troisièmement, archiver les exercices clos. Une PME qui accumule cinq ans d’historique sans archivage se retrouve avec une base de plusieurs gigaoctets et des recherches dégradées. La pratique consiste à exporter les exercices N-3 et plus anciens vers une instance Dolibarr archive read-only, accessible pour consultation mais hors du flux de production. Cette séparation accélère significativement les rapports et les sauvegardes du système actif.

Migration depuis Excel ou un cahier comptable papier

La grande majorité des TPE ouest-africaines tiennent encore aujourd’hui leur comptabilité sur Excel ou un cahier physique. La migration vers Dolibarr suit alors une procédure standardisée en cinq étapes. D’abord, récupérer les fichiers Excel existants et nettoyer les en-têtes pour exporter en CSV propre : une feuille pour les clients, une pour les fournisseurs, une pour le catalogue produits, une pour les écritures comptables d’à-nouveau. Ensuite, importer chaque CSV via le module d’import natif de Dolibarr — le mapping de colonnes guidé évite les erreurs courantes.

Pour la reprise des soldes comptables, l’expert-comptable fournit la balance d’entrée au 1er janvier. Saisir une écriture d’à-nouveau qui crédite et débite chaque compte selon le solde, par exemple un débit de 411-Client global pour les créances ouvertes et un crédit du même montant en 1101-Capital. Cela permet de démarrer Dolibarr au bon état comptable sans avoir à reprendre toutes les écritures de l’année précédente. Pour les factures en cours d’encaissement, créer une facture de reprise par client avec le solde dû et la date d’échéance d’origine — Dolibarr suivra ainsi correctement les relances impayés.

Former l’équipe et organiser le support

L’outil le mieux paramétré ne sert à rien si l’équipe ne se l’approprie pas. Une formation initiale de deux journées suffit pour former trois utilisateurs aux gestes quotidiens : créer un tiers, émettre un devis, le transformer en facture, suivre les paiements, sortir un rapport mensuel. Pour les fonctions avancées (comptabilité, gestion de stocks multi-dépôts), prévoir une session complémentaire d’une journée animée par un consultant Dolibarr expérimenté. Au Sénégal et en Côte d’Ivoire, plusieurs intégrateurs proposent ces formations à 200 000 à 400 000 XOF la session.

Mettre en place un canal de support interne : un groupe WhatsApp ou Discord où les utilisateurs posent leurs questions, et une checklist d’ouverture de ticket pour les demandes complexes. Référencer aussi les ressources externes utiles : la documentation officielle française, le forum francophone dolibarr.fr, les groupes Telegram d’utilisateurs ouest-africains. Cette infrastructure légère évite que les utilisateurs abandonnent l’outil au premier blocage.

Pour finir, garder en tête que Dolibarr évolue très vite — la communauté publie chaque année des modules sectoriels innovants spécifiques au contexte ouest-africain (paie CNPS Côte d’Ivoire, déclarations CNSS Sénégal, gestion microfinance, suivi caisses villageoises). Suivre régulièrement DoliStore et le forum francophone permet de tirer parti de ces innovations sans réinventer la roue. La PME qui investit ainsi dans son outil de gestion construit un avantage compétitif durable face à ses concurrents restés sur Excel ou sur des solutions cloud étrangères inadaptées au marché local.

Pour aller plus loin

La documentation officielle Dolibarr se trouve sur wiki.dolibarr.org, le code source sur GitHub, et la communauté francophone très active sur dolibarr.fr. Pour la conformité fiscale ouest-africaine, consulter les sites officiels DGI Côte d’Ivoire et DGID Sénégal.