Mettre en place votre flux source

1. Format du flux source

Vous pouvez nous fournir votre flux source aux formats CSV, TXT ou XML cependant nous recommandons le format CSV.

2. Encodage du flux source

Il est préférable d’encoder votre flux au format UTF-8 afin de garantir une compatibilité optimale avec tous les caractères.

3. Contenu du flux source

Avant de générer votre flux source, voici quelques éléments à suivre notamment car certaines choses peuvent endommager ou bloquer votre indexation sur la solution Lengow.

  • Ne jamais placer d’espace dans les titres de champs (préférez les _).
  • Ne jamais placer de caractères spéciaux (accents,% , / . etc) dans les titres de champs.
  • Les ID unique ne doivent pas contenir de caractères spéciaux ( accents, %, &, /, etc).
  • Les intitulés de catégorie ne doivent pas contenir de / ou & (préférez les symboles >).
  • Ne jamais changer les ID de vos produits. Les ID produits sont utilisés pour sauvegarder vos optimisations dans la solution. Si vous changez vos ID produits, vous perdrez toutes vos optimisations.
  • Ne jamais modifier la structure de votre flux source une fois qu’il est utilisé dans la solution. Si vous avez besoin de champs supplémentaires, ajoutez-les à la fin de votre structure.
  • Un champ ne doit pas être présent en double dans votre flux source. Chaque en-tête doit être unique.

3.1 Structure générale attendue

Voici une liste non exhaustive des champs à intégrer dans votre flux source (il est conseillé de ne pas inclure de déclinaisons de vos produits dans ces flux). Il s'agit bien d'un exemple de flux source. Le contenu et la structure sont adaptables en fonction de vos besoins.

3.1.1 Au format CSV ou TXT

Les séparateurs acceptés sont le pipe (|), la virgule, le point-virgule et la tabulation.

