Configurer une API Obelink

Obelink est l'un des plus grands magasins de camping avec une vaste gamme de tentes, de caravanes, de camping-cars, de fournitures de camping, d'accessoires, de mobilier de jardin et de sports. Cet article décrit les étapes de la mise en place d'une API Obelink dans Channable.

Étape 1 : Ajouter une nouvelle connexion Obelink

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

Lorsque vous disposez d'un compte Mirakl Obelink, allez dans le menu "[Votre entreprise] paramètres (dans le coin supérieur droit) > Connexions". Cliquez sur "+ Ajouter une nouvelle connexion" puis vous verrez un écran où vous pouvez sélectionner Obelink. Remplissez le nom de votre connexion. Cliquez ensuite sur ''Connecter avec Obelink''. 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éer une nouvelle API Obelink dans Channable

Naviguez jusqu'à l'onglet APIs de votre projet et sélectionnez + Ajouter nouvelle API. Sélectionnez la connexion Obelink que vous venez de créer et donnez un nom à la nouvelle API.

Sélectionnez le champ que vous souhaitez utiliser comme ID unique par produit (nous recommandons le champ "id"), et sélectionnez la Langue pour les catégories et les attributs à configurer. En outre, vous avez la possibilité d'inclure un groupe de règles générales si vous le souhaitez. Cliquez sur "Sauvegarder" pour terminer la création de la nouvelle API Obelink.

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

Une fois que vous avez créé l'API Obelink, vous pouvez créer vos annonces produits en suivant les étapes ci-dessous dans l'API.

1. Catégories
   Pour que vos annonces soient créées, vos produits ont besoin d'une catégorie. Ajoutez des catégories à vos produits en utilisant la fonction de génération de catégories ou créez manuellement de nouvelles catégories.
   
   
2. Règles
   Créez différentes règles pour optimiser vos données produits. Par exemple, jetez un coup d'œil à 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.
   
   
   Astuce ! 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.
   Dans les valeurs statiques de la Catégorie d'envoi, il y a 3 valeurs. Dans le tableau ci-dessous, vous trouverez ces valeurs et leurs explications :
   

   Code	Nom	Explication
   SP	Petit colis	Poids maximum : 3 kg Longueur maximum : 50 cm Circonférence maximum : (2xL + 2xh + 1xl) de 111 cm
   NP	Colis moyen	Poids maximum : 31,5 kg Longueur maximum : 175cm Circonférence maximum : (2xL + 2xh + 1xl) de 300 cm
   NSP	Colis non standard	Le colis a une longueur ou une diagonale supérieure à 130 cm Et/ou poids >35 kg Et/ou colis non stable ou de forme irrégulière (sphère, cylindre, rouleau)

   
   Bien entendu, si cette valeur est différente pour certains de vos produits, vous pouvez remplir ce champ de manière dynamique.
   
   Remarque I : Obelink dispose également d'un champ d'offre supplémentaire, appelé SKU fournisseur. Obelink a spécifié que certains partenaires ont besoin de cet attribut pour compléter la commande. Ce champ est donc ajouté en tant que champ d'offre supplémentaire à l'étape Construire. Si vous disposez de ce SKU fournisseur, vous pouvez le remplir ici, sinon vous pouvez le laisser vide.
   Remarque II : Obelink a plusieurs canaux de vente : obelink.nl, obelink.be et obelink.de, mais ils ne supportent pas la tarification par canal, donc nous n'affichons pas le pop-up de sélection de canal dans les paramètres de l'API et l'onglet supplémentaire à l'étape Construire. Les canaux doivent être activés/désactivés dans votre compte Mirakl ici ou dans Settings > Partner > Channels
4. Attributs
   L'étape suivante consiste à remplir les champs de l'étape Attributs. C'est très important si vous voulez vendre de nouveaux produits qui n'existent pas encore sur la place de marché, et cela évitera l'erreur 'mirakl_unknown_error_code'. Sélectionnez la catégorie que vous voulez optimiser en premier. Vous pouvez trouver un exemple de ce qui devrait apparaître dans la capture d'écran ci-dessous. Pour une explication plus détaillée de la section "Attributs", vous pouvez consulter cet article.
   

Étape 4 : Envoyez vos produits à Obelink

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 > Paramètres de projet > Activer le projet". Ensuite, retournez sur l'onglet APIs et cliquez sur "Paramètres" de votre API Obelink 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" pour envoyer vos annonces produits à Obelink.

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

Si vous avez envoyé vos annonces produits à Obelink, rendez-vous dans l'onglet Résultat de votre API. Cliquez sur l'onglet "Erreurs" pour voir quelles annonces produits contiennent des erreurs et ne sont pas diffusées correctement sur la marketplace. Cliquez sur une erreur spécifique pour obtenir plus d'informations sur la cause de l'erreur. Si vous avez résolu certaines erreurs en changeant les paramètres ou les informations de vos produits, vous pouvez réexécuter l'API pour voir les nouveaux résultats.