Connecter Wayfair : recevoir les commandes, renvoyer le fulfillment

Copiez votre Client ID et votre Client secret depuis Wayfair Partner Home, collez-les dans Integration, testez, mappez, activez.

Le connecteur Wayfair importe les commandes Wayfair dans OMS et renvoie le fulfillment vers Wayfair. Il peut aussi pousser les mises à jour produits et stock, pour que commandes, expéditions et stock restent synchronisés des deux côtés.

Prérequis#

• Un compte fournisseur Wayfair avec accès à Wayfair Partner Home.
• Le droit d’ouvrir les paramètres API dans Wayfair Partner Home — le Client ID et le Client secret y sont affichés.
• Votre Supplier ID Wayfair, si vous poussez le stock ou le tracking — les deux envois l’exigent. La valeur d’exemple du champ est 5000 ; utilisez votre propre ID, pas l’exemple.
• Décidez de l’environnement à connecter d’abord : bac à sable pour un premier essai, production pour les commandes réelles. Bac à sable et production ne partagent pas les commandes, ne les mélangez pas.

Obtenir les identifiants#

1. Connectez-vous à Wayfair Partner Home et ouvrez les paramètres API.
2. Sur cette page, copiez le Client ID.
3. Sur la même page, copiez le Client secret. Conservez-le en lieu sûr — vous le collerez dans Integration à l’étape suivante.
4. Vous n’avez pas besoin d’obtenir un Access token à la main. Laissez ce champ vide dans Integration : le système le génère automatiquement à partir de votre Client ID et de votre Client secret (client_credentials, valable 12 heures) et le renouvelle.

Remplir dans Integration#

1. Ouvrez Integration → Marketplace → Wayfair → Nouvelle connexion.
2. Client ID (obligatoire) : collez le Client ID copié depuis Wayfair Partner Home → Paramètres API.
3. Client secret (obligatoire) : collez le Client secret de la même page. Chiffré au repos, jamais réaffiché.
4. Access token (facultatif) : laissez-le vide. Le système génère automatiquement un token à partir de votre Client ID et de votre Client secret (client_credentials, token de 12 h). Ne le remplissez que si vous voulez délibérément remplacer le token généré par le vôtre.
5. Supplier ID : saisissez votre ID fournisseur Wayfair, par exemple 5000. Il est obligatoire pour le push de stock et le push de tracking — sans lui, ces envois ne peuvent pas fonctionner, même si les commandes peuvent toujours être importées.
6. Mode sandbox : saisissez « true » pour utiliser l’environnement bac à sable de Wayfair. Laissez la valeur par défaut (« false ») pour la production. Réglez-le délibérément — une connexion bac à sable ne voit jamais les commandes de production.

Tester la connexion#

Cliquez sur Tester la connexion. Le test échange votre Client ID et votre Client secret contre un token d’accès et sonde l’API Wayfair, puis affiche un aperçu au niveau document avec une commande réelle, les champs de la plateforme à côté de la commande standard. Si le compte n’a pas encore de commandes, la connectivité peut quand même réussir — passez ou attendez une vraie commande avant de juger l’aperçu, et consultez la FAQ si le test échoue.

Mapping / choisir un modèle#

Choisissez le modèle standard Wayfair. Il mappe numéro de commande, SKU des lignes, quantités et adresse de livraison dans la commande standard, et renvoie fulfillment et tracking au format Wayfair. Vérifiez l’aperçu avant d’activer, surtout que chaque SKU Wayfair est associé au bon produit, pour que le push de stock signale les bons articles.

Activer#

Après activation, Integration récupère les nouvelles commandes Wayfair selon la fréquence définie et renvoie le fulfillment avec suivi, ainsi que les mises à jour produits et stock, vers Wayfair. Surveillez les premières commandes dans Runs / Logs avant de laisser le processus sans surveillance — vérifiez en particulier que le premier push de suivi passe, car il exige le Supplier ID.

FAQ#

Le test échoue : authentification rejetée

Le Client ID ou le Client secret est incorrect, donc Wayfair ne les échangera pas contre un token d’accès. Les deux valeurs forment une paire issue de la même page de paramètres API — mélanger une valeur copiée d’ailleurs, ou un secret auquel il manque un caractère, casse l’échange.

Retournez dans Wayfair Partner Home → Paramètres API, recopiez le Client ID et le Client secret depuis cette même page, remplacez les deux valeurs dans la connexion, enregistrez puis testez à nouveau.

La connexion fonctionnait, puis a commencé à échouer après quelques heures

Un Access token saisi à la main a expiré. Un token obtenu ainsi n’est valable que 12 heures : un token collé dans le champ Access token fonctionne d’abord puis s’arrête, alors que l’échange automatique à partir du Client ID et du Client secret l’aurait renouvelé en continu.

Videz le champ Access token et enregistrez, pour que le système revienne à la génération automatique du token à partir de votre Client ID et de votre Client secret, puis testez à nouveau. N’utilisez le champ manuel que pour un remplacement de courte durée.

Les commandes arrivent, mais le push de stock ou de suivi échoue

Le Supplier ID est manquant ou incorrect. L’import des commandes n’exige que le Client ID et le Client secret, mais le push de stock et le push de suivi exigent aussi votre ID fournisseur Wayfair — champ vide, ID d’un autre ou valeur d’exemple, Wayfair ne peut pas accepter ces envois.

Saisissez votre propre Supplier ID Wayfair dans la connexion (pas l’exemple 5000, sauf si c’est vraiment votre ID), enregistrez, puis relancez le push depuis Runs / Logs.

Le test réussit, mais les commandes réelles n’apparaissent jamais

Le bac à sable et la production ont été confondus. Si le mode sandbox est à « true », la connexion parle à l’environnement bac à sable de Wayfair, qui ne contient que des données de bac à sable — les commandes de production n’y sont jamais visibles, quel que soit le nombre d’extractions.

Pour les commandes réelles, remettez le mode sandbox à « false » (valeur par défaut) et testez à nouveau. Gardez une connexion séparée, nommée clairement, si vous voulez aussi une connexion bac à sable pour les essais.

Connecté mais aucune commande n’arrive

La connexion est bonne — le test passe — mais Wayfair n’a pas encore de nouvelles commandes pour ce compte fournisseur, donc il n’y a rien à importer.

Attendez la prochaine vraie commande sur Wayfair (en mode bac à sable, utilisez une commande de bac à sable), puis lancez une extraction manuelle et vérifiez Runs / Logs. Les nouvelles commandes apparaissent dès que Wayfair les émet.