→ Abrir en la app — Accede directamente a esta sección desde tu cuenta.
Agora conecta el TPV de restaurante con Hotelgest PMS. Al check-in, el PMS envía a Agora los huéspedes con su habitación, régimen y extras contratados. Al cerrar un albarán en Agora contra una habitación, el cargo aparece como artículo en la reserva del PMS.
Dónde está
Marketplace → POS Restaurante → Agora
Botón Configurar → pantalla de configuración del addon
Cargos visibles en Detalle de reserva > Artículos
Requisitos
Agora instalado y contrato activo.
Addon contratado en Marketplace.
URL (IP y puerto) y Auth (contraseña) proporcionados por Agora — solicitarlos directamente al técnico de Agora.
Mapeo habitación ↔ cliente configurado con soporte.
Activación
Paso 1: Contrata el addon
Marketplace → POS Restaurante → Agora → Configurar.
Paso 2: Introduce los datos de conexión
Al pulsar Configurar, se abre la pantalla de configuración del addon. Desde ahí:
Pulsa el lápiz (editar) para habilitar los campos.
Introduce la URL del POS con su puerto — el técnico de Agora te facilitará el dato. El formato habitual es
IP:puerto/api/(por ejemplo,192.168.1.10:8984/api/).Introduce el Auth (contraseña de conexión), también proporcionada por Agora.
Activa el check de activar la integración.
Pulsa Guardar.
ℹ️ Información: Si no tienes la URL o el Auth, consúltalos con tu técnico de Agora antes de continuar.
Paso 3: Activa la carga automática
Una vez guardada la configuración, contacta con el equipo de soporte de Hotelgest para activar la carga automática de artículos desde Agora.
Paso 4: Check-in test
Reserva en casa → comprueba que Agora recibe el huésped con habitación y régimen.
Paso 5: Cierra albarán
Consumo en restaurante → albarán cerrado en Agora contra la habitación → artículo en la reserva del PMS.
Opciones adicionales en la pantalla de configuración
Desde la misma pantalla donde se introducen la URL y el Auth (lápiz → editar) están disponibles las siguientes acciones:
Opción | Para qué sirve |
Test Date + Previsualizar pedidos | Introduce una fecha y verás todos los ítems creados en Agora ese día, sin importarlos. Útil para verificar la conexión. |
Sincronizar huéspedes | Actualiza manualmente la lista de huéspedes en Agora según el estado actual del PMS (en casa, régimen, extras). |
Cargar pedido | Importa todos los artículos de la fecha indicada en Test Date hacia las reservas del PMS. |
Agrupación de pedidos | Actívalo para recibir un único artículo por recibo en la reserva, en vez de una línea por cada ítem del albarán. |
Categoría contable | Introduce el código del artículo de contabilidad al que se asignarán los cargos de Agora (ver sección siguiente). |
Configurar la categoría contable
Si el hotel usa contabilidad integrada en Hotelgest, puedes asignar una categoría contable a los artículos que llegan de Agora. Esto permite contabilizarlos automáticamente sin reclasificación manual.
Paso 6: Crea el artículo contable
Ve a Alojamiento → Artículos y crea (o localiza) el artículo al que quieres que se asignen los cargos de Agora. Anota el código del artículo.
Paso 7: Asigna el código en la configuración de Agora
Ve a Marketplace → POS Restaurante → Agora → lápiz e introduce el código del artículo en el campo de categoría contable. Pulsa Guardar.
A partir de ese momento, los artículos importados desde Agora aparecen en la reserva con el icono del carrito, indicando que están asignados a la categoría contable configurada.
Cómo funciona
Hotelgest → Agora (sincronización de huéspedes)
El PMS envía a Agora la lista de huéspedes en casa en el momento del check-in. La sincronización es inmediata: el personal de restaurante dispone de los datos del huésped sin espera. Por cada reserva activa, Agora recibe:
Dato | Descripción |
ID de cliente | Identificador automático basado en el número de habitación |
Nombre | Nombre del titular de la reserva |
Habitación | Nombre y número de puerta |
Régimen | Traducido a texto: Solo alojamiento, Desayuno, Media pensión, Pensión completa |
Fechas | Llegada y salida |
Extras | Artículos facturados a la reserva (si configurado) |
Notas | Notas privadas de la reserva |
Check-out → limpieza en Agora
Al hacer check-out, el PMS envía una orden de baja del cliente en Agora, liberando la habitación para el siguiente huésped.
Habitaciones vacías
Las habitaciones sin reserva activa (tipo subroom > 100, como zonas comunes o salas) se envían como lista independiente para que Agora pueda gestionar cargos a espacios no asignados a un huésped.
Cómo llegan los cargos al PMS
El PMS recoge los cargos periódicamente de Ágora — Ágora no envía nada al PMS. Hotelgest consulta la API de Ágora para traerse los albaranes cerrados; una vez detectados, los artículos aparecen automáticamente en la reserva correspondiente.
Esto significa que no es necesario configurar ningún endpoint ni URL en Ágora para que los cargos lleguen al PMS. Si desde el TPV de Ágora se menciona algún "botón de cargo a habitación" o se solicita una URL para configurar un envío desde Ágora hacia el PMS, no es parte de esta integración — los cargos funcionan sin ninguna acción adicional en Ágora.
Descuentos en albaranes
Cuando Agora cierra un albarán con descuentos, el PMS registra cada artículo con el importe neto (precio ya descontado, tal como lo envía Agora). Los artículos con descuento del 100 % se cargan a la reserva por 0 € y quedan registrados como consumo gratuito. Los descuentos parciales reducen el importe del artículo en la proporción del descuento aplicado en el albarán.
Operativa recepción
Acción | Dónde |
Verificar sincronización | Check-in → comprobar huésped en consola Agora |
Revisar cargos | Detalle de reserva > Artículos tras servicio de restaurante |
Facturar consumos | Desde la ficha de la reserva al cierre o check-out |
Qué sincroniza
Dirección | Qué ocurre | Dónde lo validas |
Hotelgest → Agora | Huéspedes en casa con habitación, régimen y extras | Consola Agora |
Hotelgest → Agora | Check-out: elimina huésped de Agora | La habitación se libera en Agora |
Hotelgest ← Agora (el PMS recoge) | Albaranes cerrados en Agora → artículos en la reserva (importe neto con descuentos aplicados) | Detalle de reserva > Artículos |
Hotelgest → facturación | Artículo facturable en la cuenta del huésped | Factura, proforma o cierre |
Troubleshooting
Síntoma | Qué revisar |
No llegan cargos desde Agora | Revisar la URL (IP y puerto) en la configuración. Verificar que el puerto está abierto — se puede comprobar con herramientas online como yougetsignal.com. Si el puerto no responde, consultar con el técnico de Agora. |
La integración no responde tras guardar la configuración | Verificar que la URL y el Auth introducidos son correctos. Si el problema persiste, contactar con Agora para confirmar las credenciales. |
Huésped no aparece en Agora | La sincronización ocurre al instante al hacer check-in. Verificar que el check-in esté registrado en la reserva y que la integración Agora esté activa en Marketplace. |
Cargo no llega al PMS | Verificar que el albarán está cerrado (no mesa abierta) y se cobró contra la habitación correcta. |
Régimen incorrecto en Agora | El régimen se traduce automáticamente desde el código del PMS (nb/bb/hb/ai). Si es incorrecto, revisar el régimen de la reserva. |
Habitación duplicada en Agora | Puede ocurrir si hay dos reservas activas en la misma habitación. Verificar que no hay solapamiento de reservas. |
Extras no aparecen en notas | La opción de enviar extras debe estar habilitada en la configuración. Consultar con soporte. |
Artículo sin icono de carrito en la reserva | La categoría contable no está configurada. Introducir el código del artículo contable en la pantalla de configuración de Agora (lápiz → campo categoría contable → Guardar). |
El huésped tarda en aparecer en Agora tras el check-in
El PMS envía los datos del huésped a Agora en el momento del check-in. Si el huésped no aparece de forma inmediata en el TPV del restaurante, comprueba que:
El check-in está registrado correctamente en la reserva (estado En casa).
La integración Agora está activa en Marketplace.
Si el retraso es habitual o persiste, contacta soporte indicando el número de propiedad y la reserva afectada.
El cargo llega al PMS con el precio sin descuento
El PMS aplica los descuentos del albarán de Agora automáticamente: cada artículo se registra con el precio neto y los artículos gratuitos (descuento del 100 %) se cargan por 0 €.
Si ves un artículo con descuento que aparece en la reserva al precio original, verifica que el albarán está cerrado en Agora y que el descuento aparece en el albarán (no solo en la cuenta de mesa). Si el problema persiste, contacta soporte indicando el número de albarán y la reserva afectada.
Diferencia Agora vs Revo vs TPV recepción
Herramienta | Uso |
Agora | POS restaurante — cargos tras check-in al cerrar albarán |
Revo | POS restaurante alternativo — mismo patrón de cargos a reserva |
TPV recepción | Cobro directo en mostrador, no consumo restaurante |
¿Cómo se identifican las habitaciones en Agora?
El PMS asigna un identificador numérico único a cada habitación para comunicarse con Agora. Este mapeo es automático y se basa en el campo de código externo de la habitación en el PMS.
Desde Ágora nos piden una URL para un botón de 'cargo a habitación' — ¿qué hacemos?
La integración de Ágora con Hotelgest funciona en modo pull: es el PMS quien recoge los albaranes cerrados de Ágora, no al revés. Ágora no necesita ninguna URL de Hotelgest para enviar cargos — los cargos llegan al PMS automáticamente cuando se cierra un albarán en el TPV.
Si el técnico de Ágora menciona un botón de "cargo a habitación" que requiere una URL o endpoint de Hotelgest, eso corresponde a un flujo distinto que no está disponible en esta integración. No hay nada que configurar en el PMS para ese botón, y no existe una URL de Hotelgest que facilitarles.
Para resolver los cargos a habitación, el flujo correcto es el estándar: cerrar el albarán en Ágora contra la habitación del huésped, y el PMS lo recoge automáticamente.

