Índice
¿Qué es esta integración?
La integración con Custos conecta Golfmanager con las máquinas dispensadoras de bolas Custos del campo de prácticas. Permite que el jugador compre y saque bolas desde su móvil, sin fichas ni monedas: elige el cubo que quiere, lo paga y la máquina dispensa las bolas automáticamente.
El jugador puede obtener las bolas de dos formas:
Con su bono de bolas: paga desde la app con su saldo prepago y la máquina suelta las bolas. Esta operación queda registrada en Golfmanager.
Con tarjeta en el datáfono de la máquina: acerca su tarjeta al datáfono del propio dispensador. Para esto, el club necesita una pasarela de pago Redsys dedicada exclusivamente a la máquina (no se puede usar la misma pasarela que ya tenga configurada Golfmanager).
Un bono en Golfmanager es un saldo prepago. El jugador recarga un bono de bolas y, cada vez que quiere practicar, paga con ese saldo desde el móvil y la máquina suelta las bolas. No existe un módulo aparte llamado "Custos Mobile": es esta misma integración de máquina de bolas, a la que se accede desde el móvil/app.
¿Qué problema resuelve?
Autoservicio en el campo de prácticas: el jugador saca bolas sin pasar por recepción ni usar fichas.
Sin efectivo ni fichas físicas: se paga con el bono prepago (o con tarjeta en el datáfono), más cómodo y sin manejo de monedas.
Disponible cuando el jugador quiera, también fuera del horario de recepción.
Proceso automatizado: la dispensación se realiza sola tras completar la compra.
Todo queda registrado en Golfmanager: el consumo del bono (y, si se configura, una venta formal).
¿Qué sistemas conecta y en qué dirección viajan los datos?
Conecta el portal/app de Golfmanager con el servidor de las máquinas Custos, en tiempo real:
El jugador elige una opción de bolas desde el móvil.
Golfmanager descuenta el importe de su bono de bolas.
Golfmanager envía la orden a la máquina Custos (cantidad y máquina concreta).
La máquina dispensa las bolas y el jugador ve la confirmación.
En el pago con tarjeta, el cobro lo gestiona el datáfono de la máquina con Redsys, al margen de Golfmanager.
¿Qué información se intercambia?
Información | Dirección | Para qué |
Opción de bolas elegida | Jugador → Golfmanager | Saber qué cubo quiere |
Cantidad y máquina | Golfmanager → Máquina Custos | Que la máquina dispense las bolas |
Confirmación de la operación | Máquina Custos → Golfmanager | Confirmar al jugador y dejar registro |
Requisitos previos (antes de activar la integración)
Tener máquinas de bolas Custos con su servidor accesible desde Golfmanager.
Tener el módulo "Máquina de Bolas Custos" instalado (desde el App Market), junto con el módulo de bonos.
Tener creado un tipo de bono para las bolas, que es de donde se descuenta el consumo.
Los datos de conexión del servidor Custos: dirección IP, usuario y contraseña (los facilita el proveedor).
Para el pago con tarjeta en la máquina: una pasarela Redsys dedicada (independiente de la de Golfmanager) y el formulario de autorización firmado (ver más abajo).
Permisos de administrador de sistema para la configuración.
El formulario de autorización
Para autorizar la integración entre el club, la empresa Custos y Golfmanager (y habilitar el pago con tarjeta vía Redsys), el club debe rellenar y enviar un formulario. Una vez recibido, Golfmanager lo firma y lo envía a Custos.
Campos a rellenar:
Datos del comercio
Código FUC: solicítalo a tu banco, en el sector 2422 (vending).
Nombre de comercio: el de la empresa del club que lo contrata.
Dirección de envío de los equipos: la de la empresa del club.
Persona de contacto, email y teléfono de contacto del club.
Identificador en Servidor ATENTO (nombre de operador): déjalo en blanco; lo rellena Redsys.
Nombre de la entidad bancaria del club.
Datos del servicio y equipos
Número de equipos con pago con tarjeta y telemetría: indica 1 por defecto.
Número de equipos con SOLO telemetría: indica 1 por defecto.
Información de las máquinas
Fabricante, modelo, versión de software y número de máquinas.
Cómo se configura (paso a paso)
Paso 1 — Instalar el módulo
Ve a Configuración > Sistema > App Market.
Instala el plugin Máquina de Bolas Custos.
Paso 2 — Conexión con el servidor Custos
Ve a Configuración > CRM > Configuración, apartado Máquina de bolas.
Introduce la Dirección IP del servidor (será la misma para todas las máquinas).
Introduce el Usuario (
golfmanager, en minúsculas) y la Contraseña (fija para todas las máquinas, la facilita el proveedor).Guarda los cambios.
ℹ️ Lo único que cambia entre máquinas es la IP/identificador de cada una; el usuario y la contraseña son comunes.
Paso 3 — Crear y asignar el tipo de bono
Ve a Configuración > Bonos > Tipos de bono y crea el tipo de bono de las bolas.
Vuelve al apartado Máquina de bolas (Configuración > CRM > Configuración) y selecciona ese Tipo de bono.
Guarda los cambios.
Paso 4 — Venta formal (opcional)
En el apartado Máquina de bolas, activa Generar venta formal si quieres que, además de descontar del bono, se genere una venta (pagada con el bono) para la contabilidad.
Si la activas, selecciona el Producto de venta formal.
Guarda los cambios.
Paso 5 — Crear las opciones de compra de bolas
Ve a Configuración > CRM > Máquina de Bolas.
Pulsa Nuevo y rellena: Nombre (por ejemplo, "Cubo 50 bolas"), Cantidad a descontar del bono, Descripción (opcional, útil si hay varias máquinas), Imagen, Prioridad, Cantidad a enviar a la máquina e ID de la máquina.
Guarda. Crea una opción por cada máquina disponible.
⚠️ Importante: el ID de la máquina debe coincidir con el de la máquina Custos real (lo proporciona el proveedor del lector). Si no coincide, la orden no llegará a la máquina correcta.
Paso 6 — Crear el botón de acceso en la home
Ve a Configuración > CRM > Tarjetas de la home y pulsa Nuevo.
Rellena el Texto (título), la URL con
//consumer/ballMachines, la Prioridad, la Imagen, el color de fondo, una descripción breve y el texto del botón (por ejemplo, "Sacar bolas").En Etiquetas de cliente, indica qué clientes verán la tarjeta; en Incluir subcarpetas, selecciona No (es un acceso directo).
Guarda.
Detalle de cada campo de configuración
A continuación se explica cada campo: qué es, cómo afecta al sistema, cómo se comporta y un ejemplo de uso. Se dividen en los de conexión y facturación (apartado Máquina de bolas) y los de cada opción de compra.
Conexión y facturación (Configuración > CRM > Configuración > Máquina de bolas)
Tipo de bono
Nombre del campo: Tipo de bono.
Descripción: el bono del que se descuenta el consumo de bolas.
Impacto en el sistema: es obligatorio; sin él, las compras dan error ("El bono del que descontar no está configurado").
Comportamiento del sistema: al comprar, se descuenta de este bono el importe de la opción elegida y se muestra al jugador su saldo de este bono.
Ejemplo de uso / qué ocurre: seleccionas el bono "Bolas"; el saldo de ese bono es el que ve y gasta el jugador.
Dirección IP del servidor
Nombre del campo: Dirección IP del servidor.
Descripción: la dirección del servidor de las máquinas Custos (Atento).
Impacto en el sistema: es por donde Golfmanager envía la orden de dispensar. Sin ella, no se puede contactar con las máquinas.
Comportamiento del sistema: Golfmanager se conecta a esta dirección para autenticarse y enviar la orden. Es la misma para todas las máquinas del club.
Ejemplo de uso / qué ocurre: pones la IP que te da el proveedor y guardas; a partir de ahí, las compras pueden llegar a las máquinas.
Usuario
Nombre del campo: Usuario.
Descripción: el usuario con el que Golfmanager se autentica en el servidor Custos.
Impacto en el sistema: sin un usuario válido, el servidor rechaza la conexión.
Comportamiento del sistema: se envía en cada petición al servidor Custos.
Ejemplo de uso / qué ocurre: normalmente es
golfmanager(en minúsculas), igual para todas las máquinas.
Contraseña
Nombre del campo: Contraseña.
Descripción: la contraseña del usuario del servidor Custos.
Impacto en el sistema: completa la autenticación. Si falta o es incorrecta, no se puede dispensar.
Comportamiento del sistema: acompaña al usuario en la conexión con el servidor.
Ejemplo de uso / qué ocurre: es fija para todas las máquinas; la facilita el proveedor. La introduces y guardas.
Generar venta formal
Nombre del campo: Generar venta formal. Es un interruptor (activado/desactivado).
Descripción: decide si, además de descontar del bono, se genera una venta (pagada con el bono).
Impacto en el sistema: con él activado, cada compra deja una venta formal para la contabilidad; desactivado, solo se descuenta del bono (queda el apunte del bono, sin venta).
Comportamiento del sistema: si lo activas, debes indicar también el producto de la venta.
Ejemplo de uso / qué ocurre: lo activas si tu contabilidad necesita una venta por cada operación; lo dejas desactivado si te basta con el consumo del bono.
Producto de venta formal
Nombre del campo: Producto de venta formal.
Descripción: el producto que se usa en la venta formal cuando esa opción está activada.
Impacto en el sistema: determina cómo se registra contablemente cada compra de bolas.
Comportamiento del sistema: solo se usa si "Generar venta formal" está activado.
Ejemplo de uso / qué ocurre: seleccionas un producto como "Bolas campo de prácticas"; cada venta formal saldrá con ese producto.
Cada opción de compra de bolas (Configuración > CRM > Máquina de Bolas)
Nombre
Nombre del campo: Nombre.
Descripción: cómo se muestra la opción al jugador (por ejemplo, "Cubo 50 bolas").
Impacto en el sistema: es lo que ve el jugador al elegir; no afecta a la dispensación.
Comportamiento del sistema: aparece en el listado de opciones del móvil.
Ejemplo de uso / qué ocurre: pones "Cubo grande"; el jugador lo ve así en la app.
Cantidad a descontar del bono
Nombre del campo: Cantidad a descontar del bono (tras cada compra).
Descripción: cuánto saldo del bono cuesta esa opción.
Impacto en el sistema: es lo que se resta del bono del jugador al comprar.
Comportamiento del sistema: se descuenta del bono configurado en cada operación.
Ejemplo de uso / qué ocurre: pones
1; cada compra de esa opción consume 1 unidad del bono.
Descripción
Nombre del campo: Descripción (opcional).
Descripción: un texto de apoyo que ve el jugador; útil para identificar a qué máquina corresponde si hay varias.
Impacto en el sistema: solo informativo.
Comportamiento del sistema: se muestra bajo el nombre de la opción.
Ejemplo de uso / qué ocurre: pones "Máquina campo de prácticas" para que el jugador sepa de qué máquina saldrán las bolas.
Imagen
Nombre del campo: Imagen.
Descripción: la imagen que representa la opción en la app.
Impacto en el sistema: mejora la claridad visual para el jugador; no afecta a la dispensación.
Comportamiento del sistema: se muestra en la tarjeta de la opción.
Ejemplo de uso / qué ocurre: subes una foto de un cubo de bolas para que la opción sea reconocible.
Prioridad
Nombre del campo: Prioridad.
Descripción: el orden en que se muestran las opciones.
Impacto en el sistema: ordena la lista que ve el jugador.
Comportamiento del sistema: las opciones se ordenan según este valor.
Ejemplo de uso / qué ocurre: das menor prioridad al cubo más popular para que aparezca primero.
Cantidad a enviar a la máquina
Nombre del campo: Cantidad a enviar a la máquina.
Descripción: el valor que se manda a la máquina para que dispense, expresado en dinero y sin decimales.
Impacto en el sistema: determina cuántas bolas suelta la máquina.
Comportamiento del sistema: Golfmanager envía este valor a la máquina Custos al confirmar la compra.
Ejemplo de uso / qué ocurre: si un cubo de bolas vale 1 €, aquí pones
50(sin decimales, según la equivalencia de la máquina).
ID de la máquina
Nombre del campo: ID de la máquina.
Descripción: el identificador de la máquina Custos a la que se manda la orden (lo proporciona el proveedor del lector).
Impacto en el sistema: dirige la orden a la máquina correcta. Si es incorrecto, las bolas saldrán de otra máquina o no saldrán.
Comportamiento del sistema: se envía junto con la cantidad a la máquina.
Ejemplo de uso / qué ocurre: si el club tiene varias máquinas, creas una opción por cada una, cada una con su ID; así cada opción dispensa en su máquina.
Cómo se usa en el día a día
Para el jugador, el proceso es de autoservicio:
Entra en el portal/app de Golfmanager (debe estar identificado) y abre la sección de máquina de bolas (por ejemplo, desde el botón "Sacar bolas" de la home).
Ve su saldo de bono y las opciones disponibles (los cubos).
Elige una opción y confirma (aparece un "¿Continuar?").
Golfmanager descuenta el importe del bono y ordena a la máquina dispensar.
La máquina suelta las bolas y el jugador ve el mensaje "Compra realizada correctamente".
Como alternativa, el jugador puede pagar con tarjeta en el datáfono de la propia máquina (vía Redsys); en ese caso el cobro lo gestiona la máquina.
El bono de bolas
En el pago desde la app, el jugador usa su bono de bolas (saldo prepago). Cuando se le acaba, puede recargarlo desde la propia pantalla (botón "Recargar bono", que lleva a la tienda online) o en recepción.
El consumo de cada operación se descuenta del bono según la cantidad a descontar definida en la opción elegida.
Limitaciones a tener en cuenta
El jugador debe estar identificado y tener saldo en el bono de bolas (para el pago desde la app).
El pago con tarjeta es por el datáfono de la máquina: requiere una pasarela Redsys dedicada, distinta de la de Golfmanager. Esos cobros con tarjeta aún no se registran en Golfmanager (sí los del bono).
Depende de las máquinas Custos: si el servidor no está accesible, no se pueden dispensar bolas.
Cada opción apunta a una máquina concreta mediante su ID; debe estar bien configurado.
El consumo del bono se aplica al confirmar: si justo después la máquina no respondiera, podría haberse descontado el saldo sin dispensar; ante un caso así, revisa la operación y contacta con soporte.
Es una integración de autoservicio del jugador, pensada para el móvil/portal, no para el TPV de recepción.
Preguntas frecuentes
¿Existe un módulo aparte llamado "Custos Mobile"?
No. Es la misma integración de máquina de bolas Custos, a la que el jugador accede desde el móvil/app. El módulo que se instala se llama "Máquina de Bolas Custos".
¿Cómo paga el jugador las bolas?
De dos formas: con su bono de bolas (saldo prepago, desde la app) o con tarjeta en el datáfono de la propia máquina. El pago con bono queda registrado en Golfmanager; el pago con tarjeta lo gestiona el datáfono con Redsys.
¿Por qué hace falta una pasarela Redsys aparte para el pago con tarjeta?
Porque el cobro con tarjeta en la máquina usa una pasarela Redsys dedicada exclusivamente al datáfono de la máquina. No se puede usar la misma pasarela de pago que ya tengas configurada en Golfmanager; es un alta independiente (de ahí el formulario de autorización).
¿Los cobros con tarjeta en la máquina aparecen en Golfmanager?
Por ahora no: las transacciones de pago con tarjeta en el datáfono aún no se registran en Golfmanager. Sí quedan registradas las operaciones pagadas con el bono (consumo del bono y, si lo activas, venta formal).
¿Qué necesita el jugador para sacar bolas desde la app?
Estar identificado en el portal/app y tener saldo en su bono de bolas. Sin sesión iniciada o sin saldo, no podrá completar la compra.
Sale "Necesitas iniciar sesión para comprar bolas". ¿Qué pasa?
El jugador no está identificado. Debe iniciar sesión en el portal/app para poder comprar.
Sale "El bono del que descontar no está configurado". ¿Qué reviso?
Falta asignar el tipo de bono en la configuración. Ve a Configuración > CRM > Configuración > Máquina de bolas y selecciona el tipo de bono (creado previamente en Bonos).
Sale "El servidor de la máquina no está configurado". ¿Qué reviso?
Faltan la dirección IP, el usuario o la contraseña del servidor Custos. Rellena los tres en el apartado Máquina de bolas de la configuración.
Sale "No se pudo contactar con la máquina de bolas". ¿Qué hago?
El servidor Custos no responde. Comprueba que está encendido y accesible en la red y que la dirección configurada es correcta. Si persiste, contacta con el soporte de Custos.
Sale un mensaje "ERROR …". ¿Qué significa?
Es un error que devuelve el servidor Custos al intentar dispensar (por ejemplo, un problema de la máquina o de los datos enviados). El mensaje incluye el código y el detalle; revísalo y, si no se resuelve, facilítalo al soporte de Custos.
El jugador no tiene saldo suficiente. ¿Qué hace?
Debe recargar el bono antes de sacar bolas, desde el botón "Recargar bono" (lleva a la tienda online) o en recepción.
Las bolas salen de la máquina equivocada. ¿Por qué?
Porque el ID de la máquina de esa opción es incorrecto. Revisa el identificador en la opción de compra (Configuración > CRM > Máquina de Bolas) y comprueba que coincide con el de la máquina real.
¿Qué diferencia hay entre "cantidad a descontar del bono" y "cantidad a enviar a la máquina"?
La cantidad a descontar del bono es lo que cuesta la opción en saldo del bono (por ejemplo, 1). La cantidad a enviar a la máquina es el valor que recibe el dispensador para soltar las bolas, en dinero y sin decimales (por ejemplo, 50 si el cubo equivale a 1 €). Son dos conceptos distintos: uno es el coste para el jugador, el otro la orden para la máquina.
Tengo varias máquinas de bolas. ¿Cómo lo configuro?
Debes crear una opción de compra por cada máquina, cada una con su ID de máquina. Así cada opción dispensa en su máquina concreta. Puedes usar la descripción de cada opción para indicar a qué máquina corresponde.
¿Qué es "Generar venta formal" y cuándo lo activo?
Si lo activas, cada compra de bolas genera, además del consumo del bono, una venta formal (pagada con el bono) con el producto que elijas. Actívalo si tu contabilidad necesita una venta por operación; déjalo desactivado si te basta con el apunte del bono.
¿Dónde queda registrado el consumo de bolas?
En el consumo del bono del jugador (siempre) y, si has activado "Generar venta formal", también como una venta pagada con el bono. Los pagos con tarjeta en el datáfono, de momento, no se registran en Golfmanager.
Se descontó el bono pero no salieron las bolas. ¿Qué pasa?
El consumo se aplica al confirmar la compra; si justo después la máquina no respondiera, podría quedar el saldo descontado sin dispensar. Revisa la operación del jugador y, si hace falta corregir el saldo, contacta con soporte. Comprueba también que la máquina está operativa.
¿Cómo recarga el jugador su bono?
Desde la propia pantalla de la máquina de bolas, con el botón "Recargar bono" (que lleva a la tienda online), o en recepción.
¿Cómo pongo el acceso a la compra de bolas en la app?
Crea una tarjeta de la home (Configuración > CRM > Tarjetas de la home) con la URL //consumer/ballMachines y, por ejemplo, el texto del botón "Sacar bolas". Esa tarjeta es el acceso directo del jugador.
¿Qué usuario y contraseña pongo en la conexión?
El usuario suele ser golfmanager (en minúsculas) y la contraseña es fija para todas las máquinas; ambas las facilita el proveedor. Lo único que cambia entre máquinas es su identificador/IP.
¿Necesito rellenar algún formulario antes de empezar?
Sí. Para autorizar la integración entre el club, Custos y Golfmanager (y habilitar el pago con tarjeta vía Redsys), debes rellenar y enviar el formulario de autorización. Golfmanager lo firma y lo remite a Custos. Tienes los documentos en la sección "El formulario de autorización".
¿Qué es el "Código FUC" del formulario y de dónde lo saco?
Es un código que debes solicitar a tu banco, en el sector 2422 (vending). Forma parte de los datos del comercio del formulario de autorización.
¿Qué permisos necesito para configurar la integración?
Permisos de administrador de sistema para la configuración (instalar el módulo, configurar el servidor, las opciones y la tarjeta de la home).
¿Funciona fuera del horario de recepción?
Sí. Es un autoservicio: mientras el jugador tenga saldo (o pague con tarjeta en la máquina) y las máquinas estén operativas, puede sacar bolas a cualquier hora.
¿A quién contacto si la incidencia es de la máquina o del hardware?
Al soporte de Custos (ver la sección "Soporte y contacto"). Para dudas sobre la configuración en Golfmanager, contacta con el soporte de Golfmanager.
Soporte y contacto
Para cualquier consulta o incidencia con la máquina o el servicio, contacta con Custos:
Soporte técnico: Jesús Sánchez · Tel. 607 043 836.
Soporte comercial: Paula Antón · Tel. 654 036 409 · paula.anton@custosmobile.com
Para dudas sobre la configuración en Golfmanager, contacta con el soporte de Golfmanager.
Buenas prácticas recomendadas
Comprueba la conexión con las máquinas con una operación de prueba al implantar.
Revisa los identificadores de máquina de cada opción para que las bolas salgan donde toca.
Pon nombres e imágenes claros en las opciones de bolas para que el jugador elija fácil.
Facilita la recarga del bono (online y en recepción) para que el jugador nunca se quede sin saldo.
Decide si quieres generar venta formal según las necesidades de tu contabilidad.
Si vas a ofrecer pago con tarjeta, tramita a tiempo la pasarela Redsys dedicada y el formulario de autorización.