Ir al contenido principal

v3 - Integración Syltek

Sincroniza las reservas de pista entre Golfmanager y Syltek en los dos sentidos. Configuración paso a paso, cada campo explicado, funcionamiento diario, pantalla de sincronización, limitaciones y preguntas frecuentes.

Índice

¿Qué es esta integración?

Syltek es una plataforma externa de gestión y reserva de pistas deportivas (pádel, tenis y similares). Muchos clubes la utilizan para su agenda de pistas mientras gestionan el resto del club —clientes, caja, ventas— con Golfmanager.

El módulo Integración Syltek conecta las dos agendas: cuando se crea o se anula una reserva en uno de los sistemas, la misma reserva se crea o se anula en el otro. Así las pistas tienen una única ocupación real, se reserve desde donde se reserve.

En una frase: Golfmanager y Syltek siguen siendo dos programas distintos; esta integración solo hace que las reservas de pista estén en los dos a la vez.

¿Qué problema resuelve?

  • Evita el overbooking: una pista ocupada en Syltek deja de estar libre en Golfmanager, y al revés.

  • Elimina el doble apunte: nadie tiene que copiar reservas de una agenda a otra a mano.

  • Propaga las anulaciones: si se anula en un sistema, el hueco se libera también en el otro.

  • Deja registro: cada sincronización queda anotada con cuántas reservas se han descargado, cuántas han entrado bien y cuáles han fallado.

¿En qué dirección viajan los datos?

La integración funciona en los dos sentidos, y cada sentido se activa por separado. Puedes tener solo uno, los dos, o ninguno.

De Golfmanager a Syltek: envío inmediato

  • Al guardar una reserva de una pista vinculada, se crea al momento en Syltek.

  • Al anular o borrar la reserva, se anula también en Syltek.

  • Se activa con la casilla «Sincronización de V3 a Syltek».

De Syltek a Golfmanager: descarga cada 10 minutos

  • Un proceso automático descarga las reservas de Syltek cada 10 minutos.

  • Trae las reservas desde hoy hasta un año vista, y solo las que han cambiado desde la última vez.

  • Se activa con la casilla «Sincronización de Syltek a V3».

⚠️ Las anulaciones que salen de Golfmanager hacia Syltek se envían siempre que la reserva tenga un ID de Syltek, aunque el envío de reservas nuevas esté desactivado. Es a propósito: una reserva ya creada en Syltek no debe quedarse ocupando pista si se anula en Golfmanager.

Requisitos previos

  1. Tener el módulo Reservas en funcionamiento (la integración trabaja sobre él).

  2. Tener instalado el módulo Integración Syltek.

  3. Disponer de los datos de acceso que facilita Syltek: la dirección del sistema (host), la clave de API y el cliente con el que se crearán las reservas.

  4. Saber el identificador de cada pista en Syltek, para poder emparejarla con su recurso de Golfmanager.

  5. Permisos de administración para entrar en Configuración y editar recursos.

Cómo se configura (paso a paso)

A) Datos de conexión

  1. Entra en Configuración > Reservas > Syltek.

  2. Rellena el Host, la API Key y el Id de cliente para reservas que te ha dado Syltek.

  3. No actives todavía las dos casillas de sincronización: primero hay que emparejar las pistas.

B) Emparejar cada pista

  1. Ve a Reservas > Recursos y abre la ficha de una pista.

  2. Escribe en el campo «ID Syltek» el identificador que esa misma pista tiene en Syltek.

  3. Guarda y repite con todas las pistas compartidas entre los dos sistemas.

⚠️ El emparejamiento de las pistas es lo que decide qué se sincroniza. Una reserva de un recurso sin ID Syltek no se envía, y una reserva que llega de Syltek de una pista que Golfmanager no reconoce se descarta sin avisar. Si algo «no se sincroniza», empieza por revisar aquí.

C) (Opcional) Emparejar los tipos de reserva

  1. Ve a Reservas > Tipos de reserva y abre un tipo.

  2. Escribe su «ID Syltek» si quieres que la reserva llegue a Syltek con ese tipo concreto.

  3. Si lo dejas vacío, la reserva se crea igualmente, con el tipo por defecto de Syltek.

D) Activar la sincronización

  1. Vuelve a Configuración > Reservas > Syltek.

  2. Activa «Sincronización de V3 a Syltek» para empezar a enviar reservas.

  3. Activa «Sincronización de Syltek a V3» para empezar a descargarlas. Esta casilla enciende y apaga el proceso automático de cada 10 minutos.

  4. Espera unos minutos y comprueba el resultado en la pantalla «Syltek sync».

Explicación de cada campo

A) Configuración > Reservas > Syltek

Campo

Qué es

