Índice
¿Qué es esta integración?
La integración con Oracle Opera conecta Golfmanager con el PMS (sistema de gestión hotelera) Opera, de Oracle. Permite, desde el TPV de Golfmanager, localizar la reserva del huésped y cargar sus compras a la habitación.
El importe deja de cobrarse en caja y se añade a la cuenta del huésped en Opera, que lo paga al hacer el check-out. La versión moderna funciona con Opera Cloud a través de la plataforma de integración de Oracle (OHIP).
Un PMS (Property Management System) es el programa con el que el hotel gestiona reservas, habitaciones y la cuenta de cada huésped. Oracle Opera es uno de los más extendidos. OHIP (Oracle Hospitality Integration Platform) es la vía moderna de conexión con Opera Cloud.
¿Qué problema resuelve?
El huésped no paga en el momento: consume en el golf, la tienda o el bar y todo se acumula en su habitación.
Localiza la reserva fácilmente buscando por habitación o por nombre.
Evita la doble gestión: el cargo viaja a Opera al instante.
Respeta las reglas del hotel (por ejemplo, reservas que no admiten cargos).
Permite devoluciones sobre la misma reserva (o, en Opera Cloud, sobre otra habitación).
¿Qué sistemas conecta y en qué dirección viajan los datos?
Conecta el TPV de Golfmanager con Oracle Opera Cloud (a través de OHIP), en tiempo real:
Golfmanager consulta a Opera las reservas para localizar al huésped (por habitación o nombre).
Golfmanager envía el cargo (o la devolución) a la cuenta/folio de la reserva.
Opera responde si la operación se ha realizado, y Golfmanager la registra.
Es una comunicación en tiempo real por API. En las variantes clásicas (on-premise) la comunicación se hace contra un servidor local de Opera; ver el apartado Variantes.
¿Qué información se intercambia?
Información | Dirección | Para qué |
Búsqueda de reservas (por habitación o nombre) | Opera → Golfmanager | Identificar a quién se carga |
Cargo: importe, concepto y folio/reserva | Golfmanager → Opera | Añadir el cargo a la cuenta del huésped |
Confirmación / devolución | Golfmanager ↔ Opera | Confirmar o anular el cargo |
Requisitos previos (antes de activar la integración)
Que el hotel use Oracle Opera Cloud con la plataforma de integración OHIP habilitada.
Tener el módulo Opera Cloud instalado en tu Golfmanager, junto con los módulos de TPV y facturación.
Las credenciales de OHIP: Client ID, Client Secret, Application Key (App Key), Enterprise ID y la URL del gateway.
El identificador del hotel (Hotel ID) en Opera.
Permisos para gestionar Opera en Golfmanager.
Formulario de autorización
Para autorizar la integración entre tu empresa y Opera a través de una API, normalmente hay que enviar a Golfmanager un documento cumplimentado y firmado por ambas partes antes de empezar. Es un requisito previo a la activación de la conexión.
Tu equipo de implantación te indicará el formulario concreto y cómo entregarlo. Hasta que la autorización esté completa, no se puede operar contra el Opera real.
Cómo se configura (paso a paso)
La configuración se hace una sola vez, con las credenciales que facilita Oracle o el equipo de IT del hotel.
Paso 1 — Datos de conexión
Accede a Opera Cloud > Configuración.
Activa Modo de prueba (recomendado al empezar: no realiza conexión real).
Introduce Client ID, Client Secret y Application Key.
Introduce la URL del gateway (por defecto
https://api.platform.opera-cloud.com/ohip) y el Enterprise ID.Indica la Moneda (por defecto
EUR).Opcional: activa Enviar a Opera también los pagos que no son de Opera si quieres que todas las ventas queden reflejadas en el folio.
Marca Activo.
Guarda los cambios.
Paso 2 — Dar de alta los hoteles
Ve a Opera Cloud > Hoteles.
Crea cada hotel con su Hotel ID de Opera y un nombre identificativo.
Guarda.
Paso 3 — Códigos de transacción y caja (recomendado)
En cada subfamilia de productos, indica su Código Opera Cloud (el código de transacción con el que Opera debe registrar esos productos).
En cada TPV, indica su Cashier ID Opera Cloud si el hotel lo requiere para el cuadre diario.
Si activaste el envío de pagos que no son de Opera, asigna el Código Opera Cloud a cada forma de pago que quieras reportar.
Paso 4 — Probar la conexión
Usa la opción de probar conexión para comprobar que las credenciales son correctas.
Cuando funcione, desactiva el Modo de prueba para operar en real.
⚠️ Recomendación: empieza con el modo de prueba activado y, cuando la conexión funcione, desactívalo para operar en real. En real, los cargos son reales en la cuenta del huésped.
Los campos de configuración en detalle
A continuación se explica cada campo de la integración con Opera Cloud.
1) Activo
• Nombre del campo: Activo
• Descripción: Interruptor general que habilita o deshabilita la integración con Opera Cloud.
• Impacto en el sistema: Si está desactivado, la forma de pago de cargo a habitación no opera contra Opera.
• Ejemplo de uso: lo activas cuando la conexión ya está probada.
Qué ocurre cuando se utiliza: el TPV puede empezar a cargar ventas a las habitaciones.
Comportamiento del sistema: con él desactivado, la integración queda inactiva aunque las credenciales estén puestas.
2) Modo de prueba
• Nombre del campo: Modo de prueba (sin conexión real)
• Descripción: Hace que la integración funcione contra un entorno simulado, sin enviar cargos reales a Opera.
• Impacto en el sistema: Permite validar la configuración y el flujo sin afectar a las cuentas de huéspedes.
• Ejemplo de uso: lo activas durante la puesta en marcha.
Qué ocurre cuando se utiliza: los "cargos" no llegan al hotel; solo se prueba el circuito.
Comportamiento del sistema: al desactivarlo, los cargos pasan a ser reales en el folio del huésped.
3) Client ID
• Nombre del campo: Client ID
• Descripción: Identificador de cliente de las credenciales OHIP que facilita Oracle/el hotel.
• Impacto en el sistema: Forma parte de la autenticación. Si es incorrecto, la conexión falla.
• Ejemplo de uso: lo copias del panel de OHIP del hotel.
Qué ocurre cuando se utiliza: junto con el resto de credenciales, autentica a Golfmanager ante Opera.
Comportamiento del sistema: un valor erróneo provoca error de conexión/credenciales.
4) Client Secret
• Nombre del campo: Client Secret
• Descripción: Clave secreta asociada al Client ID. Es información sensible.
• Impacto en el sistema: Necesaria para autenticarse. No debe compartirse.
• Ejemplo de uso: la pegas junto al Client ID.
Qué ocurre cuando se utiliza: completa la autenticación con Opera.
Comportamiento del sistema: si caduca o es incorrecta, la conexión deja de funcionar.
5) Application Key (App Key)
• Nombre del campo: Application Key
• Descripción: Clave de aplicación de OHIP que identifica la aplicación ante la plataforma de Oracle.
• Impacto en el sistema: Imprescindible para que las peticiones sean aceptadas por OHIP.
• Ejemplo de uso: la facilita Oracle al habilitar OHIP.
Qué ocurre cuando se utiliza: las peticiones se identifican correctamente ante Opera Cloud.
Comportamiento del sistema: sin App Key válida, OHIP rechaza las llamadas.
6) URL del gateway
• Nombre del campo: URL del gateway
• Descripción: Dirección del servicio de OHIP al que se conecta Golfmanager. Por defecto https://api.platform.opera-cloud.com/ohip (puede variar por región).
• Impacto en el sistema: Define a qué servidor de Opera Cloud se dirigen las peticiones.
• Ejemplo de uso: el hotel te indica la URL correcta para su región.
Qué ocurre cuando se utiliza: las consultas y cargos viajan a ese gateway.
Comportamiento del sistema: una URL incorrecta produce errores de conexión.
7) Enterprise ID
• Nombre del campo: Enterprise ID
• Descripción: Identificador de la organización en Oracle, necesario en las peticiones a OHIP.
• Impacto en el sistema: Ubica las peticiones dentro de la cuenta correcta de Oracle.
• Ejemplo de uso: lo facilita Oracle junto con el resto de credenciales.
Qué ocurre cuando se utiliza: las peticiones se asocian a la empresa correcta.
Comportamiento del sistema: si falta o es erróneo, Opera no procesa las peticiones.
8) Moneda
• Nombre del campo: Moneda
• Descripción: Divisa con la que se envían los cargos a Opera (por defecto EUR).
• Impacto en el sistema: Debe coincidir con la divisa que maneja el hotel para esa propiedad.
• Ejemplo de uso: dejas EUR en un hotel que factura en euros.
Qué ocurre cuando se utiliza: los cargos llegan a Opera en esa divisa.
Comportamiento del sistema: una divisa incoherente puede provocar rechazos del hotel.
9) Enviar a Opera también los pagos que no son de Opera
• Nombre del campo: Enviar pagos que no son de Opera
• Descripción: Opción para que los pagos hechos con otras formas (efectivo, tarjeta…) también se comuniquen a Opera.
• Impacto en el sistema: Permite que el hotel vea en el folio todas las ventas, no solo los cargos a habitación. Solo se reportan las formas de pago que tengan asignado un Código Opera Cloud.
• Ejemplo de uso: lo activas para tener visibilidad completa de pagos divididos.
Qué ocurre cuando se utiliza: los pagos en efectivo/tarjeta de una venta también se notifican a Opera.
Comportamiento del sistema: si una forma de pago no tiene código, no se reporta.
10) Hotel ID
• Nombre del campo: Hotel ID (en Opera Cloud > Hoteles)
• Descripción: Identificador de cada hotel/propiedad en Opera, junto con su nombre.
• Impacto en el sistema: Indica a qué propiedad de Opera se dirigen las búsquedas y cargos.
• Ejemplo de uso: das de alta el hotel con el Hotel ID que te indica el hotel.
Qué ocurre cuando se utiliza: al cargar, eliges el hotel y se consultan sus reservas.
Comportamiento del sistema: un Hotel ID erróneo hace que no se encuentren reservas.
11) Código Opera Cloud (subfamilia)
• Nombre del campo: Código Opera Cloud, en cada subfamilia
• Descripción: Código de transacción de Opera con el que se registran los productos de esa subfamilia.
• Impacto en el sistema: Permite que el hotel clasifique correctamente los consumos (golf, tienda, restauración…).
• Ejemplo de uso: a la subfamilia "Restaurante" le pones el código de transacción de restauración de Opera.
Qué ocurre cuando se utiliza: los cargos de esos productos llegan a Opera bajo ese código.
Comportamiento del sistema: sin código, el cargo puede no clasificarse como el hotel espera.
12) Cashier ID Opera Cloud (TPV)
• Nombre del campo: Cashier ID Opera Cloud, en cada TPV
• Descripción: Identificador de cajero que el hotel asigna a cada TPV para el cuadre diario en Opera.
• Impacto en el sistema: Asocia los cargos al cajero correcto en Opera.
• Ejemplo de uso: el hotel te da un Cashier ID por punto de venta.
Qué ocurre cuando se utiliza: los cargos de ese TPV se imputan a ese cajero.
Comportamiento del sistema: si el hotel lo exige y falta, los cargos pueden rechazarse.
13) Código Opera Cloud (forma de pago)
• Nombre del campo: Código Opera Cloud, en cada forma de pago
• Descripción: Código de Opera asociado a una forma de pago, para reportarla cuando se activa el envío de pagos que no son de Opera.
• Impacto en el sistema: Solo las formas de pago con código se comunican a Opera.
• Ejemplo de uso: pones el código de "efectivo" en la forma de pago Efectivo.
Qué ocurre cuando se utiliza: los pagos en efectivo se reportan a Opera con ese código.
Comportamiento del sistema: las formas de pago sin código quedan fuera del reporte.
ℹ️ Nota: los nombres exactos pueden variar ligeramente según tu versión e idioma. La función de cada campo es la descrita.
Cómo se usa en el día a día
Cargar una venta a la habitación
En el TPV, añade los productos al carrito como siempre.
Como forma de pago, selecciona "Opera Cloud - Cargo a habitación".
Elige el hotel (si tienes varios dados de alta).
Localiza la reserva buscando por habitación o nombre del huésped.
Selecciona la reserva y confirma. El cargo se envía a la cuenta (folio) del huésped en Opera.
ℹ️ Si la reserva tiene activada la marca "No Post" en Opera, el hotel no permite cargos a esa habitación y la operación se rechazará indicándolo.
Devoluciones
Para devolver, cancela/descarta el cargo desde Golfmanager: el sistema envía a Opera la devolución sobre la misma reserva. En Opera Cloud, además, puedes dirigir la devolución a otra habitación si fuera necesario.
Consultar las transacciones
En Opera Cloud > Transacciones verás todas las operaciones enviadas a Opera, con el huésped, la habitación, el importe, si fueron correctas o fallidas y el detalle del error si lo hubo. Es la primera pantalla a revisar cuando un cargo no se ha completado.
Cada transacción tiene un tipo:
Cargo (pago): se añadió un importe a la habitación.
Devolución: se restó un importe previamente cargado.
Pago externo / Rechazada: notificación de un pago que no es de Opera, o una operación que el hotel no aceptó. Cuando Opera rechaza un cargo, Golfmanager deshace el pago de su lado y la línea queda pendiente de pago.
Cada registro guarda la petición enviada y la respuesta recibida, lo que ayuda a soporte a diagnosticar.
Variantes de la integración con Opera
Existen varias formas de conectar con Opera según el hotel. El funcionamiento para el usuario (cargar a habitación) es equivalente; cambian los datos de conexión y la infraestructura. Tu equipo de implantación te indicará cuál aplica a tu hotel.
Opera Cloud (OHIP): la versión actual y recomendada, por API REST en tiempo real, descrita en este artículo. La forma de pago es "Opera Cloud - Cargo a habitación".
Opera 2.0 (vía servidor/proxy): conexión contra un Opera on-premise a través de un servidor intermedio. Permite configurar subtotales y centro de ingresos (revenue center) por subfamilia.
Opera (clásica, on-premise): la integración original de cargo a habitación. La forma de pago es "(OPERA) Cargo a habitación".
Sobre la variante clásica (on-premise)
En las instalaciones clásicas, Golfmanager no habla directamente con el Opera del hotel, sino con un servidor local de Opera (un programa que se instala en un terminal del club y que reenvía las peticiones al Opera final). Algunos aspectos propios de esta variante:
Dirección del servidor local: se configura la IP del servidor local (por ejemplo
http://127.0.0.1:8081), siempre con el encabezadohttp://.Subtotales de Opera: cada subfamilia puede asignarse a un grupo de subtotal (Opera admite hasta 16) para que el hotel reciba las ventas agrupadas a su manera (por ejemplo, "Restauración" en un subtotal y "Tienda" en otro).
Impuestos: se puede elegir enviar los importes con impuestos desglosados o con el total impuestos incluidos.
Envío de la facturación a Opera: además del cargo en el momento, puede sincronizarse la facturación. Hay un envío manual (botón "Enviar a Opera" en la vista de ventas, que remite las ventas aún no enviadas) y un envío automático periódico configurable.
Estas opciones son específicas de la variante clásica. En Opera Cloud, la clasificación de productos se hace con el Código Opera Cloud de cada subfamilia.
Limitaciones a tener en cuenta
Depende del hotel: Opera y OHIP deben estar accesibles. Si el servicio no responde, no se pueden cargar habitaciones.
El huésped debe tener una reserva localizable en Opera (con check-in).
Las reservas con "No Post" no admiten cargos.
Requiere las credenciales de OHIP correctas y el Hotel ID.
No mezcles el modo de prueba con el real: en real los cargos afectan a la cuenta del huésped.
La variante clásica requiere un servidor local instalado y en ejecución en el club.
Preguntas frecuentes
¿Qué es un PMS, Opera y OHIP?
Un PMS es el programa con el que el hotel gestiona reservas, habitaciones y la cuenta de cada huésped. Oracle Opera es uno de los más usados. OHIP es la plataforma moderna de Oracle para conectarse a Opera Cloud por API.
¿El huésped paga en caja?
No. Con el cargo a habitación, el importe no se cobra en caja: se añade a la cuenta del huésped en el hotel y este lo paga al hacer el check-out.
Me sale "Esta reserva tiene la marca No Post". ¿Qué significa?
Significa que el hotel ha marcado esa reserva como no apta para cargos. Debes usar otra forma de cobro, o el hotel debe quitar la marca "No Post" en Opera.
No aparece la reserva al buscar. ¿Por qué?
Puede que el huésped no tenga una reserva localizable (sin check-in) o que Opera/OHIP no respondan. Verifica que el huésped está registrado y que el servicio del hotel está accesible.
Me da un error de conexión o de credenciales.
Revisa Client ID, Client Secret, Application Key, Enterprise ID y la URL del gateway. Usa la opción de probar conexión para confirmar que son correctos.
El cargo se rechaza aunque la conexión funciona.
Opera no aceptó el movimiento. Revisa el detalle en Transacciones: la reserva pudo cerrarse, tener restricciones o faltar algún dato. Cuando Opera rechaza, Golfmanager deshace el pago y la línea queda pendiente.
¿Qué diferencia hay entre el modo de prueba y el real?
En modo de prueba no se envían cargos reales al hotel: solo se valida el circuito. En real, cada cargo afecta de verdad a la cuenta del huésped.
¿Puedo hacer devoluciones?
Sí. Al descartar/cancelar el cargo, Golfmanager envía la devolución a Opera. En Opera Cloud puedes incluso dirigirla a otra habitación si es necesario.
¿Qué ocurre con los pagos que no son de Opera (efectivo, tarjeta)?
Por defecto no se envían a Opera. Si activas la opción "Enviar pagos que no son de Opera" y asignas un Código Opera Cloud a esas formas de pago, también se reflejarán en el folio.
¿Para qué sirve el "Código Opera Cloud" de las subfamilias?
Es el código de transacción con el que Opera clasifica los productos (golf, tienda, restauración…). Permite que el hotel vea los consumos en las categorías correctas.
¿Qué versiones de Opera son compatibles?
La recomendada es Opera Cloud (OHIP). También existen variantes on-premise (Opera 2.0 vía servidor y Opera clásica). Para el usuario, cargar a habitación funciona igual; cambia la conexión.
¿Necesito instalar algo en el club?
Con Opera Cloud no: la conexión es por internet (API). Con las variantes clásicas sí: hace falta un servidor local de Opera instalado y en ejecución en un terminal del club.
¿Hace falta firmar algún documento para activarla?
Sí. Normalmente hay que enviar firmado el formulario de autorización de la integración por API antes de operar en real.
¿Dónde veo si un cargo ha fallado?
En Opera Cloud > Transacciones. Cada operación muestra si fue correcta o fallida y el detalle del error.
¿Quién me facilita las credenciales de OHIP?
Las facilita Oracle o el equipo de IT del hotel. Reúnelas antes de configurar la integración.
Buenas prácticas recomendadas
Prueba primero en modo de prueba y con "probar conexión" antes de operar en real.
Reúne las credenciales de OHIP con el equipo de IT del hotel.
Configura el Código Opera Cloud en las subfamilias para que los consumos lleguen bien clasificados.
Confirma siempre la reserva y el huésped antes de cargar.
Ante un cargo fallido, revisa primero Transacciones: el detalle del error suele indicar la causa.
Completa el formulario de autorización antes de empezar a operar.
¿Necesitas ayuda?
Si tienes dudas sobre las credenciales de OHIP, la configuración o un cargo que no se completa, nuestro equipo de soporte está disponible para ayudarte. Escríbenos en la burbuja azul de tu programa de gestión. Para los datos de conexión y las reglas del hotel (No Post, códigos de transacción, Hotel ID…), apóyate también en el equipo de IT del hotel, que es quien gestiona Opera.