Qu'est-ce que c'est un fichier de données (datafeed)?

Pour référencer vos produits sur ShopMania vous devez créer un fichier de données. Un fichier de données est un fichier aux format txt, CSV ou XML qui contient de informations détaillées sur vos produits, tels comme: le nom du produit, les prix, catégorie etc. Les champs du fichier texte sont séparés par le délimiteur pipe (|) et les lignes délimitées par une nouvelle ligne(\n).

Celuis-ci est le format standard pour un fichier de données txt et CSV:

catégorie avec le chemin complet | fabricant | numero de pièce | code produit marchand | nom du produit | description | URL du produit | URL de l'image | prix | devise | frais de port | disponibilité | GTIN (UPC/EAN/ISBN)

Les champs suivants sont obligatoires: Catégorie, MPC, Nom du produit, URL du produit, URL de l'image et Prix. GTIN est également obligatoire pour les livres; dans ce cas, vous devez ajouter le numéro ISBN. Il ne suffit pas d’ajouter ces champs dans le fichier de données, vous devez également vous assurer que les champs obligatoires comprennent également les informations correctes. Sinon, le flux ne peut pas être considéré comme valide.Toutefois, pour obtenir une liste de produit correcte, nous vous recommandons fortement d’ajouter des informations pour tous les champs déjà mentionnés et pas seulement pour ceux qui sont obligatoires.

Les champs dans le fichier de données doivent contenir les données suivantes:

Champ	Description	Exemple
Catégorie	Doit contenir la catégorie de votre site avec le chemin complet de la racine à la catégorie où les produits sont références. Limite: 255 caractères	Appareils ménagers > Petits appareils pour soin personnel > Rasoirs
Fabricant	Le nom du fabricant ou la marque du produit. Limite: 100 caractères	Nokia
Modèle	Le numéro de pièce attribué au produit par le fabricant (MPN, EAN, UPC ou ISBN). Limite: 100 caractères	Pour la carte graphique Gigabyte Nvidia GeForce 210 512MB DDR2, le modèle est "GV-N210OC- 512I"
Le code du produit	Un code de produit unique par lequel les produits sont identifiés dans votre boutique. Il est recommandé que le code ne change pas avec le temps. Limite: 100 caractères	12345, 12346, 123457
Le nom du produit	Le nom du produit tel comme il apparaît sur votre site. Limite: 255 caractères	Carte graphique Gigabyte Nvidia GeForce 210 512MB
La description du produit	La description du produit; ne pas utiliser de balises HTML, de code Javascript, d' images ou tout autre type de fichier multimédia. Limite: 200 caractères	L' appareil photo numérique D3100 prend des photos merveilleux dans des conditions sombres et il est utilisé principalement dans l'industrie semi-professionnelle
URL produit	L'adresse URL de la page du produit.	http://example.fr/view-product?prod-id=12345
URL image	L'adresse URL de l'image principale du produit. Nous vous recommandons d’envoyer une image de grande taille avec une bonne qualité qui correspond à votre produit. Nous ne permettons pas des informations contenue dans l'image, comme filigrane, logo ou texte promotionnel.	http://example.fr/images/12345.jpg
Prix	Le prix du produit doit inclure toutes les taxes, sans le frais de port et qui doit être affiché dans un autre champ. Nous n'acceptons pas des prix qui sont disponibles seulement pour une catégorie de clientèle spécifique. Le prix ne doit pas contenir la devise: EUR.	120.45
Devise	La devise du prix.	EUR
Frais de port	Ces sont les frais de port pour les produits. Pour afficher les frais de port inclus dans le fichier de données, vous devez cocher cette option "Frais de port par produit" dans la section Paramètres - Paramètres d'expédition de votre compte. Les frais de port doivent être exprimées dans la même devise que le prix du produit. Livraison gratuite doit être indiqué par zéro (0.00).	2.5
Disponibilité	Contient les spécifications concernant la disponibilité d'un produit. Les valeurs acceptées pour ce champ sont: - In stock: Utilisez cette valeur si vous êtes sûr qu’il sera livré (ou être en transit vers le client) jusqu'à 3 jours ouvrables ou moins. Par exemple, si vous avez le produit disponible dans votre entrepôt. - Available for order: Utilisez cette valeur si la livraison prend plus de 4 jours ouvrables. Par exemple, si vous n'avez pas le produit en stock pour le moment, mais vous êtes sûr qu'il va arriver dans les prochains jours. Pour les produits inédits, utilisez la valeur Preorder. - Out of stock: Vous n'acceptez pas actuellement des commandes pour ce produit. - Preorder: Vous prenez des commandes pour ce produit, mais il n’est pas encore disponible. Note: Si vous utilisez d'autres valeurs pour la disponibilité dans votre flux, vous devez accéder à votre panneau de contrôle sur ShopMania pour faire les correspondances avec les valeurs utilisées dans le système.	In stock
GTIN (UPC/EAN/ISBN)	L'ensemble primaires des identifiants de produits uniques sont les codes articles internationaaux (GTIN), qui comprennent UPC - Code universel des produits , EAN - Code européen de numérotation d'article (en Europe) et ISBN - Numéro international normalisé du livre . Ces valeurs sont très importantes dans les recherches des utilisateurs pour vos produits. Il est obligatoire de fournir le numéro ISBN pour les livres. Cependant, nous vous recommandons de fournir les codes GTIN pour tous les produits, car cela pourrait devenir obligatoire à l'avenir. Vous pouvez trouver plus d'informations sur GTIN sur Wikipedia.	- UPC: un identifiant numérique unique pour les produits commerciaux qui est généralement associé à un code à barres imprimé sur les produits vendus au détail; numéro à 12 chiffres comme 001234567891 Vous pouvez trouver plus d'informations sur UPC sur Wikipedia. - UPC: un identifiant numérique unique pour les produits commerciaux qui est généralement associé à un code à barres imprimé sur les produits vendus au détail; numéro à 13 chiffres comme 001234567891 Vous pouvez trouver plus d'informations sur UPC sur Wikipedia. - ISBN: un identifiant numérique unique pour les livres commerciaux qui peuvent être trouvés sur le dos du livre avec le code-barres; numéro à 10 ou 13 chiffres comme 0451524233 Si vous avez les deux, n’utilisez que le numéro de 13 chiffres; Vous pouvez trouver plus d'informations sur ISBN sur Wikipedia.

