Configurer une API Fnac Darty products (résoudre ERR_026)

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. Les connexions API de Fnac Darty expliquées
2. Étape de préparation
3. Créer une nouvelle connexion Fnac Darty Products dans Channable
4. Créer une nouvelle API Fnac Darty Products
5. Créer vos annonces produits dans Channable
6. Envoyer vos annonces produits à Fnac Darty
7. Vérifier vos annonces produits pour détecter des erreurs
8. Désactiver l'API Fnac Darty products

Les connexions APIs 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 Products 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 inconnus sur Fnac Darty :
   Cet article suppose que vos codes EAN sont inconnus de Fnac Darty. Si vos codes EAN/produits sont connus de Fnac Darty, veuillez vous référer à notre article du Centre d'aide sur la façon d'envoyer vos codes EAN/produits connus à 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 Products dans Channable

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

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

Cliquez sur le bouton ''Connecter avec Fnac'' pour enregistrer votre connexion.

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

Vous pouvez désormais naviguer dans "Votre projet > APIs > +Ajouter nouvelle API" et sélectionnez la nouvelle connexion que vous venez de créer - et non la connexion Fnac Darty offers + orders. 

Vous serez redirigé(e) vers les paramètres de l'API, où vous pourrez choisir le Nom de votre API et sélectionner l'ID unique par produit et le Pays France. Vous pouvez également choisir d'utiliser un groupe de règles générales. Ensuite, cliquez sur "Continuer" pour créer la nouvelle API Fnac Darty products. 

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

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 sur l'API Fnac Darty Products

Pour l'API Products, il vous suffit de sélectionner votre champ EAN lors de l'étape Construire, en cliquant sur l'attribut lui-même. Lorsque vous avez sélectionné le bon champ EAN, cliquez sur "Sauvegarder" en bas de l'écran.

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

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

Si vous avez envoyé vos annonces produits vers Mirakl Fnac Darty, rendez-vous dans l'onglet "Résultats" de votre API. Cliquez sur "Erreurs" pour voir quelles données produits sont en erreur et rejetées par Mirakl. Cliquez sur une erreur spécifique pour voir plus d'informations sur la cause de l'erreur.

Dans certains cas, il peut arriver que l'API Produits ne crée aucun produit sur Mirakl et que nous ne recevions aucun message d'erreur à ce sujet dans l'onglet des Résultats.

Dans ce cas, il existe deux façons d'obtenir un rapport d'erreur plus détaillé :

• Comment télécharger le rapport d'erreur sur la plateforme Fnac ?

1. 1. Allez sur la plateforme Fnac et allez dans "My inventory".
   2. Cliquez sur "Import from file".
   3. Sélectionnez "Track Product Imports".
   4. Téléchargez le(s) rapport(s) d'erreur depuis le côté droit de l'écran en cliquant sur "Download transformation error report".

• Comment télécharger le rapport d'erreur dans Fnac Darty Mirakl :

1. 1. Connectez-vous à votre compte Mirakl et naviguez vers "Catalog" > "Product Imports".
   2. Dans la section "Product Imports", vous trouverez la liste des imports effectués par Channable, ainsi que leur horodatage.
   3. Cliquez sur le bouton "See details" correspondant à l'import le plus récent pour accéder aux derniers détails d'erreurs.
   4. Sélectionnez "Non-integrated products report" parmi les options proposées. Le rapport d'erreur sera automatiquement téléchargé. Consultez cet article pour plus de détails sur la façon d'obtenir un rapport d'erreur Mirakl.

En suivant ces étapes, vous pouvez suivre et résoudre efficacement tous les problèmes liés à vos annonces produits sur la plateforme Fnac Darty.

Étape 6 : Désactiver l'API Fnac Darty Products

Il n'est pas nécessaire que l'API Fnac Darty products soit tout le temps activée car elle n'est utilisée que pour mettre à jour le contenu des produits (des parties de l'annonce qui changent très peu comme la description, le titre, etc.) ou pour créer des données pour de nouveaux produits que Fnac Darty ne connaît pas encore.

Consultez la section "Résultats" de l'API Fnac Darty offers + orders (si vous n'en avez pas encore, consultez notre article du Centre d'aide) pour voir s'il y a une erreur appelée "ERR_026 : Product not found". Si vous voyez cette erreur, alors l'API Fnac Darty products doit être activée. Si vous ne voyez pas cette erreur dans "Résultats" de l'API Fnac Darty offers + orders, l'API Fnac Darty products peut être désactivée. 

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