Connecter Walmart : recevoir les commandes, renvoyer le fulfillment
Copiez votre Consumer ID et votre Private Key depuis Walmart Developer Portal, collez-les dans Integration, testez, mappez, activez.
Le connecteur Walmart importe les commandes Walmart Marketplace dans OMS et renvoie fulfillment et stock vers Walmart. Il importe aussi les retours et peut pousser les mises à jour produits et stock.
Prérequis#
- Un compte vendeur Walmart Marketplace.
- Accès à Walmart Developer Portal, avec le droit d’ouvrir My apps pour ce compte.
- Une personne capable de conserver la Private Key en sécurité — la clé complète servira en cas de reconnexion ou de rotation.
Obtenir les identifiants#
- Allez dans Walmart Developer Portal → My apps et ouvrez l’app de votre compte Marketplace.
- Copiez le Consumer ID affiché sur cette page.
- Copiez la Private Key sur la même page. Elle est au format PKCS#8 PEM et commence par -----BEGIN PRIVATE KEY----- — copiez tout le texte, première et dernière lignes comprises.
Remplir dans Integration#
- Ouvrez Integration → Marketplace → Walmart → Nouvelle connexion.
- Consumer ID : collez le Consumer ID copié depuis Walmart Developer Portal → My apps. Les deux champs sont obligatoires.
- Private Key : collez la Private Key complète au format PKCS#8 PEM, en commençant par -----BEGIN PRIVATE KEY----- et avec la ligne de fermeture. Les requêtes sont signées avec Consumer ID + Private Key ; la clé est chiffrée au repos et jamais réaffichée.
Tester la connexion#
Cliquez sur Tester la connexion. Le test envoie une requête signée — avec votre Consumer ID et votre Private Key — pour sonder l’API Walmart Marketplace. Un succès signifie que Walmart a accepté la signature et que les identifiants sont utilisables. En cas d’échec, notez l’erreur et consultez la FAQ avant de changer autre chose.
Mapping / choisir un modèle#
Choisissez le modèle standard Walmart. Il mappe numéro de commande, SKU des lignes, quantités, adresse de livraison et statut de fulfillment. Vérifiez l’aperçu avant d’activer, surtout que chaque SKU Walmart est associé au bon produit OMS.
Activer#
Après activation, Integration récupère les nouvelles commandes Walmart Marketplace selon la fréquence définie, importe les retours et renvoie fulfillment avec suivi, mises à jour produits et changements de stock vers Walmart. Surveillez les premières commandes dans Runs / Logs.
FAQ#
Le test échoue avec 401
Walmart a rejeté la signature de la requête de test. La cause la plus fréquente est une Private Key copiée de façon incomplète ou au format abîmé, donc la signature ne peut pas être vérifiée.
Recopiez la Private Key depuis Walmart Developer Portal → My apps et collez le texte complet : ce doit être un PEM PKCS#8 complet, commençant par -----BEGIN PRIVATE KEY----- et se terminant par la ligne de fermeture, sans aucun caractère manquant. Enregistrez puis testez à nouveau.
Le test échoue : Consumer ID non reconnu
Le champ Consumer ID contient une mauvaise valeur : souvent un autre ID a été collé à la place du Consumer ID de cette app, et Walmart ne peut pas associer la requête signée à votre app.
Retournez dans Walmart Developer Portal → My apps, copiez exactement le Consumer ID de cette app, remplacez la valeur dans la connexion, enregistrez puis testez à nouveau.
La connexion fonctionnait, maintenant tous les tests échouent
La clé ou l’app côté Walmart n’est plus valide : par exemple la Private Key a été révoquée, ou l’app a été désactivée dans Walmart Developer Portal. Une clé que Walmart n’accepte plus ne peut signer aucune requête, quel que soit le collage.
Générez une nouvelle Private Key pour l’app dans Walmart Developer Portal, collez la nouvelle clé complète dans la connexion, enregistrez puis testez à nouveau. Conservez la nouvelle clé en lieu sûr : elle n’est entièrement visible qu’à la génération.
Connecté mais aucune commande n’arrive
La connexion est bonne — le test passe — mais Walmart Marketplace n’a pas encore de nouvelles commandes pour ce compte, donc il n’y a rien à importer.
Passez une vraie commande sur votre fiche Walmart Marketplace (ou attendez la prochaine commande client), puis lancez une extraction manuelle et vérifiez Runs / Logs. Les nouvelles commandes apparaissent dès que Walmart les émet.