Titre du champ Contenu du champ Type Exemple Préconisation
Identifiant_unique Référence pérenne propre à chaque offre et permettant de l'identifier de façon unique dans le temps. Une même offre devra toujours avoir le même identifiant. Celui-ci ne devra pas être réattribué à une autre offre (25 caractères maximum). Alphanumérique 1235RES56 Obligatoire
Titre Titre du produit. Alphanumérique Télévision LCD 100 Hertz Samsung Obligatoire
Description Description du produit. Alphanumérique Télévision LCD 100 Hertz Samsung, 47 pouces… Obligatoire
Prix_TTC Correspond au prix du produit sur votre site (54.40, 60.30 …). Sans le symbole € et le séparateur devant être un point. Numérique 799.90 Obligatoire
Prix_barre Si le prix a été réduit (promotion, déstockage…) indiquez dans ce champ l'ancien prix du produit TTC en euros. Sans le symbole € et le séparateur devant être un point. Numérique 900.99 Fortement conseillé
Prix_solde Prix du produit pendant la période des soldes. Sans le symbole € et le séparateur devant être un point. Numérique 699.90 Fortement conseillé
Categorie Catégorie à laquelle appartient le produit. On peut également parler de “famille de produit” (champ de 250 caractères maximum). Ce champ servira à la catégorisation de vos produits. (Machine à laver, baladeur MP3, …). Alphanumérique High tech > Télévision > Télévision LCD > 100 Hertz Obligatoire
Sous_categorie1 Sous-catégorie à laquelle appartient le produit Alphanumérique Télévision LCD Fortement conseillé
Sous_categorie2… Sous-catégorie à laquelle appartient le produit Alphanumérique 100 Hertz Fortement conseillé
URL_produit Correspond à l’url de la page du produit sur votre site URL http://monsitemarchand.com/produit.html Obligatoire
URL_image Correspond à l’url de l’image du produit sur votre site. Format GIF ou JPG. Taille minimum variable selon les diffuseurs. URL http://monsitemarchand.com/image_produit.html Obligatoire
EAN Ce champ se compose de 13 chiffres et correspond au code barre couramment utilisé pour les produits de grande consommation. Il identifie le produit de façon unique et permet une meilleure indexation de votre offre dans nos catégories de produits. European article number. Numérique 1234567891011 Fortement conseillé
MPN Référence fabriquant (Manufacturer Product Number) Alphanumérique PRD567HT Fortement conseillé
Marque Correspond à la marque du produit ou au nom du constructeur du produit. Alphanumérique SAMSUNG Obligatoire pour GoogleAdwords, fortement conseillé pour les autres diffuseurs
Frais_de_livraison Correspond aux frais de livraison du produit. Dans ce champ, doit être indiqué la somme TTC en euros de tous les frais liés à la commande : frais de port, de traitement, de préparation… Sans le symbole € et le séparateur devant être un point » dans la description. Numérique 5.00 Fortement conseillé
Delais_de_livraison Délai maximal de livraison. Valeur numérique qui sera interprétée par défaut en jour. Si l'unité n'est pas le jour merci de le préciser (unités acceptées : heures, heure; jour, jours; semaine, semaines; mois). Pour les délais comprenant une fourchette, séparer les délais par un tiret. Indiquer l'unité seulement si l'unité n'est pas le jour. Numérique 12 Fortement conseillé
Description_de_livraison Description additionnel de la livraison. Détail concernant la livraison Alphanumérique Livraison le même jour à Paris Fortement conseillé
Quantite_en_Stock Correspond au nombre de produits actuellement en stock Numérique 23 Fortement conseillé
Disponibilite Disponibilité du produit. Valeur numérique qui sera interprétée par défaut en jour. 0 = En stock. Si l'unité n'est pas le jour merci de le préciser (unités acceptées : heures, heure; jour, jours ; semaine, semaines; mois).Pour les disponibilités comprenant une fourchette, séparer les valeurs par un tiret. Indiquer l'unité seulement si l'unité n'est pas le jour. Numérique 0 Conseillé
Garantie Durée de la garantie du produit. En année par défaut. Si la garantie n'est pas exprimée en année, préciser l'unité (unités acceptées : mois, an, ans, année, années) Numérique 2 Fortement conseillé
Taille Correspond à la taille du produit. Listez les tailles disponibles pour un produit en les séparant par des virgules Alphanumérique M Fortement conseillé
Couleur Correspond à la couleur du produit (rouge, blanc, bleu, …). Listez les couleurs disponibles pour un produit en les séparant par des virgules Textuel Bleu, Rouge, Vert Fortement conseillé
Matiere Correspond à la matière du produit (cuir, velour, sky, coton,…). Listez les matières disponibles pour un produit en les séparant par des virgules. Obligatoire pour vendre sur Amazon Vêtements Textuel Cuir, Coton Fortement conseillé
Genre Correspond au genre du produit. Homme, Femme, … Textuel H Fortement conseillé
Poids Correspond au poids du produit en grammes. Sans l’unité de mesure et le séparateur devant être un point. Numérique 20.55 Fortement conseillé
Condition Correspond à l’état du produit. Vous pouvez indiquer 0 ou 1 (0= neuf, 1 = occasion) ou simplement neuf ou occasion. Alphanumérique 0 ou neuf Fortement conseillé
Soldes N’intervient qu’en période de soldes. 0 = produit non soldé, 1 = produit soldé Numérique 1 Fortement conseillé
Promo_texte Correspond à une accroche promotionnelle sur un produit, (champ limité à 80 caractères, espaces compris) Alphanumérique 3 produits achetés 1 offert !
Pourcentage_promo Correspond au pourcentage de rabais appliqué sur le produit. En chiffre, par exemple : 30, 40, 50,… Numérique 30 Fortement conseillé
Date_de_debut_promo Correspondant au début de la promo Champ date : JJ-MM-AAAA HH:MM:SS 26-06-2008 08-00-00 Fortement conseillé
Date_de_fin_de_promo Correspondant à la fin de la promo Champ date : JJ-MM-AAAA HH:MM:SS 10-07-2008 23-59-59 Fortement conseillé
Ecotaxe Montant en euros de l'éco-participation pour les Déchets d'Equipements Electriques et Electroniques (DEEE). Sans le symbole € et le séparateur devant être un point. Numérique 2.33 Fortement conseillé
Devise Correspond à la devise du prix du produit. Utilisez exclusivement le code standard à 3 lettres ISO 4217. Vous pouvez consulter les codes devises sur le site iso.org Textuel EUR Fortement conseillé

3.1.2 Au format XML

