Dolibarr pour TPE : CSV avec des exemples concrets

1. Pourquoi le CSV est une aubaine pour les TPE

Avantage Explication Impact pour la TPE
Légèreté Le format CSV (valeurs séparées par des virgules) est universel : il peut être lu par Excel, Google Sheets, LibreOffice ou même par un éditeur texte. Pas besoin d’une licence coûteuse ; on travaille avec des outils déjà en main.
Interopérabilité Les données exportées depuis Dolibarr sont compatibles avec d’autres logiciels (CRM, comptabilité, e‑commerce). Facilite les échanges avec des partenaires, fournisseurs ou des plateformes de vente en ligne.
Portabilité Les fichiers CSV peuvent être sauvegardés, versionnés (Git, cloud) et restaurés facilement. Protection contre les pannes ou les pertes de données.
Automatisation Les scripts (Python, PowerShell, Bash) peuvent ingérer des CSV pour mettre à jour massivement les données. Gains de temps sur les tâches répétitives (import de nouvelles fiches, mise à jour de prix, etc.).
Transparence Le contenu du fichier est lisible en texte brut. Repérage rapide d’erreurs ou de doublons.

2. Les principaux CSV de Dolibarr

Dolibarr propose plusieurs fichiers CSV prêts à être exportés ou importés :

CSV Usage typique Exemple d’utilisation pour une TPE
list of customers (client) Export/import des contacts clients Copier‑coller le CSV dans Excel pour préparer une campagne mail ; ré‑importer après nettoyage des doublons.
list of suppliers (fournisseur) Gestion des fournisseurs Mettre à jour les délais de paiement automatiquement depuis le logiciel comptable (via un macro).
list of products (produit) Catalogue de marchandises Exporter la fiche produit pour la synchroniser avec le CSV d’un marketplace (Etsy, e‑Bay).
list of invoices (facture) Historique des factures Faire un point mensuel de trésorerie en important le CSV dans un tableur de suivi de trésorerie.
list of stocks (stock) Niveaux de stock et mouvements Utilisé pour déclencher automatiquement des réapprovisionnements quand le stock passe sous un seuil.
list of orders (commande) Commandes clients Exporter les commandes du mois pour les analyser et prévoir les besoins en production.
list of users (utilisateur) Gestion des accès Export pour intégrer un tableau de suivi des habilitations et auditer les droits.

Astuce : Dans le menu Administration → Outils → Export/Import CSV, vous pouvez choisir le format « Excel » (comma‑separated) ou « CSV UTF‑8 » selon vos préférences régionales.

3. Exemple concret : Importer un tableau de produits depuis un CSV

3.1. Situation Vous avez reçu un fichier produits_fournisseurs.csv envoyé par un grossiste :

RefProduit,Libellé,Description,PrixHT,Quantité,ID_Fournisseur

00123,Clé USB 16 Go,Clé USB 16 Go 2,50 €,150,10

00124,Souris Noir, Souris optique, 5,80 €,80,10

00125,Carte SD 32 Go, Carte SD 32 Go, 9,90 €,120,12```
Votre boutique en ligne nécessite que chaque article possède un **SKU** unique (ex. `SKU_00123`) et un **prix de vente** calculé à 30 % au-dessus du prix d’achat.
### 3.2. Étapes dans Dolibarr  
1. **Préparer le CSV** (ajout du SKU et du prix de vente).  

   Dans Excel :     - Ajoutez deux colonnes `SKU` et `PrixVente`.     - Formule `=A2` + `*1.30` pour le prix de vente.  

   - Le fichier final ressemble à :
```csv

   RefProduit,Libellé,Description,PrixHT,Quantité,ID_Fournisseur,SKU,PrixVente

   00123,Clé USB 16 Go,Clé USB 16 Go 2,50,150,10,SKU_00123,6,50

   00124,Souris Noir,Souris optique,5.80,80,10,SKU_00124,7,52

   00125,Carte SD 32 Go,Carte SD 32 Go,9.90,120,12,SKU_00125,12,9,96

  1. Aller dans Gestion des produits → Importation CSV (ou Produits → Import CSV).

  2. Configurer l’import :

    • Fichier source : sélectionner le fichier CSV préparé.

    • Séparateur : « , » (virgule).

    • Encodage : UTF-8.

    • Mapping : associer chaque colonne du CSV à un champ Dolibarr (label, price, sku, etc.).

    • Résultat attendu : Si un RefProduit est déjà présent, l’import « met à jour » l’enregistrement (option « Update if exists »).

  3. Lancer l’import : cliquez sur ‘Importer’.

  4. Vérifier : le module produit affichera les nouvelles entrées, avec le SKU et le prix de vente encodés.

3.3. Résultat

  • Les 3 produits apparaissent dans la liste Produits → Catalogue.

  • Vous pouvez maintenant créer des ventes en un clic, car le champ SKU est reconnu par le module de facturation.

  • Les modifications sont détectables immédiatement dans les rapports de stocks (Stock → Consultation).

4. Export CSV vers un logiciel externe : le cas d’un tableau de suivi de trésorerie

4.1. Objectif

Exporter la liste des factures payées au mois de septembre afin d’alimenter un tableau de suivi de trésorerie partagé sur Google Sheets.

4.2. Procédure

