Automatiser les Coûts dans Dolibarr : Méthode Spécifique au Maroc
Guide pratique pour les PME et les professionnels marocains
1. Introduction
Dolibarr est un ERP/CRM open‑source très populaire au Maroc, notamment auprès des petites et moyennes entreprises (PME) qui cherchent une solution simple à déployer et à personnaliser. L’une des problématiques récurrentes des entreprises marocaines est la gestion automatisée des coûts (achats, stocks, frais indirects, TVA, etc.) afin de respecter les obligations fiscales du ministère des Finances et d’optimiser la rentabilité.
Cet article détaille, pas à pas, comment automatiser le calcul et la comptabilisation des coûts dans Dolibarr en se situant dans le cadre juridique et économique du Maroc.
2. Cadre Légal et Fiscal de Gestion des Coûts au Maroc
| Élément | Description | Impacts sur Dolibarr |
|---|---|---|
| TVA | Taux standard 20 % (réduit à 10 % ou 7 % pour certains produits/services). | Les règles de TVA doivent être paramétrées dans « Comptabilité → Paramètres → Taux de TVA ». |
| Régime des Incidents de TVA | Déclaration mensuelle ou trimestrielle selon le volume d’activité. | Automatisez la génération des écritures de TVA à chaque facturation ou achat. |
| Plan Comptable Marocain (PCG) | Chartes comptables obligatoires pour les sociétés Marocaines. | Utilisez les classes de compte correspondantes (6xxx pour achats, 7xxx pour charges, etc.). |
| Déclaration de la Taxe sur les Salaires | 0,5 % du total des salaires bruts (si applicable). | Intégrer un script de calcul possible via un module externe ou un web‑hook. |
| Obligations de Tenue de Stock | Semi‑annulaire pour certains secteurs (ex. : agro‑alimentaire). | Les mouvements de stock déclenchent des écritures de coût d’achat/vente. |
3. Architecture Général de l’Automatisation
+-------------------+ +----------------------+ +------------------------------+
| Module "Ventes" | --> | Engine de Triggers | --> | Écritures Comptabilité |
+-------------------+ +----------------------+ +------------------------------+
| | |
v v v
+-------------------+ +----------------------+ +------------------------------+
| Module "Achats" | --> | Calcul Coût Unitaire | --> | Suivi Stock & Valeur |
+-------------------+ +----------------------+ +------------------------------+
- Module “Ventes” : crée automatiquement les lignes de facture (produit, qté, prix, TVA).
- Engine de Triggers : écoute les événements sale, purchase, stock_move.
- Calcul Coût Unitaire : utilise la méthode FIFO, LIFO ou Moyenne pondérée (choix selon la politique de l’entreprise).
- Écritures Comptabilité : génère les mouvements GL (Compte d’achat, TVA,Compte de Stock, Coût de Vente).
4. Étapes Pratiques de Mise en Place
4.1. Installation et Configuration Initiale de Dolibarr
-
Déploiement
- Serveur LAMP (Linux, Apache, MySQLMariaDB, PHP ≥ 7.4).
- Télécharger la dernière version stable de Dolibarr depuis
https://www.dolibarr.org. - Créer une base MySQL dédiée (
dolibarr_maroc).
-
Activation des Modules Essentiels
- Commerce → Factures / Devis
- Fournisseurs → Commandes / Factures fournisseurs
- Stocks → Articles / Mouvements
- Facturation → TVA (définir les taux 20 %, 10 %, 7 %).
-
Paramétrage du Plan Comptable Marocain
Créer un nouveau compte→ choisir le numéro conforme au PCG.- Exemple :
- 601 : Achats de marchandises (produits finis).
- 626 : Charges sociales (salaires).
- 658 : Frais de transport.
- 706 : Produits divers (revenus).
- Import d’un fichier CSV du PCG complet si nécessaire.
- Définir les Taux de TVA
Facturation → TVA → Ajouter→ saisir : Code TVA, Libellé, Taux, Régime (standard/réglementé).
4.2. Configuration du Calcul Automatique du Coût
| Action | Chemin Dolibarr | Paramètre à Régler |
|---|---|---|
| Méthode de Valorisation du Stock | Stocks → Configuration → Méthode de valorisation |
Choisir FIFO, LIFO ou Moyenne. |
| Calcul du Coût Unitaire | Articles → Entrées → Prix d’achat |
Entrer le prix d’achatHT + frais d’import (ex. frais de douane, frais de transport). |
| Automatisation des Coûts d’Import | Fournisseurs → Options → Frais additionnels |
Ajouter un champ « Frais supplémentaires » et le passer au compte 601 via un script (PHP) ou un module externe. |
| Déclencheurs (Triggers) | Extensions → Event Hooks (si dispos) |
Créer un hook sur order_confirm ou order_add pour copier les lignes de commande dans la table llx_stock_movement. |
Exemple de Script PHP (Hook “order_confirm”)
<?php
global $db;
$order_id = $_GET['id']; // ID de la commande confirmée
// 1. Récupérer le coût d'achat de chaque article
$res = $db->query('SELECT lfk_piece_numero, lfk_product, lfk_qty, lfk_price',
$db->prepare('SELECT product, qty, price FROM llx_line WHERE fx_id = ?', [$order_id]));
while ($row = $db->fetch_object($res)) {
// 2. Calcul du coût total = qty * price + frais de douane (ex 5% du prix)
$frais_douane = $row->price * 0.05; // hypothèse 5% frais divers
$cout_total = $row->qty * ($row->price + $frais_douane);
// 3. Crée la ligne de ventilation comptable
$sql = 'INSERT INTO llx_accounting_entries
(fk_user, fk_account, label, debit, amount, date, entities, subendi)
VALUES (0, 601, CONCAT("Achats ", $row->product), 1, '.$cout_total.',
NOW(), 0, 0)';
$db->query($sql);
}
?>
Note : Ce script doit être placé dans
htdocs/custom/et déclaré dans le fichiermanifest.xmldu module personnalisé.
4.3. Automatisation des Écritures de TVA
-
Paraméter la règle de génération :
Comptabilité → Règles de TVA → Activer l'automatisation.
-
Définir les écritures par défaut :
- Débit TVA collecté (44566) – Crédit TVA à décaisser (44566) lorsqu’une facture est émise.
- Débit TVA déductible (445666) – Crédit TVA fournisseurs (44566) lors d’une facture d’achat.
- Trigger automatique : à chaque validation de facture (Invoice → Validate), l’extension
accountinggénère directement les écritures correspondantes.
Tip marocain : Si vous êtes soumis au régime de la TVA mensuelle, créez un job cron (Linux) qui exécute le script
cron_accounting.phptoutes les 1ères heures du mois pour consolider les écritures en attente.
4.4. Suivi des Coûts Indirects (Charges Fixes)
- Exemples : loyers, frais d’énergie, amortissements.
- Méthode : créer des dimensions budgétaires (ex. “Charge‑Energie”) dans Dolibarr → Budget → assigner à chaque compte du PCG.
- Automatisation : un module externe (ex. Dolibarr Budget Modules) permet de répartir automatiquement ces charges selon un taux fixe (ex. 2 % du CA).
4.5. Reporting et Tableau de Bord
| Tableau de bord | Contenu | Source Dolibarr |
|---|---|---|
| Coût de Vente Brut (COGS) | Valeur totale des achats + frais d’import + évolutions de stock. | Rapports → Stock → Valeur du stock. |
| Marge Nette% par Article | (Prix de vente HT – Coût unitaire) / Prix de vente HT. | Export CSV → Excel / Power BI. |
| Evolution de la TVA | Montant collecté vs déductible par période. | Comptabilité → Rapports → TVA. |
| Analyse des Charges Indirectes | Répartition par centre de coût (ex. Labor, Transport). | Export gl_accounting_lines vers un script Python. |
5. Bonnes Pratiques Spécifiques au Maroc
| Pratique | Pourquoi | Implémentation dans Dolibarr |
|---|---|---|
| Intégration des frais de douane et de transport | Obligatoires pour les importations. | Ajouter un champ “Coût supplémentaire” à la ligne de commande et le mapper sur le compte 601. |
| Gestion du Régime Fiscal des PME (RFR‑PME) | Certaines PME bénéficient d’un abattement de 30 % sur le bénéfice imposable. | Nécessite un calcul manuel dans un module “RFR‑PME” qui ajoute un tag aux écritures. |
| Déclaration périodique de la CEMA (Caisse d’Assurances Sociales) | Contribution proportionnelle aux salaires. | Créer une règle de calcul mensuelle dans le module HR → Payroll, puis déclencher une écriture comptable vers le compte 626. |
| Mise à jour automatique du taux de change (DH → USD/EUR) | Les importations sont en devises étrangères. | Utiliser le plugin CurrencyRate qui récupère les cours depuis la Banque Centrale (BMCE) chaque jour. |
| Respect du délai de paiement de 30 jours | Obligation légale pour les fournisseurs privés. | Configurer le +30 days dans les paramètres de facture et créer un rappel automatisé via le moteur de task scheduler. |
6. Exemple Complet : De la Commande à la Facturation
6.1. Étape 1 – Réception d’une Commande Fournisseur
- Création de la commande :
Fournisseurs → Commandes → Créer. - Ajout de l’article : Sélection du produit, quantité, prix unitaire HT.
- Ajout des frais :
- Frais de douane : 5 % du coût total (
prix * qty * 0.05). - Transport : montant fixe de 150 MAD.
- Frais de douane : 5 % du coût total (
- Validation → La ligne de commande est automatiquement créée dans
llx_stock_movement.
6.2. Étape 2 – Réception et Enregistrement du Stock
- Réception :
Stocks → Réception→ La quantité reçue est rattachée àllx_stockavec le coût d’achat (prix HT + frais). - Mise à jour du coût : Le système calcule la nouvelle valeur moyenne pondérée (ou FIFO si configuré).
6.3. Étape 3 – Vente du Produit (Facturation)
- Création de la facture client :
Ventes → Factures → Créer. - Sélection du produit → Quantité vendue.
- Application du taux de TVA (ex. 20 %).
- Calcul du coût de vente : Le coût d’achat (déduit du stock) est débit sur le compte
601(ou603selon la catégorie). - Génération de l’écriture :
- Débit
601 – Achats(coût du produit). - Crédit
401 – Fournisseurs(montant total HT). - Débit
706 – Produits divers(revenu HT). - Crédit
445666 – TVA à décaisser(montant de TVA collectée).
- Débit
6.4. Étape 4 – Automatisation du Reporting Mensuel
- Script PHP (planifié via cron) qui extrait les écritures du mois précédent et les projette dans un tableau de bord BI (ex. Power BI).
- Export au format CSV pour les auditeurs fiscaux.
7. Outils Complémentaires (Modules & Extensions)
| Extension | Fonction | Installation | Particularité Marocaine |
|---|---|---|---|
| Dolibarr Accounting Extend | Ajout de champs personnalisés pour les frais d’import. | git clone https://github.com/Dolibarr/dolibarr-accounting-extend.git |
Possibilité d’ajouter le taux de change officiel de la BMCE. |
| VAT Morocco | Gestion avancée du régime de la TVA (déclaration, paiement). | Via le marketplace Dolibarr. | Génère automatiquement les bordereaux de TVA au format PDF exigé par l’Administration des Contributions. |
| Budget Planner | Suivi des coûts indirects par centre de coût. | Téléchargement depuis GitHub. | Permet de planifier le taux de répartition des charges fixes (ex. loyer / CA). |
| Telegram / Slack Notification | Alertes en temps réel sur les écritures critiques (déblocage de TVA, dépassement de seuils). | Installation via API. | Utilisé par les comptables marocains pour être informés des échéances de paiement. |
8. Checklist de Déploiement (Version Maroc)
| ✅ Item | Vérif. |
|---|---|
Base de données : MySQL 8 compatible, charset utf8mb4. |
|
| Plan Comptable : Tous les comptes importés conformes au PCG. | |
| Taux de TVA : 20 % standard, 10 %/7 % pour catégories spécifiques. | |
| Méthode de valorisation du stock : définie (FIFO/LIFO/moyenne). | |
Frais supplémentaires : champs créés et liés aux comptes 601. |
|
Triggers : hooks order_confirm, invoice_validate fonctionnels. |
|
| Automatisation TVA : génération d’écritures chaque vente/achat. | |
| Job cron : script de consolidation mensuel des écritures. | |
| Export légal : factures et bordereaux de TVA en PDF conforme aux exigences de l’Office des Changes. | |
| Sécurité : authentification 2FA pour les utilisateurs comptables. |
9. Conclusion
L’automatisation des coûts dans Dolibarr offre aux entreprises marocaines un levier puissant pour :
- Réduire les erreurs manuelles de saisie comptable.
- Assurer la conformité fiscale (TVA, impôt sur les sociétés, frais de douane).
- Optimiser la visibilité financière grâce à des rapports en temps réel.
- Adapter rapidement les changements législatifs ou tarifaires grâce aux hooks personnalisables.
En suivant la méthodologie décrite – configuration du plan comptable, mise en place des triggers d’événements, intégration des frais d’importation et création de rapports dédiés – vous disposerez d’un système de gestion des coûts robuste, adaptable et conforme aux exigences du Maroc.
Prochaine étape : Pilotage d’un projet pilote sur un compte‑fournisseur représentatif, suivi des KPI (coût de revient, marge nette, délai de règlement) pendant 3 mois, puis généralisation à l’ensemble de l’organisation.
Ressources complémentaires
- Documentation officielle Dolibarr : https://www.dolibarr.org/doc.function.php
- Guide fiscal marocain 2024 (Ministère des Finances).
- Forums communautaires : https://forum.dolibarr.org – rubrique “Maroc – fiscalité”.
- Templates de PCG : téléchargement depuis le site du Conseil National du Comptabilité Publique (CNCP).
Bonne automatisation ! 🚀