CARONNA OdooL'intégrateur Odoo par IA

CARONNA Odoo / Blog / Projet et méthode

Projet et méthode

Comment réussir l'import de données Odoo sans casser sa base

Publié le 22 novembre 2026 · 6 min de lecture

Un import mal préparé laisse des doublons, des liens cassés et des chiffres faux dans votre base. Voici une méthode simple, étape par étape, pour importer vos contacts, produits ou commandes en gardant le contrôle, avec ou sans l'aide de l'IA.

Un import de données Odoo mal préparé laisse des doublons, des liens cassés et des chiffres faux dans votre base, et il est ensuite fastidieux de tout nettoyer. Bien préparé, il se déroule sans surprise. Cet article vous donne une méthode concrète, pensée pour les équipes qui ne sont pas développeuses.

Pourquoi un import de données Odoo tourne mal

Les problèmes viennent presque toujours des mêmes causes, et aucune n'est technique :

  • Des doublons : le même client importé deux fois, parce que le fichier a été relancé après une erreur.
  • Des liens introuvables : une ligne mentionne un commercial, un pays ou une catégorie que la base ne reconnaît pas, ou qu'elle reconnaît en plusieurs exemplaires.
  • Des formats mélangés : une date écrite « 03/04 » peut se lire en mars ou en avril, et un prix avec une virgule n'est pas lu comme un prix avec un point.
  • Des accents abîmés : un fichier enregistré avec le mauvais encodage (la façon dont les caractères sont codés) transforme « é » en symboles étranges.
  • Des effets de bord : selon votre configuration, des actions automatisées ou des notifications peuvent se déclencher sur les enregistrements créés.

La bonne nouvelle : ces risques se contrôlent avant l'import, pas après.

Avant de toucher à la base : sauvegarde et copie de test

Premier réflexe : ne jamais tester un import sur votre base de production, c'est-à-dire celle que vos équipes utilisent au quotidien. L'écran d'import standard d'Odoo ne propose pas de retour arrière en un clic. Une fois les lignes créées, il faut les supprimer ou les corriger à la main.

Voici ce que nous vous conseillons :

  1. Faire une sauvegarde de la base. La procédure dépend de votre hébergement (Odoo Online, Odoo.sh ou installation sur votre propre serveur). Vérifiez dans votre gestionnaire de bases ou auprès de votre hébergeur.
  2. Créer une copie de test si votre hébergement le permet. Vous y rejouez l'import complet, en toute tranquillité.
  3. Prévenir les utilisateurs si l'import touche des données sensibles, comme des produits en vente ou des contacts commerciaux.

Si vous ne pouvez pas dupliquer la base, importez au minimum un petit échantillon, puis contrôlez le résultat avant de continuer.

Préparer le fichier : colonnes, identifiants et formats

Odoo accepte en général les fichiers CSV (un tableau en texte brut) et les fichiers Excel. La première ligne contient les noms de colonnes. Passez ensuite un peu de temps sur le nettoyage, c'est là que se joue l'essentiel de la réussite.

Donner un identifiant unique à chaque ligne

C'est le conseil le plus utile de cet article. Ajoutez une colonne « Identifiant externe » (« External ID » dans l'interface en anglais). Il s'agit d'un code que vous choisissez, par exemple CLI-0001, CLI-0002, etc. Chaque ligne doit avoir le sien.

L'intérêt est double :

  • Si vous réimportez le fichier corrigé, Odoo met à jour les enregistrements existants au lieu d'en créer de nouveaux. Fini les doublons.
  • Vous pouvez ensuite référencer ces codes depuis un autre fichier, par exemple pour rattacher des commandes à des clients.

Écrire les valeurs comme Odoo les attend

  • Champs liés (pays, commercial, étiquette, devise…) : écrivez le nom exactement tel qu'il apparaît dans Odoo, ou utilisez l'identifiant externe de l'élément lié.
  • Dates : choisissez un seul format dans tout le fichier et vérifiez qu'Odoo l'interprète correctement à l'étape de test.
  • Nombres : pas d'espace pour les milliers, un seul séparateur décimal.
  • Listes de choix (statut, type…) : reprenez les libellés visibles dans l'application.
  • Nettoyage : supprimez les lignes vides, les espaces en début et fin de cellule, et unifiez les majuscules.

Les noms de menus, de champs et de colonnes varient selon la version d'Odoo et la langue de votre interface. Vérifiez-les dans votre propre base avant de bâtir votre fichier.

Importer par étapes avec l'outil intégré d'Odoo

L'ordre compte. Importez d'abord les données dont les autres dépendent, puis celles qui s'y rattachent : les catégories et paramètres d'abord, puis les contacts, puis les produits, et seulement ensuite les documents qui les utilisent (devis, commandes, factures).