Étape Action Détails
1 Administration → Export CSV → Factures Sélectionner le filtre Statut = Paid et la période 2025-09-01 → 2025-09-30.
2 Choisir les colonnes Facture ID, Client, Date, Montant HT, Montant TTC, Mode de paiement.
3 Export Cliquer sur Export → le fichier factures_sept_2025.csv est téléchargé.
4 Uploader sur Google Sheets Dans Sheets, créer un nouvelle feuille → Fichier > Importer > Téléverser > Sélectionner le CSV.
5 Mise en forme Appliquer une mise en forme conditionnelle :
– Montant TTC < 100 → fond rouge
– Montant TTC > 1000 → fond vert.
6 Partage Partager la feuille avec le comptable et le directeur financier.

4.3. Avantages

  • Pas de duplication : les données sont directement extraites depuis Dolibarr, aucune saisie manuelle.

  • Actualisé chaque mois : il suffit de relancer l’export le 1er du mois suivant.

  • Traçabilité : chaque ligne possède un identifiant unique (Facture ID) permettant de tracer les paiements dans Dolibarr.

5. Automatisation via un script : mise à jour de prix basée sur un CSV de coûts

5.1. Situation

Le service achats a publié un fichier coûts_fournisseurs.csv contenant les nouveaux prix d’achat pour 250 articles. Vous devez mettre à jour automatiquement le champ Prix d’achat dans Dolibarr.

5.2. Script Python minimal (exemple)

import csv

import urllib.request

import urllib.parse
# 1. Lecture du CSV de coûts

url_csv = "https://monsite.com/coûts_fournisseurs.csv"

with urllib.request.urlopen(url_csv) as f:

    rows = list(csv.DictReader(f))
# 2. Connexion à Dolibarr (API DoliAPI)

API_URL = "https://shop.mondomaine.com/dolibarr/api"

TOKEN = "YOUR_API_TOKEN"
def update_product_price(ref, new_purchase_price):

    data = {

        "type": "product",

        "action": "update",

        "values[price_buying]": str(new_purchase_price),

        "range": [ref]  # champ Bibliographic reference

    }

    req = urllib.request.Request(

        API_URL,

        data=urllib.parse.urlencode(data).encode(),

        headers={"Authorization": f"Bearer {TOKEN}", "Content-Type": "application/x-www-form-urlencoded"}

    )

    urllib.request.urlopen(req)   # ignore response for demo
# 3. Boucle sur chaque ligne du CSV

for row in rows:

    ref = row["RefProduit"]

    price = float(row["PrixAchat"])

    update_product_price(ref, price)
print("Mise à jour terminée.")

5.3. Pourquoi utiliser le CSV ?

  • Source unique : le fichier est fourni par le service achats, aucune perte d’information.

  • Traçabilité : chaque ligne possède le RefProduit correspondant à l’identifiant interne de Dolibarr.

  • Évolutivité : le script peut être planifié (cron) pour appliquer chaque trimestre les nouveaux prix.

6. Bonnes pratiques pour manipuler les CSV avec Dolibarr

Bonnes pratiques Pourquoi c’est important
Système d’encodage UTF‑8 Evite les caractères spéciaux (é, è, ç) qui se transforment en é.
Séparateur cohérent (, ou ;) Certains pays utilisent le point‑virgule comme séparateur. Choisir le même séparateur que le logiciel qui ouvrira le fichier évite les fautes de parsing.
Inclure un header Permet à Dolibarr d’associer automatiquement chaque colonne à son champ interne.
Contrôler les doublons avant import Utilisez un tableur ou un script pour identifier et fusionner les doublons afin d’éviter la création de fiches dupliquées.
Sauvegarder le CSV avant import En cas d’erreur, on peut revenir à la version précédente.
Tester sur un sous‑ensemble Importer d’abord 5‑10 lignes pour vérifier le mapping avant de lancer l’import complet.
Versionner les CSV (ex. Git) Historique des changements, possibilité de revenir à un état antérieur.
Utiliser les champs obligatoires Ne pas exporter ou importer de champs marqués « mandatory » avec des valeurs vides ; sinon l’import échouera.

7. Conclusion

Le format CSV est, pour les TPE, le pont le plus simple et le plus fiable entre Dolibarr et les autres outils de gestion (comptabilité, ventes en ligne, suivi de trésorerie). – Export : récupérez les données clefs (clients, produits, factures) et réutilisez‑les dans des tableurs ou des API tierces.

  • Import : faites entrer rapidement de gros volumes de données (nouveaux prix, listes de fournisseurs, fiches produits) en évitant la saisie manuelle fastidieuse.

  • Automatisation : combinez le CSV avec des scripts ou des macros pour créer des workflows entièrement automatisés (mise à jour de prix, synchronisation de stocks).

En maîtrisant ces flux CSV, une petite entreprise gagne en efficacité, en précision et en maîtrise de ses coûts — tout en restant totalement compatible avec les logiciels qu’elle utilise déjà.

Prêt à passer à l’action ?

  1. Exportez dès aujourd’hui votre première liste de contacts (Clients → Export CSV).

  2. Importez un petit fichier test de produits et observez le gain de temps.

  3. Planifiez une petite automatisation (ex. mise à jour de prix) en suivant l’exemple de script ci‑dessus.

Vous verrez rapidement combien le CSV, simple en apparence, peut transformer la gestion quotidienne de votre TPE avec Dolibarr. 🎯

Publications similaires