Índice
¿Qué es esta integración?
La integración con Simec conecta Golfmanager con las máquinas y lectores de Simec para relacionarte con tus clientes a través de tarjetas o códigos QR. Los usos más habituales son:
Lector en la máquina de bolas del campo de prácticas, para que el cliente pague con una tarjeta prepago o QR.
Lector en tornos para que los socios puedan acceder a ciertas áreas del club.
Lector en puertas para permitir el acceso a determinadas salas o instalaciones.
En todos los casos, el cliente presenta su QR/tarjeta, la máquina lo valida con Golfmanager y se descuenta de su bono para dispensar bolas o permitir el acceso.
Un bono es el saldo prepago del cliente (por ejemplo, de bolas o de accesos). La máquina Simec lee el QR del cliente, pregunta a Golfmanager si tiene saldo y, si lo hay, descuenta la cantidad correspondiente y actúa (dispensa o abre).
¿Qué problema resuelve?
Autoservicio: el cliente usa la máquina con su QR, sin pasar por recepción.
Prepago con bono: cada uso se descuenta de su saldo.
Control de acceso o dispensación automatizados.
Todo registrado: cada operación queda anotada con su resultado.
¿Cómo funciona?
El cliente presenta su QR/tarjeta en la máquina Simec.
La máquina pregunta a Golfmanager (fase de validación) si ese cliente tiene saldo suficiente en su bono.
Si hay saldo, la máquina realiza la operación y confirma a Golfmanager, que descuenta la cantidad configurada (y, si procede, genera una venta).
La máquina dispensa las bolas o permite el acceso, y la operación queda registrada con su resultado.
ℹ️ El cliente se identifica mediante un número de tarjeta de cliente (su identificador para Simec), que Golfmanager asigna automáticamente. Ese número es el que viaja en el QR/tarjeta que lee la máquina.
¿Qué sistemas conecta y en qué dirección viajan los datos?
Conecta las máquinas Simec con Golfmanager, en tiempo real:
La máquina pregunta a Golfmanager (con el QR/cliente) si puede realizar la operación.
Golfmanager valida el bono, descuenta y responde, y registra la transacción.
Por seguridad, la dirección IP desde la que llega la petición debe coincidir con la configurada para esa máquina.
Requisitos previos (antes de activar la integración)
Tener máquinas Simec instaladas (dispensadores de bolas, tornos o lectores de puerta).
Que cada máquina esté conectada a internet y sea localizable en una dirección IP.
Tener el módulo Simec instalado, junto con el módulo de bonos.
Un tipo de bono para el saldo que usan las máquinas, y bonos cargados para los clientes.
Los datos de cada máquina (API ID y dirección IP), que te facilita el proveedor de Simec.
Permisos para gestionar Simec.
Formulario de autorización
Para autorizar la integración entre tu empresa y el sistema 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
Para usar esta funcionalidad es necesario descargar el módulo desde el App Market. Si no lo tienes disponible, contacta con nuestro equipo de soporte a través de la burbuja azul de tu programa de gestión.
Una vez instalado, aparecerán en Menú Configuración > Sistema las opciones Configuración Simec y Máquinas Simec.
Cómo se configura (paso a paso)
Paso 1 — Opciones de QR (Configuración Simec)
Menú Configuración > Sistema > Configuración Simec
Accede a Menú Configuración > Sistema > Configuración Simec.
Si tu proveedor de Simec te lo indica, activa Invertir bytes QR (según el tipo de lector).
Si tus máquinas usan el formato dinámico de Simec, activa Formato dinámico QR.
Guarda los cambios.
Paso 2 — Dar de alta las máquinas (Máquinas Simec)
Menú Configuración > Sistema > Máquinas Simec
Accede a Menú Configuración > Sistema > Máquinas Simec.
Pulsa Nuevo.
En la sección General, identifica la máquina: Descripción (ej. "Máquina de bolas izquierda"), API ID (ej. 1, te lo da Simec), Dirección IP (ej.
19.19.215.115:444) y Operación (normalmente 1).En la sección Venta, configura cómo se guarda la transacción: Descripción (concepto que se verá en el bono, ej. "Cesta de 30 bolas"), Tipo de bono (de dónde se descuenta, ej. "Bono monedero"), Producto (opcional) y Cantidad a descontar (ej. 1).
Indica si la operación ¿Genera ventas? según necesites una venta o solo el descuento del bono.
Guarda los cambios.
Con esta configuración de ejemplo, cada vez que el cliente saque bolas (si tiene saldo) se le descontará 1 unidad (1 €) de su bono monedero con el concepto "Cesta de 30 bolas".
⚠️ La dirección IP de la máquina debe coincidir con la real; si no, la petición se rechaza. Confirma con el instalador/Simec la IP, el API ID y el formato de QR de cada máquina.
Los campos de configuración en detalle
A continuación se explica cada campo de una máquina Simec y de la configuración general.
1) Descripción (máquina)
• Nombre del campo: Descripción
• Descripción: Nombre identificativo de la máquina física dentro de Golfmanager.
• Impacto en el sistema: Solo sirve para reconocer la máquina en los listados; no afecta a la operación.
• Ejemplo de uso: "Máquina de bolas izquierda".
Qué ocurre cuando se utiliza: identificas la máquina con claridad al gestionarla.
Comportamiento del sistema: es un texto descriptivo, sin efecto técnico.
2) API ID
• Nombre del campo: API ID
• Descripción: Identificador único de la máquina que facilita el proveedor de Simec. La máquina lo envía en cada petición.
• Impacto en el sistema: Permite a Golfmanager saber qué máquina solicita la operación.
• Ejemplo de uso: 1.
Qué ocurre cuando se utiliza: Golfmanager localiza la máquina por su API ID y su operación.
Comportamiento del sistema: si el API ID no existe, la petición se ignora.
3) Dirección IP
• Nombre del campo: Dirección IP
• Descripción: Dirección IP (y puerto) donde está conectada la máquina.
• Impacto en el sistema: Es una medida de seguridad: Golfmanager comprueba que la petición llega desde esa IP.
• Ejemplo de uso: 19.19.215.115:444.
Qué ocurre cuando se utiliza: solo se aceptan peticiones que provengan de esa IP.
Comportamiento del sistema: si la IP no coincide, la operación se rechaza.
4) Operación
• Nombre del campo: Operación
• Descripción: Número que permite que una misma máquina ofrezca varios tipos de transacción.
• Impacto en el sistema: Distingue, por ejemplo, "30 bolas" (operación 1) de "60 bolas" (operación 2), o "acceso al spa" frente a "acceso al gym".
• Ejemplo de uso: 1 (lo normal si la máquina hace una sola cosa).
Qué ocurre cuando se utiliza: cada operación se configura por separado (con su bono/cantidad).
Comportamiento del sistema: la máquina indica qué operación solicita y Golfmanager aplica su configuración.
5) Tipo de bono
• Nombre del campo: Tipo de bono
• Descripción: El tipo de bono del que se descuenta el saldo en esa operación.
• Impacto en el sistema: Define de qué saldo del cliente se resta cada uso.
• Ejemplo de uso: "Bono monedero" o "Bono de bolas".
Qué ocurre cuando se utiliza: el descuento se aplica sobre ese tipo de bono del cliente.
Comportamiento del sistema: si el cliente no tiene saldo en ese bono, la operación se deniega.
6) Producto (opcional)
• Nombre del campo: Producto
• Descripción: Producto asociado a la operación (por ejemplo, "Cesta de bolas"). Debe poder pagarse con el tipo de bono indicado.
• Impacto en el sistema: Necesario sobre todo si la operación genera una venta.
• Ejemplo de uso: el producto "Cesta de 30 bolas".
Qué ocurre cuando se utiliza: la venta (si se genera) se registra con ese producto.
Comportamiento del sistema: si el producto no admite el bono, el cobro no se realiza bien.
7) Cantidad
• Nombre del campo: Cantidad
• Descripción: Importe o unidades que se descuentan en cada transacción.
• Impacto en el sistema: Determina cuánto se resta del bono en cada uso.
• Ejemplo de uso: 1 (1 unidad / 1 €).
Qué ocurre cuando se utiliza: cada uso descuenta esa cantidad del saldo.
Comportamiento del sistema: si el saldo es menor que la cantidad, se deniega.
8) ¿Genera ventas?
• Nombre del campo: ¿Genera ventas?
• Descripción: Indica si la operación debe registrar una venta o solo descontar saldo del bono.
• Impacto en el sistema: Si está activado, además del descuento se crea una venta (pagada con el bono); si no, solo se descuenta el saldo.
• Ejemplo de uso: lo activas si quieres que cada cesta de bolas figure como venta.
Qué ocurre cuando se utiliza: cada operación correcta deja una venta asociada.
Comportamiento del sistema: sin activar, el movimiento solo aparece como descuento en el bono.
9) Invertir bytes QR (configuración general)
• Nombre del campo: Invertir bytes QR
• Descripción: Ajusta el orden de los bytes del QR según lo requiera el lector de Simec.
• Impacto en el sistema: Hace que el QR se interprete correctamente con ciertos lectores.
• Ejemplo de uso: lo activas si Simec te indica que el lector necesita el QR invertido.
Qué ocurre cuando se utiliza: el QR se valida correctamente en esos lectores.
Comportamiento del sistema: si está mal configurado, el QR no se reconoce.
10) Formato dinámico QR
• Nombre del campo: Formato dinámico QR (SIMEC)
• Descripción: Usa el formato dinámico de Simec (un código seguido de fecha/hora) en lugar del formato estándar.
• Impacto en el sistema: Debe coincidir con el formato que generan/leen tus máquinas.
• Ejemplo de uso: lo activas si tus máquinas trabajan con el formato dinámico.
Qué ocurre cuando se utiliza: el QR se interpreta con el formato dinámico.
Comportamiento del sistema: si no coincide con tus máquinas, el QR no se valida.
ℹ️ Nota: los nombres exactos pueden variar ligeramente según tu versión e idioma. La función de cada campo es la descrita.
Máquinas y operaciones
Una misma máquina física puede ofrecer varias operaciones (por ejemplo, distintas cantidades de bolas, o distintos accesos). Para ello, se da de alta una "máquina" por cada operación, cambiando el número de operación y asociándola al bono, producto y cantidad que corresponda. Así cada operación se configura de forma independiente.
Si quieres que una misma máquina descuente de distintos tipos de bono, debes pedir a tu proveedor de Simec que habilite varias operaciones en el hardware y, en Golfmanager, dar de alta una máquina por cada tipo de bono.
Cómo se usa en el día a día
El cliente presenta su QR/tarjeta en la máquina.
La máquina valida y descuenta del bono, y dispensa bolas o da acceso.
El movimiento queda reflejado en el bono del cliente con el concepto configurado, y como venta si la operación lo genera.
El cliente obtiene su QR desde su bono / zona de cliente. Si tu club lo utiliza, existe además una variante con escáner para leer el QR en recepción.
Consultar las transacciones
En Transacciones Simec (en el menú de Facturación) verás el registro de cada operación: la máquina, si fue correcta o fallida, la petición y la respuesta, el posible error y la venta asociada (si se generó). Es la primera pantalla a revisar cuando una operación no se completa.
Lector de DNI/pasaporte (opcional)
Simec ofrece, además, un lector de DNI/pasaporte que se conecta mediante un pequeño servicio local. Sirve para autocompletar la ficha del cliente (nombre, apellidos, documento, fecha de nacimiento, dirección…) al escanear el documento, agilizando el registro en recepción. Se configura indicando la URL del proxy local y el puerto del servicio.
Limitaciones a tener en cuenta
La IP de la máquina debe coincidir con la configurada, o la operación se rechaza.
El cliente necesita saldo en su bono del tipo que usa la máquina.
Cada operación se configura como una "máquina" independiente.
El formato del QR debe coincidir con el de tus máquinas Simec.
Depende de las máquinas Simec y de su conexión a internet.
Preguntas frecuentes
¿Para qué sirve Simec?
Para conectar máquinas físicas (dispensadores de bolas, tornos, puertas) con Golfmanager, de modo que el cliente las use con su QR/tarjeta y se le descuente del bono.
¿Cómo se identifica al cliente?
Con un número de tarjeta de cliente que Golfmanager asigna automáticamente; es lo que viaja en el QR/tarjeta que lee la máquina.
La máquina no opera y da error de IP.
La IP desde la que llega la petición no coincide con la configurada para esa máquina. Comprueba la dirección IP en la configuración de la máquina y con el instalador.
El cliente no puede dispensar bolas o acceder.
Normalmente es porque no tiene saldo en el bono del tipo que usa la máquina. El cliente debe recargar su bono.
El QR no se valida.
El formato del QR no coincide con la configuración. Ajusta las opciones de QR (Invertir bytes QR o Formato dinámico QR) según tus máquinas.
El producto no se cobra bien.
El producto asociado no admite el tipo de bono de la máquina. Asocia un producto que pueda pagarse con ese bono.
¿Puede una máquina ofrecer varias cantidades u operaciones?
Sí. Se da de alta una máquina por operación (cambiando el número de operación) y se asocia al bono, producto y cantidad correspondientes.
¿La operación genera una venta o solo descuenta del bono?
Depende del campo ¿Genera ventas?: si está activado, se crea una venta (pagada con el bono); si no, solo se descuenta el saldo.
¿Dónde compruebo si una operación se realizó?
En Transacciones Simec. Cada operación muestra si fue correcta o fallida, y el detalle del error si lo hubo.
¿Sirve también para tornos y puertas?
Sí. Además de la máquina de bolas, Simec permite control de acceso en tornos y puertas: la operación devuelve un OK/KO para permitir o no el paso.
¿Necesito algo especial en la máquina?
Que esté conectada a internet y sea localizable en una IP. Los datos (API ID, IP, formato de QR) los facilita el proveedor de Simec.
¿Qué es el lector de DNI/pasaporte?
Un complemento de Simec que autocompleta la ficha del cliente al escanear su documento, para agilizar el registro en recepción.
¿A quién contacto para temas de las máquinas?
Al soporte de Simec (ver el apartado "Contacto y ayuda"). Para la configuración en Golfmanager, a nuestro soporte por la burbuja azul.
Buenas prácticas recomendadas
Confirma con el instalador/Simec la IP, el API ID y el formato de QR de cada máquina.
Crea una máquina por operación y asóciala al bono y producto correctos.
Revisa las transacciones ante cualquier incidencia.
Informa a los clientes de cómo obtener y usar su QR y de cómo recargar su bono.
Decide bien "¿Genera ventas?" según necesites o no registrar venta de cada uso.
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 de las máquinas, contacta con el soporte de Simec:
Teléfono: 686 93 41 06 (Jesús)
Email: soporte@simec.es