Qué pasa si falta o está mal

Host

Dirección del sistema de Syltek del club, con la forma https://[cliente].syltek.com

Cualquier envío o descarga se detiene con el aviso «Es obligatorio el host de Syltek en la configuración».

API Key

Clave que autoriza a Golfmanager a conectarse con Syltek. La facilita Syltek.

Aviso «Es obligatoria la clave API de Syltek en la configuración» y no se conecta.

Id de cliente para reservas

Cliente de Syltek bajo el que se crean todas las reservas que envía Golfmanager.

Aviso «Es obligatorio el cliente de Syltek en la configuración»; no se puede enviar ninguna reserva.

Id tipo de recurso

Campo previsto para filtrar por tipo de recurso de Syltek. Hoy no tiene efecto: el módulo no lo utiliza.

Nada. Puede dejarse vacío.

Sincronización de V3 a Syltek

Activa el envío de reservas nuevas de Golfmanager a Syltek.

Desactivada, no se crean reservas en Syltek (pero las anulaciones sí se siguen enviando).

Sincronización de Syltek a V3

Enciende o apaga el proceso automático que descarga reservas de Syltek cada 10 minutos.

Desactivada, Golfmanager deja de enterarse de lo que se reserva en Syltek.

B) Campos que el módulo añade en las fichas

Campo

Dónde está

Para qué sirve

ID Syltek

Ficha del recurso (pista)

Empareja la pista con la de Syltek. Es el campo clave: sin él, esa pista queda fuera de la sincronización.

ID Syltek

Ficha del tipo de reserva

Opcional. Indica con qué tipo de reserva debe crearse en Syltek.

ID Syltek

Ficha de la reserva

Informativo. Es el número que la reserva tiene en Syltek; lo rellena el sistema. Si está vacío, esa reserva nunca llegó a Syltek.

Syltek original

Ficha de la reserva

Informativo. Marca las reservas descargadas de Syltek, frente a las nacidas en Golfmanager.

Cómo funciona el día a día

Una reserva creada en Golfmanager

  • Al guardarla, si la pista tiene ID Syltek y el envío está activo, se crea en Syltek al instante y la reserva guarda el número que Syltek le asigna.

  • Se envían el nombre, la fecha y hora de inicio, la duración, la pista y, si está configurado, el tipo de reserva.

  • Si más tarde se cambia la hora, la duración o la pista, Golfmanager anula la reserva en Syltek y crea una nueva. Es normal que el número de reserva de Syltek cambie.

  • Si se cambia otra cosa (por ejemplo el nombre) después de haberse enviado, ese cambio no se reenvía a Syltek.

  • Al anularla o borrarla, se anula en Syltek. Syltek no envía correo al cliente por esa anulación.

Una reserva creada en Syltek

  • Llega a Golfmanager en la siguiente pasada del proceso automático, como máximo 10 minutos después.

  • Se crea con el nombre, la pista, el horario y el precio que trae de Syltek, y en estado Pendiente.

  • No lleva cliente asociado: solo el nombre como texto. Si quieres facturarla, hay que asignarle el cliente en Golfmanager.

  • El precio solo se copia si la reserva no tenía precio; nunca pisa un precio ya calculado en Golfmanager.

  • Si en Syltek se cambia de hora o de pista, el cambio se aplica también en Golfmanager. Si se anula en Syltek, la reserva se elimina en Golfmanager.

La descarga es incremental: cada pasada pide solo lo que ha cambiado desde la sincronización anterior, por eso es rápida y no vuelve a tocar reservas antiguas.

La pantalla «Syltek sync»

En el menú encontrarás la entrada «Syltek sync»: el historial de sincronizaciones, la más reciente arriba. Es el primer sitio donde mirar cuando algo no cuadra.

Columna

Qué indica

Creado

Cuándo se ejecutó esa sincronización.

Descargar desde

A partir de qué momento se pidieron los cambios a Syltek.

Descargado

Cuántas reservas envió Syltek en esa pasada.

Sincronizado correctamente

Cuántas de ellas se guardaron bien en Golfmanager.

Errores

Cuántas no se pudieron guardar.

Último error

Descripción del último fallo, con el número de reserva de Syltek afectado.

El botón «Reiniciar»

Fuerza una descarga completa: en vez de pedir solo los cambios recientes, vuelve a traer todas las reservas desde hoy hasta un año vista.

🚨 Antes de descargar, «Reiniciar» borra todas las reservas futuras marcadas como «Syltek original» y las vuelve a crear desde cero. Es una operación de mantenimiento: úsala solo si la agenda ha quedado descuadrada y, preferiblemente, con soporte al teléfono. También tarda varios minutos si hay muchas reservas.

