Skip to Content
Last modified by admin on 2026/07/18 17:45
Show last authors
1 = Soporte emisión de comprobantes bajo CAEA {{id name="soporte-emisión-de-comprobantes-bajo-caea" /}}=
2
3 == Libertya Electronic Invoice v2.3 {{id name="libertya-electronic-invoice-v2.3" /}}==
4
5 = Indice {{id name="indice" /}}=
6
7 {{toc/}}
8
9 = Introducción {{id name="introducción" /}}=
10
11 El presente documento detalla los pasos de configuración y uso para la emisión de comprobantes CAEA mediante el servicio WSMTXCA de AFIP.
12
13 El soporte a dicha funcionalidad se encuentra presente a partir de la versión 2.3 del módulo nativo de facturación eletrónica Libertya Electronic Invoice (LYEI).
14
15 = Configuración {{id name="configuración" /}}=
16
17 En la configuración de Punto de Venta Electrónico (PVE) ahora es necesario especificar el valor para el campo **Gestion de CAE**. Las opciones posibles son **CAE** o **CAEA**.
18
19 Al seleccionar la opción **CAE**, la funcionalidad del módulo de facturación electronica es la tradicional, esto es: ante cada factura a completar, Libertya interactuará con AFIP a fin de obtener el CAE correspondiente mediante sus webservices **WSFE** / **WSFEX**.
20
21 Al seleccionar la opción **CAEA**, la funcionalidad aplicada será la de utilizar un CAE previamente obtenido ante AFIP mediante el webservice **WSMTXCA**, sin necesidad de realizar una autorización online al momento de completar cada factura.
22
23 [[image:image1.png]]
24
25 Para el usuario de Libertya que emite y completa facturas de venta, la operatoria será indistinta entre ambos métodos, lo único que varía es la gestión interna y los instantes de tiempo en la interacción con AFIP. La funcionalidad de CAEA contempla tres procesos principales de importancia:
26
27 *. **Proceso Solicitar CAEA**: solicita un nuevo CAEA para ser (re)utilizado en las facturas que se completen dentro de un período determinado.\\
28 *. **Proceso Informar Comprobante CAEA**: informa uno o varios comprobantes emitidos mediante CAEA en un período determinado.\\
29 *. **Proceso Informar CAEA no utilizado**: informa uno o varios puntos de venta que no han utilizado un CAEA en particular para un período determinado.
30
31 Por defecto, el acceso a dichos procesos se encuentra en la carpeta CAEA dentro del menú **Configuración de la Compañía**.
32
33 [[image:image2.png]]
34
35 = Configuración de Artículos {{id name="configuración-de-artículos" /}}=
36
37 A fin de poder informar los comprobantes CAEA correctamente a AFIP, es necesario configurar dos valores en los artículos:
38
39 [[image:image3.png]]
40
41 **Unidad de ref. minorista**: Si en Libertya no se indica ningún valor en este campo, el valor por defecto informado a AFIP será 1.
42
43 **Codigo unidad minorista**: Si en Libertya no se indica ningún valor en este campo, el valor por defecto informado será el de la preferencia **LYEI_CODIGO_MTX_PREDETERMINADO**. Si esta preferencia tampoco existiera, se presentará el error: //Es obligatorio informar CodigoMtx. Especificarlo en el campo ‘Codigo unidad minorista’ del articulo o de manera general como valor predeterminado: LYEI_CODIGO_MTX_PREDETERMINADO.//
44
45 == Unidad de referencia minorista (**UnidadesMtx**) {{id name="unidad-de-referencia-minorista-unidadesmtx" /}}==
46
47 Según la referencia en AFIP, este campo refiere a:
48
49 //Unidad de Referencia del código Producto/Servicio. Cuando la comercialización de los productos se realice en presentaciones distintas a la unidad de consumo minorista o presentación al consumidor final, a la que hace referencia la codificación del producto, se deberán indicar las cantidades de unidades de consumo minoristas contenidas en la presentación que se comercializa. En caso que el producto ya se encuentre individualizado en su unidad de consumo minorista, la unidad de referencia deberá ser igual a UNO (1). Es opcional si <codigoUnidadMedida> es 99 (bonificacion) ó 97 (seña), para el resto de los casos es obligatorio.//
50
51 == Codigo unidad minorista (**CodigoMtx**) {{id name="codigo-unidad-minorista-codigomtx" /}}==
52
53 Según la referencia en AFIP, este campo refiere a:
54
55 //Código de Producto/Servicio. Deberán corresponder a la estructura provista por la ASOCIACION ARGENTINA DE CODIFICACION DE PRODUCTOS COMERCIALES. Códigos GTIN 13, GTIN 12 y GTIN 8, correspondientes a la unidad de consumo minorista o presentación al consumidor final. Es opcional si <codigoUnidadMedida> es 99 ó 97, para el resto de los casos es obligatorio. Por ejemplo: 7790001001054 = Ventas varias.//
56
57 El **Apéndice I** de este documento muetra los distintos códigos de de unidad minorista, mientras que el **Apéndice II** presenta la tabla de códigos de unidad de medida.
58
59 = Proceso Solicitar CAEA {{id name="proceso-solicitar-caea" /}}=
60
61 Este proceso solicita un nuevo CAEA para ser (re)utilizado en las facturas que se completen dentro de un período determinado.
62
63 [[image:image4.png]]
64
65 AFIP requiere que por cada quincena se solicite un nuevo CAEA. Por consiguiente, las solicitudes a AFIP poseen el siguiente formato:
66
67 *. Período: año y mes correspondiente a solicitar, por ejemplo **202106** refiere a **Junio 2021**.\\
68 *. Orden: el cual puede ser 1 o 2 según la quincena del período. Hasta el día 15 inclusive es **orden 1** y a partir del 16 en adelante es **orden 2**.
69
70 El proceso simplifica esta gestión, simplemente con el check **Periodo Actual**. Si dicho check se encuentra tildado intentará obtener un CAEA para el período correspondiente a la fecha actual. Si dicho check no se encuentra tildado intentará obtener un CAEA para el período inmediato siguiente al período correspondiente a la fecha actual.
71
72 La siguiente tabla muestra ejemplos para comprender la semántica de dicho check:
73
74 |=Fecha Actual |=Check Periodo Actual |=Período-Orden a solicitar
75 |15 de Junio de 2021 |Tildado |202106-1
76 |15 de Junio de 2021 |No tildado |202106-2
77 |25 de Agosto de 2021 |Tildado |202108-2
78 |25 de Agosto de 2021 |No tildado |202109-1
79
80 Cabe mencionar que AFIP solo permite solicitar un CAEA para un período dado con un máximo de 5 días de anticipación. En aquellos casos de solicitarlo en una fecha incorrecta, AFIP indicará el siguiente mensaje de error:
81
82 //[[image:image5.png]]//
83
84 El proceso requiere también que se especifique el **Ambiente** (Homo o Prod) sobre el cual intentaremos obtener un CAEA por parte de AFIP. Al obtener un CAEA para - por ejemplo - Homologación, todos los PVE con ambiente Homologación podrán utilizar este CAEA, pero no así los PVE con ambiente Producción, y viceversa.
85
86 Si el proceso de obtención de CAEA se ejecuta varias veces y ya se había obtenido un CAEA para el período en cuestión, el proceso no realiza otras gestiones y simplemente indica el CAEA ya existente:
87
88 [[image:image6.png]]
89
90 Una vez obtenido el CAEA, el mismo quedará almacenado en la nómina de CAEA solicitados. Esta información puede visualizarse en la pestaña **CAEA Solicitados**:
91
92 [[image:image7.png]]
93
94 Notar que la solicitud de CAEA se discrimina por **Periodo**, **Orden** y **Ambiente**.
95
96 = Proceso Informar comprobantes CAEA {{id name="proceso-informar-comprobantes-caea" /}}=
97
98 Este proceso permite informar los comprobantes emitidos mediante CAEA en un período determinado.
99
100 [[image:image8.png]]
101
102 Es posible filtrar por una Factura, un punto de venta o un CAEA en particular a fin de informar sólo un subconjunto de documentos. Si no se indica ninguno de estos valores, entonces se indicarán todos los comprobantes pendientes a informar, utilizando el ambiente (Homo / Prod) que corresponda según el ambiente configurado en el PVE de cada comprobante.
103
104 Los comprobantes pendientes a informar son los que poseen el campo CAEA Informado con valor **Pendiente** o **Rechazado** (este último implicará realizar alguna medida correctiva a fin de que sea aceptado):
105
106 [[image:image9.png]]
107
108 Adicionalmente, un comprobante puede ser **Observado**, lo cual se considera como **Aceptado** pero con alguna observación menor.
109
110 [[image:image10.png]]
111
112 Al finalizar la ejecución del proceso se visualizará el resultado de la notificación de cada uno de los comprobantes:
113
114 [[image:image11.png]]
115
116 Cabe mencionar que AFIP solo permite informar documentos CAEA para un período dado con un máximo de 5 días posterior a la finalización de dicho período. Por ejemplo si el período para un CAEA dado es **202106-1**, entonces la fecha máxima de uso de dicho CAEA es el **15 de Junio de 2021**, y la fecha límite para informar documentos con dicho CAEA es el **20 de Junio de 2021**. El campo Fecha Tope Informe de la pestaña **CAEA Solicitado** indica justamente este dato.
117
118 = Proceso Informar CAEA no utilizado {{id name="proceso-informar-caea-no-utilizado" /}}=
119
120 Este proceso informa uno o varios puntos de venta que no han utilizado un CAEA en particular para un período determinado.
121
122 [[image:image12.png]]
123
124 Es posible filtrar por un CAEA en particular, o bien si no se especifica uno, se buscará el CAEA pendiente a informar que se encuentre dentro del período válido según Fecha Tope Informe.
125
126 El proceso buscará todos los PVE del ambiente seleccionado, y para cada uno verificará el número de comprobantes emitidos para el período en cuestión. En caso de tener comprobantes emitidos, el proceso no realiza notificación alguna a AFIP. En caso de que un PVE no tenga comprobantes emitidos para el período dado, el proceso realizará la notificación correspondiente a AFIP. Para cada PVE de tipo CAEA, el resultado de la ejecución puede ser **Aceptado** o **Rechazado** por parte de AFIP.
127
128 [[image:image13.png]]
129
130 Ante cada notificación a AFIP de un CAEA no utilizado para un PVE dado en un período determinado, se almacenará una entrada en la pestaña **CAEAs No Usados**, la cual una subpestaña de **CAEA Solicitados** y se indicará el **número de punto de venta**, el **ambiente** y el **estado** (Aceptado / Rechazado).
131
132 [[image:image14.png]]
133
134 Cabe mencionar que AFIP solo permite informar CAEA no utilizados para un período dado con un máximo de 5 días posterior a la finalización de dicho período. Por ejemplo si el período para un CAEA dado es **202106-1**, entonces las fechas de notificación de CAEA no utilizados comprenderán entre del **16 al 20 de Junio de 2021**. El campo Fecha Tope Informe de la pestaña **CAEA Solicitado** indica justamente este dato.
135
136 Por consiguiente, en función de estas restricciones de fechas es posible que el proceso indique que no es posible informar CAEA no utilizados:
137
138 [[image:image15.png]]
139
140 = Secuencias de documentos bajo CAEA {{id name="secuencias-de-documentos-bajo-caea" /}}=
141
142 == Operatoria {{id name="operatoria" /}}==
143
144 Al igual que cualquier tipo de documento, los tipos de documento de un PVE configurado con CAEA tienen una secuencia asociada. Sin embargo, en este último caso se utilizan 2 campos específicamente para la gestión de las secuencias, dado que bajo CAEA la asignación del número de documento no la gestiona AFIP como en los casos de CAE tradicional.
145
146 Los campos exclusivos para esta actividad son **Sig. Sec. CAEA Homo** (secuencia para homologación) y **Sig. Sec. CAEA Prod** (secuencia para Producción).
147
148 [[image:image16.png]]
149
150 Si bien al crear una factura de tipo CAEA se utiliza el campo **Siguiente Secuencia** como un valor preliminar, al completar la misma se utilizan los campos exclusivos, asignando este valor al comprobante. De no presentarse ningún inconveniente en la operatoria, el cambio de secuencia queda registrado, y en caso contrario la transacción se anula y la secuencia vuelve a su valor anterior.
151
152 Esto es de extrema importancia dado que debe existir una perfecta coincidencia entre los números de documento de los comprobantes en Libertya con los de AFIP. En caso contrario, al informar comprobantes se obtendrán errores del tipo:
153
154 //703:El número de comprobante informado debe ser mayor en 1 al último informado para igual punto de venta y tipo de comprobante.//
155
156 Los campos exclusivos para CAEA inician sin dato alguno (vacíos). Al completar una factura, Libertya notará que se encuentra vacío, lo interpretará como cero e incrementará a uno (primer número que espera AFIP para un nuevo punto de venta CAEA). Para el siguiente comprobante a completar, la secuencia que estaba en uno se incrementará a dos y así sucesivamente.
157
158 == Validación preliminar {{id name="validación-preliminar" /}}==
159
160 Al crear un PVE de tipo CAEA, o bien al empezar a utilizar la metodología CAEA, se recomienda ejecutar el proceso **Validar Uĺtimo Nro Cbte**, ubicado en la pestaña **Punto de Venta Electrónico**.
161
162 [[image:image17.png]]
163
164 Este botón sólo está habilitado para PVE que sean de tipo CAEA, y la actividad que realiza es la de buscar todos los tipos de documento electrónicos asociados al PVE en cuestión, por ejemplo Factura A, Nota de Credito A, Nota de Debito A, Factura B, Nota de Credito B, etc.
165
166 Para cada uno de estos tipos de documento, valida contra AFIP los valores de último numero de comprobante a fin de verificar si hay coincidencias o discrepancias con la información almacenada en las secuencias de Libertya asociadas al tipo de documento en cuestión, en los campos **Sig Sec CAEA Homo** y **Sig Sec CAEA Prod**.
167
168 La ejecución del proceso contrastará los valores en LY contra los de AFIP, informando acordemente. Esto permitirá configurar adecuadamente las secuencias en Libertya conforme a la información en AFIP en caso de ser necesario, por ejemplo:
169
170 [[image:image18.png]]
171
172 La información resultante del proceso indica:
173
174 *. **Factura A Homo**: se detectó que el valor en Libertya es 1, pero el valor en AFIP es 3.\\
175 *. **Factura A Prod**: el certificado de producción no es válido. Se omite la validación.\\
176 *. **Factura B Homo**: se detectó coincidencia entre valor local y valor en AFIP. No se requieren acciones.\\
177 *. **Factura C Homo y E Homo**: C y E no son válidos para CAEA al momento de escribir este documento.\\
178 *. **NC A Homo**: Localmente no tiene un valor asignado y en AFIP se detectó un 3, en este caso se asigna el valor 3.\\
179 *. **NC B Homo**: AFIP no contiene registro de ningun comprobante, con lo cual no podemos comparar, solo suponer que nunca se informó nada.
180
181 Como se puede observar, en la mayoría de los casos Libertya solo informará la situación pero no realizará modificaciones de las secuencias (casos //Omitiendo//). El proceso solo realizará modificaciones únicamente si la secuencia en Libertya no tiene un valor definido (se encuentra vacía) y desde AFIP sí se recibe un valor de secuencia.
182
183 = Seguimiento de comprobantes CAEA {{id name="seguimiento-de-comprobantes-caea" /}}=
184
185 Existen dos informes de utilidad a fin de realizar el seguimiento de los comprobantes emitidos bajo CAEA.
186
187 == Comprobantes CAEA pendientes a informar {{id name="comprobantes-caea-pendientes-a-informar" /}}==
188
189 Visualiza todos los comprobantes que se encuentran pendientes a informar a AFIP. Los comprobantes pendientes a informar son los que poseen su **Estado CAEA** como **Pendiente** o **Rechazado**.
190
191 [[image:image19.png]]
192
193 El informe permite filtrar por Organización, Período, Orden, Punto de Venta y Ambiente (este último obligatorio).
194
195 [[image:image20.png]]
196
197 == CAEA no utilizados pendientes a informar {{id name="caea-no-utilizados-pendientes-a-informar" /}}==
198
199 Visualiza todos los PVE que no utilizaron un CAEA en particular pendientes a informar a AFIP. Los PVE que no utilizaron un CAEA en particular son los que no emitieron comprobante alguno para un período y orden dado.
200
201 [[image:image21.png]]
202
203 El informe permite filtrar por Organización, Período, Orden, Punto de Venta y Ambiente (este último obligatorio).
204
205 [[image:image22.png]]
206
207 = Programando la ejecución de procesos {{id name="programando-la-ejecución-de-procesos" /}}=
208
209 Es posible programar los procesos **Solicitar CAEA**, **Informar Comprobante CAEA**, **Informar CAEA no utilizado** para que se ejecuten automáticamente de dos maneras distintas:
210
211 == Tareas programadas de Libertya {{id name="tareas-programadas-de-libertya" /}}==
212
213 Para cada actividad deberá definirse la tarea programada en cuestión indicando el proceso correspondiente y la frecuencia, siendo los siguientes procesos los encargados de llevar la actividad en cada caso:
214
215 *. **Proceso Solicitar CAEA**: LYEICAEARequestProcess\\
216 *. **Proceso Informar Comprobante CAEA**: LYEICAEANotifyDocumentProcess\\
217 *. **Proceso Informar CAEA no utilizado**: LYEICAEANotUsedProcess
218
219 == Invocación desde Terminal / Tabla de cron (linux) {{id name="invocación-desde-terminal-tabla-de-cron-linux" /}}==
220
221 Desde la terminal o tabla de cron también es posible invocar a las clases correspondientes utilizando //CallClass.sh//:
222
223 *. **Proceso Solicitar CAEA**
224 **. org.libertya.locale.ar.electronicInvoice.process.LYEICAEARequestProcess\\
225 *. **Proceso Informar Comprobante CAEA**
226 **. org.libertya.locale.ar.electronicInvoice.process.LYEICAEANotifyDocumentProcess\\
227 *. **Proceso Informar CAEA no utilizado**
228 **. org.libertya.locale.ar.electronicInvoice.process.LYEICAEANotUsedProcess
229
230 En cada caso se requerirá una serie de argumentos, los cuales pueden consultarse si se indica el argumento //-help//. Por ejemplo:
231
232 Pedido de CAEA
233
234 Argumentos:\\-help muestra esta ayuda\\-client AD_Client_ID (obligatorio)\\-org AD_Org_ID (obligatorio, puede ser 0)\\-env ambiente (H)omologacio o (P)roduccion. Si no se especifica, se supone homologacion\\-current periodo actual? (Y/N) Si no es actual pide por el siguiente. Si no se especifica, se supone actual
235
236 El AD_Client_ID y el AD_Org_ID se utilizan para determinar la configuración utilizar.\\El nombre de argumento y su correspondiente valor no deben tener espacios!
237
238 = Apéndice I. Codigos Unidad Minorista {{id name="apéndice-i.-codigos-unidad-minorista" /}}=
239
240 |=Codigo |=Descripción
241 |7790001001030 7790001001047 7790001001054 7790001001061 7790001001078 7790001001085 7790001001092 7790001001115 7790001001122 7790001001139 7790001001146 7790001001153 |Descuentos y bonificaciones comerciales Conceptos financieros Ventas varias Bienes de uso Servicios prestados Fletes Alquileres Depósito y servicios de logística Repuestos y accesorios Ajustes impositivos Actividades comerciales no codificadas Venta de material de rezado
242
243 = Apéndice II. Codigos Unidad de Medida {{id name="apéndice-ii.-codigos-unidad-de-medida" /}}=
244
245 |=Codigo |=Descripción
246 |0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 41 47 48 49 50 51 52 53 54 55 61 62 63 97 98 99 |SIN DESCRIPCION KILOGRAMO METROS METRO CUADRADO METRO CUBICO LITROS 1000 KILOWATT HORA UNIDAD PAR DOCENA QUILATE MILLAR MEGA U. INTER. ACT. ANTIB UNIDAD INT. ACT. INMUNG GRAMO MILIMETRO MILIMETRO CUBICO KILOMETRO HECTOLITRO MEGA UNIDAD INT. ACT. INMUNG CENTIMETRO KILOGRAMO ACTIVO GRAMO ACTIVO GRAMO BASE UIACTHOR JGO.PQT. MAZO NAIPES MUIACTHOR CENTIMETRO CUBICO UIACTANT TONELADA DECAMETRO CUBICO HECTOMETRO CUBICO KILOMETRO CUBICO MICROGRAMO NANOGRAMO PICOGRAMO MUIACTANT UIACTIG MILIGRAMO MILILITRO CURIE MILICURIE MICROCURIE U.INTER. ACT. HORMONAL MEGA U. INTER. ACT. HOR. KILOGRAMO BASE GRUESA MUIACTIG KILOGRAMO BRUTO PACK HORMA SEÑAS/ANTICIPOS OTRAS UNIDADES BONIFICACION