Glosario de Connect Manager
Este glosario recoge los términos clave utilizados en las aplicaciones de integración de Connect Manager. Su objetivo es unificar el lenguaje entre equipos técnicos, clientes y documentación, y servir como referencia transversal para todos los manuales.
Connect Manager#
Plataforma de integración que actúa como núcleo de comunicación entre el TPV Ágora y sistemas externos. Centraliza la lógica de integración, controla los flujos de datos y aporta trazabilidad, seguridad y escalabilidad.
Integración#
Proceso mediante el cual dos o más sistemas intercambian información de forma automatizada y controlada, siguiendo reglas definidas.
Aplicación de integración#
Módulo o servicio específico dentro de Connect Manager que resuelve un caso de uso concreto, como integraciones con ERP, delivery, ticketing, PMS u otros sistemas externos.
TPV (Terminal Punto de Venta)#
Sistema principal de operación en el local. En el contexto de esta documentación, hace referencia al TPV Ágora, que actúa como origen o destino de los datos.
Hub de integración#
Modelo de arquitectura en el que un sistema central intermedia todas las comunicaciones entre sistemas, evitando integraciones directas punto a punto.
Sincronización#
Intercambio de datos entre sistemas. Puede ser programado, en intervalos definidos, o en tiempo real, en respuesta a un evento.
Job#
Proceso automático ejecutado por Connect Manager, normalmente de forma programada, encargado de realizar tareas como envíos, recepciones, validaciones o conciliaciones de datos.
Proceso Pull#
Modelo de integración en el que Connect Manager consulta activamente a un sistema externo para obtener información.
Proceso Push#
Modelo de integración en el que un sistema externo envía información a Connect Manager sin que este la solicite explícitamente.
Webhook#
Mecanismo mediante el cual un sistema notifica automáticamente a otro la ocurrencia de un evento mediante una llamada HTTP en tiempo real.
API (Application Programming Interface)#
Interfaz que permite la comunicación estructurada entre sistemas de forma segura y controlada. Las integraciones de Connect Manager se basan habitualmente en APIs REST.
API Key / Token#
Credencial utilizada para autenticar y autorizar el acceso a una API. Debe tratarse como información sensible y almacenarse de forma segura.
Credenciales#
Conjunto de datos necesarios para acceder a un sistema, como usuarios, contraseñas, tokens, claves API o certificados.
Entorno local#
Infraestructura ubicada físicamente en el local del cliente, que incluye servidores, TPVs y servicios residentes.
Entorno cloud#
Servicios alojados en infraestructura externa accesible a través de Internet, como APIs, plataformas SaaS o servicios centralizados.
Trazabilidad#
Capacidad de seguir el recorrido completo de un dato desde su origen hasta su destino, incluyendo estados intermedios, errores y reintentos.
Log#
Registro técnico donde se almacena información sobre la ejecución de procesos, eventos relevantes y errores detectados durante el funcionamiento de una integración.
Reintento#
Mecanismo automático que vuelve a ejecutar un proceso que ha fallado por causas temporales, como problemas de red o indisponibilidad puntual de un servicio externo.
Error funcional#
Incidencia provocada por datos incorrectos, configuraciones erróneas o incumplimiento de reglas de negocio.
Error técnico#
Incidencia causada por problemas de infraestructura, conectividad, caídas de servicio o errores internos del sistema.
SLA (Service Level Agreement)#
Acuerdo de nivel de servicio que define compromisos de disponibilidad, tiempos de respuesta y resolución ante incidencias.
Idempotencia#
Propiedad de un proceso que garantiza que múltiples ejecuciones del mismo producen siempre el mismo resultado sin generar duplicidades.
Cola de mensajes#
Mecanismo intermedio utilizado para gestionar procesos asíncronos, desacoplar sistemas y mejorar la tolerancia a fallos.
URL del servidor de Ágora#
Dirección web de administración del servidor de Ágora de un local, accesible desde el exterior. Se utiliza para tareas de gestión, integración y comunicación con servicios externos.
API Token de Ágora#
Credencial de autenticación que permite a sistemas externos, como Connect Manager, acceder de forma segura a la API del servidor de Ágora del local.
ACMS (Ágora Central Management System)#
Plataforma centralizada de Ágora que permite la gestión y supervisión de múltiples locales desde un entorno central.
URL de ACMS#
Dirección web de acceso a Ágora Central. Es el punto de entrada para integraciones que operan a nivel centralizado y multi-local.
API Token de Ágora Central#
Token de autenticación utilizado para acceder a las APIs de Ágora Central (ACMS). Permite a Connect Manager realizar operaciones globales sobre uno o varios locales de forma controlada. Este glosario es un documento vivo y se ampliará conforme evolucione el ecosistema de Connect Manager.