Índice
¿Qué es esta integración?
La integración con Prosegur Cash conecta el TPV de Golfmanager con las máquinas de efectivo de Prosegur (recicladores y dispensadores de billetes y monedas). Permite cobrar en efectivo de forma automática: la máquina recibe el dinero, calcula y entrega el cambio, y también realiza devoluciones y retiradas de efectivo.
Una máquina de efectivo (reciclador) es un dispositivo que cuenta, guarda y devuelve billetes y monedas. Esta integración hace que el TPV "hable" con la máquina para cobrar, dar cambio y registrar todo automáticamente.
¿Qué problema resuelve?
Automatiza el cobro en efectivo y el cálculo del cambio, sin manipular dinero a mano.
Reduce errores y descuadres de caja.
Mejora la seguridad: el efectivo queda en la máquina, no en un cajón.
Deja registro de cada cobro, devolución o retirada.
¿Qué permite hacer?
Función | Qué hace |
Cobro en efectivo | La máquina recibe el dinero y entrega el cambio automáticamente |
Devolución | La máquina dispensa el importe a devolver |
Retirada manual | Sacar efectivo de la máquina (por ejemplo, para caja chica) |
Registro de operaciones | Cada movimiento queda anotado con su detalle |
¿Qué sistemas conecta y en qué dirección viajan los datos?
Conecta el TPV de Golfmanager con la máquina Prosegur a través de un programa intermedio (middleware) instalado en un PC de la red local del club:
Golfmanager pide a la máquina que cobre, dé cambio, devuelva o dispense.
La máquina ejecuta la operación y devuelve el resultado (cobrado, dispensado, cambio, etc.).
Golfmanager registra la operación y marca la venta.
La comunicación es en tiempo real y dentro de la red local del club (no pasa por internet).
Requisitos previos (antes de activar la integración)
Tener una máquina de efectivo Prosegur instalada en el club.
Tener el middleware de Prosegur en marcha en un PC de la red local (misma red que el navegador del TPV).
Tener el módulo Prosegur Cash instalado, junto con los módulos de TPV y facturación.
Los datos de conexión de la máquina y del middleware (Host, ID Equipo, ID TPV, usuario y contraseña).
Permisos de administración para configurar.
Cómo se configura (paso a paso)
La máquina se configura en cada TPV que la use. Cada terminal con máquina Prosegur se configura por separado.
Accede a Configuración > TPV.
Selecciona el terminal que usa la máquina Prosegur.
Busca la sección Prosegur.
Introduce el Host (URL del middleware con su puerto, por ejemplo
https://192.168.1.100:15601).Introduce el ID Equipo (identificador de la máquina, por ejemplo
CashRecycler).Introduce el ID TPV (identificador de este terminal, por ejemplo
POS_RECEPTION).Introduce el Usuario y la Contraseña del middleware.
Pulsa "Probar conexión Prosegur" para verificar que la configuración es correcta.
Guarda los cambios.
⚠️ Usa siempre "Probar conexión Prosegur" tras configurar. La contraseña se guarda cifrada. Recuerda que cada terminal con máquina Prosegur se configura de forma individual.
Los campos de configuración en detalle
Estos son los campos de la sección Prosegur dentro de la configuración de cada TPV.
1) Host
• Nombre del campo: Host
• Descripción: Dirección (URL) del middleware de Prosegur, incluido el puerto. Es el PC de la red local que habla con la máquina.
• Impacto en el sistema: Indica a Golfmanager dónde encontrar la máquina. Si es incorrecta o el middleware no está activo, no habrá conexión.
• Ejemplo de uso: introduces https://192.168.1.100:15601.
Qué ocurre cuando se utiliza: el TPV envía las órdenes (cobrar, dispensar…) a esa dirección.
Comportamiento del sistema: una dirección errónea provoca "Conexión fallida".
2) ID Equipo (Device ID)
• Nombre del campo: ID Equipo
• Descripción: Identificador de la máquina de efectivo (suele tener 12 caracteres).
• Impacto en el sistema: Identifica a qué máquina van dirigidas las órdenes.
• Ejemplo de uso: introduces CashRecycler.
Qué ocurre cuando se utiliza: las operaciones se dirigen a esa máquina concreta.
Comportamiento del sistema: un ID incorrecto impide operar con la máquina.
3) ID TPV (POS ID)
• Nombre del campo: ID TPV
• Descripción: Identificador de este terminal ante el middleware de Prosegur.
• Impacto en el sistema: Permite a la máquina saber qué TPV solicita cada operación (útil cuando varios terminales comparten la máquina).
• Ejemplo de uso: introduces POS_RECEPTION.
Qué ocurre cuando se utiliza: las operaciones de ese TPV se identifican con ese ID.
Comportamiento del sistema: ayuda a gestionar el uso de la máquina por turnos entre terminales.
4) Usuario
• Nombre del campo: Usuario
• Descripción: Nombre de usuario para autenticarse en el middleware de Prosegur.
• Impacto en el sistema: Necesario para que el middleware acepte las peticiones.
• Ejemplo de uso: introduces admin.
Qué ocurre cuando se utiliza: junto con la contraseña, autentica al TPV ante el middleware.
Comportamiento del sistema: credenciales incorrectas impiden la conexión.
5) Contraseña
• Nombre del campo: Contraseña
• Descripción: Contraseña del usuario del middleware. Se guarda cifrada.
• Impacto en el sistema: Completa la autenticación con el middleware.
• Ejemplo de uso: la facilita el técnico que instala el middleware.
Qué ocurre cuando se utiliza: permite establecer la conexión con la máquina.
Comportamiento del sistema: si es incorrecta, la conexión falla.
ℹ️ Junto a estos campos hay un botón "Probar conexión Prosegur": no es un campo, sino una comprobación que valida los datos introducidos antes de guardar. Úsalo siempre tras cambiar la configuración.
El método de pago "Efectivo (Prosegur)"
El módulo crea automáticamente un método de pago llamado "Efectivo (Prosegur)". Este método:
Admite cobros y devoluciones contra la máquina.
Queda vinculado a la máquina configurada en ese TPV.
Es el que debes seleccionar al cobrar o devolver cuando quieras usar la máquina de efectivo.
Cómo se usa en el día a día
Cobrar en efectivo
Añade los productos al carrito como de costumbre.
Pulsa Cobrar.
Selecciona "Efectivo (Prosegur)" como método de pago.
Aparece la ventana "Esperando pago…".
El cliente introduce el efectivo en la máquina.
La máquina calcula y entrega el cambio automáticamente.
La ventana se cierra y el pago queda registrado.
Puedes cancelar en cualquier momento pulsando Cancelar; el efectivo ya introducido se le devuelve al cliente.
Devolver en efectivo
Al anular una venta (incluso si se pagó por otro medio, como tarjeta) puedes reembolsar en efectivo:
Selecciona la venta o ventas a devolver.
Pulsa Anular.
Elige la opción: Anular y reembolsar, o Reembolsar y dejar el pago pendiente.
Selecciona "Efectivo (Prosegur)" como método de reembolso.
La máquina dispensa el importe de la devolución.
Retirada manual (dispensación directa)
Para sacar efectivo sin una venta ni una devolución (por ejemplo, caja chica):
En el TPV, abre la carpeta Prosegur.
Pulsa Dispensar.
Introduce el importe.
Pulsa Dispensar de nuevo para confirmar.
La máquina entrega el importe solicitado.
Estas operaciones se marcan como "dispensación directa" en el registro de transacciones.
Ver las operaciones
En Prosegur > Transacciones (desde el TPV o desde el menú de Transacciones Prosegur) verás cada operación con su tipo (cobro, dispensación o cancelación), su estado, los importes (solicitado, depositado, dispensado y lo no dispensado) y las ventas relacionadas.
Estados de las operaciones
Estado | Color | Significado |
Pendiente | Naranja | Operación en curso |
Completada | Verde | Operación realizada con éxito |
Cancelada | Gris | Operación cancelada |
Error | Rojo | Operación fallida |
Aviso | Naranja | Éxito parcial (por ejemplo, cambio insuficiente) |
Limitaciones a tener en cuenta
Necesita el middleware de Prosegur funcionando en la red local; si no, no hay conexión con la máquina.
Cada TPV se configura por separado con su máquina.
Una máquina la usa un TPV a la vez: si otro la está usando, hay que esperar.
Si falta cambio en la máquina, el cobro puede completarse pero el cliente recibe menos cambio (aviso).
Funciona en la red local: el PC del middleware debe estar encendido y en la misma red que el TPV.
Preguntas frecuentes
¿Qué es el "middleware" de Prosegur y por qué lo necesito?
Es un pequeño programa que se instala en un PC del club y que hace de puente entre Golfmanager y la máquina de efectivo. Sin él en marcha, el TPV no puede comunicarse con la máquina.
Me sale "Conexión fallida". ¿Qué reviso?
Comprueba que el middleware esté en ejecución, que la URL del Host sea correcta y que el PC del middleware esté en la misma red que el navegador del TPV. Después usa "Probar conexión Prosegur".
Aparece el aviso "CASH_SHORTAGE". ¿Qué significa?
La máquina no tiene suficientes monedas o billetes para dar el cambio. La venta puede completarse igualmente, pero el cliente recibirá menos cambio. Conviene reponer efectivo en la máquina.
Aparece el error "CLAIMED". ¿Qué hago?
Otro TPV está usando la máquina en ese momento. Espera a que termine la otra operación o cancélala desde el otro terminal.
Aparece el error "BUSY". ¿Qué hago?
La máquina está procesando otra operación. Espera un momento e inténtalo de nuevo.
La máquina no responde.
Comprueba que el PC del middleware esté encendido y conectado. Si hace falta, reinicia el servicio del middleware y usa "Probar conexión Prosegur" para diagnosticar.
¿Puedo cancelar un cobro a medias?
Sí. Mientras está "Esperando pago…" puedes pulsar Cancelar: el efectivo que el cliente ya hubiera introducido se le devuelve.
¿Puedo devolver en efectivo una venta que se pagó con tarjeta?
Sí. Al anular, puedes elegir reembolsar con "Efectivo (Prosegur)" y la máquina dispensa el importe, aunque el pago original fuera con otro medio.
¿Qué es la "dispensación directa"?
Es una retirada de efectivo de la máquina sin una venta ni una devolución asociada (por ejemplo, para caja chica). Queda registrada con esa etiqueta.
¿Puede una misma máquina dar servicio a varios TPV?
Sí, pero uno a la vez. Cada TPV se configura por separado y, si la máquina está ocupada, los demás deben esperar (verás "CLAIMED" o "BUSY").
¿Dónde compruebo si una operación se completó?
En Prosegur > Transacciones. Cada operación muestra su estado (Pendiente, Completada, Cancelada, Error o Aviso) y los importes.
¿La contraseña del middleware se guarda de forma segura?
Sí, la contraseña se almacena cifrada en la configuración del TPV.
¿Esta integración pasa por internet?
No. La comunicación es local, dentro de la red del club, entre el TPV, el middleware y la máquina.
Buenas prácticas recomendadas
Comprueba la conexión ("Probar conexión Prosegur") tras configurar o ante cualquier problema.
Mantén el middleware y el PC encendidos y en la misma red que el TPV.
Vigila el nivel de efectivo de la máquina para que nunca falte cambio.
Revisa las transacciones ante cualquier duda de cuadre.
Configura cada TPV con su ID de equipo e ID de TPV correctos.
¿Necesitas ayuda?
Si tienes dudas sobre la configuración, la conexión con la máquina o una operación que no se completa, nuestro equipo de soporte está disponible para ayudarte. Escríbenos en la burbuja azul de tu programa de gestión. Para la instalación del middleware y el mantenimiento de la máquina (reposición de efectivo, averías…), contacta también con Prosegur, que es quien suministra y mantiene el equipo.