Guía para la integración de Global Blue#
1. Datos del Local#
1- En el menú lateral izquierdo, pincha en las 3 rayas laterales
2- Accede a Administración.
3- Haz clic en Locales.
4- Para crear un nuevo local, pulsa el botón + Añadir (parte inferior derecha). Para editar un local existente, selecciónalo de la lista.
2. Datos del Local (campos a completar)#
En la pantalla de detalle del local, completa o revisa los siguientes campos:
Cliente: Ponemos el nombre del distribuidor. EJ. "Informática Pepe"
Nombre: Lo nombramos siempre de la siguiente forma: Nombre distribuidor – Nombre del local – Donde se encuentra el local (Retiro/Sol/Bernabeu)
URL de API: Si es un Cloud usamos la URL del ACMS. Si es solo un local tenemos que poner la URL correspondiente al local
API key: Usamos la Api Key del ACMS en caso de que sean varios locales. Si es un único local usamos la Api Key del local en cuestión.
Dirección: Introducir la dirección del local correspondiente
Ciudad: Introducir la ciudad correspondiente
Zona horaria Introducir la zona horaria correspondiente
Una vez completados los datos, pulsa Guardar. En ese momento los módulos del lado derecho estarán habilitados.
3. Integraciones fiscales#
Si prestamos atención a la derecha, vemos la casilla de "integraciones fiscales" pinchamos ahí para luego mirar abajo a la derecha y clicar en el botón "añadir" Seleccionamos el proveedor "Global Blue"
URL Api: URL Global Blue del cliente final
Usuario: Usuario registrado en FourVenues
Password: Contraseña para acceder a FourVenues
Borrar caché: En principio no se marcaría, para que vaya más fluido. Si en algún momento es necesario, se marcará a futuro
Una vez introducidos estos datos, pulsa el botón "Guardar" (parte inferior derecha) para que la configuración quede registrada.
En la parte inferior de esta misma pantalla de Configuración aparecen dos URLs que se generan automáticamente. Son necesarias para terminar la integración en Ágora, así que cópialas usando el icono de copiar situado a la izquierda de cada una:
URL para enviar facturas desde Ágora: es la dirección a la que Ágora enviará las facturas para que Global Blue las procese. Debe pegarse en la configuración de Ágora del cliente.
URL de botón de búsqueda de facturas: es la dirección que permite localizar y consultar las facturas ya emitidas desde el propio TPV. También se configura en Ágora.
Recomendación: pega ambas URLs en un documento o correo junto con los datos del cliente para tenerlas localizadas durante la instalación en Ágora.
4. Puntos de venta#
Después de guardar la configuración, accede a la pestaña "Puntos de venta" (en la parte superior, junto a "Configuración"). Aquí se indica a qué punto de venta (POS) del local corresponde cada caja o terminal de Global Blue.
Para dar de alta un punto de venta:
Pulsa el botón "+ Añadir" (parte superior derecha). Se abrirá el formulario "Punto de venta".
Punto de venta (POS): despliega la lista y selecciona el POS del local que quieres integrar. Estos POS provienen de la configuración del local en Ágora; si la lista aparece vacía, asegúrate de que el local tiene POS creados y la configuración guardada.
Shop id de Global blue: introduce el identificador de tienda (Shop ID) que proporciona Global Blue para ese establecimiento. Es un campo obligatorio.
Desk id de Global blue: introduce el identificador de caja/mostrador (Desk ID) facilitado por Global Blue para ese punto de venta. Es un campo obligatorio.
Pulsa "Guardar". El punto de venta aparecerá en la lista con su Id y su POS asociado.
Repite el proceso por cada punto de venta que el local tenga que integrar con Global Blue. Si un local tiene varias cajas, cada una necesita su propio Shop id y Desk id.
5. Configuración en Ágora y verificación#
Con la integración ya creada en Connect Manager, el último paso es enlazarla con Ágora:
La integración con Global Blue se completa en Ágora en dos lugares dentro del menú Herramientas: primero se crea una "Acción personalizada" con la URL y después se coloca como botón en el TPV.
Crear la acción con la URL. Ve a Herramientas y, en la columna "Visualización", entra en "Acciones Personalizadas". Pulsa "+ Nuevo" (o selecciona la acción existente y pulsa "Editar") y rellena:
"Texto" escribe el nombre que verá el usuario en el botón (por ejemplo "TAX FREE")
"Tipo" selecciona "Url/Aplicación"
"Acción" pega la "URL de botón de búsqueda de facturas" que copiaste de Connect Manager.
Deja marcada la casilla "Mostrar Urls en un diálogo de Ágora" para que las facturas se abran dentro de Ágora.
Opcionalmente asigna un icono en "Img. Tema Claro" e "Img. Tema Oscuro". Pulsa "Aceptar" para guardar.
Colocar el botón en el TPV. Vuelve a Herramientas y, en "Visualización", entra en "Configuración de Botones". Selecciona el perfil que usa el local (por ejemplo "Básica" o "Tablet") y pulsa "Editar". En la rejilla de "Botones de acción", arrastra o asigna la acción que acabas de crear a una celda libre para que quede visible en la pantalla de venta.
Pulsa "Aceptar" para guardar. A partir de ese momento, el botón (p. ej. "TAX FREE") aparecerá en el TPV y, al pulsarlo, abrirá la pantalla de búsqueda de facturas de Global Blue.
La "URL para enviar facturas desde Ágora": es la dirección que utiliza la integración para enviar las facturas generadas a Global Blue. El proceso a seguir es exactamente el mismo que la configuración de la URL mencionada anteriormente
Comprobación final: realiza una venta de prueba en el TPV y verifica que la factura llega correctamente a Global Blue y que el botón de búsqueda muestra la factura. Si algo no aparece, revisa que las credenciales (Usuario y Password), el Shop id y el Desk id sean correctos, y que la configuración esté guardada en Connect Manager.
Nota: si en algún momento los datos no se actualizan correctamente, marca la casilla "Borrar caché" en la pestaña Configuración, guarda, y vuelve a desmarcarla una vez resuelto.