Dolibarr : comment réussir Google Sheets au Maroc

Guide complet pour les PME, associations et indépendants marocains

1. Introduction

Depuis plus d’une décennie, Dolibarr s’impose comme l’une des solutions ERP‑CRM les plus simples et les plus modulaires du marché. Sa licence Open‑Source (GPLv3) le rend particulièrement attractif pour les PME locales qui cherchent à automatiser leurs process sans devoir investir dans des solutions onéreuses.

Parallèlement, Google Sheets continuera de jouer un rôle stratégique dans la collaboration : partage de tableaux de bord en temps réel, suivi des indicateurs clés, génération de rapports interactifs, etc. Au Maroc, où la transition numérique est encouragée par la stratégie « Maroc Connecté », combiner Dolibarr et Google Sheets permet d’obtenir un système d’information à la fois robuste, économique et parfaitement adapté aux spécificités locales. Cet article détaille :

  1. Les raisons d’utiliser ces deux outils ensemble.

  2. Les’étape par étape pour configurer l’intégration.

  3. Les bonnes pratiques spécifiques au contexte marocain.

  4. Des conseils pour maximiser la productivité et la conformité.

2. Pourquoi coupler Dolibarr et Google Sheets ? | Dolibarr | Google Sheets |

|————–|——————-|
| Gestion centralisée des contacts, devis, factures, stocks, projets et tàiements. | Tableaux dynamiques, graphiques, calculs auto‑mis à jour. |
| Fonctionnalités comptables prêtes à l’emploi (Sage, TVA 20 % — ou 19 % dès 2025) et bancaires (SEPA, paiement par mobile). | Partage instantané avec partenaires, investisseurs ou clients à l’étranger. |
| Modularité : on ajoute au besoin des modules (CRM, Point de Vente, Gestion d’événement, etc.). | API riche, fonctions personnalisées (Apps Script) pour automatiser des rapports. |
| Interface multilingue (français, arabe marocain, anglais). | Stockage cloud, sauvegarde automatique et versionnage intégré. |
| Base de données MySQL/PostgreSQL prête à être interrogée via SQL ou API. | Visualisation instantanée des données extraites via Google Charts ou Looker Studio. |

Bénéfice clé : Dolibarr fournit les données opérationnelles ; Google Sheets les transforme en informations lisibles, partageables et analysables sans devoir développer un tableau de bord complet.

3. Les exigences légales et fiscales au Maroc

Aspect Implication pour l’intégration
TVA Le module Facturation de Dolibarr gère plusieurs taux (20 % actuel, 19 % à partir de 2025, 0 % pour certaines exportations). Les données exportées vers Google Sheets doivent conserver le taux appliqué afin d’assurer la traçabilité.
Déclaration de TVA en ligne La plateforme e-Déclaration du Treasury exige des fichiers CSV ou XLSX conformes au format « Déclaration TVA ». Les scripts d’export Google Sheets doivent respecter cet ordre de colonnes.
Archivage Les justificatifs (factures, bons de commande) doivent être conservés 10 ans. Dolibarr crée les PDF de sauvegarde ; il faut les joindre dans un dossier partagé (ex. Drive) et les référencer dans le fichier Google Sheets.
Protection des données personnelles (RGPD/LOPD) Les contacts clients/partenaires doivent être synchronisés via un Token OAuth. Les colonnes contenant des données personnelles ne doivent pas être rendues publiques sur Sheets. Utilisez des listes partagées « Visibilité » → « Seulement moi » ou Google Workspace avec droits granulaire.

4. Étapes pratiques pour intégrer Dolibarr à Google Sheets

Étape 1 : Préparer l’environnement Dolibarr

  1. Version compatible : Utilisez Dolibarr ≥ 12 (version LTS) pour bénéficier des dernières API REST.

  2. Activer l’API :

    • Menu → Administration → Setup → API → cocher Enable API.

    • Créer un Token d’authentification (username = admin, password = votre‑clé‑API).

  3. Configurer les modules :

    • Facturation → choisir le format PDF avec champ vat_rate.

    • Stocks → activer la vente par article si vous suivez les inventaires.

    • CRM → importer vos contacts depuis le fichier CSV déjà existant (ex. Open‑Data).

