Étape 1 : Ajoutez une nouvelle connexion
L'API Decathlon utilise la plateforme Mirakl, vous aurez donc besoin d'un compte Mirakl pour commencer à envoyer vos produits à Decathlon.
Lorsque vous avez un compte Mirakl Decathlon, allez dans le menu "[Votre entreprise] > Connexions > Ajouter une connexion". Cliquez sur "+ Ajouter une nouvelle connexion" puis vous verrez un écran où vous pouvez sélectionner Decathlon. Remplissez le nom de votre connexion avec par exemple "Decathlon". Puis cliquez sur ''Connecter avec Decathlon''. Vous serez redirigé(e) vers l'environnement où vous pourrez vous connecter avec vos identifiants Mirakl. Après vous être connecté(e), vous serez redirigé(e) vers Channable où la connexion sera disponible.
Étape 2 : Ajoutez une nouvelle API Decathlon dans Channable
Vous pouvez désormais naviguer dans "Votre projet > APIs" et cliquer sur "+ Ajouter nouvelle API". Veillez à sélectionner la connexion Decathlon que vous venez de créer et donner un nom à votre nouvelle API.
Sélectionnez le champ que vous souhaitez utiliser pour l'ID unique par produit (nous recommandons le champ "id"). Sélectioner un pays spécifique vous permettra de choisir des catégories et des attributs dans la langue correspondante. Par exemple, si vous sélectionnez "France", les catégories à l'étape "Catégories" de l'API seront en français. Afin d'envoyer vos produits pour plusieurs pays activés dans un même compte vendeur, vous pouvez remplir les attributs disponibles dans différentes langues (comme par exemple "Composition" dans la capture d'écran ci-dessous).
Enfin, vous pouvez également ajouter un groupe de règles générales si vous le souhaitez, puis cliquez sur "Continuer" pour terminer la création de la nouvelle API Decathlon.
Étape 3 : Créez vos annonces produits dans Channable
Une fois que vous avez créé l'API Decathlon, vous pouvez configurer les données de vos produits en suivant les différentes étapes de l'API.
-
Catégories
Pour que vos données sur les produits puissent être créées, il faut que vos produits aient une catégorie. Ajoutez des catégories à vos produits en utilisant la fonction de génération de catégories ou créez manuellement de nouvelles catégories.
-
Règles
Créez différentes règles pour optimiser les données relatives à vos produits. Consultez notre article concernant les règles courantes pour obtenir quelques exemples.
-
Construire
Vous trouverez ici notre modèle prédéfini pour vos produits. Il vous suffit de le remplir en cliquant sur un champ et en sélectionnant ce que vous souhaitez renseigner. Par exemple, le champ "Stock" doit afficher le stock de votre produit, etc. Lorsque vous avez terminé le paramétrage, il vous suffit de cliquer sur "sauvegarder" en bas de l'écran.Astuce ! Vous remarquerez un point d'interrogation à côté de chaque champ. Si vous le survolez, vous verrez une description du champ et des suggestions pour les valeurs attendues.Éco-participations
La France a introduit une législation sur l'éco-participation. Si votre entreprise opère en France, elle doit ajouter des éco-participations à ses offres sur la marketplace. Dans cet article, vous trouverez une liste des catégories d'EPR disponibles.
Canaux de vente : A côté de l'onglet "Produit", vous trouverez l'onglet pour les canaux de vente que vous avez pu activer à l'étape 2.
En utilisant un champ de projet, vous pouvez définir dynamiquement l'activation des différents canaux (Enabled
ouDisabled
), pour ajuster quels produits de votre API seront envoyés à chaque canal activé.
- Attributs
Vous avez presque fini ! Il vous faut maintenant remplir les champs de l'étape "Attributs". Sélectionnez d'abord la catégorie que vous souhaitez optimiser. Vous pouvez visualiser la vue que vous devriez maintenant avoir dans la capture d'écran ci-dessous. Vous trouverez une explication plus détaillée concernant ce qu'il faut indiquer dans l'étape "Attributs" dans notre article à ce sujet.
Étape 4 : Envoyez vos produits à Decathlon
Vous avez presque terminé, vos annonces produits sont prêtes à être envoyées. Si vous n'avez pas activé votre projet, rendez vous dans "Installation> Paramètres du projet" et cliquez sur "Activer le projet". Ensuite, retournez à "APIs > API Decathlon > Paramètres > Activer API". Une fois cette étape terminée, retournez à "APIs > Exécuter" pour envoyer vos annonces produits à Decathlon.
Étape 5 : Vérifiez vos annonces produits pour détecter les erreurs
Après avoir envoyé vos annonces produits à Decathlon, rendez-vous sur l'onglet "Résultats" de votre API Decathlon. Cliquez sur le filtre "Erreurs". Vous pouvez maintenant voir quelles annonces comportent des erreurs et ne sont pas envoyées. Cliquez sur une erreur spécifique pour obtenir plus d'informations. Une fois que vous avez résolu une ou plusieurs erreurs, veuillez relancer afin de mettre à jour les résultats de l'API.
Bonnes pratiques
Ajout de plusieurs valeurs d'attribut : Lorsque vous ajoutez plusieurs valeurs dans un champ d'attribut pour les marketplaces Mirakl, séparez chaque valeur par le symbole "|" pour assurer un traitement correct des valeurs.
ID du produit du vendeur pour les produits simples/uniques : Veuillez noter qu'il existe deux attributs nommés respectivement "SellerArticleId" et "SellerProductId". L'attribut "SellerProductId" fait référence à l'ID parent, tandis que l'attribut "SellerArticleId" fait référence aux produits variants. Pour les produits uniques, les deux attributs doivent être remplis avec la même valeur.
Pour plus d'informations sur les erreurs des marketplaces de Mirakl et les bonnes pratiques à adopter, consultez notre guide dédié.