Importer des produits depuis un fichier CSV

Avec la version complète, vous pouvez charger de nombreux produits en une fois depuis un fichier CSV (un tableur enregistré en texte brut, avec des valeurs séparées par des virgules, des points-virgules ou des tabulations) dans Product Viewer > Import. Les produits sont reconnus par leur code : recharger le même fichier les met à jour au lieu de créer des doublons.

Avant de commencer

1. Créez d’abord vos filtres (Créer des filtres et des entrées). L’import reconnaît une colonne par filtre.
2. Ouvrez Product Viewer > Import. Le cadre How the file has to look montre la première ligne exacte dont votre fichier a besoin, par exemple : sku,title,excerpt,image,range,function,capacity. Copiez-la comme première ligne de votre tableur.

Les colonnes

Colonne	Contenu
sku	Le code produit. Il décide si une ligne crée un nouveau produit ou met à jour le produit existant qui a le même code.
title	Le nom du produit. Les nouveaux produits sans nom prennent le code comme nom. Les produits existants gardent leur nom si la colonne est absente ou la cellule vide.
excerpt	La description courte affichée sur la fiche. Retirez la colonne du fichier pour conserver les descriptions courtes existantes.
content	Facultatif : la description complète, affichée sur la page de détail du produit.
image	L’adresse web complète de la photo (commençant par https://). Utilisée seulement si vous cochez l’option des images lors de l’import.
une colonne par filtre	Le nom de la colonne est le nom interne du filtre, tel qu’affiché dans l’écran Import (le nom du filtre en minuscules, avec des tirets bas à la place des espaces). Pour un filtre en liste, écrivez le nom de l’entrée ; plusieurs entrées dans une même cellule sont séparées par une barre verticale, par exemple Restaurants|Hotels. Pour un filtre numérique, écrivez uniquement le nombre, par exemple 600.

Le fichier doit contenir au moins la colonne sku ou la colonne title. Les noms de colonnes ne tiennent pas compte des majuscules. Les lignes entièrement vides sont ignorées.

• Les entrées de filtre qui n’existent pas encore sont créées automatiquement.
• Pour un filtre en liste, la cellule remplace les entrées du produit pour ce filtre. Pour un filtre numérique, une cellule vide supprime la valeur.
• Seules les colonnes présentes dans le fichier sont écrites. Une colonne absente (un filtre, excerpt, content, title) n’est pas touchée sur les produits existants : un fichier avec seulement sku et une colonne de filtre met à jour ce filtre et rien d’autre.
• Une cellule vide dans une colonne présente vide ce champ sur le produit (sauf pour le nom : une cellule title vide conserve le nom actuel).
• Pour un filtre numérique, vous pouvez écrire les décimales avec une virgule ou un point, par exemple 600,5 ou 600.5.

Un fichier d’exemple, sample-catalog.csv, est fourni dans le zip de l’extension, dans le dossier examples.

Enregistrer le fichier depuis Excel ou Google Sheets

• Google Sheets : Fichier > Télécharger > Valeurs séparées par des virgules (.csv).
• Excel : Fichier > Enregistrer sous et choisissez CSV UTF-8 (délimité par des virgules). L’option CSV simple fonctionne aussi.

Lancer l’import

1. Dans Upload the file, cliquez sur le champ de fichier et choisissez votre CSV.
2. Laissez Dry run first (essai à blanc d’abord) coché la première fois.
3. Cochez Download the images (télécharger les images) si votre fichier contient des adresses d’images. Les photos sont copiées dans votre médiathèque.
4. Cliquez sur Import.
5. Lisez le résultat. Un essai à blanc répond Dry run finished, nothing was written. To create: X, to update: Y, skipped: Z. : les chiffres indiquent ce qui se passerait (à créer, à mettre à jour, ignorés). Un import réel répond Import finished. Created: X, updated: Y, skipped: Z.
6. Si les chiffres vous semblent corrects, décochez l’essai à blanc et cliquez à nouveau sur Import.

Tenir le tarif à jour

Modifiez votre tableur et importez-le à nouveau. Les produits qui ont le même code sont mis à jour, les nouveaux codes sont créés, et rien n’est dupliqué. Les produits absents du fichier restent tels quels (ils ne sont pas supprimés), et les produits mis à jour gardent leur statut de publication.