> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://docs.organilog.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Diagnostiquer et corriger un problème lors d’un import CSV

Un import CSV peut échouer, produire des données incorrectes ou donner un résultat différent de celui attendu lorsque le fichier ou les paramètres de lecture ne correspondent pas aux données à importer.
Avant de relancer un import, il est important d’identifier l’origine du problème. Un import peut avoir créé tout ou partie des données même si son exécution semble avoir rencontré une difficulté.
## Avant de relancer un import
|| Attention : un import n’est pas réversible.
Si un import semble avoir échoué ou être resté bloqué, commencer par vérifier dans Organilog si des données ont malgré tout été créées ou modifiées.
Relancer immédiatement le même fichier peut entraîner la création de doublons.
Pour effectuer des essais dans de bonnes conditions :
* conserver une copie du fichier CSV d’origine ;
* créer un petit fichier de test contenant environ 3 à 10 lignes représentatives ;
* inclure si possible des données avec des accents, des dates et les différents cas présents dans le fichier complet ;
* vérifier le résultat dans Organilog avant d’importer l’ensemble des données.
Pour un fichier particulièrement volumineux, il peut être préférable de réaliser plusieurs imports plus petits. La quantité de données pouvant être traitée dépend notamment du nombre de lignes, du nombre de colonnes et de la quantité d’informations contenue dans chaque ligne.
## Vérifier que le fichier est correctement lu
Lors de l’import, Organilog affiche un aperçu du fichier. Cet aperçu constitue le premier élément à contrôler avant de poursuivre.
### Toutes les informations apparaissent dans une seule colonne
Le **séparateur** sélectionné ne correspond probablement pas à celui utilisé dans le fichier.
Selon la manière dont le CSV a été généré, le séparateur peut notamment être :
* un point-virgule ;
* une virgule ;
* une tabulation.
Modifier le séparateur et contrôler l’aperçu jusqu’à obtenir une séparation correcte des colonnes.
### Les accents ou caractères spéciaux sont incorrects
Des valeurs telles que `Fran�ois`, des points d’interrogation ou d’autres caractères inhabituels à la place des accents indiquent généralement un problème d’**encodage**.
Modifier l’encodage proposé lors de l’import et observer immédiatement le résultat dans l’aperçu.
L’encodage **UTF-8** est fréquemment utilisé, mais le bon choix dépend du fichier d’origine.
Ne pas poursuivre l’import tant que les noms, adresses, libellés ou autres textes ne s’affichent pas correctement.
### Les titres des colonnes sont importés comme des données
Lorsque la première ligne du CSV contient des intitulés tels que `Nom`, `Adresse`, `Téléphone` ou `Email`, celle-ci ne doit pas être traitée comme une fiche à importer.
Activer l’option permettant d’ignorer la première ligne du fichier.
### Les dates ou les heures sont incorrectes
Vérifier le **format des dates et des heures** sélectionné lors de la lecture du CSV.
Le format configuré dans Organilog doit correspondre au format réellement présent dans le fichier.
Par exemple, une date enregistrée sous la forme `2026-09-12` ne doit pas être interprétée comme une date utilisant un autre ordre pour le jour, le mois et l’année.
Contrôler plusieurs lignes dans l’aperçu avant de poursuivre.
## Vérifier la correspondance des colonnes
L’étape de correspondance permet d’indiquer à Organilog la destination de chaque colonne du CSV.
Vérifier notamment que :
* chaque colonne utile est associée au bon champ Organilog ;
* deux informations différentes ne sont pas associées par erreur au même champ ;
* les colonnes inutiles ne sont pas importées ;
* les données obligatoires pour le type d’import concerné sont présentes.
Il n’est pas nécessaire d’importer toutes les colonnes du fichier.
Pour identifier un problème, il peut également être utile de recommencer avec un fichier ne contenant que quelques colonnes indispensables, puis d’ajouter progressivement les autres informations.
## Vérifier les liaisons avec les données déjà présentes dans Organilog
Certains imports doivent rattacher les nouvelles données à des éléments qui existent déjà dans Organilog.
Dans ce cas, le libellé ou l'adresse visible ne suffit pas toujours à établir la liaison. Un **numéro Organilog** peut être nécessaire.
Par exemple :
* un devis importé peut devoir être rattaché au numéro Organilog du client et de son adresse ;
* une adresse supplémentaire peut être rattachée au numéro Organilog du client ;
* un équipement importé peut nécessiter le numéro Organilog du client auquel il appartient.
Lorsque des données importées ne sont pas rattachées au bon client ou à la bonne adresse, vérifier en priorité les colonnes servant à effectuer ces associations.
## Éviter les doublons lors d’une mise à jour
Un import classique ajoute des données.
Il ne faut donc pas réimporter simplement un fichier contenant des clients ou produits déjà présents en espérant que leurs fiches soient automatiquement modifiées. Cela peut créer de nouvelles fiches en doublon.
Lorsque le type d’import concerné propose l’option **Mettre à jour les données existantes**, utiliser cette fonctionnalité pour modifier des éléments déjà présents.
Une **clé de mise à jour** permet alors à Organilog d’identifier la fiche concernée.
Lorsque le numéro Organilog est disponible, il constitue généralement une clé particulièrement fiable puisqu’il identifie précisément la fiche existante.
Une seule clé de mise à jour doit être sélectionnée.
Les autres colonnes correspondent aux informations à modifier.
**Conseil :** pour modifier uniquement une information, conserver dans le fichier la clé nécessaire à l’identification de la fiche et les seules colonnes réellement à mettre à jour. Cela facilite le contrôle de l’import et limite le risque de modifier d'autres données involontairement.
Lorsque le même fichier contient à la fois des éléments existants à modifier et de nouveaux éléments à créer, séparer si nécessaire l'opération en deux imports permet de mieux maîtriser le résultat.
## L’import semble bloqué ou ne se termine pas correctement
Un fichier contenant un grand nombre de lignes ou beaucoup d’informations peut être plus difficile à traiter.
Avant toute nouvelle tentative :
1. Vérifier si les données sont déjà apparues dans Organilog.
2. Ne pas relancer immédiatement le fichier complet.
3. Tester le même import avec quelques lignes.
4. Si ce test fonctionne, importer les données en plusieurs lots plus petits.
Il n’existe pas nécessairement un nombre de lignes identique à respecter pour tous les imports : un fichier comportant peu de colonnes peut être beaucoup plus léger qu’un fichier contenant de nombreuses informations par ligne.
## Certaines lignes fonctionnent mais d’autres ne sont pas importées
Créer un fichier de test contenant uniquement quelques lignes, dont au moins une ligne qui pose problème.
Comparer ensuite les valeurs avec une ligne correctement importée :
* données obligatoires manquantes ;
* format de date différent ;
* caractère inhabituel ;
* identifiant Organilog incorrect ;
* valeur ne correspondant pas au type de champ attendu ;
* structure différente des autres lignes.
Si nécessaire, réduire progressivement le fichier jusqu’à identifier la ligne ou la colonne à l’origine du problème.
Cette méthode permet souvent d’isoler une donnée incorrecte beaucoup plus rapidement qu’en recommençant l’import complet.
## Des doublons ont déjà été créés
Ne pas poursuivre les imports tant que leur origine n’a pas été identifiée.
Vérifier notamment :
* si le fichier a été importé plusieurs fois ;
* si un import classique a été utilisé à la place d’un import de mise à jour ;
* si la clé de mise à jour sélectionnée correspond réellement aux fiches existantes.
Selon le type de données concerné, l’outil de fusion des doublons peut permettre de regrouper certaines fiches.
Pour un volume important de doublons ou lorsqu’une suppression pourrait avoir des conséquences sur des données liées, il est préférable de ne pas effectuer de suppression massive avant d’avoir identifié précisément les éléments concernés.
## Contrôler le résultat après chaque import
Après un import, vérifier quelques fiches représentatives directement dans Organilog.
Contrôler notamment :
* les accents et caractères spéciaux ;
* les dates et heures ;
* les numéros de téléphone et emails ;
* les associations avec les clients et adresses ;
* les champs personnalisés ;
* les données numériques ;
* l’absence de doublons inattendus.
Pour un import important, vérifier également le nombre approximatif d’éléments créés ou modifiés avant de poursuivre avec un autre fichier.
## Préparer les informations nécessaires en cas de demande au support
Si le problème persiste, conserver les éléments permettant de reproduire et analyser l’import :
* le fichier CSV utilisé ;
* le type de données importé ;
* les paramètres de lecture sélectionnés ;
* une capture de l’aperçu avant l’import ;
* le message d’erreur exact, lorsqu’un message est affiché ;
* quelques exemples de lignes qui fonctionnent et de lignes qui échouent ;
* la date approximative de l’import concerné ;
* le résultat obtenu et le résultat attendu.
Ces informations permettent de distinguer plus rapidement un problème de structure du fichier, de paramétrage de l’import ou un comportement nécessitant une analyse complémentaire.
## Articles associés
* [Importer des données](https://docs.organilog.com/fr/article/importer-des-donnees-dans-organilog-amznnu/)
* [Importer des clients et leurs adresses](https://docs.organilog.com/fr/article/importer-des-clients-et-leurs-adresses-a1cafk/)
* [Importer des produits](https://docs.organilog.com/fr/article/importer-des-produits-et-services-18u8eh0/)
* [Mettre à jour des informations par import](https://docs.organilog.com/fr/article/mettre-a-jour-des-donnees-existantes-avec-un-import-neefz5/)
* [Fusionner les doublons](https://docs.organilog.com/fr/article/detecter-et-fusionner-les-doublons-158m5d/)