Conectar Logiwa: enviar pedidos, consultar inventario
Use el correo y la contraseña de una cuenta de Logiwa con acceso a la API en la conexión WMS, pruebe el inicio real por token, mapee y active.
El conector de Logiwa conecta este sistema con Logiwa como sistema externo de almacén. Puede enviar pedidos de envío a Logiwa, de forma individual o en lote, y consultar el inventario guardado en Logiwa. Las confirmaciones de envío vuelven por el Webhook V2 de Logiwa, no por una llamada de sondeo de esta conexión. Esta conexión se configura en el área WMS, no en el asistente de canales, e inicia sesión con usuario y contraseña de Logiwa para obtener un token de sesión.
Requisitos previos#
- Una cuenta de Logiwa a la que pueda acceder. El usuario de esta conexión es el correo de un usuario de Logiwa con acceso a la API.
- La contraseña de ese mismo usuario de Logiwa. No hay una API Key separada que generar para esta conexión: el correo y la contraseña de la cuenta son las credenciales.
- Sabe si debe usar la dirección de servicio predeterminada https://myapi.logiwa.com u otra baseUrl indicada para su entorno de Logiwa. Si nadie le dio otra dirección, deje la predeterminada.
Obtener credenciales#
- Elija el usuario de Logiwa para la integración y confirme que ese usuario tiene acceso a la API. Use un usuario dedicado cuando sea posible, para que un cambio personal de contraseña no rompa la conexión.
- Anote el usuario: la dirección de correo de ese usuario de Logiwa.
- Anote la contraseña de ese mismo usuario. La introducirá una vez en la conexión WMS, donde se guarda como secreto y se usa junto con el usuario para obtener un token.
- Si su entorno de Logiwa le dio una dirección de servicio distinta de la predeterminada, anote también esa baseUrl. En caso contrario, no hay nada más que reunir.
Completar en Integration#
Esta conexión no tiene lista de campos en el asistente de canales. Abra la conexión WMS de Logiwa en Integration y complete los valores siguientes en ese formulario de conexión WMS. No busque Logiwa en los pasos de campos del asistente de canales: el asistente no tiene campos para ella.
- username, obligatorio: el correo del usuario de Logiwa con acceso a la API, exactamente como se usa para entrar en Logiwa.
- password, obligatorio: la contraseña de ese mismo usuario de Logiwa. Es un campo secreto y se envía junto con username cuando el sistema obtiene un token.
- baseUrl, opcional: la dirección de servicio de Logiwa. Déjelo vacío para usar la predeterminada https://myapi.logiwa.com, o complete la dirección distinta indicada para su entorno de Logiwa.
Probar la conexión#
Use la prueba de la conexión WMS. Envía una solicitud real de inicio a la dirección de token bajo su baseUrl, con el username y la password completados, y solo aprueba cuando Logiwa devuelve un token. Si falta username o password, la prueba se detiene con MISSING_CREDENTIALS. Si la solicitud no devuelve token, falla con AUTH_FAILED. Hay dos entradas de prueba que puede encontrar: esta prueba de la conexión WMS es la comprobación real de credenciales descrita aquí, mientras que una prueba mostrada en el asistente de canales no contacta con Logiwa con estas credenciales: no trate un aprobado allí como prueba de que la cuenta de Logiwa funciona. Juzgue la conexión solo por la prueba de la conexión WMS.
Mapping / elegir plantilla#
Elija el mapping estándar de Logiwa. Con él, un pedido de salida de este sistema se convierte en un pedido de envío de Logiwa, y una consulta de inventario lee la lista de inventario de Logiwa para el SKU mapeado. Tras aprobar la prueba, envíe un pedido real y compárelo en Logiwa (referencia, líneas y cantidades) y contraste la cantidad de un SKU con lo que muestra Logiwa, antes de activar. Si un SKU de este sistema nombra de otro modo el mismo producto en Logiwa, corrija ese SKU en el mapping en lugar de renombrar el producto en cualquiera de los sistemas.
Activar#
Tras activar, los pedidos de salida de este sistema se envían a Logiwa como pedidos de envío, uno a uno o en lote, y las consultas de inventario leen las cantidades actuales de Logiwa para los SKU mapeados. Las confirmaciones de envío vuelven por el Webhook V2 de Logiwa, así que mantenga funcionando la entrega por webhook en el lado de Logiwa. Vigile los primeros pedidos en Runs / Logs y en el propio Logiwa antes de dejar la conexión sin supervisión.
Preguntas frecuentes#
La prueba WMS falla con AUTH_FAILED
La solicitud de token llegó a Logiwa pero no devolvió token. La pareja de usuario y contraseña no fue aceptada: el correo no es un usuario de Logiwa con acceso a la API, la contraseña no pertenece a ese usuario, o la baseUrl apunta a un entorno de Logiwa distinto del de la cuenta.
Entre en Logiwa en el navegador con el mismo correo y contraseña para probar que la pareja funciona, confirme que el usuario tiene acceso a la API y vuelva a introducir username y password en la conexión WMS sin recortar nada. Si se indicó otra baseUrl para su entorno, póngala tal cual; en caso contrario, vacíe baseUrl para usar la dirección predeterminada y pruebe de nuevo.
La prueba se detiene con MISSING_CREDENTIALS
Falta username o password en la conexión WMS. La solicitud de token necesita ambos valores, así que la prueba se detiene antes de contactar con Logiwa.
Complete ambos campos en el formulario de conexión WMS (username con el correo del usuario de Logiwa y password con la contraseña de ese usuario), guarde y pruebe de nuevo.
La prueba del asistente de canales aprobó, pero la prueba WMS sigue fallando
Las dos pruebas no son la misma comprobación. El asistente de canales no tiene campos de Logiwa y su prueba no inicia sesión en Logiwa con su username y password, así que un aprobado allí no dice nada sobre la cuenta de Logiwa. Solo la prueba de la conexión WMS hace el inicio real por token.
Ignore el resultado del asistente para esta conexión. Ejecute la prueba de la conexión WMS y trabaje desde su resultado: MISSING_CREDENTIALS significa que falta un campo y AUTH_FAILED significa que la pareja de la cuenta fue rechazada.
Los pedidos se envían, pero Logiwa muestra cantidades distintas
La conexión y el token funcionan (el pedido llegó), pero una línea no coincide: normalmente el SKU del pedido nombra otro producto en Logiwa, o la unidad de la línea difiere entre los dos sistemas.
Compare el pedido enviado línea por línea con el pedido en Logiwa, corrija el mapping de SKU del producto que no coincide, envíe un pedido de prueba nuevo y compárelo de nuevo antes de retomar los pedidos normales.
La consulta de inventario no devuelve nada para un SKU que existe en Logiwa
La consulta de inventario lee la lista de inventario de Logiwa con el SKU mapeado. Si el SKU enviado no es el SKU bajo el que Logiwa guarda el stock, la lista vuelve vacía aunque el producto exista.
Encuentre el SKU exacto en el registro del producto en Logiwa, ponga ese valor en el mapping de este producto y ejecute la consulta de inventario de nuevo.
Los pedidos se envían en Logiwa, pero aquí no llega la confirmación
Las confirmaciones de envío de esta conexión viajan por el Webhook V2 de Logiwa, no por las llamadas de pedidos ni de inventario. Si la entrega por webhook en el lado de Logiwa está detenida o falla, los pedidos y el inventario siguen funcionando mientras las confirmaciones dejan de llegar.
Revise el estado de entrega por webhook en el lado de Logiwa y restáurelo, envíe un pedido de prueba en Logiwa y confirme que la confirmación llega aquí antes de retomar el volumen normal.