Structure du fichier
et details des champs

Home Page > Support > Support marchands > Structure du fichier et details des champs

Structure du fichier

La liste complète des champs est présentée dans le tableau ci-dessous. Les codes utilisés sont les suivants :

  • M sont les champs obligatoires. Votre offre ne pourra pas être affichée sur Kelkoo si ces champs ne sont pas renseignés !
  • HR sont les champs hautement recommandés.
  • R sont les champs recommandés.
  • O sont les champs optionnels.

Afin de faciliter l’intégration de votre flux, nous vous demandons de respecter :

  • Le nom des balises XML (4e colonne du tableau ci-dessous)
  • L’ordre des champs et le séparateur “Tabulation (\t)” pour un fichier texte.
  • Les types de données :
    • Numérique : Champ strictement numérique (pas de caractère ni de symbole), les centimes sont toujours séparés par un point et non par une virgule.
    • Date : La date doit être au format YYYY-MM-DD (ex : 2009-10-29)
    • Texte : Les champs de type texte sont limités en nombre de caractère à l’affichage. Le code HTML n’est pas autorisé dans votre fichier.

Détails des champs

Pour référencer certains produits, nous avons besoin d’informations spécifiques comme par exemple l’année ou la cylindrée pour les voitures, ou la taille et la couleur pour les catégories mode et accessoires. Ces champs doivent être ajoutés en fin de fichier.

