Architecture Dolibarr : multi-devise orienté conformité

Par [Nom du rédacteur] – 3 novembre 2025

1. Introduction

Dolibarr est un ERP‑CRM open‑source conçu pour les PME, les associations et les indépendants. Depuis la version 15, la plateforme s’est renforcée autour d’une architecture modulaire qui facilite l’extension fonctionnelle tout en garantissant la conformité aux exigences légales et comptables. L’un de ses atouts majeurs est la gestion native multidevise (multi‑devise) couplée à un moteur de conformité fiscale et comptable, qui permet aux entreprises opérant dans plusieurs pays de rester alignées avec les règles locales sans recourir à des développements externes lourds.

Cet article décortique l’architecture de Dolibarr au niveau technique, explique comment le module multi‑devise fonctionne, puis montre comment la solution répond aux exigences de conformité (TVA, TVA intracommunautaire, normes comptables, audit).

2. Architecture générale de Dolibarr

2.1. Core & modules

Niveau Description Exemple de module
Core Le noyau (core) fournit les services de base : gestion des entités (clients/fournisseurs), des fiches, de l’utilisateur, du thème, du cache, du journal d’activités. – gestion des catégories de produits
– gestion des comptes bancaires
Modules Chaque fonctionnalité est implémentée comme un module (ex : cashmanager, product, accounting, multicurrency). Les modules sont indépendants et peuvent être activés/désactivés à la volée. – Paiement en ligne (bank)
– Gestion des stocks (stock)
– Facturation (invoice)
Hook system Un système d’« hooks » (évènements) permet aux modules d’intervenir à des points précis (ex : avant sauvegarde d’une facture). – Ajoute un champ supplémentaire à la facture via le hook onBeforeSaveInvoice

Cette architecture modulaire simplifie les mises à jour de conformité : lorsqu’une nouvelle réglementation apparaît (ex : taux de TVA 2025), il suffit d’ajouter ou de modifier le module accounting sans toucher au cœur.

2.2. Stockage des données

  • Base de données : MySQL/MariaDB ou PostgreSQL, avec un schéma normalisé qui utilise des tables dédiées (ex : llx_currencies, llx_price, llx_currency_rates).

  • Tables de conversion : llx_currency_rates conserve les historiques de change (date, taux, source).

  • Gestion des devises : chaque paiement, facture, devis ou devis possède un champ currency qui indique la devise d’affectation.

3. Gestion multidevise (multi‑devise)

3.1. Concepts clés

Concept Définition Implémentation Dolibarr
Devise de l’entreprise Devise par défaut de l’entité juridique (ex : EUR). Paramétrable via Preferences > Currencies.
Devise du client / fournisseur Devise dans laquelle le client ou le fournisseur réalise ses opérations. Stockée dans le champ currency de la table llx_societes.
Devise de la transaction Devise réelle utilisée lors de la création de la facture ou du devis. Peut être différente de la devise de l’entreprise ou du client.
Taux de change Un taux de conversion enregistré à la date de transaction ou récupéré dynamiquement. Table llx_currency_rates + fonction getCurrencyRate($from, $to, $date).

3.2. Flux de travail lors de la création d’une facture

  1. Sélection du client : la devise du client est récupérée.

  2. Choix de la devise de facturation :

    • Si le client est en EUR, la facture est générée en EUR (ou la devise de l’entreprise).

    • Si le client est en USD mais que l’utilisateur veut facturer en EUR, il indique manuellement la devise souhaitée.

  3. Conversion du montant :

    • Le montant brut (ex : 100 USD) est converti en devise cible grâce à getCurrencyRate().

    • Le taux utilisé correspond à la date de la facture (ou à la date du jour si aucunHistorique n’est disponible).

  4. Arrondi : Dolibarr applique les règles d’arrondi propres à chaque devise (ex : 0,01 EUR, 0,05 USD).

  5. Enregistrement : le montant converti est stocké dans la table llx_invoice avec le champ amount. Le taux de change utilisé est enregistré dans llx_currency_rates pour audit.

  6. Affichage : sur les listes et fiches, les colonnes affichent le montant brut (devise client) et le montant net (devise de facturation).

3.3. Gestion des historiques

  • Historique des taux : chaque modification de taux est historisée (date, taux, source).

  • Génération de rapports : la fonction reconcileCurrency() permet de ré‑exécuter tous les changements de devise sur une période donnée afin de préparer des audits fiscaux.

4. Orientation conformité

4.1. Conformité fiscale

Exigence Support Dolibarr Exemple d’implémentation
TVA intracommunautaire Module invoice + accounting Le champ vat_code indique le taux (0 %, 5,5 %, 20 %). Le module vat calcule automatiquement le TVA en fonction du pays du client et du type de opération.
Déclaration de TVA Export CSV/PDF positif/négatif Le module accounting génère un fichier de synthèse conforme au format CA3 (France) ou Intracommunity Declaration (UE).
Gestion des exonérations Module thirdparty / tax Ajout d’un champ « exonération » qui désactive le calcul de TVA pour les transactions avec clients дипломатических ou organisations sans but lucratif.
Retenue à la source Module invoice + accounting Possibilité de définir un pourcentage de retenue qui crée automatiquement un écriture d’avoir dans le plan comptable.

