Remarque : Avant de consulter cet article, veuillez aussi consulter l'article pour diffuser vos annonces sur la Fnac.
Comment fonctionnent les deux connexions API FNAC ?
Ces deux connexions font la distinction entre votre offre (prix, livraison et stock) et le contenu (de l'annonce). La connexion "API-Offers" vous permet d'envoyer des produits qui sont déjà connus de la Fnac (si les codes EAN sont déjà connus de la marketplace). Les champs nécessaires pour établir cette connexion sont le code EAN, le stock, les informations de livraison et le prix.
Si vos codes EAN sont inconnus, l'API appelée "Fnac Offers" affichera "ERR_026 : Product not found" (Produit introuvable) dans la section Aperçu de l'API. Cela veut dire que la Fnac ne connaît pas ces produits. Pour ceux-ci, vous devrez créer de nouvelles annonces produits. Pour créer des annonces sur la Fnac, nous avons développé la connexion Fnac appelée API-Products.
Configuration de l'API Fnac
Important ! Pour le moment, il est possible d'utiliser l'API produits Fnac uniquement pour les comptes Fnac français. Si votre compte Fnac n'est pas français, vous ne pourrez pas créer une clé API à partir de votre compte, donc vous ne pourrez pas utiliser l'API produits Fnac. Pour envoyer de nouveaux produits, vous devrez utiliser les modèles fournis par la Fnac et vous pourrez les obtenir auprès de votre interlocuteur Fnac.
Étape 1 : Comment obtenir vos identifiants API pour votre compte Fnac Mirakl
L'API-Products de la Fnac est construite sur la plateforme Mirakl, qui est également utilisée par plusieurs autres marketplaces. Pour commencer à diffuser vos produits sur la Fnac, vous aurez besoin d'un compte Mirakl.
Une fois que vous avez les données de connexion d’un compte Mirakl Fnac, vous pouvez naviguer vers "préférences utilisateur" en cliquant sur votre adresse email en haut à droite. Après cela, cliquez sur "clé API" et sur "générer une nouvelle clé API" s'il n'y a pas encore de clé disponible. Si une clé API est déjà disponible, vous pouvez l'utiliser, vous n'avez pas besoin d'en créer une nouvelle. Copier la "clé API", vous en aurez besoin pour l'étape suivante.
Vous pouvez aussi trouver votre numéro d'identifiant dans votre compte boutique. Tout d'abord, sélectionnez la boutique sur laquelle vous souhaitez vendre vos produits dans le coin en haut à droite. Ensuite sélectionnez Mon compte > Paramètres afin de trouver l'identifiant de votre boutique.
Étape 2 : Créez une nouvelle API Products pour la Fnac dans Channable
La création d'une API-Products Fnac est similaire à la création d'autres connexions marketplaces:
Allez sur l'onglet APIs > Ajouter nouvelle API > Ajouter une nouvelle connexion. Vous serez redirigé vers toutes les connexions API où vous verrez deux connexions Fnac. Veillez à sélectionner la connexion appelée "Fnac Products".
Saisissez un nom pour la connexion sous "Label", nous vous conseillons de nommer la connexion "Fnac Offer API". Remplissez votre identifiant de boutique que vous avez reçu de la Fnac à l'étape 1 et cliquez sur le bouton "Créer" pour enregistrer votre connexion.
Vous serez redirigé vers l'étape Paramètres de l'API où vous pouvez donner un nom à votre API. Après avoir choisi un nom, cliquez sur le bouton "Continuer" pour créer votre nouvelle API-Products Fnac. Une fois la connexion établie, il est temps de configurer l'API Product.
Étape 3 : Créez les annonces dans Channable
Retournez sur l'onglet "API" de Channable et sélectionnez la connexion nouvellement créée avec les produits Fnac. Ensuite, suivez les étapes habituelles:
1. Catégories
Catégorisez tous vos produits, car les produits non-catégorisés n'auront pas d'annonces créées sur la marketplace. Ajoutez des catégories à vos produits en utilisant la fonction créer des catégories ou créez de nouvelles catégories à partir de zéro.
2. Règles
Créez différentes règles pour optimiser vos données produits. Par exemple, jetez un coup d'oeil à notre article de support sur les règles les plus souvent utilisées.
3. Construire
Ci-dessous, vous trouverez notre modèle prédéfini pour les annonces produits. Tout ce que vous avez à faire est de connecter vos données produits à celles attendues par la marketplace. Par exemple, le champ "Stock" devrait afficher le stock de votre produit et ainsi de suite. Lorsque vous avez terminé de configurer les annonces produits, cliquez simplement sur " Sauvegarder " au bas de l'écran.
Conseil ! Notez que si vous passez votre souris sur le point d'interrogation derrière chaque champ, vous verrez la description de ce qui est attendu par la marketplace et des suggestions de valeurs possibles.
4. Attributs
Remplissez les champs de l'étape Attributs. Sélectionnez d'abord la catégorie que vous voulez optimiser. Ci-dessous, la capture d'écran vous montre un exemple de ce que vous pourriez voir apparaître. Une explication plus détaillée de ce qu'il faut faire à l'étape Attributs peut être trouvée dans notre article de support.
Étape 4 : Envoyez vos informations produits à la Fnac
Vous y êtes presque, vos annonces produits sont prêtes à être envoyées. Si vous n'avez pas activé votre projet dans Channable, allez dans l'onglet Paramètres dans la barre de menu à gauche et cliquez sur "activer le projet'. Ensuite, retournez sur l'onglet APIs et cliquez sur "Paramètres" de votre API-Product Fnac nouvellement créée. Activez l'API en sélectionnant "Activer API". Une fois cette étape terminée, retournez sur l'onglet APIs et cliquez sur le bouton bleu "Exécuter maintenant" pour envoyer vos annonces produits à la Fnac.
Étape 5 : Vérifiez les erreurs de vos données produit
Si vous avez envoyé vos annonces produits à la Fnac, rendez-vous dans l'onglet Aperçu de votre API Fnac. Cliquez sur "Erreur". Vous pouvez maintenant voir quelles annonces produits ont des erreurs et ne sont pas diffusées. Cliquez sur une erreur spécifique pour voir plus d'informations sur la cause de l'erreur et contactez notre support technique si vous avez besoin d'aide.
Étape 6 : Désactivez l'API-Product de la Fnac
Il n'est pas nécessaire que l'API 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 annonces pour de nouveaux produits que la Fnac ne connaît pas encore. Consultez la section Aperçu de l'API-Offer Fnac (si vous n'avez pas encore d'API-Offer Fnac, consultez notre article de support) pour voir s'il y a une erreur appelée "ERR_026 : Product not found". Si vous voyez cette erreur dans la section Aperçu de l'API-Offer Fnac, l'API-Product Fnac doit être activée. Si vous ne voyez pas cette erreur dans la section Aperçu de l'API-Offer Fnac, l'API-Product Fnac doit être désactivée.