CodeFevad (uniquement FR)BALISE XMLTYPE DE DONNÉESDESCRIPTION
135Moffer-idtexteL’identifiant de chaque article doit être unique au sein de votre compte. Il ne peut pas être réutilisé d’un flux à l’autre pour le même pays et la même langue. Si vous possédez plusieurs flux pour un pays, les identifiants des articles contenus dans les différents flux doivent également être uniques.
Si vos codes n’apparaissent qu’une fois dans votre inventaire et qu’ils sont conformes aux exigences indiquées ci-dessous, nous vous conseillons de les utiliser pour cet attribut.
Attention :Après avoir envoyé un article, vous ne devez pas modifier son identifiant lors de la mise à jour de votre flux de données. .
Attention :Après avoir envoyé un article, vous ne devez pas utiliser son identifiant pour désigner un produit différent par la suite. .
1MtitletexteModèle ou désignation de l’offre, limité à 80 caractères (espaces compris). Ex : “EOS 400D”, ou “Pull 100% laine”…
ATTENTION : Votre offre ne pourra pas être affichée sur Kelkoo si ce champ n’est pas renseigné.
2Mproduct-urltexteLien vers l’offre
URL de la page de l’offre sur votre site. L’URL doit obligatoirement commencer par “http://” ou “https://”.
ATTENTION : Votre offre ne pourra pas être affichée sur Kelkoo si votre URL ne débute pas par http:// ou https://
136Mlanding-page-urltexteLien vers l’offre
URL de la page de l’offre sur votre site. L’URL doit obligatoirement commencer par “http://” ou “https://”.
ATTENTION : Le champ landing-page-url est différent du champ product-url : il ne contient pas de tracking – par exemple  Beezup, ChannelPilot, Iziflux, Lengow, ShoppingFeed… Le champ landing-page-url doit être l’URL finale vue par l’utilisateur, et utilise le nom de domaine de votre boutique.
3MpricenumériquePrix TTC pour un acheteur local.
Ne doit pas inclure une éventuelle réduction d’un code promo…(voir les champs dédiés plus bas)
4MbrandtexteMarque du produit : Laisser vide s’il n’en possède pas ou si elle n’est pas pertinente.
5MdescriptiontexteDescription :
Caractéristiques de votre produit. Texte libre, limité à 300 caractères espaces compris (ne pas utiliser de code HTML).
6Mimage-urltexteLien pointant vers une image de l’offre. Indiquez l’image la plus grande disponible sur votre site. Elles ne doivent contenir aucun filigrane ou logo du commerce. Il est recommandé de fournir des photos sur un fond blanc au format jpg, png ou gif..
Taille minimum recommandée : 300 * 300.
Taille maximale : 6 600 000 pixels. Exemples :
* image 1024 * 768 = 786 432 pixels = OK
* image 1600 * 1200 = 1 920 000 pixels = OK
* image 1518 × 5908 = 8 968 344 pixels = NOT OK
ATTENTION : Votre image ne pourra pas être affichée sur Kelkoo si votre URL ne commence pas par http:// ou par https://.
7MeantexteLe code EAN du produit, vous garantira un bon matching au niveau produit. Nous acceptons :
* UPC-E (6 chiffres)
* EAN-8/UCC-8/GTIN-8 (8 chiffres)
* UPC-A/GTIN-12 (12 chiffres)
* EAN-13/UCC-13/GTIN-13 (13 chiffres)
* ISBN-13 (13 chiffres pour les livres)
* EAN-14/UCC-14/GTIN-14 (14 chiffres)
Si vous ne pouvez pas fournir de codes EAN pour une raison spécifique, veuillez contacter votre Account Manager Kelkoo ou nous contacter ici
8HRmerchant-categorytexteCategorie :
Renseignez un nom de catégorie pertinent, le champ étant utilisé par notre système de catégorisation. Par exemple, “Accessoires” ne serait pas assez précis pour notre système, alors que “Accessoires auto” ou “Accessoires tuning PC” ont une bien meilleure chance de correspondre avec la bonne catégorie…
9MavailabilitynumériqueDisponibilité de l’offre. Les codes acceptés sont les suivants :
1 = En stock
4 = En précommande
5 = Disponible sur commande
ATTENTION : Votre offre ne pourra pas être affichée sur Kelkoo si ce champ n’est pas correctement renseigné.
10Mdelivery-costnumériqueFrais de livraison. Indiquez le montant exact de vos frais de port. Il s’agit des frais de livraison à domicile uniquement, en non en point de retrait dans un magasin, un entrepôt ou autre…
Attention : Votre offre ne pourra pas être affichée sur Kelkoo si ce champ n’est pas correctement renseigné. Une valeur à 0 affichera gratuit.
11HRdelivery-timetexteDélais de livraison du produit après commande. Exemples de valeurs :
* Sous x à y jours
* Sous x jours
* Sous x à y heures
* Sous y heures
* Sous x à y semaines
* Sous y semaines
12HRconditionnumériqueEtat du produit. Valeurs autorisées :
0 = neuf (valeur par défaut)
1 = occasion
2 = reconditionné
3 = boîte/emballage ouvert
4 = retour SAV
5 = endommagé
6 = destockage
7 = liquidation
8 = inconnu
9 = téléchargement
10 = offres pour professionnels
13HRecotaxnumériqueEcotaxe. Valeurs acceptées dans ce champ (numérique) :
* L’offre n’est pas concernée par l’écotaxe, indiquez la valeur ‘0’
* L’offre est concernée par l’écotaxe et le prix ne l’inclue pas, indiquez le montant de cette taxe
* Si le prix de l’offre (champ price) contient déjà l’écotaxe, indiquez la valeur ‘0’
14HRwarrantytexteGarantie appliquée pour cette offre. Valeurs conseillées :
* x ans + informations complémentaires
* x mois + informations complémentaires
* voir sur le site
Ex. : 2 ans garantie constructeur, 6 mois sur site
15Rmobile-urltexteURL de votre “site Web mobile” contenant le détail des produits et le bouton “acheter” pour le produit correspondant
16Rkelkoo-category-idnumériqueIdentifiant unique de la catégorie sur Kelkoo. Par exemple, pour la catégorie Climatiseur et Ventilateur, indiquez le catkkid 144801.
17MmpntexteCode MPN (manufacturer part number) pour le produit, peut aider à un meilleur référencement du produit.
18OskutexteLe code SKU du produit, peut aider à un meilleur référencement du produit.
19RcolortexteCouleur de l’article. Si l’article est disponible en plusieurs couleurs, vous pouvez alors indiquer plusieurs couleurs, ou utiliser le délimiteur “;” pour séparer chaque valeur.
20Runit-pricetextePrix unitaire. Ex : 14.56 EUR/kg, 0.14 EUR pour 100 ml, pour 100ml = 14.56 EUR
137Runit-price-measuretexteLa mesure dans laquelle le produit est vendu. Par exemple, 300 ml pour une bouteille de 300 ml, 0,75 l pour une bouteille de vin de taille normale, etc.
138Runit-price-base-measurtexteLa mesure de base dans laquelle le prix doit être comparé à. p.ex. 100 ml si pour afficher 5,60 eur / 100 ml, 12,90 eur / 0,75 l, etc.
21Roffer-typetexteType d’offre. Deux valeurs possible : “single” ou “bundle”.
22Omerchant-infotexteCe champ vous permet d’associer des informations supplémentaires à votre marque (et non au produit). Ex : présentation de l’entreprise, points de vente, livraison (limité à 150 caractères, espaces compris).
23OcurrencytexteMonnaie utilisée. Ex : EUR, GBP, DKK etc.
24Oimage-url-2texteLien pointant vers une image alternative de l’offre. Indiquez l’image la plus grande disponible sur votre site. Chaque image doit être différente.
25Oimage-url-3texteLien pointant vers une image alternative de l’offre. Indiquez l’image la plus grande disponible sur votre site. Chaque image doit être différente.
26Oimage-url-4texteLien pointant vers une image alternative de l’offre. Indiquez l’image la plus grande disponible sur votre site. Chaque image doit être différente.
Caractéristiques du produit
27Rgreen-producttexteProduit écologique. Indiquer si le produit peut être considéré comme écologique (green) :
1 = oui
0 = non (ou vide = valeur par defaut)
28Rgreen-labeltexteLabel écologique du produit. Ex : NF Environnement, FSC, Commerce équitable,…
29Osales-ranknumériqueLe classement de ce produit en terme de ventes pour le marchand. Les nombres faibles indiquent qu’ils sont vendus le plus souvent.
30Ounit-quantitynumériqueLa quantité d’éléments inclus. Ex : un paquet contient 8 unités de dentifrice.
31Omade-intexteLe pays où le produit a été fabriqué.
32Oefficiency-classtexteClasse énergétique de l’offre (A+++, A++, A+, A, B, C, D, E, F, G).
Mode d’expédition
33Rshipping-methodtexteMode de livraison lié au frais de port. Ex: Poste, UPS, Colissimo, Kiala…
34Rdelivery-cost-2numériqueFrais de livraison alternatif
35Rshipping-method-2texteMode de livraison lié au frais de port. Ex: Poste, UPS, Colissimo, Kiala…
36Rdelivery-cost-3numériqueFrais de livraison alternatif
37Rshipping-method-3texteMode de livraison lié au frais de port. Ex: Poste, UPS, Colissimo, Kiala…
38Rdelivery-cost-4numériqueFrais de livraison alternatif
39Rshipping-method-4texteMode de livraison lié au frais de port. Ex: Poste, UPS, Colissimo, Kiala…
40Rzip-codenumériqueCode postal de la boutique. Spécifique pour les Etats-Unis, mais nécessaire pour tous les pays pour permettre la géolocalisation.
41Ostock-quantitynumériqueNombre de produits en stock
42Oshipping-weighttextePoids de l’élément à l’expédition.
43Opayment-methodstexteListe des méthodes de paiement acceptées (Visa, Paypal…)
Coupon
44Rvoucher-titletexteTitre du Coupon. Limité à 80 caractères, espaces compris.
45Ovoucher-descriptiontexteDescription du coupon. Limité à 180 caractères espaces compris.
Requis en France
46Ovoucher-urltexteURL du coupon. Lien vers votre page coupon si vous en avez une ou la page d’accueil de votre site (limité à 20 caractères, espaces compris).
Requis en France
47Ovoucher-codetexteCode coupon. Le code que devra saisir l’utilisateur pour utiliser le coupon sur votre site. Limité à 20 caractères espaces compris.
Requis en France
48Ovoucher-start-datedateDate de début du coupon, au format YYYY-MM-DD (ex : 2015-01-29)
49Ovoucher-end-datedateDate de fin du coupon, au format YYYY-MM-DD (ex : 2012-11-29)
Prix barrés / Soldes
50Rprice-no-rebatenumériquePrix barré. Prix de l’article avant la réduction. La valeur de ce champ doit être strictement supérieure à la valeur du champ “price”. Cette information sera affichée barrée à côté de votre prix pendant la période de promotion, et doit être ignorée hors de cette période. Champ strictement numérique (pas de caractère ni de symbole .), les centimes sont toujours séparés par un point et non par une virgule.
51Opercentage-promonumériquePourcentage de réduction. Laissez ce champ vide, Kelkoo Group le calculera pour vous.
52Ooccasion (anciennement “flag”)texteUtilisé pour marquer vos offres lors d’événements spéciaux comme Noël, les Soldes, la Saint Valentin et d’autres encore.
53Opromo-start-datedateDate de début de la promotion. Au format YYYY-MM-DD (ex : 2015-10-29).
54Opromo-end-datedateDate de fin de la promotion. Au format YYYY-MM-DD (ex : 2015-10-29)
Engagement de l’utilisateur
55Ouser-ratingnumériqueNote de l’utilisateur. Comment les utilisateurs ont noté le produit sur le site marchand de 1 à 5, 5 étant la meilleure note.
56Onb-reviewsnumériqueNombre d’avis d’utilisateurs. Le nombre de commentaires d’utilisateurs pour ce produit sur le site marchand.
57Ouser-review-linktexteL’URL pour les avis utilisateurs sur le site marchand.
58Ovideo-linktexteL’URL d’une vidéo sur le produit.
59Ovideo-titletexteLe titre de la vidéo du produit.
Mode et Accessoires
60Rfashion-typetexteLe type de produit (tee-shirt, chaussures, veste, etc.)
61Rfashion-gendertexteGenre (homme, femme, enfant, mixte).
62Rfashion-sizetexteTaille de l’article. Ex: 36;37;38;39;42;45
19RcolortexteCouleur de l’article. Si l’article est disponible en plusieurs couleurs, vous pouvez alors indiquer plusieurs couleurs, ou utiliser le délimiteur “;” pour séparer chaque valeur.
Logiciels et Jeux vidéo
63Rsoftware-platformtextePlatforme (ex : XBox, PlayStation 4…)
Immobilier (extra)
64Rproperty-typetexteType d’offre. Valeurs :
* Achat
* Location
* Collocation
* Viager
* Investissement locatif
65Rproperty-sourcetexteSource. Valeurs :
* Particulier
* Professionnel
66Rpropery-garage-parkingtexteGarage et Parking. Valeurs :
* Garage
* Avec garage et parking
* Avec parking
* Sans garage ni parking
67Rproperty-citytexteNom de la ville
68Rproperty-zip-codenumériqueCode postal
69Rproperty-number-roomsnumériqueNombre de chambres (ex : 1, 2, 3…).
70Rproperty-surfacenumériqueSurface du logement
71Rproperty-publication-datedateDate de publication de l’annonce. Au format YYYY-MM-DD.
72Rproperty-tenuretexteTenure
Films (extra)
73Rmovie-directortexteLe réalisatur du film comme Steven Spielberg, Stanley Kubrick, etc.
74Rmovie-actorstexteActeur du film
75Rmovie-formattexteFormat du film (VHS, DVD, Blu-Ray).
76Rmovie-regiontexteZone (ex : 1 (USA), 2 (Europe), etc.)
77Omovie-languagestexteLangues disponibles sur le média.
78Omovie-release-datedateDate de sortie du film au format YYYY-MM-DD.
79Rmovie-media-ratingtextePublic. Ex : Interdit aux moins de 18 ans…
CD (extra)
80Rmusic-artisttexteL’artiste, groupe, liste des musiciens, etc. Pour la musique classique, le chef d’orchestre.
81Rmusic-mediatexteSupport (CD, Vinyle…)
82Rmusic-genretexteGenre musical
83Omusic-formattexteFormat du support (album, single…)
84Omusic-record-labeltexteMaison de disques
85Omusic-languagetexteLangue principale
86Omusic-release-datedateDate de sortie au format YYYY-MM-DD.
Livres (extra)
87Rbook-authortexteL’auteur ou groupe d’auteurs
88Rbook-formattexteFormat (Poche, broché…).
89Rbook-editiontexteEdition
90Rbook-publishertexteEditeur
91Obook-genretexteLe genre du livre (policer, science-fiction…)
92Obook-languagetexteLangue utilisée
93Obook-release-datedateDate de sortie au format YYYY-MM-DD
94Obook-audiencetexteType de public (adultes, enfants…)
95Obook-number-of-pagestexteNombre de pages du livre
Vin et Champagne (extra)
96Rwine-countrytexteOrigine du vin (France, Australie, Chili…)
97Rwine-yearnumériqueAnnée de production
98Owine-domaintexteDomaine de production
99Owine-zonetexteRégion du vin dans le pays (Bordeaux, Bourgogne…)
100Owine-number-bottlesnumériqueNombre de bouteilles
101Owine-capacitytexteCapacité / volume de chaque bouteille
Pneu (extra)
102Rtyre-wet-griptexteLa base de l’adhérence sur sol mouillé est la distance d’arrêt lors de la conduite à 80 km/h. Entre chaque classe, il y a une différence de 3 à 6 mètres de distance de freinage. Les classes “D” et “G” ne sont pas utilisées (ex : A).
103Rtyre-noise-classnumériqueLe niveau de bruit est cité comme une valeur absolue en décibel (ex : 72).
Téléphone portable avec abonnement ou carte prépayée (extra)
104Rmobilephone-networktexteL’opérateur ou le fournisseur de l’abonnement (Telenor, Netcom, Vodaphone, Orange, Tele2, etc).
105Rmobilephone-contract-typetexteLibellé du forfait pour le téléphone mobile
106Rmobilephone-contract-lengthtexteDurée minimale du contrat
107Rmobilephone-contract-total-costnumériquePrix total minimum par an (produits et abonnement combiné)
108Rmobilephone-tariffnumériqueTarif mensuel du forfait
109Rmobilephone-monthly-hourstexteNombre d’heures de communication par mois
Voiture Neuve et d’Occasion (extra)
110Rvehicle-yearnumériqueAnnée du vehicule. Date de premiere mise en circulation (ex : 2008)
111Rvehicle-mileagenumériqueKilométrage du véhicule
112Rvehicle-vendor-typetexteOrigine. Valeurs :
* Professionnel
* Particulier
113Rvehicle-citytexteVille où le véhicule sera visible/vendu
114Rvehicle-zip-codenumériqueCode postal de la ville où le véhicule sera visible/vendu
115Rvehicle-doorsnumériqueNombre de portes du véhicule
116Rvehicle-chassistexteCarosserie (ex : coupe, berline, 4X4…)
117Rvehicle-engine-sizenumériqueCylindrée du moteur (en ccm)
118Rvehicle-transmissiontexteType de boîte. Valeurs :
* Manuelle
* Automatique
* Séquentielle
119Rvehicle-fuel-typetexteEnergie : essence, diesel, électrique, éthanol, GPL…
120Rvehicle-bonus-malusnumériqueBonus-malus. Indiquez la valeur du bonus ou du malus. Valeur positive ou négative (ex : 200 ou -300)
121Rvehicle-all-fuel-typestexteValeurs :
* Essence
* Diesel
* Gaz
* Electrique
* Electrique+Essence
* Electrique+Diesel
* Gaz+Essence
* Gaz+Diesel
122Rvehicle-consumption-highwaynumériqueLitres pour 100km ou MPG. Ex : 4
123Rvehicle-consumption-citynumériqueLitres pour 100km ou MPG. Ex : 5
124Rvehicle-consumption-mixednumériqueLitres pout 100km ou MPG. Ex : 6
125Rvehicle-electric-consumption-highwaynumériqueKiloWatt par heure. Ex : 53 kW
126Rvehicle-electric-consumption-citynumériqueKiloWatt par heure. Ex : 53 kW
127Rvehicle-electric-consumption-mixednumériqueKiloWatt par heure. Ex : 53 kW
128Rvehicle-co2-emmissionnumériqueEmission CO2 (combiné) (g/km)
Billeterie et Sortie (extra)
129Revent-zip-codenumériqueCode postal où l’événement se produit
130Revent-citytexteVille où l’événement se produit
131Revent-locationtexteLieu où l’événement se produit
132Revent-start-datedateDate de début au format YYYY-MM-DD
133Oevent-end-datedateDate de fin au format YYYY-MM-DD
134Revent-genretexteGenre de l’événement (concert, spectacle…)

Select your location