Índice
¿Qué es esta integración?
La integración con The Bucket Pro conecta Golfmanager con el servicio de dispensado de bolas Bucket Pro.
Cuando un cliente paga un producto de bolas, el sistema genera automáticamente los códigos de Bucket Pro y los imprime como código QR en el recibo. El cliente usa ese código en el dispensador para retirar sus bolas.
The Bucket Pro es el sistema que controla las máquinas de bolas. Esta integración convierte cada compra de bolas en un código (QR) válido para el dispensador, sin fichas ni gestión manual.
¿Qué problema resuelve?
Venta y dispensado en un solo paso: al cobrar, el cliente ya recibe su código de bolas.
Sin fichas ni tokens físicos: el código va impreso en el recibo.
Automático: no hay que generar el código a mano.
Todo queda registrado en la venta.
¿Cómo funciona?
El cliente compra un producto de bolas marcado como Bucket Pro.
Al pagar la venta, Golfmanager pide a Bucket Pro un código por cada unidad vendida.
Los códigos se guardan en la venta y se imprimen como código/QR en el recibo (físico y virtual).
El cliente usa el código en el dispensador para retirar las bolas.
Si la venta se cancela, los códigos de Bucket Pro se eliminan de ella.
¿Qué sistemas conecta y en qué dirección viajan los datos?
Conecta el TPV de Golfmanager con el servicio Bucket Pro:
Al pagar, Golfmanager pide los códigos a Bucket Pro.
Bucket Pro devuelve los códigos, que Golfmanager guarda e imprime.
El dispensado de bolas lo gestiona Bucket Pro al leer el código.
Requisitos previos (antes de activar la integración)
Tener una cuenta de Bucket Pro con acceso a su API.
Tener el módulo The Bucket Pro instalado, junto con los módulos de TPV y facturación.
Tus datos de Bucket Pro: URL de la API, clave de API (API Key) e identificador de tu sitio (Site ID).
Permisos de administración (facturación) para configurar.
Cómo se configura (paso a paso)
Paso 1 — Datos de conexión
Accede a Golfmanager con un usuario con permiso de facturación.
Entra en Bucket Pro > Configuración.
Introduce la URL de la API, la clave de API (se guarda cifrada) y el Site ID que te facilita Bucket Pro.
Guarda los cambios.
Paso 2 — Productos de bolas
Entra en la ficha de cada producto de bolas.
Marca la casilla "Producto Bucket Pro".
Indica el número de bolas que incluye esa compra.
Guarda los cambios.
⚠️ Todo producto marcado como Bucket Pro debe tener su número de bolas. Si falta, al guardar el producto o al vender ese producto el sistema mostrará un error. Empieza con las credenciales de prueba (sandbox) y pasa a las reales cuando todo funcione.
Explicación de cada campo
A continuación se describe cada campo de la integración: dónde está, qué significa, su impacto en el sistema y un ejemplo de uso (qué ocurre cuando se utiliza y cómo se comporta el sistema).
A) Datos de conexión (Bucket Pro > Configuración)
1. URL de la API
Descripción: la dirección del servicio de Bucket Pro al que se piden los códigos.
Impacto en el sistema: imprescindible. Indica a qué entorno (prueba o real) se conecta.
Ejemplo de uso: introduces la URL de sandbox para probar y la real al salir a producción.
Qué ocurre cuando se utiliza: Golfmanager llama a esa URL al pagar para generar los códigos.
Comportamiento del sistema: si falta, aparece "Bucket Pro: la URL de la API no está configurada" y no se generan códigos.
2. Clave de API (API Key)
Descripción: la credencial que autoriza la conexión con Bucket Pro. Se guarda cifrada.
Impacto en el sistema: imprescindible para autenticarse.
Ejemplo de uso: copias la clave que te facilita Bucket Pro.
Qué ocurre cuando se utiliza: cada petición de códigos se autentica con ella.
Comportamiento del sistema: si falta, aparece "Bucket Pro: la clave de API no está configurada".
3. Site ID
Descripción: el identificador de tu sitio/club en Bucket Pro.
Impacto en el sistema: imprescindible. Indica a qué instalación pertenecen los códigos.
Ejemplo de uso: introduces el Site ID que te da Bucket Pro.
Qué ocurre cuando se utiliza: los códigos se generan para tu sitio.
Comportamiento del sistema: si falta, aparece "Bucket Pro: el Site ID no está configurado".
B) En el producto
4. Producto Bucket Pro (casilla)
Descripción: marca el producto como un producto de bolas gestionado por Bucket Pro.
Impacto en el sistema: solo los productos marcados generan código al pagarse.
Ejemplo de uso: la marcas en tu producto "Cubo de bolas".
Qué ocurre cuando se utiliza: al cobrar ese producto, se genera el código de bolas.
Comportamiento del sistema: un producto sin esta marca no genera ningún código.
5. Número de bolas
Descripción: cuántas bolas incluye esa compra (el tamaño del cubo).
Impacto en el sistema: es obligatorio en los productos Bucket Pro; es el número de bolas que se envía a Bucket Pro.
Ejemplo de uso: en un cubo de 50 bolas pones 50.
Qué ocurre cuando se utiliza: el código generado da derecho a esa cantidad de bolas en el dispensador.
Comportamiento del sistema: si está marcado como Bucket Pro pero sin número de bolas, aparece "El producto requiere un número de bolas de Bucket Pro" (al guardar el producto o al vender).
C) En la venta
Código Bucket Pro: el código (o códigos) generados para esa venta. Impacto: es lo que se imprime en el recibo y usa el cliente. Comportamiento: es de solo lectura; si la venta lleva varias unidades, los códigos se muestran separados por punto y coma.
Estado Bucket Pro: indica el resultado de la generación. Impacto: ayuda a saber si los códigos se han creado. Comportamiento: pasa a "Procesado" cuando los códigos se han generado; "Sin líneas de bolas" si la venta no tiene productos de bolas.
Cómo se usa en el día a día
Vende el producto de bolas en el TPV como cualquier otro.
Al cobrar, el código (QR) de Bucket Pro aparece en el recibo (impreso o en el recibo virtual/popup).
El cliente usa el código en el dispensador para sus bolas.
En la ficha de la venta puedes ver el campo "Código Bucket Pro" (los códigos generados) y el campo "Estado Bucket Pro", que pasa a "Procesado" cuando los códigos se han generado. Si una venta incluye varias unidades, los códigos se muestran separados por punto y coma.
Limitaciones a tener en cuenta
Cada producto Bucket Pro necesita su número de bolas; sin él, la venta da error.
Los códigos se generan al pagar: una venta sin pagar todavía no tiene código.
Se genera un código por cada unidad vendida; varias unidades, varios códigos (separados por punto y coma).
Si se cancela la venta, los códigos se eliminan de la venta.
Es de un solo sentido (Golfmanager pide; Bucket Pro responde) y se dispara al pagar.
Depende del servicio Bucket Pro: si su API no está disponible, no se generan los códigos en ese momento.
Preguntas frecuentes
Al vender (o guardar) un producto de bolas me da error.
Suele ser que el producto está marcado como Bucket Pro pero no tiene número de bolas; aparece "El producto requiere un número de bolas de Bucket Pro". Indica el número de bolas en la ficha del producto.
No se genera el código al pagar.
Revisa los datos de conexión: si falta alguno, aparecen avisos del tipo "Bucket Pro: la URL de la API / la clave de API / el Site ID no está configurado". Completa la URL de la API, la clave y el Site ID, y vuelve a intentarlo.
Aparece "la respuesta no contenía un código".
Bucket Pro no devolvió un código válido (servicio no disponible o respuesta inesperada). Comprueba que el servicio de Bucket Pro está operativo y que las credenciales son correctas, y reintenta el cobro.
El código no aparece en el recibo.
El código se genera al pagar. Si la venta aún no está cobrada, todavía no hay código. Cobra la venta y el código saldrá en el recibo (físico y virtual).
El dispensador no acepta el código.
Comprueba el estado de la venta y el código en su ficha (campos "Código Bucket Pro" y "Estado Bucket Pro"). Si la venta se canceló, el código se eliminó.
El cliente ha comprado varios cubos. ¿Recibe un código o varios?
Uno por cada unidad. Si compra 3 cubos, se generan 3 códigos, que se guardan juntos (separados por punto y coma) y se imprimen todos en el recibo.
¿Qué identifica al cliente en el dispensador?
El propio código impreso en el recibo. No hace falta tarjeta ni número de socio: el cliente introduce o escanea ese código en la máquina.
¿Cómo configuro distintos tamaños de cubo?
Crea un producto por cada tamaño (por ejemplo, 30, 50 o 100 bolas), marca cada uno como Bucket Pro e indica su número de bolas.
¿Dónde reviso los códigos de una venta?
En la ficha de la venta: el campo "Código Bucket Pro" muestra los códigos y "Estado Bucket Pro" indica si están "Procesado".
¿Cómo pruebo antes de operar en real?
Configura primero las credenciales de prueba (sandbox) que te facilite Bucket Pro y haz una venta de prueba; cambia a las credenciales reales cuando todo funcione.
¿Se reintegra el código si devuelvo la venta?
Al cancelar la venta, los códigos se eliminan de la venta en Golfmanager. La gestión del dispensado (si el cliente ya retiró las bolas) corresponde a Bucket Pro.
Buenas prácticas recomendadas
Configura el número de bolas en todos los productos Bucket Pro.
Prueba primero con las credenciales de sandbox antes de operar en real.
Comprueba que el código sale en el recibo (físico y virtual) tras el cobro.
Ante un problema, revisa la ficha de la venta (código y estado Bucket Pro).