Soporte para QR Code en facturas. Instalacion y configuracion
Soporte QR Code en facturas electrónicas
Instalacion y configuración
Introducción
El presente documento detalla los pasos necesarios a fin de soportar el uso de Códigos QR en las impresiones de facturas electrónica según resolución de AFIP (https://www.afip.gob.ar/fe/qr/)
IMPORTANTE: Esta actualización brinda el soporte para la generación del QR Codes en la impresión de facturas, y en particular modifica el reporte rpt_Factura_Electronica.xjrml para dicha visualización. En caso de contar con una impresión de facturas ad-hoc, se deberán realizar las modificaciones pertinentes de la misma en iReport a fin de lograr dicha visualización.
Prerrequisitos
Esta funcionalidad ha sido desarrollada para instalar sobre Libertya 18.06, Libertya 19.07 o Libertya 21 únicamente. En caso de contar con una versión anterior de Libertya, primeramente deberá actualizar a una de las versiones soportadas.
IMPORTANTE: La instancia donde se realice esta actividad debera poseer Java 8 instalado.
Detalles técnicos
Para LY 21, la funcionalidad comprende la revisión r2934 + r2942 del repositorio
Para LY 19.07 la funcionalidad comprende la revisión r2934 + r2942 del repositorio, salvo para:
- LaunchInvoice.java, el cual responde a la revisión r2706 más los cambios exclusivos de la r2934.
- rpt_Factura_Electronica.jrxml, el cual responde a la revisión 1898 más los cambios exclusivos de la r2934.
- build.xml, el cual corresponde a la revisión r2709 más los cambios exclusivos de la r2394.
Para LY 18.06 la funcionalidad comprende la revisión r2934 + r2942 del repositorio, salvo para:
- LaunchInvoice.java, el cual responde a la revisión r2193 más los cambios exclusivos de la r2934.
- rpt_Factura_Electronica.jrxml, el cual responde a la revisión r1898 más los cambios exclusivos de la r2934.
- build.xml, el cual corresponde a la revisión r2447 más los cambios exclusivos de la r2394.
En todos los casos, el rango del changelog se encuentra comprendido entre los valores 2480034 y 2480087.
Copia de seguridad
IMPORTANTE: Se sugiere que preventivamente se realice una copia de seguridad tanto de los binarios de Libertya como de la base de datos previo a llevar adelante esta actualización.
Descarga de paquete de actualización
Dependiendo la versión de Libertya que se esté utilizando, deberá descargarse y descomprimir el paquete de actualización correspondiente:
Para usuarios de Libertya 18.06
Para usuarios de Libertya 19.07
Para usuarios de Libertya 21
Copia de nuevos archivos
El paquete de esta actualización contiene una serie de archivos que deben ser copiados en las correspondientes ubicaciones:
- Ubicar las librerías core-3.3.1.jar y javase-3.3.1.jar en la ubicación /ServidorOXP/lib
- Ubicar el archivo org.libertya.core.support.qrcode_r2934_r2942.jar en la ubicación /ServidorOXP/lib/plugins
- Sobrescribir el archivo build.xml en la ubicación /ServidorOXP
Actualización de base de datos
Se deben insertar una serie de valores de configuración de servicios externos, para ésto realizar:
- Acceder al sistema como System Administrator.
- Abrir la ventana Instalador de Componentes.
- Seleccionar el archivo org.libertya.core.support.qrcode_r2934_r2942.jar.
- Hacer click en Instalar.
Una vez instalado, desde la ventana Servicio Externo podrá visualizarse la nueva entrada junto con sus atributos
Adicionalmente se debe actualizar el informe Jasper con el soporte para QR Codes:
- Acceder al sistema como System Administrator.
- En la ventana Jasper Report buscar el registro con nombre Factura Electrónica.
- Hacer click en Informe Precompilado y seleccionar el archivo rpt_Factura_Electronica.jasper, el cual es parte de esta distribución.
- Por último guardar el registro.
Actualización de binarios
Luego de haber copiado los nuevos binarios a las ubicaciones correspondientes, se deberá reconfigurar la instancia a fin de propagar estos cambios:
- Detener el servidor de aplicaciones.
- Ejecutar ConfigurarAuto.sh.
- Reiniciar el servidor de aplicaciones.
Pasos finales
Una vez realizados los pasos anteriores, eliminar el archivo org.libertya.core.support.qrcode_r2934_r2942.jar de /ServidorOXP/lib/plugins a fin de evitar potenciales conflictos al momento de instalar nuevas versiones de CORE.