Primer envío
Vamos a configurar un flujo completo y enviar el primer mensaje. El ejemplo usa una aplicación MES que recibe datos de pallets.
Crear la Aplicación
En Aplicaciones (/applications), cree una aplicación con la sigla MES. La sigla aparece en
las URL y en los informes, así que use algo corto y estable.
Crear la Interfaz
En Interfaces (/interfaces), cree la interfaz MES_PALLET para la aplicación MES. Elija el
orden de procesamiento:
- Secuencial cuando el orden de los mensajes importa (movimientos de stock, por ejemplo).
- Paralelo cuando el volumen importa más que el orden.
Crear la Definición de Entrega
En Definiciones (/definitions), cree AnyToMES_PalletData apuntando a la interfaz
MES_PALLET. Configure:
- Tipo de entrega:
HTTP_POST - Destino: la URL del sistema MES
- Timeout y reintentos según el SLA del destino
- Transformador: opcional en esta primera vuelta
Generar un API Token
En API Tokens (/api-tokens), genere un token para la aplicación MES. Va en el header
x-api-token de cada petición.
El token solo se muestra en el momento de la creación. Toda copia posterior queda registrada en el historial de copias del token.
Enviar el mensaje
JSON
curl -X POST http://localhost:3000/api/MES_PALLET/AnyToMES_PalletData \
-H "Content-Type: application/json" \
-H "x-api-token: SU_TOKEN_AQUI" \
-d '{"pallet":"PAL001","weight":120.5,"line":"LINE-A"}'Respuesta de éxito:
{
"id_message": "uuid-del-mensaje",
"message_type": "ASYNC",
"return_message": "Message received and queued",
"hasError": false
}Hacer seguimiento
Abra Mensajes (/messages) y busque por el id_message devuelto. La pantalla de detalle
(/messages/:id) muestra el payload completo y el historial de intentos de entrega — incluida la
respuesta del destino en cada uno.
¿Y vía SOAP?
Toda Definición con “Exponer Web Service” activada obtiene automáticamente un endpoint SOAP:
GET /api/ws/MES_PALLET/AnyToMES_PalletData?wsdl ← WSDL generado dinámicamente
POST /api/ws/MES_PALLET/AnyToMES_PalletData ← envelope SOAPLa autenticación puede hacerse por WS-Security UsernameToken dentro del envelope, en lugar del
header x-api-token.
Próximos pasos
- Aplicar un Transformador para adaptar el payload al formato del destino.
- Registrar Errores de Negocio para clasificar respuestas de falla.
- Configurar Alertas para ser avisado cuando algo se detenga.