Étape 1 : Ajoutez une nouvelle connexion Douglas
L'API Douglas utilise la plateforme Mirakl, vous aurez donc besoin d'un compte Mirakl pour commencer à envoyer vos produits à Douglas.
Lorsque vous avez un compte Mirakl Douglas, 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 Douglas . Remplissez le nom de votre connexion avec par exemple "Douglas". Puis cliquez sur ''Connecter avec Douglas''. 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 : Ajoutez une nouvelle API Douglas dans Channable
Vous pouvez désormais naviguer dans "Votre projet > APIs" et cliquer sur "+ Ajouter nouvelle API". Veillez à sélectionner la connexion Douglas que vous venez de créer et donner un nom à votre 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 Douglas.
Étape 3 : Créez vos annonces produits dans Channable
Une fois que vous avez créé l'API Douglas, vous pouvez créer vos annonces produits en suivant les étapes ci-dessous dans l'API.
-
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.
-
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.
-
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.
Important : Les APIs Mirakl ne possèdent pas de "Titre" à l'étape Construire. Il y a à la place un champ "Titre du produit" à l'étape Attributs pour connecter votre titre.Remarque : Alors que Mirakl permet habituellement de sélectionner des canaux de vente au sein d'une même boutique, Douglas applique une politique stricte d'un seul canal de vente par boutique. C'est aussi la raison pour laquelle vous ne voyez pas d'onglet 'Canaux de vente' dans cette étape. Pour chaque région, il existe un canal de vente distinct lié à la boutique. Chaque boutique n'a donc accès qu'à un seul canal de vente. Si vous souhaitez vendre dans plusieurs régions, vous devez avoir des boutiques distinctes (et donc des connexions) pour chaque canal de vente. C'est la politique de Douglas. C'est pour cette raison que la "tarification spécifique au canal" n'est pas activée. - Attributs
Bientôt fini ! La prochaine étape consiste à remplir les champs à l'étape Attributs. 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 à Douglas
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 Douglas 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 à Douglas .
Étape 5 : Vérifiez vos listes de produits pour détecter des erreurs
Si vous avez envoyé vos annonces produits à Douglas , 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.
Bonnes pratiques
Ajout de plusieurs valeurs d'attribut : Lorsque vous ajoutez plusieurs valeurs dans un champ d'attribut pour les marketplaces Mirakl, séparez chaque valeur par le symbole "|" pour assurer un traitement correct des valeurs.
ID du produit du vendeur pour les produits simples/uniques : Veuillez noter qu'il existe deux attributs nommés respectivement "SellerArticleId" et "SellerProductId". L'attribut "SellerProductId" fait référence à l'ID parent, tandis que l'attribut "SellerArticleId" fait référence aux produits variants. Pour les produits uniques, les deux attributs doivent être remplis avec la même valeur.
Pour plus d'informations sur les erreurs des marketplaces de Mirakl et les bonnes pratiques à adopter, consultez notre guide dédié.