Ir al contenido principal

Agora (POS restaurante)

Escrito por Jordi

Abrir en la app — Accede directamente a esta sección desde tu cuenta.

Vista de Agora en Hotelgest PMS

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á

  • MarketplacePOS RestauranteAgora

  • 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

MarketplacePOS RestauranteAgoraConfigurar.

Paso 2: Introduce los datos de conexión

Al pulsar Configurar, se abre la pantalla de configuración del addon. Desde ahí:

  1. Pulsa el lápiz (editar) para habilitar los campos.

  2. 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/).

  3. Introduce el Auth (contraseña de conexión), también proporcionada por Agora.

  4. Activa el check de activar la integración.

  5. 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.

¿Ha quedado contestada tu pregunta?