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.
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.
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 :
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")
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 :
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 :
- 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.
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 :
- Ajouter un nouveau produit →
- Ajouter un nouveau produit avec des options →
- Ajouter un nouveau produit avec des options et des variantes →
- Ajouter un nouveau produit avec des fichiers →
- Ajouter de nouvelles catégories de la boutique →
- Ajouter des attributs aux produits existants →
- Ajouter des traductions à un produit existant →
- Activer le suivi des stocks pour un produit existant →
- Mettre à jour le stock pour un produit existant →
- Créer une redirection de site instantané →
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.