# Configurer une API Maisons du Monde {% hint style="info" %} **Mise à jour de l'interface :** Vous pouvez désormais trouver les informations d'erreur dans l'onglet **Feedback** (anciennement l'onglet **Erreurs** ) de la **La étape** . {% endhint %} Maisons du Monde est une entreprise française de mobilier et décoration d'intérieur comptant près de 250 magasins en France, Italie, Espagne, Luxembourg, Belgique, Allemagne et Suisse. Plus de 190 de ces magasins sont situés en France. {% stepper %} {% step %} ### Ajouter une nouvelle connexion Maisons du Monde Maisons du Monde utilise la plateforme Mirakl, ce qui signifie que vous aurez besoin d'un compte Mirakl pour commencer à envoyer vos annonces produits à Maisons du Monde. Lorsque vous disposez d'un compte Mirakl Maisons du Monde, allez dans « \[Votre entreprise] > Paramètres > Connexions > Ajouter une connexion ». Cliquez sur « + Ajouter une nouvelle connexion » puis sélectionnez Maisons du Monde. Saisissez le libellé de votre connexion, par exemple Maisons du Monde. Cliquez ensuite sur « Connecter avec Maisons du Monde ». Vous serez redirigé vers l'environnement où vous pourrez vous connecter avec vos identifiants Mirakl. Après la connexion, vous reviendrez dans Channable où la connexion sera disponible. | ![Maisons 1.png](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/YAMrWWxmslkPHzV9c9mj/14624671065618) | [![Mirakl API - Worten.png](broken-reference)](https://helpcenter.channable.com/hc/article_attachments/21017891330194) | | -------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | | {% endstep %} | | {% step %} ### Ajouter une nouvelle API Maisons du Monde dans Channable Allez dans la vue d'ensemble des API de votre projet et sélectionnez Ajouter une nouvelle API. Choisissez la connexion Maisons du Monde que vous venez de créer et donnez un nom à la nouvelle API. ![Maisons 2.png](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/JDB546Gzl8U1u8m2DOht/14624660556562) Sélectionnez le champ que vous souhaitez utiliser pour **ID unique par produit** (nous recommandons le champ « id »), et sélectionnez le **Langue** pour la configuration des catégorisations et des attributs. De plus, vous pouvez inclure un groupe de règles générales si vous le souhaitez. Cliquez sur « Continuer » pour terminer la création de la nouvelle API Maisons du Monde. {% hint style="info" %} **Important :** Maisons du Monde offre la possibilité de définir des canaux de vente dans notre API. Si vous souhaitez en savoir plus sur les canaux ou sur la manière de les configurer, veuillez suivre les étapes dans [cet article](https://helpcenter.channable.com/hc/en-us/articles/11883675662482). Il est important de noter que la création d'API Maisons du Monde séparées pour différents pays en utilisant la même connexion ne fonctionnera pas, car les API se remplaceront mutuellement. {% endhint %} {% endstep %} {% step %} ### Créez vos annonces produits dans Channable Suivez ces étapes pour configurer votre canal. {% stepper %} {% step %} #### Catégorisez vos produits Pour configurer vos données produits, affectez des catégories à vos produits. * **Catégorisation des produits par IA :** Attribue automatiquement des catégories de produits via notre algorithme. * **Catégorisation manuelle :** Attribuez manuellement des catégories de produits avec des règles personnalisées. Vous pouvez créer des filtres détaillés pour mapper chaque produit à la catégorie correcte. * **Produits non catégorisés :** Produits qui doivent encore être examinés et catégorisés [En savoir plus sur la catégorisation pour les marketplaces](https://helpcenter.channable.com/list-advertise/list-and-advertise-fr/vendre-sur-les-marketplaces/commencer-avec-les-marketplaces/marketplaces-etape-de-categorisation) {% endstep %} {% step %} #### Configurer des règles Les règles vous aident à optimiser rapidement vos données produits pour la place de marché sur laquelle vous souhaitez vendre. * **Modèles de règles :** Règles couramment utilisées que vous pouvez adapter à votre cas d'usage. * **Configuration des règles :** Définissez des règles pour affiner vos données produits. Cela peut inclure le filtrage, la modification ou l'enrichissement des champs de données pour répondre aux exigences de la marketplace. [En savoir plus sur l'utilisation des règles pour les marketplaces](https://helpcenter.channable.com/list-advertise/list-and-advertise-fr/vendre-sur-les-marketplaces/commencer-avec-les-marketplaces/marketplaces-etape-des-regles) {% endstep %} {% step %} #### Construire vos annonces Le **La étape** l'étape consiste à configurer vos annonces produits pour qu'elles correspondent aux exigences du marketplace. C'est une étape essentielle pour mettre vos produits en ligne et éviter les erreurs. Champs obligatoires et optionnels : * **Champs obligatoires** : Requis pour référencer vos produits sur cette marketplace * **Recommandé** : Recommandé pour éviter des erreurs * **Optionnel** : Non requis pour la mise en ligne Attributs partagés : Les attributs partagés sont les champs communs qui s'appliquent à vos produits, tels que l'EAN, les prix et les titres. Cette étape garantit l'uniformité des informations produit de base sur vos annonces. * **Utiliser des valeurs statiques ou dynamiques** * **Valeurs statiques :** Valeurs fixes qui ne changent pas (par ex. nom de marque, fabricant) * **Valeurs dynamiques :** Champs qui changent automatiquement en fonction des données liées (par ex. stock, prix) Attributs spécifiques à la catégorie : Les attributs spécifiques à la catégorie sont des champs qui s'appliquent précisément à la catégorie de vos produits. Cette étape permet d'affiner vos annonces pour répondre aux exigences de catégorie du marketplace. Remplissez les attributs spécifiques à la catégorie sélectionnée (par ex. taille pour les vêtements ou dimensions pour le mobilier). {% hint style="success" %} Astuce : Cliquez **Auto-map fields** pour mapper automatiquement les catégories avec les informations fournies précédemment dans le même canal. {% endhint %} [En savoir plus sur l'étape Build pour les marketplaces](https://helpcenter.channable.com/list-advertise/list-and-advertise-fr/vendre-sur-les-marketplaces/commencer-avec-les-marketplaces/marketplaces-etape-build) {% endstep %} {% step %} #### Vérifier la qualité de votre configuration Le **Qualité** Cette étape fournit des retours sur votre canal avant son activation. Elle met en évidence les erreurs obligatoires et optionnelles afin de garantir que vos données produits répondent aux exigences pour être listées sur le marketplace. * Corrigez les erreurs, en priorisant d’abord les erreurs obligatoires. Actions : * **Voir les produits** : Voir les produits avec des problèmes spécifiques. * **Voir dans Construire** : Redirige vers le **La étape** pour mapper les informations manquantes. * **Définir les catégories** : Dirige vers le **Catégories** pour catégoriser les produits. * **Afficher la source** : Disponible pour les champs ID. Dirige vers le **Paramètres** . [En savoir plus sur l’étape Qualité pour les marketplaces](https://helpcenter.channable.com/list-advertise/list-and-advertise-fr/vendre-sur-les-marketplaces/commencer-avec-les-marketplaces/marketplaces-etape-qualite) {% endstep %} {% step %} #### Aperçu avant activation Le **Aperçu** L’étape affiche les attributs que vous avez mappés dans l’étape **La étape** , vous aidant à vérifier si tout est correctement configuré en fournissant une vue d’ensemble de vos produits et des erreurs potentielles. Filtrage : * **Filtrer par erreur :** Cliquez sur l’ **Tous** menu déroulant et sélectionnez si vous souhaitez filtrer pour afficher uniquement les produits avec des erreurs, ou les produits avec une erreur spécifique. * **Filtrer par catégorie :** Cliquez sur l’ **Toutes les catégories** menu déroulant et sélectionnez la catégorie par laquelle vous souhaitez filtrer. Avant de continuer : * **Vérifier les attributs partagés** : Assurez-vous que tous les attributs partagés obligatoires sont remplis. * **Vérifier les attributs spécifiques à la catégorie** : Assurez-vous que tous les attributs obligatoires spécifiques à la catégorie sont remplis. * **Vérifier les erreurs** : Corrigez tous les champs marqués en rouge. [En savoir plus sur l’étape Aperçu pour les marketplaces](https://helpcenter.channable.com/list-advertise/list-and-advertise-fr/vendre-sur-les-marketplaces/commencer-avec-les-marketplaces/marketplaces-etape-apercu) {% endstep %} {% endstepper %} ### Informations supplémentaires concernant Maisons du Monde : Les API Mirakl n'ont pas de « titre » à l'étape Construire. Il existe un champ « Product Title » dans l'étape attributs pour connecter le titre ! Canaux de vente : Dans l'étape Construire, vous trouverez également l'onglet *Sales channels* où vous pouvez renseigner vos informations de tarification pour chaque canal de vente séparé sur Maisons du Monde. Plus d'informations sur ces canaux de vente [se trouve ici](https://helpcenter.channable.com/list-advertise/list-and-advertise-fr/vendre-sur-les-marketplaces/marketplaces-mirakl/configurer-des-canaux-de-vente-mirakl). {% endstep %} {% step %} ### Envoyez vos produits à Maisons du Monde Presque prêt, vos annonces produits sont prêtes à être envoyées. Si vous n'avez pas activé votre projet, allez dans *Installation > Paramètres du projet* sur le côté gauche de l'écran et cliquez sur « activer le projet ». Ensuite, revenez à la *APIs* vue d'ensemble et allez dans *« Nom de votre API Maisons du Monde » > Paramètres*, où vous activez l'API en sélectionnant « Activer l'API ». Après avoir complété cette étape, revenez à la *APIs* vue d'ensemble et cliquez sur le bouton bleu « Exécuter maintenant » pour envoyer vos annonces produits à Maisons du Monde. {% endstep %} {% step %} ### Vérifiez vos annonces produits pour détecter les erreurs Après avoir envoyé vos annonces produits à Maisons du Monde, allez dans l'onglet *Résultats* de votre API Maisons du Monde. Cliquez dans le filtre sur « erreur ». Vous pouvez alors voir quelles annonces produits contiennent des erreurs et ne sont pas publiées. Cliquez sur une erreur spécifique pour obtenir plus d'informations sur la cause. Si vous avez corrigé certaines erreurs en modifiant les paramètres ou les informations produit, relancez l'API Maisons du Monde pour voir les nouveaux résultats. #### Bonnes pratiques * Ajout de plusieurs valeurs d'attribut : Lors de l'ajout de plusieurs valeurs dans un champ d'attribut pour les places de marché Mirakl, séparez chaque valeur par un symbole pipe "|" afin d'assurer une détection et un traitement corrects. * ID produit du vendeur pour produits simples/uniques : Il existe deux attributs nommés 'SellerArticleId' et 'SellerProductId'. 'SellerProductId' correspond à l'ID Parent, tandis que 'SellerArticleId' correspond aux variantes. Pour les produits simples, les deux attributs doivent être remplis avec la même valeur. Pour plus d'informations sur les erreurs Mirakl Marketplace, les modes d'emploi et les bonnes pratiques, consultez [notre guide dédié](https://helpcenter.channable.com/list-advertise/list-and-advertise-fr/vendre-sur-les-marketplaces/marketplaces-mirakl/guide-mirakl-parametres-et-solutions). {% endstep %} {% endstepper %}