Configurer les APIs Brico & Praxis

Maxeda, l'organisation derrière Praxis (Pays-Bas) et Brico (Belgique), offre une marketplace majeure pour les produits de bricolage dans la région du Benelux. Grâce à Mirakl, les vendeurs tiers peuvent proposer leurs produits sur les deux plateformes, ce qui leur permet d'atteindre un large public tout en maintenant des normes de qualité.

Ce guide fournit des instructions étape par étape pour configurer les API Praxis et Brico en utilisant Mirakl dans Channable, ainsi que des directives pour une mise en œuvre efficace.

Table des matières

1. Explication des APIs Praxis et Brico
2. Acceptation du compte
3. Création des connexions pour Praxis et Brico
4. Création des APIs pour Praxis et Brico
5. Création de vos annonces produits
6. Activation des APIs
7. Finalisation de la configuration et vérification du compte
8. Vérifier l'absence d'erreurs dans vos annonces

Explication des APIs Praxis et Brico

Pour vendre sur Praxis ou Brico, vous devez référencer vos produits sur les deux plateformes. Dans Channable, cela est géré par deux API distinctes, une pour chaque plateforme. Ces APIs se connectent au même compte vendeur Mirakl, qui renvoie ensuite aux boutiques individuelles de Brico et de Praxis.

Maxeda fonctionne différemment des autres marketplaces, car elle exige que toutes les données soient identiques dans les deux API. Il s'agit d'un élément important à prendre en compte lors de la configuration de vos annonces produits et de la création de règles, car le maintien de la cohérence est crucial pour une intégration réussie.

Acceptation du compte

Pour réussir à diffuser vos produits sur la plateforme Maxeda, et avant de configurer vos APIs, plusieurs étapes doivent être complétées pour se conformer aux directives de Maxeda. Nous les décrivons ci-dessous :

1. Créer la boutique Praxis NL : Commencez par créer la boutique Praxis NL.
   Création de boutiques :
2. Créer des utilisateurs dans le magasin Praxis NL : Informez l'équipe Maxeda Marketplaces d'ouvrir la boutique Brico BE et de dupliquer les utilisateurs du compte NL.
3. Vérifier les informations du compte : Une fois les deux boutiques créées, assurez-vous que toutes les informations de votre compte Mirakl sont remplies conformément aux directives.
4. Vérifier le statut des magasins : Vérifiez le statut de chaque boutique dans Mirakl. Si une boutique n'est pas en ligne, des informations supplémentaires peuvent être nécessaires. Contactez Maxeda pour obtenir de l'aide.

Maxeda doit également examiner vos produits. Cela ne se fera que lorsque vos boutiques seront en ligne et que toutes les informations nécessaires sur les produits auront été fournies. Pour plus d'informations, consultez les documents au bas de cet article ou contactez directement Maxeda.

Étape 1 : Création des connexions pour Praxis et Brico

Pour compléter la configuration des connexions Maxeda Praxis et Maxeda Brico, vous devrez répéter les étapes suivantes pour chaque plateforme :

1. Rendez vous dans la section Connexions de Channable.
2. Cliquez sur +Ajouter une nouvelle connexion.
3. Sélectionnez Maxeda Praxis ou Maxeda Brico.
   
4. Saisissez un nom, par exemple "Praxis" pour Praxis ou "Brico" pour Brico.
5. Cliquez sur "Créer". Vous serez redirigé(e) vers Maxeda/Mirakl pour l'étape suivante. Une fois sur le site, connectez-vous à l'aide de vos identifiants Maxeda/Mirakl.

Après avoir réussi à vous connecter, la connexion avec Maxeda est établie et disponible.

Étape 2 : Création des APIs pour Praxis et Brico

Une fois de retour sur Channable, naviguez jusqu'à la page des APIs dans votre projet.

1. Cliquez sur +Ajouter nouvelle API. Sélectionnez la connexion Praxis ou Brico que vous avez créée précédemment et commencez à configurer les paramètres de l'API :
   • Nommez votre API.
   • Sélectionnez l'ID unique par produit, nous vous recommandons de sélectionner le champ "id".
   • Sélectionnez la langue de votre API, la langue choisie n'affecte pas la langue des données envoyées à Maxeda.
   • Nous vous conseillons vivement d'utiliser un groupe de règles générales, afin de synchroniser les données entre les deux APIs.
     
2. Pour créer la nouvelle API, cliquez sur "Continuer".

Étape 3 : Création de 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

2. Règles

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

1. 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.
2. 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

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

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

1. Sélectionner une catégorie de produits : Choisissez la catégorie correspondant à votre produit, par exemple vêtements ou meubles.
2. 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

Informations complémentaires pour Praxis & Brico

Les informations suivantes sont spécifiques à Maxeda. Nous présentons ci-dessous des informations importantes sur les APIs Praxis et Brico, ainsi que les règles d'or à respecter.

