Intégration de Kaufland
Vendez automatiquement les produits de votre boutique sur Kaufland.de, Kaufland.at et d'autres vitrines en ligne : les articles, les prix et les stocks sont synchronisés plusieurs fois par jour, et les commandes sont importées automatiquement. À partir de la version 4.8.09, la boutique vérifie en outre quelles offres sont disponibles sur Kaufland ; à partir de la version 4.10.0, elle vérifie également lesquelles sont visibles sur Kaufland.
Comment configurer l'intégration Kaufland ?
Vous trouverez tous les paramètres sous Admin → Multicanal → Kaufland → Paramètres.
Identifiants d'accès et vitrine
Vous pouvez obtenirla ClientKey et le ClientSecret sur le portail des vendeurs Kaufland, sous Paramètres → API. Dans le champ « Storefront (Pays) », sélectionnez le pays de votre compte vendeur (par exemple « de » ou « at ») – Kaufland gère les groupes d'expédition et les catégories séparément pour chaque pays.
Après avoir modifié les paramètres de la vitrine ou du portail, cliquez sur le bouton« Recharger les groupes d'expédition, les catégories et l'entrepôt ».
Groupe d’expédition par défaut et entrepôt par défaut à partir de la version 4.8.09
Le groupe d’expédition par défaut s’applique à tous les produits pour lesquels aucune sélection n’a été effectuée. L’entrepôt par défaut (Warehouse) détermine depuis quel entrepôt Kaufland vos offres sont expédiées.
Ces deux paramètres peuvent être modifiés pour chaque produit : onglet « Places de marché » du produit → champs « Groupe d’expédition » ou « Entrepôt » (Warehouse).
Référence article chez Kaufland à partir de la version 4.8.09
Détermine ce que Kaufland utilise comme référence article pour vos offres : ean (le code EAN, comportement précédent) ou model (votre propre référence article issue de la boutique, comme pour les autres places de marché).
Kaufland ne permet pas de modifier la référence des offres existantes. Après la mise en place, exécutez donc la fonction «Mettre à jour les références chez Kaufland », en commençant par « Vérifier uniquement (simulation) ». La boutique crée alors chaque offre sous le nouveau numéro et ne supprime l’ancienne qu’ensuite ; l’article reste en ligne tout au long du processus.

