Configurer une API fonQ

Étape 1 : Ajoutez une nouvelle connexion

L'API fonQ utilise la plateforme Mirakl, vous aurez donc besoin d'un compte Mirakl pour commencer à envoyer vos produits à fonQ.

Lorsque vous avez un compte Mirakl fonQ, allez dans le menu "[Votre entreprise] > Connexions > Ajouter une connexion". Cliquez sur "+ Ajouter une nouvelle connexion" puis vous verrez un écran où vous pouvez sélectionner fonQ. Remplissez le nom de votre connexion avec par exemple "fonQ". Puis cliquez sur ''Se connecter avec fonQ''. Vous serez redirigé(e) vers l'environnement où vous pourrez vous connecter avec vos identifiants Mirakl. Après vous être connecté(e), vous serez redirigé(e) vers Channable où la connexion sera disponible.

Étape 2 : Créez une nouvelle API fonQ dans Channable.

Allez maintenant dans l'aperçu de l'API. Cliquez sur "Ajouter nouvelle API", sélectionnez la connexion fonQ que vous venez de créer et donnez un nom à votre nouvelle API.

Sélectionnez le champ que vous souhaitez utiliser pour l'ID unique par produit (nous recommandons le champ "id") et le pays dans lequel vous souhaitez vendre. Vous pouvez également ajouter un groupe de règles générales si vous le souhaitez. Cliquez sur "Continuer" pour terminer la création de la 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.

1. 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 "Résultats" de l'API : "mirakl_unknown_error_code".
   
   
2. Règles
   Créez différentes règles pour optimiser vos annonces produits. Par exemple, consultez cet article sur les règles courantes.
   
   
3. Construire
   Vous trouverez ici notre template 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 "Stock" doit afficher le stock 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.
   
4. 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 "Paramètres > Paramètres du projet > Activer le projet". Ensuite, retournez à l'aperçu des APIs et sélectionnez "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.