Vers le site principal
  1. Help Center - Channable
  2. APIs
  3. Installation d'autres canaux

Articles dans cette section

Afficher plus

Configurer une API Walmart

Souhaitez-vous apprendre de manière interactive toutes les bases pour la création d'une API export dans Channable? Apprenez comment créer un compte Channacademy dans l'application Channable grâce à cet article du Centre d'aide et commencez avec le cours Bases - APIs.

Walmart est l'une des plus grandes chaînes américaines de supermarchés, avec plus de 10 000 magasins dans 27 pays à ce jour.

La configuration de l'API Walmart dans Channable est assez intuitive, mais il y a un certain nombre de choses à savoir, et vous pouvez les trouver dans cet article.

Table des matières

  1. Préparation
  2. Créer une nouvelle connexion Walmart
  3. Créer une nouvelle API Walmart dans Channable
  4. Créer vos annonces produits dans Channable
  5. Envoyer vos annonces produits à Walmart
  6. Résoudre les erreurs dans vos annonces produits

Préparation

  • Configuration de l'accès à l'API Walmart

    1. Créer un ID client : Vous devez d'abord créer un ID client Walmart et un Client secret qui peuvent être récupérés dans le Walmart Developer Portal (Portail Développeur Walmart). Durant ce processus, vous devrez indiquer avec quel intégrateur vous travaillez, mais aussi quels droits vous voulez nous donner. Au minimum, il est nécessaire de nous accorder les droits dans les encadrés ci-dessous et choisir "Access":

    2. Recevoir les informations d'identification : Une fois que vous avez configuré les autorisations correctement, Walmart vous fournira votre ID client Walmart et un Client secret. Ceux-ci sont essentiels pour créer la connexion avec Walmart dans l'étape suivante.

Étape 1 : Créer une nouvelle connexion Walmart

Pour créer une nouvelle connexion Walmart, suivez les étapes ci-dessous :

  1. 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.
    API_Walmart.jpg
  2. Sur la page des connexions, sélectionnez "+Ajouter une nouvelle connexion".
  3. Recherchez la connexion "Walmart" en naviguant sur les différentes pages. Après avoir trouvé la connexion "Walmart", fournissez les informations suivantes :
    • Nom
    • Client ID
    • Client Secret

    API_Walmart_2.jpg
  4. Cliquez sur "Créer" pour terminer la création de votre connexion Walmart. Vous serez ensuite ramené(e) à la configuration de l'API.

Étape 2 : Créer une nouvelle API Walmart dans Channable

Lorsque vous revenez à l'aperçu de l'API dans votre projet, vous pouvez maintenant sélectionner votre nouvelle connexion avec Walmart et continuer à configurer votre API.

  1. Configurer les paramètres de l'API :
    • Nommez votre API
    • Choisissez l'ID unique par produit. (Nous recommandons le champ 'ID')
      API_Walmart_3.jpg
  2. Créer l'API : Cliquez sur "Continuer" pour créer la nouvelle API Walmart.

Étape 3 : Créer vos annonces produits dans Channable

Remarque : Au cours des prochains mois, nous mettrons progressivement en place Marketplaces V2. Si votre API est sur Marketplaces V1, ces étapes peuvent être différentes. Consultez cet article pour plus d'informations !

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

  1. 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.
  2. 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

  1. 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.

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

  1. Sélectionner une catégorie de produits : Choisissez la catégorie correspondant à votre produit, par exemple vêtements ou meubles.
  2. 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 Walmart

Les informations suivantes sont spécifiques à Walmart.

