Índice
Para quién es este artículo: aplica a los clubes que gestionan torneos con Golf Genius.
¿Qué es esta integración?
La integración con Golf Genius conecta Golfmanager con Golf Genius, uno de los software de competición de golf de referencia a nivel mundial. Permite inscribir jugadores en torneos de forma sencilla (online o desde recepción) y mantener sincronizados entre ambos sistemas los inscritos, los horarios de salida y los resultados.
En Golf Genius, los torneos se organizan en eventos y rondas. La integración los enlaza con el módulo de torneos y con las reservas de Golfmanager: cuando un jugador contrata un tipo de reserva (tarifa) asociado a un torneo, queda inscrito automáticamente.
El mapeo de tees (Tee Resource Mapping) relaciona cada salida (tee) de un evento de Golf Genius con un recurso de Golfmanager (campo/hoyo de salida), para que los horarios de salida se importen al sitio correcto.
¿Qué problema resuelve?
Evita la doble gestión: los inscritos, las salidas y los resultados se comparten entre Golfmanager y Golf Genius sin teclearlos dos veces.
Inscripción integrada: apuntarse al torneo es tan fácil como reservar un green fee; la inscripción queda reflejada como reserva en Golfmanager.
Datos de competición al día: hándicaps, licencias y resultados se mantienen coherentes entre los dos sistemas.
Centraliza la operativa del club aunque la competición se gestione en Golf Genius.
Tipos de integración (modos de juego)
Hay dos formas de gestionar un torneo de golf:
Modo británico / australiano: el club decide qué días hay torneo y los jugadores eligen cuándo y con quién jugar.
Modo internacional: los jugadores se apuntan a una bolsa de inscritos y el club genera los partidos el día anterior.
Actualmente la integración está activa en modo británico / australiano. El modo internacional estará disponible próximamente.
Cómo funciona el modo británico / australiano: el club marca los días con torneo. El jugador puede jugar esos días en el campo y decidir si lo hace en modo torneo o en modo amistoso, eligiendo la hora de salida y a sus compañeros. Por ejemplo, los jugadores A y B deciden jugar el sábado a las 10:00 y solo el jugador A se une al torneo: ambos reservan juntos, el jugador A toma la tarifa de torneo y el jugador B la tarifa normal de green fee. Jugarán juntos, pero solo el jugador A recibirá tarjeta de juego y optará a los premios.
¿Qué sistemas conecta y en qué dirección viajan los datos?
Conecta Golfmanager con Golf Genius a través de su API, en ambos sentidos:
Golf Genius → Golfmanager: al importar o sincronizar un evento, se traen sus datos, inscritos, horarios de salida y resultados.
Golfmanager → Golf Genius: cuando un jugador se inscribe (o se cancela), la inscripción se envía a Golf Genius. También puedes empujar a Golf Genius las inscripciones creadas en Golfmanager que aún no estén en la plataforma.
¿Qué información se intercambia?
Información | Dirección | Para qué |
Eventos, rondas y campos/tees | Golf Genius → Golfmanager | Mostrar/importar torneos y mapear las salidas |
Inscripción del jugador (nombre, apellidos, email, licencia, hándicap) | Golfmanager → Golf Genius | Apuntar (o cancelar) al jugador en el torneo |
Inscritos, salidas (tee times) y resultados (bruto, neto, stableford) | Golf Genius → Golfmanager | Sincronizar el torneo en Golfmanager |
Formulario de autorización
Para autorizar la integración entre tu club y Golf Genius a través de la API, antes de empezar tendrás que enviar a Golfmanager el documento de autorización cumplimentado y firmado por ambas partes. Encontrarás el documento y el procedimiento en este enlace.
Requisitos previos (antes de activar la integración)
Tener cuenta en Golf Genius y su clave de API (la facilita Golf Genius desde el panel de tu cuenta).
Tener el módulo Golf Genius instalado (se descarga desde el App Market), junto con los módulos de reservas y torneos.
Haber enviado el formulario de autorización firmado por ambas partes.
Que los jugadores tengan nombre, apellidos y email en su ficha (Golf Genius los exige), y su licencia y hándicap si el torneo lo requiere.
Permisos de administrador de sistema para configurar la integración.
Cómo se configura (paso a paso)
La puesta en marcha tiene tres bloques: (A) instalar y conectar el módulo, (B) asociar un tipo de reserva a un torneo y (C) mapear los tees. Más abajo, en «Explicación de cada campo», tienes el detalle de qué hace cada campo.
A) Instalar y conectar el módulo
Accede a Configuración > App Market y descarga la app Golf Genius.
Accede a Golf Genius > Configuración.
Introduce la API key facilitada por Golf Genius. Pulsa Enter o haz clic fuera del campo para confirmar el dato.
Selecciona el Entorno: Producción (golfgenius.com) para operar de verdad, o Pruebas/Staging (ggstest.com) para testear.
Selecciona, si procede, el Tipo de reserva por defecto y la Forma de pago que se usarán al sincronizar/cobrar.
Guarda los cambios.
B) Asociar un tipo de reserva a un torneo
Al instalar el módulo, los tipos de reserva incorporan la posibilidad de asociarse a un torneo de Golf Genius. Así, cada vez que alguien contrata esa tarifa, se le inscribe automáticamente en el torneo asociado. La tarifa es visible en recepción y online como cualquier green fee.
Accede a la configuración de tipos de reserva y crea el tipo que desees (por ejemplo, «Torneo Rolex»).
En el campo Forma de identificación, elige la opción Buscar cliente (imprescindible: el jugador debe quedar identificado).
En la parte inferior, en ID del torneo de Golf Genius, elige del desplegable el torneo donde se inscribirá a los jugadores que contraten esta tarifa.
Activa ¿Requiere licencia? si el torneo obliga a jugar con licencia federativa.
Guarda los cambios.
Nota. Puedes limitar el tipo de reserva por fechas, días de la semana, etc., y personalizar los emails de confirmación, cancelación y recordatorio para adaptarlos a tu torneo.
C) Mapeo de tees (Tee Resource Mapping)
En Golf Genius > Tee Resource Mapping, relaciona cada salida del evento con un recurso de Golfmanager:
Elige el Evento (se carga desde Golf Genius).
Selecciona el Tee de ese evento.
Asígnale el Recurso de Golfmanager (campo/hoyo de salida).
Guarda los cambios.
⚠️ Sin la API key no funciona ninguna operación. Y sin el mapeo de tees, los horarios de salida no podrán asignarse al recurso correcto.
Explicación de cada campo
Primero, los campos del módulo en Golf Genius > Configuración; después, los campos que aparecen al asociar un tipo de reserva a un torneo. De cada uno se indica qué es, su impacto, un ejemplo y cómo se comporta el sistema.
1. API key
Nombre del campo: API key.
Descripción: clave de autenticación que identifica a tu club frente a la API de Golf Genius. La facilita Golf Genius y se guarda cifrada.
Impacto en el sistema: es la credencial principal; sin ella ninguna operación con Golf Genius funciona.
Ejemplo de uso: pegas la clave del panel de tu cuenta de Golf Genius y pulsas Enter (o haces clic fuera del campo) para confirmar.
Qué ocurre cuando se utiliza: Golfmanager la envía en cada llamada para listar eventos, inscribir, sincronizar o cancelar.
Comportamiento del sistema: si falta o es incorrecta, el sistema avisa de que falta la clave de aplicación (apiKey) y bloquea las operaciones.
2. Entorno
Nombre del campo: Entorno.
Descripción: indica contra qué servidor de Golf Genius trabaja la integración: Producción (golfgenius.com) o Pruebas/Staging (ggstest.com).
Impacto en el sistema: determina si las operaciones son reales o de prueba.
Ejemplo de uso: durante la puesta en marcha eliges «Pruebas» para validar el flujo; cuando todo funciona, cambias a «Producción».
Qué ocurre cuando se utiliza: todas las llamadas se dirigen al servidor del entorno seleccionado.
Comportamiento del sistema: por defecto trabaja en Producción; conviene volver a Producción antes de abrir las inscripciones al público.
3. Tipo de reserva (por defecto)
Nombre del campo: Tipo de reserva.
Descripción: tipo de reserva por defecto que el sistema utiliza al crear reservas al importar los horarios de salida (tee times) desde Golf Genius.
Impacto en el sistema: determina con qué tarifa/condiciones se generan las reservas de las salidas importadas.
Ejemplo de uso: seleccionas un tipo de reserva de torneo que ya tengas creado.
Qué ocurre cuando se utiliza: al sincronizar las salidas, las reservas resultantes toman este tipo de reserva.
Comportamiento del sistema: si no se configura, las salidas se importan sin un tipo de reserva por defecto asociado.
4. Forma de pago
Nombre del campo: Forma de pago.
Descripción: forma de pago con la que se registra el cobro cuando Golf Genius informa de reservas pagadas.
Impacto en el sistema: determina cómo se asienta el cobro de las inscripciones pagadas.
Ejemplo de uso: seleccionas la forma de pago que quieras asociar a los cobros de torneos.
Qué ocurre cuando se utiliza: el cobro de la inscripción se registra con esta forma de pago.
Comportamiento del sistema: si no se configura, no se aplica una forma de pago específica para estos cobros.
5. ID del torneo de Golf Genius (en el tipo de reserva)
Nombre del campo: ID del torneo de Golf Genius.
Descripción: desplegable, dentro del tipo de reserva, que enlaza esa tarifa con un torneo (ronda/evento) concreto de Golf Genius.
Impacto en el sistema: es lo que convierte una tarifa normal en una «tarifa de torneo».
Ejemplo de uso: en el tipo de reserva «Torneo Rolex» eliges del desplegable el torneo correspondiente.
Qué ocurre cuando se utiliza: cada vez que alguien contrata ese tipo de reserva, se le inscribe automáticamente en el torneo asociado.
Comportamiento del sistema: si está vacío, la tarifa funciona como un green fee normal y no inscribe en ningún torneo.
6. ¿Requiere licencia?
Nombre del campo: ¿Requiere licencia?
Descripción: casilla, dentro del tipo de reserva, que exige que el jugador tenga licencia federativa para poder contratar esa tarifa.
Impacto en el sistema: bloquea la inscripción de quien no tenga licencia en su ficha.
Ejemplo de uso: la activas en los torneos que obligan a jugar con licencia.
Qué ocurre cuando se utiliza: al reservar, el sistema comprueba la licencia del jugador.
Comportamiento del sistema: si el jugador no tiene licencia, se muestra un aviso indicando que no ha sido posible encontrar una licencia y que este tipo de reserva la requiere.
7. Forma de identificación = Buscar cliente
Nombre del campo: Forma de identificación.
Descripción: determina cómo se identifica al jugador al reservar. Para los tipos de reserva de torneo debe ser Buscar cliente.
Impacto en el sistema: garantiza que la reserva quede ligada a un cliente concreto (Golf Genius no admite inscripciones anónimas).
Ejemplo de uso: en el tipo de reserva de torneo seleccionas «Buscar cliente» en este campo.
Qué ocurre cuando se utiliza: al reservar, hay que buscar y elegir al jugador, cuyos datos se envían a Golf Genius.
Comportamiento del sistema: si la reserva no tiene cliente, el sistema avisa de que no se permiten inscripciones anónimas y pide identificarse.
Cómo se usa en el día a día
Inscripción de un jugador — online (portal)
El jugador reserva una salida como cualquier green fee, eligiendo el día y la hora deseados.
Al elegir la tarifa, selecciona la tarifa de Torneo.
Busca y elige al jugador (recuerda: el tipo de reserva usa «Buscar cliente»).
Paga la inscripción para confirmar la reserva. En ese momento queda inscrito en el torneo y los datos se envían a Golf Genius.
Inscripción de un jugador — recepción (administración)
Elige el día y la hora donde apuntar al jugador y selecciona la tarifa de Torneo.
Al reservar, el jugador queda inscrito en el torneo automáticamente.
Si la inscripción se cancela, Golfmanager también la cancela en Golf Genius.
Importar y sincronizar torneos
Desde la administración, pulsa Importar de Golf Genius y elige el evento a importar al módulo de torneos. Se crea el torneo en Golfmanager vinculado a Golf Genius.
Desde la ficha del torneo, pulsa Sincronizar con Golf Genius y marca qué traer/enviar:
Datos del evento (nombre, fechas, categoría, estado).
Solo inscritos (sin horarios de salida) o Salidas (tee times), que crean inscritos y reservas.
Resultados (tarjetas y clasificación).
Enviar a Golf Genius las inscripciones locales que aún no se hayan enviado.
Confirma la sincronización. Al terminar verás cuántos inscritos, salidas, resultados e inscripciones enviadas se han procesado.
Cada torneo muestra su estado de sincronización (sincronizado, con error o sin sincronizar) y la fecha de la última sincronización.
Cómo se identifica a los jugadores
Al importar inscritos, salidas o resultados desde Golf Genius, el sistema intenta emparejar cada jugador con un cliente de Golfmanager en este orden:
Por email (debe haber una única coincidencia).
Por licencia federativa (número de licencia), si no se encontró por email.
Por nombre exacto, como último recurso.
Durante la sincronización, Golf Genius también puede completar en la ficha del cliente la licencia de golf y el hándicap (campos de solo lectura).
Pantallas del módulo
En el menú Golf Genius tienes:
Torneos (Tournaments): los eventos de Golf Genius enlazados, con su estado de sincronización.
Rondas (Rounds): las rondas de cada torneo.
Inscripciones (Registrations): el registro de inscripciones gestionadas con Golf Genius (cliente, torneo y ronda).
Tee Resource Mapping (mapeo de tees) y Configuración.
Limitaciones a tener en cuenta
Golf Genius exige nombre, apellidos y email del jugador: sin ellos, no se puede inscribir.
No se permiten inscripciones anónimas: el jugador debe estar identificado (por eso el tipo de reserva usa «Buscar cliente»).
El modo internacional aún no está disponible: la integración opera en modo británico / australiano.
El mapeo de tees es necesario para que las salidas se asignen al recurso correcto.
La sincronización es bajo demanda: inscritos, salidas y resultados se traen al importar o sincronizar (no hay sincronización parcial ni automática).
Depende del servicio de Golf Genius: si no está disponible, no se pueden hacer estas operaciones en ese momento.
Preguntas frecuentes (FAQ)
El sistema dice que falta la clave de aplicación (apiKey). ¿Qué hago?
No se ha configurado la API key. Entra en Golf Genius > Configuración, introduce la clave que te facilitó Golf Genius y confírmala (Enter o clic fuera del campo). Sin ella, ninguna operación funciona.
Al inscribir aparece que falta el nombre, los apellidos o el email del cliente. ¿Por qué?
Golf Genius exige nombre, apellidos y email de cada jugador. Completa esos datos en la ficha del cliente y vuelve a intentarlo.
Aparece que no se permiten inscripciones anónimas. ¿Cómo lo soluciono?
La reserva no tiene un cliente asociado. Asegúrate de que el tipo de reserva de torneo tiene la Forma de identificación en Buscar cliente y de identificar al jugador al reservar.
El jugador no puede reservar porque «requiere licencia». ¿Qué ocurre?
El tipo de reserva tiene activado ¿Requiere licencia? y el jugador no tiene licencia en su ficha. Añade su licencia federativa o, si el torneo no la exige, desactiva esa casilla en el tipo de reserva.
Aparece que el jugador ya está inscrito en esta ronda. ¿Por qué?
Es una inscripción duplicada: ese jugador ya figura en esa ronda del torneo. Revisa las Inscripciones antes de volver a apuntarlo.
Al importar un evento dice que ya ha sido importado. ¿Qué significa?
Ese evento ya está vinculado a un torneo en Golfmanager. Usa el torneo existente y sincronízalo en lugar de importarlo de nuevo.
No puedo sincronizar un torneo: dice que no está vinculado a Golf Genius. ¿Qué falta?
El torneo no está enlazado a un evento de Golf Genius. Impórtalo primero desde Golf Genius para vincularlo y luego podrás sincronizarlo.
El evento ya no aparece o no se encuentra en Golf Genius. ¿Qué ha pasado?
El evento puede haberse eliminado o cambiado en Golf Genius después de vincularlo. Comprueba el evento en Golf Genius; si ya no existe, deberás volver a importar el correcto.
Aparece un error de conexión con Golf Genius. ¿Cómo lo reviso?
Golf Genius no respondió o la conexión falló. Revisa que la API key y el Entorno sean correctos e inténtalo de nuevo más tarde. Si persiste, contacta con el soporte de Golf Genius.
¿Qué diferencia hay entre el entorno de Pruebas (Staging) y el de Producción?
Pruebas/Staging (ggstest.com) sirve para validar la configuración y el flujo sin afectar a datos reales; Producción (golfgenius.com) opera de verdad. Prueba primero en Staging y cambia a Producción antes de abrir las inscripciones.
¿Para qué sirve el mapeo de tees y qué pasa si no lo configuro?
El mapeo de tees relaciona cada salida de un evento de Golf Genius con un recurso de Golfmanager. Sin él, los horarios de salida importados no pueden asignarse al recurso correcto. Configúralo para cada evento antes de sincronizar las salidas.
¿Cómo empareja el sistema a un jugador de Golf Genius con un cliente de Golfmanager?
Intenta emparejar por email, luego por licencia federativa y, por último, por nombre exacto. En cada caso debe haber una única coincidencia; si hay duda, el jugador no se vincula automáticamente.
¿Qué se trae exactamente al sincronizar un torneo?
Puedes traer los datos del evento, los inscritos, los horarios de salida (tee times) y los resultados. También puedes enviar a Golf Genius las inscripciones creadas en Golfmanager. Marcas qué quieres sincronizar antes de confirmar.
Dos jugadores quieren jugar juntos pero solo uno compite. ¿Es posible?
Sí. En modo británico / australiano ambos reservan la misma salida: el que compite toma la tarifa de torneo y el otro la tarifa normal de green fee. Juegan juntos, pero solo el primero recibe tarjeta y opta a premios.
¿Dónde veo las inscripciones gestionadas con Golf Genius?
En Golf Genius > Inscripciones (Registrations), donde figuran el cliente, el torneo y la ronda. Los torneos y rondas enlazados están en Torneos y Rondas.
Buenas prácticas recomendadas
Completa los datos de los jugadores (nombre, apellidos, email y licencia/hándicap) antes de inscribir.
Usa «Buscar cliente» como forma de identificación en los tipos de reserva de torneo.
Configura el mapeo de tees de cada evento para que las salidas caigan en el recurso correcto.
Prueba primero en el entorno de pruebas (Staging) antes de operar en Producción.
Sincroniza el torneo antes y después del evento para tener inscritos, salidas y resultados al día.
Revisa las Inscripciones ante cualquier inscripción duplicada o que no se complete.