Índice
¿Qué es esta integración?
La integración con Golf Directo conecta Golfmanager con la plataforma de gestión de torneos Golf Directo, especializada en la organización y administración de competiciones de golf e integrada con la RFEG (Real Federación Española de Golf). Golf Directo cubre la gestión completa del torneo (inscripciones, categorías, hándicaps, emparejamientos, cálculo de resultados, licencias federativas y estadísticas), y la integración trae todo ese flujo a Golfmanager. Permite:
Mostrar e inscribirse en torneos desde el portal del cliente (con su licencia federativa), cobrando la inscripción en Golfmanager.
Importar y sincronizar los torneos en el módulo de torneos de Golfmanager: datos del torneo, inscritos, horarios de salida y resultados.
Es una conexión bidireccional: Golf Directo consulta y envía información a Golfmanager, y Golfmanager hace lo mismo hacia Golf Directo. Gracias a ello, un jugador puede apuntarse a un mismo torneo tanto desde la web de Golf Directo como desde el portal/app de Golfmanager, y la inscripción queda reflejada en ambos sistemas.
La licencia RFEG es el número federativo del jugador. La integración la usa para inscribir a cada jugador en el torneo de Golf Directo, así que el cliente debe tenerla guardada en su ficha. Sin licencia, el jugador no podrá inscribirse ni ver la sección de torneos federados.
¿Qué problema resuelve?
Inscripción de torneos desde el portal: el socio se apunta y paga online, sin pasar por recepción.
Evita la doble gestión: los inscritos, las salidas y los resultados se traen a Golfmanager sin teclearlos a mano.
Centraliza el cobro: la inscripción se factura en Golfmanager con su producto y su forma de pago, y queda en el listado de ventas y cobros como cualquier otra venta.
Mantiene los torneos al día entre Golf Directo y Golfmanager, con un estado de sincronización y la fecha de la última sincronización siempre visibles.
¿Qué sistemas conecta y en qué dirección viajan los datos?
Conecta Golfmanager con Golf Directo a través de su API, en ambos sentidos:
Golf Directo → Golfmanager: los torneos se muestran en el portal y, al importarlos o sincronizarlos, sus inscritos, salidas (horarios) y resultados entran en Golfmanager.
Golfmanager → Golf Directo: cuando un jugador se inscribe (o se cancela) en el portal, la inscripción se envía a Golf Directo. También puedes empujar a Golf Directo las inscripciones que hayas creado en Golfmanager.
¿Qué información se intercambia?
Información | Dirección | Para qué |
Torneos disponibles (nombre, fechas, modalidad, descripción, ventanas de inscripción) | Golf Directo → Golfmanager | Mostrarlos en el portal y poder importarlos |
Inscripción del jugador (cliente, email, licencia RFEG) | Golfmanager → Golf Directo | Apuntar (o cancelar) al jugador en el torneo |
Inscritos, salidas (tee times) y resultados (tarjetas: bruto, neto, stableford, posición) | Golf Directo → Golfmanager | Sincronizar el torneo en Golfmanager |
Confirmación del pago de la inscripción | Golfmanager ↔ Golf Directo | Confirmar la reserva en Golf Directo cuando se cobra la inscripción |
Formulario de autorización
Para autorizar la integración entre tu club y Golf Directo 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 Directo y su clave de API (la proporciona Golf Directo, una por club).
Tener instalado el módulo Golf Directo (lo instala el equipo de Golfmanager), junto con los módulos de torneos, licencias federativas, facturación y portal del cliente.
El código del club en la RFEG y su contraseña RFEG.
Haber enviado el formulario de autorización firmado por ambas partes.
Que los clientes tengan su licencia RFEG en la ficha para poder inscribirse.
Permisos de gestión de reservas/torneos para configurar y administrar la integración.
Cómo se configura (paso a paso)
La puesta en marcha tiene tres bloques: (A) configurar el módulo dentro de Golfmanager, (B) preparar la conexión desde Golf Directo hacia Golfmanager y (C) dejar el enlace de acceso a los torneos en la web de Reservas. Más abajo, en «Explicación de cada campo», tienes el detalle de qué hace cada campo.
A) Configurar el módulo en Golfmanager (Golfmanager → Golf Directo)
Accede a Configuración > Golf Directo > Configuración.
Introduce la API key que te ha facilitado Golf Directo.
Selecciona el Entorno: Producción (golfdirecto.com) para operar de verdad, o Pruebas (test.golfdirecto.com) para testear sin cobrar.
Selecciona el Producto con el que se cobrará la inscripción en Golfmanager.
Selecciona la Forma de pago con la que se registrará el cobro de la inscripción.
Activa Cargar iframe si quieres que el formulario de Golf Directo se muestre incrustado dentro del portal durante la inscripción.
Activa Mostrar torneos en la home del portal si quieres que aparezca el carrusel de torneos en la página de inicio del portal del cliente.
Introduce el Código del club en la RFEG y la Contraseña RFEG.
Guarda los cambios. Al guardar el código y la contraseña RFEG, el club queda dado de alta automáticamente en Golf Directo y el sistema recibe y guarda la Contraseña Golf Directo (campo automático de solo lectura).
⚠️ Sin la API key y el Producto configurados, las inscripciones no se podrán realizar y el sistema mostrará el aviso «El módulo no está configurado».
B) Preparar la conexión de Golf Directo hacia Golfmanager (Golf Directo → Golfmanager)
Para que las inscripciones, las líneas de venta y los cobros hechos desde la web de Golf Directo lleguen a Golfmanager automáticamente, recomendamos contratar con Golf Directo su plan completo. Golf Directo se conecta con una API key de administración que el equipo de Golfmanager activa (la misma clave sirve para todos los clubes). Pasos:
En Golfmanager, accede a Configuración > Sistema > Usuarios y crea un usuario nuevo:
Nombre: Golfdirecto
Email: info@golfdirecto.com
Tipo: Administrador
Accede a Configuración > Facturación > Formas de pago y crea una forma de pago exclusiva para Golf Directo con estos valores:
Nombre: «Golfdirecto» o «Torneos Golfdirecto».
Tipo: Transferencia.
Disponible online: Desactivado.
Devolución en TPV: Activado.
Permitir cambiar: Activado.
Válido en API: Activado.
Entra en Golf Directo > Ajustes > Opciones > pestaña Golfmanager y rellena:
Método de pago asociado: la forma de pago que acabas de crear para ellos.
Caja asociada: una caja existente en Golfmanager o una nueva específica para Golf Directo.
Producto asociado: el producto por defecto que se usará si al configurar un torneo no se indica otro.
Guarda los cambios en ambas plataformas.
NOTA importante sobre la pasarela de pago. No es posible reutilizar la misma pasarela de pago (Redsys, Stripe…) que tengas configurada en Golfmanager, porque en la web de la pasarela solo se puede dar de alta la URL de comercio del consumer de reservas de Golfmanager. Por eso la inscripción cobrada desde Golf Directo se registra mediante la forma de pago dedicada que has creado.
Explicación de cada campo de configuración
Estos son los campos del módulo en Configuración > Golf Directo > Configuración. 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 Directo. La proporciona Golf Directo y se guarda cifrada.
Impacto en el sistema: es la credencial principal; sin ella ninguna operación con Golf Directo funciona.
Ejemplo de uso: pegas la clave que te envía Golf Directo (por ejemplo, una cadena larga de letras y números) y guardas.
Qué ocurre cuando se utiliza: Golfmanager la envía en cada llamada para listar torneos, inscribir, sincronizar o cancelar.
Comportamiento del sistema: si falta o es incorrecta, el sistema responde «El módulo no está configurado» y no se muestran ni se gestionan torneos.
2. Entorno
Nombre del campo: Entorno.
Descripción: indica contra qué servidor de Golf Directo trabaja la integración: Producción (golfdirecto.com) o Pruebas (test.golfdirecto.com).
Impacto en el sistema: determina si las inscripciones y cobros 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: en «Pruebas» no se generan operaciones reales; conviene volver a «Producción» antes de abrir las inscripciones al público.
3. Producto
Nombre del campo: Producto.
Descripción: producto de Golfmanager que se usa para cobrar y facturar la inscripción al torneo.
Impacto en el sistema: define el importe, los impuestos y la contabilización de la inscripción. Es obligatorio para poder inscribir.
Ejemplo de uso: creas o seleccionas un producto «Inscripción torneo» con su precio (y, si quieres, precios por tipo de cliente) y lo asignas aquí.
Qué ocurre cuando se utiliza: al inscribirse un jugador, Golfmanager genera una venta de ese producto por el importe de la inscripción.
Comportamiento del sistema: si no hay producto configurado, la sincronización y la inscripción avisan de que «Golf Directo no está configurado» y no se puede cobrar.
4. Forma de pago
Nombre del campo: Forma de pago.
Descripción: forma de pago de Golfmanager con la que se registra el cobro de la inscripción.
Impacto en el sistema: determina en qué medio/caja queda registrado el cobro de la inscripción.
Ejemplo de uso: seleccionas la forma de pago dedicada a Golf Directo (la que creaste en el paso B) o la que uses para el cobro online.
Qué ocurre cuando se utiliza: cuando se confirma el pago de la inscripción, el cobro se asienta con esta forma de pago.
Comportamiento del sistema: el cobro aparece en el listado de cobros y cobros desglosados asociado a la venta de la inscripción.
5. Cargar iframe
Nombre del campo: Cargar iframe.
Descripción: casilla que decide si el formulario de inscripción de Golf Directo se muestra incrustado dentro del portal (iframe) o si, en su lugar, se lleva al cliente directamente al proceso de pago de Golfmanager.
Impacto en el sistema: cambia la experiencia de inscripción del jugador.
Ejemplo de uso: lo activas si quieres que el jugador complete el formulario de Golf Directo sin salir del portal.
Qué ocurre cuando se utiliza: con el iframe activado, tras crear la reserva se muestra el formulario incrustado y el portal comprueba periódicamente si el jugador lo ha completado.
Comportamiento del sistema: si está desactivado, el jugador es redirigido al proceso de pago (checkout) de Golfmanager.
6. Mostrar torneos en la home del portal
Nombre del campo: Mostrar torneos en la home del portal.
Descripción: casilla que muestra un carrusel de torneos en la página de inicio del portal del cliente.
Impacto en el sistema: mejora la visibilidad de los torneos para el jugador.
Ejemplo de uso: lo activas cuando quieres promocionar los torneos abiertos directamente en la portada del portal.
Qué ocurre cuando se utiliza: bajo el menú de inicio del portal aparece un carrusel con los próximos torneos.
Comportamiento del sistema: si está desactivado, los torneos siguen siendo accesibles desde el enlace «Torneos», pero no se muestran en la portada.
7. Código del club en la RFEG
Nombre del campo: Código del club en la RFEG.
Descripción: código federativo que identifica a tu club ante la RFEG. Campo obligatorio que rellena el club.
Impacto en el sistema: junto con la contraseña RFEG, da de alta tu club en Golf Directo.
Ejemplo de uso: introduces el código que te asignó la RFEG.
Qué ocurre cuando se utiliza: al guardarlo junto con la contraseña RFEG, Golfmanager solicita el alta del club a Golf Directo.
Comportamiento del sistema: si el alta tiene éxito, Golf Directo devuelve la «Contraseña Golf Directo»; si falla, el sistema avisa de un error al registrar el club.
8. Contraseña RFEG
Nombre del campo: Contraseña RFEG.
Descripción: contraseña federativa del club. Campo obligatorio que rellena el club y se guarda cifrado.
Impacto en el sistema: es necesaria, junto al código RFEG, para registrar el club en Golf Directo.
Ejemplo de uso: introduces la contraseña federativa del club y guardas.
Qué ocurre cuando se utiliza: al guardarla, se dispara el alta del club en Golf Directo.
Comportamiento del sistema: tras un alta correcta, el sistema recibe y almacena la contraseña interna de Golf Directo.
9. Contraseña Golf Directo (automática)
Nombre del campo: Contraseña Golf Directo.
Descripción: contraseña que genera y devuelve Golf Directo cuando el club queda dado de alta. Es de solo lectura y no debe editarse a mano.
Impacto en el sistema: Golfmanager la utiliza internamente para autenticarse con Golf Directo.
Ejemplo de uso: no se rellena: se completa sola tras guardar el código y la contraseña RFEG.
Qué ocurre cuando se utiliza: el sistema la usa de forma transparente en las comunicaciones con Golf Directo.
Comportamiento del sistema: si está vacía, suele indicar que el alta del club aún no se ha completado correctamente; revisa el código y la contraseña RFEG y vuelve a guardar.
C) Enlace de acceso a las inscripciones en la web de Reservas
Una vez instalado el módulo de Golf Directo por el equipo de Golfmanager, se crea automáticamente un acceso en el menú principal de la web de Reservas que lleva a todos los torneos publicados en Golf Directo. Además, puedes añadir un acceso destacado mediante una tarjeta en la home:
Accede a Configuración General > CRM > Tarjetas de la Home.
Crea una tarjeta nueva e indica en la URL la ruta de torneos: //consumer/golfdirecto/tournaments
Asigna una prioridad para colocar la tarjeta en la posición deseada de la home.
Guarda los cambios.
Rutas útiles del portal: //consumer/golfdirecto/tournaments (listado de torneos) y //consumer/golfdirecto/mytournaments («Mis inscripciones», donde el jugador con licencia RFEG ve los torneos en los que está apuntado).
Cómo se usa en el día a día
Inscripción del jugador (portal)
El jugador entra en el portal y abre la sección de Torneos.
Elige un torneo y pulsa inscribirse. Necesita tener su licencia RFEG en la ficha; si no la tiene, el sistema se lo pedirá.
Se le cobra la inscripción con el producto y el precio configurados (pueden aplicarse precios por tipo de cliente). El pago se hace en Golfmanager o, si el torneo lo tiene activado, en Golf Directo.
Al confirmarse el pago, la inscripción se confirma en Golf Directo y queda registrada en ambos sistemas.
Si la inscripción se cancela, Golfmanager también la cancela en Golf Directo.
Importar y sincronizar torneos (administración)
Desde el listado de torneos, pulsa Importar de Golf Directo: el sistema muestra los torneos disponibles en Golf Directo.
Selecciona el torneo a importar. Se crea el torneo en Golfmanager vinculado a Golf Directo y marcado como sincronizado.
Desde la ficha del torneo, pulsa Sincronizar con Golf Directo y elige qué traer/enviar:
Datos del torneo (nombre, fechas, modalidad de puntuación).
Solo inscritos (sin horarios de salida) o Salidas (tee times), que crean inscritos y reservas. Estas dos opciones son excluyentes entre sí.
Resultados (tarjetas con bruto, neto, stableford y posición).
Enviar a Golf Directo las inscripciones hechas en Golfmanager que aún no estén en la plataforma.
Confirma la sincronización. Al terminar verás cuántos inscritos, salidas, resultados e inscripciones enviadas se han procesado.
En la ficha del torneo se reflejan el estado de sincronización (sincronizado, con error o sin sincronizar) y la fecha de la última sincronización, para saber siempre si los datos están al día.
Consultar las transacciones, ventas y cobros
Tienes tres sitios donde revisar lo que genera la integración:
Golf Directo > Transacciones: el registro de inscripciones gestionadas con Golf Directo. Por cada inscripción verás el cliente, el identificador de Golf Directo, el estado (borrador, formulario completado, confirmada o cancelada), la venta asociada y, si lo hubo, el error. Es la primera pantalla a revisar cuando una inscripción no se completa.
Listado de ventas: al inscribirse un jugador se genera una venta del producto de inscripción, visible como cualquier otra venta.
Cobros / cobros desglosados: si la inscripción requiere pago, se genera el cobro con la forma de pago configurada.
Limitaciones a tener en cuenta
El jugador necesita licencia RFEG en su ficha para inscribirse y para ver la sección de torneos federados.
Está orientada a torneos federados gestionados con Golf Directo (ámbito RFEG / España).
La inscripción se cobra con el producto y la forma de pago configurados.
No se reutiliza la pasarela de pago ya configurada en Golfmanager para el cobro desde la web de Golf Directo (ver la nota del paso B).
La sincronización es bajo demanda: los inscritos, salidas y resultados se traen cuando se importa o sincroniza el torneo.
Depende del servicio de Golf Directo: si no está disponible, no se pueden mostrar torneos ni inscribir en ese momento.
Preguntas frecuentes (FAQ)
El sistema dice «El módulo no está configurado». ¿Qué falta?
Falta la API key o el Producto en Configuración > Golf Directo > Configuración. Completa ambos campos y guarda; sin ellos no se pueden listar ni inscribir torneos.
Un jugador no puede inscribirse y le aparece que necesita licencia RFEG. ¿Cómo lo soluciono?
El cliente no tiene la licencia federativa guardada en su ficha. Añade su número de licencia RFEG en la ficha del cliente y podrá inscribirse. Recuerda que la licencia también es necesaria para ver la sección de torneos federados.
Al inscribir aparece «Licencia en uso». ¿Por qué?
Esa licencia ya está inscrita en ese torneo en Golf Directo. Comprueba si el jugador ya estaba apuntado (en «Mis inscripciones» del portal o en las Transacciones) antes de volver a intentarlo.
Aparece «El servicio de torneos no está disponible». ¿Qué hago?
Golf Directo no está respondiendo en ese momento. Inténtalo de nuevo más tarde y revisa que la API key y el Entorno sean correctos. Si persiste, contacta con el soporte de Golf Directo.
No puedo sincronizar un torneo. ¿Cuál es el motivo?
El torneo no está vinculado a Golf Directo. Impórtalo primero desde Importar de Golf Directo para vincularlo; a partir de ahí podrás sincronizarlo.
¿Qué diferencia hay entre el entorno de Pruebas y el de Producción?
El entorno de Pruebas (test.golfdirecto.com) sirve para validar la configuración y el flujo sin generar inscripciones ni cobros reales. El de Producción (golfdirecto.com) opera de verdad. Prueba primero en Pruebas y cambia a Producción antes de abrir las inscripciones al público.
¿Dónde veo el cobro de una inscripción?
En el listado de ventas (la venta del producto de inscripción) y en cobros / cobros desglosados (el cobro con la forma de pago configurada). El detalle de la inscripción está en Golf Directo > Transacciones.
Una inscripción no se ha completado. ¿Por dónde empiezo a mirar?
Abre Golf Directo > Transacciones y localiza la inscripción del cliente. Mira su estado (borrador, formulario completado, confirmada o cancelada) y el campo de error: ahí suele estar el motivo (licencia, pago no completado, servicio no disponible, etc.).
¿Puedo usar la misma pasarela de pago (Redsys, Stripe…) que ya tengo en Golfmanager?
No para los cobros que vienen desde la web de Golf Directo. En la pasarela solo se puede dar de alta la URL de comercio del consumer de reservas de Golfmanager. Por eso se crea una forma de pago dedicada (tipo Transferencia) para registrar esos cobros.
¿Puede un jugador apuntarse a la vez desde Golf Directo y desde Golfmanager?
Sí. La integración es bidireccional: las inscripciones hechas en cualquiera de las dos plataformas se reflejan en la otra. Las hechas en Golfmanager se pueden enviar a Golf Directo, y las hechas en Golf Directo entran al sincronizar el torneo.
¿Qué se trae exactamente al sincronizar un torneo?
Puedes traer los datos del torneo (nombre, fechas, modalidad), los inscritos, los horarios de salida (tee times) y los resultados. Las opciones «solo inscritos» y «salidas» son excluyentes. También puedes enviar a Golf Directo las inscripciones creadas en Golfmanager.
¿Cómo sé si un torneo está al día?
En la ficha del torneo se muestran el estado de sincronización (sincronizado, con error o sin sincronizar) y la fecha de la última sincronización. Si aparece «con error», vuelve a sincronizar y revisa el mensaje.
¿Qué pasa si cancelo una inscripción en Golfmanager?
Golfmanager cancela también la reserva correspondiente en Golf Directo, de modo que el jugador deja de figurar inscrito en ambos sistemas.
El formulario de Golf Directo no aparece dentro del portal. ¿Por qué?
Revisa la casilla Cargar iframe. Si está activada, el formulario se muestra incrustado en el portal; si está desactivada, al jugador se le redirige directamente al proceso de pago de Golfmanager.
¿Es recomendable poner emojis en el nombre del torneo?
No. Como buena práctica, evita emojis y caracteres especiales en el nombre del torneo para prevenir problemas de visualización o de sincronización entre plataformas. Usa nombres con texto sencillo.
Buenas prácticas recomendadas
Asegúrate de que los socios tienen su licencia RFEG en la ficha para que puedan inscribirse.
Configura bien el producto y el precio de la inscripción (incluidos los precios por tipo de cliente si aplican).
Prueba primero en el entorno de Pruebas antes de operar en Producción.
Sincroniza el torneo antes y después del evento para tener inscritos, salidas y resultados al día.
Usa nombres de torneo sencillos, sin emojis ni caracteres especiales.
Revisa las Transacciones ante cualquier inscripción que no se complete.
Datos de contacto
Juan Antonio Sánchez
28350, Madrid (España)
Soporte y contacto: contacto@golfdirecto.com
Dpto. Comercial: comercial@golfdirecto.com