> For the complete documentation index, see [llms.txt](https://helpcenter.channable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.channable.com/list-advertise/list-and-advertise-fr/vendre-sur-les-marketplaces/places-de-marche-mirakl/configuration-dune-api-manor.md). # Configuration d'une API Manor Manor (Mirakl) — Guide d'installation {% hint style="info" %} **Mise à jour de l’interface :** Il existe une nouvelle page de sélection des canaux et Vue d'ensemble pour **Flux** A **Places de marché** (appelés auparavant API) ! Certaines illustrations et instructions peuvent ne pas être à jour. {% endhint %} {% hint style="warning" %} **Important :** Les codes EAN sont obligatoires pour Manor. Assurez-vous de disposer de codes EAN valides pour tous vos produits, sinon aucune fiche produit ne pourra être créée pour vos produits. {% endhint %} {% stepper %} {% step %} ### Ajouter une nouvelle connexion Manor L'API Manor utilise la plateforme Mirakl, ce qui signifie que vous aurez besoin d'un compte Mirakl pour commencer à envoyer vos fiches produits à Manor. Lorsque vous disposez d'un compte Mirakl Manor, allez dans « Connexions > Ajouter une connexion ». Cliquez sur « + Ajouter une nouvelle connexion » et vous verrez un écran où vous pourrez sélectionner Manor. Remplissez le libellé de votre connexion (par exemple : Manor), puis cliquez sur « Connecter avec Manor ». Vous serez redirigé(e) vers l'environnement où vous pourrez vous connecter avec vos identifiants Mirakl. Après la connexion, vous serez redirigé(e) vers Channable où la connexion sera disponible. | | | | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | [![New\_connection\_-\_Manor.png](/files/59a097aeff709a4355aabe6c4ff25a244a934926)](https://helpcenter.channable.com/hc/article_attachments/7647187429650) | [![Sing\_in\_Mirakl\_-\_Oauth.png](/files/d9931469df82a6940fa42550e5f06f9a1da602f9)](https://helpcenter.channable.com/hc/article_attachments/7647182828946) | | {% endstep %} | | {% step %} ### Créer une nouvelle API Manor dans Channable Allez dans l'aperçu des API de votre projet. Cliquez sur « + Ajouter une nouvelle API », sélectionnez la connexion Manor que vous venez de créer et donnez un nom à votre nouvelle API. [![](/files/97544687f8af9c7fcabc4e137ae4eef7ee1d8958)](https://helpcenter.channable.com/hc/article_attachments/19237568656018) Sélectionnez le champ que vous souhaitez utiliser pour **ID unique par produit** (nous recommandons le champ 'id), et le **Langue**. Vous devrez sélectionner la langue que vous souhaitez utiliser pour l'API car la Suisse propose 3 langues officielles au choix (allemand, français et italien). Après avoir choisi un nom, cliquez sur le bouton « Continuer » pour créer votre nouvelle API Manor. {% endstep %} {% step %} ### Créez vos annonces produits dans Channable Une fois que vous avez créé l'API Manor, configurez vos données produits en suivant les étapes de l'API. {% stepper %} {% step %} #### Catégories Pour que vos fiches produits soient créées, vos produits ont besoin d’une catégorie. Ajoutez des catégories A vos produits en utilisant le [fonction Auto-générer des catégories](/manage-improve-product-data/manage-product-and-improve-data-fr/categoriser-les-produits/creer-des-categories-de-produits/utilisez-la-fonction-auto-generer-des-categories.md) ou [Créer de nouvelles catégories à partir de zéro](/manage-improve-product-data/manage-product-and-improve-data-fr/categoriser-les-produits/creer-des-categories-de-produits/ajouter-des-categories-manuellement.md). {% endstep %} {% step %} #### Règles Créer [différentes règles](/manage-improve-product-data/manage-product-and-improve-data-fr/regles-modification-en-masse-et-enrichissement/utiliser-les-regles.md) A optimiser vos fiches produits. {% endstep %} {% step %} #### Créer - Attributs partagés Les attributs partagés sont des attributs qui s'appliquent à tous vos Produits, comme le prix et le stock. 1. Commencez par Map fields aux attributs marqués comme obligatoires par la marketplace. 2. Vérifiez les attributs restants et Map fields A ceux qui sont pertinents pour votre activité. 3. Cliquez **Sauvegarder**. {% endstep %} {% step %} #### Créer - Attributs par catégorie Les attributs de catégorie sont des attributs qui s'appliquent aux Produits de Catégories spécifiques, comme les informations sur la batterie pour les Produits électroniques, ou les informations de taille pour les vêtements. 1. Commencez par Map fields aux attributs marqués comme obligatoires par la marketplace. 2. Vérifiez les attributs restants et Map fields A ceux qui sont pertinents pour votre activité. 3. Cliquez **Sauvegarder**. {% endstep %} {% endstepper %} {% endstep %} {% step %} ### Envoyez vos données produits à Manor Si vous n'avez pas activé votre projet, allez dans les paramètres de votre projet sur la gauche de l'écran et cliquez sur « activer le projet ». Puis revenez dans Canaux et allez dans Votre canal Manor > Paramètres, et activez le canal en sélectionnant « Activer l'API ». À partir de là, cliquez **Exécuter maintenant** pour envoyer vos fiches. {% endstep %} {% step %} ### Vérifiez vos annonces produits pour détecter les erreurs Après avoir envoyé vos fiches produits à Manor, rendez-vous dans l'onglet Aperçu de votre API Manor. Cliquez/filtrez sur « erreur ». Vous pouvez voir quelles fiches produits présentent des erreurs et n'ont pas été créées dans Manor. Cliquez sur une erreur spécifique pour voir plus d'informations. {% endstep %} {% endstepper %} ### 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 les produits simples/isolés : Il existe deux attributs nommés respectivement « SellerArticleId » et « SellerProductId ». « SellerProductId » fait référence à l'ID parent, tandis que « SellerArticleId » fait référence 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é](/list-advertise/list-and-advertise-fr/vendre-sur-les-marketplaces/places-de-marche-mirakl/guide-mirakl-parametres-et-solutions.md). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://helpcenter.channable.com/list-advertise/list-and-advertise-fr/vendre-sur-les-marketplaces/places-de-marche-mirakl/configuration-dune-api-manor.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.