Winkelstraat.nl est une plateforme en ligne qui propose un large éventail de vêtements de luxe et de créateurs de plus de 600 marques haut de gamme. Elle propose des produits exclusifs provenant de boutiques premium situées aux Pays-Bas et en Belgique. Dans cet article, nous vous expliquons comment configurer une API Winkelstraat.nl dans Channable.
Table des matières
- Préparation
- Créez une nouvelle connexion
- Créez l'API
- Créez vos annonces produits dans Channable
- Envoyez vos annonces produits sur Winkelstraat.nl
- Vérifiez que vos annonces produits ne contiennent pas d'erreurs
Préparation
-
Demander les informations d'identification de l'API à Winkelstraat.nl : Pour Winkelstraat, vous avez besoin d'un 'Client ID' et d'un 'Client Secret' afin d'établir une connexion API valide. Pour obtenir ces informations d'identification, vous devez les demander en envoyant un email à contentapi@winkelstraat.nl.
Lorsque vous avez reçu les informations d'identification de Winkelstraat, vous pouvez créer la connexion API dans Channable.
Étape 1 : Créez une nouvelle connexion
Pour créer une nouvelle connexion Winkelstraat, suivez les étapes suivantes:
- Commencez par vous rendre sur la page API de votre projet et cliquez sur le bouton "+Ajouter une nouvelle API". Cette action vous redirigera vers la page des connexions de votre compte.
- Sur la page des connexions, sélectionnez "+Ajouter une nouvelle connexion".
- Recherchez la connexion "Winkelstraat.nl" en naviguant entre les pages. Après avoir trouvé la connexion "Winkelstraat.nl", fournissez les informations suivantes :
- Nom
- Client ID
- Client Secret
- Après avoir rempli les informations requises, cliquez sur "Créer" et la connexion sera validée et créée.
Étape 2 : Créez l'API
Vous pouvez maintenant commencer à créer vos annonces produits. Choisissez votre nouvelle connexion avec Winkelstraat.nl 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')
- Sélectionnez la langue de votre API
- Créer l'API : Cliquez sur "Continuer" pour créer la nouvelle API Winkelstraat.nl.
Étape 3 : Créez 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.
Informations complémentaires pour Winkelstraat.nl
Les informations suivantes sont spécifiques à Winkelstraat.nl, nous expliquons par onglet ce à quoi vous devez faire attention.
Onglet Produit
- L'ID du groupe de produits est obligatoire : ce champ doit être obligatoirement rempli. En général, le champ que vous pouvez utiliser ici s'appelle "item_group_id" ou "parent_id".
- EAN non obligatoire : Pour l'instant, le champ EAN n'est pas obligatoire pour que vos produits soient acceptés par Winkelstraat, mais il est fortement recommandé par Winkelstraat de l'ajouter.
Onglet Attributs par catégories
- Images et description : Ces champs sont obligatoires et doivent être remplis dans l'onglet « Attributs par catégorie ».
Informations complémentaires
- Supprimer des produits de la plateforme : Pour Winkelstraat.nl, il n'est pas possible de supprimer complètement des produits de votre compte. Il suffit de mettre le stock du produit à "0" pour le désactiver sur la plateforme. Si vous devez supprimer vos produits, renvoyez-les avec le stock défini sur "0".
Étape 4 : Envoyez vos annonces produits sur Winkelstraat.nl
Une fois que vous avez terminé la configuration de vos annonces produits, vous pouvez commencer à les envoyer sur Winkelstraat.nl. Si vous n'avez pas encore activé le projet, naviguez vers "Installation > Paramètres du projet" et activez le projet.
Ensuite, retournez à l'onglet "API", allez dans les paramètres de votre API Winkelstraat pour l'activer.
Lorsque vous cliquerez sur "Exécuter" dans l'aperçu de l'API, vos produits seront envoyés sur Winkelstraat.nl.
Étape 5 : Vérifiez que vos annonces produits ne contiennent pas d'erreurs
Pour vérifier s'il y a des erreurs, rendez-vous sur la page Résultats de l'API > onglet Erreurs, où vous verrez les annonces produits qui comportent des erreurs. En cliquant sur une erreur spécifique, vous obtiendrez plus d'informations sur la cause de l'erreur.