But est une chaine de magasins française spécialisée dans les meubles, la décoration intérieure et les équipements pour la maison. Ils offrent une large gamme de produits abordables, y compris des produits high-tech et des appareils électroménagers.
Table des matières
- Créer une nouvelle connexion
- Créer l'API
- Créer vos annonces produits
- Envoyer vos annonces produits à But
- Vérifier les erreurs de vos annonces
Étape 1 : Créer une nouvelle connexion
Pour créer une nouvelle connexion avec But, suivez les étapes ci-dessous :
- Commencez par naviguer vers la page API de votre projet et cliquez sur le bouton "+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 "But" parmi les connexions disponibles. Une fois la connexion "But" trouvée, nommez cette nouvelle connexion.
- Cliquez sur "Se connecter avec But". Vous serez redirigé(e) vers But pour l'étape suivante. Une fois redirigé(e), connectez-vous en utilisant vos identifiants But.
Après vous être connecté(e) avec succès, la connexion avec But est établie et prête à être utilisée ! Vous serez ramené(e) à la configuration de l'API.
Étape 2 : Créer l'API
Une fois de retour dans Channable, sélectionnez votre nouvelle connexion avec But et poursuivez la configuration de votre API.
-
Configurer les paramètres de l'API:
- Nommez l'API
- Choisissez l'ID unique par produit. (nous recommandons le champ "id")
- Sélectionnez la langue de votre API
- Créer l'API : Cliquez sur "Continuer" pour créer la nouvelle API But.
Étape 3 : Créer vos annonces produits
Pour configurer votre API, suivez les étapes décrites ci-dessous. Cliquez sur chaque étape pour afficher les instructions détaillées, qui vous guideront tout au long du processus.
1. Catégorisation
Pour que vos données produit soient créées, vos produits ont besoin d'une catégorie. Ajoutez des catégories à ces derniers en utilisant la fonction de génération de catégories, ou créez de nouvelles catégories à partir de zéro.
- Smart Categorization : Cette fonction attribue automatiquement des catégories à vos produits sur la base de critères prédéfinis, ce qui simplifie le processus de catégorisation.
- Catégorisation manuelle : Attribuez manuellement des catégories à vos produits en définissant des règles spécifiques. Vous pouvez créer des filtres détaillés pour associer chaque produit à la bonne catégorie.
- Produits non catégorisés : Examinez et catégorisez tous les produits qui ne le sont pas encore afin de vous assurer qu'ils sont tous correctement organisés.
Cliquez ici pour en savoir plus sur la catégorisation dans les APIs.
2. Règles
Créez différentes règles pour optimiser les données relatives à vos produits. Pour des exemples, reportez-vous à notre article d'aide sur les règles les plus courantes.
- Configuration des règles : Définissez diverses règles pour affiner les données relatives à vos produits. Il peut s'agir de filtrer, de modifier ou d'améliorer les champs de données pour répondre aux exigences de la marketplace.
Cliquez ici pour en savoir plus sur la mise en place de règles dans les APIs.
3. Construire
L'étape Construire dans Channable vous permet de configurer tous les attributs nécessaires pour vos produits, en veillant à ce que les données soient conformes aux exigences de la marketplace. Cette étape est cruciale pour réussir la mise en ligne des produits et pour éviter les erreurs.
3.1 Vue d'ensemble
- Accéder à l'étape Construire : Commencez par accéder à l'interface centralisée de l'étape Construire. C'est là que vous gérerez et attribuerez tous les attributs du produit.
- Identifier les champs obligatoires et optionnels : Les champs obligatoires sont indiqués en rose, ce qui indique qu'ils sont essentiels pour la mise en ligne de vos produits. Les champs optionnels sont marqués en jaune et peuvent être remplis en fonction de besoins spécifiques.
3.2 Renseigner les attributs partagés
-
Renseigner les attributs partagés : Saisissez les détails communs qui s'appliquent à tous les produits, tels que l'EAN, les prix et les titres. Cette étape garantit l'uniformité des informations de base sur les produits dans l'ensemble de vos annonces produits.
-
Utiliser des valeurs statiques ou dynamiques :
- Valeurs statiques : Saisissez directement des valeurs qui restent constantes, comme le nom de la marque ou du fabricant.
- Valeurs dynamiques : Utilisez des champs qui se mettent automatiquement à jour en fonction des données liées, ce qui est idéal pour les variables telles que les niveaux de stock ou les prix.
-
Utiliser des valeurs statiques ou dynamiques :
Après avoir indiqué les valeurs souhaitées pour les attributs partagés, passez aux attributs par catégorie ci-dessous.
3.3 Spécifier des attributs par catégorie
- Sélectionner une catégorie de produits : Choisissez la catégorie correspondant à votre produit, par exemple vêtements ou meubles.
- Catégorie - attributs spécifiques : Renseignez les attributs spécifiques à la catégorie sélectionnée, tels que la taille pour les vêtements ou les dimensions pour les meubles. Cette étape permet d'affiner vos annonces en fonction des exigences de la catégorie. Ici encore, vous pouvez utiliser des valeurs statiques ou dynamiques.
Cliquez ici pour en savoir plus sur l'étape Construire de vos APIs.
4. Qualité
L'étape Qualité fournit un retour d'information instantané sur la qualité de la configuration, en mettant en évidence les erreurs obligatoires et optionnelles afin de garantir que les données relatives à vos produits répondent aux normes des marketplaces.
Actions
- Voir les produits : Pour voir les produits présentant des problèmes spécifiques.
- Voir dans Construire : Redirige vers l'étape Construire pour lier les informations manquantes.
- Catégoriser : Renvoie à l'étape Catégorisation pour classer les produits.
- Source : Disponible pour les champs IDs, dirige vers l'étape Paramètres.
Cliquez ici pour en savoir plus sur l'étape Qualité de vos APIs.
5. Aperçu
L'étape Aperçu affiche les attributs mappés de plusieurs produits et met en évidence les erreurs avant l'export vers la marketplace.
Caractéristiques
- Rechercher et filtrer : Recherchez des produits spécifiques ou filtrez par message d'erreur/catégorie.
- Vue d'ensemble des produits : Affiche tous les produits à exporter; elle peut être filtrée pour n'afficher que les produits comportant des erreurs.
- Aperçu détaillé du produit : Affiche les informations manquantes et les actions pour corriger les erreurs.
Checklist pour la finalisation des attributs
- Examiner les attributs partagés : Assurez-vous que tous les attributs partagés obligatoires sont remplis.
- Examiner les attributs par catégorie : Veillez à ce que tous les attributs obligatoires spécifiques à chaque catégorie soient remplis.
- Vérifier les erreurs : Corrigez les champs indiqués en rouge.
Cliquez ici pour en savoir plus sur l'étape Aperçu de vos APIs.
6. Résultat
L'étape Résultat fournit une vue d'ensemble des résultats de la configuration de l'API, y compris les annonces correctes, les erreurs et un aperçu des produits envoyés. Cette étape permet de s'assurer que vos données produits sont correctement traitées et d'identifier les problèmes à résoudre.
- Vue d'ensemble : Indique l'état de vos annonces produits, en mettant en évidence les erreurs et les problèmes pour obtenir des informations détaillées.
- Aperçu des produits : Affiche une vue d'ensemble des produits à envoyer à la marketplace, permettant de vérifier que les attributs sont correctement remplis.
- Correctes : Liste des produits traités avec succès et prêts à être diffusés sur la plateforme.
- Erreurs : Identifie les erreurs en fournissant des informations détaillées pour les résoudre.
Les onglets supplémentaires tels que les erreurs de Repricer, l'historique des événements du Repricer, les mises à jour des stocks et les mises à jour de l'exécution des commandes n'apparaissent que s'ils sont pertinents pour l'API que vous utilisez. Cliquez ici pour en savoir plus sur l'étape Résultat de vos APIs.
Exigences supplémentaires pour But
Les informations suivantes sont spécifiques à But et incluent des détails concernant l'onglet Produit et des exigences supplémentaires.
Onglet Produit
-
Catégorie d'envoi (classe logistique) : Les classes logistiques déterminent les coûts d'expédition respectifs de vos produits. Saisissez la classe logistique de votre produit.
- Délai d'expédition : Le délai d'expédition indique le temps nécessaire jusqu'à ce que le colis soit remis au transporteur. Indiquez le délai d'expédition en jours.
- Éco-participation : La France a introduit une législation pour l'éco-participation. Si votre entreprise opère en France, vous devez ajouter les éco-contributions à vos offres sur la marketplace. Dans cet article, vous pouvez trouver une liste des catégories EPR disponibles.
- Prix excl. TVA : Indiquez la TVA, et définissez la valeur à "20".
- Taxe pour copie privée : En France, la redevance pour copie privée est une obligation légale qui rémunère les auteurs et les ayants droit pour les copies privées réalisées à partir de supports vierges tels que les CD, les DVD, les disques durs externes et les clés USB. Cette redevance est incluse dans le prix de vente de ces supports vierges et est ensuite distribuée aux créateurs et aux ayants droit par l'intermédiaire des organismes collectifs de gestion. Les vendeurs sont tenus d'indiquer le montant de la redevance "copie-privée" en euros pour chaque produit de cette catégorie.
- Garantie : Indiquez la garantie légale de 2 ans, en écrivant "2-ans" avec un trait d'union.
Exigences de titre
- Nombre maximum de caractères : 100 caractères maximum.
- Structure du titre : Type de produit, fonction, style, couleur, matériau, dimensions.
- Exclusion du nom de marque : N'incluez pas le nom de la marque dans le titre. Remarque : Le champ de la marque est automatiquement placé avant le titre sur le site.
- Dimensions : Indiquez les unités de mesure (ex. H.10 cm). N'utilisez pas d'abréviations. Exemple : Ø
- Aucun terme commercial : N'affichez pas des termes comme "Exclusif", "Nouveau", "Meilleure vente", etc.
- Caractères spéciaux : N'incluez pas de caractères spéciaux (ex. lettres grecques, etc.).
- Pas de tiret en début de titre : Ne commencez pas le titre par un tiret.
Exigences d'image
- Premier visuel : Doit être sur un fond blanc, détouré.
- Positionnement : Doit être positionné soit de face soit en angle de ¾.
- Nombre de visuels : Jusqu'à 6 visuels montrant différents angles (photo d'arrière-plan, schéma, accessoires, détails, etc.)
- Formats recommandés : 2000×2000 pixels, 3000×3000 pixels.
Exigences de description
- Limite de caractères : Assurez-vous que la description de votre produit ne dépasse pas 8 000 caractères pour rester conforme aux directives de la plateforme.
- Aucun lien externe : Évitez d'inclure des liens ou des références vers des sites ou boutiques externes dans la description du produit.
- Utilisez le HTML pour l'enrichissement : Le HTML peut être utilisé pour enrichir votre description, ajoutant du formatage et des éléments visuels (Remarque : le HTML est bloqué par défaut sur Mirakl ; contactez votre gestionnaire de compte pour l'activer).
En suivant ces directives, vous vous assurez que vos fiches produits pour But sont correctement configurées et conformes à leurs exigences.
Bonnes pratiques
Ajout de plusieurs valeurs d'attribut : Lorsque vous ajoutez plusieurs valeurs dans un champ d'attribut pour les marketplaces Mirakl, séparez chaque valeur par le symbole "|" pour assurer un traitement correct des valeurs.
ID du produit du vendeur pour les produits simples/uniques : Veuillez noter qu'il existe deux attributs nommés respectivement "SellerArticleId" et "SellerProductId". L'attribut "SellerProductId" fait référence à l'ID parent, tandis que l'attribut "SellerArticleId" fait référence aux produits variants. Pour les produits uniques, les deux attributs doivent être remplis avec la même valeur.
Pour plus d'informations sur les erreurs des marketplaces de Mirakl et les bonnes pratiques à adopter, consultez notre guide dédié.
Étape 4 : Envoyer vos annonces produits à BUT
Vous y êtes presque, vos annonces produits sont prêtes à être envoyées. Si vous n'avez pas activé votre projet, allez dans les paramètres de votre projet sur le côté gauche de l'écran et cliquez sur "Activer le projet".
Ensuite, retournez à l'aperçu des APIs et accédez à [Votre API But] > Paramètres , où vous activez l'API en cliquant sur "Activer l'API".
Une fois l'API activée, retournez à l'aperçu des APIs et cliquez sur le bouton bleu "Exécuter" pour envoyer vos annonces produits à But.
Étape 5 : Vérifier les erreurs de vos annonces
Pour vérifier les erreurs, accédez à la [page Résultats de l'API] > Onglet Erreurs, où vous verrez les annonces produits ayant des erreurs. En cliquant sur une erreur spécifique, vous obtiendrez plus d'informations sur la cause du problème. Pour plus d'informations sur la signification des erreurs, lisez cet article.