---
title: "Importer ses contacts dans Odoo depuis un tableur sans créer de doublons"
url: "https://digitalcrafting.tech/veille/importer-contacts-odoo-tableur-sans-doublons/"
description: "Importer vos contacts dans Odoo depuis Excel ou CSV sans doublons : ID externe, sociétés puis personnes, test sur petit lot et ré-import pour mettre à jour."
published: "2026-11-16"
updated: "2026-11-16"
author: "François Legrand"
site: "DigitalCrafting"
rubrique: "Odoo"
---

# Importer ses contacts dans Odoo depuis un tableur sans créer de doublons

> Importer vos contacts dans Odoo depuis Excel ou CSV sans doublons : ID externe, sociétés puis personnes, test sur petit lot et ré-import pour mettre à jour.

En bref

- L’import de contacts passe par l’outil d’import standard d’Odoo, identique en Community et en Enterprise, sur Odoo Online, Odoo.sh ou votre serveur.
- La colonne **ID externe** est ce qui vous protège des doublons : un même fichier réimporté met à jour les fiches au lieu d’en créer de nouvelles.
- Importez d’abord les sociétés, puis les personnes rattachées à leur société par cet identifiant.
- Testez sur une vingtaine de lignes avec le bouton **Test** avant le fichier complet : un import ne s’annule pas.

## Le problème : un fichier de contacts, et deux fois plus de fiches qu’attendu

Vos contacts vivent aujourd’hui dans un tableur, un ancien logiciel de facturation ou un export de messagerie. Vous les importez dans Odoo, tout semble fonctionner… puis vous corrigez quelques lignes, relancez l’import, et chaque client existe désormais en double. Ou bien les personnes arrivent sans leur société, et les devis ne savent plus à qui s’adresser.

Ce n’est pas un défaut d’Odoo : l’outil d’import crée une nouvelle fiche pour chaque ligne qu’il ne sait pas rattacher à une fiche existante. La documentation officielle le dit clairement : seules les colonnes *ID externe* ou *ID de base de données* permettent de modifier un enregistrement déjà importé au lieu d’en créer un autre. Cet article vous montre comment préparer votre fichier pour que l’import soit propre dès le premier passage, et rejouable sans risque.

## Les prérequis

