Índice
Para quién es este artículo: aplica a los clubes que gestionan sus hándicaps con Handicap Master.
¿Qué es esta integración?
La integración con Handicap Master pone a disposición de ese sistema los datos de socios y competiciones del club, para que Handicap Master los sincronice automáticamente y no haya que introducirlos a mano.
Handicap Master consulta los datos de Golfmanager de forma periódica: la lista de socios, las competiciones marcadas para exportar y los jugadores inscritos en cada una.
Handicap Master es un software de gestión de hándicaps y competiciones. Esta integración le facilita los datos del club; los hándicaps y resultados los gestiona Handicap Master en su sistema. Golfmanager no guarda los hándicaps: solo expone los datos de socios y competiciones para que Handicap Master los lea.
¿Qué problema resuelve?
Evita teclear los socios y competiciones dos veces (en Golfmanager y en Handicap Master).
Mantiene la lista de socios al día en Handicap Master.
Comparte los inscritos en cada competición sin gestiones manuales.
Es sencilla: el club solo activa la integración y marca las competiciones.
¿Qué sistemas conecta y en qué dirección viajan los datos?
Conecta Golfmanager con Handicap Master, en un solo sentido:
Es Handicap Master quien consulta (lee) los datos de Golfmanager cuando lo necesita.
Golfmanager expone esos datos de forma segura (con una clave de API).
No es una sincronización bidireccional: Golfmanager comparte socios y competiciones; los hándicaps y resultados viven en Handicap Master y no se importan de vuelta.
¿Qué información se comparte?
Información | Qué incluye |
Socios | Referencia, nombre y apellidos, sexo, fecha de nacimiento, nº de tarjeta de socio, dirección (calle, ciudad, país, código postal), email y estado (activo, inactivo o baja) |
Competiciones | Identificador, nombre, fecha, hora de inicio y fin y nº de jugadores por ronda |
Jugadores de cada competición | Hora de salida, posición en el grupo, nombre y nº de socio |
Todos estos datos viajan de Golfmanager hacia Handicap Master.
Requisitos previos (antes de activar la integración)
Tener una cuenta de Handicap Master.
Tener el módulo Handicap Master instalado en tu Golfmanager.
Una clave de API para que Handicap Master se autentique al leer los datos.
Permisos de administrador de sistema para configurar.
Cómo se configura (paso a paso)
Paso 1 — Activar la integración
Ve a Configuración > Handicap Master.
Activa la opción "Activar integración".
Guarda los cambios. Si no está activada, Handicap Master no podrá leer los datos.
Paso 2 — Crear la clave de API
Ve a la sección de Claves de API y crea una clave nueva.
Entrega la clave a Handicap Master para que se conecte. Es la "contraseña" con la que su sistema accede a los datos.
Paso 3 — Marcar las competiciones
En cada competición (tipo de reserva) que quieras exportar, abre la sección Handicap Master.
Activa "Subir a Handicap Master".
Introduce la hora de inicio y la hora de fin del evento y el número de jugadores por ronda.
Guarda los cambios.
⚠️ Solo se exportan las competiciones que tengan activado "Subir a Handicap Master". Si una competición no aparece en Handicap Master, revisa primero esta casilla.
Detalle de cada campo de configuración
A continuación se explica cada campo: qué es, cómo afecta al sistema, cómo se comporta y un ejemplo de uso. Se agrupan en el ajuste de la integración, los campos de la competición y los campos del socio que deciden si se exporta.
Ajuste de la integración (Configuración > Handicap Master)
Activar integración
Nombre del campo: Activar integración. Es un interruptor (activado/desactivado, por defecto desactivado).
Descripción: habilita que Handicap Master pueda leer los datos del club.
Impacto en el sistema: sin él activado, las consultas de Handicap Master se rechazan.
Comportamiento del sistema: si está desactivado, al consultar aparece el aviso "la integración de Handicap Master no está activada".
Ejemplo de uso / qué ocurre: lo activas cuando vas a empezar a usar Handicap Master; lo desactivas si quieres cortar el acceso.
Campos de la competición (en el tipo de reserva, sección Handicap Master)
Subir a Handicap Master
Nombre del campo: Subir a Handicap Master. Es un interruptor.
Descripción: marca la competición para que se incluya en la exportación.
Impacto en el sistema: solo las competiciones con esta opción activada se comparten con Handicap Master.
Comportamiento del sistema: si está desactivado, esa competición no aparece en Handicap Master.
Ejemplo de uso / qué ocurre: lo activas en los torneos que gestiona Handicap Master y lo dejas desactivado en el resto.
Hora de inicio del evento
Nombre del campo: Hora de inicio del evento (HM).
Descripción: la hora a la que empieza la competición.
Impacto en el sistema: se envía a Handicap Master como hora de inicio del evento.
Comportamiento del sistema: forma parte de los datos de la competición que lee Handicap Master.
Ejemplo de uso / qué ocurre: pones, por ejemplo, 09:00.
Hora de fin del evento
Nombre del campo: Hora de fin del evento (HM).
Descripción: la hora a la que termina la competición.
Impacto en el sistema: se envía a Handicap Master como hora de fin del evento.
Comportamiento del sistema: forma parte de los datos de la competición.
Ejemplo de uso / qué ocurre: pones, por ejemplo, 14:00.
Jugadores por ronda
Nombre del campo: Jugadores por ronda (HM).
Descripción: el número de jugadores por ronda de la competición.
Impacto en el sistema: se envía a Handicap Master como número de jugadores.
Comportamiento del sistema: forma parte de los datos de la competición.
Ejemplo de uso / qué ocurre: pones, por ejemplo, 4 (grupos de cuatro).
Campos del socio que deciden si se exporta (ficha del cliente)
Estos campos no son exclusivos de Handicap Master, pero determinan si un socio se incluye en la lista que se comparte.
Sexo
Nombre del campo: Sexo (en la ficha del cliente).
Descripción: el sexo del socio (M/F).
Impacto en el sistema: es obligatorio para que el socio se exporte; también se envía en sus datos.
Comportamiento del sistema: si no está indicado, el socio no se incluye en la exportación.
Ejemplo de uso / qué ocurre: lo rellenas en cada socio que deba aparecer en Handicap Master.
Notificaciones por email
Nombre del campo: Notificaciones por email (en la ficha del cliente).
Descripción: indica si el socio acepta recibir comunicaciones por email.
Impacto en el sistema: debe estar activado para que el socio se exporte (control de privacidad).
Comportamiento del sistema: si está desactivado, el socio no se incluye.
Ejemplo de uso / qué ocurre: te aseguras de que los socios que deban exportarse lo tienen activado.
Número de socio
Nombre del campo: Número de socio (en la ficha del cliente).
Descripción: el número con el que se identifica al socio.
Impacto en el sistema: es el dato con el que Handicap Master relaciona a cada jugador (se envía como número de tarjeta/jugador).
Comportamiento del sistema: si un socio no tiene número, igualmente se exporta, pero su número de tarjeta saldrá vacío.
Ejemplo de uso / qué ocurre: asegúrate de que cada socio tiene su número para que Handicap Master lo reconozca.
Etiqueta de cuota/suscripción
Nombre del campo: Etiqueta (tag) vinculada a una cuota/suscripción.
Descripción: la etiqueta que marca al cliente como socio con una cuota vigente.
Impacto en el sistema: es necesaria (y debe estar vigente) para que el socio se exporte; determina su estado.
Comportamiento del sistema: el estado se envía como activo (asignación vigente), inactivo (etiqueta caducada) o baja (cliente o etiqueta eliminados).
Ejemplo de uso / qué ocurre: al renovar la cuota de un socio, su etiqueta sigue vigente y se exporta como activo.
Cómo se usa en el día a día
Una vez configurado, no hay que hacer nada: Handicap Master se conecta y lee los datos por su cuenta, de forma periódica.
El club solo tiene que mantener al día los socios y marcar las competiciones que quiera exportar.
Los administradores pueden previsualizar los datos que se comparten (socios, competiciones y jugadores) para comprobar que todo es correcto.
La frecuencia con la que se actualizan los datos la decide Handicap Master, que es quien consulta. Golfmanager solo expone los datos cuando se los piden.
Qué socios se exportan
Para que un cliente se incluya en la lista de socios que lee Handicap Master, debe cumplir todo esto:
Tener sexo indicado en su ficha.
Tener activadas las notificaciones por email.
Tener una etiqueta (tag) activa vinculada a una cuota/suscripción, con su asignación vigente (ya iniciada y no caducada).
No estar dado de baja (ni el cliente ni la etiqueta).
El estado que se envía es activo (asignación vigente), inactivo (etiqueta caducada) o baja (cliente o etiqueta eliminados).
Limitaciones a tener en cuenta
Es solo de exportación (un sentido): Golfmanager comparte los datos; los hándicaps y resultados se gestionan en Handicap Master y no se importan de vuelta.
Golfmanager no guarda hándicaps: solo expone datos de socios y competiciones.
Solo se exportan los socios que cumplen los criterios anteriores.
Solo se exportan las competiciones marcadas con "Subir a Handicap Master".
De los jugadores de una competición se excluyen las reservas anuladas, eliminadas o caducadas.
Es Handicap Master quien decide cuándo leer: la frecuencia de actualización depende de su sistema.
Requiere la integración activada y una clave de API válida.
Preguntas frecuentes
¿En qué sentido viajan los datos?
En un solo sentido: de Golfmanager hacia Handicap Master. Es Handicap Master quien consulta (lee) los datos. No es una sincronización bidireccional.
¿Se importan los hándicaps de vuelta a Golfmanager?
No. Golfmanager no guarda hándicaps; solo comparte datos de socios y competiciones. Los hándicaps y resultados viven en Handicap Master.
¿Cómo activo la integración?
En Configuración > Handicap Master, activa "Activar integración" y guarda. Sin esto, Handicap Master no puede leer los datos.
¿Para qué sirve la clave de API?
Es la "contraseña" con la que Handicap Master se autentica al consultar los datos. Se crea en la sección de Claves de API y se le entrega a Handicap Master.
Handicap Master no puede conectarse. ¿Qué reviso?
Comprueba que la integración está activada y que la clave de API es correcta y se la has facilitado a Handicap Master. Si la clave está mal, no podrá leer los datos.
Sale "La integración de Handicap Master no está activada". ¿Qué hago?
La opción "Activar integración" está desactivada. Actívala en Configuración > Handicap Master y guarda.
Una competición no aparece en Handicap Master. ¿Por qué?
Porque no tiene activado "Subir a Handicap Master". Edita el tipo de reserva de esa competición, actívalo y rellena sus horas y jugadores por ronda.
Un socio no se exporta. ¿Qué reviso?
Que cumpla todos los criterios: tener sexo, notificaciones por email activadas y una etiqueta de cuota vigente, y no estar de baja. Si falta alguno, no se incluye.
¿Qué significa que un socio salga como "inactivo" o "baja"?
Activo: su cuota/etiqueta está vigente. Inactivo: la etiqueta ha caducado. Baja: el cliente o la etiqueta se han eliminado. El estado se calcula automáticamente.
¿Con qué dato relaciona Handicap Master a cada jugador?
Con el número de socio, que se envía como número de tarjeta/jugador. Conviene que cada socio tenga su número para que Handicap Master lo reconozca.
¿Qué pasa si un socio no tiene número de socio?
Igualmente se exporta, pero su número de tarjeta saldrá vacío, lo que puede dificultar que Handicap Master lo relacione. Mejor asignarle uno.
¿Qué datos del socio se comparten?
Referencia, nombre y apellidos, sexo, fecha de nacimiento, nº de socio, dirección (calle, ciudad, país, código postal), email y estado.
¿Qué datos de la competición se comparten?
El identificador, el nombre, la fecha, la hora de inicio y fin y el número de jugadores por ronda.
¿Qué jugadores de una competición se comparten?
Los inscritos en esa competición, con su hora de salida, su posición en el grupo, su nombre y su nº de socio. Se excluyen las reservas anuladas, eliminadas o caducadas.
¿Cada cuánto se actualizan los datos?
Lo decide Handicap Master, que es quien consulta. Golfmanager expone los datos al instante cuando se los piden; la frecuencia de lectura depende de su sistema.
¿Puedo ver lo que se va a compartir antes?
Sí. Los administradores pueden previsualizar los datos de socios, competiciones y jugadores para comprobar que todo es correcto.
¿Tengo que hacer algo cada día o antes de cada torneo?
No de forma manual para enviar: basta con mantener los socios al día y marcar y rellenar los datos de la competición. El resto lo hace Handicap Master al consultar.
¿Hay un envío automático programado (cron)?
No por parte de Golfmanager. Golfmanager no envía nada por su cuenta: solo responde cuando Handicap Master pide los datos.
¿Qué permisos necesito para configurar la integración?
Permisos de administrador de sistema, que dan acceso a la configuración de Handicap Master y a la previsualización de los datos.
¿Puedo cortar el acceso de Handicap Master?
Sí: desactivando la integración o revocando la clave de API. A partir de ese momento, Handicap Master deja de poder leer los datos.
Buenas prácticas recomendadas
Mantén las fichas de socio completas (sexo, email, nº de socio y cuota vigente) para que se exporten bien.
Marca cada competición y rellena sus horas y jugadores por ronda antes del evento.
Usa una clave de API dedicada a Handicap Master, para poder revocarla sin afectar a otras integraciones.
Previsualiza los datos al implantar para confirmar que socios y competiciones salen correctos.