Introducción a las aplicaciones de integración de Connect Manager

Esta sección de la wiki tiene como objetivo ofrecer una visión global, clara y estructurada de qué es Connect Manager, para qué sirve y cómo se organizan sus aplicaciones de integración. Está pensada para que cualquier lector —técnico, partner o responsable de negocio— pueda entender el ecosistema antes de entrar en manuales específicos o configuraciones avanzadas.

1. ¿Qué es Connect Manager?

Connect Manager es una plataforma de integración diseñada para conectar el TPV Ágora con otros sistemas externos de forma segura, controlada y escalable. Su función principal es actuar como un hub central de comunicaciones, evitando integraciones punto a punto y permitiendo:

• Centralizar la lógica de integración
• Estandarizar los flujos de datos
• Reducir dependencias técnicas entre sistemas
• Facilitar el mantenimiento y la evolución futura

Connect Manager no sustituye al TPV ni a los sistemas externos, sino que orquesta la comunicación entre ellos, asegurando que la información fluye de forma fiable y trazable.

2. Casos de uso habituales

Las aplicaciones de integración de Connect Manager cubren múltiples escenarios reales en entornos de restauración:

Integración TPV ↔ ERP / Contabilidad

• Envío de ventas, cobros y facturación
• Automatización de cierres contables
• Reducción de tareas manuales

Integración TPV ↔ Delivery

• Recepción automática de pedidos
• Sincronización de estados
• Unificación de operaciones

Integración TPV ↔ Ticketing

• Venta de entradas desde el TPV
• Validación y control de accesos
• Integraciones como Seetickets

Integración TPV ↔ PMS (Hoteles)

• Cargos a habitación
• Identificación de clientes
• Conciliación posterior

Integraciones personalizadas

• APIs externas
• Webhooks
• Proyectos a medida para grandes cuentas

Cada caso de uso responde a un problema operativo real, aportando eficiencia, control y escalabilidad.

3. Ecosistema de aplicaciones e integraciones

Connect Manager se compone de un conjunto de aplicaciones de integración, cada una con una responsabilidad clara.

Tipos de integraciones

• Operativas: pedidos, tickets, consumos
• Económicas / financieras: cobros, facturación, contabilidad
• Marketing y ticketing: eventos, entradas, campañas
• Sistemas externos: ERPs, PMS, plataformas cloud

Cada integración está documentada de forma independiente en esta wiki, incluyendo:

• Descripción funcional
• Requisitos
• Flujo de datos
• Configuración
• Limitaciones

4. Arquitectura general de las integraciones

La arquitectura de Connect Manager está diseñada para ser robusta y flexible.

Componentes principales

• TPV Ágora: origen o destino de los datos
• Connect Manager: núcleo de integración
• Servicios locales: procesos residentes, colas, tareas programadas
• Servicios cloud / APIs externas: sistemas terceros

Tipos de comunicación

• Sincronización programada
• Comunicación en tiempo real
• Webhooks
• Procesos Pull / Push

Los flujos están pensados para garantizar:

• Trazabilidad
• Control de errores
• Reintentos
• Logs y auditoría

5. Requisitos generales de las integraciones

Antes de implantar cualquier integración, existen requisitos comunes que deben cumplirse:

• Versiones mínimas de TPV y sistemas externos
• Conectividad estable
• Credenciales y permisos necesarios
• Configuración correcta del entorno

FOS valida estos requisitos previamente para garantizar una implantación correcta y estable.

6. Roles y responsabilidades

Para un correcto funcionamiento, es importante definir responsabilidades:

FOS Consulting

• Diseño de la integración
• Implantación y configuración
• Soporte de la capa Connect Manager

Cliente

• Disponibilidad de sistemas
• Validación funcional
• Uso correcto de la integración

Terceros

• Disponibilidad y funcionamiento de sus APIs
• Cambios en condiciones o versiones

7. Seguridad\, datos y buenas prácticas

La seguridad es un pilar fundamental:

• Uso de credenciales seguras
• Tokens y claves API
• Control de accesos
• Gestión de logs

Buenas prácticas

• No compartir credenciales
• Revisar logs periódicamente
• Mantener versiones actualizadas
• Seguir los manuales oficiales

8. Cómo usar esta wiki

Esta wiki está organizada para facilitar la consulta:

• Artículos introductorios (esta sección)
• Manuales por integración
• Guías rápidas
• Resolución de incidencias

Convenciones

• ⚠️ Advertencias importantes
• ℹ️ Notas informativas
• 🛠️ Pasos técnicos

9. Glosario básico

Connect Manager: plataforma de integración Integración: intercambio controlado de datos entre sistemas Webhook: notificación automática entre sistemas Job: proceso programado Sincronización: intercambio periódico de datos Token / API Key: credenciales de acceso

Esta introducción sirve como base común para todos los manuales de integración. A partir de aquí, cada aplicación dispone de su propia documentación detallada.