Vers le site principal
  1. Help Center - Channable
  2. APIs
  3. API Mirakl

Articles dans cette section

Afficher plus

Configurer une API Fnac Darty offers + orders

Souhaitez-vous apprendre de manière interactive toutes les bases pour la création d'une API export dans Channable? Apprenez comment créer un compte Channacademy dans l'application Channable grâce à cet article du Centre d'aide et commencez avec le cours Bases - APIs.

Fnac Darty est un important groupe de distribution français issu de la fusion de la Fnac et de Darty, et spécialisé dans une large gamme de produits. La Fnac propose des articles culturels et électroniques tels que des livres, de la musique, des films, des jeux vidéo et des produits électroniques grand public, tandis que Darty se concentre sur les appareils électroménagers et l'électronique grand public.

Table des matières

  1. Explication des connexions API de Fnac Darty
  2. Étape de préparation
  3. Créer une nouvelle connexion Fnac Darty Offers dans Channable
  4. Créer une nouvelle API Fnac Darty Offers
  5. Créer vos annonces produits dans Channable
  6. Envoyer vos annonces produits à Fnac Darty
  7. Vérifier vos annonces produits pour détecter les erreurs

Les connexions API de Fnac Darty expliquées

Il existe deux connexions différentes et donc des APIs distinctes pour Fnac Darty qui font la distinction entre vos données d'offre et vos données produit.

  • La connexion Fnac Darty Offers : Cette API (qui supporte une connexion commande) vous permet de vendre des produits qui sont déjà connus de la Fnac ou de Darty, sur la base des codes EAN. Si vos codes EAN/produits sont inconnus de la Fnac ou de Darty, l'API Fnac Darty Offers affichera une erreur à l'étape Aperçu appelée "ERR_026 : Product not found".

  • La connexion à l'API Fnac Darty Products : Si Fnac Darty ne connaît pas vos EANs/produits, vous devez ajouter leurs données à la base de données de Fnac Darty par le biais de l'API Fnac Darty Products. Cette API est essentielle pour la soumission initiale de vos EANs et pour la mise à jour des informations sur les produits, mais ne nécessite pas d'être activée en permanence.

Dans cet article, nous allons vous guider dans la mise en place d'une API Offers avec la plateforme Fnac Darty en utilisant Channable.

Étape de préparation

Pour garantir une installation fluide et éviter tout problème, veuillez lire et suivre ces lignes directrices importantes :

  1. EANs connus sur Fnac Darty :
    Cet article suppose que vos codes EAN sont connus de Fnac Darty. Si vos codes EAN/produits sont nouveaux pour Fnac Darty, veuillez vous référer à notre article du Centre d'aide sur la façon d'ajouter des codes EAN/produits inconnus à Fnac Darty.
  2. EAN obligatoires :
    Les codes EAN sont obligatoires pour la Fnac et Darty. Assurez-vous d'avoir des codes EAN valides pour tous vos produits, sinon aucune annonce produit ne pourra être créée pour vos produits.
  3. Informations d'identification de l'API :
    Pour vendre vos produits sur Fnac Darty, vous avez besoin d'un compte vendeur professionnel. Suivez les instructions de création de compte ici. Une fois que vous vous êtes inscrit(e), contactez Fnac Darty pour obtenir le Shop ID pour la Fnac et le Shop ID pour Darty. Conservez ces identifiants car vous en aurez besoin à l'étape suivante.
  4. Connexion Channable :
    Vous ne pouvez créer une connexion qu'à Fnac Darty France depuis Channable. Les connexions avec les autres pays de Fnac Darty ne sont pas supportées pour le moment.

Après avoir complété et passé en revue tous les points de préparation, vous êtes prêt(e) à passer à la première étape.

Étape 1 : Créer une nouvelle connexion Fnac Darty Offers dans Channable

Pour créer une connexion à Fnac Darty Offres, suivez les étapes suivantes :

  1. Naviguez vers "Connexions".
  2. Cliquez sur "+Ajouter une connexion".
  3. Sélectionnez “Fnac Darty Offers (et non “Fnac Darty products”).
  4. Entrez un nom, e.g., “Fnac Darty Offers”.

Renseignez le Shop ID

  • Si vous créez une API Fnac Darty Offers pour vendre uniquement des produits sur la Fnac, veuillez indiquer le Shop ID Fnac que vous avez reçu.
  • Si vous créez une API Fnac Darty Offers pour vendre uniquement des produits sur Darty, veuillez indiquer le Shop ID Darty que vous avez reçu.
  • Si vous souhaitez vendre vos produits à la fois sur Fnac et sur Darty, vous devez créer deux connexions distinctes (l'une avec le Shop ID Fnac et l'autre avec le Shop ID Darty).

Channable

 Sing_in_Mirakl_-_Oauth.png

Cliquez sur "Créer" pour enregistrer votre connexion.

Étape 2 : Créer une nouvelle API Fnac Darty Offers

Pour créer une nouvelle API, allez dans votre projet puis dans "APIs > + Ajouter nouvelle API" et sélectionnez la connexion Fnac Darty offers + orders que vous avez précédemment créée.

Vous serez redirigé(e) vers l'étape "Paramètres" de l'API où vous pouvez donner un Nom à votre API et sélectionner l'ID unique par produit.

Vous pouvez éventuellement ajouter un groupe de règles générales. Ensuite, cliquez sur le bouton "Continuer" pour créer votre nouvelle API d'offres Fnac Darty.

Ici également, gardez en tête les scénarios mentionnés plus haut : 

  1. Pour vendre vos produit sur Fnac, veillez à créer une API utilisant la connexion comportant le Shop ID Fnac créée à l'Étape 1.
  2. Pour vendre vos produit sur Darty, veillez à créer une API utilisant la connexion comportant le Shop ID Darty créée à l'Étape 1.

Étape 3 : Créer vos annonces produits dans Channable

Remarque : Au cours des prochains mois, nous mettrons progressivement en place Marketplaces V2. Si votre API est sur Marketplaces V1, ces étapes peuvent être différentes. Consultez cet article pour plus d'informations !

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

  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

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.

Étape 4 : Envoyer vos annonces produits à Fnac Darty

Une fois toutes les étapes terminées, vous êtes prêt(e) à envoyer vos annonces produits. Suivez les instructions ci-dessous pour envoyer vos annonces produits :

  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 API" > Paramètres.
  5. Sélectionnez "Activer API" pour activer l'API.
  6. Retournez à la vue d'ensemble des APIs et cliquez sur le bouton bleu "Exécuter" pour envoyer vos annonces produits.

Étape 5 : Vérifier vos annonces produits pour détecter les erreurs

Après avoir envoyé vos annonces produits à Fnac Darty, veillez à vérifier si elles comportent des erreurs dans "Aperçu" de votre API. Cliquez sur l'onglet "Erreurs" pour voir quels produits contiennent des erreurs et ne sont pas diffusés en ligne. Cliquez sur une erreur spécifique pour obtenir plus d'informations sur la cause de l'erreur et sur sa correction. 

Erreur "ERR_026"

Si vous recevez l'erreur "ERR_026", cela signifie que vos produits ne sont pas encore connus par Fnac Darty. Pour résoudre cette erreur, lisez notre article sur la façon d'ajouter des produits avec des codes EAN inconnus à Fnac Darty.

Channable

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.

Pour plus d'informations sur les erreurs des marketplaces de Mirakl et les bonnes pratiques à adopter, consultez notre guide dédié.