Integración de Prestige con Ágora: cargos a habitación

La integración de Prestige con Ágora permite cargar a la habitación el importe de un ticket desde el TPV: el camarero busca la habitación, ve el huésped, las fechas, el régimen y el localizador y, al cargar, el ticket se cierra en Ágora como albarán y Connect Manager manda el cargo a Prestige, por su importe sin IVA o repartido por servicios.

Este manual es para el técnico de FOS o del distribuidor que configura la integración en un local. La visión general de los PMS con Ágora está en Hotel Hub: cómo funciona.

Qué hace la integración#

• Añade a Ágora un botón (acción personalizada) que abre la ventana de cargo dentro del TPV.
• Busca la habitación en Prestige y enseña huésped, entrada, salida, régimen y localizador.
• Cierra el ticket en Ágora como albarán a nombre del cliente configurado, con el huésped y la habitación en el nombre fiscal.
• Carga a la habitación un único cargo con la base imponible del ticket (sin IVA) en el servicio por defecto, con la serie y número del albarán en las observaciones.
• Con «Enviar cargos en diferido», reparte el ticket en un cargo por servicio de Prestige según la familia y el TPV, y lo envía en segundo plano.
• Guarda cada cargo en Connect Manager con lo enviado y la respuesta de Prestige, que incluye el motivo cuando lo rechaza (habitación libre, servicio inexistente, segmento de crédito…).

Qué no hace#

• No anula en Prestige el cargo de un albarán anulado en Ágora: hay que anularlo a mano en el PMS.
• No envía propinas, comensales ni el desglose de IVA, ni facturas.
• No sincroniza reservas ni disponibilidad.
• No deja cargar tickets con descuento en importe, ni con descuento por línea y a pie de ticket a la vez.
• No enseña en el TPV el motivo del rechazo de Prestige: la ventana da un aviso genérico y el detalle queda en Connect Manager.
• El cierre diario (Z-cierre) está en el panel, pero la tarea que lo envía no está activada en la versión actual del motor.

Requisitos#

• Ágora con Herramientas → Acciones personalizadas. La ventana lee el ticket y crea el albarán por la API local del TPV.
• API de Ágora accesible desde Connect Manager solo para configurar: los selectores de Cliente, Familia y TPV del panel la usan. Abre el puerto a las IP de Connect Manager o usa Zero Connect.
• Servicio web de Prestige accesible desde Internet. Connect Manager no le manda usuario ni contraseña: si Prestige restringe el acceso por IP, dale las IP de Connect Manager.
• Quién hace qué. FOS da de alta el local y la integración con la URL que facilita Prestige. El distribuidor revisa la configuración de cargos, asocia familias si hace falta y configura el botón en Ágora. El cliente valida con una prueba real.

Datos que necesitamos#

Configuración paso a paso#

1. En Prestige#

1. Pide a Prestige la URL de su servicio web para integraciones y, si filtra por IP, que autorice las de Connect Manager.
2. Confirma con el hotel qué servicios de Prestige se usarán para los cargos.

2. En Connect Manager: el local (lo hace FOS)#

1. En Administración → Locales, abre el local y rellena Cliente, Nombre, URL de API, API key, Dirección, Ciudad y Zona horaria. Pulsa el icono de prueba del campo URL de API (sale con la URL y la API key rellenas): «Conexión con éxito».
2. Guardar → Integraciones de hoteles → Añadir → proveedor Prestige.

3. En Connect Manager: Conf. general#

1. Pausar el envío de cargos al PMS después de y Pausar el envío de cargos al PMS: solo los ve FOS. Con la integración pausada, el botón del TPV abre el aviso «Integración pausada».
2. URL Api: la base del servicio web. Connect Manager añade service.asmx detrás.
3. Usuario, Password e Id. del hotel: rellénalos con lo que dé Prestige, aunque la versión actual no los envía.
4. Email de receptor de notificaciones: escribe cada dirección y pulsa Intro. Ahí llegan los fallos de los cargos en diferido.
5. Pulsa Guardar: la integración se abre en modo edición y aparece el desplegable Servicio, que antes de guardar no sale.

4. En Connect Manager: Conf. de cargos#

• Servicio: el servicio de Prestige por defecto. Sin «Enviar cargos en diferido», todo el ticket va a este servicio.
• Enviar cargos en diferido: el ticket se reparte en un cargo por servicio (pestaña Familias) con la base imponible de sus líneas, y los cargos salen en segundo plano. El TPV da el cargo por hecho al momento, sin esperar a Prestige; si Prestige rechaza alguno, llega un correo y queda marcado con error. Desmarcado: un único cargo que se manda en el momento.
• Dejar abierto el albarán: el albarán se crea en Ágora permitiendo facturarlo después.
• Nº de días para cerrar albaranes (7 por defecto): lo usa una tarea nocturna, hoy inactiva, que anula en Ágora los albaranes abiertos pasados esos días. No toca Prestige.
• Cliente: el cliente genérico de Ágora para los albaranes. Su nombre fiscal se sustituye por el del huésped y la habitación.

5. En Connect Manager: Familias (con envío en diferido)#