Pour l'import lui-même, le chemin habituel est le suivant :

  1. Ouvrez la liste de l'objet concerné (par exemple les contacts ou les produits).
  2. Cherchez la fonction d'import. Selon la version, c'est un bouton « Importer » ou une entrée du menu « Favoris », sous un nom proche de « Importer des enregistrements ».
  3. Chargez votre fichier. Odoo propose une correspondance entre vos colonnes et ses champs : relisez-la ligne par ligne.
  4. Cliquez sur le bouton de test (« Tester »). Odoo vérifie le fichier sans rien créer et signale les erreurs ligne par ligne.
  5. Corrigez le fichier, retestez, puis lancez l'import réel.
  6. Contrôlez le résultat dans la liste : nombre de lignes, quelques fiches ouvertes au hasard, filtres sur la date de création.

Commencez toujours par un échantillon d'une dizaine de lignes variées, y compris les cas bizarres (nom très long, champ vide, accent). Si l'échantillon passe, le fichier complet a de bonnes chances de passer aussi.

Les pièges qui reviennent le plus souvent

Les produits avec variantes. Une même référence peut décliner plusieurs tailles ou couleurs. La structure du fichier est plus délicate : vérifiez la documentation de votre version et testez sur peu de lignes.

Les stocks et la comptabilité. Importer des quantités en stock ou des écritures comptables n'est pas un simple ajout de lignes : cela a des conséquences sur la valorisation du stock et sur vos comptes. Pour ces données, appuyez-vous sur les outils prévus par Odoo (ajustements d'inventaire, reprise de soldes) et faites valider la démarche par votre comptable.

Les automatisations. Si vous avez des actions automatisées (envoyer un e-mail, créer une tâche à la création d'une fiche), vérifiez dans l'import test si elles se déclenchent. Vous éviterez, par exemple, d'envoyer un message à des centaines de contacts sans le vouloir. Désactivez-les temporairement si nécessaire.

Les fichiers modifiés en cours de route. Gardez la version d'origine intacte et travaillez sur une copie. Nommez vos versions (par exemple « contacts_v2_nettoye ») pour savoir ce qui a été importé.

Ce que l'IA de CARONNA change dans un import

CARONNA est un intégrateur Odoo par intelligence artificielle : vous branchez votre Odoo, vous décrivez votre besoin en français, et l'IA paramètre la base à votre place. Pour un import, voici concrètement ce qu'elle peut faire :

  • lire votre fichier et proposer la correspondance entre vos colonnes et les champs d'Odoo ;
  • repérer les doublons probables, les dates ambiguës et les valeurs qui n'existent pas dans la base ;
  • préparer les identifiants externes pour que vos réimports mettent à jour au lieu de dupliquer ;
  • jouer l'opération d'abord en mode test, puis en mode production une fois le résultat validé ;
  • demander votre accord explicite avant toute action irréversible ;
  • tenir un journal complet de ce qui a été fait, avec possibilité d'annuler.

Quand vos données viennent d'un ancien logiciel qui n'exporte pas proprement, l'IA peut aussi développer un connecteur : un petit programme en Python (un langage de programmation courant) hébergé sur PythonAnywhere, un service d'hébergement en ligne. Il va chercher les données à la source et les transmet à Odoo. Et si vous bloquez sur un écran, l'extension Chrome permet à l'IA de voir ce que vous voyez pour vous guider.

L'IA est incluse dans l'abonnement. Vous pouvez estimer ce que cela représente pour votre organisation dans la section « Ce que vous gagnez », ou voir un import en conditions réelles en demandant une démonstration.

Votre checklist à appliquer dès aujourd'hui

Sans attendre, vous pouvez déjà faire ceci :

  1. Sauvegardez votre base, ou vérifiez qu'une sauvegarde récente existe.
  2. Ouvrez votre fichier et supprimez les lignes vides et les espaces superflus.
  3. Ajoutez une colonne d'identifiant externe avec un code unique par ligne.
  4. Unifiez les formats de dates et de nombres.
  5. Extrayez un échantillon d'une dizaine de lignes et testez-le avec le bouton de test d'Odoo.
  6. Contrôlez le résultat dans Odoo avant de lancer le fichier complet.

Si vous préférez déléguer la préparation, le test et le suivi, vous pouvez ouvrir l'application CARONNA, connecter votre Odoo et décrire votre import en quelques phrases. Vous gardez la main : rien d'irréversible ne se fait sans votre accord, et le journal vous permet de revenir en arrière.

Votre intégrateur Odoo, disponible tout de suite

Branchez votre Odoo et décrivez votre besoin en français : l'IA paramètre, connecte et vérifie, avec votre accord pour chaque action sensible. IA incluse, dès 149 € par mois.

À lire ensuite