Dolibarr : Importer rapidement et simplement
Importer des données en masse dans Dolibarr permet d’économiser du temps et d’éviter des erreurs. Voici comment faire, étape par étape.
Sommaire
Préparer votre fichier d'import
Etape 1 : Choisissez un lot prédéfini de données que vous désirez importer…
Dans Dolibarr :
Allez dans Outils > Assistant d’import
- Choisissez le type de données à importer (ex : Tiers, Produits…).
Etape 2 : Choisissez le format de fichier à importer …
Cliquez sur Télécharger un exemple de fichier.
Ce modèle vous montre les colonnes exactes attendues.
Seule les colonnes avec * sont obligatoire
L’ordre et le nombre de colonne n’est pas à respecter obligatoirement
Utilisez ce fichier comme base pour préparer vos données.
Paramètrer l'import
De plus, l’aspect open-source confère une transparence totale : les utilisateurs peuvent contrôler les fonctionnalités, adapter le logiciel, et intégrer de nouvelles fonctionnalités si nécessaire. La communauté Dolibarr, active et internationale, contribue constamment à l’amélioration de l’ERP en proposant des mises à jour, des correctifs, et des modules complémentaires.
Etape 3 : Choisissez le fichier à importer …
Etape 4 : Valider les colonnes à importer …
À cette étape, Dolibarr analyse votre fichier et extrait toutes les colonnes présentes.
Détection automatique : Dolibarr essaie d’associer chaque colonne à un champ connu (ex : « Nom du client », « Adresse », « Code produit »…).
Type de données : Si Dolibarr ne reconnaît pas automatiquement une colonne, vous devrez sélectionner manuellement à quoi elle correspond via un menu déroulant.
Désélectionner une colonne si vous ne souhaitez pas importer certaines colonnes de votre fichier :
Laissez simplement la sélection vide pour cette colonne.
Dolibarr ignorera les données correspondantes à l’import.
Cela permet de contrôler précisément quelles informations seront intégrées dans votre base.
Etape 5 : Synthèse des paramètres d'importer …
Avant de lancer l’import, Dolibarr vous demande :
Plage de lignes : vous pouvez choisir d’importer uniquement certaines lignes du fichier (par exemple de la ligne 2 à la ligne 100).
Clé(s) de mise à jour :
Vous pouvez définir une ou plusieurs colonnes comme clé (ex : le code produit, le nom du client).
Dolibarr va utiliser cette clé pour :Mettre à jour les données existantes si elles sont déjà présentes.
Éviter les doublons en créant seulement les nouvelles entrées.
C’est une étape essentielle pour garder une base de données propre.
Valider la simulation d’import
Simulation d'import Réussi
Dolibarr lance une simulation de l’import.
Il vous indique ce qu’il va faire : création de nouveaux enregistrements, mise à jour d’éléments existants, détection de doublons éventuels, etc.
Aucune donnée n’est encore modifiée à ce stade : c’est juste une prévisualisation.
Simulation d'import en Erreur
Dolibarr vous signale les erreurs détectées.
Pour chaque erreur, Dolibarr précise :
La ligne concernée.
La colonne concernée.
La raison de l’erreur (champ manquant, format incorrect, valeur non reconnue, etc.).
Soyez attentif aux messages affichés : ils vous aident à comprendre précisément ce qu’il faut corriger.
Que faire en cas d’erreur ?
Corriger votre fichier : modifiez les données directement dans votre fichier source, puis recommencez l’import à l’étape 2.
Ou ignorer certaines données : si certaines lignes ou colonnes ne vous intéressent pas, passez à l’étape 4 — désélection pour les exclure de l’import.
Important :
À ce stade, aucune donnée n’est encore enregistrée dans Dolibarr. C’est uniquement une prévisualisation sécurisée.
Importer
Dolibarr n’autorise l’import définitif que si toutes les erreurs détectées sont corrigées.
Tant qu’il reste une erreur dans votre fichier, l’import est bloqué.
Cela garantit que seules des données propres et cohérentes sont ajoutées dans votre base Dolibarr.
