# Configurer une API vtwonen {% stepper %} {% step %} ### Étape 1 : Créez une nouvelle connexion * Accédez à **\[Votre projet] > Canaux**. * Cliquez **+Ajouter une nouvelle API**. Cela vous redirigera vers la page des connexions de votre entreprise. * Sur la page des connexions, sélectionnez **+Ajouter une nouvelle connexion.** * Recherchez la connexion "vtwonen" en parcourant les pages et sélectionnez-la en cliquant dessus. * Ajoutez un libellé. * Cliquez **Créer**. Vous serez redirigé vers vtwonen pour l'étape suivante. * Une fois redirigé, connectez-vous avec vos identifiants vtwonen. Après une connexion réussie, la connexion avec vtwonen est prête. Ensuite, vous serez renvoyé vers la configuration de l'API. {% endstep %} {% step %} ### Étape 2 : Créez l’API Une fois votre connexion créée, vous devez sélectionner votre nouvelle connexion vtwonen et configurer les paramètres de votre API : * Dans la section **Nom** champ, saisissez un nom pour votre API. * Choisissez la **ID unique par produit** dans le menu déroulant. Nous recommandons le champ 'id'. * Sélectionnez **Langue** pour votre API. * Cliquez **Continuer** pour créer votre API vtwonen. {% endstep %} {% step %} ### Étape 3 : Créez vos annonces produits 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 bonne catégorie. * Produits non catégorisés : Produits qui doivent encore être revus 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 ajuster pour votre cas d’usage. * Configuration des règles : Configurez des règles pour affiner vos données produits. Cela peut inclure le filtrage, la modification ou l’enrichissement des champs pour répondre aux exigences du marché. [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 applicables à l'ensemble de vos produits, tels que l'EAN, les prix et les titres. Cette étape garantit l'uniformité des informations de base de vos produits sur vos annonces. * Utiliser des valeurs statiques ou dynamiques : * Valeurs statiques : valeurs fixes qui ne changent pas (par ex. nom de la marque, fabricant) * Valeurs dynamiques : champs qui changent automatiquement en fonction des données liées (par ex. stock, prix) Attributs spécifiques à une catégorie * Les attributs spécifiques à une catégorie sont des champs qui s'appliquent spécifiquement à la catégorie de vos produits. Cette étape permet d'affiner vos annonces pour répondre aux exigences de catégorie du marketplace. * Complétez les attributs spécifiques à la catégorie sélectionnée (par ex. la taille pour les vêtements ou les dimensions pour les meubles). [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 le **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 le **Toutes les catégories** menu déroulant et sélectionnez la catégorie par laquelle vous souhaitez filtrer. Avant de continuer : * Vérifiez les attributs partagés : Assurez-vous que tous les attributs partagés obligatoires sont remplis. * Vérifiez les attributs spécifiques à la catégorie : Assurez-vous que tous les attributs obligatoires propres à la catégorie sont remplis. * Vérifiez 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 %} {% endstep %} {% step %} ### Exigences supplémentaires pour vtwonen Ces exigences d'attributs sont spécifiques à vtwonen et s'appliquent aux attributs dans l' **La étape** . onglet Attributs partagés * Classe d'expédition (classe logistique) : Les classes logistiques déterminent les coûts d'expédition correspondants pour vos produits. Indiquez la classe logistique de votre produit. * Délai d'expédition : Le délai d'expédition indique le temps nécessaire jusqu'à la remise du colis au transporteur. Indiquez le délai d'expédition en jours. Exigences pour le titre Les titres de produit doivent comprendre les éléments suivants : | | | | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------- | | **Marque** | Le nom de la marque tel qu'il est enregistré | | **Type de produit** | La catégorie du produit, par exemple « sofa ». Elle doit être écrite en minuscules | | **Nom de la série/du produit** | Le nom de la série ou du produit qui aide à identifier la variante du produit. Chaque mot doit commencer par une majuscule | | **Attributs** | Les caractéristiques distinctives du produit, par exemple couleur, dimensions ou matériau | * Structure : Marque Type de produit Nom - Attributs * Exemple : suspension vtwonen Titan - noir. Description du produit Les descriptions produits pour votre API vtwonen doivent : * s'adresser au client (« vous » et « votre ») * être rédigées dans un ton convivial, utile et respectueux * éviter le jargon ou les termes techniques, si cela est pertinent pour le public cible * décrire les caractéristiques du produit ainsi que les bénéfices et l'expérience * utiliser des mots-clés pertinents * ne pas contenir d'abréviations Les descriptions produits doivent comprendre les éléments suivants : | | | | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Description courte** | Un aperçu du produit mettant en avant les caractéristiques les plus importantes. Le HTML n'est pas autorisé | | **Points à puces** | Les caractéristiques et avantages clés du produit. Minimum 3 et maximum 5 points | | **Description longue** | Informations détaillées sur les caractéristiques, spécifications, matériaux et utilisation du produit. Également des conseils de style et d'entretien. Le HTML est autorisé (gras et listes) | Exigences relatives aux images | | | | -------------------------- | --------------------------------------------- | | **Résolution minimale** | 800 x 800 px | | **Résolution maximale** | 4472 x 4472 px | | **Formats pris en charge** | JPEG, PNG, WebP, GIF | | **Style** | Pas de filigranes, logos ou éléments textuels | Exigences vidéo | | | | -------------------------- | ------------------------------------------------------------------------- | | **Durée** | Entre 30 s et 2 min | | **Résolution** | 1080p ou supérieure | | **Formats pris en charge** | .mp4, .mov, .avi, .flv | | **Style** |

Pas de bordures, croquis, filigranes, logos,
étiquettes ou prix

| | {% endstep %} | | {% step %} ### 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/hc/en-us/articles/360012678720-Mirakl-guide-settings-and-solutions). {% endstep %} {% step %} ### Étape 4 : Envoyez vos annonces produits à vtwonen Une fois vos annonces produits prêtes, vous devez les envoyer à vtwonen : * Si vous n'avez pas activé votre projet, allez dans **\[Votre projet] > Paramètres** et cliquez **Activer le projet**. * Dans **\[Votre projet] > APIs**, allez à **\[Votre vtwonenAPI] > Paramètres**. * Cliquez **Activer l'API**. * Une fois l'API activée, revenez à **APIs**. * Cliquez sur **Exécuter maintenant** bouton dans la colonne 'Statut' pour envoyer vos annonces produits à vtwonen. {% endstep %} {% step %} ### Étape 5 : Vérifiez vos annonces produits pour détecter les erreurs * Pour vérifier les erreurs, allez à la **Résultat > onglet Erreurs**. Ici se trouve la liste des annonces produits qui contiennent des erreurs. * Cliquez sur l'erreur spécifique pour afficher plus d'informations sur la cause de l'erreur. {% endstep %} {% endstepper %}