Qué NO se sincroniza

  • Clientes. Las fichas de cliente no viajan entre los dos sistemas; de Syltek solo llega el nombre como texto.

  • Cobros, pagos y ventas. Lo que se cobra en Syltek se queda en Syltek, y al revés.

  • Extras, artículos y consumiciones asociados a la reserva.

  • Participantes o jugadores de la reserva.

  • Bloqueos, mantenimientos, clases y torneos que no sean una reserva de pista normal.

  • Precios ya calculados en Golfmanager: el precio de Syltek solo se usa cuando la reserva no tiene ninguno.

Limitaciones a tener en cuenta

  • Ventana de un año: solo se descargan reservas entre hoy y un año vista. Las de más allá no llegan.

  • Hasta 10 minutos de desfase: lo que se reserva en Syltek tarda en aparecer en Golfmanager hasta la siguiente pasada. En sentido contrario el envío es inmediato.

  • Sin pista emparejada no hay sincronización, y el descarte no genera aviso.

  • Las reservas descargadas nacen «Pendiente» y sin cliente: requieren repaso manual si hay que cobrarlas.

  • Los cambios de horario se resuelven anulando y recreando en Syltek, con lo que la reserva cambia de número allí.

  • Depende del servicio de Syltek: si Syltek no responde, esa sincronización falla y se reintenta en la siguiente pasada.

  • Estados desconocidos: si una reserva de Syltek llega con un estado distinto de «Reservada» o «Anulada», se cuenta como error y no se guarda.

Preguntas frecuentes

Una reserva no llega a Syltek. ¿Qué miro primero?

Abre la ficha de la reserva y mira el campo ID Syltek: si está vacío, no se envió. Las dos causas habituales son que la pista no tiene ID Syltek o que la casilla «Sincronización de V3 a Syltek» está desactivada.

En Syltek hay una reserva que no aparece en Golfmanager.

Comprueba que la pista de esa reserva está emparejada en Golfmanager: las reservas de pistas desconocidas se descartan. Revisa también que la casilla «Sincronización de Syltek a V3» está activa y que la pantalla «Syltek sync» muestra pasadas recientes.

¿Cuánto tarda en verse una reserva hecha en Syltek?

Como máximo 10 minutos, que es cada cuánto se ejecuta la descarga automática.

Me sale un aviso de error «Syltek error anulando reserva…».

Golfmanager intentó anular la reserva en Syltek y Syltek respondió con un error o no respondió. La reserva sigue ocupando pista en Syltek: anúlala allí a mano y avisa a soporte si se repite.

He cambiado el nombre de una reserva y en Syltek sigue el antiguo.

Es el comportamiento actual: una vez enviada, solo se reenvía a Syltek cuando cambia la hora, la duración o la pista. El resto de cambios no se propagan.

¿Por qué las reservas de Syltek entran como «Pendiente»?

Porque llegan sin cliente ni cobro: son ocupación de pista. Si hay que facturarlas, se completan y confirman en Golfmanager.

¿El cliente recibe correo cuando se anula desde Golfmanager?

No desde Syltek: la anulación se envía indicando expresamente que no se mande correo, para evitar que el cliente reciba dos comunicaciones distintas.

¿Puedo usar solo un sentido de la sincronización?

Sí. Las dos casillas son independientes. Ten en cuenta que las anulaciones hacia Syltek se envían igualmente cuando la reserva ya tenía número de Syltek.

¿Qué hago si las dos agendas se han descuadrado?

Revisa el historial de «Syltek sync» y su columna Último error. Si el desajuste es general, existe el botón «Reiniciar», que borra las reservas futuras venidas de Syltek y las descarga de nuevo: hazlo con soporte, porque es una operación destructiva.

El campo «Id tipo de recurso» de la configuración, ¿qué hace?

Hoy nada. Está previsto en la pantalla de configuración, pero la sincronización no lo utiliza. Puedes dejarlo vacío.

Buenas prácticas recomendadas

  • Empareja todas las pistas antes de activar las casillas de sincronización; así evitas huecos difíciles de detectar luego.

  • Decide dónde se reserva cada cosa y comunícalo al equipo: la integración sincroniza, pero no resuelve dos criterios distintos de trabajo.

  • Revisa «Syltek sync» las primeras semanas, sobre todo las columnas Errores y Último error.

  • Repasa las reservas «Pendiente» venidas de Syltek si necesitas cobrarlas o asignarles cliente.

  • Reserva el botón «Reiniciar» para incidencias reales y con soporte delante.

  • Al dar de alta una pista nueva en cualquiera de los dos sistemas, acuérdate de rellenar su ID Syltek en Golfmanager.

¿Ha quedado contestada tu pregunta?