Comment importer/exporter les Produits du Panier

Bonnes pratiques > Étape 1 - Paramètres > Section Avancés > E-commerce >

Comment importer/exporter les Produits du Panier

Previous pageReturn to chapter overviewNext page

Après avoir créé un Panier e-commerce, il peut être utile d'être en mesure d'exporter le catalogue de Produits de sorte que, par exemple, vous pouvez l'entrer dans un autre Projet ou vous pouvez l'utiliser dans un autre logiciel, peut-être dédié à la gestion de la facturation. Dans le sens inverse, bien sûr, il est tout aussi important d'être en mesure d'importer la liste des Produits pour n'avoir pas à la recréer à partir de zéro.

Dans WebSite X5 vous pouvez accomplir ces tâches Importer / Exporter en utilisant les commandes appropriées dans la Barre d'Outils de la fenêtre E-commerce | Produits. L'exportation du catalogue des Produits génère un fichier. TXT ou .CSV qui peuvent être facilement ouverts et modifiés avec un éditeur de texte standard (par exemple, Bloc-notes Windows) ou Microsoft Excel.

Pour modifier manuellement le fichier obtenu de l'exportation du Catalogue des Produits ou pour en créer un nouveau à importer, il faut respecter les règles suivantes :

La première ligne doit contenir l'en-tête des champs et doit comporter les indications suivantes :

ID;Category;Name/Code;Description;Price;Enable VAT;VAT Value;Weight;Images;Options;Enable Discounts;Discounts

