Conectar Lowe's: recibir pedidos y enviar fulfillment
Encuentre la URL base de la API de Mirakl en la documentación de la API de su portal de vendedor Mirakl de Lowe's, copie su clave API desde nombre de usuario → API Key, pegue ambas en Integration, pruebe, mapee y active.
El conector de Lowe's trae pedidos de su tienda en el marketplace de Lowe's a OMS mediante Mirakl y devuelve fulfillment a Lowe's. También puede enviar actualizaciones de producto e inventario, para que pedidos, envíos y stock queden sincronizados en ambos lados. Una conexión apunta a un solo entorno Mirakl de Lowe's: la URL base de la API y la clave API deben pertenecer a ese mismo entorno.
Requisitos previos#
- Una cuenta de vendedor del marketplace de Lowe's, con acceso al portal de vendedor Mirakl de Lowe's de esa tienda.
- Permiso en el portal de vendedor Mirakl para ver la documentación de la API y generar una clave API para su usuario: el conector se autentica con esa clave.
- Su propio entorno Mirakl de Lowe's listo para copiar: la URL base de la API es específica de su entorno y no es la misma para todos los marketplaces Mirakl, así que no tome prestada la dirección de otra tienda Mirakl.
Obtener credenciales#
- Inicie sesión en el portal de vendedor Mirakl de Lowe's y abra la documentación de la API de su portal de vendedor. Encuentre allí la URL raíz de la API: se ve como https://<your-env>/api. Copie la dirección completa tal como se muestra para su entorno.
- En el mismo portal de vendedor, haga clic en su nombre de usuario arriba a la derecha y luego abra API Key.
- En la página API Key, elija Generate New Key si aún no tiene una clave, o Copy para copiar la que ya tiene. Guarde la clave en un lugar seguro: la pegará en Integration en el paso siguiente, y se envía como valor de la cabecera Authorization en cada solicitud.
Completar en Integration#
- Abra Integration → Marketplace → Lowe's → Nueva conexión.
- URL base de la API de Mirakl: pegue la URL raíz de la API que encontró en la documentación de la API de su portal de vendedor Mirakl de Lowe's, por ejemplo https://<your-env>/api. Pegue solo la dirección de su propio entorno de Lowe's: una dirección de otra instancia Mirakl llegará al marketplace equivocado, aunque el formato parezca correcto.
- Clave API: pegue la clave API que copió desde el portal de vendedor Mirakl de Lowe's → su nombre de usuario (arriba a la derecha) → API Key. Este campo es obligatorio, se envía como valor de la cabecera Authorization, se cifra en reposo y nunca se muestra.
Probar la conexión#
Haga clic en Probar la conexión. La prueba usa la URL base de la API de Mirakl y la clave API que completó para llegar a su entorno Mirakl de Lowe's y comprobar que la clave es aceptada como cabecera Authorization. Si pasa, la dirección llegó al entorno correcto y la clave funciona. Si falla, anote el error y revise las preguntas frecuentes antes de cambiar otra cosa: la mayoría de los fallos vienen de la clave o de que la URL base apunta a la instancia Mirakl equivocada.
Mapping / elegir plantilla#
Elija la plantilla estándar de Lowe's. Mapea número de pedido, SKU de línea, cantidades, dirección de envío y estado de fulfillment entre Lowe's (Mirakl) y el pedido estándar, y lleva los campos de producto e inventario que se usan al enviar actualizaciones. Revise la vista previa antes de activar, sobre todo que cada SKU de Lowe's esté vinculado al producto OMS correcto.
Activar#
Tras activar, Integration trae nuevos pedidos de Lowe's según la frecuencia definida, devuelve fulfillment con números de rastreo a Lowe's y envía actualizaciones de producto e inventario. Vigile los primeros pedidos en Runs / Logs antes de dejarlo sin supervisión.
Preguntas frecuentes#
La prueba falla: la clave API no es aceptada
La clave API de la conexión es incorrecta o ya no es válida: por ejemplo se copió incompleta, pertenece a otro usuario, o se generó una clave nueva y la antigua guardada en la conexión ya no es la actual. Como la clave se envía como cabecera Authorization en cada solicitud, Mirakl rechaza cada solicitud en la puerta cuando no reconoce la clave.
Vaya al portal de vendedor Mirakl de Lowe's, haga clic en su nombre de usuario arriba a la derecha → API Key y copie la clave actual completa — o elija Generate New Key si necesita una nueva — y luego péguela en el campo API key de la conexión. Guarde y pruebe de nuevo.
La prueba falla o llega a la tienda equivocada: la URL base de Mirakl es incorrecta
El campo de URL base de la API de Mirakl tiene una dirección que no pertenece a su entorno de Lowe's. La causa más común es pegar la dirección de otra instancia Mirakl: otro marketplace u otro entorno que también funciona con Mirakl. Esa dirección puede parecer perfectamente válida, pero apunta a otro lugar, así que su clave API de Lowe's no coincide allí y la prueba no puede llegar a su tienda de Lowe's.
Vaya al portal de vendedor Mirakl de Lowe's y abra de nuevo la documentación de la API de su portal de vendedor. Copie la URL raíz de la API que se muestra allí para su entorno — se ve como https://<your-env>/api — reemplace la URL base de la API de Mirakl de la conexión con esa dirección exacta, guarde y pruebe de nuevo. No reutilice una dirección copiada de otra tienda Mirakl.
Conectado pero no llegan pedidos
La conexión está bien — la prueba pasa — pero su tienda de Lowe's aún no tiene pedidos nuevos, así que no hay nada que traer.
Revise primero el portal de vendedor Mirakl de Lowe's para confirmar si realmente se emitió un pedido nuevo para su tienda. Si se emitió, ejecute una extracción manual y revise Runs / Logs. Si el portal tampoco muestra pedidos nuevos, espere el próximo pedido de un cliente: los pedidos nuevos aparecen en Integration una vez que Lowe's los emite.