Í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.
Hay dos formas de trabajar con la integración:
Opción A – Reserva y pago en Golf Directo (recomendada): el jugador se inscribe y paga en la plataforma de Golf Directo, y Golf Directo envía automáticamente a Golfmanager la venta y el cobro de la inscripción. Toda la configuración se hace en Golf Directo y no se instala el plugin de Golf Directo en Golfmanager.
Opción B – Reserva y pago en Golfmanager (no recomendada): el jugador se inscribe desde el portal del cliente de Golfmanager y la inscripción se envía a Golf Directo. Requiere instalar el plugin de Golf Directo en Golfmanager.
✅ Recomendación de Golfmanager: elige siempre la opción A. Golf Directo es la plataforma donde se gestionan los torneos federados, así que lo más sencillo y fiable es que las inscripciones y los pagos se hagan allí. La opción B se documenta porque existe, pero actualmente ningún club la está utilizando.
¿Qué problema resuelve?
Evita la doble gestión: las inscripciones cobradas en Golf Directo llegan a Golfmanager como ventas y cobros, sin tener que teclearlas a mano.
Centraliza la contabilidad: cada inscripción queda registrada en Golfmanager con su producto, su forma de pago y su caja, y aparece en los listados de ventas y cobros como cualquier otra venta.
Inscripción online: el jugador se apunta y paga sin pasar por recepción.
¿Qué sistemas conecta y en qué dirección viajan los datos?
Conecta Golfmanager con Golf Directo a través de la API. La dirección depende de la opción elegida:
Opción A (Golf Directo → Golfmanager): Golf Directo se conecta a la API de Golfmanager y crea la venta y el cobro de cada inscripción pagada en su plataforma.
Opción B (en ambos sentidos): Golfmanager muestra los torneos de Golf Directo en el portal y envía a Golf Directo las inscripciones (y cancelaciones) hechas en el portal. Además, permite importar y sincronizar en Golfmanager los inscritos, salidas y resultados de cada torneo.
¿Qué información se intercambia?
Información | Dirección | Opción | Para qué |
Venta y cobro de la inscripción (producto, importe, forma de pago, caja) | Golf Directo → Golfmanager | A | Registrar en Golfmanager lo cobrado en Golf Directo |
Torneos disponibles (nombre, fechas, modalidad, descripción, ventanas de inscripción) | Golf Directo → Golfmanager | B | Mostrarlos en el portal y poder importarlos |
Inscripción del jugador (cliente, email, licencia RFEG) | Golfmanager → Golf Directo | B | Apuntar (o cancelar) al jugador en el torneo |
Inscritos, salidas (tee times) y resultados (bruto, neto, stableford, posición) | Golf Directo → Golfmanager | B | Sincronizar el torneo en Golfmanager |
Confirmación del pago de la inscripción | Golfmanager ↔ Golf Directo | B | 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)
Para cualquiera de las dos opciones:
Tener cuenta en Golf Directo. Para la opción A, recomendamos contratar con Golf Directo su plan completo, que incluye la conexión con Golfmanager.
Haber enviado el formulario de autorización firmado por ambas partes.
Permisos de administración en Golfmanager para crear usuarios y formas de pago.
Solo para la opción B (no recomendada), además:
Tener instalado el plugin de Golf Directo en Golfmanager (lo instala el equipo de Golfmanager), junto con los módulos de torneos, licencias federativas, facturación y portal del cliente.
La API key de Golf Directo (la proporciona Golf Directo, una por club).
El código del club en la RFEG y su contraseña RFEG.
Que los clientes tengan su licencia RFEG en la ficha para poder inscribirse desde el portal.
Cómo se configura (paso a paso)
Antes de empezar, decide dónde se van a hacer las inscripciones y los pagos, porque de eso depende toda la configuración:
Opción A (recomendada) | Opción B (no recomendada) | |
Dónde se inscribe el jugador | En la web de Golf Directo | En el portal del cliente de Golfmanager |
Dónde paga | En Golf Directo | En Golfmanager |
Dónde se configura | En Golf Directo (en Golfmanager solo se crean un usuario y una forma de pago) | En Golfmanager |
Plugin de Golf Directo en Golfmanager | No se instala | Se instala |
Uso actual | Es la que usan los clubes | Ningún club la utiliza actualmente |
Opción A (recomendada): reserva y pago en Golf Directo
Con esta opción, las inscripciones y los pagos se hacen en la plataforma de Golf Directo, y por eso la configuración se realiza en Golf Directo. Golf Directo se conecta a Golfmanager con una API key de administración que activa el equipo de Golfmanager (la misma clave sirve para todos los clubes) y, cada vez que un jugador paga una inscripción, crea en Golfmanager la venta y el cobro correspondientes.
⚠️ En esta opción no se instala el plugin de Golf Directo en el tenant, porque las reservas no se realizan desde Golfmanager. Tampoco hay que rellenar nada en Configuración > Golf Directo (ese menú solo existe con el plugin instalado).
Paso 1. Crear el usuario de Golf Directo en Golfmanager
Accede a Configuración > Sistema > Usuarios y crea un usuario nuevo:
Nombre: Golfdirecto
Email: info@golfdirecto.com
Tipo: Administrador
TPV: selecciona un TPV del desplegable. Es obligatorio si tienes activada la opción TPV obligatorio para cobros y facturas (Configuración > TPV > Configuración).
Guarda los cambios. Las ventas y cobros que lleguen desde Golf Directo quedarán registrados con este usuario, así podrás identificarlos fácilmente.
Paso 2. Crear la forma de pago de Golf Directo en Golfmanager
Accede a Configuración > Facturación > Formas de pago y crea una forma de pago exclusiva para Golf Directo:
Nombre: «Golfdirecto» o «Torneos Golfdirecto».
Tipo: Transferencia.
Disponible online: Desactivado.
Devolución en TPV: Activado.
Permitir cambiar: Activado.
Válido en API: Activado (imprescindible para que Golf Directo pueda usarla).
Guarda los cambios.
Paso 3. Configurar la conexión en Golf Directo
Entra en Golf Directo > Ajustes > Opciones > pestaña Golfmanager.
Rellena:
Método de pago asociado: la forma de pago que creaste en el paso 2.
Caja asociada: una caja existente en Golfmanager o una nueva específica para Golf Directo.
Producto asociado: el producto de Golfmanager que se usará por defecto para las inscripciones si al configurar un torneo no se indica otro.
Guarda los cambios.
Paso 4. Crear los torneos y abrir las inscripciones en Golf Directo
Los torneos, sus precios y sus plazos de inscripción se gestionan en Golf Directo. Si un torneo necesita un producto distinto del producto por defecto, indícalo al configurar ese torneo en Golf Directo.
Paso 5. Comprobar que funciona
Tras la primera inscripción pagada en Golf Directo, revisa en Golfmanager el listado de ventas y el de cobros: debe aparecer la venta con el producto asociado y el cobro con la forma de pago «Golfdirecto».
Nota sobre la pasarela de pago. No es posible reutilizar la pasarela de pago (Redsys, Stripe…) que tengas configurada en Golfmanager para los cobros de Golf Directo, porque en la pasarela solo se puede dar de alta la URL de comercio del consumer de reservas de Golfmanager. Por eso el cobro de Golf Directo se registra en Golfmanager con la forma de pago dedicada del paso 2.
Opción B (no recomendada): reserva y pago en Golfmanager
⚠️ No recomendamos esta opción: actualmente ningún club la está utilizando. La explicamos porque existe, pero te aconsejamos configurar la opción A. Si aun así quieres usarla, consúltalo antes con el equipo de Golfmanager.
En esta opción el jugador se inscribe y paga desde el portal del cliente de Golfmanager, y Golfmanager envía la inscripción a Golf Directo. Pasos:
Solicita al equipo de Golfmanager la instalación del plugin de Golf Directo en tu tenant.
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.
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.
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 guarda la Contraseña Golf Directo (campo automático de solo lectura).
Si quieres, añade el acceso a los torneos en la web de Reservas (ver Enlace de acceso a las inscripciones).
⚠️ 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».
Explicación de cada campo de configuración (solo opción B)
Estos campos solo existen si el plugin de Golf Directo está instalado, en Configuración > Golf Directo > Configuración. En la opción A no se utilizan.
1. API key
Descripción: clave que identifica a tu club frente a la API de Golf Directo. La proporciona Golf Directo y se guarda cifrada.
Impacto: es la credencial principal; sin ella ninguna operación con Golf Directo funciona.
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».
2. Entorno
Descripción: servidor de Golf Directo contra el que trabaja la integración: Producción (golfdirecto.com) o Pruebas (test.golfdirecto.com).
Impacto: determina si las inscripciones son reales o de prueba.
Ejemplo de uso: durante la puesta en marcha eliges «Pruebas»; cuando todo funciona, cambias a «Producción».
3. Producto
Descripción: producto de Golfmanager con el que se cobra y factura la inscripción. Obligatorio.
Impacto: define el importe, los impuestos y la contabilización de la inscripción (admite precios por tipo de cliente).
Qué ocurre cuando se utiliza: al inscribirse un jugador, se genera una venta de ese producto.
Comportamiento del sistema: si no hay producto configurado, el sistema avisa de que «Golf Directo no está configurado».
4. Forma de pago
Descripción: forma de pago de Golfmanager con la que se registra el cobro de la inscripción.
Qué ocurre cuando se utiliza: al confirmarse el pago, el cobro se asienta con esta forma de pago y aparece en cobros y cobros desglosados.
5. Cargar iframe
Descripción: decide si el formulario de inscripción de Golf Directo se muestra incrustado en el portal (iframe) o si se lleva al cliente directamente al proceso de pago de Golfmanager.
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 (estado «Iframe completado» en la transacción).
Comportamiento del sistema: si está desactivado, el jugador es redirigido al checkout de Golfmanager.
6. Mostrar torneos en la home del portal
Descripción: muestra un carrusel de torneos en la página de inicio del portal del cliente.
Comportamiento del sistema: si está desactivado, los torneos siguen accesibles desde el enlace «Torneos», pero no aparecen en la portada.
7. Código del club en la RFEG
Descripción: código federativo del club. Obligatorio.
Qué ocurre cuando se utiliza: al guardarlo junto con la contraseña RFEG, Golfmanager solicita el alta del club en Golf Directo.
Comportamiento del sistema: si el alta tiene éxito, Golf Directo devuelve la «Contraseña Golf Directo»; si falla, se muestra un error al registrar el club.
8. Contraseña RFEG
Descripción: contraseña federativa del club. Obligatoria y se guarda cifrada.
Qué ocurre cuando se utiliza: al guardarla, se dispara el alta del club en Golf Directo.
9. Contraseña Golf Directo (automática)
Descripción: contraseña que genera y devuelve Golf Directo al dar de alta el club. Es de solo lectura.
Comportamiento del sistema: si está vacía, el alta del club no se ha completado; revisa el código y la contraseña RFEG y vuelve a guardar.
Enlace de acceso a las inscripciones en la web de Reservas (solo opción B)
Con el plugin instalado se crea automáticamente un acceso en el menú principal de la web de Reservas que lleva a los torneos publicados en Golf Directo. Además, puedes añadir una tarjeta destacada 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.
Guarda los cambios.
Rutas útiles del portal: //consumer/golfdirecto/tournaments (listado de torneos) y //consumer/golfdirecto/mytournaments («Mis inscripciones»).
En la opción A, si quieres dar acceso a los torneos desde tu web de Reservas, puedes crear una tarjeta de la home que apunte directamente a la página de tu club en Golf Directo.
Cómo se usa en el día a día
Opción A: inscripción y pago en Golf Directo
El jugador entra en la web de Golf Directo, elige el torneo y se inscribe.
Paga la inscripción en Golf Directo.
Golf Directo crea automáticamente en Golfmanager la venta (con el producto asociado al torneo o el producto por defecto) y el cobro (con la forma de pago y la caja configuradas).
Recepción y administración solo tienen que consultar las ventas y cobros en Golfmanager; la gestión del torneo (listados, salidas, resultados) se hace en Golf Directo.
Opción B: inscripción desde el portal de Golfmanager
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 la pedirá.
Se le cobra la inscripción con el producto y el precio configurados. Si el torneo tiene el pago en Golf Directo, el pago se completa allí.
Al confirmarse el pago, la inscripción se confirma en Golf Directo. Si se cancela, Golfmanager también la cancela en Golf Directo.
Opción B: importar y sincronizar torneos
Desde el listado de torneos, pulsa Importar de Golf Directo y selecciona el torneo. Se crea en Golfmanager vinculado a Golf Directo.
Desde la ficha del torneo, pulsa Sincronizar con Golf Directo y elige qué traer o enviar:
Datos del torneo (nombre, fechas, modalidad de puntuación).
Solo inscritos o Salidas (tee times), que crean inscritos y reservas. Son excluyentes entre sí.
Resultados (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 registros se han procesado.
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.
Consultar las transacciones, ventas y cobros
Listado de ventas (ambas opciones): cada inscripción genera una venta del producto de inscripción. En la opción A, puedes filtrar por el usuario «Golfdirecto».
Cobros / cobros desglosados (ambas opciones): el cobro aparece con la forma de pago configurada. En la opción A, filtra por la forma de pago «Golfdirecto» para ver todo lo cobrado en Golf Directo.
Golf Directo > Transacciones (solo opción B): registro de las inscripciones gestionadas desde Golfmanager. Muestra el cliente, el Golf Directo ID, el Torneo ID, el precio, el estado (Borrador, Iframe completado, Confirmada o Anulada), si el pago se hizo en Golf Directo, la venta asociada y, si lo hubo, el error.
Limitaciones a tener en cuenta
Está orientada a torneos federados gestionados con Golf Directo (ámbito RFEG / España).
No se reutiliza la pasarela de pago de Golfmanager para los cobros hechos en Golf Directo (ver la nota de la opción A).
En la opción A, la gestión deportiva del torneo (inscritos, salidas, resultados) se consulta en Golf Directo; a Golfmanager llegan las ventas y los cobros.
En la opción B, el jugador necesita licencia RFEG en su ficha, y la sincronización de inscritos, salidas y resultados es bajo demanda.
Depende del servicio de Golf Directo: si no está disponible, no se pueden registrar inscripciones en ese momento.
Preguntas frecuentes (FAQ)
¿Qué opción debo elegir?
La opción A: inscripción y pago en Golf Directo. Es la que usan los clubes, se configura en Golf Directo y no necesita el plugin en Golfmanager. La opción B existe pero no la recomendamos.
¿Hay que instalar el plugin de Golf Directo en Golfmanager?
No, si trabajas con la opción A (recomendada). Las reservas no se hacen desde Golfmanager, así que solo necesitas crear el usuario «Golfdirecto» y la forma de pago dedicada. El plugin solo es necesario para la opción B.
Las inscripciones pagadas en Golf Directo no llegan a Golfmanager. ¿Qué reviso?
Comprueba que existe el usuario «Golfdirecto» de tipo Administrador (con TPV si es obligatorio en tu club), que la forma de pago tiene activado Válido en API y que en Golf Directo > Ajustes > Opciones > Golfmanager están seleccionados el método de pago, la caja y el producto. Si todo está bien, contacta con soporte.
El sistema dice «El módulo no está configurado». ¿Qué falta? (opción B)
Falta la API key o el Producto en Configuración > Golf Directo > Configuración. Completa ambos campos y guarda.
Un jugador no puede inscribirse porque necesita licencia RFEG. ¿Cómo lo soluciono? (opción B)
Añade su número de licencia RFEG en la ficha del cliente y podrá inscribirse desde el portal.
Al inscribir aparece «Licencia en uso». ¿Por qué? (opción B)
Esa licencia ya está inscrita en ese torneo en Golf Directo. Comprueba en «Mis inscripciones» o en las Transacciones si el jugador ya estaba apuntado.
Aparece «El servicio de torneos no está disponible». ¿Qué hago? (opción B)
Golf Directo no está respondiendo. Inténtalo 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? (opción B)
El torneo no está vinculado a Golf Directo. Impórtalo primero desde Importar de Golf Directo.
¿Dónde veo el cobro de una inscripción?
En el listado de ventas y en cobros / cobros desglosados, filtrando por la forma de pago de Golf Directo. En la opción B, el detalle está además en Golf Directo > Transacciones.
Una inscripción de la opción B no se ha completado. ¿Por dónde empiezo?
Abre Golf Directo > Transacciones, localiza la inscripción y revisa su estado (Borrador, Iframe completado, Confirmada o Anulada) y el campo Error.
¿Puedo usar la misma pasarela de pago (Redsys, Stripe…) que ya tengo en Golfmanager?
No para los cobros hechos en 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).
El formulario de Golf Directo no aparece dentro del portal. ¿Por qué? (opción B)
Revisa la casilla Cargar iframe. Si está desactivada, el jugador es redirigido directamente al proceso de pago de Golfmanager.
¿Es recomendable poner emojis en el nombre del torneo?
No. Evita emojis y caracteres especiales en el nombre del torneo para prevenir problemas de visualización o de envío de datos entre plataformas.
Buenas prácticas recomendadas
Trabaja con la opción A (inscripción y pago en Golf Directo).
Usa una forma de pago y, si puedes, una caja exclusivas para Golf Directo, para identificar y cuadrar fácilmente esos cobros.
Configura bien el producto por defecto en Golf Directo y, si hace falta, el producto específico de cada torneo.
Revisa las ventas y cobros tras las primeras inscripciones para validar la configuración.
Usa nombres de torneo sencillos, sin emojis ni caracteres especiales.
Datos de contacto
Juan Antonio Sánchez
28350, Madrid (España)
Soporte y contacto: contacto@golfdirecto.com
Dpto. Comercial: comercial@golfdirecto.com