• Assurer la cohérence entre les deux APIs
  Pour éviter les erreurs et garantir des annonces produits réussies pour Praxis et Brico, il est essentiel de maintenir la cohérence des données produits sur les deux plateformes. Des données incohérentes peuvent entraîner des erreurs telles que :
  "Produit rejeté : Les champs obligatoires ne sont pas remplis, ajouter le contenu aux deux canaux (BE+NL)".
  Pour éviter ces problèmes, utilisez les Règles générales de Channable. Celles-ci vous permettent de centraliser et de renforcer la cohérence de vos annonces produits pour les deux APIs. Vous pouvez créer un groupe de règles générales et l'appliquer aux APIs Praxis et Brico, en veillant à ce que tous les champs obligatoires et les données principales restent synchronisés. Pour plus d'informations sur l'utilisation des règles générales, veuillez vous référer à notre article contenant des exemples de règles générales.
• Images
  Bien que les deux APIs indiquent que des images doivent être ajoutées dans les attributs, Maxeda demande spécifiquement que vous n'envoyiez des images que via l'API Praxis. Pour l'API Brico, laissez les attributs d'image vides.
• Les règles d'or
  Maxeda effectue des contrôles initiaux à l'aide des règles d'or. Si votre produit répond à ces critères, d'autres évaluations suivront. Vous trouverez ci-dessous les Règles d'or :

  Exigence	Description	Applicable pour
  Remplissage des champs obligatoires	Les données produit doivent être complètes pour les champs obligatoires de Praxis et Brico.	Praxis et Brico
  Composition du titre (BE-NL, NL-NL)	'brand' – 'product type' – 'numéro de série' – 'attribut 1' et/ou 'dimensions' – 'autres mots clés' (Max. 85 caractères).	Praxis et Brico
  Composition du titre (BE-FR)	'product type' – 'brand' – 'numéro de série' – 'attribute ' et/ou 'dimensions'(Max. 100 caractères).	Brico
  Description du produit	Utilisez uniquement du HTML de base (pas de CSS). Mettez en évidence les principaux avantages du produit. Énumérez clairement ce qui est inclus dans la boîte. (ou ce qui ne l'est pas) Décrivez l'utilisation du produit et le public visé. Répétez les principaux mots-clés et la marque tout au long du texte. Adressez-vous au client en utilisant le terme "vous" (150 caractères au minimum).	Praxis et Brico
  Points de vente uniques (USPs)	3 points de vente uniques dans toutes les langues sont obligatoires. Mettez en évidence les caractéristiques qui distinguent le produit. (65 caractères maximum).	Praxis et Brico
  Images	Au moins 2 images d'une taille minimale de 500x500px. Ajoutez les dimensions ou un manuel si nécessaire.	Praxis et Brico
  Formatage des nombres	Utilisez toujours le '.' (point) pour les nombres au lieu de la ',' (virgule).	Praxis et Brico

Étape 4 : Activation des APIs

Suivez les étapes ci-dessous pour activer vos APIs :

1. Allez dans Paramètres > Paramètres du projet sur le côté gauche de l'écran.
2. Cliquez sur "Activer le projet".
3. Retournez à la vue d'ensemble des APIs.
4. Allez dans [Votre nom d'API] > Paramètres.
5. Sélectionnez "Activer l'API" pour activer l'API.

Retournez à la vue d'ensemble des APIs et cliquez sur le bouton bleu "Exécuter" pour envoyer vos annonces produits.

Étape 5 : Finalisation de la configuration et vérification du compte

Après avoir configuré vos APIs, il est essentiel de vérifier que vos produits sont envoyés avec succès et qu'ils sont correctement diffusés sur la marketplace. Suivez les étapes suivantes pour finaliser la configuration :

1. Vérifier le statut du produit sur la marketplace

Après avoir configuré vos APIs, il se peut que les produits soient envoyés avec succès à la marketplace, mais qu'ils ne soient pas encore en ligne. Pour résoudre ce problème, assurez-vous que votre compte Maxeda dans Mirakl a passé toutes les étapes requises, comme indiqué dans la section Acceptation du compte de cet article.

Lorsque vous vous connectez à Mirakl, vous pouvez voir le statut de chaque boutique. Si une boutique n'est pas en ligne, cela peut indiquer que des informations supplémentaires sont nécessaires. Dans ce cas, contactez Maxeda pour obtenir de l'aide.

2. "Règles d'or : erreurs

Lorsque vous envoyez des produits à Maxeda pour la première fois, vous pouvez rencontrer l'erreur : "mirakl_unknown_error_code" suivi de "Le produit n'existe pas". Cette erreur se produit lorsqu'une partie ou la totalité des EAN/produits n'ont pas encore été examinés et acceptés par Maxeda. Ces produits seront examinés par Maxeda conformément à sa politique de règles d'or.

3. Calendrier de révision des produits

L'équipe Contenu de Maxeda prend généralement une semaine pour examiner les produits. Si les produits sont conformes à leur politique, l'erreur sera résolue et les produits seront mis en ligne.

Étape 6 : Vérifier l'absence d'erreurs dans vos annonces

Une fois que vous avez résolu le "mirakl_unknown_error_code" et l'erreur associée ”Le produit n'existe pas", vous pouvez gérer les APIs comme vous le feriez pour n'importe quelle autre marketplace dans Channable. Cependant, n'oubliez pas de synchroniser les changements à travers les deux APIs chaque fois que vous faites des modifications.

Pour examiner vos erreurs, accédez aux onglets Aperçu de vos APIs. Vous pouvez y voir quels produits comportent des erreurs et doivent être corrigés.