Manual de Integración SIHOT y ÁGORA

1. Introducción

Este manual describe de forma estructurada los pasos necesarios para configurar la integración entre SIHOT (PMS hotelero) y ÁGORA (TPV) utilizando Connect Manager como capa de integración. La integración permite:

• Cargos a habitación desde ÁGORA hacia SIHOT.
• Cancelación de cargos desde ÁGORA.
• Envío de facturas.
• (Opcional) Envío de ventas de clientes no alojados.

2. Requisitos PrevZios

Antes de comenzar, asegúrate de disponer de:

• Acceso a Connect Manager en https://app.connectmanager.es/
• Acceso a ÁGORA con permisos de configuración.
• URL de la API de ÁGORA accesible desde el exterior.
• API Key de ÁGORA activa.
• Credenciales de acceso a SIHOT (URL, usuario y contraseña).

3. Configuración en Connect Manager

3.1 Acceso a la Configuración del Local

1. Accede a Connect Manager.
2. Ve a Administración > Locales.
3. Selecciona el local que deseas integrar.

3.2 Configuración de la Integración con ÁGORA

Dentro del apartado de integraciones del local:

1. Introduce la URL de la API de ÁGORA (debe tener conexión externa).
2. Introduce la API Key de ÁGORA.

⚠ IMPORTANTE: Si los buscadores no funcionan, normalmente es porque no hay conexión con la API de ÁGORA.

3.3 Configuración de la Integración con SIHOT

Edita la integración de SIHOT y completa los siguientes campos:

• URL: Endpoint del PMS SIHOT.
• Usuario: Usuario de integración facilitado por SIHOT.
• Password: Contraseña del usuario de integración.
• ID del Hotel: Identificador del hotel en SIHOT.
• Email receptor de notificaciones: Dirección donde se enviarán avisos y errores de la integración.

4. Configuración de Cargos a Habitación

Dentro de la configuración de la integración, en el apartado Cargos a habitación, se pueden definir las siguientes opciones:

4.1 Solicitar Firma

• Sí: Se solicitará la firma del cliente al realizar el cargo.
• No: No se solicitará firma.

4.2 Concepto Único

• Permite agrupar todos los cargos en un único concepto dentro del PMS.
• Si no se activa, los cargos se enviarán separados.

4.3 Gestión del Albarán

• Dejar el albarán abierto: Permite cancelar el cargo posteriormente desde ÁGORA y anularlo en SIHOT.

4.4 Cliente de ÁGORA para los Cargos

• Selecciona el cliente genérico de ÁGORA que se utilizará para los cargos a habitación.

5. Enlaces proporcionados para ÁGORA

Se proporcionan dos URLs necesarias para completar la integración:

5.1 URL para Acción Personalizada

• Esta URL debe configurarse en ÁGORA en: Herramientas > Acciones personalizadas
• Se utiliza como botón de acción personalizada para el envío de cargos a SIHOT.

El funcionamiento de la accion personalizada es el siguiente:  Se introduce el  nº de habitación para relizar el cargo, si esta activada la firma se le pedirá al cliente, se pulsa sobre cargar y esté documento será cargado en el PMS y en ágora generará un albarán.

⚠ IMPORTANTE: La acción personalizada generá un permiso que se deben introducir en los perfiles de los usuarios,  Marcar siempre Mostrar Urls en un diálogo de Ágora.

5.2 URL para Envío de Facturas

• Esta URL se utilizará para enviar facturas desde ÁGORA hacia el sistema externo.

6. Activación de cancelación de albaranes en Ágora

Para permitir la cancelación de cargos desde ÁGORA, es necesario activar la siguiente opción: ara configurarlo en ágora es desde el servicio de ágora > Activar módulos adiciones > Servicios de integración

Se debe configurar la URL proporcionada por connectmanager, Habilitar integración de documentos y Enviar albaranes.

7. Envío de ventas de clientes no alojados (Opcional)

Si se desea enviar a SIHOT las ventas de clientes no alojados (no cargos a habitación):

1. Configurar la Conf. de Z-Cierre en ÁGORA.
2. Definir:
   • Número de habitación donde se enviarán estas ventas.
   • Hora a la que se generará el envío automático.

8. Asociaciones Opcionales

De forma opcional, se pueden asociar elementos de ÁGORA con SIHOT, tales como:

• Familias de productos.
• Locales.
• Métodos de pago.

Estas asociaciones permiten un mayor nivel de detalle y control en el PMS.

9. Consideraciones Importantes

• Si los buscadores no funcionan, revisar siempre:
  • Conectividad con la API de ÁGORA.
  • URL y API Key configuradas correctamente.
• Se recomienda realizar pruebas controladas antes de operar en entorno productivo.