Important : pas d’offre sans entrepôt
Kaufland exige un entrepôt pour chaque offre.
Symptôme : « Les données de l'offre sont manquantes »
Si vos articles apparaissent sur le portail Kaufland sans prix ni stock (« Les données de l'offre sont manquantes »), cela signifie qu'aucun entrepôt par défaut n'est sélectionné dans votre compte Kaufland. Kaufland rejette alors toutes les offres.
Deux solutions :
- Dans le portail vendeur Kaufland, sous Paramètres → Expédition & Entrepôt, créez un entrepôt et désignez-le comme entrepôt par défaut – le transfert mettra ensuite automatiquement à jour les offres.
- À partir de la version 4.8.09 : vous pouvez également sélectionner un entrepôt directement dans la boutique sous « Entrepôt par défaut » (Warehouse); la boutique l'inclura alors dans chaque offre.
Synchronisation : offres sur la place de marché à partir de la version 4.8.09
Vous pouvez voir à tout moment quelles offres se trouvent réellement chez Kaufland – et lesquelles sont répertoriées dans votre boutique.
Effectuer la synchronisation maintenant
Charge toutes les offres de votre compte Kaufland dans l'aperçu (onglet « Offres de la place de marché »).
Filtrer
Toutes / Associées / Non associées : cela vous permet de voir immédiatement les offres sans produit associé dans la boutique.
Attribuer automatiquement
Associe les offres au produit correspondant de la boutique à l'aide de la référence ou du code EAN.
Mettre fin à l'offre
Met fin à une offre non attribuée directement chez Kaufland – avec une demande de confirmation.
Mon offre est-elle visible sur Kaufland ?
à partir de la version 4.10.0
Le statut de téléchargement «done» signifie simplement que Kaufland a accepté l’offre. La colonne «Live» indique si celle-ci est visible sur Kaufland.
La colonne « Live »
Elle se trouve dans l'onglet « Offres de la place de marché » et dans l'onglet « Kaufland » (aperçu des articles), à côté de chaque article faisant l'objet d'une offre Kaufland :
- Live (vert) : l'offre est visible sur Kaufland.
- Non en ligne (rouge) : Kaufland n’affiche pas l’offre.
- – (trait) : aucun statut n’est encore disponible pour cette offre.
En passant la souris sur l'indicateur, vous verrez quand le statut a été vérifié pour la dernière fois. Le filtre « Non en ligne » dans l'onglet « Offres de la place de marché » ne répertorie que les offres concernées.
D'où provient le statut ?
Kaufland communique le statut à chaque synchronisation, c’est-à-dire lorsque vous cliquez sur «Synchroniser maintenant »dans l’onglet « Offres de la place de marché » ou automatiquement si la synchronisation est configurée en tant que tâche cron. La date de la dernière synchronisation est indiquée en haut sous « Dernière synchronisation ».
Si, après la mise à jour, la mention « – » apparaît partout, cela signifie qu’aucune synchronisation n’a encore eu lieu depuis lors : cliquez sur «Synchroniser maintenant». Si la mention « – » persiste partout après cela, contactez l’assistance XONIC.
Si Kaufland ne reconnaît pas une offre, bien que la boutique la considère comme transférée, la synchronisation n’affiche aucun statut à ce sujet. L’offre est alors absente de l’onglet « Offres de la place de marché » et n’apparaît donc pas non plus sous le filtre « Non en ligne » ; dans l’aperçu des articles, l’article reste sur « – ». Ce n’est qu’après avoir cliqué sur la loupe à côté du statut que le message « La place de marché ne connaît aucune offre portant le numéro… » s’affiche, accompagné de la mention « Non en ligne », jusqu’à ce que vous actualisiez la page. Dans ce cas, transférez à nouveau l’article.
Pourquoi une annonce n’est-elle pas en ligne ?
Si une offre est marquée comme « Non en ligne », vous trouverez à côté le bouton «Pourquoi n’est-elle pas en ligne ?». Dans l’aperçu des articles, ce bouton affiche uniquement une loupe. Si aucun statut n’est encore disponible, ce même bouton s’intitule «Vérifier le statut en ligne». Un clic permet d’interroger directement Kaufland sur les raisons : la boîte de dialogue indique chaque motif avec une explication et le code Kaufland, ainsi qu’un lien vers des informations complémentaires sur le site de Kaufland, le cas échéant. La colonne affiche ensuite le statut obtenu.
Kaufland limite cette requête. La boutique ne l’effectue donc que lorsque vous cliquez sur le bouton, et jamais automatiquement.
Vous pouvez résoudre ces motifs dans la boutique
- Le stock chez Kaufland est de 0 : si l’article est en stock dans la boutique, transférez-le à nouveau.
- Le prix doit être vérifié : vérifiez le prix dans la boutique en ligne ainsi que les paramètres de prix pour Kaufland (voir « Quels articles et quels prix sont transmis à Kaufland ? ») et transférez à nouveau l’article.
- Données produit incomplètes : complétez le titre, la description, les images et la catégorie dans la boutique, puis transférez à nouveau l’article.
- Les données du produit ne correspondent pas à l’article : vérifiez les informations dans la boutique, corrigez-les, puis transférez à nouveau l’article.
- Coordonnées GPSR manquantes : vérifiez les informations dans la gestion des fabricants (voir « Informations sur les fabricants (GPSR) ») puis transférez à nouveau un article de ce fabricant.
Pour effectuer un nouvel envoi, sélectionnez l’article dans l’aperçu des articles, puis choisissez l’option «Mettre à jour le produit» dans le menu «Action pour les produits sélectionnés». La colonne continue ensuite d’afficher le statut de la dernière vérification ; pour connaître le statut actuel, cliquez sur la loupe. Immédiatement après le transfert, Kaufland peut encore signaler brièvement que l’offre n’est pas en ligne.
Vous devez effectuer ces opérations sur Kaufland
- Offre suspendue : réactivez-la dans le portail des vendeurs Kaufland.
- Numéros d’enregistrement manquants (DEEE, EPR et autres) : les enregistrer dans le portail des vendeurs.
- Documents dans le compte Kaufland, par exemple le numéro d’identification TVA : les mettre à jour dans le portail des vendeurs.
- Droits de marque, droits d’image ou droits de propriété intellectuelle, authenticité, conditions générales de vente ainsi que motifs non précisés : clarifier la situation avec le service d’assistance aux vendeurs de Kaufland.
Quels articles et quels prix sont transmis à Kaufland ?
Les sections « Produits » et « Prix » de l'onglet « Paramètres » permettent de gérer la sélection et le calcul des prix.
Sélection des articles
- Uniquement les produits « esclaves » et les produits individuels : exclut les articles principaux des familles de variantes et ne transfère que les variantes et les articles individuels.
- Exporter les produits sans GTIN et filtrer les GTIN/MPN en double : ces options déterminent la manière dont la boutique gère les numéros d'identification manquants ou attribués plusieurs fois.
- Liste d'exclusion des fabricants/marques : exclut certains fabricants ou certaines marques de l'exportation.
- Restriction de catégories pour l’exportation : une liste blanche ne transfère que les articles des catégories sélectionnées, tandis qu’une liste noire les exclut. Les articles déjà répertoriés qui ne correspondent plus seront supprimés lors de la prochaine mise à jour.
- Entrepôts à prendre en compte : permet de déterminer de quels entrepôts provient le stock transféré. Si aucune sélection n’est effectuée, tous les entrepôts actifs sont pris en compte.
Prix
- Groupe de clients pour le calcul des prix : base de prix incluant les prix promotionnels et les prix de groupe actifs. Si le groupe n’a pas de prix pour un article, c’est le prix standard qui s’applique.
- Prendre en compte les prix promotionnels : inclut les prix promotionnels.
- Majoration automatique des prix : majorations fixes ou en pourcentage jusqu’à une valeur nette donnée. Les prix de la place de marché indiqués sur l’article ont la priorité.
- Arrondi automatique du prix brut : avec 0,99, la boutique arrondit tous les prix bruts à x,99.


Comment les informations du fabricant (GPSR) parviennent-elles à Kaufland ?
Le règlement européen sur la sécurité des produits (GPSR) exige le nom et l'adresse du fabricant ; pour les fabricants situés en dehors de l'UE, il exige en outre la désignation d'une personne responsable au sein de l'UE.
Transfert automatique depuis la gestion des fabricants à partir de la version 4.10.0
La boutique transmet les informations GPSR issues de la gestion des fabricants à Kaufland une seule fois par fabricant ; elles s’appliquent alors à tous les articles de ce fabricant. Si le fabricant est situé en dehors de l’UE, l’adresse enregistrée au sein de l’UE est transmise en tant que personne responsable.
Pour chaque fabricant, Kaufland sélectionne une information parmi celles fournies par tous les revendeurs. Vos informations sont donc transmises, mais ce ne sont pas nécessairement celles qui s’affichent.
Ce que Kaufland exige
- Nom, ville et pays ; dans l’UE, le code postal est également requis.
- Rue et numéro de rue. La boutique sépare automatiquement ces deux éléments ; elle ne transmet pas d’adresse sans numéro de rue identifiable.
- Une adresse e-mail ou un site web.
S'il manque une information, la boutique le signale lors de la transmission en indiquant le nom du fabricant. L'offre en ligne n'en est pas affectée ; les prix et les stocks continuent d'être mis à jour.
Comment fonctionne le processus entièrement automatisé ?
Une fois configurée, l'intégration fonctionne de manière autonome.
Transfert via une tâche cron
Les nouveaux articles, ainsi que les modifications de prix et de stocks, sont automatiquement transmis à Kaufland plusieurs fois par jour. Les commandes sont importées toutes les heures et leur expédition est signalée à Kaufland.
Correction automatique des erreurs à partir de la version 4.8.09
Si une offre est temporairement refusée par Kaufland (par exemple, en cas de rupture de stock), la boutique réessaie automatiquement chaque jour ; dès que le problème est résolu, l'offre s'affiche sans intervention supplémentaire.
Si Kaufland ne répond pas
à partir de la version 4.10.0
Si la connexion avec Kaufland est interrompue ou si Kaufland est temporairement inaccessible, le transfert des articles, des prix et des stocks n’est pas considéré comme terminé : l’article affiche le statut de téléchargement « error », et la boutique réessaie lors de la prochaine exécution, et non pas seulement le lendemain. Si vous lancez vous-même le transfert dans le backend, le message « Kaufland n’a pas fourni de réponse valide » s’affiche en plus.
La boutique ne crée les commandes que lorsque Kaufland a transmis l’intégralité des données de commande. Si la récupération est interrompue, la commande est rattrapée lors de la prochaine importation.
Vérifier la notification d’expédition
à partir de la version 4.10.0
Si la boutique a bien signalé l’expédition à Kaufland, l’entrée « „Versandübermittlung an Kaufland erfolgreich.“ » apparaît dans l’historique de la commande. Si elle manque, vérifiez d’abord le numéro d’expédition : sans numéro d’expédition, la boutique ne signale pas l’expédition à Kaufland et n’affiche aucune notification à ce sujet. Ajoutez le numéro d'expédition à la commande, puis remettez la commande au statut d'expédition, par exemple « expédiée ».