Dolibarr : importer des données depuis un fichier CSV

L’assistant d’import Dolibarr charge des enregistrements en masse depuis un fichier CSV ou Excel.

Prérequis

• Module Imports activé.
• Droit Importer dans les permissions utilisateur.
• Un fichier source en UTF-8, séparateur , ou ;.

1. Lancer l’assistant

Menu Outils → Imports → Nouvel import. Choisir le jeu de données cible, par exemple Tiers (sociétés).

2. Choisir le format

Sélectionner Csv ou Excel 2007. Téléverser le fichier. La première ligne doit contenir les en-têtes de colonnes.

3. Associer les colonnes

L’assistant affiche les colonnes source et les champs Dolibarr. Faire glisser chaque colonne vers le champ cible :

• nom → Nom du tiers.
• email → Adresse e-mail.
• code_postal → Code postal. Les champs obligatoires sont signalés par un astérisque.

4. Simuler l’import

Cliquer Simuler l'import. Dolibarr signale les lignes en erreur sans rien écrire. Corriger le CSV puis relancer.

5. Importer

Lancer Importer le fichier. Un compte rendu indique le nombre de lignes créées et ignorées.

Vérification

Ouvrir la liste cible (Tiers → Liste). Le nombre d’enregistrements correspond au compte rendu. Contrôler quelques fiches importées.

Dépannage

• Caractères accentués corrompus : fichier non encodé en UTF-8 ; réenregistrer en UTF-8 sans BOM.
• « Champ obligatoire manquant » : colonne non associée ; vérifier le mapping.
• Doublons créés : aucun champ clé d’unicité défini ; dédupliquer la source avant import.
• Séparateur mal interprété : choisir le bon séparateur dans Configuration → Imports ou ajuster le CSV.