Import CSV

Pour importer vos produits ou les mettre à jour en masse par l'intermédiaire de fichiers CSV, utilisez le menu principal Catalogue > Import CSV.

Le fichier CSV exemple utilisé dans la démonstration est disponible en utilisant le menu Outils > Installation > Créer des fichiers CSV exemples pour l'importation de produits dans le catalogue

C'est un fichier au format texte, lisible par un éditeur de texte classique comme le bloc note mais il est préférable de lire ou modifier ce type de fichier dans MS Excel ou un autre tableur.

Ce type de fichier contient des données séparées généralement par des points virgules, c'est ce que l'on appelle le séparateur de champs.

Chaque champ peut être éventuellement entouré de double quotes.

Ainsi le contenu d'un fichier CSV ressemble à ceci :

"Nom du produit";"Quantité"

"Table en bois";5

"Chaise pliante";26

Chaque produit est renseigné sur une seule ligne obligatoirement, il n'est donc pas possible de stocker des descriptions dans un fichier CSV.

La première ligne de ce fichier est réservée à la liste des noms des colonnes. Store Commander a besoin de cette ligne dans tous vos fichiers CSV pour faire la relation avec les champs de la base de données.

Pour enregistrer un fichier CSV depuis Excel :

•	Depuis un PC, choisissez Enregistrer sous > CSV (séparateur: point-virgule)

•	Depuis un MAC, choisissez Enregistrer sous > CSV (Windows)

Ce type de fichier permet à différentes applications de se transmettre des informations dans un format simple. Vos fournisseurs peuvent vous faire gagner beaucoup de temps s'il peuvent vous fournir la liste de leurs produits.

Vous pourrez ainsi les intégrer à votre boutique très rapidement grâce à Store Commander mais aussi mettre à jour automatiquement vos stocks disponibles si vous fonctionnez en flux tendu ou en "drop shipping".

L'interface se compose de 3 parties :

•	Partie 1 : on sélectionne le fichier à importer

•	Partie 2 : on choisit les données à importer

•	Partie 3 : on suit le processus jusqu'à l'importation complète

Partie 1

Les fichiers CSV présents sur votre serveur sont listés dans cette partie ( ils sont dans votre répertoire /adminXXX/import ).

Barre d'outils :

•	Mettre à jour la liste des fichiers

•	Charger un nouveau fichier CSV sur le serveur

•	Supprimer les fichiers CSV marqués (cochés dans la première colonne de la grille)

Colonnes de la grille, les options du fichier :

•	Première colonne : permet de marquer les fichier à supprimer

•	Nom : nom du fichier CSV

•	Date : date du fichier CSV

•	Taille : taille du fichier CSV

•

Fournisseur : Store Commander permet de spécifier si le fichier CSV concerne un fournisseur en particulier : Si un produit est créé, ce fournisseur lui sera automatiquement affecté. Lors de l'analyse de votre fichier CSV, Store Commander ne va chercher que les produits de ce fournisseur dans la base de données pour vérifier la présence d'un produit similaire : si deux produits portent le même nom, seul celui correspondant au fournisseur mentionné sera modifié.

•	Mapping : permet de charger automatiquement un mapping préalablement sauvegardé (voir section Mapping de la Partie 2 ci-dessous)

•	Séparateur de champs : c'est le caractère qui sépare les colonnes de votre fichier, généralement un point virgule.

•

