Configurer une API fonQ

Remarque : Cet article part du principe que vous avez déjà fait de la publicité sur fonQ avec vos produits. Si vous débutez dans la publicité sur fonQ, assurez-vous de savoir comment ajouter des codes EAN inconnus à fonQ. Les codes EAN sont obligatoires pour fonQ. Veillez à disposer de codes EAN valides pour tous vos produits, sinon aucune fiche produit ne pourra être créée pour vos produits.

Vous pouvez passer directement aux étapes détaillées ci‑dessous :

1

Étape 1 : Ajouter une nouvelle connexion fonQ

L'API fonQ utilise la plateforme Mirakl, ce qui signifie que vous aurez besoin d'un compte Mirakl pour commencer à envoyer vos fiches produit à fonQ.

Lorsque vous disposez d'un compte Mirakl fonQ, allez dans Connexions > Ajouter une connexion. Cliquez sur "+ Ajouter une nouvelle connexion" et sélectionnez fonQ. Remplissez le libellé de votre connexion (par exemple : fonQ). Puis cliquez sur « Connecter avec fonQ ». Vous serez redirigé vers l'environnement où vous pourrez vous connecter avec vos identifiants Mirakl. Après connexion, vous serez renvoyé vers Channable où la connexion sera disponible.

2

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

Allez dans l'aperçu des API de votre projet et cliquez sur "+ Ajouter une nouvelle API". Sélectionnez la connexion fonQ que vous avez créée 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 ici si nécessaire. 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 :

• Offre : Une offre n'inclut que les champs de l'étape Build de l'API.

• Produit : Un produit contient plus d'informations qu'une offre (comme une catégorisation et des attributs remplis) et est nécessaire lorsque des articles sont inconnus de fonQ.

Remarque : fonQ NL n'accepte que les soumissions de Produits pour les boutiques basées aux Pays‑Bas. Si votre boutique n'est pas néerlandaise, vous devez envoyer des offres en ne catégorisant pas vos données.

Si vos produits ne sont pas connus de fonQ et que vous n'avez pas de boutique NL, vous devrez créer une boutique NL et configurer une API Produit pour les produits inconnus (les catégoriser et les pousser vers la boutique NL). Une fois acceptés, vous pouvez configurer une seconde API pour créer des offres BE, mais cela peut aussi créer des offres dans la boutique NL ; pour éviter cela, il peut être nécessaire de supprimer l'API NL une fois les produits acceptés.

3

Étape 3 : Créez vos fiches produit dans Channable

Une fois l'API fonQ créée, vous pouvez configurer vos données produit en suivant les étapes de l'API :

1

Catégories

Nous vous conseillons d'essayer d'abord d'envoyer vos produits sans effectuer la catégorisation. Si fonQ connaît déjà les codes EAN de vos produits, vous n'aurez pas besoin de réaliser cette étape. Si les produits ne sont pas encore connus, vous verrez l'erreur suivante dans l'étape Aperçu de l'API : "mirakl_unknown_error_code".

2

Règles

Créer différentes règles pour optimiser vos fiches produit.

3

La étape

Vous trouverez ici notre modèle prédéfini pour les fiches produit. Remplissez‑le en cliquant sur un champ et en sélectionnant la valeur avec laquelle vous souhaitez le remplir (par exemple, définissez le champ Title pour afficher le titre de votre produit). Une fois terminé, cliquez sur Sauvegarder en bas de l'écran.

4

Exigences GPSR et DSA

L'Union européenne (UE) a introduit de nouvelles Exigences GPSR et DSA pour les plateformes en ligne, y compris les places de marché.

Pour votre API fonQ dans Channable, assurez‑vous de remplir l'onglet attributs par catégorie dans l'étape Build :

• Adres Marktdeelnemer : Fournissez l'adresse complète du fabricant ou de l'importateur.

• Email Marktdeelnemer : Saisissez l'adresse e‑mail du fabricant ou de l'importateur.

• Naam Marktdeelnemer : Indiquez le nom du fabricant ou de l'importateur.

• Telefoon Marktdeelnemer : Fournissez un numéro de téléphone valide pour le fabricant ou l'importateur.

5

Étape 4 : Envoyez vos données produit à fonQ

Si vous n'avez pas activé votre projet, allez dans Paramètres du projet à gauche et cliquez sur Activer le projet. Ensuite, revenez à l'aperçu des Canaux, ouvrez « Votre nom d'API fonQ > Paramètres » et activez l'API en sélectionnant « Activer l'API ». Après activation, cliquez sur le bouton bleu « Exécuter » pour envoyer vos fiches produit à fonQ.

6

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

Après l'envoi de vos fiches produit à fonQ, rendez‑vous dans l'onglet Aperçu de votre API fonQ et cliquez sur Erreurs. Vous pouvez voir quelles fiches produit contiennent des erreurs et n'ont pas été créées. Cliquez sur une erreur spécifique pour obtenir plus d'informations.

Bonnes pratiques

Cliquez pour développer les bonnes pratiques

• Ajout de plusieurs valeurs d'attribut : Lors de l'ajout de plusieurs valeurs dans un champ d'attribut pour les places de marché Mirakl, séparez chaque valeur par un symbole pipe "|" afin d'assurer une détection et un traitement corrects.

• ID produit du vendeur pour produits simples/à l'unité : Il existe deux attributs nommés 'SellerArticleId' et 'SellerProductId'. 'SellerProductId' fait référence à l'ID parent, tandis que 'SellerArticleId' se réfère aux variantes. Pour les produits simples, les deux attributs doivent être remplis avec la même valeur.

Pour plus d'informations sur les erreurs Mirakl Marketplace, les modes d'emploi et les bonnes pratiques, consultez notre guide dédié.