Índice
¿Qué es esta integración?
Tagmarshal es un sistema externo de control del ritmo de juego y seguimiento GPS de los grupos en el campo. Usa tecnología GPS y análisis en tiempo real para mejorar la eficiencia operativa, la experiencia del jugador y los ingresos del campo.
Golfmanager no tiene un módulo específico de Tagmarshal, pero ofrece una API pública con la que Tagmarshal puede leer las salidas y reservas (el tee sheet) de tu club para saber quién juega y a qué hora.
Es decir, la integración se construye conectando Tagmarshal a la API de Golfmanager, con la ayuda del equipo de Golfmanager (que habilita el acceso) y de Tagmarshal.
Una API es una "puerta de entrada" controlada para que dos programas se comuniquen. La API de Golfmanager permite a Tagmarshal consultar las reservas del campo sin acceder directamente a la base de datos.
¿Qué problema resuelve?
Tagmarshal sabe quién juega y cuándo sin teclearlo a mano: toma las salidas de Golfmanager.
Mejor control del ritmo de juego: relaciona el seguimiento en el campo con las reservas reales.
Evita la doble gestión de la lista de salidas.
Datos siempre al día a través de la API.
¿Qué sistemas conecta y en qué dirección viajan los datos?
Conecta Golfmanager con Tagmarshal. El sentido habitual es de Golfmanager a Tagmarshal:
Tagmarshal consulta a la API las salidas y reservas del campo y las incorpora.
No es una sincronización automática "de fábrica": es una conexión que se configura una vez y luego funciona sola.
El seguimiento en el campo (posiciones, ritmo) se gestiona en Tagmarshal.
¿Qué información se comparte?
Dato | Para qué lo usa Tagmarshal |
Reservas / salidas (tee sheet) | Saber qué grupos salen y a qué hora |
Jugadores / clientes | Identificar los grupos en el seguimiento |
Tú decides, con Tagmarshal, qué datos se consultan y con qué frecuencia.
Requisitos previos (antes de empezar)
Tener Tagmarshal contratado y operativo en el campo.
Acceso a la API de Golfmanager habilitado para Tagmarshal (lo activa el equipo de Golfmanager; ver más abajo).
El equipo de Tagmarshal o tu IT para configurar la lectura de las salidas.
Permisos de administración para crear el usuario y el cliente de Tagmarshal en tu club.
Formulario de autorización
Para autorizar la integración entre tu empresa y Tagmarshal a través de la API, normalmente hay que enviar a Golfmanager un documento cumplimentado y firmado por ambas partes antes de empezar. Tu equipo de implantación te indicará el formulario concreto y cómo entregarlo.
Cómo se configura (paso a paso)
La puesta en marcha tiene una parte que hace el club y otra que hace el equipo de Golfmanager.
Parte del club
Paso 1 — Crear el usuario de Tagmarshal:
Accede a Menú Configuración > Sistema > Usuarios.
Crea un nuevo usuario.
Usa como email
info@tagmarshal.com.Guarda los cambios.
Paso 2 — Crear el cliente de Tagmarshal:
Accede a Menú Principal > Clientes.
Crea un nuevo cliente.
Usa como email
info1@tagmarshall.com.Guarda los cambios.
Parte del equipo de Golfmanager
Este paso lo realiza nuestro equipo (no el club). Se hace desde Superadmin > Multitenants Api:
En la API "Tagmarshal Usuario" > pestaña Tenants, se crea una entrada nueva, se busca el tenant del club y se guarda; se copia el código de API y se pega en el usuario creado en el Paso 1.
En la API "Tagmarshal Cliente" > pestaña Tenants, se repite: se añade el tenant, se copia el código y se pega en el cliente creado en el Paso 2.
Paso final — Facilitar los datos a Tagmarshal: una vez habilitado el acceso, se entrega a Tagmarshal lo necesario para que consulte las salidas (clave de API e identificador del club). Después conviene probar con un día de salidas y validar que las recibe.
🛠️ Nota técnica (para IT): la API de Golfmanager (versión 3) expone los datos mediante direcciones del tipo "api / model / nombre-del-modelo" (por ejemplo, las reservas). La autenticación usa dos cabeceras: la clave de API (cabecera key) y el identificador del club (cabecera tenant). Permite filtrar por fechas, seleccionar campos y paginar. Hay documentación y un entorno de pruebas ("playground") en las rutas de documentación de la API.
Los elementos de la conexión en detalle
Esta integración no tiene una pantalla de "campos de configuración" propia; se basa en crear unos elementos y en el acceso por API. A continuación se explican.
1) Usuario de Tagmarshal
• Nombre del campo: Usuario (Configuración > Sistema > Usuarios), con email info@tagmarshal.com
• Descripción: El usuario de Golfmanager bajo el que Tagmarshal accede a la API. Sus permisos definen qué puede leer.
• Impacto en el sistema: La clave de API hereda los permisos de este usuario; solo se accede a lo que él puede ver.
• Ejemplo de uso: lo creas con el email de Tagmarshal indicado.
Qué ocurre cuando se utiliza: el equipo de Golfmanager le asocia el código de API de "Tagmarshal Usuario".
Comportamiento del sistema: sin este usuario, no hay credencial con la que Tagmarshal consulte la API.
2) Cliente de Tagmarshal
• Nombre del campo: Cliente (Menú Principal > Clientes), con email info1@tagmarshall.com
• Descripción: El cliente que se asocia a la API de "Tagmarshal Cliente".
• Impacto en el sistema: Complementa el acceso de la integración por el lado de cliente.
• Ejemplo de uso: lo creas con el email indicado para Tagmarshal.
Qué ocurre cuando se utiliza: el equipo de Golfmanager le pega el código de API correspondiente.
Comportamiento del sistema: permite que la conexión funcione completa (usuario + cliente).
3) Código / Clave de API
• Nombre del campo: Código de API (Superadmin > Multitenants Api)
• Descripción: El código que autentica las peticiones de Tagmarshal. Lo genera y asocia el equipo de Golfmanager al usuario y al cliente.
• Impacto en el sistema: Es la "llave" de acceso: identifica a Tagmarshal ante la API.
• Ejemplo de uso: el equipo de Golfmanager copia el código del tenant y lo pega en el usuario/cliente.
Qué ocurre cuando se utiliza: Tagmarshal lo envía en cada consulta y la API le responde con las salidas.
Comportamiento del sistema: si el código es incorrecto, la API rechaza la petición.
4) Identificador del club (tenant)
• Nombre del campo: Tenant (identificador del club)
• Descripción: El nombre/identificador de tu club en Golfmanager, que viaja junto a la clave de API.
• Impacto en el sistema: Indica a qué club pertenecen las salidas que se consultan.
• Ejemplo de uso: se facilita a Tagmarshal junto con la clave de API.
Qué ocurre cuando se utiliza: las consultas se dirigen a los datos de tu club.
Comportamiento del sistema: un tenant incorrecto hace que no se encuentren las salidas.
ℹ️ Nota: técnicamente, la clave de API (cabecera key) y el identificador del club (cabecera tenant) son las dos cabeceras que Tagmarshal envía en cada petición. Los nombres exactos de menús pueden variar ligeramente según tu versión.
Cómo funciona la conexión
Tagmarshal consulta las salidas de Golfmanager (por ejemplo, las del día) a través de la API.
Con esa información, asocia cada grupo en el campo a su reserva y controla su ritmo de juego.
Seguridad: cada consulta va firmada con la clave de API y respeta los permisos del usuario asociado.
Límites de uso: la API puede tener un máximo de peticiones por minuto/hora para proteger el servicio.
Limitaciones a tener en cuenta
No es un conector "listo para usar": requiere configurar la lectura en el lado de Tagmarshal y el alta del acceso por el equipo de Golfmanager.
El seguimiento y el ritmo de juego viven en Tagmarshal; Golfmanager aporta las salidas.
Respeta permisos y límites de uso: la clave de API solo accede a lo que su usuario puede ver.
La frecuencia de actualización la define la configuración de Tagmarshal.
Preguntas frecuentes
¿Hay un módulo de Tagmarshal en Golfmanager?
No. La integración se hace a través de la API pública de Golfmanager: Tagmarshal consulta tus salidas mediante esa API. No hay un módulo ni una pantalla de configuración propia de Tagmarshal en Golfmanager.
¿Qué tengo que hacer yo (el club) para activarla?
Crear el usuario (email info@tagmarshal.com) y el cliente (email info1@tagmarshall.com) en Golfmanager, y firmar el formulario de autorización. El equipo de Golfmanager habilita el acceso por API y genera los códigos.
¿Quién genera la clave de API?
La genera el equipo de Golfmanager desde Superadmin y la asocia al usuario y al cliente que has creado. Después se facilita a Tagmarshal.
Tagmarshal no recibe las salidas.
Suele ser por una clave de API o un identificador de club incorrectos. Revisa con soporte la clave y el nombre del club facilitados a Tagmarshal.
Faltan datos de algunas reservas.
El usuario de la API no tiene permiso sobre esos datos. Revisa los permisos del usuario asociado a la clave.
Aparece un aviso de exceso de peticiones.
Las consultas son demasiado frecuentes y se alcanza el límite de uso de la API. Reduce la frecuencia de consulta en Tagmarshal.
Los grupos no cuadran con las salidas.
Suele ser un desfase entre la consulta y cambios de última hora en el tee sheet. Ajusta la frecuencia de actualización con Tagmarshal.
¿Qué datos ve Tagmarshal?
Las salidas/reservas (quién juega y a qué hora) y los jugadores/clientes necesarios para identificar los grupos, siempre dentro de lo que permitan los permisos del usuario.
¿La integración manda datos de vuelta a Golfmanager?
El uso habitual es de lectura: Tagmarshal consulta las salidas. El seguimiento y el ritmo de juego se gestionan en Tagmarshal.
¿Cada cuánto se actualizan las salidas en Tagmarshal?
Lo define la configuración de Tagmarshal (con qué frecuencia consulta la API), respetando los límites de uso.
Buenas prácticas recomendadas
Usa un usuario dedicado para Tagmarshal, con los permisos justos para leer las salidas.
Prueba con un día de salidas antes de operar en real.
Acuerda la frecuencia de actualización con Tagmarshal para no superar los límites de la API.
Documenta la conexión (qué se consulta y cada cuánto) para su mantenimiento.
¿Necesitas ayuda?
Para crear el usuario y el cliente, firmar la autorización o habilitar el acceso por API, escríbenos en la burbuja azul de tu programa de gestión: el equipo de Golfmanager realiza la parte de Superadmin. Para la configuración del seguimiento y la lectura de las salidas en su sistema, contacta también con el equipo de Tagmarshal.