Séparateur de valeur : pour certains champs comme les catégories ou les tags, vous pouvez spécifier plusieurs valeurs : Table en bois;Meubles,Salon;5;19.6;8 (dans cet exemple Meubles et Salon sont deux catégories dans lesquelles ont retrouvera le produit). On utilise généralement une virgule mais pas toujours (le cas d'une catégorie portant une virgule en son nom peut poser problème si vous ne choisissez pas le bon séparateur).

•	Force UTF8 : convertit les données en UTF8. Pour faire simple, si après la création d'un produit dont le nom contient des accents, vous voyez des hiéroglyphes dans son nom, il faut modifier cette option et réimporter ce produit.

•

Produits identifiés par : Pour chacune des lignes de votre fichier CSV, Store Commander va rechercher des produits similaires dans la base de données (et exécuter l'action précisée dans l'option suivante). Indiquez ici sur quels champs doit s'effectuer cette recherche. Chaque produit doit avoir un identifiant unique (son nom, sa référence, ou autre...). Si jamais la base de données contenait 2 produits avec le même identifiant, seul le premier trouvé serait modifié.

•	Si un produit avec même identifiant est trouvé dans la base : Détermine l'action à faire si un tel cas se produit :

o	Ignorer : SC ne fait rien pour les produits trouvés en base de données, les produits non trouvés sont créés.

o	Créer un nouveau produit : SC crée un nouveau produit par ligne : les déclinaisons définies sur plusieurs lignes du fichier CSV ne sont pas prises en compte.

o	Remplacer les propriétés du produit : SC modifie le produit trouvé sans en créer de nouveau. Si le fichier CSV contient des colonnes concernant des déclinaisons, SC créera une nouvelle déclinaison pour ce produit.

Exemples de configuration :

Vous souhaitez importer de nouveaux produits de différents fournisseurs dont les références sont toujours différentes :

Fournisseur : vide

Mapping : vide

Produits identifiés par : référence

Si un produit est trouvé : ignorer

Résultat : si des références similaires sont trouvées, elles sont conservées dans le fichier de travail votreFichier.TODO.csv et vous pouvez les corriger avant de poursuivre l'importation.

Vous souhaitez mettre à jour les stocks disponibles des produits de votreFournisseur :

Fournisseur : votreFournisseur

Mapping : votreMapping (mapping préalablement enregistré lorsque vous avez importé les produits : inutile de ressaisir les liaisons entre le fichier CSV et la base de données)

Produits identifiés par : référence

Si un produit est trouvé : Remplacer les propriétés

Le mapping est automatiquement chargé, vous pouvez désélectionner les champs autres que "référence" et "quantité" pour ne modifier que ces valeurs (pensez à enregistrer ce mapping pour la prochaine utilisation).

Résultat : Les stocks de ce fournisseur seront mis à jour.

Partie 2

L'ensemble des relations entre tous les champs du fichier CSV et de la base de données est ce que l'on appelle Mapping.

Lorsqu'un fichier CSV est sélectionné dans la partie 1, Store Commander analyse ce fichier et affiche la liste de ses colonnes.

Il faut ensuite pour chacune d'elle trouver le champ correspondant dans la base de données.

Si vous utilisez le fichier CSV exemple fourni, Store Commander vous facilite encore plus la tache en détectant automatiquement ces relations.

Barre d'outils : Charger, enregistrer, supprimer un mapping. Note : Techniquement, le mapping est enregistré dans un fichier XML à côté du fichier CSV.

Colonnes de la grille, les relations entre le fichier et la base de données :

Utilisé : ce champ doit être ou non pris en compte lors de l'importation

Champ du fichier : le nom de la colonne dans le fichier CSV

Champ de la base de données : le nom du champ à associer dans la base de données

Options : Lorsqu'un champ requiert la saisie d'une option, la cellule de la grille est coloriée en bleu foncé. Les options peuvent être par exemple les langues pour les champs nom, meta_title...

Particularité de certains champs :

•	Nom : ce champ est obligatoire pour vos créations de produit

•	Catégorie par défaut : si elle est trouvé, le produit est placé à l'intérieur, sinon une nouvelle catégorie portant le nom du fichier de travail votreFichier.TODO.csv sera créée et vous devrez ventiler vos produits par des glisser/déposer dans Store Commander.

•	Catégories : vous pouvez préciser plusieurs catégories dans lequel le produit sera présent en utilisant le séparateur de valeur (défini dans la Partie 1)

•	Prix TTC : si vous utilisez ce champ, vous devez aussi utiliser le champ TVA pour que Store Commander puisse calculer le prix HT

•	Soldé : indique si le produit est en solde ou non, valeurs : 0 ou 1

•	Disponibilité si hors stock : 0 => Refuser les commandes ; 1 => Accepter les commandes ; 2 => Utiliser les préférences de la boutique

•	Réduction depuis/jusqu'au : Store Commander convertit automatiquement tous les formats de date ("aaaa/mm/jj","jj-mm-aaaa",...)

•	link_rewrite : si ce champ n'est pas précisé, il serait automatiquement créé avec le nom du produit

•	Tags : vous pouvez préciser plusieurs tags séparés par le séparateur de valeur (défini dans la Partie 1)

•

ImageURL : deux possibilités : soit vous indiquez une url complète vers une image "http://www.pshopexpert.com/monImage.jpg", soit vous placez les images sur votre serveur dans le dossier "/adminXXX/import/images/" et vous indiquez le chemin à partir de celui ci, par exemple si le champ est égal à "maison/maison01.jpg", Store Commander ira chercher le fichier à cet emplacement : /adminXXX/import/images/maison/maison01.jpg". Chacune des images est redimensionnée plusieurs fois, c'est pourquoi l'importation avec des images prend beaucoup de temps. Il est conseillé de procéder en 2 étapes : d'abord l'importation des produits sans leurs images puis réutiliser le fichier CSV pour importer les images en abaissant le nombre de lignes à importer par lot afin de ne pas saturer le serveur.

Partie 3

Barre d'outils :

•

Créer les catégories non trouvées : Si les catégories indiquées dans le fichier CSV n'existent pas dans la base de données, vous pouvez les créer automatiquement en cochant cette option. Par défaut (option non cochée) les produits sont placés dans une nouvelle catégorie cachée portant le nom du fichier CSV importé. La création détecte les chemins : si " Homme > Chemises " est indiquée pour une catégorie par défaut, Store Commander testera et créera si besoin les catégories " Homme " et " Chemises " puis placera le produit à l'intérieur.

•	Lignes à importer : Si vous souhaitez traiter votre fichier par lots, modifiez cette valeur. Lorsque vous importez des images, le processus est beaucoup plus long : il vaut mieux baisser cette limite pour laisser le temps au serveur de traiter toutes les informations.

•	Importer : bouton magique qui lance la procédure !

Résultat de l'importation

Il faut savoir qu'une importation ne se passe généralement pas bien du premier coup : pas de panique !

Tout d'abord, Store Commander crée une copie de travail de votre fichier appelée votreFichier.TODO.csv. A chaque fois qu'une ligne est bien importée, elle est supprimée de ce fichier. Il ne reste donc dans ce fichier que les produits qui posent problèmes ou restant à traiter et vous pouvez les modifier pour terminer l'importation sans devoir recommencer toute la procédure. Si vous ne souhaitez plus utiliser le fichier de travail TODO.csv et réutiliser votre fichier original, supprimez ce fichier de travail : il sera recréé à partir de votre fichier CSV.

Store Commander analyse ensuite les données de votre fichier et vous propose de créer rapidement certains éléments comme les fournisseurs, les fabricants, les caractéristiques, ... qui n'existent pas encore dans la base de données. Cela vous permet de continuer l'importation sereinement, il vous restera à compléter les informations de ces éléments plus tard.

Après chaque correction apportée, recliquez sur l'icone Importer de la barre d'outils pour avoir de nouvelles instructions jusqu'à ce que vous obteniez le message de fin d'importation.

Ce qu'il faut savoir : PrestaShop gère les prix des déclinaisons en enregistrant la différence entre le le prix de la déclinaison TTC et le prix de base TTC : Pour un prix de base de 10 € TTC et une déclinaison de 12 € TTC, la valeur 2 sera stockée dans la base de données. Il faut donc penser à renseigner la TVA sur le prix de base dès la création des déclinaisons pour que cette différence se calcule bien sur le prix TTC et non HT.

Les options de mapping permettent d'importer les éléments suivants :

•	attribut de déclinaison : la colonne du fichier CSV contient un attribut de la déclinaison à importer

•	attribut de déclinaison - valeurs multiples : la colonne du fichier CSV contient des attributs de la déclinaison à importer, séparés par le séparateur de champ sélectionné dans la Partie 1

Comment fonctionne l'importation et la création automatique des déclinaisons ?

Imaginons le fichier CSV exemple suivant :

1.	Nom produit;Couleur;Taille

2.	Chaussure en cuir;beige;42

3.	Chaussure en cuir;beige;44

4.	Chaussure haute en cuir;marron;42,44

5.	Chaussure haute en cuir;noire;42,44,46

Pour cet exemple, nous choisissons d'identifier les produits par leurs noms et le mapping suivant :

•	Nom produit : Champ Nom, FR

•	Couleur : Champ Attribut de déclinaison, Couleur

•	Taille : Champ Attribut de déclinaison - valeurs multiples, Taille

Lors de l'importation, Store Commander lit ligne par ligne le fichier :

Ligne 1 : Il s'agit de l'entête qui va servir à identifier les colonnes

Ligne 2 : Il s'agit d'un nouveau produit qui contient des colonnes correspondant à des déclinaisons : Store Commander crée le produit et la déclinaison correspondante.

Ligne 3 : Un produit portant le même nom a été trouvé dans la base de données et le mapping contient des attributs de déclinaison, Store Commander comprend alors qu'il s'agit de déclinaisons à rajouter au produit existant

Ligne 4 : Il s'agit d'un nouveau produit qui contient des colonnes correspondant à des déclinaisons : Store Commander crée le produit et toutes les déclinaisons correspondantes en "multipliant" les couleurs par les tailles. Nous aurons donc une déclinaison Marron,42 et une déclinaison Marron,44.

Ligne 5 : Un produit portant le même nom a été trouvé dans la base de données et le mapping contient des attributs de déclinaison, Store Commander comprend alors qu'il s'agit de déclinaisons à rajouter au produit existant et l'application recrée automatiquement les combinaisons.

Si vous avez des besoins spécifiques, nous pouvons créer des outils sur mesure.

N'hésitez pas à nous contacter pour booster votre traitement de données !

Page url: http://www.storecommander.com/doc/index.html?import_csv.htm