Índice
¿Qué es esta integración?
La integración con Range Manager conecta Golfmanager con el sistema externo Range Manager, que gestiona los dispensadores de bolas del campo de prácticas. Permite que el cliente compre y recargue bolas usando un saldo (un bono asociado a su ficha), y que todas esas operaciones queden registradas en Golfmanager como ventas y recargas.
Range Manager es el sistema que controla las máquinas de bolas. El saldo de bolas es un bono del cliente: se recarga (añade saldo) y se consume (al dispensar bolas). Golfmanager mantiene ese saldo y lo sincroniza con Range Manager.
¿Qué problema resuelve?
Autoservicio de bolas: el cliente dispensa y recarga sin pasar por recepción.
Prepago con saldo: el cliente gasta de su bono de bolas.
Todo registrado: compras, recargas y pagos quedan en Golfmanager.
Saldo siempre al día entre Golfmanager y Range Manager.
¿Qué operaciones permite?
Operación | Qué hace |
Añadir al carrito | Pasa al carrito del TPV las bolas elegidas en Range Manager (como venta pendiente) |
Pago con saldo | Cobra las bolas descontando del saldo de bonos del cliente |
Recarga | Añade saldo al bono del cliente |
Pago directo | Cobra sin usar saldo (por ejemplo, con tarjeta en la máquina) |
Consulta de saldo | Range Manager pregunta y Golfmanager devuelve el saldo del cliente |
¿Qué sistemas conecta y en qué dirección viajan los datos?
Conecta el TPV de Golfmanager con Range Manager, en ambos sentidos:
Desde el TPV se abre la interfaz de Range Manager (con un identificador de sesión) y, al terminar, se vuelve a Golfmanager.
Range Manager informa a Golfmanager de cada operación (compra, recarga o pago) y Golfmanager la registra y actualiza el saldo.
Golfmanager devuelve el saldo del cliente cuando Range Manager lo consulta.
El saldo de bolas (bono)
El cliente tiene un saldo combinado: si tiene varios bonos de Range Manager (de tipo "dinero"/monedero), se suman todos. Para mantener el orden:
Los pagos descuentan primero del bono más antiguo.
Las recargas se añaden al bono más reciente.
Así el cliente consume antes lo que cargó primero.
Requisitos previos (antes de activar la integración)
Tener el sistema Range Manager y sus dispensadores instalados.
Tener el módulo Range Manager instalado, junto con el módulo de TPV.
Un tipo de bono de Range Manager con un producto asignado, y bonos creados para los clientes.
Las credenciales de la API de Range Manager (Site, Vendor y contraseña).
Permisos de administración para configurar.
Cómo se configura (paso a paso)
Paso 1 — Credenciales
Accede a Golfmanager con un usuario administrador.
Entra en Range Manager > Configuración.
Introduce el Site, el Vendor y la contraseña (los facilita Range Manager).
Guarda los cambios. (La contraseña se guarda cifrada.)
Paso 2 — Tipo de bono y bonos de los clientes
Crea un tipo de bono marcado como "Range Manager" y asígnale un producto (el de las recargas).
Crea bonos de ese tipo para los clientes que vayan a usar las máquinas.
Guarda los cambios.
Paso 3 — Productos (opcional)
Entra en la ficha de los productos de bolas.
Rellena el ID de producto de Range Manager para que las ventas usen el producto correcto.
Guarda los cambios. (Si no lo haces, el producto se crea automáticamente a partir de los datos de la transacción.)
🔒 La contraseña de Range Manager se guarda cifrada y la conexión usa un token que se renueva solo. No necesitas gestionarlo manualmente.
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) Credenciales (Range Manager > Configuración)
1. Site
Descripción: el identificador de tu instalación en Range Manager.
Impacto en el sistema: es obligatorio. Identifica con qué cuenta de Range Manager se conecta y a qué interfaz se abre desde el TPV.
Ejemplo de uso: introduces el Site que te facilita Range Manager.
Qué ocurre cuando se utiliza: el TPV abre la interfaz de tu Range Manager correctamente.
Comportamiento del sistema: si falta, aparece "Range Manager site not configured" (Site no configurado) y no se conecta.
2. Vendor
Descripción: el identificador del operador/club para autenticarse en Range Manager.
Impacto en el sistema: es obligatorio. Forma parte de las credenciales de conexión.
Ejemplo de uso: introduces el Vendor que te facilita Range Manager.
Qué ocurre cuando se utiliza: se usa junto al Site y la contraseña para obtener el acceso.
Comportamiento del sistema: si falta, aparece "Range Manager vendor not configured" (Vendor no configurado) y no se conecta.
3. Contraseña
Descripción: la contraseña de la API de Range Manager.
Impacto en el sistema: es obligatoria. Se guarda cifrada y se usa para autenticarse.
Ejemplo de uso: introduces la contraseña que te facilita Range Manager.
Qué ocurre cuando se utiliza: la conexión obtiene un token que se renueva solo.
Comportamiento del sistema: si falta o es incorrecta, aparece "Range Manager password not configured" o un fallo de autenticación, y no se conecta.
B) Tipo de bono "Range Manager"
Nombre del campo: marca "Range Manager" en el tipo de bono, con su producto asociado.
Descripción: indica que ese tipo de bono es el monedero de bolas, y el producto es el que se usa al recargar saldo.
Impacto en el sistema: imprescindible. Solo los bonos de tipos marcados como "Range Manager" (y de tipo dinero) cuentan para el saldo y los pagos.
Ejemplo de uso: creas un tipo de bono "Saldo Range Manager" marcado como Range Manager y con su producto, y das bonos a los clientes.
Qué ocurre cuando se utiliza: el saldo de esos bonos se usa para pagar bolas y se incrementa al recargar.
Comportamiento del sistema: si el cliente no tiene ningún bono de este tipo, al recargar aparece "No Range Manager voucher found for customer" (no se encuentra bono).
C) ID de producto de Range Manager (en el producto)
Nombre del campo: ID de producto de Range Manager (en la ficha del producto).
Descripción: el identificador que relaciona un producto de Golfmanager con el de Range Manager.
Impacto en el sistema: es opcional. Hace que las ventas usen tu producto en vez de uno creado al vuelo.
Ejemplo de uso: en tu producto "30 bolas" introduces su ID de Range Manager.
Qué ocurre cuando se utiliza: las ventas de esas bolas salen con tu producto.
Comportamiento del sistema: si no lo rellenas, Golfmanager crea el producto automáticamente con los datos de la transacción (nombre e importe).
Cómo se usa en el día a día
Desde el TPV, pulsa el botón Range Manager; se abre Range Manager con el cliente identificado.
El cliente elige bolas y paga: con su saldo (bono), con pago directo (tarjeta) o pasando las bolas al carrito del TPV para cobrarlas allí.
También puede recargar saldo.
Golfmanager registra cada operación (venta, pago o recarga) y actualiza el saldo.
ℹ️ Cancelaciones: si cancelas una venta de bolas que ya se había pasado a Range Manager, el sistema comprueba el estado en Range Manager. Si las bolas aún no se han usado, se cancela; si ya se reclamaron/usaron, la cancelación se bloquea.
Registros, bonos y tokens
En el menú Range Manager tienes tres pantallas de consulta:
Registros (Logs): el historial de todas las operaciones recibidas (consulta de saldo, carrito, pago con saldo, recarga y pago directo), con su detalle y resultado (correcto o error). Es la primera pantalla a revisar ante cualquier incidencia.
Bonos: la relación entre las ventas de bolas y el bono de Range Manager correspondiente (sirve para el control de cancelaciones).
Tokens: el token de conexión, que se renueva solo; no hay que gestionarlo a mano.
Limitaciones a tener en cuenta
El saldo es combinado (suma de los bonos de Range Manager del cliente); se consume del más antiguo y se recarga en el más reciente.
Solo cuentan los bonos de tipo "dinero" marcados como Range Manager.
El pago con saldo necesita saldo suficiente en los bonos del cliente.
Para recargar, el cliente debe tener ya un bono de Range Manager.
No se puede cancelar una venta cuyas bolas ya se hayan usado en Range Manager.
Requiere las credenciales correctas (Site, Vendor, contraseña).
Depende del sistema Range Manager y de su conexión.
Preguntas frecuentes
No conecta con Range Manager.
Suele ser por credenciales incorrectas o incompletas. Revisa el Site, el Vendor y la contraseña en Range Manager > Configuración; si falta alguno, aparecen mensajes del tipo "Range Manager site/vendor/password not configured", y si son incorrectos, un fallo de autenticación.
El pago con saldo se rechaza.
El cliente no tiene saldo suficiente en sus bonos de Range Manager; aparece "Saldo insuficiente" (con el disponible y el necesario). El cliente debe recargar su bono antes de pagar con saldo.
No puedo cancelar una venta de bolas.
Si las bolas ya se han reclamado o usado en Range Manager, la cancelación se bloquea (mensaje del tipo "no se puede cancelar: el bono de Range Manager ya se ha usado"). Solo se pueden cancelar las bolas que aún no se han dispensado.
El producto de la venta no es el que esperaba.
Es porque ese producto no está mapeado con Range Manager. Rellena el "ID de producto de Range Manager" en la ficha del producto. Si no lo haces, Golfmanager crea un producto automáticamente con los datos de la transacción.
Al recargar me dice que no hay bono.
Aparece "No se encuentra un bono de Range Manager para el cliente". Las recargas añaden saldo a un bono existente, así que el cliente debe tener al menos un bono del tipo Range Manager. Créale uno y vuelve a intentarlo.
¿Qué es el "saldo combinado"?
Si un cliente tiene varios bonos de Range Manager, su saldo es la suma de todos. Al pagar se descuenta primero del bono más antiguo; al recargar se añade al más reciente. Así consume antes lo que cargó primero.
¿Cuentan todos los bonos para el saldo?
Solo los bonos de tipo "dinero" (monedero) marcados como Range Manager. Otros tipos de bono no se tienen en cuenta para el saldo ni para los pagos.
¿Qué es "Añadir al carrito"?
Es la opción que pasa las bolas elegidas en Range Manager al carrito del TPV como venta pendiente, para cobrarlas en caja con cualquier método (no necesariamente con el saldo).
¿Qué es el "pago directo"?
Es un cobro que no usa el saldo del cliente (por ejemplo, pagar con tarjeta en la máquina). Se registra en Golfmanager con el método de pago propio de Range Manager.
¿Cómo se identifica al cliente?
Range Manager se abre desde el TPV con el cliente ya identificado en Golfmanager; con ese cliente se asocian las compras, recargas y su saldo.
¿Dónde reviso lo que ha pasado?
En Range Manager > Registros (Logs) están todas las operaciones con su resultado y detalle. También tienes las pantallas de Bonos (relación venta–bono) y Tokens (conexión).
¿Tengo que gestionar el token de conexión?
No. El token se obtiene y se renueva automáticamente; no hay que tocarlo. La pantalla de Tokens es solo informativa.
¿Es segura la contraseña de Range Manager?
Sí. Se guarda cifrada en Golfmanager y se usa únicamente para autenticarse con la API de Range Manager.
¿Necesita conexión a internet?
Sí. La integración consulta e informa a Range Manager en tiempo real; si el servicio no está disponible, no se podrán abrir sesiones ni registrar operaciones en ese momento.
Buenas prácticas recomendadas
Crea el tipo de bono de Range Manager con su producto antes de empezar y bonos para los clientes.
Mapea tus productos con Range Manager para que las ventas usen el producto correcto.
Revisa los Registros (Logs) ante cualquier incidencia.
Informa a los clientes de cómo recargar y consumir su saldo de bolas.