Dans cet article, nous expliquons comment configurer l'API Kruidvat dans Channable. Kruidvat est une chaîne de pharmacies aux Pays-Bas et en Belgique. Vous configurez l'API Kruidvat en suivant les étapes suivantes de cet article :
Étape 1 : Ajouter une nouvelle connexion Kruidvat
Étape 2 : Créer une nouvelle API Kruidvat dans Channable
Étape 3 : Créez vos annonces produits dans Channable
Etape 4 : Envoyez vos produits à Kruidvat
Étape 5 : Vérifiez que vos annonces produits pour détecter des erreurs
Étape 1 : Ajouter une nouvelle connexion Kruidvat
L'API Kruidvat utilise la plateforme Mirakl, ce qui signifie que vous aurez besoin d'un compte Mirakl pour commencer à envoyer vos annonces produits à Kruidvat.
Lorsque vous disposez d'un compte Mirakl Kruidvat, allez dans le menu "[Votre entreprise] > Connexions". Cliquez sur "+ Ajouter une nouvelle connexion" puis vous verrez un écran où vous pouvez sélectionner Kruidvat. Remplissez le nom de votre connexion. Cliquez ensuite sur ''Connecter avec Kruidvat''. 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 : Créer une nouvelle API Kruidvat dans Channable
Naviguez jusqu'à l'onglet APIs de votre projet et sélectionnez + Ajouter nouvelle API. Sélectionnez la connexion Kruidvat que vous venez de créer et donnez un nom à la nouvelle API.
Sélectionnez le champ que vous souhaitez utiliser comme ID unique par produit (nous recommandons le champ "id"), et sélectionnez la Langue pour les catégories et les attributs à configurer. En outre, vous avez la possibilité d'inclure un groupe de règles générales si vous le souhaitez. Cliquez sur "Sauvegarder" pour terminer la création de la nouvelle API Kruidvat.
Étape 3 : Créez vos annonces produits dans Channable
Une fois que vous avez créé l'API Kruidvat, vous pouvez créer vos annonces produits en suivant les étapes ci-dessous dans l'API.
-
Catégories
Pour que vos annonces soient créées, vos produits ont besoin d'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 vos données produits. Par exemple, jetez un coup d'œil à notre article de support sur les règles les plus souvent utilisées.
-
Construire
Ci-dessous, vous trouverez notre modèle prédéfini pour les annonces produits. Tout ce que vous avez à faire est de connecter vos données produits à celles attendues par la marketplace. Par exemple, le champ "Stock" devrait afficher le stock de votre produit et ainsi de suite. Lorsque vous avez terminé de configurer les annonces produits, cliquez simplement sur "Sauvegarder" au bas de l'écran.
Astuce ! Notez que si vous passez votre souris sur le point d'interrogation derrière chaque champ, vous verrez la description de ce qui est attendu par la marketplace et des suggestions de valeurs possibles. -
Attributs
Bientôt fini ! La prochaine étape consiste à remplir les champs à l'étape Attributs. Sélectionnez la catégorie que vous voulez optimiser en premier. Vous pouvez trouver un exemple de ce qui devrait apparaître dans la capture d'écran ci-dessous. Pour une explication plus détaillée de la section "Attributs", vous pouvez consulter cet article.
Étape 4 : Envoyez vos produits à Kruidvat
Vous y êtes presque, vos annonces produits sont prêtes à être envoyées. Si vous n'avez pas activé votre projet dans Channable, allez dans l'onglet "Paramètres > Paramètres de projet > Activer le projet". Ensuite, retournez sur l'onglet APIs et cliquez sur "Paramètres" de votre API Kruidvat nouvellement créée. Activez l'API en sélectionnant "Activer API". Une fois cette étape terminée, retournez sur l'onglet APIs et cliquez sur le bouton bleu "Exécuter" pour envoyer vos annonces produits à Kruidvat.
Étape 5 : Vérifiez vos annonces produits pour détecter des erreurs
Si vous avez envoyé vos annonces produits à Kruidvat, rendez-vous dans l'onglet Résultat de votre API. Cliquez sur l'onglet "Erreurs" pour voir quelles annonces produits contiennent des erreurs et ne sont pas diffusées correctement sur la marketplace. Cliquez sur une erreur spécifique pour obtenir plus d'informations sur la cause de l'erreur. Si vous avez résolu certaines erreurs en changeant les paramètres ou les informations de vos produits, vous pouvez réexécuter l'API pour voir les nouveaux résultats.
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.
Pour plus d'informations sur les erreurs des marketplaces de Mirakl et les bonnes pratiques à adopter, consultez notre guide dédié.