Especificación Técnica CAEs y Rangos CAE
CAE y Rangos
El CAE es la autorización otorgada por DGI para emitir un tipo de CFE. Cada CAE contiene:
• Tipo de comprobante
• Serie
• Rango completo autorizado (NúmeroDesde / NúmeroHasta)
• Fecha de vencimiento
• Estado y datos de la empresa
El CAE pertenece a la empresa y, en esta etapa, no está asignado a ninguna sucursal ni a
ningún punto de emisión.
Rango CAE
El Rango CAE representa un sub-tramo extraído de un CAE.
Se asigna a una sucursal y/o punto de emisión. Cada rango almacena:
• Desde / Hasta
• Folios disponibles
• Folios usados
• Si está agotado
• Fecha de creación y origen
Los rangos se generan a demanda: cuando un punto necesita numeración, el sistema
toma un CAE disponible y extrae un tramo del tamaño definido en la configuración.
Qué significa el número configurado en “Rangos CAE”
Los inputs de esta sección definen la cantidad de folios por tramo que se entregará a cada
sucursal o punto.
Ese valor puede configurarse en tres niveles:
1. Punto de emisión
2. Sucursal
3. Empresa
Cuando el sistema necesita numeración:
1. Busca el primer valor distinto de cero en este orden:
Punto → Sucursal → Empresa
2. Ese número determina:
o Cuántos folios se recortan del CAE para generar un nuevo Rango CAE
o El stock mínimo de folios que debe mantener ese punto
Ejemplos operativos
Diferencia entre usar 1 o 10
Valor 1
• Cada reserva crea un rango de solo un folio.
• Se generan muchas reservas pequeñas.
• Aumenta la cantidad de escrituras en la base (más rangos).
• Mayor probabilidad de que la terminal se quede sin numeración ante fallas de red.
• Útil solo para pruebas o ambientes controlados.
Valor 10
• Cada reserva entrega un bloque de 10 folios.
• El punto mantiene 10 números listos para emitir.
• Menos operaciones de reserva → menos carga y menor concurrencia sobre los CAE.
• Reduce el riesgo de quedarse sin numeración durante el uso diario.
Implicancias en otras funcionalidades
Si se deja en 0
• No existe stock mínimo.
• No se hacen reservas automáticas.
• La empresa no podrá emitir el tipo de CFE aunque tenga un CAE cargado al
sistema.
Valores bajos
• Producen muchos rangos pequeños.
• La tabla de rangos crece rápido.
• Aumenta la operación concurrente sobre CAE.
• El job de monitoreo puede disparar alertas frecuentes por disponibilidad.
Valores adecuados a la emision
• Cada punto tiene un stock generoso de numeración.
• Los módulos masivos (importaciones, APIs, envíos de lote) casi nunca deben esperar una reserva.
• Se reducen alertas por falta de numeración.
• Se inmovilizan más folios en cada sucursal/punto.
Resumen
El número de “Rangos CAE” no es un identificador.
Es la cantidad de folios por tramo y el mínimo garantizado que cada punto tendrá para emitir.
Elegir 1, 10 o cualquier otro valor define:
• Tamaño del bloque asignado
• Frecuencia de reservas
• Robustez frente a fallas de conectividad
• Carga en base de datos
• Fluidez en emisiones masivas
Firma Offline
El módulo permite que integraciones externas reserven numeración y firmen CFE offline,
sin depender del módulo de emisión principal.
Flujo:
1. 2. 3. 4. El sistema reserva un tramo de folios para uso offline.
Ese tramo queda bloqueado para el motor interno (no puede usarlo).
El integrador genera y firma los CFE con esos números.
El servidor solo aceptará XML cuya numeración esté dentro del rango reservado offline.
Responsabilidades del integrador:
• Controlar continuidad numérica
• Evitar saltos o números duplicados
• Manejar reintentos y sincronización
• Garantizar que consume únicamente los folios asignados
Recomendaciones para la configuración de Rangos CAE
La correcta configuración del tamaño de los Rangos CAE influye directamente en la estabilidad del sistema, la continuidad numérica y la capacidad de cada punto de emisión para operar sin interrupciones. A continuación se presentan recomendaciones generales basadas en buenas prácticas operativas:
1. Usar un valor equivalente al 10% del CAE principal
Como regla general, se recomienda que cada tramo que se asigna a una sucursal o punto de emisión corresponda aproximadamente al 10% de la longitud total del CAE autorizado.
Ejemplo:
• CAE: 1000 → 1999 (1000 folios).
• 10% = 100 folios.
• Recomendación: configurar Rangos CAE en 100.
Esto proporciona un equilibrio óptimo entre:
• Suficiente numeración local para evitar bloqueos.
• No inmovilizar folios en exceso.
• Reducir la frecuencia de reservas.
2. Ajustar el tamaño según la cantidad y el ritmo de emisión
Además del 10%, se recomienda ajustar el valor considerando el uso real:
Bajo volumen (< 200 comprobantes por mes)
• Rango recomendado: 20–50 folios.
Volumen medio (200–2.000 por mes)
• Rango recomendado: 50–150 folios.
Volumen alto (> 2.000 por mes o integraciones API intensivas)
• Rango recomendado: 100–300 folios.
• En APIs de e-commerce o marketplaces, preferir valores altos para evitar bloqueos en horas pico.
3. Evitar valores muy bajos (1, 5)
Valores demasiado pequeños generan efectos negativos:
• Aumentan exponencialmente la cantidad de reservas.
• Incrementan la concurrencia en la tabla de CAE y en la tabla de Rangos CAE.
• Producen alertas prematuras de “falta de numeración”.
• Incrementan la probabilidad de quedarse sin folios en un pico de emisión.
Regla:
Evitar valores menores a 10, salvo entornos de prueba o empresas con nula o reducidad emision (<= 1 por mes).
4. Evitar el 0 salvo casos muy particulares
Configurar 0 implica que:
• No hay stock mínimo.
• No hay reservas automáticas.
• La empresa no puede emitir un CFE del tipo aunque exista CAE cargado