La pestaña Familias solo aparece con «Enviar cargos en diferido» marcado. Por cada Familia elige el Servicio de Prestige y, si el servicio cambia según dónde se venda, añade la misma familia otra vez con un TPV concreto: se usa la asociación del TPV del albarán y, si no la hay, la general. Las familias sin asociar van al servicio por defecto.

6. En Connect Manager: Conf. de Z-cierre#

Con Z-cierre marcado aparecen Factura, Id moneda, Id origen, Id method y Hora de generación fich. contable. Sirven para mandar una vez al día a Prestige un cargo resumen con el total sin IVA de las facturas del día, en el servicio por defecto, con esos códigos.

[!WARNING] La tarea nocturna que envía el Z-cierre no está activada en la versión actual del motor. No configures este bloque contando con él sin confirmarlo antes con FOS.

7. En Ágora#

1. Copia del bloque Enlaces la URL botón acción personalizada. Si empieza por /venues/, antepón https://app.connectmanager.es.
2. En Herramientas → Acciones personalizadas pulsa Nuevo: Texto «Cargo habitación», Tipo «Url/Aplicación», Acción la URL copiada (sin tocar los marcadores entre llaves) y marca Mostrar Urls en un diálogo de Ágora.
3. Coloca la acción en Herramientas → Configuración de botones y da su permiso a los perfiles que vayan a cargar.

Cómo funciona#

El botón abre la ventana con el ticket; la ventana lo lee por la API local de Ágora y lo guarda en Connect Manager. El camarero busca la habitación y Connect Manager consulta a Prestige el huésped alojado. Al pulsar Cargar, la ventana crea el albarán en Ágora, lo guarda y pide el cargo. Sin envío en diferido, Connect Manager manda el cargo a Prestige y espera su respuesta; con envío en diferido, deja los cargos en cola y responde al momento. En los dos casos la ventana dice «Se generó el siguiente cargo» y se cierra.

sequenceDiagram
    participant TPV as TPV Ágora
    participant CM as Connect Manager
    participant PMS as Prestige
    TPV->>TPV: Lee el ticket por la API local
    TPV->>CM: Guarda el ticket
    TPV->>CM: Busca la habitación
    CM->>PMS: Consulta el huésped alojado
    PMS-->>CM: Nombre, fechas, régimen y localizador
    CM-->>TPV: Datos de la reserva
    TPV->>TPV: Crea el albarán por la API local
    TPV->>CM: Guarda el albarán y pide el cargo
    alt Envío inmediato
        CM->>PMS: Cargo con la base imponible
        PMS-->>CM: Correcto o código de error
    else Enviar cargos en diferido
        CM->>CM: Un cargo por servicio en cola
        CM->>PMS: Envío en segundo plano
    end
    CM-->>TPV: Se generó el siguiente cargo

Qué se envía: el número de habitación, el servicio, cantidad 1, el importe sin IVA (con los descuentos repartidos) y la observación «Albarán: » seguida de la serie y el número.

Si Prestige rechaza el cargo: el albarán ya está creado en Ágora. Sin envío en diferido, la ventana dice «No se ha podido generar el albarán…» y el motivo de Prestige queda en Operaciones hoteleras → Cargos, en «Pedido externo (response)». Con envío en diferido, el error llega por correo («Enviar cargo diferido de Prestige (Error)») y se ve en la pestaña Cargos en diferido del cargo, con estado «Sin enviar», «Enviado» o «Error». En ambos casos el cargo no se repite solo.

Comprobar que funciona#

1. Tras guardar, el desplegable Servicio muestra los servicios de Prestige.
2. En Ágora, abre un ticket, pulsa el botón y busca una habitación ocupada: salen cliente, entrada, salida, régimen y localizador.
3. Pulsa Cargar: sale «Se generó el siguiente cargo: …» y se imprime el albarán con el huésped y la habitación.
4. En Prestige, la habitación tiene el cargo por la base imponible con la observación del albarán.
5. En Operaciones hoteleras → Cargos aparece el cargo; con envío en diferido, su pestaña Cargos en diferido debe pasar a «Enviado».

Errores frecuentes y solución#

Preguntas frecuentes#

¿Cómo conecto Prestige con Ágora?#

Con Connect Manager: FOS crea la integración con la URL del servicio web de Prestige, se elige el servicio y, en Ágora, se añade una acción personalizada con la URL de cargo.

¿Prestige recibe el importe con IVA o sin IVA?#

Sin IVA: Connect Manager manda la base imponible del ticket, o de cada servicio con el envío en diferido.

¿Se anula el cargo en Prestige si anulo el albarán en Ágora?#

No. La anulación hay que hacerla también en Prestige.

¿Para qué sirve «Enviar cargos en diferido»?#

Para repartir el ticket entre varios servicios de Prestige por familia y TPV, y para que el TPV no espere la respuesta de Prestige.

¿Se manda el cierre de caja a Prestige?#

El panel tiene el bloque Z-cierre, pero la tarea que lo envía no está activada en la versión actual: confírmalo con FOS.

Referencias#

• Ficha de la integración con Prestige
• Hotel Hub: cómo funciona
• Integración de Sihot con Ágora: la misma configuración de acción personalizada en Ágora
• Direcciones IP de Connect Manager