Configurer une API vtwonen

1

É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.

2

É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.

3

Étape 3 : Créez vos annonces produits

Suivez ces étapes pour configurer votre canal.

1

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

2

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

3

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

4

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

5

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

4

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

5

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é.

6

É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.

7

É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.