Si vous éliminez un champ de l'en-tête vous éliminez cette donnée pour tous les Produits. Naturellement, les champs obligatoires Category, Name/Code, Description et Price ne peuvent pas être supprimés de l'en-tête.
Chaque ligne, après l'en-tête, doit correspondre à un Produit;
Tous les paramètres doivent être séparés par le caractère ";".
Pour chaque Produit il faut indiquer obligatoirement: le nom de la Catégorie, le nom du Produit, la description du Produit, le prix du Produit. Tous les autres champs sont optionnels et peuvent être omis (simplement en n' insérant aucune description entre les caractère ";" pour le champ en question).
L'ID du Produit est créé par le Programme et non manuellement: si vous insérez un nouveau Produit il est normal de laisser vide le champ de l'ID.
Les espaces insérés, si ils ne sont pas nécessaires, seront automatiquement supprimés pendant l'importation.

Plus précisément, les paramètres dans le fichier .TXT ou .CSV sont :

Paramètre : ID

Obligatoire

Non

Description

C'est un identifiant unique pour le Produit.

Valeur

Il est automatiquement créé et associé au Produit par le programme.

Pour mettre à jour le fichier .TXT ou .CSV obtenu par exportation, il est déconseillé de modifier les ID déjà affectés et laisser le champ vide pour les éventuels nouveaux produits ajoutés. Si vous créez de zéro un fichier .TXT ou .CSV, pour importer le catalogue dans le panier, vous ne devez pas créer manuellement les ID des produits. En effet, en phase d'importation, le programme confronte les ID pour ne pas avoir de duplicatas et génère ceux qui manquent.

Paramètre : Category

Obligatoire

Oui

Description

C'est la Catégorie où est inséré le Produit.

Valeur

Vous pouvez reproduire le chemin de catégories et sous-catégories en utilisant le caractère ">".

Par exemple, si le produit est un T-shirt inséré dans le catalogue à la sous-catégorie "Casual" de la catégorie "Vêtements pour homme", dans le fichier .TXT ou .CSV vous pouvez indiquer le chemin comme suit :

... ; Vêtements pour homme > Casual ; ...

Avec ce type de remarque, vous pouvez insérer toutes les sous-catégorie nécessaires.

Paramètre : Name/Code

Obligatoire

Oui

Description

C'est le Nom ou le Code assigné au Produit.

Valeur

En cas d'exportation du catalogue dans .TXT ou .CSV, ce paramètre est repris par le champ Nom/Code de la fenêtre Paramètres de produit | Général.

Paramètre : Description

Obligatoire

Oui

Description

C'est la description associée au Produit.

Valeur

En cas d'exportation du catalogue dans .TXT ou .CSV, ce paramètre est repris par le champDescription de la fenêtre Paramètres de produit | Général.

Paramètre : Price

Obligatoire

Oui

Description

C'est le prix associé au Produit.

Valeur

En cas d'exportation du catalogue dans .TXT ou .CSV, ce paramètre est repris par le champ Prix de la fenêtre Paramètres de produit | Général.

Paramètre : Enable VAT

Obligatoire

Non

Description

Indique si l'application d'une TVA particulière a été prévue pour le produit.

Valeur

En cas d'exportation du catalogue dans .TXT ou .CSV, ce paramètre est repris par l'option TVA (%) de la fenêtre Paramètres de produit | Général. Cette option est disponible seulement si dans E-commerce | Disponibilité vous avez sélectionné l'option Type "TVA incluse dans le prix" pour les Paramètres TVA et elle permet d'associer au Produit une TVA particulière, différente de celle des autres Produits du catalogue. Dans ce cas, les prix sont indiqués hors taxe.

Ce paramètre peut prendre seulement deux valeurs : 0 ou 1, respectivement si vous avez ou n'avez pas sélectionné l'option TVA (%) indiquée ci-dessus.

Paramètre : VAT Value

Obligatoire

Non

Description

C'est la valeur de la TVA quand est prévue l'application d'une taxe particulière sur le prix du produit.

Valeur

En cas d'exportation du catalogue dans .TXT ou .CSV, ce paramètre est repris par l'option TVA (%) de la fenêtre Paramètres de produit | Général qui, tel que pour le paramètre précédent, est disponible seulement si dans E-commerce | Disponibilité vous avez sélectionné l'option Type "TVA incluse dans le prix" pour les Paramètres TVA.

Si l'option TVA (%) de la fenêtre Paramètres de produit | Général est sélectionnée mais qu'aucune valeur n'est spécifiée, le programme prend la Valeur par défaut (%) définie dans la section Paramètres de produit | Disponibilité.

Paramètre : Weight

Obligatoire

Non

Description

C'est le poids associé au produit.

Valeur

En cas d'exportation du catalogue dans .TXT ou .CSV, ce paramètre est repris par le champ Poids de la fenêtre Paramètres de produit | Général.

Paramètre : Images

Obligatoire

Non

Description

Il s’agit de la liste des images insérées pour le Produit.

Valuer

En cas d’exportation du catalogue en .TXT o .CSV, ce paramètre est repris par la fenêtre Paramètres de produit | Image. Pour chaque image, le parcours absolu original est repris.

En cas de création d’un fichier .TXT ou .CSV à importer, en revanche, la liste des images du Produit peut être introduite en utilisant le caractère « | » et en indiquant le parcours relatif ou absolu, comme suit :

... ; PathImage1 | PathImage2 | PathImage3 ; ...

Paramètre : Options

Obligatoire

Non

Description

C'est la liste des variantes pour le Produit.

Valeur

En cas d'exportation du catalogue dans .TXT ou .CSV, ce paramètre est repris par le champ Liste des Options Principales de la fenêtre Paramètres de produit | Options..

Si vous créez un fichier .TXT ou .CSV à importer, la liste des variantes de produit peut être introduite en utilisant le caractère "|", comme suit :

... ; Variante1 |Variante2| Variante3; ....

Avec ce type de remarque, vous pouvez insérer toutes les variantes nécessaires.

Paramètre : Enable Discounts

Obligatoire

Non

Description

Indique si une remise sur la quantité est prévue pour le produit.

Valeur

En cas d'exportation du catalogue dans .TXT ou .CSV, ce paramètre est repris par l'option Activer la remise sur quantité de la fenêtre Paramètres de produit | Remise.

Ce paramètre peut prendre seulement deux valeurs : 0 ou 1, respectivement si vous avez ou n'avez pas sélectionné l'option Activer la remise sur quantité indiquée ci-dessus.

Paramètre : Discounts

Obligatoire

Non

Description

C'est la liste des remises sur la quantité à appliquer au produit, si elles sont prévues.

Valeur

En cas d'exportation du catalogue dans .TXT ou .CSV, ce paramètre est repris, comme le précédent, par l'option Activer la remise sur quantité de la fenêtre Paramètres de produit | Remise.

Si vous créez un fichier .TXT ou .CSV à importer, la liste des remises sur la quantité à appliquer doit être composée en respectant la remarque suivante:

... ; quantité : remise| quantité : remise ; ...

Ainsi, si pour des commandes dépassant les 20 pièces, on a prévu une remise de 10% et pour les commandes de plus de 50 pièces, il y a une remise de 15%, il faut insérer les données en écrivant:

... ; 20: 10| 50: 15 ; ...

En utilisant le caractère "|", vous pouvez insérer toutes les remises sur la quantité nécessaires.

Après avoir importé un fichier .TXT ou .CSV obtenu à partir d'une exportation précédente ou créé manuellement, il est très probable qu'il soit mis à jour par le programme: par exemple, en insérant les ID des Produits qui manquent. Pour cette raison, si vous voulez avoir une copie à jour du fichier .TXT ou .CSV il est nécessaire de procéder à une neuvelle exportation du Catalogue Produits.

 


Bonnes pratiques :

-

Comment définir les contenus des e-mail de notification