Aller au contenu principal

Importation de fichier CSV

Si vous souhaitez envoyer des paquets à un grand nombre de destinataires, vous pouvez utiliser la fonction Importation de fichiers.


Créer un profil

Avant d'importer le fichier, vous devez créer un profil d'importation.

Menu d'importation CSV

  1. Allez dans ProfilsAdresses ou Expéditions → appuyez sur +
  2. Sélectionnez Type d'import → Adresses ou Expéditions
  3. Ajoutez un Nom du profil (p. ex. carnet d'adresses)
  4. Sélectionnez le Type de fichier d'importation → CSV

Créer un profil — formulaire

Les autres éléments restent tels quels par défaut.

Paramètres par défaut du profil

  1. Appuyez sur Continuer
  2. Appuyez sur Télécharger le fichier

Télécharger le fichier

  1. Appuyez sur Traiter le fichier
  2. Attribuez les noms des champs en fonction des noms d'en-tête de votre fichier CSV

Mappage des champs (1)

Mappage des champs (2)

remarque

Si vous avez un fichier CSV sans en-tête, votre liste déroulante se compose des positions 0, 1, 2, etc. La première colonne (A) de la feuille du fichier CSV correspond à la position 0.

Mappage des champs — sans en-tête

La colonne Fonction peut rester telle quelle.

Si nécessaire, vous pouvez ajouter une Transformation — créée et utilisée lorsqu'il faut modifier les données du fichier CSV pour l'importation. Par exemple, lorsque le nom du pays dans votre fichier est «Suisse», mais que notre système a besoin de l'avoir au format ISO 3166-1 alpha-2 («CH»).

Transformation

Une fois que tous les noms des champs obligatoires (et facultatifs) sont saisis, appuyez sur Enregistrer.


Télécharger le fichier CSV

Menu Importations de fichiers

  1. Allez dans Importations de fichiers
  2. Appuyez sur Importer un fichier à droite

Bouton Importer un fichier

  1. Choisissez le Profil (le nom que vous avez saisi à la 1re étape)
  2. Téléchargez le fichier CSV et appuyez sur Importer

Dialogue d'importation CSV

  1. Appuyez sur Rafraîchir

Après l'importation — rafraîchir

Les informations importées apparaîtront dans votre carnet d'adresses ou dans vos envois.


Exigences techniques pour le fichier CSV

Le système prend en charge les formats CSV flexibles avec détection automatique de l'en-tête et plusieurs options d'encodage et de délimiteur.

Encodage des caractères

Choisissez l'un des encodages supportés:

EncodageCas d'utilisationRemarques
UTF-8Recommandé pour tous les fichiersSupport universel, gère tous les caractères spéciaux
ISO-8859-1Langues d'Europe de l'OuestUmlauts allemands (ä, ö, ü), accents français
Windows-1251Caractères cyrilliquesUkrainien, bulgare
astuce

Enregistrez votre fichier CSV au format UTF-8 dans Excel: Fichier → Enregistrer sous → CSV UTF-8 (délimité par des virgules)

Délimiteurs de champ

DélimiteurSymboleExportation Excel (région)Quand l'utiliser
Point-virgule;Excel européen (DE/FR/IT)Recommandé pour les régions européennes
Virgule,Excel USA / Royaume-UniLes données ne contiennent pas de virgules
Tabulation\tExportation manuelleLes données contiennent beaucoup de caractères spéciaux
Barre verticale|Exportations de bases de donnéesIntégrations techniques
attention

Vos données ne doivent pas contenir le caractère qui sert de délimiteur, à moins qu'il ne soit correctement entouré d'apostrophes.


Format d'en-tête CSV

Les en-têtes doivent commencer par une lettre (A–Z, a–z) ou un tiret du bas (_).

Caractères autorisés dans les en-têtes (après le premier caractère):

CaractèreExemples
LettresA–Z, a–z
Chiffres0–9
Tiret du bas_
Trait d'union-
Point.
Espace
Parenthèses( )
Barre oblique/
Deux-points:
Esperluette&
Virgule,

Interdit en tant que premier caractère: Chiffres, symboles spéciaux ($, #, @, !, etc.)

Exemples d'en-tête valide:

Nom;Adresse1;CodePostal;Pays
DocStatus;DocDat.;No_de_commande;Poids.KG
Nom du client;Rue & numéro;Date/heure;Statut (actif)
nom_destinataire;adresse_destinataire;numéro-de-suivi

Exemples d'en-tête non valide:

123;456;789                  (commence par un chiffre)
$Montant;#ID;@E-mail (caractères spéciaux: $, #, @)
;Nom;Adresse (première colonne vide)

Détection automatique d'en-tête

Le système détecte automatiquement si la première ligne est un en-tête:

  • Caractéristiques de l'en-tête: contient au moins une lettre, pas purement numérique, correspond au motif de caractères autorisé
  • Caractéristiques des données: la deuxième ligne contient des numéros, des e-mails ou du texte sensiblement différent; différence de longueur > 3 caractères par rapport à l'en-tête
Première ligneDeuxième ligneRésultat de la détection
Nom;Adresse;PoidsJohn Doe;Main St 1;2,5En-tête détecté
Client;Commande;TotalACME Corp;12345;99,99En-tête détecté
123;456;789111;222;333Pas d'en-tête (tous numériques)
Actif;En attente;TerminéActif;Terminé;En attenteAmbigu (longueurs de texte similaires)

Paramètres de configuration CSV

ParamètreTypeDescriptionExemples de valeurs
columnDelimiterChaîneCaractères de séparation des champs; , \t |
decimalSeparatorChaîneSéparateur pour les nombres. (US) ou , (UE)
multiValueDelimiterChaîneSéparateur pour champs multi-valeurs| ; ,
containsHeaderBooléenSi la première ligne est l'en-têtevrai / faux

Exemples de séparateurs de décimales:

Format européen (virgule):

Nom;Poids;Prix
Produit A;2,5;19,99
Produit B;1,8;15,50

Format US (point):

Nom,Poids,Prix
Produit A,2.5,19.99
Produit B,1.8,15.50

Création de fichiers CSV à partir d'Excel

  1. Préparez vos données:

    • Première ligne = en-têtes
    • Pas de lignes vides en haut
    • Nombre de colonnes cohérent
  2. Enregistrer au format CSV:

    • Européen (point-virgule): Fichier → Enregistrer sous → CSV (délimité par un point-virgule) *.csv
    • UTF-8: Fichier → Enregistrer sous → CSV UTF-8 (délimité par des virgules) *.csv
    • US (virgule): Fichier → Enregistrer sous → CSV (délimité par des virgules) *.csv
  3. Vérifier l'encodage:

    • Ouvrez le fichier dans le Bloc-notes ou TextEdit
    • Vérifiez que les caractères spéciaux (ä, ö, ü, é) s'affichent correctement

Problèmes et solutions courants

Les caractères spéciaux ne s'affichent pas correctement

Problème: Müller se transforme en Müller

Solution: Enregistrer le fichier en encodage UTF-8. Dans Excel, utiliser le format «CSV UTF-8», pas le format CSV normal. Vérifier dans l'éditeur de texte que les caractères spéciaux ont l'air corrects.


Les nombres ne sont pas reconnus

Problème: 2,5 est traité comme du texte au lieu d'un nombre

Solution: Définissez le séparateur de décimales pour qu'il corresponde au format de votre fichier.

  • Europe: "decimalSeparator": ","
  • Etats-Unis/international: "decimalSeparator": "."

Problème de délimiteur

Problème: Toutes les données apparaissent dans la première colonne

Solution: Vérifiez le délimiteur défini dans votre fichier. Excel européen utilise ;, Excel américain utilise ,. Définir le bon columnDelimiter.


En-tête non détecté

Problème: Le système traite la ligne d'en-tête comme des données

Solution: Assurez-vous que les en-têtes commencent par des lettres et non des chiffres. Définissez explicitement "containsHeader": true. Vérifier que les lignes de données sont différentes des en-têtes.


Lignes vides ou colonnes en trop

Problème: L'importation échoue ou comporte des colonnes inattendues

Solution: Supprimez les lignes vides en haut du fichier. Assurez-vous que toutes les lignes ont le même nombre de colonnes. Supprimez les délimiteurs de fin de ligne.


Liste de contrôle avant importation

Avant d'importer, vérifier:

  • L'encodage du fichier est UTF-8 (ou adapté à votre langue)
  • Le délimiteur correspond à la configuration (point-virgule pour l'Europe, virgule pour les USA)
  • Les en-têtes commencent par des lettres (si vous utilisez des en-têtes)
  • Il n'y a pas de lignes vides en haut
  • Le nombre de colonnes est cohérent sur toutes les lignes
  • Le séparateur de décimales correspond à votre format numérique
  • Les caractères spéciaux (ä, ö, ü, é) s'affichent correctement dans l'éditeur de texte
  • Il n'y a pas d'espaces de délimiteurs à la fin
  • La taille du fichier est raisonnable (< 25 Mo recommandé)