Configurer une API Decathlon

• Étape 1 : Ajoutez une nouvelle connexion
• Étape 2 : Ajoutez une nouvelle API Decathlon dans Channable
• Étape 3 : Créez vos annonces produits dans Channable
• Exigences liées au RSGP et au DSA
• Étape 4 : Envoyez vos produits à Decathlon
• Étape 5 : Vérifiez vos annonces produits pour détecter les erreurs

É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.

1. 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.
   
   
2. 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.
   
   
3. 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 ou Disabled), pour ajuster quels produits de votre API seront envoyés à chaque canal activé.
   
   
4. 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.

Exigences liées au RSGP et au DSA

L'Union Européenne (UE) a introduit de nouvelles exigences liées au RSGP et au DSA pour les plateformes en ligne, y compris les marketplaces.

Pour votre API Decathlon dans Channable, assurez-vous de remplir les attributs à l'étape Attributs (Marketplaces V1) ou dans l'onglet "Attributs par catégorie" à l'étape Construire (Marketplaces V2) :

• Les attributs avec le préfixe “RSGP-”. Ajoutez les informations par région en fonction du code pays qui fait partie du nom du champ (par exemple De_DE ou Nl_BE).

É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.