Base de connaissances
Guides
Académie
Tutoriels vidéo
Appuyez sur la touche échap pour quitter :
Articles consultés récemment :

Sommaire

Instructions de formatage pour le fichier CSV

Pour réussir à importer des fichiers CSV dans votre boutique, assurez-vous qu'ils répondent à certaines exigences de formatage décrites dans cet article.

Si vous exportez des produits à partir d'une boutique sur notre plateforme, un fichier CSV a déjà la mise en forme correcte.

Règles générales

Voici quelques directives générales pour compiler un fichier CSV :

  • Chaque fichier doit avoir un en-tête avec des noms de colonne. Consultez la liste des colonnes prises en charge
  • L'ordre des colonnes n'a pas d'importance tant que vous utilisez les bons noms de colonnes.
  • Ajoutez toutes les colonnes nécessaires pour importer vos données et n'hésitez pas à laisser de côté les autres.
    Par exemple, lors de la mise à jour des détails des produits existants, seules les colonnes auxquelles vous apportez des modifications ainsi que les colonnes identifier peuvent être utilisées.
  • Faites attention aux colonnes obligatoires. Elles dépendent du type de l'élément et de l'objectif de votre importation (création de nouveaux éléments ou mise à jour des éléments existants). Consultez la référence de colonne du fichier CSV pour obtenir plus d'informations.
  • Enregistrez vos fichiers CSV en UTF-8 (il s'agit de l'encodage recommandé).

En-tête

La partie la plus importante de votre fichier CSV est l'en-tête. Il s'agit de la première ligne qui contient tous les noms de colonnes. Ces noms de colonne indiquent quel type de données se trouve dans une colonne particulière.

Format_guidelines_for_the_CSV_file__3_.png

Vous ne pouvez pas importer de fichier s'il ne comprend pas d'en-tête.

Types de données

Chaque ligne du fichier (à l'exception de l'en-tête) est dédiée à un ensemble spécifique de données. Pour spécifier exactement les informations de la ligne, vous utilisez la colonne type :

Format_guidelines_for_the_CSV_file__2_.png

Sur la base du type, les lignes peuvent contenir des données sur :

  • un produit (type = "produit")
  • une option de produit ou un champ de saisie (type = "product_option")
  • une variante de produit (type = "product_variation")
  • un fichier produit (type = "product_file")
  • une catégorie de boutique (type = "category")
  • une redirection du site instantané (type = "site_redirect")
Si toutes les lignes de votre fichier correspondent à des produits (type = "produit"), vous pouvez omettre la colonne « type » au complet. Sauf indication contraire, toutes les lignes sont considérées comme des lignes "product".

Colonnes

Toutes les colonnes de votre fichier d'importation à l'exception de la colonne « type » sont dédiées à des informations spécifiques telles que le nom du produit, l'UGS, le prix, etc :

Format_guidelines_for_the_CSV_file__1_.png

Les informations peuvent se référer à un produit, une option de produit (ou un champ d'entrée), une variante de produit, un fichier de produit, une catégorie de boutique ou une redirection du site instantané, selon la ligne particulière.

Consultez la liste complète des colonnes prises en charge. Vous pouvez placer des colonnes dans l'ordre que vous voulez, mais assurez-vous de spécifier les noms de colonnes exactement comme indiqué dans la référence.

Identifiants

Pour faire correspondre les données d'une ligne particulière avec des produits ou des catégories spécifiques, vous utilisez des identifiants. Par exemple, lorsque vous devez indiquer à quel produit l'option appartient :

Format_guidelines_for_the_CSV_file__4_.png

  • Lors de la mise à jour des produits existants, spécifiez l'ID du produit ou l'UGS du produit unique.
  • Lorsque vous ajoutez des options, des champs de saisie, des variantes ou des fichiers, spécifiez une UGS ou un ID unique du produit auquel ils doivent être attribués.
  • Lors de la mise à jour des catégories existantes de la boutique, spécifiez l'ID de la catégorie ou le chemin de la catégorie complet.
  • Lors de la mise à jour ou de la suppression des redirections du site instantané, spécifiez l'ID de la redirection.

Consultez la liste des colonnes CSV prises en charge pour connaître les noms de colonnes.

Pour connaître les identifiants des produits ou des catégories, exportez votre catalogue et trouvez les colonnes « product_internal_id » et « category_internal_id » respectivement. Pour connaître les ID des redirections, exportez vos redirections (en anglais).
Si vous avez des UGS non uniques ou vides dans votre boutique, vous pouvez uniquement identifier les produits par leurs identifiants.

Ensemble d'exemples de fichiers CSV

Consultez notre ensemble d'exemples de fichiers CSV avec des exemples prêts à l'emploi pour différents cas d'utilisation de :

Vous pouvez utiliser ces fichiers comme un modèle et voir comment les lignes et les colonnes fonctionnent ensemble. Remplacez les exemples d'articles par vos produits ou catégories et ajoutez plus de colonnes de propriété si vous en avez besoin.

Vous pouvez en apprendre plus sur la compilation de fichiers pour des objectifs spécifiques à partir de nos études de cas détaillées (en anglais).
Cet article vous a-t-il été utile ?

Génial ! Merci pour vos commentaires !

Merci pour vos commentaires !

Nous sommes désolés ! Que s'est-il passé ?
Utilisateurs qui ont trouvé cela utile : 6 sur 11
10
Nous utilisons des cookies et des technologies similaires pour garder vos préférences en mémoire, mesurer l'efficacité de nos campagnes et analyser des données anonymisées afin d'améliorer les performances de notre site. En choisissant « Accepter », vous acceptez l'utilisation de cookies.
Accepter les cookies Refuser