Índice
¿Qué es la API para TTOO y otras empresas?
La API permite que un touroperador (TTOO), agencia u otra empresa se conecte a Golfmanager desde su propio software para buscar disponibilidad y hacer reservas en el club, o para gestionar parte o toda la configuración del tenant, sin entrar en la web ni en el programa de gestión.
Existen tres formas de conexión:
Clientes API Consumer: empresas que reservan en la web de reservas del club (OTAs, TTOO…). Se dan de alta en Golfmanager MT API y se vinculan a una ficha de cliente.
Usuarios API Admin multitenant: una sola clave API v3 para gestionar varios tenants.
Usuarios API Admin individual: un usuario API v3 dentro del tenant del club.
¿Qué problema resuelve?
Más canales de venta: los TTOO y OTAs venden tus salidas desde su propia plataforma.
Sin doble gestión: las reservas entran directamente en el plano de reservas, sin copiar datos a mano.
Precios controlados: cada empresa ve el precio que le corresponde según su etiqueta de cliente.
Facturación ordenada: con la ficha a crédito, las reservas quedan pendientes y se facturan a final de mes.
Integraciones de gestión: software de terceros (ERP, contabilidad, apps) trabaja con tus datos como si fuera un empleado.
Requisitos previos
Formulario de autorización cumplimentado y firmado por el club (ver abajo).
Para API Consumer: ficha de cliente de la empresa en el CRM y Tipos de Reserva online con sus Etiquetas de API.
IPs de la empresa integradora, si va a conectarse desde direcciones concretas.
Para un usuario API Admin individual: permisos para crear usuarios en Menú de Configuración > Seguridad > Usuarios.
Formulario de autorización
Para que un TTOO o empresa pueda conectarse a través de una API, el club tiene que rellenar previamente el formulario cumplimentado y firmado. Selecciona el botón Formulario:
Datos del campo de golf que se beneficiará de la integración:
Nombre del club, Número de teléfono, Email de contacto y Dirección del club que solicita la integración.
Datos de contacto de la persona que autoriza:
Tu nombre completo, Tu cargo en la empresa, Tu número de teléfono y Tu dirección de email de la persona del club que rellena y firma el documento.
Razón social y Número de identificación fiscal de la empresa del club.
Fecha en que se rellena y firma el documento.
Datos de la empresa que realizará la integración:
Razón Social, Marca Comercial, Persona de Contacto, Número de Teléfono y Email de la empresa externa a la que autorizas la conexión.
IP Addresses. Pide a la empresa externa las IPs desde las que va a trabajar. Ejemplo, Leadingcourses: 51.140.152.154, 51.140.8.92, 51.140.0.50, 51.140.2.76 y 51.140.7.106.
Tipo de API (marca con una “X”):
API CONSUMER. Solo para hacer reservas online (OTAs, TTOO…). La agencia reserva desde su propio programa como si entrara en la web del club (Leadingcourses, Golfbreaks, Your Golf Travel…).
API ADMIN PARCIAL. Gestiona parte de la configuración de tu Golfmanager como si fuera un empleado del club, desde el software del tercero. Indica en Funciones API las funcionalidades que necesita la empresa.
API ADMIN COMPLETA. Gestiona toda la configuración de tu Golfmanager como si fuera un empleado del club, desde el software del tercero.
Cómo se configura (paso a paso)
1. Clientes API Consumer
Empresas que reservan en la web de reservas del club (OTAs, TTOO, agencias).
Paso 1 — Configuración por parte del club
Ve a Menú Principal > CRM > Clientes y crea la ficha de la empresa. Antes, busca en el listado por si ya existe.
Activa A crédito en la ficha. La empresa podrá reservar sin pagar en ese momento y a final de mes le facturas las reservas pendientes.
Opcional: añade un Alias. Así identificarás en el plano de reservas qué reservas llegan por esta empresa.
Añade la Etiqueta de cliente que tengan los Tipos de Reserva que debe ver. La etiqueta define el precio:
Sin etiqueta: ve los mismos precios que un visitante de tu web. La empresa vende a ese precio y te factura su comisión.
Con etiqueta de descuento: recibe el precio de agencia y añade su margen. A final de mes tú le facturas sus reservas a ese precio.
En Menú de Configuración > Reservas > Tipos de Reserva, sección Etiquetas de API, añade a cada Tipo de Reserva online las etiquetas que correspondan: 18holes, 9holes, tee1, tee10, buggy, trolley, electric-trolley, clubs, ygt. Ejemplos: “18holes tee1 buggy”, “18holes tee10”, “9holes tee1”, “9holes tee10 buggy”.
Envía al equipo de soporte, desde el chat de ayuda, la solicitud de conexión con el formulario de autorización adjunto.
Paso 2 — Configuración por parte del equipo de Golfmanager
Tras recibir el formulario de autorización del club:
En el tenant del club: Menú Principal > Configuración > App Market, instala el plugin APIs V1. Añade a la ficha de cliente el campo Código API V1.
En superadmin: ve a Main > Golfmanager MT API (eu.golfmanager.com/main/gmApiKey).
Busca el registro de la empresa. Si no existe, crea uno nuevo (requiere autorización previa de Carlos y Dani):
Pulsa Nuevo.
Indica Nombre, Email y Tipo de autorización Cliente.
Pulsa Guardar. El Código se genera automáticamente.
En la sección Tenants del registro, añade el tenant del club.
Copia el Código del registro.
En el tenant del club: Menú Principal > CRM > Clientes, abre la ficha de la empresa y pega el código en Código API V1.
📌 Notas:
El email de la ficha de cliente del tenant debe coincidir con el email del registro en Golfmanager MT API.
Un mismo código sirve para todos los tenants añadidos al registro.
Si la empresa migra desde v1, debe cambiar la URL (endpoint) y la clave.
Paso 3 — 🏌️ Configuración específica Golfbreaks
Golfbreaks utiliza un set-up estandarizado que sustituye al antiguo envío manual de IDs de Tipos de Reserva. El club debe:
Crear Tipos de Reserva exclusivos para Golfbreaks, no compartidos con otros TTOO, con “Golfbreaks” en el nombre.
Asignar la Etiqueta de Cliente “GOLFBREAKS” solo a esos Tipos de Reserva y a la ficha de Golfbreaks del CRM.
Asignar la Etiqueta de API correspondiente.
Configurar los precios específicos en el producto del Tipo de Reserva exclusivo, vinculados a la configuración de Golfbreaks (etiqueta de cliente, cliente…).
Exportar un informe de Tipos de Reserva filtrado por la etiqueta de Golfbreaks para que validen el mapping antes del go-live.
Paso 4 — 🏌️ Configuración específica Zest
En Menú Principal > CRM > Clientes: crea la ficha de Zest y la de cada cliente colaborador que reservará a través de Zest. En la ficha de Zest activa A crédito y añade la misma Etiqueta que el Tipo de Reserva.
En Menú de Configuración > Reservas > Tipos de Reserva, sección Etiquetas de API: añade las etiquetas API.
En Menú de Configuración > Seguridad > Usuarios: crea un usuario con Nombre Zest, Email info1@zest.com, Contraseña vacía y Perfil Administrador.
📌 Nota: el usuario debe ser administrador porque Zest reserva en nombre de otros clientes.
2. Usuarios API Admin multitenant
Una sola clave API v3 para gestionar varios tenants. Lo configura el equipo de Golfmanager.
En superadmin: ve a Main > Clave API Multitenant V3 (eu.golfmanager.com/main/multiApi).
Busca la empresa o pulsa Nuevo e indica el Nombre.
Define Peticiones por minuto y Peticiones por hora (habitualmente 30 y 1.000).
Pulsa Guardar. Se genera la Clave API.
En la sección Tenants, añade cada club con su Tenant, el Usuario del tenant con el que actuará la API y, opcionalmente, el Cliente al que se asignarán las reservas.
Comparte la clave con la empresa por un canal seguro.
📌 Nota: los permisos en cada tenant son los del perfil del Usuario indicado.
3. Usuarios API Admin individual
Un usuario API v3 dentro del tenant del club. Cada tenant dispone de 3 usuarios API individuales gratuitos.
Ve a Menú de Configuración > Seguridad > Usuarios.
Crea el usuario nuevo: indica Nombre (por ejemplo, el de la empresa integradora), Email y el Perfil con los permisos que necesita la integración. Si procede, ajusta Peticiones por minuto (por defecto 30), Peticiones por hora (por defecto 1.000) y Rango de IP.
Pulsa Guardar.
Selecciona el botón Acciones > Regenerar api key. Se genera la Clave API del usuario.
Comparte la clave con la empresa por un canal seguro.
📌 Nota: el perfil define qué puede hacer la API. Para API Admin parcial, limita el perfil a las funciones acordadas en el formulario.
Detalle de cada campo
Golfmanager MT API (Clientes API Consumer)
Nombre: nombre de la empresa integradora.
Email: debe coincidir con el email de la ficha de cliente en el tenant.
Código: se genera al guardar. Es la credencial que usa la empresa.
Tipo de autorización: Cliente (reserva como cliente) o Usuario (actúa como usuario del club).
Tenants: clubes a los que puede acceder el código.
Clave API Multitenant V3 (Usuarios API Admin multitenant)
Nombre: nombre de la empresa integradora.
Clave API: credencial única para todos sus tenants.
Peticiones por minuto / por hora: límite de llamadas. Si se supera, las peticiones se rechazan hasta el siguiente periodo.
Tenants: Tenant, Usuario (con el que actúa la API en ese club) y Cliente (opcional, ficha a la que se asignan las reservas).
Usuario (Usuarios API Admin individual)
Nombre, Email y Perfil: identifican al usuario y sus permisos.
Clave API: credencial del usuario. Se genera desde Acciones > Regenerar api key, una vez guardado el usuario.
Peticiones por minuto / por hora: por defecto 30 y 1.000.
Rango de IP: si se informa, solo se aceptan peticiones desde esas IPs.
Ficha de cliente de la empresa
A crédito: permite reservar sin pago inmediato.
Alias: identifica sus reservas en el plano.
Etiquetas: determinan qué Tipos de Reserva y precios ve.
Código API V1: solo con el plugin APIs V1. Contiene el código de Golfmanager MT API.
Cómo se usa en el día a día
Revisar reservas API: las reservas de la empresa aparecen en el plano de reservas con su ficha (o Alias).
Cambiar precios o disponibilidad: modifica los Tipos de Reserva con su etiqueta; la empresa lo ve en su siguiente consulta.
Facturar a final de mes: filtra las ventas pendientes de la ficha a crédito y emite la factura.
Revocar el acceso: deshabilita el usuario API o pide a soporte que retire tu tenant del registro multitenant.
Qué ocurre al reservar a través de la API
La reserva se crea en el plano marcada como reserva de API, a nombre de la ficha de la empresa.
El precio aplicado es el del Tipo de Reserva según las etiquetas de la ficha.
Si la ficha está A crédito, la venta queda pendiente de pago para facturarla después.
Si la empresa supera el límite de peticiones, sus llamadas se rechazan hasta el siguiente minuto u hora.
Listados de empresas conectadas por API
Para conectar cualquiera de estas empresas con tu club, solicítalo a soporte con el formulario de autorización.
Clientes API Consumer
Empresas con acceso a la web de reservas de los clubes, dadas de alta en Golfmanager MT API.
Andalucia Golf Hub
ANWB Golf
Awolf
Bookingtee
Domitur
Eligo Club
Eligo Guest
Estrella del mar
Gogolf
Golf Clapp Spain
GOLF GLOBE 365 GmbH
Golf Holidays Direct
Golf Info
Golf Mexico Tee Times
GOLF NOW - golfnow
Golfamore
GOLFBREAKS
Golfspain
Greenfee 365
Greenfinder.AI
Instant Golf Holidays (Golfholidays by Morgan)
ION54
Le Club
Leadingcourses
metropolipatriotismo
MORTEN DATING SPAIN SL (Marbella golf teetimes)
Mulligan App
Mundo GolfTravel SL (GoGollf.Travel)
MYGOLF
Novacom
ONE TEE
ONTEE
PAGS
PlaySpain.Golf (AECG)
Reserveteetime
swinglab
Tee Times
Tee Times Booking
Tee Up / TeeUp.club
TeeTimesSpain
Teeup Golf Solutions
Thecocktail
Viya
Yourgolfpass
YourGolfTravel
Zest
Usuarios API Admin multitenant
Empresas con clave API v3 multitenant, dadas de alta en Clave API Multitenant V3.
Brick
Bucket Pros
Cascadia
Courserev
dePique
Details
Dialia
Doodes > TICSTRATEGY SAS
ERP OLINA NOVA
Golf Genius
Golf Pilot Rubitec
Golf.ai
Golfdirecto
GolfNext
Greenfinder
In one
M3Padel
Mulligan App
Nextcaddy
Novacom
Pacesetter
Patch Retention
PitchCRM
Players 1st
PRICR DYNAMIC AB
Priswing
Prodelfi
Qbud
Rangemanager
Sabico
Simec
Smartpanel
Svaito
Velaris Integration
Viya
WebLock
ZOHO CRM
URLs de acceso a las APIs v3
API nativa v3 (.app): https://eu.golfmanager.app/api/doc
API nativa v3 (.com): https://eu.golfmanager.com/api/doc
CCVM / Club de Campo: https://eu2.golfmanager.com/api/doc
Réplica de la API v1 en v3: https://eu.golfmanager.com/main/apimt/
Limitaciones a tener en cuenta
Sin formulario no hay conexión: soporte no activa ninguna integración sin el formulario firmado.
Usuarios API Admin individuales: 3 gratuitos por tenant.
Clave API individual: solo se puede generar después de guardar el usuario.
Límite de peticiones: por defecto 30 por minuto y 1.000 por hora.
Email coincidente (API Consumer): si el email de la ficha no coincide con el de Golfmanager MT API, la conexión no funciona.
Etiquetas de API: los Tipos de Reserva sin etiquetas no se muestran a la empresa.
Nuevos registros multitenant requieren autorización interna previa.
Preguntas frecuentes
¿Qué tipo de conexión necesito?
Si la empresa solo reserva, Cliente API Consumer. Si gestiona datos de muchos clubes, Usuario API Admin multitenant. Si es una integración propia del club, Usuario API Admin individual.
No veo la clave API del usuario individual.
Guarda primero el usuario y después pulsa Acciones > Regenerar api key.
La empresa no ve disponibilidad.
Revisa que los Tipos de Reserva tengan Etiquetas de API y que la ficha tenga la misma Etiqueta de cliente.
La empresa ve un precio incorrecto.
Comprueba la etiqueta de la ficha: sin etiqueta ve el precio web; con etiqueta, el precio de agencia.
La empresa recibe errores por exceso de peticiones.
Ha superado el límite por minuto u hora. Pide a soporte revisar los límites si está justificado.
¿Puedo tener más de 3 usuarios API individuales?
Consulta con soporte las condiciones para usuarios adicionales.
Buenas prácticas recomendadas
Un usuario API por integración, nunca compartido con empleados.
Restringe el Rango de IP cuando la empresa facilite sus IPs.
Usa Tipos de Reserva exclusivos por TTOO para controlar precios y cupos.
Añade un Alias para identificar sus reservas en el plano.
Comparte las claves por canales seguros y deshabilita los usuarios que ya no se usen.
¿Necesitas ayuda?
Si tienes dudas, nuestro equipo de soporte está disponible para ayudarte. Escríbenos en la burbuja azul de tu programa de gestión.