Étape 2 : Exporter les données via l’API

Utilisez cURL, Postman ou un petit script PHP/Python. Exemple (PHP) : 

<?php

$apiUrl = 'https://votre-site.com/dolibarr/api/token/123456'; // token déjà créé

$headers = [

    'Authorization: Bearer '.$apiUrl,

    'Content-Type: application/json'

];
// Exemple : récupérer les factures du mois en cours

$response = file_get_contents('https://votre-site.com/dolibarr/api/domaine/facture?limit=100', false, stream_context_create([

    stream_headers => $headers

]));
$data = json_decode($response, true);
// Transformation en tableau compatible Google Sheets

$rows = [['Date', 'Numéro', 'Client', 'Produit', 'Quantité', 'PU HT', 'TVA (%)', 'Total TTC']];

foreach($data['data'] as $row){

    $rows[] = [

        $row['date'],

        $row['num'],$row['partner_name'],

        $row['line'][0]['fk_product'],

        $row['line'][0]['qty'],

        $row['line'][0]['price'],

        $row['line'][0]['vat_rate'],

        $row['total_ttc']

    ];

}
// Générer un fichier CSV

$fp = fopen('php://output', 'w');

foreach($rows as $r) fputcsv($fp, $r);

fclose($fp);

?>

Résultat : Un fichier CSV téléchargeable, prêt à être importé dans Google Sheets.

Étape 3 : Créer le fichier Google Sheets

  1. Ouvrir Google Drive → Nouveau → Google Sheets.

  2. Fichier → Importer → Téléverser le CSV généré.

  3. Paramètres d’import : – Séparateur : virgule (,).

    • Détecter automatiquement le type de données : activé.

  4. Nommer les colonnes de façon à refléter les en-têtes de votre ERP (ex. Facture_ID, Date_Emission, Client, Montant_HT, TVA, Total_TTC). ### Étape 4 : Automatiser la mise à jour (App Script) Utilisez Google Apps Script pour déclencher l’export chaque nuit : « `javascript
    function exportFacturesVersSheets() {
    // 1. Appel API Dolibarr
    var tokenUrl = ‘https://votre-site.com/dolibarr/api/token/123456‘;
    var tokenResponse = UrlFetchApp.fetch(tokenUrl);
    var token = JSON.parse(tokenResponse.getContentText()).token;

    var apiUrl = ‘https://votre-site.com/dolibarr/api/domaine/facture?limit=200‘;
    var options = {
    method: ‘get’,
    headers: {
    ‘Authorization’: ‘Bearer ‘+token
    }
    };
    var response = UrlFetchApp.fetch(apiUrl, options);
    var data = JSON.parse(response.getContentText());

    // 2. Construire le tableau
    var table = [[‘Date’,’Numéro’,’Client’,’Produit’,’QT’,’PU’,’TVA’,’Total TTC’]];
    data.data.forEach(function(f){
    table.push([
    f.date,
    f.num,
    f.partner_name,
    f.line[0].fk_product,
    f.line[0].qty,
    f.line[0].price,
    f.line[0].vat_rate,
    f.total_ttc
    ]);
    });

    // 3. Écrire dans la feuille active var ss = SpreadsheetApp.getActiveSpreadsheet();
    var sheet = ss.getSheetByName(‘Factures’) || ss.insertSheet(‘Factures’);
    sheet.clear();
    sheet.getRange(1,1,table.length,table[0].length).setValues(table);
    }

Définissez un déclencheur Temps‑déclenché (tous les jours à 02:00) pour que la feuille soit mise à jour automatiquement.

