Manual usuario Glop – Comercia Agnóstica

En este manual vamos a ver como es el nuevo sistema de conexión de Glop y GlopDroid con Comercia a través de la arquitectura Agnóstica.

ANTES DE CONFIGURAR GLOP

Antes de arrancar Glop para configurar la conexión Agnóstica, debemos de instalar el servicio InStorePaymentApi que será proporcionado por Comercia. Enlace descarga

Para instalarlo, clic derecho «ejecutar como administrador»

IMPORTANTE Una vez instalado, hay que ir en el explorador de archivos a «C:\Comercia\InStorePaymentApi» y abrir el archivo config.json y cambiar el número de la key a 69.

Tras cambiar el número de la key es necesario reiniciar el servicio instalado desde el administrador de tareas – servicios – «InStore-Payment-Api» – reiniciar.

CONFIGURACIÓN GLOP

En Glop tendremos que elegir el tipo de conexión Agnóstica y emparejar el datáfono a través de la lectura del QR. Si al abrir la ventana para emparejar se nos muestran unos mensajes sobre el certificado tendremos que aceptar ambos.

Para emparejar:

A) Emparejado por QR (recomendado)

  • En el PC (TPV)
    • Pulse el botón de emparejado en la configuración de Glop
    • En la página/web que se abre aparecerá un QR preparado para emparejar.
    • Pulse el botón Register (o la opción que muestre la página para iniciar el proceso).
  • En el datáfono
    • En el datáfono abra la app de registro/emparejamiento (InStorePaymentApi).
    • Introduzca la contraseña proporcionada por Comercia.
    • Seleccione la opción Scan (o “QR”) y enfoque la cámara al QR que aparece en la pantalla del PC.
  • Confirmación
    • Tras escanear el QR el datáfono emitirá un beep y debería mostrar un mensaje de éxito.
    • En la interfaz del PC la indicación del botón cambiará a PAIRED OK (o similar) cuando el emparejamiento se complete.
  • Resultado
    • El TPV y el datáfono quedan emparejados; ya puede enviarse operaciones (payment, refund, etc.).

B) Emparejado manual (si la cámara no funciona)

  • En el datáfono
    • Abra la app de emparejamiento en el datáfono.
    • Introduzca la contraseña proporcionada por Comercia.
    • El datáfono mostrará un Device ID / código alfanumérico en pantalla.
  • En el PC (TPV)
    • Pulse el botón de emparejado en la configuración de Glop
    • Introduzca en el campo correspondiente (por ejemplo “Terminal Name” o “Device ID”) el valor que mostró el datáfono.
    • Pulse Register.
  • Confirmación
    • Tras unos segundos la página cambiará y mostrará Registered manually (o un mensaje equivalente) indicando que el emparejamiento se ha realizado correctamente.

También tendremos que tener una forma de pago con el parámetro GlobalPay activo.

CONFIGURACIÓN GLOPDROID

En GlopDroid tendremos que activar en la configuración la opción de comercia Agnóstica y activar una forma de pago que sea GlobalPay.

En dispositivos CM5-X la opción de imprimir ticket en el dispositivo no estará disponible al no tener impresora.

USO EN GLOP

En el video se puede ver un ejemplo de uso en Glop lanzando un pago y una devolución.

USO EN GLOPDROID

En el video se puede ver como realizamos un pago desde GlopDroid

PROPINAS

Enlace al manual de propinas donde se especifica el comportamiento con datáfonos: enlace

QUITAR ESPACIO EN BLANCO EN PIE DE PAGINA PARA FACTURAS A4

Cuando una factura de A4 tiene muchas líneas y se generan 2 hojas o más, en la primera hoja se muestra un espacio en blanco bastante grande.
Esto es debido a que ese espacio en blanco es el espacio reservado para el pie de página. Para «eliminar» ese espacio vamos a reducir el tamaño del pie de pagina al mínimo posible pero manteniendo la información.

Paso 1:

Vamos a añadir un nuevo bloque utilizando la opción de «insertar banda» y seleccionaremos la opción de «Pie».


Esto nos va a crear un nuevo bloque «Footer» que será donde añadiremos los campos.

Paso 2:

Vamos a desplazar los campos del pie al nuevo «Footer» que hemos creado asegurándonos que los campos están siempre dentro del espacio reservado. Si necesitamos más espacio solo tenemos que ampliar el tamaño del bloque «Footer».