Onglet Modèle d'expédition

  • ID du modèle d'expédition :
    Pour lier vos produits à des modèles d'expédition spécifiques, vous devez d'abord créer les modèles d'expédition pour vos produits sur Walmart comme expliqué dans cet article de Walmart. Lorsque vous avez fini de créer un modèle, Walmart génère un ID de modèle d'expédition. Vous devrez configurer ou gérer vos modèles d'expédition sur la plateforme de Walmart.



    Chaque modèle que vous créez sur Walmart génère un ID unique de modèle d'expédition. Saisissez cet identifiant dans l'onglet "Construire > Modèles d'expédition" de Channable.

    Pour attribuer différents modèles d'expédition à divers produits, utilisez des champs dynamiques et des règles dans Channable, en veillant à ce que chaque produit corresponde à l'ID de modèle d'expédition correct.

  • ID du centre de distribution :
    Cet ID représente le site américain à partir duquel vos commandes sont expédiées. Comme pour les modèles d'expédition, vous devez configurer et gérer votre modèle de centre de distribution sur Walmart conformément à cet article Walmart. Saisissez cet identifiant dans Channable pour vous assurer que vos produits sont associés au bon centre de traitement.

Remarque : Ces deux IDs sont essentiels et doivent être complétés pour utiliser ces fonctionnalités. Consultez le site Walmart Seller Help pour obtenir des conseils détaillés sur la création et la mise à jour de ces IDs.

Informations complémentaires

Création de variantes pour Walmart

La gestion des variantes de produits sur Walmart nécessite une sélection minutieuse des catégories et une configuration spécifique des attributs :

  1. Sélectionnez la bonne catégorie : Commencez par choisir la catégorie appropriée pour vos produits. Certaines catégories ne prennent pas en charge les variantes, c'est pourquoi la sélection de la bonne catégorie est cruciale pour la configuration des variantes.

  2. Configurer les attributs de variation : Après la sélection de la catégorie, configurez les attributs de variation en remplissant les champs suivants :

    • Variant Group ID : Un identifiant de groupe de variantes : un identifiant qui est partagé par toutes les variantes d'un groupe. Vous pouvez utiliser, par exemple, parent_id ou item_group_id.

    • Variant attribute name : la valeur sur laquelle le groupe de variantes diffère (par exemple, la couleur, la taille).

    • Variant code field : Le champ qui est associé au code de la variante

  3. Saisir les codes de variantes : Saisissez plusieurs codes de variantes en les séparant par une virgule ,. Bien que cela puisse déclencher un message d'erreur dans Channable, vous pouvez l'ignorer car Walmart traitera toujours les valeurs correctement. Ne terminez pas une valeur saisie par une virgule, car Walmart rejettera la saisie.

Étape 4 : Envoyer vos annonces produits à Walmart

Vos annonces produits sont prêtes à être envoyées. Si vous n'avez pas activé votre projet, allez dans "Paramètres > Paramètres du projet > Activer le projet".

Ensuite, retournez à l'aperçu des API et allez à "Votre nom d'API Walmart" > Paramètres > Activer l'API".

Une fois cette étape terminée, retournez à l'aperçu des API et sélectionnez "Exécuter" pour envoyer vos annonces produits à Walmart. Lorsque l'API transmet des produits à Walmart avec succès, ceux-ci passent par plusieurs étapes avant d'être publiés sur Walmart et de pouvoir être commandés par l'utilisateur. 

Mise à jour des annonces Walmart

Après le téléchargement initial, vous verrez des produits marqués comme ayant été poussés avec succès dans Channable, indiquant qu'ils ont été créés sur Walmart sans prix ni stock. Lors du prochain export, Channable mettra à jour ces produits avec leurs prix et stock. Utilisez le tableau de bord Walmart pour surveiller le statut de publication de chaque produit.

Remarque : Walmart a besoin d'environ 4 à 8 heures pour mettre à jour le prix des nouveaux produits et des produits existants.

Étape 5 : Résoudre les erreurs dans vos annonces produits

Après avoir envoyé vos annonces produits à Walmart, allez dans l'onglet "Résultats" de votre API Walmart. 

Pour les erreurs, cliquez sur le filtre "erreur". Vous pouvez maintenant voir quelles annonces produits comportent des erreurs. Cliquez sur une erreur spécifique pour en obtenir des informations sur la cause. Si vous avez résolu certaines erreurs en modifiant les paramètres ou les informations sur les produits, relancez l'API Walmart pour voir les nouveaux résultats.