La sincronización entre Ágora y Global Blue permite a los establecimientos agilizar y automatizar la gestión del Tax Free.
Manual de usuario para la integración de Ágora y Global Blue
Connect Manager es una potente herramienta que conecta Ágora con tu ecosistema de herramientas en un solo lugar.
En esta ocasión, te mostraremos cómo conectamos Ágora con Global Blue en la operativa de un negocio.
La integración entre Global Blue y Ágora ofrece varias ventajas para optimizar la gestión de las operaciones:
✅ Automatización del proceso para reducir errores manuales y acelerar el procedimiento de solicitud del Tax Free.
✅ Prevención de duplicados asegurando el cumplimiento de la normativa.
✅ Experiencia mejorada para el cliente
Puedes ver toda la información sobre esta integración en connectmanager.es/integracion-global-blue-con-agora/
En la siguiente guía detallaremos el desarrollo, la implementación y el uso de la integración entre Ágora y Global Blue.
Esta integración, desarrollada por ConnectManager, permite a los establecimientos optimizar la gestión del Tax Free de manera automatizada y eficiente, mejorando la experiencia del cliente y reduciendo la carga administrativa.
Requisitos
- Versión de Ágora > 7.8.9
- Licencia de Ágora Bundle
- Acceso a la api local del servidor standalone
- Api-token de ágora
Si no es posible abrir puertos para acceder a la API local, ponemos a su disposición nuestro servicio zeroConnect, que permite acceder a la API mediante un túnel seguro a nuestra infraestructura. Este servicio tiene un coste adicional de 10€/mes + impuestos.
Credenciales de Acceso
Para acceder a la configuración de Global Blue en Ágora, sigue los siguientes pasos:
- Solicita usuario y contraseña a soporte@connectmanager.es proporcionando nombre y correo electrónico.
- Ingresa a https://app.connectmanager.es.
- Dentro del formulario de edición del local:
- Haz clic en los tres puntos en la esquina superior derecha.
- Selecciona “Integraciones fiscales”.
- Para añadir una nueva integración, haz clic en el botón “+ Añadir”.
- Para modificar una integración existente, selecciona la fila correspondiente.
- En el campo “Proveedor*”, selecciona “Global Blue”.
- En “Integraciones fiscales” encontrarás las integraciones existentes.
- Si es una integración nueva: haz clic en el botón “+ Añadir” en la esquina inferior derecha.
- Si es una integración existente: haz clic en la fila de la integración que quieres modificar.
Configuración: Cómo se configura en Ágora
Pasos para la Implementación
1) El primer paso es obtener las dos URLS necesarias para la configuración que hemos visto en el video anterior, resultantes de la acción de configurar una nueva integración en Connect Manager.
2) Seleccionamos “URL para enviar facturas desde Ágora” y la pegaremos en el servidor de Ágora del local.
A continuación podrás ver los pasos que debes realizar:
Paso 1: Ingresar a “Herramientas del estado” del Servidor de Ágora.
Paso 2: Activar módulos adicionales.
Paso 3: Activar módulos de servicios de integración.
Paso 4: Hacer clic en “Configurar servicios de integración”.
Paso 5: Tildar en “Habilitar integración de creación de documentos con sistemas externos”.
Paso 6: Copiar y pegar la url obtenida en Connect Manager “URL para enviar facturas desde Ágora”
Paso 7: Hacer clic en Aceptar para concluir la acción.
Ahora el sistema se reiniciará con la acción actualizada.
3) La tercera etapa de esta configuración será configurar la url “URL de botón de búsqueda de facturas” en el sistema de administración de Ágora.
Paso 1: Seleccionar en Connect Manager la url “URL de botón de búsqueda de facturas” y pegar en la Administración de Ágora para crear una acción personalizada.
Paso 2: Entrar en la administración, hacer clic en herramientas, y seleccionar la opción “Acciones personalizadas”.
Paso 3: Crear acción personalizada.
Paso 4: Dentro de acciones personalizadas completar los datos solicitados en dicha ventana.
-Texto: (Este es el texto que aparecerá en el botón de Ágora)
-Tipo: Url/Aplicación
Atención: Es importante que tildes en la acción “Mostrar Urls en un diálogo de Ágora” para que se ejectue correctamente en Ágora
Puedes ver todos estos pasos descritos en el siguiente videos
4) En la cuarta etapa, crearemos el botón de la acción personalizada.
Paso 1: Dentro de administración de Ágora, hacer clic en “Herramientas”, hacer clic en “Configuración de botones”
Paso 2: Hacer clic en la configuración donde necesitas añadir el botón: suele ser la del principal, que es el TPV.
Paso 3: En el espacio que deseas, buscas el botón a añadir y seleccionas la acción personalizada.
Puedes ver los pasos descritos en detalle en el siguiente video:
5) La quinta etapa es donde asignaremos los permisos.
Paso 1: Añadir el permiso al perfil o los perfiles de usuario que corresponda esta acción.
Paso 2: Hacer clic en el perfil elegido.
Paso 3: Hacer clic en editar.
Paso 4: Hacer clic en el símbolo +
Paso 5: Localizar el permiso a agregar, hacer clic y aceptar la operación.
Paso 6: Hacer clic en aceptar en la ventana final.
En el siguiente video podrás ver cómo dar permiso de esta acción a un encargado.
Uso Operativo
Proceso de una Transacción Tax Free
- El cliente realiza una compra en el establecimiento.
- Desde el TPV, en las opciones que te brinda el sistema, se busca la acción personalizada que se ha creado: ejemplo “tax free”.
- Se selecciona la factura o se busca manualmente con el identificador del ticket
- Aparece le formulario de global blue que se tiene que completar.
- Al Aceptar se imprime por la impresora que este configurada con el documento del tax free.
FAQ y Resolución de Problemas
Preguntas Frecuentes (FAQ)
P: ¿Qué hago si mi POS no es compatible?
R: Consulte con ConnectManager o el proveedor de Ágora para actualizar su hardware o buscar alternativas.
P: ¿Cuánto tiempo tarda la implementación?
R: Depende del tamaño del establecimiento, pero suele completarse en 1-3 días tras la configuración inicial.
A continuación, se presentan soluciones a consultas comunes que pueden surgir por parte de los clientes:
1. “El formulario Tax Free no se genera”
- Causa posible: Conexión a Internet fallida o credenciales API incorrectas.
- Solución: Verifique la conexión y las credenciales en la configuración de Ágora. Reinicie el módulo si es necesario.
2. “Los datos no se sincronizan con Global Blue”
- Causa posible: Error en la API o bloqueo por firewall.
- Solución: Contacte al soporte técnico de ConnectManager o Global Blue para revisar los logs de la API.
3. “El sistema marca una transacción como no elegible para Tax Free”
- Causa posible: El monto o el país del cliente no cumplen los requisitos.
- Solución: Revise las reglas de elegibilidad en la documentación de Global Blue y ajuste los parámetros en Ágora si es necesario.
¡Gracias por utilizar connect Manager!
La integración de Ágora y Global Blue, desarrollada por ConnectManager, es una herramienta poderosa para optimizar la gestión del Tax Free en tu establecimiento.
Siguiendo esta guía, podrás implementar y utilizar la solución con éxito, resolviendo dudas comunes y mejorando la experiencia de tus clientes.
Para más información o asistencia personalizada, no dude en contactar a los equipos de soporte Connect Manager.
Requisitos mínimos
- Ágora versión 7.8 o superior.
- Licencia de integración o bundle.
- Acceso a la api local.