Configuration du connecteur eBay¶
Aperçu¶
Le connecteur eBay d’Odoo permet aux annonces d’eBay de se connecter aux produits d’Odoo. Une fois qu’eBay est connecté, vous pouvez mettre à jour les annonces dans Odoo et dans eBay. Lorsqu’un article est vendu sur eBay, des commandes brouillon sont créées dans Odoo que l’utilisateur peut contrôler et confirmer. Une fois que la commande est confirmée, les applications Inventaire et Ventes d’Odoo fonctionnent comme d’habitude pour retirer des produits des stocks et permettre à l’utilisateur de créer des factures.
Pour plus d'infos
Pour en apprendre plus sur le connecteur eBay, consultez également ces pages :
Champs liés eBay - Odoo¶
Les champs suivants sont des détails de produit eBay. Chacun de ces champs eBay mettent à jour les champs correspondants dans Odoo.
URL eBay
Statut eBay
Quantité vendue
Date de début
Titre
Sous-titre
État de l’article
Catégorie
Catégorie 2
Catégorie de magasin
Catégorie de magasin 2
Politique de paiement
Profiles vendeur
Code postal
Politique d’expédition
Type d’annonce (prix fixe ou vente aux enchères)
Enchère de départ
Prix Buy it now
Montant du prix fixe
Utiliser la quantité en stock
Quantité sur eBay
Durée
Autoriser la meilleure offre
Annonce privée
Description eBay
Image produit eBay
Pays
Conditions eBay¶
Les Versions permettent de regrouper plusieurs produits en un seul, avec plusieurs versions (ou variantes). Les versions peuvent être synchronisées avec les attributs et les valeurs d’Odoo. Les versions apparaissent dans les menus déroulants situés en haut de la page lors de la consultation d’une annonce eBay. Elles sont comparables aux variantes de produits dans Odoo.
Les Caractéristiques de l’objet, situés au bas de l’annonce, fournissent des informations spécifiques au produit. Ces caractéristiques ne sont pas automatiquement synchronisés avec les champs d’Odoo, car un développement est nécessaire pour lier ces champs.
Sandbox et Production sont des termes utilisés pour catégoriser les environnements eBay comme soit encore en développement/test (Sandbox), soit destinés à être utilisés dans l’instance réelle de la base de données avec des informations/ensembles de données de clients réels (Production). Il est recommandé de commencer par le Sandbox pour tester, puis de créer une instance de Production en suivant les processus ci-dessous.
Astuce
Vous pouvez accéder à l’environnement sandbow d’eBay en allant au portail sandbox d’eBay via https://sandbox.ebay.com/. Vous pouvez accéder à l’environnement de production d’eBay en allant au portail eBay.com ou https://www.ebay.com/.
Important
La sélection de l’environnement doit rester inchangée pour tous les paramètres d’environnement sur eBay et sur Odoo tout au long de cette configuration.
Actions eBay disponibles dans Odoo¶
Les actions suivantes sont intégrées dans Odoo et permettent d’ajouter ou de mettre à jour les annonces eBay :
Liste/ Lien : générer une nouvelle annonce eBay avec un produit Odoo en cliquant sur Vendre l’article sur eBay ou Associer à une annonce eBay existante.
Le bouton Modifier l’article : après avoir modifié une annonce eBay dans Odoo, enregistrez l’enregistrement et cliquez sur Modifier l’article dans Odoo pour mettre à jour l’annonce eBay.
Remettre en vente : si l’annonce d’un article a pris fin prématurément ou si la fonction remettre en vente automatiquement n’est pas sélectionnée, un utilisateur peut remettre en vente l’article à partir d’Odoo. La date de début sera réinitialisée.
Le bouton Terminer l’annonce d’un article : mettre fin à une annonce sur eBay directement depuis Odoo.
Dissocier les annonces de produits : les utilisateurs peuvent dissocier un produit de l’annonce eBay ; l’annonce restera intacte sur eBay.
Configuration requise dans Odoo avant la configuration d’eBay¶
Pour associer eBay à Odoo, installez le module eBay en allant au tableau de bord d’Odoo et en cliquant sur l’application Apps. Recherchez le terme eBay et installez le module Connecteur eBay.
Les éléments suivants doivent être configurés avant qu’eBay soit configuré :
Dans Odoo, créez et configurez les produits destinés à être listés sur eBay. eBay n’importe pas de nouveaux produits dans Odoo. Tous les produits doivent d’abord être créés dans Odoo, puis liés à des annonces.
Odoo ne permet pas d’associer plusieurs annonces eBay par produit dans Odoo. Si la société vend le même produit dans plusieurs annonces, suivez ces instructions :
Configurez un produit de base (noté dans le champ Composant de la nomenclature à partir de laquelle toutes les annonces eBay seront tirées. Il s’agit d’un produit stockable qui permet de conserver des stocks. Surligné en vers ci-dessous, ce produit sera inclut dans le kit pour chaque produit “associé” suivant.
Configurez plus de deux produits associés (notés dans le champ Produit de la nomenclature), un pour chaque annonce eBay. Le type de produit sera déterminé par les paramètres de comptabilité de la société, comme il est expliqué dans la documentation d’Odoo. Surligné en jaune ci-dessous, chaque produit doit avoir un type de nomenclature équivalent au Kit et le produit de base en tant que Composant du kit. Lorsque ce produit eBay associé est vendu, le bon de livraison créé indiquera le produit de base au lieu du produit associé.
Pour plus d'infos
eBay ne crée pas automatiquement des factures pour les commandes eBay qui sont transférées dans Odoo. Définir la politique de facturation pour les produits eBay : la politique de facturation dictera lorsque le produit peut être facturé. Puisque la plupart des utilisateurs d’eBay encaissent le paiement avant l’expédition du produit, « facturer sur commande » permettra aux utilisateurs de créer en masse des factures pour les commandes eBay tous les jours.
Définissez la route Expéditions pour l’entrepôt afin de Livrer les marchandises directement (1 étape).
Avertissement
Lorsque la route des Expéditions est définie sur deux ou trois étapes, un problème connu se produit : eBay marque à tort les commandes comme livrées lorsque l’opération de transfert dans Odoo est confirmée. Le comportement attendu est de marquer les commandes comme livrées après la configuration du bon de livraison. Cette erreur d’étiquetage empêche les numéros de suivi dans eBay d’être importés dans le bon de livraison.
Si les applications Comptabilité/Facturation sont installées, entraînez-vous à enregistrer les paiements et à lettrer les factures créées à partir des commandes eBay avec l’argent reçu d’eBay.
Pour plus d'infos
Générez un jeton de notification de suppression/clôture de compte de marketplace. Pour commencer, allez à l’application . Dans l’en-tête eBay, modifiez le mode en Production et saisissez des valeurs de texte aléatoires pour la Cert Key production. Cliquez ensuite sur le bouton Générer le jeton dans la section Notifications de suppression/clôture de compte eBay Marketplace. Ce jeton sera utilisé pendant la configuration dans eBay pour la configuration des notifications de suppression/clôture.
Configuration dans eBay¶
Configurer un compte de développeur eBay¶
Pour commencer, créez un compte de développeur eBay via le portail développeur d’eBay. Ce site demande un login et un mot de passe différents du compte eBay, même si la même adresse email peut être utilisées pour vous inscrire. Le délai de vérification pour la création d’un compte de développeur est d’environ 24 heures.
Configurer un ensemble de clés eBay¶
Une fois le compte de développeur eBay créé, configurez une application sur le portail développeur d’eBay. Allez ensuite à la rubrique Bonjour [nom d’utilisateur] en haut à droite de l’écran, puis, dans le menu déroulant, cliquez sur Ensembles de clés de l’application. Cette opération ouvre une fenêtre contextuelle qui invite l’utilisateur à Saisir le titre de l’application (jusqu’à cinquante caractères), et choisissez un environnement de développement (Sandbox ou Production). Ces deux champs génèrent un premier ensemble de clés. Le titre de cette application n’est pas enregistré jusqu’à ce que l’ensemble de clés soit généré. Cliquez sur Créer un ensemble de clés pour générer l’ensemble de clés.
Avertissement
L”ensemble de clés de production nouvellement créé est désactivé par défaut. Activez-le en vous abonnant aux “notifications de suppression ou de clôture de compte” de la Marketplace eBay ou en demandant une dérogation à eBay. Une fois activée, la base de données peut passer 5000 appels par jour à l’aide de cet ensemble de clés.
Configurer les paramètres de suppression de compte / de notification (Production)¶
Pour configurer les notifications ou supprimer la base de données dans un environnement de production, allez au portail développeur d’eBay. Configurez les paramètres de suppression de compte/notification dans eBay en allant à la rubrique Bonjour [nom d'utilisateur] en haut à droite de l’écran, puis à Ensembles de clés de l’application.
Cliquez ensuite sur l’option notification de suppression de la marketplace/clôture du compte dans la colonne de l’ensemble de clés Production. Saisissez un email dans la section Email à notifier si le point de terminaison de notification de suppression de compte de la marketplace est interrompu. Cliquez sur Enregistrer pour activer l’email.
Suite à cette action, saisissez l’URL du Point de terminaison de la notification de suppression du compte de la marketplace fournie par Odoo. Ce point de terminaison HTTPs se trouve dans Odoo en allant à l’application , dans le champ Notifications de suppression/clôture de compte eBay Marketplace.
Le fait de cliquer sur le bouton Générer le jeton dans Odoo en dessous de ce champ crée un jeton de vérification pour l’environnement de production d’eBay. Dans Odoo, copiez le jeton nouvellement créé et allez à eBay pour compléter le champ Jeton de vérification. Cliquez sur Enregistrer pour activer la Méthode de livraison des notifications d’événement.
Après avoir rempli les champs ci-dessus, cliquez sur Envoyer une notification de test pour tester les nouvelles notifications. Procédez à l’étape suivante lorsque la coche verte apparaît. Revenez sur les paramètres ci-dessus si la notification test ne répond pas aux attentes.
Après avoir configuré les paramètres de notification, retournez à la page pour générer les ensembles de clés de production.
Créer l’ensemble de clés¶
Une configuration réussie des notifications permet de créer des Jeux de clés de production qui sont nécessaires pour le reste de la configuration d’Odoo. Retournez à la page pour générer un jeu de clés de production.
L’administrateur est invité à . Saisissez ou confirmez le propriétaire du compte (la personne légalement responsable de l’accord de licence API d’eBay). Remplissez les champs Prénom, Nom de famille, Email, Téléphone. Sélectionnez ensuite l’option Particulier ou Entreprise.
Note
L’adresse email ou le numéro de téléphone fournis ne doivent pas nécessairement correspondre à ceux du compte. eBay utilise ces informations pour contacter l’entreprise ou le particulier en cas de problèmes avec les jetons d’utilisateurs. Vous pouvez ajouter des contacts supplémentaires à partir de la page Profil & Contacts d’eBay.
Cliquez sur Continuer à créer des clés pour confirmer le contact principal. Les Clés de l’application s’affichent dans un nouvel écran et un email est envoyé au compte de développeur. Les champs ID App (ID Client), ID Dev, et ID Cert (Secret client) se remplissent automatiquement.
Copiez ces valeurs, car elles sont saisies dans Odoo plus tard dans le processus.
Créer le jeton d’utilisation d’eBay¶
Créez à présent un jeton d’utilisateur dans eBay en allant à la section Bonjour [nom d'utilisateur] en haut à droite de l’écran, puis à Jetons d’accès utilisateur.
Sélectionnez le bon Environnement : Sandbox pour les tests ou Production pour la base de données live. Gardez la même sélection pour tous les paramètres d’environnement dans eBay et dans Odoo.
Sélectionnez ensuite le bouton radio libellé Auth’n’Auth.
Choisissez Connectez-vous à Production ou Connectez-vous à Sandbox pour obtenir un jeton d’utilisateur dans l’environnement choisi. Le bouton change en fonction de la sélection faite : Sandbox ou Production.
Cette opération fait apparaître une fenêtre contextuelle permettant de Confirmer votre adresse légale. Complétez les champs requis, tels que Prénom, Nom de famille, Email principal, Adresse légale, et Type de compte. En ce qui concerne le Type de compte, sélectionnez soit Particulier, soit Entreprise. Pour compléter la confirmation, cliquez sur Connectez-vous à eBay pour obtenir un jeton.
Note
eBay contactera ce particulier ou cette entreprise si un problème survient avec les clés de l’application. Vous pouvez ajouter d’autres contacts à la page d’eBay.
L’administrateur sera redirigé à une page de connexion sandbox ou production. Ce login est différent du login de la console développeur d’eBay, il s’agit du compte eBay sur lequel les articles seront vendus. Cet email et/ou login peuvent différer du compte de développeur d’eBay.
Saisissez l”Email ou le Nom d’utilisateur pour le compte eBay et connectez-vous au compte eBay.
Important
Si un utilisateur additionnel est nécessaire pour la simulation sandbox, vous devez créer un utilisateur test. Consultez le formulaire d’inscription à Sandbox d’eBay. Vous trouverez des instructions détaillées sur les pages d’assistance d’eBay : Create a test Sandbox user.
Accorder l’accès à l’application¶
Après s’être connecté à l’environnement de production ou sandbox, eBay propose à l’administrateur d’autoriser l’accès aux données eBay de l’utilisateur.
Le fait de cliquer sur Accepter permet à eBay d’associer le compte eBay à l”interface de programmation d’application (API). Ce consentement peut être modifié à tout moment en allant aux préférences du compte eBay.
Avertissement
eBay a mis en place une séquence temporelle entre la connexion et l’acceptation des conditions de liaison de l”API au compte. Une fois l’opération terminée, un Jeton d’utilisateur s’affichera sur la page .
Un Jeton d’utilisateur s’affiche à l’écran. Veillez à copier ce jeton, car il sera utilisé dans les étapes suivantes avec le Jeu de clés de l’appliation.
Important
Vous devez vous connecter au compte eBay afin de créer le jeton. Le développeur eBay peut également révoquer le jeton en cliquant sur le lien Révoquer un jeton.
Explorateur de l’API¶
À présent que le Jeu des clés de l’application et un Jeton d’utilisateur ont été créés, un test peut être exécuté via l”Explorateur de l’API afin de s’assurer que l”API est correctement configuré. Ce test effectuera une simple recherche à l’aide de l”API.
Pour lancer le test API, cliquez sur Obtenir le jeton d’application OAuth. La clé sera alors remplie dans le champ Jeton.
Une fonction de recherche de base s’exécutera. Cliquez sur Exécuter pour finaliser le test. Un test réussi répondra avec une Réponse à l’appel de 200 OK et l”Heure correspondante.
Saisir les identifiants dans Odoo¶
Le Jeton d’utilisateur et le Jeu de clés d’application précédemment copiés peuvent désormais être saisis dans la base de données d’Odoo.
Retournez aux paramètres d’eBay dans Odoo () et collez les identifiants suivants d’eBay dans les champs correspondants dans Odoo.
Plateforme |
Clé/ID Dev |
Jeton |
Clé/ID App |
Clé/ID Cert |
|---|---|---|---|---|
eBay |
ID Dev |
Jeton d’utilisateur |
ID App (ID client) |
ID Cert (Secret client) |
Odoo |
Clé développeur |
Jeton Production/Sandbox |
Clé App Production/Sandbox |
Clé Cert Production/Sandbox |
Important
Vous pouvez accéder au Jeu de clés de l’application en allant au portail développeur d’eBay et à la section Bonjour [nom d'utilisateur] en haut à droite de l’écran, puis cliquez sur Jeux de clés de l’application. Allez au Jeton d’utilisateur dans eBay en allant à la section Bonjour [nom d'utilisateur] en haut à droite de l’écran, puis à Jetons d’accès de l’utilisateur et cliquez sur Connectez-vous à Sandbox. Vous pouvez également accéder au Jeton d’utilisateur en cliquant sur Jetons d’utilisateur à partir de la page .
Confirmez que la configuration est correcte en enregistrant les identifiants dans Odoo. Une fois que la configuration initiale est terminée, un nouvel onglet de menu intitulé eBay apparaît dans les produits avec l’option de Vendre sur eBay. Consultez la documentation gérer sur la façon de lister les produits.
Astuce
Synchronisez les catégories de produit en cliquant sur Catégories de produits. Après la synchronisation, un nouvel élément de menu, intitulé Catégorie eBay, est disponible pour configurer les produits. Ces catégories d’eBay sont importées depuis la base de données d’Odoo et sont disponibles lorsque vous listez un article sur eBay via Odoo.
Important
Si des catégories de produits au-delà de quatre chemins sont nécessaires, les utilisateurs devront ajouter ces chemins manuellement. Historiquement, cela a été fait en obtenir une liste de toutes les catégories de produits au-delà de quatre chemins, en les important manuellement dans le modèle de catégorie de produits dans Odoo, puis en les liant individuellement au produit.
Pour plus d'infos
Maintenant que la configuration est terminée, passez aux étapes suivantes :