Étape 1 : Générez vos identifiants API dans votre compte fonQ
L'API fonQ utilise la plateforme Mirakl, ce qui signifie que vous aurez besoin d'un compte Mirakl pour commencer à diffuser vos produits sur fonQ.
Connectez-vous sur votre compte fonQ Mirakl et naviguez vers My user settings en cliquant sur votre adresse e-mail dans le coin supérieur droit. Ensuite, cliquez sur l'onglet "API key" puis sur "generate API key" s'il n'y a pas encore de clé disponible. S'il y a une clé API disponible, vous pouvez l'utiliser, vous n'avez pas besoin d'en créer une nouvelle. Copiez la clé API, car vous en aurez besoin pour l'étape suivante.
Ensuite, vous devrez trouver votre Shop ID dans votre compte vendeur. Sélectionnez d'abord la boutique sur laquelle vous souhaitez envoyer des produits dans le coin supérieur droit. Ensuite, allez dans My Account > Settings pour trouver votre Shop ID. Copiez-le également car vous en aurez besoin pour l'étape suivante.
Étape 2 : Créez une nouvelle API fonQ dans Channable.
Dans Channable, ouvrez votre projet et allez dans API > Ajouter nouvelle API. Un nouvel écran s'ouvrira avec les paramètres de l'API où vous pourrez cliquer sur le bouton "+ Ajouter une nouvelle connexion".
Vous serez redirigé vers un aperçu dans lequel vous pourrez sélectionner "fonQ" pour créer une nouvelle connexion. Ajoutez un nom pour la connexion, nous vous recommandons de la nommer "fonQ API". Renseignez la clé API et le Shop ID que vous avez copiés à l'étape 1, et cliquez sur le bouton "Créer" pour enregistrer la connexion.
Vous pouvez alors choisir votre nouvelle connexion fonQ et vous serez automatiquement redirigé vers l'étape Paramètres de l'API fonQ où vous pourrez nommer votre API. Après avoir choisi un nom, cliquez sur le bouton "Continuer" pour créer votre nouvelle API fonQ.
Différence entre une Offre et un Produit dans l'API fonQ
Avant de créer vos listes de produits, il est important de comprendre la différence entre l'envoi d'une Offre et d'un Produit via l'API fonQ.
- Offre : Une offre comprend uniquement les champs de l'étape "construction" de l'API.
- Produit : Un produit a plus d'informations qu'une offre, renseignées grâce à la catégorisation et aux attributs remplis, ce qui est nécessaire lorsque les articles sont inconnus de fonQ.
Si vous n'avez pas de boutique néerlandaise et que vos produits ne sont pas connus de fonQ, vous devrez créer une boutique néerlandaise et configurer une API de produit pour ceux qui sont inconnus. Vous devrez catégoriser ces produits et les envoyer vers la boutique néerlandaise pour les faire connaître. Une fois cela fait, vous pourrez alors configurer une deuxième API pour créer des offres belges, mais cela entraînera la création d'offres dans la boutique néerlandaises également. Pour éviter cela, vous devrez effacer l'API néerlandaise une fois que les produits auront été acceptés.
Étape 3 : Créez vos listes de produits dans Channable
Une fois que l'API fonQ est créée, vous pouvez configurer vos données produit en suivant les étapes de l'API.
- Catégories
Nous vous conseillons de commencer par essayer d'envoyer vos produits sans les catégoriser. Si fonQ connaît déjà les codes EAN de vos produits, vous n'aurez pas besoin de faire cette étape. Si les produits ne sont pas encore connus, vous verrez apparaître l'erreur suivante dans l'étape Aperçu de l'API : "mirakl_unknown_error_code". - Règles
Créez différentes règles pour optimiser vos listes de produits. Par exemple, consultez cet article sur les règles courantes. - Construire
Vous trouverez ici notre modèle prédéfini pour les fiches produits. Il vous suffit de le remplir en cliquant sur un champ et en sélectionnant ce que vous souhaitez y voir figurer. Par exemple, le champ "Titre" doit afficher le titre de votre produit et ainsi de suite. Lorsque vous avez terminé de créer les fiches produits, il vous suffit de cliquer sur "Sauvegarder" en bas de l'écran.
Astuce ! Remarquez le point d'interrogation derrière chaque champ ; si vous le survolez, vous verrez la description du champ ainsi que des suggestions de valeurs possibles. - Attributs
Tout comme pour l'étape Catégories, nous vous conseillons de commencer par essayer d'envoyer vos produits sans remplir les attributs. Si fonQ connaît déjà les codes EAN de vos produits, vous n'aurez pas besoin de compléter cette étape.
Étape 4 : Envoyez vos données de produit à fonQ
Presque terminé, vos produits sont prêts à être envoyés. Si vous n'avez pas activé votre projet, allez dans l'onglet Installation à gauche de l'écran, puis "Paramètres du projet" et enfin "Activer le projet". Ensuite, retournez à l'aperçu des APIs et sélectionnez Votre nom d'API fonQ > Paramètres où vous pourrez activer l'API en cliquant sur "Activer l'API". Après avoir terminé cette étape, retournez une nouvelle fois à la vue d'ensemble des APIs et sélectionnez le bouton bleu "Exécuter " pour envoyer votre catalogue produit vers fonQ.
Étape 5 : Vérifiez les éventuelles erreurs de votre catalogue produit
Si vous avez envoyé votre catalogue produit vers fonQ, cliquez sur l'onglet Aperçu de votre API fonQ. Sélectionnez "Erreurs". Vous pouvez maintenant voir quels produits comportent des erreurs et ne sont donc pas créés. Cliquez sur une erreur spécifique pour obtenir plus d'informations sur la cause de cette erreur et consultez notre section sur les solutions pour les erreurs pour les corriger. Si vous obtenez cette erreur "mirakle_unkown_error_code" pour certains produits, suivez ce guide afin de corriger ces erreurs.