Índice
¿Qué es esta integración?
Ubicación: Menú Configuración > Bucket Pro
La integración con The Bucket Pros conecta Golfmanager con el sistema que controla los dispensadores de bolas.
Cuando un cliente paga un producto de bolas, Golfmanager pide a Bucket Pro un código por cada unidad vendida, lo guarda en la venta y lo imprime en un ticket de Bucket Pro independiente del recibo. El cliente usa ese código en el dispensador para retirar sus bolas.
Si Bucket Pro no responde en el momento del cobro, la venta se cobra igualmente y el código queda como Fallido, para reintentarlo después desde la ficha de la venta.
¿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 un ticket.
El cobro nunca se bloquea: un fallo de Bucket Pro no impide cobrar ni imprimir el recibo.
Códigos recuperables: si un código no se pudo generar, se reintenta desde la venta sin tocar la factura.
Todo queda registrado en la venta (código y estado).
Requisitos previos
Cuenta de Bucket Pro con acceso a su API.
Módulo The Bucket Pros instalado, junto con los módulos de TPV y facturación.
Datos de conexión que facilita Bucket Pro: URL de la API, clave de API (API Key) e identificador del sitio (Site ID).
Permiso de administración de facturación para configurar la integración.
Impresora de tickets configurada en el TPV (o impresión en pantalla con las ventanas emergentes permitidas en el navegador).
Cómo se configura (paso a paso)
Paso 1 — Datos de conexión
Ve a Menú Configuración > Bucket Pro.
Introduce la URL de la API, la clave de API y el Site ID que te facilita Bucket Pro.
Pulsa Guardar.
Paso 2 — Marcar los productos de bolas
Abre la ficha de cada producto de bolas y pulsa Editar.
Activa la casilla Producto Bucket Pro.
Indica el Número de bolas que incluye esa compra.
Pulsa Guardar.
Paso 3 — Hacer una venta de prueba
Cobra un producto de bolas en el TPV.
Comprueba que se imprime el ticket de Bucket Pro y que en la ficha de la venta el Estado Bucket Pro es Procesado.
📌 Nota: empieza con las credenciales de prueba (sandbox) de Bucket Pro y cambia a las de producción cuando todo funcione. Las credenciales de sandbox no sirven en producción.
Detalle de cada campo
URL de la API
Nombre del campo: URL de la API. Texto (obligatorio para vender bolas).
Descripción: dirección del servicio de Bucket Pro al que se piden los códigos.
Impacto en el sistema: indica a qué entorno se conecta (sandbox o producción).
Comportamiento del sistema: solo se comprueba en las ventas que llevan productos de bolas. Si falta, esas ventas se cobran pero el código queda Fallido.
Ejemplo de uso / qué ocurre: pones la URL de sandbox para probar y la de producción al empezar a operar.
Clave de API (API Key)
Nombre del campo: Clave de API. Texto cifrado (obligatorio para vender bolas).
Descripción: credencial que autoriza la conexión con Bucket Pro. Se guarda cifrada.
Impacto en el sistema: cada petición de códigos se autentica con ella.
Comportamiento del sistema: si falta o es incorrecta, la venta se cobra y el código queda Fallido.
Ejemplo de uso / qué ocurre: copias la clave que te envía Bucket Pro y guardas.
Site ID
Nombre del campo: Site ID. Texto (obligatorio para vender bolas).
Descripción: identificador de tu instalación en Bucket Pro.
Impacto en el sistema: los códigos se generan para ese sitio y solo funcionan en sus dispensadores.
Comportamiento del sistema: si falta, el código queda Fallido.
Ejemplo de uso / qué ocurre: introduces el Site ID de producción que te asigna Bucket Pro al dar de alta tu club.
Producto Bucket Pro (en el producto)
Nombre del campo: Producto Bucket Pro. Casilla.
Descripción: marca el producto como producto de bolas gestionado por Bucket Pro.
Impacto en el sistema: solo los productos marcados generan código al cobrarse.
Comportamiento del sistema: desmarcarla es la forma correcta de dejar de generar códigos para ese producto.
Ejemplo de uso / qué ocurre: la marcas en "Cubo de bolas". Al cobrarlo, se imprime su código.
Número de bolas (en el producto)
Nombre del campo: Número de bolas. Número (obligatorio si el producto es Bucket Pro).
Descripción: cuántas bolas incluye una unidad del producto.
Impacto en el sistema: es la cantidad que se envía a Bucket Pro para cada código.
Comportamiento del sistema: si la casilla está marcada y el número está vacío, no deja guardar ni vender el producto: aparece "El producto requiere un número de bolas de Bucket Pro".
Ejemplo de uso / qué ocurre: en un cubo de 50 bolas pones 50; el código da derecho a 50 bolas.
Campos informativos de la venta
Código Bucket Pro: código o códigos generados. Solo lectura. Con varias unidades se guardan separados por punto y coma.
Estado Bucket Pro: Procesado (códigos generados) o Fallido (no se pudieron generar y se pueden reintentar). Vacío en ventas sin productos de bolas.
Cómo se usa en el día a día
Vender un producto de bolas
Añade el producto de bolas en el TPV y cobra como cualquier otra venta.
Se imprime primero el ticket de Bucket Pro con los códigos (QR) y después el recibo, en la misma impresora.
Entrega el ticket al cliente: lo usa en el dispensador.
📌 Nota: si el TPV imprime en pantalla, los códigos se muestran también en pantalla. Permite las ventanas emergentes del sitio en el navegador para que no se bloqueen.
Reintentar un código fallido
Abre la ficha de la venta con Estado Bucket Pro Fallido.
Pulsa Reintentar código Bucket Pro.
Si Bucket Pro responde, el estado pasa a Procesado y se imprime el ticket con los códigos. Si vuelve a fallar, el sistema lo avisa y la venta sigue en Fallido.
Volver a imprimir los códigos
Reimprime el recibo de la venta desde el TPV.
Junto al recibo se imprime de nuevo el ticket de Bucket Pro con los códigos de esa venta.
Qué ocurre al cobrar, cancelar o si falla Bucket Pro
Al cobrar: Golfmanager pide a Bucket Pro un código por cada unidad de bolas. Los guarda en la venta, marca el estado Procesado e imprime el ticket.
Si Bucket Pro falla o no responde: la venta queda pagada y el recibo se imprime con normalidad. El estado pasa a Fallido y el motivo queda en el registro del sistema.
Si falta la configuración: solo afecta a las ventas con bolas, que se cobran con el código en Fallido. El resto de ventas no se ven afectadas.
Al cancelar la venta: los códigos se eliminan de la venta y ya no se puede reintentar.
La factura no cambia: los códigos van en un ticket aparte, así que reintentar o reimprimir no modifica el documento fiscal.
Acciones disponibles
En Configuración > Bucket Pro: editar URL de la API, clave de API y Site ID.
En la ficha del producto: activar Producto Bucket Pro e indicar el Número de bolas.
En el TPV: cobrar (imprime el ticket de Bucket Pro) y reimprimir el recibo (vuelve a imprimir los códigos).
En la ficha de la venta: consultar Código y Estado Bucket Pro, y Reintentar código Bucket Pro en ventas pagadas con estado Fallido.
Limitaciones a tener en cuenta
Los códigos se generan al cobrar: una venta borrador o pendiente no tiene código ni se puede reintentar.
Una llamada por unidad: si Bucket Pro va lento, el cobro de varias unidades puede tardar (hasta unos 50 segundos por unidad antes de darse por fallido).
El reintento solo aparece en ventas pagadas con estado Fallido y con el producto todavía marcado como Bucket Pro.
Venta cancelada: sus códigos se eliminan; el control de bolas ya retiradas corresponde a Bucket Pro.
Depende del servicio de Bucket Pro y de que el servidor tenga salida a internet hacia su API.
Preguntas frecuentes
Al guardar o vender un producto de bolas me da error.
El producto tiene marcada la casilla Producto Bucket Pro pero no tiene Número de bolas. Indícalo en la ficha del producto.
He cobrado y el Estado Bucket Pro está en Fallido.
Bucket Pro no devolvió el código (servicio caído, lento, credenciales incorrectas o configuración incompleta). Revisa los datos de conexión y pulsa Reintentar código Bucket Pro en la ficha de la venta.
El cobro tarda mucho con productos de bolas.
Bucket Pro tarda en responder. Comprueba con Bucket Pro que el Site ID y la clave son de producción y que el sitio está activo, y que el servidor tiene salida a internet hacia su API.
No sale el ticket de Bucket Pro.
Revisa el Estado Bucket Pro de la venta. Si está en Procesado, reimprime el recibo desde el TPV. Si imprimes en pantalla, permite las ventanas emergentes del navegador.
¿Los códigos aparecen en la factura?
No. Se imprimen en un ticket aparte, así la factura no se modifica aunque haya que reintentar o reimprimir.
El cliente compra varios cubos. ¿Recibe uno o varios códigos?
Uno por unidad. Con 3 cubos se generan 3 códigos, que se guardan separados por punto y coma y se imprimen todos en el ticket.
¿Cómo dejo de generar códigos temporalmente?
Desmarca la casilla Producto Bucket Pro en los productos de bolas. No hace falta vaciar la configuración.
¿Cómo configuro distintos tamaños de cubo?
Crea un producto por tamaño (por ejemplo 30, 50 o 100 bolas), marca cada uno como Bucket Pro e indica su número de bolas.
Buenas prácticas recomendadas
Prueba primero con sandbox y cambia a producción cuando todo funcione.
Indica el número de bolas en todos los productos Bucket Pro.
Revisa a diario las ventas en Fallido y reinténtalas antes de que el cliente se vaya.
Para pausar la integración, desmarca los productos en lugar de borrar la configuración.
¿Necesitas ayuda?
Si tienes dudas, nuestro equipo de soporte está disponible para ayudarte. Escríbenos en la burbuja azul de tu programa de gestión.