Que faire face à une erreur import client CSV et encodage sur ElgeaWeb ?

Vous lancez un import client sur ElgeaWeb et l’opération échoue : accents transformés en caractères illisibles, import partiel ou message « format de fichier incorrect ». Cela bloque votre onboarding et risque d’introduire des doublons ou des données manquantes. Ce guide pas à pas vous permet de diagnostiquer, corriger et valider un CSV pour réussir l’import sur ElgeaWeb en moins de 15 minutes, avec une checklist et des scripts prêts à l’emploi.

comment diagnostiquer l’erreur (vérifications rapides)

Faites ces 6 vérifications rapides pour identifier la cause la plus probable :

• ✅ Taille du fichier : trop grand ? diviser en lots.
• ✅ Présence d’en-tête : première ligne correspond‑elle aux champs attendus ?
• ✅ Nombre de colonnes : cohérent sur les premières lignes (head -n 10).
• ✅ Séparateur : virgule ou point‑virgule ? les champs contiennent-ils des virgules ?
• ✅ Caractères bizarres / accents : voir si les accents sont corrompus.
• ✅ Test d’ouverture dans un éditeur (Notepad++ / LibreOffice) pour vérifier l’encodage affiché.

Exemples de messages d’erreur courants rencontrés sur d’autres plateformes : « fichier non encodé en UTF‑8 », « nombre de colonnes incorrect », « identifiant client manquant ». Les documentations d’import d’utilisateurs insistent souvent sur l’UTF‑8 comme encodage requis (ex. aides techniques type Webex ou Zendesk).

vérification d’encodage (outils simples)

• Sur Windows (Notepad++) : ouvrir le fichier → menu Encodage → voir l’encodage détecté. Si « UTF‑8 BOM » ou « ANSI », convertir en UTF‑8 without BOM.
• Sur mac/linux : utiliser la commande suivante pour obtenir l’encodage détecté :

« `bash file -i monfichier.csv « `

• Avec Python (chardet) : script court pour détecter l’encodage.
• Avec csvkit / pandas : tenter un read_csv pour voir si des erreurs d’analyse apparaissent.

actions correctives selon le cas

cas A — fichier non encodé en utf‑8

Solution terminal (linux/mac) : « `bash iconv -f WINDOWS-1252 -t UTF-8 input.csv -o output.csv « ` Si vous ne connaissez pas l’encodage source, testez chardet ou essayez plusieurs encodages usuels (WINDOWS-1252, ISO-8859-1).

PowerShell (Windows) : « `powershell Get-Content input.csv | Out-File -FilePath output.csv -Encoding utf8 « `

Notepad++ : Encodage → Convertir en UTF‑8 sans BOM → Enregistrer.

Excel (Windows) : Fichier → Enregistrer sous → choisir « CSV UTF‑8 (délimité par des virgules) ». LibreOffice : Fichier → Enregistrer sous → choisir encodage UTF‑8.

Astuce sur le BOM : certains systèmes refusent le BOM. Pour le vérifier / supprimer : « `bash # afficher les 3 premiers octets head -c 3 input.csv | od -An -t x1 # supprimer BOM (si présent) tail -c +4 input.csv > output_no_bom.csv « `

cas B — séparateur incorrect (virgule vs point‑virgule)

Identifier : ouvrez le fichier ; si les champs semblent fusionnés ou des guillemets apparaissent, le séparateur est mal reconnu.

Corriger :

• Remplacer le séparateur via éditeur ou script sed :

« `bash # remplacer ; par , si sûr que ; n’apparaît pas dans les champs sed ‘s/;/,/g’ input.csv > output.csv « `

• Dans Excel/LibreOffice : importer le CSV en précisant le séparateur puis réexporter en UTF‑8.

Vérifiez que ElgeaWeb attend bien un séparateur précis (virgule ou point‑virgule) ; à défaut, testez un petit fichier.

cas C — en‑têtes ou mapping incorrects

En‑têtes recommandées pour import client : id_client, nom, prénom, email, telephone

• Normaliser : retirer accents, espaces invisibles, majuscules inconsistantes.
• Vérifier colonnes obligatoires (id_client ou email) et l’unicité.
• Utilitaires : csvcut pour lister colonnes, csvsql pour valider schéma.

Exemple rapide pour afficher les 10 premières lignes et colonnes : « `bash head -n 10 input.csv csvcut -n input.csv « `

procédure de test avant import (checklist pré‑import)

• ✅ Faire une sauvegarde du fichier original.
• ✅ Convertir en UTF‑8 sans BOM si nécessaire.
• ✅ Vérifier et normaliser les en‑têtes (id_client, nom, prénom, email, telephone).
• ✅ Vérifier le séparateur.
• ✅ Vérifier unicité des id_client et emails (outil csvkit ou script).
• ✅ Tester avec 10 à 50 lignes.
• ✅ Lancer un import test et vérifier les logs d’import.

scripts et outils utiles (kit prêt à l’emploi)

Snippet bash simple pour conversion et suppression de BOM : « `bash # conversion windows-1252 -> utf-8 et suppression BOM iconv -f WINDOWS-1252 -t UTF-8 input.csv -o tmp.csv && tail -c +4 tmp.csv > clients-utf8.csv « `

Snippet PowerShell pour Windows : « `powershell Get-Content input.csv | Out-File -FilePath clients-utf8.csv -Encoding utf8 « `

Outils recommandés : Notepad++, csvkit (csvclean, csvcut), chardet (python), Excel/LibreOffice pour vérification visuelle.

Tableau : exemple d’en‑têtes attendues

que faire si l’erreur persiste (escalade)

Préparez ces éléments avant de contacter le support ElgeaWeb :

• capture d’écran du message d’erreur;
• extrait des 10 premières lignes du CSV (head -n 10);
• résultat de file -i et du test chardet;
• version navigateur et taille du fichier;
• logs d’import si disponibles.

Procédure provisoire : importer en lots plus petits (10–100 lignes), corriger les lignes signalées et consolider.

bonnes pratiques pour éviter ces erreurs

• Standardiser exports en UTF‑8 dès la source.
• Intégrer un contrôle automatique (chardet) dans votre pipeline d’export.
• Normaliser et documenter les en‑têtes.
• Automatiser tests d’import sur un environnement sandbox.
• Fournir un modèle CSV (clients-exemple.csv) encodé en UTF‑8 aux équipes qui préparent les fichiers.

FAQ