Configurer une API Obelink

Obelink est l'un des plus grands magasins de camping avec une large gamme de tentes, caravanes, camping-cars, fournitures de camping, accessoires, mobilier de jardin et articles de sport. Cet article détaille les étapes de configuration d'une API Obelink dans l'outil Channable.

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 produit à Obelink.

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

Ajouter une nouvelle API Obelink dans Channable

Allez à la vue d'ensemble des APIs dans votre projet et cliquez sur Ajouter une nouvelle API. Sélectionnez la connexion Obelink 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 la langue dans laquelle vous effectuez les catégorisations et définissez les attributs. Vous pouvez également ajouter ici un groupe de règles générales si vous le souhaitez. Cliquez sur Continuer pour terminer la création de la nouvelle API Obelink.

Créez vos annonces produits dans Channable

Une fois l'API Obelink créée, configurez vos données produit en suivant les étapes de l'API :

1

Sous Valeurs statiques pour la classe d'expédition il y a 3 valeurs. Dans le tableau ci-dessous, vous trouverez ces valeurs et leurs explications :

Code	Libellé	Explication
SP	Petit colis	Poids max 3 kg ; longueur max 50 cm et circonférence max (2xL + 2xH + 1xP) de 111 cm
NP	Colis normal	Poids max 31,5 kg ; longueur max 175 cm et circonférence max (2xL + 2xH + 1xP) de 300 cm
NSP	Colis non standard	Le colis a une longueur ou une diagonale supérieure à 130 cm ; et/ou un poids >35 kg ; et/ou une forme instable ou irrégulière (sphère, cylindre, rouleau)

Si cette valeur diffère pour certains produits, vous pouvez remplir dynamiquement ce champ.

Remarques :

• Obelink dispose également d'un champ d'offre supplémentaire appelé Supplier SKU. Certains partenaires exigent cet attribut pour finaliser la commande. Ce champ est ajouté comme champ d'offre supplémentaire à l'étape Construire. Si vous avez un Supplier SKU, renseignez-le ici ; sinon, vous pouvez le laisser vide.

• Obelink possède plusieurs canaux de vente : obelink.nl, obelink.be et obelink.de. Ils ne prennent pas en charge la tarification spécifique aux canaux, donc la fenêtre de sélection de canal sur la page des paramètres de l'API et l'onglet supplémentaire dans l'étape Construire ne sont pas affichés. Les canaux doivent être activés/désactivés dans votre back-end Mirakl. ici ou allez dans Paramètres > Partenaire > Canaux

2

Attributs

Remplissez les champs à l'étape Attributs. Ceci est important lors de la vente de nouveaux produits qui n'existent pas encore sur la marketplace — cela aide à éviter le mirakl_unknown_error_code. Sélectionnez d'abord la catégorie que vous souhaitez optimiser.

Une explication plus détaillée de ce qu'il faut faire à l'étape Attributs est disponible ici : Marketplaces : étape Construire

Envoyez vos produits à Obelink

Si vous n'avez pas activé votre projet, allez dans Installation > Paramètres du projet sur le côté gauche de l'écran et cliquez sur Activer le projet. Ensuite, revenez à la vue d'ensemble des APIs, ouvrez « Votre nom d'API Obelink > Paramètres » et activez l'API en sélectionnant Activer l'API. Après cela, revenez à la vue d'ensemble des APIs et cliquez sur le bouton bleu « Exécuter » pour envoyer vos annonces produit à Obelink.

Vérifiez vos annonces produits pour détecter les erreurs

Après avoir envoyé vos annonces produit à Obelink, allez dans l'onglet Résultats de votre API Obelink. Utilisez le filtre sur « erreur » pour voir quelles annonces produit présentent des erreurs et ne sont pas publiées. Cliquez sur une erreur spécifique pour voir plus d'informations sur la cause. Si vous corrigez des erreurs en modifiant les paramètres ou les informations produit, relancez l'API Obelink pour voir les résultats mis à jour. La création de nouveaux produits entraîne souvent des erreurs dans l'onglet Résultats jusqu'à leur approbation par Obelink.

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.

Identifiant produit du vendeur pour produits simples : 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 de la marketplace Mirakl, les guides pratiques et les bonnes pratiques, consultez le guide Mirakl : Guide Mirakl : paramètres et solutions