Índice
¿Qué es esta integración?
La integración con Ulyses Cloud conecta Golfmanager con el PMS (sistema de gestión hotelera) Ulyses Cloud. Permite que, desde el TPV de Golfmanager, el personal cargue las compras de un huésped directamente a su habitación.
El importe deja de cobrarse en caja y queda añadido a la cuenta del hotel, de modo que el huésped lo paga todo junto al hacer el check-out.
Un PMS (Property Management System) es el programa con el que el hotel gestiona habitaciones, reservas y la cuenta de cada huésped. Ulyses Cloud es uno de esos sistemas. Esta integración hace de puente entre tu TPV y la cuenta del huésped en el hotel.
¿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 cuenta del hotel.
Evita la doble gestión: el cargo viaja al PMS al instante.
Mejora la experiencia del cliente en complejos que combinan hotel y golf.
Deja rastro de cada operación: cargos y devoluciones quedan registrados.
¿Qué sistemas conecta y en qué dirección viajan los datos?
Conecta el TPV de Golfmanager con el PMS Ulyses Cloud (a través de su servicio en la nube), en tiempo real:
Golfmanager envía el cargo (o la devolución) a la habitación/cuenta del huésped.
Ulyses Cloud responde si la operación se ha realizado, y Golfmanager la registra.
¿Qué información se intercambia?
Información | Dirección | Para qué |
Búsqueda de habitación (huésped registrado) | Golfmanager ← Ulyses Cloud | Localizar la habitación ocupada del huésped |
Cargo: importe, concepto (código de producto) y cantidad | Golfmanager → Ulyses Cloud | Añadir el cargo a la cuenta del huésped |
Confirmación / devolución | Golfmanager ↔ Ulyses Cloud | Confirmar o anular el cargo |
Requisitos previos (antes de activar la integración)
Que el hotel use el PMS Ulyses Cloud y tenga activado su servicio.
Tener el módulo Ulyses instalado en tu Golfmanager, junto con los módulos de TPV y facturación.
Las credenciales de Ulyses Cloud (URL, usuario, contraseña) y los identificadores de cadena, propiedad y código de propiedad.
El código de artículo/departamento de Ulyses para cada producto que se vaya a cargar a habitación.
Permisos de gestión de sistema para configurar.
Cómo se configura (paso a paso)
Paso 1 — Datos de conexión
Accede a Golfmanager con un usuario administrador y entra en Ulysses > Configuración.
Elige el modo: deja el modo de producción desactivado para usar el entorno de pruebas, o actívalo para producción.
Introduce la URL, el usuario y la contraseña de Ulyses Cloud (la contraseña se guarda cifrada).
Introduce la cadena (Chain), la propiedad (Property) y el código de propiedad del hotel.
Hay un juego de campos para pruebas y otro para producción; rellena el que corresponda al modo activo.
Guarda los cambios.
Paso 2 — Productos
Entra en la ficha de cada producto que se pueda cargar a habitación.
Introduce su Código Ulysses (el artículo o departamento correspondiente en Ulyses).
Guarda los cambios.
⚠️ Recomendación: empieza en modo de pruebas con las credenciales de test, valida un cargo de ejemplo y activa el modo de producción solo cuando todo funcione. En producción los cargos son reales en la cuenta del huésped.
Explicación de cada campo
A continuación se describe cada campo de la integración: dónde está, qué significa, su impacto en el sistema y un ejemplo de uso (qué ocurre cuando se utiliza y cómo se comporta el sistema).
A) Configuración (Ulysses > Configuración)
1. Modo de producción
Descripción: indica si se usa el entorno de producción o el de pruebas.
Impacto en el sistema: determina qué juego de credenciales se utiliza (las de producción o las de prueba).
Ejemplo de uso: lo dejas desactivado mientras pruebas y lo activas al salir a real.
Qué ocurre cuando se utiliza: activado, los cargos son reales en la cuenta del huésped; desactivado, van al entorno de prueba.
Comportamiento del sistema: el sistema usa los datos del modo activo en cada cargo.
2. URL
Descripción: la dirección del servicio de Ulyses Cloud.
Impacto en el sistema: imprescindible. Es a dónde se envían las búsquedas y los cargos.
Ejemplo de uso: introduces la URL que te facilita el hotel/Tesipro.
Qué ocurre cuando se utiliza: Golfmanager se conecta a esa dirección.
Comportamiento del sistema: si falta, aparece "Ulyses: no hay URL configurada".
3. Usuario y 4. Contraseña
Descripción: las credenciales de acceso al servicio de Ulyses. La contraseña se guarda cifrada.
Impacto en el sistema: imprescindibles para autenticarse.
Ejemplo de uso: los copias de los datos que te da el hotel.
Qué ocurre cuando se utiliza: cada operación se autentica con ellos.
Comportamiento del sistema: si faltan, aparece "Ulyses: no hay usuario configurado" o "Ulyses: no hay contraseña configurada".
5. Cadena (Chain), 6. Propiedad (Property) y 7. Código de propiedad
Descripción: identifican el hotel concreto dentro de Ulyses (la cadena, la propiedad y su código).
Impacto en el sistema: imprescindibles. Dicen a qué hotel pertenecen los cargos.
Ejemplo de uso: introduces los identificadores que te facilita el hotel.
Qué ocurre cuando se utiliza: los cargos se aplican a la cuenta del huésped en ese hotel.
Comportamiento del sistema: si faltan, aparece "Ulyses: no hay cadena configurada" o "Ulyses: no hay propiedad configurada".
ℹ️ Existe un juego de campos equivalente para pruebas (URL, usuario, contraseña, cadena, propiedad y código de propiedad marcados como "(Test)"). El sistema usa unos u otros según esté activado el modo de producción.
B) En el producto
Nombre del campo: Código Ulysses.
Descripción: el artículo o departamento de Ulyses al que corresponde ese producto.
Impacto en el sistema: es obligatorio para poder cargar el producto a una habitación.
Ejemplo de uso: en un refresco pones el código del departamento de bebidas.
Qué ocurre cuando se utiliza: el cargo llega a Ulyses con ese concepto.
Comportamiento del sistema: si falta, al cargar aparece "El producto '…' no tiene código Ulysses".
C) En la venta
Pagado con Ulysses: indica que la venta se cargó correctamente a una habitación. Comportamiento: es de solo lectura; se marca al completarse el cargo.
Habitación Ulysses: la habitación a la que se cargó la venta. Comportamiento: es de solo lectura; se rellena con el cargo y se imprime en el ticket/factura.
D) En las transacciones
Cada operación enviada a Ulyses queda registrada con: la venta y la factura asociadas, el ID de Ulysses (identificador devuelto), la operación (cargo o devolución), el número de habitación, si fue correcta o no, y el detalle de la petición, la respuesta y el error. Comportamiento: es de solo lectura y sirve para diagnosticar.
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 "Cargo a habitación (Ulysses)".
Busca la habitación del huésped por su número y selecciónala (solo aparecen las habitaciones ocupadas).
Confirma. El cargo se envía a Ulyses Cloud y la venta queda pagada; en el ticket/factura se imprime el número de habitación.
ℹ️ El cargo a habitación no admite pago dividido: el importe se carga completo a la cuenta del huésped.
Devoluciones
Para devolver, cancela o devuelve el cargo desde Golfmanager: el sistema envía a Ulyses Cloud la anulación del importe (con cantidades negativas). La devolución debe hacerse por Ulyses y todas las ventas devueltas juntas deben ser de la misma habitación.
Consultar las transacciones
En Ulysses > Transacciones verás todas las operaciones enviadas a Ulyses Cloud (cargos y devoluciones), con el importe, la habitación, 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.
Limitaciones a tener en cuenta
Depende del hotel: Ulyses Cloud debe estar accesible. Si su servicio no responde, no se pueden cargar habitaciones.
El huésped debe estar registrado (con check-in): solo se ofrecen las habitaciones ocupadas.
Cada producto necesita su Código Ulysses; sin él, la venta no se puede cargar.
El cargo a habitación no admite pago dividido.
Las devoluciones se hacen por Ulyses y deben ser de la misma habitación.
Los importes se envían en euros (EUR).
No mezcles el modo prueba con el real: en producción los cargos son reales en la cuenta del huésped.
Preguntas frecuentes
Da error de conexión con Ulyses Cloud.
Suelen faltar datos o estar mal. Aparecen avisos del tipo "Ulyses: no hay URL configurada / no hay usuario / no hay contraseña / no hay cadena / no hay propiedad". Revisa la URL, el usuario, la contraseña, la cadena, la propiedad y el código de propiedad del modo activo.
Aparece "no se encontró servicio Ulysses" (error 404).
La URL o la ruta no son correctas, o el servicio no está disponible. Comprueba la URL y que el servicio de Ulyses esté activo.
Al buscar la habitación no aparece ninguna.
Solo se muestran las habitaciones ocupadas. Si el huésped no tiene check-in o el número no coincide, no saldrá. Verifica con recepción que el huésped está registrado.
Aparece "el producto '…' no tiene código Ulysses".
Ese producto no tiene asignado su Código Ulysses. Entra en su ficha, introduce el código del artículo/departamento de Ulyses y vuelve a intentarlo.
Aparece "el importe a cobrar no coincide".
El total del TPV no cuadra con la suma de las líneas de venta. Revisa el carrito y los importes antes de volver a cargar.
No me deja dividir el pago.
El cargo a habitación no admite pago dividido ("No se permite el pago dividido"). Carga el importe completo a la habitación.
No puedo devolver un cargo.
Las devoluciones de cargos a habitación deben hacerse por Ulyses; con otra forma de pago aparece "Los cargos no se pueden devolver a Ulyses con otras formas de pago". Además, una venta sin habitación no se puede devolver así, y todas las ventas devueltas juntas deben ser de la misma habitación.
El cargo se rechaza.
Ulyses no aceptó la operación. Revisa el detalle en Transacciones: el huésped puede haber hecho check-out o la cuenta puede estar cerrada.
Una prueba cobró de verdad (o al revés).
El modo de producción no estaba como debía. Comprueba el Modo de producción y que las credenciales del modo activo son las correctas.
¿Dónde reviso lo que se ha enviado a Ulyses?
En Ulysses > Transacciones. Cada cargo y devolución queda registrado con la habitación, el ID de Ulysses, si fue correcto y el detalle del error si lo hubo.
¿Qué identifica al huésped?
El número de habitación (la habitación ocupada). No hace falta tarjeta ni número de socio.
¿En qué moneda se cargan los importes?
En euros (EUR).
Buenas prácticas recomendadas
Prueba primero en modo test con las credenciales de prueba antes de activar producción.
Reúne las credenciales (URL, usuario, contraseña, cadena, propiedad y código de propiedad) con el equipo de IT del hotel.
Asigna el Código Ulysses a todos los productos que se vayan a cargar a habitación.
Confirma siempre la habitación y el huésped antes de cargar.
Ante un cargo fallido, revisa primero Transacciones: el detalle del error suele indicar la causa.