Fichier de données XML

Nous pouvons également traiter des fichier de données au format XML, s’ils contiennent au moins les champs obligatoires. Vous pouvez définir vos propres balises pour les champs du fichier de données ou vous pouvez utiliser ceux de notre exemple.

Exemple de fichier XML:

<store>
<products>
...
<Product>
<MPC>12554</MPC>
<Category>Computers - Monitors</Category>
<Manufacturer>Samsung</Manufacturer >
<MPN>12350</MPN>
<Name>SyncMaster 206BW</Name>
<Description>Samsung 15.6" Widescreen LCD - 1360x768, 500... </Description>
<URL>http://www.example.com/products.php?id=a3057</URL>
<Image>http://www.example.com/products.jpg</Image>
<Price>431</Price>
<Currency>EUR</Currency>
<Shipping>15</Shipping>
<Availability>In stock</Availability>
<GTIN>1001234567891</GTIN>
</Product>

Notes:

- Les lignes de produits qui ne contiennent pas de données correctes sont automatiquement rejetées. Dans votre panneau de contrôle dans les "Statistiques des produits", vous trouverez tous les détails sur les champs rejetés;
- Les champs manquants doivent être séparés par 2 caractères consécutifs. Voilà un exemple de fichier sans le champ Modèle: catégorie | fabricant | | code du produit | nom du produit | description | URL du produit | URL de l'image | prix | devise | frais de port
- La description du produit ne doit pas contenir un langage promotionnel, des discounts, des balises HTML, des frais d'expédition ou texte en lettres majuscules seulement;
- Avant d’envoyer le flux, vous devez éliminer toutes les caractères « nouvelles lignes » ou d'autres caractères qui sont utilisés comme séparateurs de colonne;
- Le chemin de la catégorie du produit doit être complète: Catégorie / Sous-catégorie1 / Sous-catégorie2. Exemple: Informatique - Périphériques - Moniteurs. Nous acceptons seulement les fichiers de données qui contiennent des catégories propres et non pas les catégories du système ShopMania;
- Les URLs d'image et les URLs des produits doivent être complètes et commençant par http://
- Vous devez indiquer clairement la disponibilité d'un article sur la page du produit soit en affichant explicitement le statut (In stock, Available for order, Out of stock, Preorder), soit en mentionnant le nombre de jours qu'il faut pour que le produit soit livré. Les articles qui ne sont plus vendus doivent être supprimés du flux des données.

Téléchargement du fichier de données dans votre compte ShopMania

Vous devez vous connecter à votre compte ShopMania et aller à la section Paramètres - Paramètres upload. En function du type du fichier de données, vous devez choisir la méthode de téléchargement (automatique ou manuel). Pour la méthode automatique vous devez insérer l'URL de votre fichier de données ou vous devez télécharger le fichier de données pour la méthode manuelle.

Méthodes de téléchargement

1. Auto – la création des fichiers des données ShopMania fournit des scripts automatiques pour la création de fichier de données pour les plates-formes e-commerce les plus populaires: OSCommerce, OSCommerce v3, ZenCart, Virtuemart, Virtuemart 2, JoomShopping, phpShop, CSCart, CSCart 4, XCart, CubeCart, SunShop, OpenCart, PHPMass, OOS Shop, xtCommerce, Interspire, PrestaShop, Magento, Shop-Script, Shop-Script Premium, Creloaded, QuickCart, PinnacleCart, Ubercart, TomatoCart, eShop, ShopperPress, WP e-Commerce, WP e-Commerce 3.8, WP Online Store, WP Store, WP StoreBox, WooCommerce, LogiVert, INDIGO Shop, PHP + MySQL, ASP + MySQL.

Pour les sites qui n'utilisent pas l'une des plates-formes ci-dessus, nous fournissons des scripts génériques pour PHP + MySQL, ASP + MySQL, ASP + SQLServer si ASP + MsAccess. Ces scripts doivent être personnalisés par un programmeur afin de correspondre à la base de données de votre site.

Vous devez cliquer ici pour plus d’information sur l’installation des scripts des flux de données.

2.Manuel – il est recommandé d'inserer 50 produits dans votre fichier de données. Le fichier de données doit être mis à jour à chaque changement du prix ou stock, ou au moins tous les 30 jours. Vous devez tenir compte que si vous ne téléchargez pas un fichier de données mis à jour depuis plus de 30 jours, votre référencement des produits sera automatiquement suspendu.

Cela prend entre 1 à 3 jours ouvrés pour l'approbation du fichier de données et pour que vos produits soient affichés sur le portail. Si vous ne recevez pas de notification concernant les fichier de données pendant une longue période de temps, s'il vous plaît contactez-nous par email à support@shopmania.be.

Enuméré dans: Caractéristiques du fichier de données