Este documento describe la información técnica que puede observarse durante la ejecución de integraciones en FlexiPaaS, desde una perspectiva pública y funcional. Su objetivo es definir el comportamiento observable del sistema durante la ejecución, los estados posibles, los tipos de errores y la información que se registra, sin entrar en detalles internos de implementación.

Este contenido complementa la documentación operativa de monitoreo, aportando claridad técnica sobre qué significa lo que el usuario ve en la plataforma.

Estados de una ejecución

Una ejecución de integración en FlexiPaaS puede atravesar estados intermedios y finalizar en un estado final. Estos estados permiten comprender en qué punto se encuentra el proceso y cuál fue su resultado.

Estados finales

Los estados finales indican que la ejecución ya no continuará.

End (Finalizada correctamente)

• La integración finalizó de manera exitosa.
• Todos los pasos definidos en el flujo se ejecutaron correctamente.
• No se detectaron errores de datos ni de comunicación.

Error

En este estado, la ejecución no se reintenta automáticamente. Para continuar, es necesario corregir los datos y volver a ejecutar el proceso

• La ejecución se interrumpió debido a un error no recuperable.
• El proceso no puede continuar sin intervención.
• Ejemplos de causas habituales:
  • Datos con formato incorrecto.
  • Campos obligatorios ausentes.
  • Inconsistencias en la información recibida.
  • Fallas en operaciones que no admiten reintento.
• .

Reintentable

La ejecución no pudo completarse debido a un problema externo temporal.

• El error no está relacionado con los datos, sino con la disponibilidad de un recurso externo.
• Ejemplos de causas habituales:
  • API externa no disponible.
  • Problemas de conectividad.
  • Timeouts en servicios externos.
• Política de reintentos
  • FlexiPaaS aplica una política automática de reintentos de hasta 5 reintentos.
  • Un reintento por minuto.
  • Si luego de los reintentos el problema persiste, la ejecución finaliza en estado Reintentable, sino sigue su ciclo de ejecucion.
• Reintento manual
  • Cuando una ejecución finaliza en estado Reintentable luego de agotar los reintentos automáticos, es posible reintentarla de forma manual desde la consola.
  • El reintento manual puede ejecutarse desde:
    • El detalle de la ejecución.
    • La sección de Configuración y logs, donde se encuentra disponible un botón Reintentar.
      Al ejecutar un reintento manual, la integración vuelve a procesarse desde el paso donde no pudo conectarse y puede finalizar en alguno de los siguientes estados:
      • End: si la ejecución completa correctamente.
      • Error: si ocurre un error no recuperable en algún paso posterior.
      • Reintentable: si vuelve a producirse un problema externo o una falla que admite reintento.
        En caso de que la ejecución vuelva a quedar en estado Reintentable, el proceso puede reintentarse nuevamente de forma manual siguiendo el mismo procedimiento.

Estados intermedios

Los estados intermedios indican que la ejecución está en curso y no representan un resultado final.

Start

• La integración acaba de iniciar su ejecución.
  • Se están preparando los recursos necesarios para el procesamiento.

Success (en ejecución)

• La integración se encuentra ejecutando pasos del flujo.
  • El proceso avanza correctamente, pero aún no ha finalizado.

Retrying

• La integración se encuentra reintentando una operación.
• Corresponde a un intento automático dentro de la política de reintentos configurada.
• Este estado es transitorio y puede derivar en:
  • Continuación exitosa de la ejecución.
  • Error.
  • Finalización en estado Reintentable.

Tipos de errores observables

Desde el punto de vista del usuario, los errores que pueden observarse en una ejecución suelen estar relacionados con:

• Formatos de datos incorrectos.
• Información esperada que no fue recibida.
• Datos incompletos o inconsistentes.
• Fallas en la ejecución de funciones debido a datos inválidos.
• Errores de comunicación con sistemas externos (credenciales incorrectas).

Información técnica registrada (logs)

• FlexiPaaS registra información técnica accesible desde el módulo de monitoreo, dentro de las secciones de configuración y logs.
• El usuario puede visualizar:
  • El recorrido de la ejecución a través de los distintos pasos del flujo.
  • La información que va ingresando y transformándose en cada etapa.
  • Los estados por los que atravesó la ejecución.
  • En caso de error, el código de error asociado.
  • Esta información permite:
    • Analizar el comportamiento de la integración.
    • Identificar el punto donde ocurrió un problema.
    • Validar el correcto procesamiento de los datos.