É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] paramètres (dans le coin supérieur droit) > 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 "Titre" doit afficher le titre 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. - 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.