Skip to Content
Last modified by admin on 2026/07/18 17:44
Show last authors
1 = Libertya Electronic Invoice {{id name="libertya-electronic-invoice" /}}=
2
3 = Componente Libertya LYEI {{id name="componente-libertya-lyei" /}}=
4
5 = Indice {{id name="indice" /}}=
6
7 {{toc/}}
8
9 = Introducción {{id name="introducción" /}}=
10
11 El presente documento detalla las funcionalidades abarcadas por el módulo de Configuración de Factura Electrónica para la localización Argentina, así como las actividades necesarias de configuración para su correcta utilización.
12
13 = Prerrequisitos {{id name="prerrequisitos" /}}=
14
15 **IMPORTANTE:** Este componente se apoya en **Libertya CORE 18.06** (o al menos la revisión r2218) y **Locale AR v1.7** o posterior.
16
17 = Instalación {{id name="instalación" /}}=
18
19 == Instalación de binarios {{id name="instalación-de-binarios" /}}==
20
21 Ubicar el archivo **org.libertya.locale.ar.electronicInvoice.2.0.jar** en el directorio **/ServidorOXP/lib/plugins** (o en la ubicación donde se encuentre instalado el servidor Libertya) y ejecutar **ConfigurarAuto.sh** o bien **ConfigurarAuto.bat** si se está trabajando bajo Windows.
22
23 == Instalación de BBDD {{id name="instalación-de-bbdd" /}}==
24
25 Una vez incorporados los binarios a la instancia, instalar uno por uno los siguientes componentes desde el perfil **System Administrator**, ventana **Instalador de Componentes**:
26
27 *. **org.libertya.locale.ar.electronicInvoice.1.0.jar**
28 **. No es necesario que este archivo se encuentre en una ubicación en particular\\
29 *. **org.libertya.locale.ar.electronicInvoice.2.0.jar**
30 **. Este archivo es el utilizado durante la instalación de binarios
31
32 = Configuración preliminar {{id name="configuración-preliminar" /}}=
33
34 == Instalación de OpenSSL {{id name="instalación-de-openssl" /}}==
35
36 Previo a la utilización del módulo LYEI, se requiere instalar OpenSSL, paquete de herramientas de administración y bibliotecas relacionadas con la criptografía En Linux esta herramienta ya se encuentra instalada, y bajo Windows la actividad de instalación es muy sencilla de realizar (ver por ejemplo: http://gnuwin32.sourceforge.net/packages/openssl.htm)
37
38 == Ubicación OpenSSL {{id name="ubicación-openssl" /}}==
39
40 Previo a la utilización del módulo LYEI, es necesario que Libertya conozca la ubicacion de OpenSSL. Para ésto hay dos alternativas:
41
42 1. Definir la variable de entorno del sistema OPENSSL_HOME, indicando la ubiación del ejecutable openssl en el equipo. Consultar los pasos necesarios para realizar esta actividad en función del sistema operativo que está utilizando. Solo debe especificarse la ubicacion, por ejemplo:
43 11. export OPENSSL_HOME=/usr/bin\\
44 1. Ampliar la variable del sistema PATH a fin de incluir la ubicación del ejecutable openssl en el equipo. Consultar los pasos necesarios para realizar esta actividad en función del sistema operativo que está utilizando. Ejemplo:
45 11. export ~$PATH=~$PATH:/usr/bin
46
47 De esta manera, Libertya podrá invocar a la herramienta y realizar las operaciones necesarias del caso.
48
49 == Ubicación afip-openssl.cnf {{id name="ubicación-afip-openssl.cnf" /}}==
50
51 Previo a la utilización del módulo LYEI, es necesario que Libertya pueda obtener el archivo afip-openssl.cnf. El mismo debe ubicarse en el directorio HOME del usuario a nivel sistema operativo. Dependiendo el sistema operativo, el HOME podrá ser por ejemplo, si el usuario del sistema se llama foobar, entonces el HOME en este caso es:
52
53 *. /home/foobar (Linux)\\
54 *. C:\users\foobar (Windows)
55
56 En el directorio en cuestión, deberá copiarse el archivo provisto por AFIP utilizado por openssl, exactamente con el nombre afip-openssl.cnf.
57
58 = Configuración de la compañía / organizaciones {{id name="configuración-de-la-compañía-organizaciones" /}}=
59
60 Previo a realizar la configuración de factura electrónica - solo en caso de no haberlo realizado - se debe realizar la configuración de Compañía y/o Organizaciones según sea necesario en función de la estructura de su empresa.
61
62 Si bien normalmente se utiliza la compañía para definir el CUIT de la empresa, también es posible definir empresas de un mismo conglomerado pero cada una de éstas con distinto CUIT, registrando dicho dato en la configuración de cada organización.
63
64 En definitiva, es posible:
65
66 1. Definir el CUIT de la empresa a nivel Configuración de la Compañía.\\
67 1. Definir una o varias organizaciones, cada una con un CUIT distinto, a nivel Configuración de la Organización.
68
69 = Acceso a Configuración de Factura Electrónica {{id name="acceso-a-configuración-de-factura-electrónica" /}}=
70
71 Se ha incorporado una nueva entrada bajo el perfil Configuración de la Compañía, la cual será el punto de partida para toda la actividad relacionada con la funcionalidad del componente.
72
73 [[image:image1.png]]
74
75 Esta ventana permitirá especificar los valores necesarios para:
76
77 *. Generar el KEY (clave privada) y el CSR (certificado de pedido), ya sea por compañía o por organización (discriminando siempre por CUIT), en caso de no contar con los mismos.\\
78 *. Almacenar el KEY y CSR en caso de ya contar previamente con los mismos y querer utilizarlos en Libertya.\\
79 *. Crear nuevos puntos de venta, junto con sus tipos de documentos y configuración electrónica correspondiente.\\
80 *. Cargar y validar los CRTs de cada punto de venta, tanto para homologación como para producción, ya sea de facturación nacional como de exportación.
81
82 Deberá existir una única configuración electrónica por CUIT, en función de la configuración realizada previamente a nivel Compañía / Organización. Para cada registro creado en esta ventana, el CUIT y el nombre serán obtenidos a partir de la organización indicada en el campo organización. Si especifica organización (*), el CUIT y nombres serán obtenidos a partir de la configuración de la compañía.
83
84 = Creación de nuevos certificados CSR {{id name="creación-de-nuevos-certificados-csr" /}}=
85
86 Si Ud. no cuenta con el certificado CSR y clave privada KEY, Libertya puede generarlos por Ud. Para ésto, debe especificar en Tipo de Configuración, la opción **//Necesito generar el certificado CSR//**.
87
88 Se habilitarán los siguientes campos:
89
90 *. **Nombre**: valor del //Organization Name// en la generación del CSR. Se debe ingresar el nombre de la empresa tal cual figura en la consulta de inscripción AFIP, respetando puntos y espacios en blanco\\
91 *. **Solicitante del certificado**: valor del //Common Name// en la generación del CSR. Se debe ingresar el nombre del encargado contable o solicitante de los Certificados
92
93 La siguiente imagen muestra una captura de la ventana de Configuración de Factura Electrónica bajo este modo.
94
95 = [[image:image2.png]] {{id name="image2" /}}=
96
97 == Confirmar configuración {{id name="confirmar-configuración" /}}==
98
99 Una vez finalizada la configuración, se deberá presionar el botón **//Confirmar Configuración//**. De esta manera los datos ya no son modificables, y se habilita la posibilidad de crear nuevos puntos de venta para esta configuración.
100
101 Una vez finalizado el proceso, y si todo funcionó correctamente, se indicará que los archivos CSR y KEY se encuentran disponibles como adjunto del registro actual. Probablemente sea necesario reabrir la ventana a fin de visualizarlo:
102
103 [[image:image3.png]]
104
105 = Almacenando certificados CSR generados previamente {{id name="almacenando-certificados-csr-generados-previamente" /}}=
106
107 Si Ud. ya cuenta con el certificado CSR y clave privada KEY para cada CUIT, simplemente hay que almacenarlos en el registro correspondiente. Para ésto, debe especificar en Tipo de Configuración, la opción **//Ya cuento con el certificado CSR//**.
108
109 [[image:image4.png]]
110
111 == Confirmar configuración {{id name="confirmar-configuración-1" /}}==
112
113 Una vez finalizada la configuración, se deberá presionar el botón **//Confirmar Configuración//**. De esta manera los datos ya no son modificables, y se habilita la posibilidad de crear nuevos puntos de venta para esta configuración.
114
115 = Creación de puntos de venta electrónicos {{id name="creación-de-puntos-de-venta-electrónicos" /}}=
116
117 Una vez finalizada la configuración y generación del CSR, ya es posible crear los puntos de venta electrónicos. Simplemente presionando **//Crear Pto Vta Electrónico//** se dispará el proceso correspondiente. El mismo requerirá dos datos:
118
119 [[image:image5.png]]
120
121 *. **Organización** de los tipos de documento a crear. Si en la configuración se especificó una organización en particular, aquí se deberá indicar la misma organización.\\
122 *. **Número del TPV** a crear, o sea el número de punto de venta de los tipos de documento
123
124 Con estos datos, se generarán y configurarán los tipos de documento electrónicos (facturas/NC/ND de tipo A, B, C y con el número de Pto. Vta. según indicado por parámetro). A partir de Libertya **r2235** se generan también los documentos electrónicos con letra E.
125
126 Los tipos de documento electrónicos generados ya estarán configurados para facturación electrónica, dado que se especifican automáticamente los valores:
127
128 *. SubTipo de Documento\\
129 *. Tipo de Documento Electrónico\\
130 *. Es Electrónico\\
131 *. Documento Fiscal
132
133 Una vez finalizada la creación de los tipos de documento, se genera además una entrada en la subpestaña **//Punto de Venta Electrónico//** de la ventana, la cual se explica más adelante en el presente documento.
134
135 == Tipos de documentos ya existentes {{id name="tipos-de-documentos-ya-existentes" /}}==
136
137 Es posible que los tipos de documentos ya existieran previamente, con lo cual en este caso el proceso realiza todas las actividades, pero omitiendo la creación y configuración de dichos puntos de documento. **Los mismos deberán ser configurados manualmente por el usuario**.
138
139 = Carga de CRT y validación de certificados {{id name="carga-de-crt-y-validación-de-certificados" /}}=
140
141 Tal como se explicó previamente, una vez creado el punto de venta, se genera una entrada en la subpestaña de la ventana. En la imagen se muestra la configuración del punto de venta 2:
142
143 [[image:image6.png]]
144
145 Esta pestaña permite cargar los CRTs gestionados, uno para producción y otro para homologación; para posteriormente ejecutar el proceso de validación de certificados a fin de validar que la interacción con AFIP es correcta.
146
147 Una vez cargados los certificados, el estado de cada uno de ellos pasará de **Certificado no cargado** a **Pendiente a validar**. Al clickear **Validar Certificados** se verificaŕan los mismos. Si hay errores el estado pasará a **CRT Inválido**, o **CRT Válido** en caso contrario.
148
149 Si ambos certificados quedan con el estado **CRT Válido**, la configuración ha quedado correctamente finalizada para el Punto de Venta en cuestión. Es posible sin embargo trabajar bajo un ambiente válido (por ejemplo Homologación) más allá de que la validación del otro ambiente sea inválida (por ejemplo Producción).
150
151 == Ámbito de aplicación {{id name="ámbito-de-aplicación" /}}==
152
153 Una vez configurado y validado un punto de venta electrónico, es posible modificar tanto el **Ambiente Actual** (Homologación / Producción) como el **Servicio** de AFIP al cual conectar (Facturación Nacional / Facturación Exportación).
154
155 También es posible realizar un cambio global del ambiente actual para todos los puntos de venta configurados utilizando el botón **Cambiar Ambiente Puntos de Vta.** ubicado en la pestaña principal de la ventana.
156
157 = Modificación de configuración {{id name="modificación-de-configuración" /}}=
158
159 Si por algún motivo es necesario realizar cambios de configuración en la pestaña principal, esto es posible realizarlo clickeando en el botón **Editar Configuración** de dicha pestaña.
160
161 **IMPORTANTE**: Al editar los valores de la Configuración es posible que requiera generar los Certificados nuevamente.
162
163 Al cambiar el CUIT, Nombre y/o Solicitante, el CSR y KEY generados variarán, con lo cual deberán cargarse los nuevos CRTs para cada punto de venta acordemente.
164
165 Una vez modificados los datos, al clickear nuevamente en **Confirmar Configuración** se presentará un mensaje especificando el impacto de los cambios realizados.
166
167 Ejemplo de modificación de Solicitante:
168
169 [[image:image7.png]]
170
171 = Log de actividades {{id name="log-de-actividades" /}}=
172
173 Ante cada actividad del módulo de Factura Electrónica, se generará una nueva entrada en el log de actividades (pestaña **//Log de actividad//** de la ventana **//Configuración de Factura Electrónica//**). La información allí queda almacenada en el log por un período de cinco días y luego es eliminada.
174
175 Se puede visualizar la información de actividad cronológicamente:
176
177 [[image:image8.png]]
178
179 O bien, revisar el detalle de una actividad en particular:
180
181 [[image:image9.png]]