Conectar Wayfair: recibir pedidos y enviar fulfillment
Copie su Client ID y Client secret desde Wayfair Partner Home, péguelos en Integration, pruebe, mapee y active.
El conector de Wayfair trae pedidos de Wayfair a OMS y devuelve fulfillment a Wayfair. También puede enviar actualizaciones de producto e inventario, para que pedidos, envíos y stock estén sincronizados en ambos lados.
Requisitos previos#
- Una cuenta de proveedor de Wayfair con acceso a Wayfair Partner Home.
- Permiso para abrir la configuración de API en Wayfair Partner Home: allí se muestran el Client ID y el Client secret.
- Su ID de proveedor de Wayfair, si va a enviar inventario o tracking: ambos envíos lo requieren. El valor de ejemplo del campo es 5000; use su propio ID, no el ejemplo.
- Decida qué entorno conectar primero: sandbox para una primera prueba, producción para pedidos reales. Sandbox y producción no comparten pedidos, así que no los mezcle.
Obtener credenciales#
- Inicie sesión en Wayfair Partner Home y abra la configuración de API.
- En esa página, copie el Client ID.
- En la misma página, copie el Client secret. Guárdelo en un lugar seguro: lo pegará en Integration en el siguiente paso.
- No necesita obtener un token de acceso a mano. Deje ese campo vacío en Integration y el sistema lo genera automáticamente con su Client ID y Client secret (client_credentials, válido 12 horas) y lo mantiene renovado.
Completar en Integration#
- Abra Integration → Marketplace → Wayfair → Nueva conexión.
- Client ID (obligatorio): pegue el Client ID copiado de Wayfair Partner Home → Configuración de API.
- Client secret (obligatorio): pegue el Client secret de la misma página. Se cifra en reposo y nunca se muestra.
- Token de acceso (opcional): déjelo vacío. El sistema genera un token automáticamente con su Client ID y Client secret (client_credentials, token de 12h). Solo complételo si quiere reemplazar deliberadamente el token generado por uno propio.
- ID de proveedor: escriba su ID de proveedor de Wayfair, por ejemplo 5000. Es obligatorio para el push de inventario y el push de tracking: sin él esos envíos no pueden ejecutarse, aunque los pedidos sí se puedan traer.
- Modo sandbox: escriba "true" para usar el entorno sandbox de Wayfair. Déjelo en el valor por defecto ("false") para usar producción. Ajústelo a propósito: una conexión sandbox nunca ve pedidos de producción.
Probar la conexión#
Haga clic en Probar la conexión. La prueba intercambia su Client ID y Client secret por un token de acceso y sondea la API de Wayfair, luego muestra una vista previa a nivel de documento con un pedido real, campos de la plataforma junto al pedido estándar. Si la cuenta aún no tiene pedidos, la conectividad puede pasar igualmente: haga o espere un pedido real antes de juzgar la vista previa, y vea las preguntas frecuentes si la prueba falla.
Mapping / elegir plantilla#
Elija la plantilla estándar de Wayfair. Mapea número de pedido, SKU de línea, cantidades y dirección de envío al pedido estándar, y devuelve fulfillment y tracking en formato Wayfair. Revise la vista previa antes de activar, sobre todo que cada SKU de Wayfair esté vinculado al producto correcto, para que el push de inventario informe los artículos correctos.
Activar#
Tras activar, Integration trae nuevos pedidos de Wayfair según la frecuencia definida y devuelve fulfillment con tracking, además de actualizaciones de producto e inventario, a Wayfair. Vigile los primeros pedidos en Runs / Logs antes de confiar en el proceso sin supervisión; en particular, compruebe que el primer push de tracking pase, porque necesita el ID de proveedor.
Preguntas frecuentes#
La prueba falla: la autenticación es rechazada
El Client ID o el Client secret son incorrectos, así que Wayfair no los intercambiará por un token de acceso. Los dos valores forman un par de la misma página de configuración de API: mezclar un valor copiado de otro lugar, o un secret al que le falte un carácter, rompe el intercambio.
Vuelva a Wayfair Partner Home → Configuración de API, copie de nuevo el Client ID y el Client secret de esa misma página, reemplace ambos valores en la conexión, guarde y pruebe de nuevo.
La conexión funcionaba y empezó a fallar tras unas horas
Un token de acceso completado a mano ha caducado. Un token obtenido así solo es válido 12 horas, por lo que un token pegado en el campo Token de acceso funciona al principio y luego deja de funcionar, mientras que el intercambio automático con Client ID y Client secret lo habría seguido renovando.
Borre el campo Token de acceso y guarde, para que el sistema vuelva a generar el token automáticamente con su Client ID y Client secret, y pruebe de nuevo. Use el campo manual solo para una anulación de corta duración.
Los pedidos llegan, pero el push de inventario o tracking falla
El ID de proveedor falta o es incorrecto. Traer pedidos solo necesita el Client ID y el Client secret, pero el push de inventario y el push de tracking también necesitan su ID de proveedor de Wayfair: con el campo vacío, con el ID de otra persona o con el valor de ejemplo, Wayfair no puede aceptar esos envíos.
Complete su propio ID de proveedor de Wayfair en la conexión (no el ejemplo 5000, salvo que ese sea realmente su ID), guarde y vuelva a ejecutar el push desde Runs / Logs.
La prueba pasa, pero los pedidos reales nunca aparecen
Se mezclaron sandbox y producción. Si el modo sandbox está en "true", la conexión habla con el entorno sandbox de Wayfair, que solo contiene datos de sandbox: los pedidos de producción nunca se ven allí, por mucho que extraiga.
Para pedidos reales, ponga el modo sandbox en "false" (el valor por defecto) y pruebe de nuevo. Mantenga una conexión separada, con un nombre claro, si también quiere una conexión sandbox para pruebas.
Conectado pero no llegan pedidos
La conexión está bien — la prueba pasa — pero Wayfair aún no tiene pedidos nuevos para esta cuenta de proveedor, así que no hay nada que traer.
Espere el próximo pedido real en Wayfair (en modo sandbox, use un pedido de sandbox), luego ejecute una extracción manual y revise Runs / Logs. Los pedidos nuevos aparecen una vez que Wayfair los emite.