Wiki source code of Soporte para QR Code en facturas. Instalacion y configuracion
Last modified by admin on 2026/07/18 17:45
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | = Soporte QR Code en facturas electrónicas {{id name="soporte-qr-code-en-facturas-electrónicas" /}}= | ||
| 2 | |||
| 3 | == Instalacion y configuración {{id name="instalacion-y-configuración" /}}== | ||
| 4 | |||
| 5 | = Introducción {{id name="introducción" /}}= | ||
| 6 | |||
| 7 | 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/>>https://www.afip.gob.ar/fe/qr/conceptos-generales.asp]]) | ||
| 8 | |||
| 9 | **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**. | ||
| 10 | |||
| 11 | = Prerrequisitos {{id name="prerrequisitos" /}}= | ||
| 12 | |||
| 13 | 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. | ||
| 14 | |||
| 15 | **IMPORTANTE:** La instancia donde se realice esta actividad debera poseer **Java 8 instalado**. | ||
| 16 | |||
| 17 | = Detalles técnicos {{id name="detalles-técnicos" /}}= | ||
| 18 | |||
| 19 | Para **LY 21**, la funcionalidad comprende la revisión **r2934** + **r2942** del repositorio | ||
| 20 | |||
| 21 | Para **LY 19.07** la funcionalidad comprende la revisión **r2934** + **r2942** del repositorio, salvo para: | ||
| 22 | |||
| 23 | *. **LaunchInvoice.java**, el cual responde a la revisión r2706 más los cambios exclusivos de la r2934.\\ | ||
| 24 | *. **rpt_Factura_Electronica.jrxml**, el cual responde a la revisión 1898 más los cambios exclusivos de la r2934.\\ | ||
| 25 | *. **build.xml**, el cual corresponde a la revisión r2709 más los cambios exclusivos de la r2394. | ||
| 26 | |||
| 27 | Para **LY 18.06** la funcionalidad comprende la revisión **r2934** + **r2942** del repositorio, salvo para: | ||
| 28 | |||
| 29 | *. **LaunchInvoice.java**, el cual responde a la revisión r2193 más los cambios exclusivos de la r2934.\\ | ||
| 30 | *. **rpt_Factura_Electronica.jrxml**, el cual responde a la revisión r1898 más los cambios exclusivos de la r2934.\\ | ||
| 31 | *. **build.xml**, el cual corresponde a la revisión r2447 más los cambios exclusivos de la r2394. | ||
| 32 | |||
| 33 | En todos los casos, el rango del changelog se encuentra comprendido entre los valores **2480034** y **2480087**. | ||
| 34 | |||
| 35 | = Copia de seguridad {{id name="copia-de-seguridad" /}}= | ||
| 36 | |||
| 37 | 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. | ||
| 38 | |||
| 39 | = Descarga de paquete de actualización {{id name="descarga-de-paquete-de-actualización" /}}= | ||
| 40 | |||
| 41 | Dependiendo la versión de Libertya que se esté utilizando, deberá descargarse y descomprimir el paquete de actualización correspondiente: | ||
| 42 | |||
| 43 | **Para usuarios de Libertya 18.06** | ||
| 44 | |||
| 45 | https://sourceforge.net/projects/libertya/files/libertya/dev/support/18.06/qrcode/org.libertya.support.qrcode.for.ly.1806.zip | ||
| 46 | |||
| 47 | **Para usuarios de Libertya 19.07** | ||
| 48 | |||
| 49 | https://sourceforge.net/projects/libertya/files/libertya/dev/support/19.07/qrcode/org.libertya.support.qrcode.for.ly.1907.zip | ||
| 50 | |||
| 51 | **Para usuarios de Libertya 21** | ||
| 52 | |||
| 53 | https://sourceforge.net/projects/libertya/files/libertya/dev/support/21/qrcode/org.libertya.support.qrcode.for.ly.21.zip | ||
| 54 | |||
| 55 | = Copia de nuevos archivos {{id name="copia-de-nuevos-archivos" /}}= | ||
| 56 | |||
| 57 | El paquete de esta actualización contiene una serie de archivos que deben ser copiados en las correspondientes ubicaciones: | ||
| 58 | |||
| 59 | *. Ubicar las librerías **core-3.3.1.jar** y **javase-3.3.1.jar** en la ubicación **/ServidorOXP/lib**\\ | ||
| 60 | *. Ubicar el archivo **org.libertya.core.support.qrcode_r2934_r2942.jar** en la ubicación **/ServidorOXP/lib/plugins**\\ | ||
| 61 | *. Sobrescribir el archivo **build.xml** en la ubicación **/ServidorOXP** | ||
| 62 | |||
| 63 | = Actualización de base de datos {{id name="actualización-de-base-de-datos" /}}= | ||
| 64 | |||
| 65 | Se deben insertar una serie de valores de configuración de servicios externos, para ésto realizar: | ||
| 66 | |||
| 67 | *. Acceder al sistema como **System Administrator**.\\ | ||
| 68 | *. Abrir la ventana **Instalador de Componentes**.\\ | ||
| 69 | *. Seleccionar el archivo **org.libertya.core.support.qrcode_r2934_r2942.jar**.\\ | ||
| 70 | *. Hacer click en **Instalar**. | ||
| 71 | |||
| 72 | Una vez instalado, desde la ventana **Servicio Externo** podrá visualizarse la nueva entrada junto con sus atributos | ||
| 73 | |||
| 74 | [[image:image1.png]] | ||
| 75 | |||
| 76 | Adicionalmente se debe actualizar el informe Jasper con el soporte para QR Codes: | ||
| 77 | |||
| 78 | *. Acceder al sistema como **System Administrator**.\\ | ||
| 79 | *. En la ventana **Jasper Report** buscar el registro con nombre **Factura Electrónica**.\\ | ||
| 80 | *. Hacer click en **Informe Precompilado** y seleccionar el archivo **rpt_Factura_Electronica.jasper**, el cual es parte de esta distribución.\\ | ||
| 81 | *. Por último guardar el registro. | ||
| 82 | |||
| 83 | [[image:image2.png]] | ||
| 84 | |||
| 85 | = Actualización de binarios {{id name="actualización-de-binarios" /}}= | ||
| 86 | |||
| 87 | Luego de haber copiado los nuevos binarios a las ubicaciones correspondientes, se deberá reconfigurar la instancia a fin de propagar estos cambios: | ||
| 88 | |||
| 89 | *. Detener el servidor de aplicaciones.\\ | ||
| 90 | *. Ejecutar **ConfigurarAuto.sh**.\\ | ||
| 91 | *. Reiniciar el servidor de aplicaciones. | ||
| 92 | |||
| 93 | = Pasos finales {{id name="pasos-finales" /}}= | ||
| 94 | |||
| 95 | 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. |