Table des matières
- Préparation
- Créer une connexion
- Créer votre API
- Créer vos annonces produits dans Channable
- Envoyer vos annonces produits vers OTTO
- Vérifier que vos annonces produits ne contiennent pas d'erreurs
Préparation
- Si vous êtes nouveau/elle sur OTTO, vous devrez d'abord passer par un processus d'onboarding et d'inscription. Vous pouvez en savoir plus sur ce processus ici.
- OTTO impose quelques conditions aux partenaires souhaitant vendre sur sa marketplace, que vous trouverez ici (en anglais ou allemand). Nous vous recommandons de les lire attentivement avant de configurer l'API OTTO. Si vous remplissez ces conditions et que vous vous êtes inscrit(e) à un compte OTTO Partner Connect, nous pouvons commencer à configurer l'API !
- Si vous souhaitez utiliser une connexion commande pour la marketplace OTTO, nous vous recommandons vivement de lire notre article sur la configuration d'une connexion commande pour OTTO.
- Veuillez noter que notre API supprime toutes les annonces existantes dans votre compte vendeur OTTO lorsque l'API est activée pour la première fois.
Étape 1 : Créer une connexion
Allez dans APIs > +Ajouter nouvelle API. Sur l'écran qui s'affiche, cliquez sur le bouton "+ Ajouter une nouvelle connexion".
Vous serez redirigé(e) vers une vue d'ensemble où vous verrez la connexion OTTO OAuth.
Cliquez sur le bouton "Connecter avec OTTO OAuth". Vous serez alors redirigé(e) vers l'environnement d'OTTO où vous pourrez vous connecter à votre compte OTTO.
Après l'autorisation, vous serez redirigé(e) vers Channable pour confirmer et attribuer un nom à la connexion. Nous vous recommandons de lui donner un nom reconnaissable afin de l'identifier facilement.
Étape 2 : Créer votre API
Vous pouvez maintenant commencer à créer vos annonces produits. Choisissez votre nouvelle connexion avec OTTO et continuez à configurer votre API.
-
Configurer les paramètres de l'API :
- Nommez votre API
-
Choisissez l'ID unique par produit. (nous recommandons le champ 'id')
- Créer l'API : Cliquez sur "Continuer" pour créer la nouvelle API OTTO.
Étape 3 : Créer vos annonces produits dans Channable
Pour configurer votre API, suivez les étapes décrites ci-dessous. Cliquez sur chaque étape pour afficher les instructions détaillées, qui vous guideront tout au long du processus.
1. Catégorisation
Pour que vos données produit soient créées, vos produits ont besoin d'une catégorie. Ajoutez des catégories à ces derniers en utilisant la fonction de génération de catégories, ou créez de nouvelles catégories à partir de zéro.
- Smart Categorization : Cette fonction attribue automatiquement des catégories à vos produits sur la base de critères prédéfinis, ce qui simplifie le processus de catégorisation.
- Catégorisation manuelle : Attribuez manuellement des catégories à vos produits en définissant des règles spécifiques. Vous pouvez créer des filtres détaillés pour associer chaque produit à la bonne catégorie.
- Produits non catégorisés : Examinez et catégorisez tous les produits qui ne le sont pas encore afin de vous assurer qu'ils sont tous correctement organisés.
Cliquez ici pour en savoir plus sur la catégorisation dans les APIs.
2. Règles
Créez différentes règles pour optimiser les données relatives à vos produits. Pour des exemples, reportez-vous à notre article d'aide sur les règles les plus courantes.
- Configuration des règles : Définissez diverses règles pour affiner les données relatives à vos produits. Il peut s'agir de filtrer, de modifier ou d'améliorer les champs de données pour répondre aux exigences de la marketplace.
Cliquez ici pour en savoir plus sur la mise en place de règles dans les APIs.
3. Construire
L'étape Construire dans Channable vous permet de configurer tous les attributs nécessaires pour vos produits, en veillant à ce que les données soient conformes aux exigences de la marketplace. Cette étape est cruciale pour réussir la mise en ligne des produits et pour éviter les erreurs.
3.1 Vue d'ensemble
- Accéder à l'étape Construire : Commencez par accéder à l'interface centralisée de l'étape Construire. C'est là que vous gérerez et attribuerez tous les attributs du produit.
- Identifier les champs obligatoires et optionnels : Les champs obligatoires sont indiqués en rose, ce qui indique qu'ils sont essentiels pour la mise en ligne de vos produits. Les champs optionnels sont marqués en jaune et peuvent être remplis en fonction de besoins spécifiques.
3.2 Renseigner les attributs partagés
-
Renseigner les attributs partagés : Saisissez les détails communs qui s'appliquent à tous les produits, tels que l'EAN, les prix et les titres. Cette étape garantit l'uniformité des informations de base sur les produits dans l'ensemble de vos annonces produits.
-
Utiliser des valeurs statiques ou dynamiques :
- Valeurs statiques : Saisissez directement des valeurs qui restent constantes, comme le nom de la marque ou du fabricant.
- Valeurs dynamiques : Utilisez des champs qui se mettent automatiquement à jour en fonction des données liées, ce qui est idéal pour les variables telles que les niveaux de stock ou les prix.
-
Utiliser des valeurs statiques ou dynamiques :
Après avoir indiqué les valeurs souhaitées pour les attributs partagés, passez aux attributs par catégorie ci-dessous.
3.3 Spécifier des attributs par catégorie
- Sélectionner une catégorie de produits : Choisissez la catégorie correspondant à votre produit, par exemple vêtements ou meubles.
- Catégorie - attributs spécifiques : Renseignez les attributs spécifiques à la catégorie sélectionnée, tels que la taille pour les vêtements ou les dimensions pour les meubles. Cette étape permet d'affiner vos annonces en fonction des exigences de la catégorie. Ici encore, vous pouvez utiliser des valeurs statiques ou dynamiques.
Cliquez ici pour en savoir plus sur l'étape Construire de vos APIs.
4. Qualité
L'étape Qualité fournit un retour d'information instantané sur la qualité de la configuration, en mettant en évidence les erreurs obligatoires et optionnelles afin de garantir que les données relatives à vos produits répondent aux normes des marketplaces.
Actions
- Voir les produits : Pour voir les produits présentant des problèmes spécifiques.
- Voir dans Construire : Redirige vers l'étape Construire pour lier les informations manquantes.
- Catégoriser : Renvoie à l'étape Catégorisation pour classer les produits.
- Source : Disponible pour les champs IDs, dirige vers l'étape Paramètres.
Cliquez ici pour en savoir plus sur l'étape Qualité de vos APIs.
5. Aperçu
L'étape Aperçu affiche les attributs mappés de plusieurs produits et met en évidence les erreurs avant l'export vers la marketplace.
Caractéristiques
- Rechercher et filtrer : Recherchez des produits spécifiques ou filtrez par message d'erreur/catégorie.
- Vue d'ensemble des produits : Affiche tous les produits à exporter; elle peut être filtrée pour n'afficher que les produits comportant des erreurs.
- Aperçu détaillé du produit : Affiche les informations manquantes et les actions pour corriger les erreurs.
Checklist pour la finalisation des attributs
- Examiner les attributs partagés : Assurez-vous que tous les attributs partagés obligatoires sont remplis.
- Examiner les attributs par catégorie : Veillez à ce que tous les attributs obligatoires spécifiques à chaque catégorie soient remplis.
- Vérifier les erreurs : Corrigez les champs indiqués en rouge.
Cliquez ici pour en savoir plus sur l'étape Aperçu de vos APIs.
6. Résultat
L'étape Résultat fournit une vue d'ensemble des résultats de la configuration de l'API, y compris les annonces correctes, les erreurs et un aperçu des produits envoyés. Cette étape permet de s'assurer que vos données produits sont correctement traitées et d'identifier les problèmes à résoudre.
- Vue d'ensemble : Indique l'état de vos annonces produits, en mettant en évidence les erreurs et les problèmes pour obtenir des informations détaillées.
- Aperçu des produits : Affiche une vue d'ensemble des produits à envoyer à la marketplace, permettant de vérifier que les attributs sont correctement remplis.
- Correctes : Liste des produits traités avec succès et prêts à être diffusés sur la plateforme.
- Erreurs : Identifie les erreurs en fournissant des informations détaillées pour les résoudre.
Les onglets supplémentaires tels que les erreurs de Repricer, l'historique des événements du Repricer, les mises à jour des stocks et les mises à jour de l'exécution des commandes n'apparaissent que s'ils sont pertinents pour l'API que vous utilisez. Cliquez ici pour en savoir plus sur l'étape Résultat de vos APIs.
Exigences supplémentaires pour OTTO
- Référence produit : La Référence produit dans l'onglet "Construire" regroupe toutes les variantes que vous souhaitez combiner en un seul produit. Elle n'est pas visible par vos clients. La Référence produit peut être attribuée librement et peut comporter 50 caractères maximum. OTTO reconnaît alors les produits qui ont la même référence produit et crée automatiquement des variantes, par exemple des tailles, des couleurs, etc. différentes. Vous pouvez définir ce qui distingue les variantes à l'étape Construire de l'API OTTO dans Channable.
- MOIN : Après la création des produits, OTTO attribue un MOIN (My OTTO Integration Number) à un produit. Il s'agit d'un identifiant unique utilisé uniquement sur OTTO. Si vous téléchargez des informations sur un produit qui existe déjà sur OTTO, OTTO affichera une erreur indiquant que les informations sur le produit existant doivent être utilisées. Pour accepter l'utilisation de ces informations produit existantes, réglez le champ "Accepter la suggestion de MOIN" sur "true". Si vous ne souhaitez pas accepter les informations produit suggérées par OTTO, contactez le service d'aide aux partenaires OTTO.
Étape 4 : Envoyer vos annonces produits vers OTTO
Vos annonces produits sont maintenant prêtes à être envoyées. Si vous n'avez pas activé votre projet, allez dans "Paramètres > Paramètres du projet" sur le côté gauche de l'écran et cliquez sur "Activer le projet". Ensuite, retournez dans les APIs et allez à "[Nom de votre OTTO API] > Paramètres" où vous activez l'API en sélectionnant "Activer l'API".
Une fois cette étape terminée, revenez à l'onglet APIs et cliquez sur le bouton bleu "Exécuter" pour commencer à envoyer vos annonces produits à OTTO.
Remarques importantes :
- Suppression des annonces existantes : La première fois que vous utilisez notre API pour envoyer des produits, toutes les annonces existantes dans votre compte vendeur OTTO sont supprimées.
- Restriction d'affichage : Si vous êtes nouveau/elle sur OTTO ou si c'est la première fois que vous y vendez et que vous avez réussi à envoyer des produits de Channable vers votre compte vendeur OTTO, vous rencontrerez une restriction d'affichage. Lisez ici comment vous pouvez enlever cette restriction d'affichage et sachez qu'il existe différents flux de travail (voir "Hinweis" dans l'article) selon le moment où l'onboarding a été effectué.
- Vérification : La mention "Correcte" dans l'onglet "Résultat" ne signifie pas forcément que vos produits sont en ligne sur OTTO ou qu'il n'y a pas d'erreurs ou d'avertissements dans les données soumises. Le terme "Correcte" signifie que vos produits ont été envoyés avec succès à la zone de transit des produits (dans votre interface graphique OTTO, visible sous "Produktübersicht"). Les erreurs potentielles expliquant pourquoi les produits ne sont pas (encore) en ligne sont également affichées ici.
- Temps de traitement : Vos produits et images prendront au moins 24 heures pour être traités. Si vos produits n'ont pas été traités après quelques jours, nous vous suggérons d'envoyer un e-mail à OTTO Seller Help.
Étape 5 : Vérifier que vos annonces produits ne contiennent pas d'erreurs
Si vous avez envoyé vos annonces produits à OTTO, allez dans l'onglet "Résultat" de votre API OTTO et cliquez sur "Erreur" pour voir quels produits sont en erreur et ne sont pas en ligne. Cliquez sur une erreur spécifique pour obtenir plus d'informations sur la cause de l'erreur.