Conectar Walmart: recibir pedidos y enviar fulfillment
Copie su Consumer ID y Private Key desde Walmart Developer Portal, péguelos en Integration, pruebe, mapee y active.
El conector de Walmart trae pedidos de Walmart Marketplace a OMS y devuelve fulfillment e inventario a Walmart. También trae devoluciones y puede enviar actualizaciones de producto e inventario.
Requisitos previos#
- Una cuenta de vendedor de Walmart Marketplace.
- Acceso a Walmart Developer Portal, con permiso para abrir My apps de esa cuenta.
- Alguien que pueda guardar la Private Key de forma segura: necesitará la clave completa si reconecta o la rota.
Obtener credenciales#
- Vaya a Walmart Developer Portal → My apps y abra la app de su cuenta de Marketplace.
- Copie el Consumer ID que muestra esa página.
- Copie la Private Key de la misma página. Está en formato PKCS#8 PEM y empieza con -----BEGIN PRIVATE KEY-----: copie el texto completo, incluidas la primera y la última línea.
Completar en Integration#
- Abra Integration → Marketplace → Walmart → Nueva conexión.
- Consumer ID: pegue el Consumer ID copiado de Walmart Developer Portal → My apps. Ambos campos son obligatorios.
- Private Key: pegue la Private Key completa en formato PKCS#8 PEM, empezando con -----BEGIN PRIVATE KEY----- e incluyendo la línea de cierre. Las solicitudes se firman con Consumer ID + Private Key; la clave se cifra en reposo y nunca se muestra.
Probar la conexión#
Haga clic en Probar la conexión. La prueba envía una solicitud firmada — con su Consumer ID y Private Key — para sondear la API de Walmart Marketplace. Si pasa, Walmart aceptó la firma y las credenciales sirven. Si falla, anote el error y revise las preguntas frecuentes antes de cambiar otra cosa.
Mapping / elegir plantilla#
Elija la plantilla estándar de Walmart. Mapea número de pedido, SKU de línea, cantidades, dirección de envío y estado de fulfillment. Revise la vista previa antes de activar, sobre todo que cada SKU de Walmart esté vinculado al producto OMS correcto.
Activar#
Tras activar, Integration trae nuevos pedidos de Walmart Marketplace según la frecuencia definida, trae devoluciones y devuelve fulfillment con tracking, actualizaciones de producto y cambios de inventario a Walmart. Vigile los primeros pedidos en Runs / Logs.
Preguntas frecuentes#
La prueba falla con 401
Walmart rechazó la firma de la solicitud de prueba. La causa más común es una Private Key copiada de forma incompleta o con el formato dañado, por lo que la firma no se puede verificar.
Vuelva a copiar la Private Key desde Walmart Developer Portal → My apps y pegue el texto completo: debe ser un PEM PKCS#8 completo, empezando con -----BEGIN PRIVATE KEY----- y terminando con la línea de cierre, sin que falte ningún carácter. Guarde y pruebe de nuevo.
La prueba falla: Consumer ID no reconocido
El campo Consumer ID tiene un valor incorrecto: a menudo se pegó otro ID en lugar del Consumer ID de esta app, y Walmart no puede asociar la solicitud firmada a su app.
Vuelva a Walmart Developer Portal → My apps, copie exactamente el Consumer ID de esa app, reemplace el valor en la conexión, guarde y pruebe de nuevo.
La conexión funcionaba y ahora toda prueba falla
La clave o la app del lado de Walmart ya no es válida: por ejemplo, la Private Key fue revocada o la app fue desactivada en Walmart Developer Portal. Una clave que Walmart ya no acepta no puede firmar solicitudes, se pegue como se pegue.
Genere una Private Key nueva para la app en Walmart Developer Portal, pegue la clave completa nueva en la conexión, guarde y pruebe de nuevo. Guarde la clave nueva en un lugar seguro: solo es totalmente visible al generarla.
Conectado pero no llegan pedidos
La conexión está bien — la prueba pasa — pero Walmart Marketplace aún no tiene pedidos nuevos para esta cuenta, así que no hay nada que traer.
Haga un pedido real en su publicación de Walmart Marketplace (o espere el próximo pedido de un cliente), luego ejecute una extracción manual y revise Runs / Logs. Los pedidos nuevos aparecen una vez que Walmart los emite.