Intégration à eBay
Vendez les articles de votre boutique sur eBay : la boutique publie automatiquement les annonces, synchronise les prix et les stocks, et importe les commandes. Ce guide décrit les deux intégrations, eBay (classique) et la nouvelle intégration eBay, avec pour chacune les paramètres à configurer dans l'interface d'administration.
Quelle connexion eBay convient à votre boutique ?
Dans le menu « Multicanal », deux connexions sont disponibles. Ne connectez un compte eBay qu’à l’une d’entre elles, sinon les deux publieront les mêmes articles.
eBay (classique)
L'intégration éprouvée via l'API Trading d'eBay. Elle publie les articles comportant des variantes sous la forme d'une seule offre, transfère les informations du fabricant relatives à la sécurité des produits (GPSR) et offre une protection complète des stocks.
Menu : Admin → Multicanal → eBay (classique)
eBay (nouvelle version)
L'intégration via l'interface REST d'eBay avec authentification OAuth. Elle utilise les mêmes masques de configuration que l'intégration Kaufland: stocks minimum et maximum, ainsi que la sélection de la catégorie et de l'entrepôt pour chaque place de marché. Elle ne transfère pas les offres à variantes, mais envoie les informations du fabricant (GPSR) à partir de la version 4.9.70.
Menu : Admin → Multicanal → eBay
| Fonction | eBay (classique) | eBay (nouvelle version) |
|---|---|---|
| Établir la connexion | Bouton « Se connecter à eBay » | Connexion à eBay lors de la première consultation |
| Variantes sous forme d'une seule annonce | oui (Family) | non |
| Informations du fabricant (GPSR) | oui, issues de la gestion des fabricants | oui, issues de la gestion des fabricants à partir de la version 4.9.70 |
| Règles relatives aux stocks | Protection des stocks à l'aide de plusieurs commutateurs | Stock minimum et maximum |
| Sélection des catégories et des entrepôts pour l'exportation | non | oui |
| Transférer uniquement le prix et le stock | Mode de téléchargement « Offre uniquement » | Mode de téléchargement « offer_only » |
| Nouvelle tentative après un refus | après un jour ; en cas de perturbations temporaires sur eBay, après une heure | après un jour |
Comment configurer eBay (classic) ?
Vous trouverez tous les paramètres sous Admin → Multicanal → eBay (classic) → onglet « Configuration eBay ». Enregistrez vos modifications en cliquant sur « Actualiser ».
Connecter un compte à partir de la version 4.9.26
Sous « Compte eBay actif », saisissez votre identifiant eBay, récupérez les identifiants d'accès en cliquant sur « Récupérer les valeurs de l'application XONIC », puis enregistrez. Lors de l'enregistrement, le formulaire vous demande le lieu de vente de l'article et au moins une catégorie eBay (étape 3).
Cliquez ensuite sur « Se connecter à eBay » → « Se connecter à eBay ». Connectez-vous à votre compte vendeur dans le nouvel onglet et confirmez l’accès. De retour dans la boutique, l’option « Connexion terminée – Récupérer le jeton » récupère l’autorisation.
Pour finir, réglez « Système de compte eBay » sur « Live » et enregistrez à nouveau. La fonction « Vérifier la validité » indique à tout moment la durée de validité de l’autorisation.
Récupérer les conditions générales
Commencez par définir les conditions de paiement, d’expédition et de retour dans votre compte eBay. La fonction « Importer les conditions générales » les transfère dans la boutique et remplace ainsi les conditions existantes.
Activez ensuite, sous « Conditions de retour » et « Modes de paiement et d’expédition », les conditions que vous souhaitez proposer à la sélection pour chaque article.
Localisation et présélection
Sous « Localisation de l’article », saisissez la ville, le code postal et le pays de votre entrepôt d’expédition.
Sous « Paramètres globaux », définissez les états des articles et les délais de livraison sélectionnables pour chaque article, ainsi que si le GTIN doit être transféré. Sous « Catégories eBay », cochez les catégories dans lesquelles vous vendez.
Offres à prix fixe
- Nombre d’articles : quantité fixe ou stock actuel. Le « nombre d’articles max. » limite la quantité par acheteur.
- Transfert du prix eBay : prix de la boutique ou champ de prix eBay personnalisé, avec au choix une majoration en pourcentage et un arrondi.
- Groupe de clients pour le calcul des prix : par exemple, une liste de prix spécifique pour eBay. Les prix spéciaux ont la priorité sur les prix de groupe.
- Méthode de transfert des variantes : « Famille (familles de produits) » est la méthode recommandée.
Activer le mode automatique
Dans la section « Protection des stocks », l’option « Téléchargement automatique des nouveaux produits » active la mise en ligne autonome de nouveaux articles. La boutique synchronise les annonces en cours indépendamment de cela.
Définissez également ici le « Statut de la commande lors de l’importation » et « Importer les commandes à partir de », puis vérifiez la protection des stocks avant de publier un grand nombre d’articles en une seule fois.
Comment les articles sont-ils transférés vers eBay (classic) ?
Vous validez les articles, la boutique les met en ligne et met à jour le prix et le stock.
Valider des articles
Dans l’onglet eBay, activez l’option « Article pour eBay » et remplissez les champs obligatoires : catégorie eBay, état de l’article, délai d’expédition, ainsi que les conditions de retour, d’expédition et de paiement.
Facultatif : un titre eBay personnalisé (champ supplémentaire « ebay_titel », 80 caractères maximum), une description eBay différente et un prix eBay personnalisé. Pour plusieurs articles à la fois, attribuez les paramètres à des catégories entières de la boutique dans l'onglet « Modèles eBay ».
Configurer et synchroniser
Si le téléchargement automatique est activé, la boutique met elle-même en ligne les articles validés. Manuellement, cela s’effectue via l’aperçu eBay : sélectionner les articles → « Préparer les articles pour l’exportation » → onglet « Exportation d’articles eBay » → « Télécharger les articles sur eBay ».
La synchronisation transfère automatiquement les modifications apportées au prix, au stock et au contenu, en traitant en priorité les articles modifiés en dernier. Le téléchargement et la synchronisation s’effectuent par petits lots. Pour les gammes de produits importantes, le transfert complet peut donc prendre un certain temps.
Caractéristiques des articles
La boutique transfère automatiquement la marque, la référence fabricant et le code EAN. Pour cela, chaque champ supplémentaire actif du produit devient une caractéristique de l’article eBay ; le nom du champ correspond au nom de la caractéristique.
Si eBay exige des caractéristiques obligatoires supplémentaires dans une catégorie, telles que « taille » ou « couleur », créez des champs supplémentaires à cet effet et remplissez-les dans la fiche produit. Si une caractéristique obligatoire manque, eBay refuse l’annonce.
Informations sur le fabricant (GPSR)
eBay exige des informations sur le fabricant. La boutique les extrait de Produits → Fabricant: société, adresse, pays et e-mail. Pour les fabricants situés en dehors de l’UE, la personne responsable au sein de l’UE doit également être indiquée.
Si le pays manque ou si le code postal comporte plus de 9 caractères, la boutique ignore l’article en affichant un message. Veillez à ce que l’adresse e-mail soit au format valide. À partir de la version 4.9.70, la nouvelle connexion eBay effectue exactement la même vérification avant de publier une nouvelle annonce. Elle continue de synchroniser les annonces en cours, mais sans les informations sur le fabricant. À partir de cette version, la boutique supprime elle-même les espaces en fin de champ.
Articles avec variantes
Avec la méthode « Family (familles de produits) », un article et toutes ses variantes apparaissent sous la forme d’une seule annonce. Si un article jusqu’alors vendu individuellement devient une variante, la boutique met automatiquement fin à son ancienne annonce individuelle.
Dans la mesure du possible, ne renommez pas les variantes d’une annonce en cours. eBay n’autorise pas cette modification. La boutique met alors fin à l’annonce et la republie, ce qui entraîne la perte des chiffres de vente et des abonnés.
Protection des stocks : que se passe-t-il lorsque le stock est à 0 ?
Onglet « Configuration eBay », section « Protection des stocks ». Avec le paramètre recommandé, les annonces épuisées sont conservées et le téléchargement ne met tout de même pas en ligne d’articles en rupture de stock.
Clôture automatique : Non
L'option « Clôturer automatiquement les annonces lorsque le stock est à 0 » reste désactivée. Les annonces épuisées restent en ligne sur eBay.
Ne mettre en ligne que les articles en stock : Oui
Seuls les articles pouvant être vendus sont mis en vente. Disponible à partir de la version 4.9.64.
Option eBay « En rupture de stock » : activée
Dans les paramètres du vendeur de votre compte eBay. eBay masque alors les annonces épuisées au lieu de les clôturer.
| Bouton | Fonction |
|---|---|
| Respecter le stock minimum | Si le stock passe en dessous de la valeur saisie, la synchronisation met fin à l'offre. |
| Mettre automatiquement fin aux annonces lorsque le stock est à 0 | Met fin à l'annonce lorsque le stock est à 0. La référence eBay disparaît alors. Si l'article revient en stock, une nouvelle annonce est créée sans historique de vente. Nous vous recommandons de laisser ce bouton désactivé. |
| Ne télécharger que les articles disposant d'un stock à partir de la version 4.9.64 | Seuls les articles disposant d'un stock ou d'une quantité eBay définie manuellement sont remis en vente. Ce paramètre n'affecte pas les annonces en cours. |
| Masquer les articles inactifs au lieu de les clôturer | Si vous désactivez un article, par exemple via le logiciel de gestion des stocks, la synchronisation transfère la quantité 0 au lieu de mettre fin à l'annonce. |
| Transférer les variantes inactives avec une quantité de 0 | Uniquement pour la méthode « Family » : les variantes inactives sont transférées vers eBay avec une quantité de 0 et ne sont plus disponibles à la vente sur la plateforme. |
| Réduire la quantité manuelle sur eBay en cas de vente | Lors de l’importation des commandes, la boutique réduit la quantité eBay enregistrée pour l’article de la quantité vendue. |
Qu’est-ce qui compte comme stock ?
- Le stock en entrepôt moins le stock de sécurité; dans le cas d’un système à plusieurs entrepôts, il s’agit des stocks publics.
- Une quantité eBay saisie manuellement pour l’article est également prise en compte.
- Les articles marqués comme « épuisés manuellement » ne sont jamais mis en vente.
- Pour les variantes gérées selon la méthode « Family », c’est le stock des variantes actives qui est pris en compte : l’offre est considérée comme disponible tant qu’une variante est en stock.
Lorsqu’un article est en rupture de stock
Avec le paramètre recommandé, la synchronisation transfère la quantité 0. eBay masque l'annonce, mais la référence de l'article, les chiffres de vente et les abonnés sont conservés.
Lorsque le stock est à nouveau disponible, la synchronisation suivante transfère le nouveau stock, et l’offre redevient visible avec son historique.
Commandes et expédition avec eBay (classic)
Les commandes eBay sont enregistrées dans votre système habituel de gestion des commandes ; les informations d'expédition sont automatiquement renvoyées à eBay.
Importation des commandes
La boutique récupère automatiquement les commandes eBay payées, attribue les articles à l'aide de leur référence (ou, à défaut, via le code EAN) et déduit les quantités en stock. Dans l'aperçu eBay, vous pouvez également lancer l'importation manuellement via « Importation des commandes ».
L'acheteur ne reçoit pas d'e-mail de confirmation de commande de la part de la boutique. L'option « Envoyer une copie de la commande lors de l'importation eBay » vous permet de choisir si vous souhaitez recevoir vous-même une copie.
Notification d’expédition
Si vous définissez une commande eBay sur « expédiée », la boutique signale l’expédition à eBay avec les numéros de suivi et marque la commande comme payée sur eBay. En cas d’enlèvement, le statut suffit sans numéro de suivi.
Cela fonctionne également si votre système de gestion des stocks définit le statut via xoPort. Le support XONIC définit quels statuts de commande sont considérés comme « expédiés ».
Comment configurer la nouvelle connexion eBay ?
Sous Admin → Multicanal → eBay → onglet « Paramètres ». Veuillez coordonner la configuration initiale avec le support XONIC.
Accès
Réglez le « Mode API » sur « live » et saisissez le ClientID, le ClientSecret et le nom RU issus de votre compte développeur eBay.
Lors de la première connexion, la boutique vous redirige vers la page de connexion eBay. Par la suite, elle renouvelle elle-même l'autorisation.
Mode de téléchargement et place de marché
« full » transfère le contenu, le prix et le stock. « offer_only » transfère uniquement le prix et le stock des annonces existantes et n’en crée pas de nouvelles.
Sous « Place de marché », sélectionnez eBay Allemagne, Autriche ou Suisse.
Localisation, conditions, catégories
Sous « Localisation », saisissez la ville, le code postal et le pays. La boutique crée elle-même le lieu de stockage sur eBay.
Vous pouvez importer les conditions de paiement, d’expédition et de retour ainsi que les catégories eBay dans la boutique en cliquant respectivement sur le bouton « … importer/mettre à jour ».
Quels articles sont transférés vers eBay via la nouvelle connexion ?
Les sections « Produits » et « Prix » de l’onglet « Paramètres » permettent de gérer la sélection, le stock et les prix.
Publier des articles
Dans l'onglet « Places de marché », activez « eBay » pour l'article concerné, puis sélectionnez la catégorie eBay, l'état, le délai d'expédition, les trois conditions ainsi que le type d'annonce et sa durée.
En option : un prix (net) spécifique à la place de marché et un nom différent.
Stock
Lorsque le stock est faible, la boutique signale la quantité 0 à eBay. Vous définissez la limite à l’aide de « Quantité minimale en stock pour l’exportation ». Les stocks supérieurs sont plafonnés à la « Quantité maximale en stock pour l’exportation ».
« Entrepôts à prendre en compte » permet de définir les entrepôts d’où provient le stock. Si un article devient inactif, la boutique supprime son annonce sur eBay.
Exclusion automatique
- Articles sans image
- Articles sans GTIN, tant que l’option « Exporter les produits sans GTIN » est désactivée
- Articles présentant un GTIN ou un MPN en double, si le filtre correspondant est activé
- Articles figurant sur une liste d’exclusion, par exemple par fabricant ou par marque
- Articles ne relevant pas des « restrictions de catégorie pour l'exportation » (liste blanche ou liste noire)
- Articles bloqués pour les visiteurs
- Articles à mettre en vente dont le fabricant n'a pas de pays ou de code postal comportant plus de 9 caractères, jusqu'à ce que les informations soient correctes. La boutique continue de synchroniser les offres en cours, mais sans les informations sur le fabricant. À partir de la version 4.9.70
Prix
Le « Groupe de clients pour le calcul des prix » détermine la base de prix, tandis que l’option « Prendre en compte les prix promotionnels » inclut les prix spéciaux.
Avec « Majoration automatique », vous définissez des majorations fixes ou en pourcentage pour chaque niveau de prix. L’arrondi du prix brut, par exemple avec 0,99, fixe tous les prix à x,99.
Détecter et corriger les erreurs
Si eBay refuse une offre, la boutique affiche le motif et réessaie automatiquement plus tard.
Où puis-je voir la raison ?
Sur eBay (classic), le message d'eBay s'affiche à côté de l'icône d'avertissement de l'article dans l'aperçu eBay. Le filtre « Avec des erreurs » affiche tous les articles concernés au cours des sept derniers jours.
Si vous lancez manuellement une opération avec la nouvelle connexion, la boutique affiche directement le message d’eBay.
Quand la boutique effectue-t-elle une nouvelle tentative ?
Après un refus, la boutique attend un jour. Si le problème est résolu d’ici là, l’article est accepté lors de la prochaine tentative.
À partir de la version 4.9.68, si eBay signale uniquement un dysfonctionnement temporaire (« Erreur système, veuillez réessayer plus tard »), eBay (classic) réessaie dès une heure plus tard.
| Message ou symptôme | Cause | Solution |
|---|---|---|
| Caractéristique obligatoire de l'article manquante | eBay exige une caractéristique dans la catégorie, par exemple « taille » ou « couleur ». | Créez un champ supplémentaire portant exactement ce nom et renseignez-le pour l'article. |
| Informations du fabricant incomplètes | Le pays, l'adresse ou l'e-mail du fabricant sont manquants ou non valides. | Sous Produits → Compléter les informations sur le fabricant, saisissez l'adresse e-mail sans espaces. |
| L'article est déjà en vente sur eBay | Il existe déjà une annonce pour ce même article dans votre compte. | À partir de la version 4.9.64, eBay (classic) associe automatiquement l'annonce existante si celle-ci peut être clairement identifiée. |
| Avertissement concernant la validation eBay | L'autorisation expire bientôt ou a déjà expiré. La boutique vous en avertit dans l'aperçu eBay, dans le tableau de bord et par e-mail. | Sur eBay (classic), cliquez à nouveau sur « Se connecter à eBay ». |
| L'article est en stock, mais n'apparaît pas | eBay a refusé l'annonce, ou l'article attend une nouvelle tentative après un refus. | Lisez la raison indiquée par l'icône d'avertissement et corrigez le problème. La boutique lancera elle-même la prochaine tentative. |
