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.
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#
Accede a Connect Manager.
Ve a Administración > Locales.
Selecciona el local que deseas integrar.
### 3.2 Configuración de la Integración con ÁGORA
Dentro del apartado de integraciones del local:
Introduce la URL de la API de ÁGORA (debe tener conexión externa).
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):
Configurar la Conf. de Z-Cierre en ÁGORA.
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.