Índice
¿Qué es esta integración?
La integración con SmartGolf conecta Golfmanager con el sistema de automatización de pistas SmartPadel.
A partir de las reservas, automatiza tanto el control de acceso (apertura de puertas, accesos y barreras) como el encendido de los equipos eléctricos de la instalación (por ejemplo, las luces y otros dispositivos). El jugador recibe un código de acceso (PIN de 4 dígitos, también en QR) por email y lo usa para entrar.
SmartGolf / SmartPadel es el sistema que controla los accesos y los dispositivos eléctricos de tus instalaciones. Con esta integración, al reservar en Golfmanager la instalación se prepara sola: el jugador abre el acceso con su PIN/QR y las luces y demás equipos se activan en su franja horaria.
¿Qué problema resuelve?
Acceso autónomo: el jugador entra con su código, sin necesidad de personal que abra.
Equipos automáticos: luces y otros dispositivos se activan solo durante la reserva, ahorrando energía.
Mejor experiencia: el código llega por email con la confirmación de la reserva.
Todo sincronizado: modificar o cancelar la reserva actualiza también el acceso y los equipos.
¿Cómo funciona?
El jugador hace una reserva en Golfmanager.
Golfmanager registra la reserva en SmartGolf y añade el código de acceso (PIN/QR) a la confirmación por email.
A la hora reservada, el jugador abre el acceso con su PIN/QR y las luces y equipos se activan automáticamente.
Si modifica o cancela la reserva, el acceso y los equipos se actualizan o se eliminan en SmartGolf.
¿Qué sistemas conecta y en qué dirección viajan los datos?
Conecta las reservas de Golfmanager con SmartGolf/SmartPadel, en ambos sentidos:
Golfmanager → SmartGolf: cada reserva (alta, modificación o cancelación) se traslada a SmartGolf, que prepara el acceso y los equipos.
SmartGolf → Golfmanager: SmartGolf envía notificaciones (por ejemplo, de accesos), que quedan registradas.
Requisitos previos (antes de activar la integración)
Tener el sistema SmartGolf/SmartPadel instalado en tus instalaciones (puertas, accesos, equipos eléctricos).
Tener el módulo SmartGolf instalado en Golfmanager, junto con los módulos de reservas y zona de cliente.
La clave de API (API Key) que facilita el equipo de SmartPadel. Las cuentas de prueba (sandbox) son gratuitas, pero las genera SmartPadel.
Los identificadores de tus recursos en SmartPadel para vincularlos.
Permisos de administración para configurar.
Formulario de autorización
Para que esta empresa externa pueda conectarse a través de una 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.
Instalación del módulo
El módulo SmartGolf se instala desde el App Market (busca "SmartGolf" e instálalo) o con ayuda de nuestro equipo de soporte. Si no lo tienes disponible, contáctanos por la burbuja azul.
Una vez instalado, aparece el menú SmartGolf con las opciones Configuración, Notificaciones y Registro (Log).
Cómo se configura (paso a paso)
Ubicación: Menú > SmartGolf > Configuración
Paso 1 — Configuración general
Accede a Menú > SmartGolf > Configuración.
Introduce la API Key (te la facilita SmartPadel).
Ajusta los tiempos (offsets) de puertas (inicio/fin) y de equipos (inicio/fin), en segundos (ver más abajo).
Deja el Modo de Producción desactivado para hacer pruebas (sandbox) y actívalo cuando todo funcione.
Guarda los cambios. Al guardar, Golfmanager se empareja con SmartPadel automáticamente (genera por sí mismo su Client Id y Client Secret).
Paso 2 — Vincular y probar los recursos
Ve a Reservas > Recursos.
Crea o edita un recurso reservable y, en el campo Identificador de SmartGolf, selecciona del desplegable el recurso equivalente de SmartPadel.
Pulsa el botón "Probar SmartGolf" para validar: activa los equipos de ese recurso durante unos 15 segundos.
Repite para cada recurso que use SmartGolf.
⚠️ Cada recurso debe estar vinculado con su equivalente en SmartPadel. Empieza en modo de pruebas (sandbox) y pasa a producción cuando todo funcione. La API Key se guarda cifrada.
Los campos de configuración en detalle
A continuación se explica cada campo de la configuración de SmartGolf.
1) API Key
• Nombre del campo: API Key
• Descripción: Clave que da acceso a los servicios de SmartPadel. La facilita el equipo de SmartPadel y se guarda cifrada.
• Impacto en el sistema: Es la credencial principal: sin ella, la integración no se conecta.
• Ejemplo de uso: la copias de tu cuenta de SmartPadel (sandbox o producción).
Qué ocurre cuando se utiliza: al guardarla, Golfmanager se empareja con SmartPadel.
Comportamiento del sistema: si es incorrecta, las operaciones fallan por autenticación.
2) Puertas — offset de inicio (en segundos)
• Nombre del campo: Puertas — offset de inicio
• Descripción: Cuánto antes de la reserva se desbloquea la puerta/acceso (en segundos).
• Impacto en el sistema: Da margen al jugador para entrar antes de la hora exacta.
• Ejemplo de uso: -300 (5 minutos antes).
Qué ocurre cuando se utiliza: el acceso se habilita ese tiempo antes del inicio de la reserva.
Comportamiento del sistema: un valor negativo significa "antes" de la hora de inicio.
3) Puertas — offset de finalización (en segundos)
• Nombre del campo: Puertas — offset de finalización
• Descripción: Cuánto después de la reserva se bloquea la puerta/acceso (en segundos).
• Impacto en el sistema: Permite salir con margen tras la reserva.
• Ejemplo de uso: 300 (5 minutos después).
Qué ocurre cuando se utiliza: el acceso sigue disponible ese tiempo tras el fin de la reserva.
Comportamiento del sistema: un valor positivo significa "después" de la hora de fin.
4) Equipos — offset de inicio (en segundos)
• Nombre del campo: Equipos (dispositivos eléctricos) — offset de inicio
• Descripción: Cuánto antes de la reserva se activan las luces y demás equipos.
• Impacto en el sistema: Asegura que la instalación esté lista al llegar el jugador.
• Ejemplo de uso: -300 (5 minutos antes).
Qué ocurre cuando se utiliza: los equipos se encienden ese tiempo antes del inicio.
Comportamiento del sistema: valor negativo = antes del inicio.
5) Equipos — offset de finalización (en segundos)
• Nombre del campo: Equipos (dispositivos eléctricos) — offset de finalización
• Descripción: Cuánto después de la reserva se desactivan las luces y equipos.
• Impacto en el sistema: Evita que se apaguen justo al terminar y ahorra energía después.
• Ejemplo de uso: 300 (5 minutos después).
Qué ocurre cuando se utiliza: los equipos se apagan ese tiempo tras el fin.
Comportamiento del sistema: valor positivo = después del fin.
6) Modo de Producción
• Nombre del campo: Modo de Producción
• Descripción: Cambia entre el entorno real (producción) y el de pruebas (sandbox).
• Impacto en el sistema: En pruebas no se actúa sobre las instalaciones reales; en producción sí.
• Ejemplo de uso: lo dejas desactivado al implantar y lo activas al pasar a real.
Qué ocurre cuando se utiliza: al activarlo, las reservas controlan de verdad puertas y equipos.
Comportamiento del sistema: desactivado = sandbox; activado = producción.
7) Identificador de SmartGolf (del recurso)
• Nombre del campo: Identificador de SmartGolf, en cada recurso reservable (Reservas > Recursos)
• Descripción: Vincula el recurso de Golfmanager con el recurso equivalente de SmartPadel (se elige de un desplegable).
• Impacto en el sistema: Indica a qué puerta/pista de SmartPadel corresponde cada recurso.
• Ejemplo de uso: seleccionas "Pista 1" de SmartPadel para tu recurso "Pista 1".
Qué ocurre cuando se utiliza: las reservas de ese recurso preparan el acceso y los equipos correctos.
Comportamiento del sistema: al rellenarlo aparece el botón "Probar SmartGolf"; sin vincular, ese recurso no se automatiza.
8) Código de acceso a la puerta (de la reserva)
• Nombre del campo: Código de acceso a la puerta (en la reserva)
• Descripción: PIN de 4 dígitos que se genera automáticamente para cada reserva y se envía al jugador por email (también como QR).
• Impacto en el sistema: Es lo que el jugador usa para abrir el acceso.
• Ejemplo de uso: el jugador recibe el código en su email de confirmación.
Qué ocurre cuando se utiliza: al introducirlo en la entrada, el sistema valida y abre.
Comportamiento del sistema: se genera solo; normalmente no hace falta editarlo.
ℹ️ Nota: Golfmanager también genera automáticamente un Client Id y un Client Secret al guardar la API Key. Son internos del emparejamiento con SmartPadel y no hay que tocarlos. Los nombres exactos pueden variar ligeramente según tu versión e idioma.
Ajuste de tiempos (accesos y equipos)
Puedes definir cuánto antes y cuánto después de la reserva se habilita el acceso y se activan los equipos, en segundos:
Ajuste | Qué controla |
Puertas — inicio / fin | Cuándo se puede abrir el acceso (antes y después de la reserva) |
Equipos — inicio / fin | Cuándo se activan/desactivan las luces y demás equipos |
Por ejemplo, un valor de -300 segundos significa 5 minutos antes de la reserva, y +300 significa 5 minutos después. Así el jugador puede entrar con un poco de margen y las luces no se apagan justo al acabar.
Cómo se usa en el día a día
El jugador reserva y recibe su código de acceso (PIN/QR) en el email de confirmación.
A su hora, accede con el PIN/QR y disfruta de la instalación con las luces y equipos ya activos.
Modificaciones y cancelaciones se reflejan automáticamente en el acceso y los equipos.
Puedes consultar las Notificaciones y el Registro (Log) de SmartGolf para revisar accesos y operaciones.
Notificaciones y registro (Log)
Notificaciones (Menú > SmartGolf > Notificaciones): los avisos que SmartPadel envía sobre accesos y eventos de cada reserva.
Registro / Log (Menú > SmartGolf > Registro): el historial de operaciones enviadas a SmartPadel (altas, modificaciones y cancelaciones), con su resultado (correcto o fallido), lo enviado, la respuesta y el posible error.
Son las pantallas a revisar cuando un acceso o una automatización no funciona como esperabas.
Limitaciones a tener en cuenta
Cada recurso debe estar vinculado con su equivalente en SmartPadel.
El acceso depende del email con el código: el jugador necesita su PIN/QR.
Depende del sistema SmartGolf/SmartPadel y de su conexión; si no está disponible, el acceso y los equipos automáticos no funcionan.
No mezcles el modo prueba con el real: en producción se actúa sobre las instalaciones reales.
Preguntas frecuentes
¿Qué es SmartGolf / SmartPadel?
Es el sistema que controla los accesos (puertas, barreras) y los equipos eléctricos (luces, etc.) de tus instalaciones. Esta integración lo conecta con tus reservas para que todo se prepare solo.
¿Cómo recibe el jugador el código de acceso?
Se genera automáticamente al confirmar la reserva y se envía en el email de confirmación como PIN de 4 dígitos (también en QR).
El acceso no se abre con el PIN.
Revisa que el recurso esté vinculado a SmartPadel (su identificador de SmartGolf) y que el código del jugador sea el de su reserva.
Las luces o los equipos no se activan a tiempo.
Ajusta los tiempos (offsets) de equipos (inicio/fin). Por ejemplo, pon el offset de inicio en -300 para que enciendan 5 minutos antes.
El botón "Probar SmartGolf" falla.
Suele ser por una API Key incorrecta o un recurso sin vincular. Revisa la API Key y el identificador de SmartGolf del recurso.
El jugador no recibe el código.
Comprueba que la reserva se confirmó y que el email del jugador es correcto (el código viaja en el email de confirmación).
¿Qué diferencia hay entre el modo pruebas (sandbox) y el real?
En sandbox no se actúa sobre las instalaciones reales: solo se valida el circuito. En producción las reservas controlan de verdad puertas y equipos.
¿Dónde veo los accesos y eventos?
En SmartGolf > Notificaciones. Y en SmartGolf > Registro (Log) verás las operaciones enviadas a SmartPadel y su resultado.
¿Qué pasa si modifico o cancelo una reserva?
El acceso y los equipos se actualizan (si modificas) o se eliminan (si cancelas) en SmartPadel automáticamente.
¿Tengo que tocar el Client Id o el Client Secret?
No. Los genera Golfmanager automáticamente al guardar la API Key, para el emparejamiento con SmartPadel.
¿Sirve solo para pádel?
El sistema procede del mundo del pádel (SmartPadel), pero la integración automatiza accesos y equipos por reserva en las instalaciones que tengas equipadas con SmartGolf.
Buenas prácticas recomendadas
Vincula todos los recursos con su equivalente en SmartPadel y pruébalos con "Probar SmartGolf".
Ajusta los tiempos (offsets) para que el jugador entre con margen y las luces cubran toda la reserva.
Prueba primero en modo sandbox antes de activar producción.
Revisa las notificaciones y el registro ante cualquier incidencia de acceso.
Contacto y ayuda
Para la configuración en Golfmanager o cualquier duda, escríbenos en la burbuja azul de tu programa de gestión.
Para el hardware, la instalación y el mantenimiento del sistema de automatización, contacta con el equipo de SmartPadel:
Miguel González: miguel@smartpadelautomation.com