> 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-worten.md). # Configuration d'une API Worten {% 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 %} Worten est une entreprise digitale, disposant également de 240 magasins physiques, qui se concentre sur le Portugal et l'Espagne. Ils vendent des appareils ménagers, des produits informatiques, des télécommunications, du son et de l'image, et du divertissement, et ils ont investi, plus récemment, dans l’offre de jouets, produits de beauté, maison & santé, sport, livres, maison & décoration, bricolage & jardin, et même des produits pour animaux de compagnie. {% stepper %} {% step %} ### Ajouter une nouvelle connexion Worten L'API Worten utilise la plateforme Mirakl, ce qui signifie que vous aurez besoin d'un compte Mirakl pour commencer à envoyer vos annonces produits à Worten. Lorsque vous disposez d'un compte Mirakl Worten, allez dans "Connexions > Ajouter une connexion". Cliquez sur "+ Ajouter une nouvelle connexion" et vous verrez un écran où vous pouvez sélectionner Worten. Remplissez le libellé de votre connexion, par exemple Worten. Puis cliquez sur "Connecter avec Worten". Vous serez redirigé 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. | [![Worten add connection.png](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/qS7k0idbxNmv3qxOzy3Y/13880231501842)](https://helpcenter.channable.com/hc/article_attachments/13880231501842) | [![Mirakl API - Worten.png](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/H6DtQzh3lM5W81aJ8gjf/21020603799314)](https://helpcenter.channable.com/hc/article_attachments/21020603799314) | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | {% endstep %} | | {% step %} ### Ajouter une nouvelle API Worten dans Channable Allez maintenant à l'aperçu des API dans votre projet. Cliquez sur "+ Ajouter une nouvelle API", sélectionnez la connexion Worten que vous venez de créer et donnez un nom à votre nouvelle API.
Sélectionnez le champ que vous souhaitez utiliser pour **ID unique par produit** (nous recommandons le champ 'id), et le **Langue** dans lequel vous effectuez les catégorisations et configurez les attributs. Cliquez sur "Continuer" pour terminer la création de la nouvelle API Worten. {% hint style="warning" %} Important : Worten 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). La création d'API Worten séparées pour différents pays en utilisant la même connexion ne fonctionnera pas, car ces API se remplaceront mutuellement. {% endhint %} {% endstep %} {% step %} ### Créez vos annonces produits dans Channable Une fois que vous avez créé l'API Worten, vous pouvez configurer 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/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 %} {% endstepper %} {% hint style="warning" %} Comparée aux autres API Mirakl, Worten n'a pas de 'title' dans l'étape de construction. Il existe un « Product Name Pt » qui est défini comme obligatoire par Worten et « Product Name Es » dans l'étape Attributs de l'API. La description pour les deux langues doit être remplie dans l'étape de construction. {% endhint %} {% hint style="success" %} **Conseil :** Survolez :circle-question: pour plus d’informations sur les exigences spécifiques à chaque champ. {% endhint %} {% stepper %} {% step %} Dans l'étape de construction, vous trouverez également l'onglet Canaux de vente où vous pouvez renseigner vos informations de tarification pour chaque canal de vente séparé sur Worten. Plus d'informations sur ces canaux de vente sont disponibles ici : [Configuration des canaux de vente Mirakl](/list-advertise/list-and-advertise-fr/vendre-sur-les-marketplaces/marketplaces-mirakl/configuration-des-canaux-de-vente-mirakl.md) {% endstep %} {% endstepper %} {% endstep %} {% step %} ### Exigences GPSR et DSA L'Union européenne (UE) a introduit de nouvelles [Exigences GPSR et DSA](/list-advertise/list-and-advertise-fr/vendre-sur-les-marketplaces/premiers-pas-avec-les-marketplaces/ce-que-vous-devez-faire-pour-etre-conforme-au-gpsr-et-au-dsa.md) pour les plateformes en ligne, y compris les places de marché. Pour votre API Worten dans Channable, veillez à remplir le spécifique par catégorie **Attributs par catégorie** onglet dans le **La étape** étape : * **Adresse e-mail de la personne responsable dans l'UE :** Saisissez l'adresse e-mail de la personne responsable dans l'UE. * **Adresse postale de la personne responsable dans l'UE :** Indiquez l'adresse postale de la personne responsable dans l'UE. * **Nom de la personne responsable dans l'UE :** Saisissez le nom de la personne responsable dans l'UE. {% hint style="info" %} Ces attributs sont requis pour se conformer aux obligations du GPSR et du DSA pour les places de marché au sein de l'UE. {% endhint %} {% endstep %} {% step %} ### Envoyez vos produits à Worten Presque prêt, vos annonces produits sont prêtes à être envoyées. Si vous n'avez pas activé votre projet, allez dans les paramètres du projet sur la gauche de l'écran et cliquez sur « activer le projet ». Ensuite, revenez à l'aperçu des API et allez dans "Votre nom d'API Worten > Paramètres", où vous activez l'API en sélectionnant "Activer l'API". Après avoir complété cette étape, revenez à l'aperçu des API et cliquez sur le bouton bleu "Exécuter maintenant" pour envoyer vos annonces produits à Worten. {% endstep %} {% step %} ### Vérifiez vos annonces produits pour détecter les erreurs Après avoir envoyé vos annonces produits à Worten, allez à l'onglet Résultats de votre API Worten. Cliquez dans le filtre sur 'erreur'. Vous pouvez maintenant voir quelles annonces produits présentent des erreurs et ne sont pas publiées. Cliquez sur une erreur spécifique pour voir plus d'informations sur la cause de l'erreur. Si vous avez résolu certaines erreurs en modifiant les paramètres ou les informations produits, relancez l'API Worten pour voir les nouveaux résultats. {% endstep %} {% endstepper %} ### 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" %} ID produit du vendeur pour produits simples/à l'unité : 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 Mirakl Marketplace, les modes d'emploi et les bonnes pratiques, consultez [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-worten.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.