4.2. Normes comptables

  • Plan comptable français (PCG) : Dolibarr propose un plan comptable pré‑configuré (PCG 2022) avec les comptes de 4 (produits), 7 (charges), 445 (TVA collectée), etc.

  • IFRS / GAAP : Le module accounting permet la mapping des comptes Dolibarr vers des plans de comptes externes (ex : compte 2100 → « Stocks » du PCG).

  • Gestion des écritures : Chaque transaction crée automatiquement au moins deux écritures (débit/crédit) afin d’assurer l’équilibrage du bilan.

4.3. Audit et traçabilité

  • Journal des mouvements : La table llx_wall accounts stocke qui a créé/modifié chaque écriture, avec horodatage et IP.

  • Export vers ERP de contrôle : Possibilité d’exporter les écritures au format SEPA, XML XBRL ou CSV pour alimenter des outils d’audit (ex : ACL, IDEA).

  • Contrôle de cohérence : Un job cron (cron:compliance_check) vérifie la cohérence des taux de change et des écritures liés aux transactions.

5. Sécurité et stabilité de l’architecture multidevise

Aspect Solution Dolibarr Bénéfice pour la conformité
Contrôle d’accès Groupes d’utilisateurs + droits modulaires (perm_level). Les droits de modification des taux de change sont limités aux comptables.
Validation des données Formulaires avec règles de validation (ex : champs obligatoires, format décimal). Empêche les erreurs de saisie qui pourraient fausser les calculs de TVA.
Sauvegarde et restauration Fonction backup automatisée + snapshot de la base. Assure la récupération des données historiques de change pour les audits.
Tests unitaires Couverture > 80 % sur les modules multicurrency et accounting. Réduit le risque de régression lorsqu’une nouvelle législation est ajoutée.

6. Cas d’usage pratiques

6.1. Entreprise française exportant vers les États‑Unis

  • Scénario : Une société française vend des services à un client américain (USD).

  • Déroulement :

    1. Le client est créé avec la devise USD.

    2. La facture est générée en EUR, mais l’utilisateur sélectionne la conversion USD → EUR au taux du jour.

    3. Le taux de change est stocké dans llx_currency_rates.

    4. Le calcul de la TVA française s’applique (ex : 20 %).

    5. Un second écriture de TVA exportée en CA3 montre la TVA due et la TVA récupérable.

    6. Le reporting mensuel montre le chiffre d’affaires en EUR et le gain/curate monétaire (difference de change).

6.2. Association internationale avec plusieurs devises

  • Scénario : Une ONG reçoit des dons en EUR, GBP, CAD et les distribue en projets locaux (NGN).

  • Déroulement :

    1. Les dons sont enregistrés avec leur devise d’origine.

    2. Le module accounting convertit chaque donation dans la devise du projet (NGN) en utilisant le taux du jour de réception.

    3. Les écritures comptables respectent la règle de matching (le revenu est reconnu dès la réception du don, la dépense dès la dépense du projet).

    4. Les rapports de conformité génèrent un tableau récapitulatif des flux de devises, indispensable aux bailleurs de fonds.

7. Perspectives d’évolution

Axe d’évolution Description Impact sur la conformité
Intelligence artificielle pour la détection d’anomalies Algorithme de ML qui signale des écarts de change inhabituels ou des factures hors normes. Renforce la vigilance réglementaire et prévient les fraudes.
Intégration native avec les passerelles de paiement PSD2 Support des APIs de banques pour récupérer les taux de change en temps réel et les rapprocher automatiquement. Garantit la traçabilité des flux de paiement transfrontaliers.
Mode “reporting réglementé” Générateur de rapports pré‑conformes aux exigences de la Directive DAC6 (automatique) et du GLN. Simplifie la remise des déclarations aux autorités fiscales.
Multi‑entity (multi‑legal entity) support Gestion simultanée de plusieurs entités juridiques avec leurs propres chartes comptables. Permet aux groupes internationaux de consolider les données tout en conservant la conformité locale.

8. Conclusion

Dolibarr se positionne comme une solution architecturalelement robuste, à la fois modulaire et orientée conformité. Sa gestion native de la multidevise s’appuie sur un moteur de conversion transparent, un historique des taux de change et des règles d’arrondi précises, ce qui évite les erreurs de saisie et assure la traçabilité exigée par les autorités fiscales.

En combinant cette capacité multidevise avec des mécanismes intégrés de TVA, de plan comptable, de journalisation et de contrôle d’accès, Dolibarr devient un outil complet pour les organisations qui œuvrent à l’international et qui doivent répondre à des exigences réglementaires de plus en plus strictes.

Pour les équipes IT et les responsables financiers, la principale valeur ajoutée réside dans la possibilité de déployer rapidement de nouvelles exigences légales (nouveau taux de TVA, nouvelles règles de rétention à la source, mise à jour des normes comptables) sans recourir à du développement externe, tout en conservant une architecture stable et sécurisée.

Sources : documentation officielle Dolibarr 15.x, forums communautaires, cahier des charges.open‑source‑erp.org, tests internes (Nov 2025).

À propos de l’auteur
[Nom du rédacteur] est architecte logiciel spécialisé en ERP open‑source et en conformité fiscale. Il accompagne depuis plus de 8 ans des PME dans la digitalisation de leurs processus comptables et la mise en conformité avec les exigences européennes.

—bigrim->finish()

Publications similaires