Paso 3:

Finalmente, reduciremos el tamaño del bloque «Pie» que previamente hemos dejado vacío al tamaño que queramos que reserve. Este bloque se podría utilizar como «margen inferior» si se quisiera añadir un margen. Muy importante no eliminar el bloque «Pie».

Visualización de imágenes en equipos con Windows 7

🔧 Problema con la visualización de imágenes

En algunos ordenadores con Windows 7, las imágenes que deben aparecer en las pantallas de actualizaciones y avisos no se muestran correctamente. Este problema se debe a que el sistema no permite cargar imágenes protegidas con seguridad moderna (TLS 1.2), que es el tipo de conexión que utilizan la mayoría de servidores actuales.


✅ Solución

Para resolver este problema, es necesario activar manualmente una opción de seguridad en Internet Explorer, que es el navegador que utiliza el sistema para mostrar este tipo de contenidos.

Pasos a seguir:

  1. Abre Internet Explorer (aunque no lo utilices habitualmente).
  2. Haz clic en el menú Herramientas (puedes pulsar la tecla Alt si no ves el menú).
  3. Selecciona Opciones de Internet.
  4. Ve a la pestaña Opciones avanzadas.
  5. Desplázate hacia abajo hasta la sección llamada Seguridad.
  6. Marca las casillas:
    • Usar TLS 1.1
    • Usar TLS 1.2
  7. Haz clic en Aceptar.
  8. Cierra Internet Explorer y vuelve a ejecutar la aplicación.

Sistema comprobación y actualizacion de impuestos en Glop

INTRODUCCIÓN

Se ha desarrollado un sistema para que los Impuestos en Glop esten siempre actualizados acorde a los impuestos validos en ese momento.

Con la norma Veri*Factu los clientes ya no pueden editar los Impuestos desde el mantenimiento por lo que será Glop a través de la Api Rest el que mantendrá los Impuestos actualizados.

REQUISITOS

🔥 ¡IMPORTANTE! REQUISITO INDISPENSABLE 🔥

Para el correcto funcionamiento, es OBLIGATORIO que la licencia disponga de credenciales API-REST. ❌ Sin estas credenciales, el sistema de actualización de impuestos NO funcionará.

En clientes que no dispongan de licencia con api-rest se deberá proceder con la actualización de su licencia.

EXPLICACIÓN DEL FLUJO DE COMPROBACIONES

Versionado Global (Version Code)

  • Se define un version code global para todos los IVAs.
  • Cualquier modificación en uno o varios IVAs incrementa el version code y se publican los cambios en la base de datos de la nube.
  • Glop consulta el version code en la nube y, si detecta que es superior al local, procede a actualizar.

Histórico y Control de Versiones

Para auditoría y referencia legal, se mantiene un historial de cambios en la tabla VERSIONES_IVA. Esta tabla debe incluir los siguientes campos adicionales:

  • URL de imagen
  • URL de imagen 2
  • URL del manual

Cada incremento de version code representa un conjunto de cambios en uno o varios IVAs.


Tablas en la Nube

  • TB_IVA_NUBE: Contiene los datos actuales de los IVAs vigentes, incluyendo:
    • Valor del IVA
    • Valor re
    • Valores actuales y del cambio
  • VERSIONES_IVA: Registra cada cambio con:
    • ID
    • Version code
    • Fecha de actualizacion (fecha a aprtir de la cual la actualización estará disponible)

Tablas en la Base de Datos Local de Glop

  • TB_IVA_VC:
    • ID: Identificador único de la actualización.
    • FECHA: Fecha de la actualización.
    • VC (Version Code): Version code local tras la última sincronización exitosa.
    • FECHA_ULTIMA_COMPROBACIÓN: Fecha en la que se ha realizado la ultima comprobación de los impuestos

Flujo de Verificación y Actualización en Glop

1. Momento de la Verificación

  • Al abrir el TPV Glop, el sistema llama a un endpoint en la nube para consultar el version code más reciente.
  • Si no hay conexión o la llamada falla, se muestra un mensaje indicando que no fue posible actualizar el IVA y se mantiene la versión anterior.

Capturas de los mensajes que se muestran al comprobar que es necesaria una actualización

Capturas de los mensajes que se muestran al comprobar que se ha manipulado la tabla de iva en la BD

