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.