- Une base Odoo 18, 19 ou 20 (Community ou Enterprise) avec l’application **Contacts** installée, et les premiers réglages faits : société, pays, langue. Si ce n’est pas encore le cas, commencez par [les premiers réglages dans le bon ordre](https://digitalcrafting.tech/veille/premiers-reglages-odoo-societe-utilisateurs-taxes/).
- Un compte avec les droits suffisants pour créer des contacts ; le mode développeur est utile pour les options avancées.
- Votre fichier source au format .xlsx ou .csv, et un tableur pour le nettoyer (LibreOffice, Excel ou Google Sheets).
- Idéalement, une base de test (copie ou base de démonstration) pour le premier essai. Odoo prévient que les imports sont définitifs et ne peuvent pas être annulés.

## 1. Partir du modèle d’import plutôt que d’un fichier vierge

Dans Contacts, passez en vue liste, ouvrez le menu **Action** (icône d’engrenage) puis choisissez **Importer des enregistrements** (*Import records* dans l’interface anglaise). L’écran d’import propose un modèle prêt à l’emploi pour les clients : téléchargez-le. Ses colonnes sont déjà reconnues par Odoo, ce qui vous évite la plupart des erreurs de correspondance.

Vous pouvez ajouter, retirer ou réordonner des colonnes. La documentation recommande en revanche de ne jamais supprimer la colonne **ID externe**. Si vous avez besoin d’un champ absent du modèle, l’astuce la plus fiable consiste à exporter une fiche existante avec ce champ : vous obtenez ainsi le libellé exact attendu à l’import.

## 2. Donner un identifiant unique et stable à chaque ligne

L’ID externe est un texte libre, unique dans toute la base, qui identifie la ligne de façon permanente. Si votre ancien logiciel attribue déjà un numéro client, réutilisez-le : c’est exactement l’usage prévu par Odoo pour une reprise depuis une autre application. La documentation conseille de le préfixer par le nom de la table pour éviter les collisions, par exemple `societe_1` et `personne_1` plutôt que `1` pour les deux.

| Colonne | Rôle | Exemple |
| --- | --- | --- |
| ID externe | Identifiant stable de la ligne | societe_C0042 |
| Nom | Raison sociale ou nom de la personne | Atelier Durand |
| Est une société | Distingue société et personne | True / False |
| Société liée / ID externe | Rattache une personne à sa société | societe_C0042 |
| E-mail, Téléphone, Ville, Pays | Coordonnées | France |
| Étiquettes | Plusieurs valeurs séparées par une virgule, sans espace | Client,Revendeur |

Deux règles à retenir : deux lignes ne doivent jamais partager le même ID externe (Odoo signale un conflit), et cet identifiant ne doit plus changer une fois importé. C’est lui qui permettra les mises à jour.

## 3. Séparer les sociétés et les personnes

Dans Odoo, une personne est rattachée à une société par le champ *Société liée*. Pour que ce lien se crée à l’import, la société doit déjà exister. Préparez donc deux fichiers et importez-les dans cet ordre : d’abord les sociétés, ensuite les personnes.

```
# societes.csv
ID externe,Nom,Est une société,Ville,Pays
societe_C0042,Atelier Durand,True,Lyon,France
societe_C0051,Boulangerie du Marché,True,Annecy,France

# personnes.csv
ID externe,Nom,Est une société,Société liée/ID externe,E-mail
personne_P0107,Claire Durand,False,societe_C0042,claire@exemple.fr
personne_P0108,Marc Petit,False,societe_C0042,marc@exemple.fr
```

Les en-têtes reprennent les libellés d’une interface en français ; au moment du test, Odoo affiche la correspondance proposée pour chaque colonne et vous pouvez la corriger dans la liste déroulante si un en-tête n’est pas reconnu.

Pour les champs relationnels comme le pays, n’utilisez qu’un seul mécanisme par colonne : le nom (*France*), l’identifiant de base de données ou l’ID externe. Le nom suffit pour un fichier préparé à la main ; l’ID externe devient préférable dès que deux enregistrements portent le même nom.

## 4. Nettoyer le fichier avant de l’envoyer

- Dédoublonnez dans le tableur, en vous fondant sur l’e-mail ou le numéro de TVA : Odoo n’effectue pas ce contrôle à votre place pendant l’import.
- Pour un fichier CSV, vérifiez l’encodage et le séparateur. Les options de format n’apparaissent que pour les CSV, pas pour les fichiers .xlsx. Odoo ne détecte pas la tabulation comme séparateur.
- Écrivez les dates au format ISO 8601 (AAAA-MM-JJ) pour éviter les inversions jour/mois.
- Ne laissez pas de colonnes vides par accident : une cellule vide écrase la valeur par défaut, alors qu’une colonne absente laisse Odoo appliquer la valeur par défaut.

## 5. Tester sur un petit lot, puis importer

Chargez votre fichier, vérifiez que chaque colonne correspond au bon champ Odoo, puis cliquez sur **Test**. Odoo signale les erreurs ligne par ligne sans rien écrire. Commencez par une vingtaine de lignes représentatives : une société, ses contacts, un pays étranger, une étiquette nouvelle. Une fois le résultat contrôlé dans la liste des contacts, importez le reste.

Pour les gros volumes, découpez le fichier : Odoo indique qu’un import trop volumineux peut provoquer une erreur de délai dépassé et recommande de traiter les données par lots plus petits. En mode développeur, l’option avancée *Track history during import* envoie des notifications et ralentit l’import : laissez-la désactivée pour une reprise initiale.

Astuce

Après l’import, filtrez la liste des contacts sur la date de création ou de dernière modification : c’est la méthode suggérée par Odoo pour retrouver précisément les fiches touchées par un import, et les contrôler ou les archiver si besoin.

## 6. Mettre à jour sans recréer : le ré-import

Pour corriger des fiches en masse, exportez-les depuis la vue liste (**Action** puis **Exporter**) avec l’option d’export compatible avec l’import. Son libellé varie selon la version : case *I want to update data (import-compatible export)* jusqu’à Odoo 19, interrupteur *Updatable fields only* dans Odoo 20 (libellés de la documentation anglaise ; l’interface française les traduit). Dans les deux cas, l’ID externe est inclus automatiquement.

Modifiez le fichier, réimportez-le : Odoo met à jour chaque fiche dont il reconnaît l’ID externe et crée uniquement les lignes nouvelles. La documentation est explicite sur le risque : si un ID externe est modifié ou supprimé, Odoo peut créer un doublon au lieu de mettre à jour la fiche existante.

## Exemple : reprendre 600 contacts d’un ancien logiciel de facturation

Prenons une entreprise de services de huit personnes qui passe sur Odoo 19 Community, hébergé sur son serveur. Son ancien logiciel exporte 180 clients et 420 interlocuteurs, chacun avec un code client (C0042) ou un code contact (P0107). Hypothèse de travail : ces codes sont uniques et ne changeront pas.

1. Le responsable administratif ajoute une colonne *ID externe* en préfixant les codes : `societe_C0042`, `personne_P0107`.
2. Il dédoublonne les sociétés par numéro de TVA dans le tableur et en fusionne trois qui avaient deux codes.
3. Il importe les sociétés, contrôle 20 fiches, puis importe les 420 personnes en deux lots.
4. Un mois plus tard, il corrige les téléphones de 60 contacts dans un export compatible et le réimporte : 60 fiches mises à jour, aucune créée.

Si des doublons étaient déjà présents dans Odoo avant cette méthode, l’application Contacts permet de les fusionner depuis la vue liste (**Action** puis **Fusionner**, *Merge* en anglais). L’opération est irréversible : vérifiez chaque groupe avant de confirmer.

## Les erreurs fréquentes

- **Importer sans ID externe**, puis réimporter le fichier corrigé : chaque ligne est recréée.
- **Renuméroter les ID externes** entre deux imports, par exemple en retriant le tableur avant de « tirer » une numérotation : les liens sont perdus.
- **Importer les personnes avant les sociétés** : le champ Société liée ne trouve rien à rattacher.
- **Séparer les étiquettes par « , » avec une espace** : la documentation demande une virgule sans espace.
- **Importer le fichier complet sans test** sur une base de production : l’import ne peut pas être annulé.

Vous avez un fichier de contacts, un ancien logiciel ou un CRM à reprendre dans Odoo et vous voulez éviter de passer des semaines à nettoyer des doublons ? Je peux préparer avec vous les fichiers d’import, les tester sur une copie de votre base et automatiser les mises à jour récurrentes. Découvrez [mon accompagnement Odoo](https://digitalcrafting.tech/odoo/) ou [décrivez-moi votre reprise de données](https://digitalcrafting.tech/contact/).

## Questions fréquentes

### Faut-il Odoo Enterprise pour importer des contacts ?

Non. L’outil d’import décrit ici fait partie du socle d’Odoo et fonctionne de la même façon en Community et en Enterprise, que la base soit sur Odoo Online, Odoo.sh ou votre propre serveur.

### Excel ou CSV : quel format choisir ?

Les deux sont acceptés. Le .xlsx évite les soucis d’encodage et de séparateur ; le CSV donne accès aux options de format (séparateur, dates, séparateur de milliers), utiles quand le fichier vient d’un autre logiciel.

### Et si je dois synchroniser les contacts en continu avec un autre outil ?

L’import manuel convient à une reprise initiale ou à des mises à jour ponctuelles. Pour un échange régulier avec un autre logiciel, il vaut mieux passer par l’API externe d’Odoo, en conservant le même principe d’identifiant stable. Voyez [les différentes API externes d’Odoo](https://digitalcrafting.tech/veille/api-externe-odoo-xml-rpc-json-2/).

## Sources

- [Odoo 19.0 — Export and import data](https://www.odoo.com/documentation/19.0/applications/essentials/export_import_data.html) documentation officielle, version 19.0
- [Odoo 20.0 — Export and import data](https://www.odoo.com/documentation/20.0/applications/essentials/export_import_data.html) documentation officielle, version 20.0 (option « Updatable fields only »)
- [Odoo 19.0 — Merge contacts](https://www.odoo.com/documentation/19.0/applications/essentials/contacts/merge.html) documentation officielle, version 19.0

Documentation consultée le 16 novembre 2026.

## Pour aller plus loin

- [Démarrer avec Odoo : Community ou Enterprise, Online, Odoo.sh ou votre serveur ?](https://digitalcrafting.tech/veille/demarrer-odoo-community-enterprise-hebergement/)
- [Premiers réglages d’une base Odoo : société, utilisateurs, devises et taxes dans le bon ordre](https://digitalcrafting.tech/veille/premiers-reglages-odoo-societe-utilisateurs-taxes/)
- [API externe Odoo : XML-RPC, JSON-RPC et la nouvelle API JSON-2](https://digitalcrafting.tech/veille/api-externe-odoo-xml-rpc-json-2/)
