Índice
Requerimientos del club
El club solicita integración con las APIs de GetSelect de las siguientes funcionalidades:
- Con cada reserva realizada, se debe solicitar al servidor de getSelect la creación de un
código de un sólo uso para extraer las bolas.
- La validez/usabilidad de dicho código expirará pasados 15 minutos a contar desde la
fecha/hora que conste en la reserva.
- Dicho código debe enviarse en forma de QR junto con el email de confirmación de la
reserva.
- El panel de reservas debe reflejar sí el cliente ha utilizado el código no lo ha utilizado.
Para el caso de que lo utilice la reserva ha de marcarse como "check in". Para el caso de
que transcurran los 15 minutos y no se use el código, la reserva ha de marcarse como
"no presentado".
- Poder agregar el/los códigos QR al ticket de venta cuando se vendan tickets para bolas
desde el POS. Esto implica una solicitud de código único a los servidores, idéntica a la
de reservas.
Formulario de autorización
Para poder autorizar la integración entre la empresa y el sistema a través de una API, previamente tendrás que enviar el documento cumplimentado y firmado por ambas partes a Golfmanager. Para más información, dirígete al siguiente link.
Configuración / instalación del módulo
Lo primero que debemos hacer es instalar el módulo desde el appMarket como se hace
normalmente. El módulo se llama "getSelect".
Una vez instalado, se nos agregará un submenú llamado "getSelect" dentro del menú de
configuración de GM con las opciones siguientes:
- Nombre de usuario (userName)*
- Clave de de acceso (passKey)*
- Identificador de tenant: (tenantId)*
- Identificador de aplicación: (appId)*
- Email de miembro (email)**
- Producto de bolas (ballsProduct)
- Cantidad de bolas (ballsQuantity)
- Habilitar la sincronización con el servidor (getSelectCronJobEnabled)
* Las debe proporcionar getSelect
** Este email debe ser dado de alta por el cliente/club según las instrucciones de
getSelect.
El resto de opciones son autodescripctivas; la opción producto de bolas sirve para
escoger el producto que está asociado a la venta de bolas para que desde el TPV se
pueda imprimir el correspondiente QR de bolas en el ticket.
Por defecto, cuando se instala el módulo, la opción de "habilitar la sincronización con el
servidor está desactivada" para evitar su ejecución antes de que se haya configurado
Máquina de bolas de getSelect
correctamente el módulo.
Funcionamiento
Este módulo no incluye UI propiamente dicha; cuando generemos una reserva, gm
intentará una petición al servidor (configurado anteriormente) para obtener un código único de
bolas para esa reserva. Dicho código se enviará como QR adjunto al email de confirmación de
reserva que el club tenga configurado. Esto último es independiente de la plantilla de mail que se
use, ya que el código va en los adjuntos.
Dicho código es el que el cliente final debe pasar por el escáner de la máquina de bolas.
Desde el TPV, cuando finalicemos una venta que contenga alguna línea con el producto
escogido en la configuración, el sistema intentará pedir los correspondientes códigos, pero esta vez,
en lugar de por email, los imprimirá en en el ticket de venta para que puedan ser pasados por
delante de la máquina.
Consideraciones
El club ha decidido que el código debe expirar pasados 15 minutos a contar desde la
fecha/hora que conste en el campo "start" (inicio) de la reserva.