Les champs attendus sont identiques à ceux du format CSV. Lengow ne peut pas prendre en compte des flux XML contenant une structure de nœuds à différents niveaux ainsi que les flux XML RSS. Vous devez nous transmettre une structure où tous les nœuds XML sont au même niveau. Chaque nœud <product> doit contenir le même nombre de sous nœuds XML. Les nœuds non renseignés doivent apparaître dans le flux même s’ils ne contiennent pas de valeur. Le fichier doit être sous cette forme par exemple :

<product>
    <Categorie><![CDATA[ Billets d'avion ]]></categorie>
    <Identifiant_unique><![CDATA[ 2 ]]></identifiant_unique>
    <Titre><![CDATA[ Couette Ultra Light Sleep 240x200]]></titre>
    <Description><![CDATA[Frais de livraison offerts Cette couette conviendra particulièrement aux personnes qui recherchent un produit naturel et extrêmement léger pour les chaudes nuits d'été]]></description>
    <Prix_ttc><![CDATA[ 399 ]]></Prix_ttc>
    <URL_produit><![CDATA [http://tracking.lengow.com/shortUrl/14-15062-2115/]]></URL_produit>
        <URL_image><![CDATA[http://www.monsite.com/Photos/Products/000004/000001.jpg]]></URL_image>
    <Frais_de_livraison><![CDATA[ 0 ]]></Frais_de_livraison>
    <Disponibilite><![CDATA[ 0 ]]></Disponibilite>
    <Delai_de_livraison><![CDATA[ 7 ]]></Delai_de_livraison>
    <Garantie><![CDATA[ 3 ]]></Garantie>
    <Ecotaxe><![CDATA[ 0 ]]></Ecotaxe>
    <Marque><![CDATA[ Plumka ]]></Marque>
    <EAN/>
    <Prix_barre/>
    <Devise><![CDATA[ EUR ]]></Devise>
    <Condition><![CDATA[ 0 ]]></Condition>
    <Type_promotion><![CDATA[ 0 ]]></Type_promotion>
    <Couleur><![CDATA[ rouge ]]></Couleur>
    <Matiere/>
    <Taille/>
    <Genre/>
</product>

Vous devez encapsuler toutes les valeurs dans des CDATA (<![CDATA[ 2 ]]>)

3.2 Ajout de champs spécifiques – Pour les marketplaces et Google Shopping

Votre catalogue produit ne comporte pas de déclinaison ?

Les champs suivants doivent être ajoutés à la structure générale de votre flux source afin de répondre aux différentes attentes des marketplaces.

Intitulé de champ Définition du champ
EAN Obligatoire pour Google shopping sauf pour l’univers mode ou quand MPN + Marque déjà renseignés, Amazon, Fnac, Cdiscount, PixPlace, LaRedoute, Priceminister selon univers - numéro à 13 chiffres
MPN Obligatoire pour Google shopping sauf pour l’univers mode ou quand EAN + Marque déjà renseignés, Facultatif pour les autres diffuseurs
ISBN Obligatoire si les produits sont des livres
ASIN Facultatif - (mais obligatoire pour Amazon si EAN, UPC ou GTIN absent)
UPC Facultatif - numéro à 12 chiffres (obligatoire pour Amazon si EAN, ASIN ou GTIN absent)
GTIN Facultatif - numéro à 14 chiffres (obligatoire pour Amazon si EAN, ASIN ou UPC absent)
Quantité Obligatoire (pour les parents, indiquer la quantité cumulée des produits enfants)

Cette liste n’est pas exhaustive et peut être complétée suivant vos besoins. Nous vous conseillons d’y ajouter les attributs que vous auriez à disposition dans votre base de données. Notamment ceux liés à vos déclinaisons et qui ne seraient pas cités dans le tableau ci-dessus.

Votre catalogue produit comporte des déclinaisons ?

Vous pouvez nous fournir un flux source uniquement destiné aux places de marché contenant les champs cités précédemment. Dans ce cas, vos déclinaisons peuvent être gérées de la manière ci-dessous.

3.2.1 Mise en place générale des déclinaisons

Les déclinaisons de produit

Si votre flux contient des déclinaisons de produit, chaque version déclinée d’un produit doit avoir un identifiant unique et un identifiant parent. L'identifiant parent doit être commun à l'ensemble des déclinaisons du produit. Il doit correspondre à l’identifiant unique d’une des déclinaisons.

Par exemple :

Pantalon Diesel taille 36 ⇒ ID_unique = 127 / ID_parent =127

Pantalon Diesel taille 38 ⇒ ID_unique = 128 / ID_parent =127

Pantalon Diesel taille 40 ⇒ ID_unique = 129 / ID_parent =127

Les produits non déclinés ne doivent pas avoir d’identifiant parent associé.

Votre flux doit également contenir les attributs de déclinaison dans des champs spécifiques. Si vos produits sont déclinés par taille par exemple, votre flux doit contenir un champ Taille avec une valeur pour chaque déclinaison.

3.2.2 Mise en place des déclinaisons pour Amazon, La Redoute ou Ebay

Si vous décidez de vendre sur Amazon, la Redoute ou eBay, votre flux doit contenir le « produit parent » sans notion d’attribut (taille, couleur) et les produits « enfants » qui sont les produits déclinés. Le produit parent doit contenir toutes les informations nécessaire sauf les attributs de déclinaison (taille, couleur, etc.)

Dans ce cas l’identifiant parent correspondra à l’identifiant unique du produit parent :

Pantalon Diesel ⇒ ID unique = 127 / ID_parent =127 (produit parent)

Pantalon Diesel taille 36 ⇒ ID_unique = 128 / ID_parent =127 (produit enfant)

Pantalon Diesel taille 38 ⇒ ID_unique = 129 / ID_parent =127 (produit enfant)

Pantalon Diesel taille 40 ⇒ ID_unique = 130 / ID_parent =127 (produit enfant)

Les produits sans déclinaisons ne doivent pas avoir d’identifiant parent associé.

Broche Diesel Love ⇒ ID unique = 131 / ID_parent =

Broche Diesel Peace ⇒ ID unique = 132 / ID_parent =

Types de déclinaison multiples

Lorsqu’il existe différents types de déclinaison dans votre flux source (taille, couleur, taille et couleur, etc.), votre flux source doit contenir un champ nommé par exemple « type_declinaison » qu’il faudra renseigner pour les lignes parents et enfants avec le type de déclinaison concerné (la valeur de ce champ est libre mais doit être commune à un même type de déclinaison).

Cas particulier LaRedoute et variation de produits

Pour pouvoir publier en mode décliné sur LaRedoute. Votre flux source ne doit contenir qu'un champ taille et un champ couleur. Vous ne pourrez publier vos déclinaisons si l'on trouve par exemple les champs Taille_pantalon, Taille_chemise, etc. Toutes ces valeurs doivent être regroupées dans un seul champ.

3.2.3 Ajout des attributs de produits

Votre flux source doit contenir un maximum d’informations sur vos produits dans des champs spécifiques. Ainsi, vous aurez une base de travail solide et complète qui facilitera grandement l’intégration de votre catalogue sur les différentes marketplaces.

Exemple d’attribut : longueur, largeur, nombre de place, contenance…

On doit donc retrouver les champs supplémentaires suivants en cas de déclinaison :

Intitulé de champ Définition du champ
Identifiant parent Obligatoire en cas de déclinaison, laisser le champ vide s'il ne s'agit pas d'un produit décliné
Taille Obligatoire si la déclinaison du produit concerne la taille (1 taille par champ/déclinaison) - Vous ne pouvez pas avoir plusieurs champs Taille pour la Redoute (ex : Taille_Pantalon, Taille_Pull)
Couleur Obligatoire si la déclinaison du produit concerne la couleur (1 couleur par champ/déclinaison) - Vous ne pouvez pas avoir plusieurs champs Couleur pour la Redoute (ex : Couleur_Pantalon, Couleur_Pull)
Genre Homme/Femme/Unique
Matiere Obligatoire si la déclinaison du produit concerne la matière, Obligatoire pour Amazon
Type_declinaison Obligatoire pour Amazon. A renseigner sur la fiche parent et fiche enfant. Exemples de valeurs : Taille, Couleur, TailleCouleur…

4. Contact Technique

Vous avez des questions concernant la création de votre flux source ?

N’hésitez pas à contacter le support client Lengow.