Skip to Content
Primeros pasosPrimer envío

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

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 SOAP

La 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.