2. Comparación de Versiones

  • Si el version code en la nube es igual al local, se comparan los datos, para evitar modificaciones directas sobre la BD.
  • Si el version code en la nube es superior, se procede a la actualización.
  • Si hay algún error durante la comprobación del VC se muestra un mensaje indicando que no fue posible actualizar el IVA

3. Aplicación de Cambios (valor de IVA o de Recargo de Equivalencia)

Primeramente se realizan los inserts y updates necesarios sobre la tabla TB_IVA.

  • UPDATE: Se actualizan los IVAs existentes con valores modificados (ejemplo: 21% a 24%).
  • INSERT: Se insertan nuevos IVAs si no existían previamente (ejemplo: nuevo IVA al 0%).
  • DELETE : Se eliminan los IVAs que ya no son necesarios.

Tras realizar los update/insert se realiza la comprobacion de si es necesario eliminar algún Impuesto que haya quedado obsoleto.

Si hay algún error durante la aplicacón de los cambios en la BD se muestra un mensaje indicando que no fue posible actualizar el IVA

4. Guardado del Nuevo Version Code

Al finalizar la sincronización, Glop guarda el nuevo version code en TB_IVA_VC para reflejar la actualización exitosa.

Siempre que se haga una actualización de los impuestos desde un terminal central, se reiniciará Glop y todos los terminales en red. Si la actualización es realizada desde un terminal en red, mostrará un mensaje de aviso de que se deben reiniciar todos los terminales.

Mensaje que se muestra desde el terminal central

Mensaje que se muestra desde un terminal remoto

Validación de impuesto asignado al abrir el TPV

Una vez tenemos los impuestos actualizados, al acceder al TPV se realizará comprobación de que todos los artículos de venta dispongan de impuesto de venta asignado. Si detecta algún artículo sin impuesto de venta, nos mostrará un mensaje de advertencia, con posibilidad de descargar un fichero CSV con todos los artículos sin impuesto de venta y posibilidad de acceder a la pantalla de actualización de impuestos para asignarlos a los artículos que sean necesarios.

Ventana informativa de que tenemos artículos sin IVA, donde nos permite abrir pantalla de actualización de artículos exclusiva para los impuestos, y descargar fichero csv con todos los artículos sin impuesto asignado.

Si optamos por descargar el archivo csv, nos mostrara la pantalla para poder guardar done queramos y dar nombre al archivo.

Sistema de LOGS

Siempre que haya algún error sea por el motivo que sea, durante el proceso de actualización, se añadirán logs. También cuando el proceso sea exitoso.

Cuando aceptemos el mensaje desde un terminal remoto en el que nos informa de que debemos reiniciar todos los terminales, también se añadirá un log.

Estos logs, se podrán ver desde acerca de – visor de logs.
Hay que tener en cuenta que los logs se vuelcan para poder ser consultados al cerrar y abrir el día.

CREACION DE VC E IMPUESTOS DESDE APP GLOP

GESTIÓN DE IMPUESTOS PENÍNSULA Y BALEARES

GESTIÓN IMPUESTOS ISLAS CANARIAS (IGIC)

En este vídeo también se puede observar el ciclo cuando hay artículos sin impuestos asignados.

MODO TEST

A nivel de programación podemos activar el modo test de los impuestos (VC -1) descomentando la siguiente línea:


Esto nos permitirá poder recibir una actualización sin tener que lanzarla a todos los clientes.

Para poder aplicar la actualización nos pedirá la contraseña de administrador para poderla realizar.

PREGUNTAS FRECUENTES

¿Funcion igual para todos los sectores y todos los tipos de Glop (MN, GL ,GB) ?

Si, no existe ningun tipo de limitación segun el sector o tipo de Glop

¿Como funciona la actualización en una red de mas de 1 puesto?

Si la actualización de los impuestos es lanzada por el ordenador central, tras finalizar, procederá a reiniciar Glop y todos los terminales en red. En el caso de que la actualización sea lanzada por un remoto, mostrará un mensaje advirtiendo que se debe de proceder con el reinicio de todos los terminales de la red.

¿Que pasa si no se actualizan los impuestos por que no tengo conexión a internet?

Se mostrará un aviso de que no se dispone de conexión a internet y no se ha podido realizar la actualización. Cuando hayan pasado mas de 48 horas sin actualizar, en el mensaje advertirá de que hace más de 48 horas que no se ha podido realizar la comprobación.

Volver arriba

Acceder a WikiGlop