> 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/marketplaces-mirakl/configuration-dune-api-obelink.md). # Configuration d'une API Obelink Obelink est l'un des plus grands magasins de camping avec une large gamme de tentes, caravanes, camping-cars, fournitures de camping, accessoires, mobilier de jardin et articles de sport. Cet article détaille les étapes de configuration d'une API Obelink dans l'outil Channable. {% 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 %} ### Ajouter une nouvelle connexion Obelink L'API Obelink utilise la plateforme Mirakl, ce qui signifie que vous aurez besoin d'un compte Mirakl pour commencer à envoyer vos annonces produit à Obelink. Lorsque vous disposez d'un compte Mirakl Obelink, allez dans « Paramètres de \[Votre entreprise] > Connexions > Ajouter une connexion ». Cliquez sur « + Ajouter une nouvelle connexion » et sélectionnez Obelink. Remplissez le libellé de votre connexion (par exemple, Obelink). Cliquez ensuite sur « Connecter avec Obelink ». Vous serez redirigé vers l'environnement où vous pourrez vous connecter avec vos identifiants Mirakl. Après la connexion, vous serez redirigé vers Channable où la connexion sera disponible. | | | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [![EN - Obelink API 1.jpg](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/y5flnQ9hLHMiHKpjkcJP/14526820787858)](https://helpcenter.channable.com/hc/article_attachments/14526820787858) | [![Sing in Mirakl - Oauth.png](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/w7Ia6J7Ic3G82F60MXJK/14526657327378)](https://helpcenter.channable.com/hc/article_attachments/14526657327378) | ### Ajouter une nouvelle API Obelink dans Channable Allez à la vue d'ensemble des APIs dans votre projet et cliquez sur Ajouter une nouvelle API. Sélectionnez la connexion Obelink que vous venez de créer et donnez un nom à votre nouvelle API. Sélectionnez le champ que vous souhaitez utiliser pour l'ID unique par produit (nous recommandons le champ « id ») et la langue dans laquelle vous effectuez les catégorisations et définissez les attributs. Vous pouvez également ajouter ici un groupe de règles générales si vous le souhaitez. Cliquez sur Continuer pour terminer la création de la nouvelle API Obelink. ### Créez vos annonces produits dans Channable Une fois l'API Obelink créée, configurez vos données produit 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/utiliser-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-et-enrichissement-en-masse/utiliser-des-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 %} {% step %} Sous **Valeurs statiques pour la classe d'expédition** il y a 3 valeurs. Dans le tableau ci-dessous, vous trouverez ces valeurs et leurs explications : | Code | Libellé | Explication | | ---- | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | | SP | Petit colis | Poids max 3 kg ; longueur max 50 cm et circonférence max (2xL + 2xH + 1xP) de 111 cm | | NP | Colis normal | Poids max 31,5 kg ; longueur max 175 cm et circonférence max (2xL + 2xH + 1xP) de 300 cm | | NSP | Colis non standard | Le colis a une longueur ou une diagonale supérieure à 130 cm ; et/ou un poids >35 kg ; et/ou une forme instable ou irrégulière (sphère, cylindre, rouleau) | | | | | Si cette valeur diffère pour certains produits, vous pouvez remplir dynamiquement ce champ. Remarques : * Obelink dispose également d'un champ d'offre supplémentaire appelé Supplier SKU. Certains partenaires exigent cet attribut pour finaliser la commande. Ce champ est ajouté comme champ d'offre supplémentaire à l'étape Construire. Si vous avez un Supplier SKU, renseignez-le ici ; sinon, vous pouvez le laisser vide. * Obelink possède plusieurs canaux de vente : obelink.nl, obelink.be et obelink.de. Ils ne prennent pas en charge la tarification spécifique aux canaux, donc la fenêtre de sélection de canal sur la page des paramètres de l'API et l'onglet supplémentaire dans l'étape Construire ne sont pas affichés. Les canaux doivent être activés/désactivés dans votre back-end Mirakl. [ici ](https://marketplace-obelink.mirakl.net/mmp/shop/account/channel)ou allez dans Paramètres > Partenaire > Canaux {% endstep %} {% step %} ### Attributs Remplissez les champs à l'étape Attributs. Ceci est important lors de la vente de nouveaux produits qui n'existent pas encore sur la marketplace — cela aide à éviter le mirakl\_unknown\_error\_code. Sélectionnez d'abord la catégorie que vous souhaitez optimiser. Une explication plus détaillée de ce qu'il faut faire à l'étape Attributs est disponible ici : [Marketplaces : étape de construction](/list-advertise/list-and-advertise-fr/vendre-sur-les-marketplaces/premiers-pas-avec-les-marketplaces/marketplaces-etape-de-construction.md) {% endstep %} {% endstepper %} ### Envoyez vos produits à Obelink 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 vue d'ensemble des APIs, ouvrez « Votre nom d'API Obelink > Paramètres » et activez l'API en sélectionnant Activer l'API. Après cela, revenez à la vue d'ensemble des APIs et cliquez sur le bouton bleu « Exécuter » pour envoyer vos annonces produit à Obelink. ### Vérifiez vos annonces produits pour détecter les erreurs Après avoir envoyé vos annonces produit à Obelink, allez dans l'onglet Résultats de votre API Obelink. Utilisez le filtre sur « erreur » pour voir quelles annonces produit présentent des erreurs et ne sont pas publiées. Cliquez sur une erreur spécifique pour voir plus d'informations sur la cause. Si vous corrigez des erreurs en modifiant les paramètres ou les informations produit, relancez l'API Obelink pour voir les résultats mis à jour. La création de nouveaux produits entraîne souvent des erreurs dans l'onglet Résultats jusqu'à leur approbation par Obelink. ### Bonnes pratiques {% hint style="info" %} 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. {% endhint %} {% hint style="info" %} Identifiant produit du vendeur pour produits simples : Il existe deux attributs nommés SellerArticleId et SellerProductId. SellerProductId fait référence à l'ID parent, tandis que SellerArticleId se réfère aux variantes. Pour les produits simples, les deux attributs doivent être remplis avec la même valeur. {% endhint %} Pour plus d'informations sur les erreurs de la marketplace Mirakl, les guides pratiques et les bonnes pratiques, consultez le guide Mirakl : [Guide Mirakl : paramètres et solutions](/list-advertise/list-and-advertise-fr/vendre-sur-les-marketplaces/marketplaces-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/marketplaces-mirakl/configuration-dune-api-obelink.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.