LogisticsWMS API & Webhooks

Para qué sirve

Permite que sistemas externos (tu ERP, e-commerce a medida, herramientas de BI, etc.) se comuniquen con el WMS de dos formas complementarias: webhooks y API REST.

Cómo funciona

• 🔔 Webhooks (WMS → exterior): el WMS envía automáticamente datos a tus sistemas cuando ocurren eventos (p. ej. pedido creado, stock actualizado). Configura, por operación, la URL de destino; las peticiones salientes se autentican con usuario / contraseña (HTTP Basic Auth).
• 🔑 Clientes API (exterior → WMS): los sistemas externos se autentican y llaman a la API del WMS directamente para consultar o modificar datos, en /api/external/v1/.
  1. Crea un cliente API — se generan un Client ID y un Client Secret (el secreto solo se muestra una vez).
  2. Intercambia las credenciales por un token JWT válido durante 1 hora: POST /api/external/v1/auth/token.
  3. Usa el token como Authorization: Bearer <token> en todas las llamadas siguientes.
• Cada cliente API se puede activar / desactivar, regenerar su secreto o eliminar — sin afectar a los demás.
• Todas las llamadas (webhooks y clientes API) quedan registradas en la pestaña de Auditoría.
• La documentación técnica completa está en Swagger.

Cómo configurarlo

1. Activa el plugin en Plugins → Otras Integraciones.
2. En los Ajustes Generales, activa las operaciones que quieres exponer y sus valores predeterminados (p. ej. si los productos creados vía API llevan siempre lote / fecha de caducidad).
3. Para notificar a sistemas externos: configura las URLs de webhooks y las credenciales de autenticación saliente en la pestaña Webhooks.
4. Para permitir llamadas al WMS: crea uno o varios Clientes API en la pestaña correspondiente y comparte las credenciales con quien vaya a consumir la API.

Notas importantes

• Guarda el Client Secret en un lugar seguro nada más generarse — no se volverá a mostrar. Si lo pierdes, regenéralo.
• Las URLs de webhook deben ser públicamente accesibles para que el WMS pueda entregar las notificaciones.
• Para obtener el client_id / client_secret iniciales, envía un email a [email protected] indicando la empresa cliente de LogisticsWMS.

💡 Consejo: dentro de la aplicación, la página de configuración de cada plugin tiene un botón Guía de Integración con el paso a paso técnico detallado.