Configurer une API OTTO

Avant de commencer 

• Si vous êtes nouveau sur OTTO, vous devrez d'abord passer par un processus 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 à 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 : Configuration d'une connexion

Une fois que vous aurez atteint le niveau "prêt à vendre" dans le processus d'inscription chez OTTO, vous recevrez vos identifiants API. Notez que ces informations d'identification seront envoyées par un e-mail automatique et ne peuvent pas être récupérées à partir de votre compte OTTO Partner Connect. Si vous ne trouvez pas cet email, veuillez contacter OTTO. 

Une fois que vous avez reçu vos informations d'identification, allez dans "APIs > Ajouter une nouvelle API".  Un nouvel écran s'ouvre avec les paramètres de l'API où vous pouvez cliquer sur le bouton "+ Ajouter une nouvelle connexion". 

Vous serez redirigé vers un aperçu où vous verrez la connexion OTTO. Sélectionnez cette connexion et saisissez le nom d'utilisateur et le mot de passe que vous avez reçus dans l'e-mail susmentionné. 

Après avoir cliqué sur "Créer", la connexion sera établie et vous pourrez commencer à remplir les informations relatives à vos produits. 

Étape 2 : Créer vos fiches produits dans Channable

Une fois que vous avez créé un nouvel exportateur API en utilisant la connexion nouvellement créée, vous pouvez configurer vos données produit en suivant les étapes de l'API.

1. Catégories
   Pour que vos données produit soient créées, vos produits ont besoin d'une catégorie. Ajoutez des catégories à vos produits en utilisant la fonction d'auto-génération de catégories ou créez de nouvelles catégories à partir de zéro.
   
   
2. Règles
   Créez différentes règles pour optimiser vos données produit. Pour des exemples, consultez notre article sur les règles courantes.
   
   
3. Construire
   Vous trouverez ici notre modèle prédéfini pour les listes de produits. Tout ce que vous avez à faire est de le remplir en cliquant sur le champ lui-même et en sélectionnant ce que vous voulez y mettre. Par exemple, le champ "titre" doit afficher le titre de votre produit, et ainsi de suite. Lorsque vous avez configuré les listes de produits, cliquez simplement sur "Enregistrer" en bas de l'écran.
   Conseil ! Remarquez le point d'interrogation derrière chaque champ. Si vous survolez le point d'interrogation, vous verrez la description du champ et des suggestions de valeurs possibles.
   Remarque : 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 "Attributs" de l'API OTTO dans Channable.
   Attention ! 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.
4. Attributs
   Presque terminé ! Ensuite, il faut remplir les champs de l'étape "Attributs". Sélectionnez d'abord la catégorie que vous souhaitez optimiser. La capture d'écran ci-dessous donne un exemple de ce que vous devriez avoir sous les yeux. Vous trouverez une explication plus détaillée de ce qu'il faut faire dans l'étape "Attributs" dans cet article de notre Centre d'Aide.
   

Étape 3 : Envoyez vos produits vers OTTO

Vos fiches 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 à l'onglet 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 fiches produits à OTTO.

Vos produits et images prendront au moins 24 heures pour être traités. Si vos articles n'ont pas été traités après quelques jours, nous vous suggérons d'envoyer un e-mail à l'aide aux vendeurs OTTO. 

Étape 4 : Résoudre les erreurs

Si vous avez envoyé vos fiches produits à OTTO, allez dans l'onglet "Aperçu" de votre API OTTO et réglez le filtre 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.

Migration vers OTTO API v3

À partir du 31 mars 2023, OTTO n'assurera plus la mise à jour de son API V2. Nous nous sommes donc assurés de supporter entièrement la V3 avant cette date. Il y a une seule chose à laquelle vous devez faire attention après la mise à niveau. Avec la nouvelle version V3 de l'API, vous devrez désormais envoyer à OTTO des ID de marque au lieu de noms de marque.

La meilleure façon de modifier cela est d'utiliser une règle Recherche valeur à l'étape Règles de votre API OTTO. Pour cela, nous vous recommandons de créer un nouveau champ brand_id. Voici à quoi la règle ressemblerait alors:

Avec cette règle, vous pourrez ajouter une liste de marques possibles dans la colonne de gauche et les ID des marques correspondants dans la colonne de droite.

Pour savoir quels ID de marques utiliser, vous pouvez consulter la liste disponible dans ce fichier. 

Si vous vendez des produits avec de nombreuses marques différentes, vous pouvez contacter notre support technique et nous vous aiderons à obtenir les bons ID de marque. Nous pouvons utiliser les marques que vous avez déjà remplies pour créer un fichier reprenant tous les ID de marque correspondants. Vous pourrez alors au choix importer ce fichier, ou copier-coller ces valeurs dans les règles. Nous vous recommandons de les utiliser dans les règles pour ne pas alourdir votre import, mais sachez que les deux solutions sont tout à fait possibles.