Bienvenue sur le Service Client de Kelkoo

Structure du fichier et Détails 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.

Code Fevad (uniquement FR) BALISE XML TYPE DE DONNÉES DESCRIPTION
135 M offer-id texte L’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. .
1 M title texte Modè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é.
2 M product-url texte Lien 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://
136 M landing-page-url texte Lien 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.
3 M price numérique Prix 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)
4 M brand texte Marque du produit : Laisser vide s’il n’en possède pas ou si elle n’est pas pertinente.
5 M description texte Description :
Caractéristiques de votre produit. Texte libre, limité à 300 caractères espaces compris (ne pas utiliser de code HTML).
6 M image-url texte Lien 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://.
7 M ean texte Le 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
8 HR merchant-category texte Categorie :
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…
9 M Feed layout and fields details fevad logo availability numérique Disponibilité 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é.
10 M Feed layout and fields details fevad logo delivery-cost numérique Frais 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.
11 HR Feed layout and fields details fevad logo delivery-time texte Dé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
12 HR condition numérique Etat 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
13 HR Feed layout and fields details fevad logo ecotax numérique Ecotaxe. 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’
14 HR Feed layout and fields details fevad logo warranty texte Garantie 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
15 R mobile-url texte URL de votre “site Web mobile” contenant le détail des produits et le bouton “acheter” pour le produit correspondant
16 R kelkoo-category-id numérique Identifiant unique de la catégorie sur Kelkoo. Par exemple, pour la catégorie Climatiseur et Ventilateur, indiquez le catkkid 144801.
17 M mpn texte Code MPN (manufacturer part number) pour le produit, peut aider à un meilleur référencement du produit.
18 O sku texte Le code SKU du produit, peut aider à un meilleur référencement du produit.
19 R color texte Couleur 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.
20 R unit-price texte Prix unitaire. Ex : 14.56 EUR/kg, 0.14 EUR pour 100 ml, pour 100ml = 14.56 EUR
21 R offer-type texte Type d’offre. Deux valeurs possible : “single” ou “bundle”.
22 O merchant-info texte Ce 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).
23 O currency texte Monnaie utilisée. Ex : EUR, GBP, DKK etc.
24 O image-url-2 texte Lien pointant vers une image alternative de l’offre. Indiquez l’image la plus grande disponible sur votre site. Chaque image doit être différente.
25 O image-url-3 texte Lien pointant vers une image alternative de l’offre. Indiquez l’image la plus grande disponible sur votre site. Chaque image doit être différente.
26 O image-url-4 texte Lien 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
27 R green-product texte Produit écologique. Indiquer si le produit peut être considéré comme écologique (green) :
1 = oui
0 = non (ou vide = valeur par defaut)
28 R green-label texte Label écologique du produit. Ex : NF Environnement, FSC, Commerce équitable,…
29 O sales-rank numérique Le classement de ce produit en terme de ventes pour le marchand. Les nombres faibles indiquent qu’ils sont vendus le plus souvent.
30 O unit-quantity numérique La quantité d’éléments inclus. Ex : un paquet contient 8 unités de dentifrice.
31 O made-in texte Le pays où le produit a été fabriqué.
32 O efficiency-class texte Classe énergétique de l’offre (A+++, A++, A+, A, B, C, D, E, F, G).
Mode d’expédition
33 R shipping-method texte Mode de livraison lié au frais de port. Ex: Poste, UPS, Colissimo, Kiala…
34 R delivery-cost-2 numérique Frais de livraison alternatif
35 R shipping-method-2 texte Mode de livraison lié au frais de port. Ex: Poste, UPS, Colissimo, Kiala…
36 R delivery-cost-3 numérique Frais de livraison alternatif
37 R shipping-method-3 texte Mode de livraison lié au frais de port. Ex: Poste, UPS, Colissimo, Kiala…
38 R delivery-cost-4 numérique Frais de livraison alternatif
39 R shipping-method-4 texte Mode de livraison lié au frais de port. Ex: Poste, UPS, Colissimo, Kiala…
40 R zip-code numérique Code postal de la boutique. Spécifique pour les Etats-Unis, mais nécessaire pour tous les pays pour permettre la géolocalisation.
41 O stock-quantity numérique Nombre de produits en stock
42 O shipping-weight texte Poids de l’élément à l’expédition.
43 O payment-methods texte Liste des méthodes de paiement acceptées (Visa, Paypal…)
Coupon
44 R voucher-title texte Titre du Coupon. Limité à 80 caractères, espaces compris.
45 O voucher-description texte Description du coupon. Limité à 180 caractères espaces compris.
Requis en France
46 O voucher-url texte URL 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
47 O voucher-code texte Code coupon. Le code que devra saisir l’utilisateur pour utiliser le coupon sur votre site. Limité à 20 caractères espaces compris.
Requis en France
48 O voucher-start-date date Date de début du coupon, au format YYYY-MM-DD (ex : 2015-01-29)
49 O voucher-end-date date Date de fin du coupon, au format YYYY-MM-DD (ex : 2012-11-29)
Prix barrés / Soldes
50 R price-no-rebate numérique Prix 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.
51 O percentage-promo numérique Pourcentage de réduction. Laissez ce champ vide, Kelkoo Group le calculera pour vous.
52 O occasion (anciennement “flag”) texte Utilisé pour marquer vos offres lors d’événements spéciaux comme Noël, les Soldes, la Saint Valentin et d’autres encore.
53 O promo-start-date date Date de début de la promotion. Au format YYYY-MM-DD (ex : 2015-10-29).
54 O promo-end-date date Date de fin de la promotion. Au format YYYY-MM-DD (ex : 2015-10-29)
Engagement de l’utilisateur
55 O user-rating numérique Note de l’utilisateur. Comment les utilisateurs ont noté le produit sur le site marchand de 1 à 5, 5 étant la meilleure note.
56 O nb-reviews numérique Nombre d’avis d’utilisateurs. Le nombre de commentaires d’utilisateurs pour ce produit sur le site marchand.
57 O user-review-link texte L’URL pour les avis utilisateurs sur le site marchand.
58 O video-link texte L’URL d’une vidéo sur le produit.
59 O video-title texte Le titre de la vidéo du produit.
Mode et Accessoires
60 R fashion-type texte Le type de produit (tee-shirt, chaussures, veste, etc.)
61 R fashion-gender texte Genre (homme, femme, enfant, mixte).
62 R fashion-size texte Taille de l’article. Ex: 36;37;38;39;42;45
19 R color texte Couleur 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
63 R software-platform texte Platforme (ex : XBox, PlayStation 4…)
Immobilier (extra)
64 R property-type texte Type d’offre. Valeurs :
* Achat
* Location
* Collocation
* Viager
* Investissement locatif
65 R property-source texte Source. Valeurs :
* Particulier
* Professionnel
66 R propery-garage-parking texte Garage et Parking. Valeurs :
* Garage
* Avec garage et parking
* Avec parking
* Sans garage ni parking
67 R property-city texte Nom de la ville
68 R property-zip-code numérique Code postal
69 R property-number-rooms numérique Nombre de chambres (ex : 1, 2, 3…).
70 R property-surface numérique Surface du logement
71 R property-publication-date date Date de publication de l’annonce. Au format YYYY-MM-DD.
72 R property-tenure texte Tenure
Films (extra)
73 R movie-director texte Le réalisatur du film comme Steven Spielberg, Stanley Kubrick, etc.
74 R movie-actors texte Acteur du film
75 R movie-format texte Format du film (VHS, DVD, Blu-Ray).
76 R movie-region texte Zone (ex : 1 (USA), 2 (Europe), etc.)
77 O movie-languages texte Langues disponibles sur le média.
78 O movie-release-date date Date de sortie du film au format YYYY-MM-DD.
79 R movie-media-rating texte Public. Ex : Interdit aux moins de 18 ans…
CD (extra)
80 R music-artist texte L’artiste, groupe, liste des musiciens, etc. Pour la musique classique, le chef d’orchestre.
81 R music-media texte Support (CD, Vinyle…)
82 R music-genre texte Genre musical
83 O music-format texte Format du support (album, single…)
84 O music-record-label texte Maison de disques
85 O music-language texte Langue principale
86 O music-release-date date Date de sortie au format YYYY-MM-DD.
Livres (extra)
87 R book-author texte L’auteur ou groupe d’auteurs
88 R book-format texte Format (Poche, broché…).
89 R book-edition texte Edition
90 R book-publisher texte Editeur
91 O book-genre texte Le genre du livre (policer, science-fiction…)
92 O book-language texte Langue utilisée
93 O book-release-date date Date de sortie au format YYYY-MM-DD
94 O book-audience texte Type de public (adultes, enfants…)
95 O book-number-of-pages texte Nombre de pages du livre
Vin et Champagne (extra)
96 R wine-country texte Origine du vin (France, Australie, Chili…)
97 R wine-year numérique Année de production
98 O wine-domain texte Domaine de production
99 O wine-zone texte Région du vin dans le pays (Bordeaux, Bourgogne…)
100 O wine-number-bottles numérique Nombre de bouteilles
101 O wine-capacity texte Capacité / volume de chaque bouteille
Pneu (extra)
102 R tyre-wet-grip texte La 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).
103 R tyre-noise-class numérique Le 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)
104 R mobilephone-network texte L’opérateur ou le fournisseur de l’abonnement (Telenor, Netcom, Vodaphone, Orange, Tele2, etc).
105 R mobilephone-contract-type texte Libellé du forfait pour le téléphone mobile
106 R mobilephone-contract-length texte Durée minimale du contrat
107 R mobilephone-contract-total-cost numérique Prix total minimum par an (produits et abonnement combiné)
108 R mobilephone-tariff numérique Tarif mensuel du forfait
109 R mobilephone-monthly-hours texte Nombre d’heures de communication par mois
Voiture Neuve et d’Occasion (extra)
110 R vehicle-year numérique Année du vehicule. Date de premiere mise en circulation (ex : 2008)
111 R vehicle-mileage numérique Kilométrage du véhicule
112 R vehicle-vendor-type texte Origine. Valeurs :
* Professionnel
* Particulier
113 R vehicle-city texte Ville où le véhicule sera visible/vendu
114 R vehicle-zip-code numérique Code postal de la ville où le véhicule sera visible/vendu
115 R vehicle-doors numérique Nombre de portes du véhicule
116 R vehicle-chassis texte Carosserie (ex : coupe, berline, 4X4…)
117 R vehicle-engine-size numérique Cylindrée du moteur (en ccm)
118 R vehicle-transmission texte Type de boîte. Valeurs :
* Manuelle
* Automatique
* Séquentielle
119 R vehicle-fuel-type texte Energie : essence, diesel, électrique, éthanol, GPL…
120 R vehicle-bonus-malus numérique Bonus-malus. Indiquez la valeur du bonus ou du malus. Valeur positive ou négative (ex : 200 ou -300)
121 R vehicle-all-fuel-types texte Valeurs :
* Essence
* Diesel
* Gaz
* Electrique
* Electrique+Essence
* Electrique+Diesel
* Gaz+Essence
* Gaz+Diesel
122 R vehicle-consumption-highway numérique Litres pour 100km ou MPG. Ex : 4
123 R vehicle-consumption-city numérique Litres pour 100km ou MPG. Ex : 5
124 R vehicle-consumption-mixed numérique Litres pout 100km ou MPG. Ex : 6
125 R vehicle-electric-consumption-highway numérique KiloWatt par heure. Ex : 53 kW
126 R vehicle-electric-consumption-city numérique KiloWatt par heure. Ex : 53 kW
127 R vehicle-electric-consumption-mixed numérique KiloWatt par heure. Ex : 53 kW
128 R vehicle-co2-emmission numérique Emission CO2 (combiné) (g/km)
Billeterie et Sortie (extra)
129 R event-zip-code numérique Code postal où l’événement se produit
130 R event-city texte Ville où l’événement se produit
131 R event-location texte Lieu où l’événement se produit
132 R event-start-date date Date de début au format YYYY-MM-DD
133 O event-end-date date Date de fin au format YYYY-MM-DD
134 R event-genre texte Genre de l’événement (concert, spectacle…)