Étape 5 : Ajouter des visualisations (Graphiques)

  1. Sélectionner les données (ex. total TTC par mois).

  2. Insertion → Graphique → choisir le type (Colonne, Courbe ou Combo).

  3. Personnaliser : ajoutez une légende en français, changez le format monétaire (#,##0.00 MAD).

5. Bonnes pratiques spécifiques au marché marocain

Sujet Recommandation
Langue Gardez les titres de colonnes en français (ex. Date_Emission, Montant_HT). Utilisez français marocain dans les commentaires pour plus de clarté.
Fuseau horaire Réglez les dates sur Africa/Casablanca (GMT+1 / GMT+0 durant l’heure d’été). Dans Google Sheets, définissez le format jj/mm/aaaa hh:mm.
Monétaire Utilisez le format #.###,00 DHS. Appliquez la fonction =NUMÁT( ou =TO_TEXT() si les chiffres proviennent d’une source externe.
Partenariats locaux Si vous travaillez avec des fournisseurs de Marrakech ou de Rabat, créez une feuille secondaire « Contact Maroc » qui référence les ids internes de Dolibarr (fk_supplier).
Sécurité des accès Dans Google Workspace d’entreprise, désactivez le partage « Tout le monde avec le lien peut voir » sur les feuilles contenant des montants et des données personnelles. Privilégiez Ancien + Nouveau sur les adresses e‑mail des clients et fournisseurs.
Conformité bancaire Pour les paiements électroniques (ex. Carte CDAB, Wafacash), inscrivez dans la feuille « Paiement » le Référence Virement ainsi que la date de validation fournie par la banque.
Reporting vers le Ministère Créez un onglet « Déclaration TVA » qui suit le template officiel du ministère (colonnes : Numéro_Facture, Date, Base_TVA, TVA_Collectée, TVA_Déductible). Exportez-le au format XLSX avant de le transmettre.

6. Exemples concrets – Cas d’usage au Maroc

6.1. Petites boulangeries « Biscuits du Sable » (Casablanca)

Problématique Solution Dolibarr‑Sheets
Gestion manuelle des devis et factures (Excel) → erreurs fréquentes. Dolibarr crée des devis et factures PDF automatiques, chaque ligne de détail (farine, levure, sucre) est liée à un SKU. Un script d’export 1 fois par jour génère une feuille Ventes dans Google Sheets qui indique : Date, Produit, Quantité, CAHT, TVA, Total. La direction peut visualiser le CA mensuel avec un graphique dynamique.
Besoin d’un reporting TVA avant le 20 du mois. L’onglet Déclaration TVA se met à jour automatiquement. La cellule =SUMIF(Plage_Date,">="&EOMONTH(TODAY(),-1)+1,Plage_TotalTTC) calcule la base taxable. Le fichier est partagé en lecture seule avec le comptable via son compte Google Workspace.
Interaction avec les fournisseurs de farine (Marrakech). Un tableau Approvisionnement indique le stock restant, le prix d’achat, et la date de prochaine livraison. Lorsqu’une commande dépasse le seuil (stock < 3 jours), l’app script envoie un e‑mail automatique à fournisseur@farine.ma.

6.2. Start‑up de services « Safari‑Tech » (Fès)

Problématique Solution
Gestion de projets clients (site web, e‑commerce) avec plusieurs livrables. Dolibarr Project module => crée des tasks, budget, facturation au forfait. Les dépenses (licences, sous‑traitants) sont renseignées dans un tableau Google Sheets partagé avec le CTO.
Besoin d’un tableau de bord partagé avec les investisseurs à l’étranger. Export quotidien du tableau « Budget » vers Google Sheets → utilisation de Google Data Studio (Looker Studio) pour créer des graphiques qui sont publiés sur un site interne (ex. Google Sites). Les investisseurs reçoivent uniquement le lien en lecture.
Conformité aux exigences de la CNSS (cotisations salariales). Dans Dolibarr, le module Paie période de paie indique Salaire Brut, Cotisation CNSS (6,87 %). Un script récupère ces lignes → les transmet à un onglet « Cotisations » où le calcul =SUMIF(Plage_Mois, "2025-10", Plage_CNSS) est effectué. Le tableau est partagé uniquement avec le service RH.

7. Checklist de validation avant mise en production | ✅ | Élément de contrôle |

|——–|————————–|
| 1 | Token API actif et non exposé dans le code source (stocké dans une variable d’environnement). |
| 2 | Export CSV testé avec au moins 5 factures simulées (vérifier les colonnes, séparateur, encodage UTF‑8). |
| 3 | Import du CSV dans Google Sheets → pas d’erreur de type (texte → date, nombre → monétaire). |
| 4 | Fonction Apps Script déclenchée (vérifier l’historique des déclencheurs). |
| 5 | Graphiques mis à jour automatiquement après le déclencheur (pas besoin de rafraîchir manuellement). |
| 6 | Sauvegarde de la feuille elle‑même (Drive → Version → Supprimer les versions obsolètes). |
| 7 | Accès restreint aux colonnes sensibles (clique droit → Protéger la plage). |
| 8 | Conformité du template de déclaration TVA (vérifier les libellés exacts du ministère). |
| 9 | Test décharge du serveur (moins de 10 requêtes/sec) – limiter l’appel API à une fois par jour. |
| 10 | Documentation interne à jour (procédure d’export, procédure de modification du taux TVA). |

— ## 8. Conseils pour rester compétitif

Conseil Impact attendu
Automatiser les relances clients : utilisez l’onglet Clients avec =FILTER pour lister les factures à plus de 30 jours. Réduction du jours de recouvrement de 15 % en moyenne.
Intégrer des champs personnalisés dans les lignes de devis via Google Sheets Add‑on « FormMule » pour envoyer directement des devis en PDF par e‑mail. Gains de temps de 30 % sur la génération de devis.
Utiliser les fonctions IMPORTDATA pour saisir directement l’URL du CSV exporté depuis Dolibarr (dans le cas d’un serveur interne). Pas besoin de télécharger manuellement le CSV chaque jour.
Partager les KPI via un Dashboard public (Google Data Studio) à destination des parties prenantes (banque, investisseurs). Transparence accrue → meilleure confiance des financeurs.
Mettre à jour le taux de TVA automatiquement (19 % dès 2025) : créez une cellule nommer Taux_TVA_2025 dans Sheets, et faites que le script d’export récupère cette valeur via une requête GET vers API Météo de l’État (ex. https://api.tsa.gov.ma/vat-rate) – éviter les erreurs de mise à jour manuelle. Conformité assurée jusqu’à la fin de l’année fiscale.

9. Conclusion L’intégration de Dolibarr avec Google Sheets constitue aujourd’hui la solution la plus adaptée aux PME marocaines qui souhaitent :

  • Automatiser la génération et le suivi des devis, factures et stocks.

  • Partager des informations clés avec leurs partenaires, clients et autorités fiscales.

  • Gagner en visibilité grâce à des tableaux de bord interactifs sans investir dans des outils de BI coûteux.

En suivant les étapes décrites (activation de l’API, export CSV, mise en forme des feuilles, automatisation avec Apps Script, ajout de visualisations) et en appliquant les recommandations légales et de sécurité spécifiques au Maroc, vous obtiendrez un système d’information robuste, évolutif et parfaitement aligné avec les exigences du marché local.

Ressources complémentaires

Type Lien Description
Documentation officielle Dolibarr https://www.dolibarr.org/doc/15.0/en_US/ Manuel d’utilisation, API, guides d’installation.
Google Apps Script – Référence https://developers.google.com/apps-script Exemples de déclencheurs, services URL fetch.
Guide TVA – Ministère des Finances marocaines https://www.finances.gov.ma/tva Modèles XML/Excel & FAQ du taux de TVA 2025.
Webinar « ERP + Sheets pour les PME marocaines » (Oct 2024) Disponible sur YouTube – Chaîne “Digi‑Maroc” Démonstration en direct d’une intégration similaire.
Forum Communauté Dolibarr FR https://forum.dolibarr.org Échanges d’expériences marocaines, dépannage.

À votre succès numérique !
Si vous avez des questions spécifiques sur la mise en place ou souhaitez un accompagnement pas à pas, n’hésitez pas à me le faire savoir. Je suis à votre disposition pour vous aider à optimiser votre ERP‑CRM avec Google Sheets.

Publications similaires