Home24 est un détaillant de meubles et d'articles de décoration en ligne qui opère principalement en Europe et en Amérique latine. L'entreprise propose une large gamme de produits pour la maison, y compris des meubles, des accessoires pour la maison et des articles de jardin. Ceci est un guide sur la façon dont vous pouvez mettre en place une API dans Channable pour la marketplace Home24.
Préparation
- L'API home24 est capable de se connecter aux marchés allemand, autrichien, suisse et français.
- Home24 est une plateforme basée sur Mirakl, ce qui signifie que vous aurez besoin d'un compte Mirakl pour commencer à envoyer vos listes de produits à Home24.
- Les codes EAN sont obligatoires pour home24, assurez-vous d'avoir des codes EAN valides pour tous vos produits, sinon aucune annonce produit ne pourra être créée pour vos produits.
Étape 1 : Créer la connexion
1. Commencez par vous rendre sur la section APIs de votre projet et cliquez sur le bouton "+Ajouter nouvelle API". Vous serez redirigé(e) vers la page des connexions de votre entreprise.
2. Sur la page des connexions, sélectionnez "+Ajouter une nouvelle connexion".
3. Recherchez la connexion "Home24" dans la barre de recherche. Après avoir trouvé la connexion "Home24", donnez un nom à cette nouvelle connexion.
4. Cliquez sur "Connecter avec Home24". Vous serez redirigé(e) vers Home24/Mirakl pour l'étape suivante. Une fois redirigé(e), connectez-vous à l'aide de vos identifiants Mirakl.
Après avoir réussi à vous connecter, la connexion avec Home24 est maintenant établie et disponible ! Vous reviendrez à la configuration de l'API.
Étape 2 : Créer l'API
Une fois fait, vous devez sélectionner votre nouvelle connexion avec Home24 et continuer à configurer votre API.
- Donnez un nom à votre API.
- Sélectionnez le champ que vous souhaitez utiliser pour "Unique ID par produit" (nous recommandons le champ 'id') et la "Langue" dans laquelle vous souhaitez vendre vos produits.
Vous pouvez également ajouter un groupe de règles principales si vous le souhaitez.
Cliquez sur "Continuer" pour terminer la création de la nouvelle API Home24.
Étape 3 : Créez vos listes de produits dans Channable
Une fois que vous avez créé l'API Home24, vous pouvez créer vos listes de 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.
Eco-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 EPR disponibles.
-
Attributs
Bientôt fini ! Il s'agit maintenant de remplir les champs de l'étape Attributs. Une explication détaillée de ce qu'il faut faire à l'étape Attributs peut être trouvée dans notre article sur les Attributs.
Étape 4 : Activation de l'API et vérification des erreurs
Vous y êtes presque, vos annonces produits sont prêtes à être envoyées. Si vous n'avez pas activé votre projet, allez dans les paramètres de votre projet sur le côté gauche de l'écran et cliquez sur "activer le projet".
Revenez ensuite à la vue d'ensemble des APIs et allez sur [Votre API home24] > Paramètres, où vous activez l'API en cliquant sur "Activer API".
Une fois l'API activée, revenez à l'aperçu des APIs et cliquez sur le bouton bleu "Exécuter" pour envoyer vos produits sur Home24.
Pour vérifier s'il y a des erreurs, rendez-vous sur la page des Résultats de l'API > onglet Erreurs, où vous verrez quels produits ont des erreurs. En cliquant sur une erreur spécifique, vous obtiendrez plus d'informations sur la cause de l'erreur. Pour plus d'informations sur la signification des erreurs, consultez cet article.
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é.