Índice
Sección: Menú Configuración > Máquina de bolas
Introducción
Nebular es una aplicación para la máquina de bolas, en la que el cliente podrá recargar su saldo y pagar en la máquina, y sincronizar todos esos datos con la aplicación de Golfmanager.
IMPORTANTE. El precio que se añada al Producto de Golfmanager tiene que ser el mismo que se añada al Dashboard de la web de Nebular. Por lo que en la primera prueba del técnico de la máquina de bolas, hay que decirle que la haga al mismo precio que ese producto. Si no coincide con el precio del producto que se ha añadido a la configuración, no dejará importar los cobros al sistema de Golfmanager.
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 de Golfmanager
Sección: Menú Configuración > Configuración General > App Center
Instalar el plugin de Ballsmachine.
De forma automática, aparecerá:
Forma de pago: ballMachinePaymentMethod (el nombre puede ser modificable)
Listado de cobros: botón especial > Importar cobros de máquina de bolas
Llamar a API y sacar el transactionid para el campo Id Última transacción importada:
Como por ejemplo: "transactionid": "01A1AA0101AAAAAAA1A1AAA1AA"
Hay que usar la web: https://api.nebular.online/swagger/index.html
Busca el desplegable: Transactions
Selecciona el desplegable: GET /api/v1/transactions
Selecciona el botón: Try it out
En la sección dateFrom: añade la fecha con el siguiente formato:2021-04-19T00:00:00.00
En la sección dateTo: añade la fecha con el siguiente formato:2021-04-19T23:59:00.00
En la sección Client-Id: este dato lo tienes visible en la configuración del sistema de Golfmanager
En la sección Client-Secret: este dato te lo tiene que dar el club, ya que visualmente aparece encriptado en el sistema de Golfmanager
Selecciona el botón: Execute
Busca el cuadro: Response body
Ahí puedes buscar la última transacción del día designado en la búsqueda haciendo scroll hasta abajo dentro de ese cuadro:
"activationdate": es la fecha de la transacción
"price": fíjate bien que si es la prueba del técnico, en el precio del Producto,...
"transactionid": el dato que hay que copiar y pegar en el sistema de Golfmanager
NOTA. Si necesitas hacer otra búsqueda, tienes que seleccionar primero el botón Clear y esperar más de 1 minuto para hacer la siguiente búsqueda
Configuración del club en el sistema
Sección: Menú Configuración > Máquina de bolas > Configuración
Aquí tienes que poner la información facilitada por Nebular siendo:
Identificador de cliente. Campo obligatorio. Dato facilitado por la empresa de la máquina de bolas
Token único de cliente. Campo obligatorio. Dato facilitado por la empresa de la máquina de bolas
Producto. Tienes que seleccionar un producto configurado en el sistema de Golfmanager. Tiene que ser un producto con el cual deseas facturar en cada compra para la máquina de bolas y así se reflejará en los informes. El precio que se añada al Producto de Golfmanager tiene que ser el mismo que se añada al Dashboard de la web de Nebular. Este Producto no puede contener Tarifas Dinámicas, solo puede haber un precio fijo.
IMPORTANTE. En la primera prueba del técnico de la máquina de bolas, tienes que decirle que la haga al mismo precio que ese producto. Si no coincide con el precio del producto que se ha añadido a la configuración, no dejará importar los cobros al sistema de Golfmanager.
ID última transacción importada. Como máximo tiene que tener 32 caracteres. Este campo tiene que estar vacío para la primera vez.
Para sacar el último Id ultima transacción importada de 32 caracteres necesitamos:
Documentación Api: https://api.nebular.online/swagger/index.html
Client-Id: en configuración > "Identificador de cliente"
Client-Secret: pedir a desarrollo > encriptado en "Token único de cliente"
Llamar a API y sacar el "Id Última transacción importada" (transactionid) > pedir al equipo de Golfmanager
IMPORTANTE. El precio que se añada al Producto de Golfmanager tiene que ser el mismo que se añada al Dashboard de la web de Nebular. Por lo que en la primera prueba del técnico de la máquina de bolas, hay que decirle que la haga al mismo precio que ese producto. Si no coincide con el precio del producto que se ha añadido a la configuración, no dejará importar los cobros al sistema de Golfmanager.
Importar cobros
Sección: Menú Principal > Listados/Facturación > Cobros
Botón especial > Importar cobros de máquina de bolas. Hay que seleccionar este botón especial para importar todos los cobros que se hayan realizado en la máquina.
IMPORTANTE. El precio que se añada al Producto de Golfmanager tiene que ser el mismo que se añada al Dashboard de la web de Nebular. Por lo que en la primera prueba del técnico de la máquina de bolas, hay que decirle que la haga al mismo precio que ese producto. Si no coincide con el precio del producto que se ha añadido a la configuración, no dejará importar los cobros al sistema de Golfmanager.
Documentación Api
Documentación Api: https://api.nebular.online/swagger/index.html
Contacto de Soporte
COGES ESPAÑA MEDIOS DE PAGO, S.L.
C/ Isla de Hierro, 7, Módulo 3.2
28703 San Sebastián de Los Reyes (Madrid)
Tel: +34 948 709 709
Supervisor: Luis Amo Hurtado
TécniComercial: Javier Molina
Tel. +34 652 96 50 48
coges.es@coges.eu
www.coges.es
Your merchant (or the one of your customer) will soon migrate to Nebular 2.0 (https://www2.nebular.online/). You’ll need new credentials:
Client ID: is what we used to call merchant ID
Client Secret: is what we used to call TOKEN