📘 Manual de Ingeniería de Fórmulas y Configuración: El Motor de e-Sueldos

1. Introducción: Lógica Abierta y Niveles de Personalización

e-Sueldos se diferencia de otros sistemas por su arquitectura de Lógica Abierta. No es una "caja negra"; es un motor transparente que permite al liquidador auditar y modificar cada cálculo.

Aunque el sistema trae pre-configurados los convenios estándar (Comercio, UOCRA, etc.), su potencia radica en la capacidad de personalizar la liquidación. Para ello, debemos entender los 3 Niveles de Configuración:

1. Configuración Máster (Sistema): Son las fórmulas y convenios base que mantiene e-Sueldos (ej. actualizaciones generales de Ganancias o MOPRE).
2. Configuración por Cuenta/Estudio: Ajustes que aplican a todas las empresas de un mismo estudio contable o holding.
3. Configuración por Empresa (Cliente): La personalización final. Aquí creas los conceptos específicos para una empresa (ej. "Bono Productividad Sucursal Centro").

2. La Cadena Lógica: Legajo - Convenio - Categoría

Antes de calcular, el sistema debe saber "cuánto debe cobrar" la persona. Aquí es crítico diferenciar la estrategia según el tipo de contratación:

A. El Flujo del Empleado de Convenio (La Norma)

En la mayoría de los casos (ej. Comercio 130/75), el sueldo NO está escrito en el legajo del empleado. El sistema lo busca dinámicamente siguiendo esta ruta:

1. Legajo: Define el Convenio (L[1]) y la Categoría (L[8]).
2. Convenio: El sistema va a la tabla de Escalas Salariales del convenio.
3. Escala: Cruza Categoría + Periodo y obtiene el Básico.

⚠️ Regla de Oro para Liquidadores: Cuando sale una nueva paritaria, NUNCA edites los legajos uno por uno. Solo debes actualizar la Escala Salarial en la configuración del Convenio. El sistema actualizará automáticamente los sueldos de todos los empleados de esa categoría.

B. El Flujo del Fuera de Convenio (La Excepción)

Para personal jerárquico o sin convenio:

1. Legajo: Se utiliza el campo "Sueldo Pactado" o "A cuenta de futuros aumentos".
2. Actualización: En este caso, para dar un aumento, SÍ debes actualizar el importe en la ficha del empleado o mediante una importación masiva de legajos.

3. Los 5 Módulos del Motor de Cálculo

Módulo 1: Convenios (El Marco Legal)

No es solo un título. El Convenio actúa como un "activador masivo".

• Permite que convivan fórmulas de Jornalizados (UOCRA) con Mensualizados (Comercio) en la misma liquidación.
• Determina qué Escalas Salariales están disponibles para el legajo.

Módulo 2: Variables de Legajo L[...]

Es el ADN del empleado. Son datos estáticos o semi-estáticos.

• Identificadores: Fecha de Ingreso (L[18]), Obra Social (L[5]).
• Variables de Cálculo: Se usan para personalizar fórmulas (ej. L[350] Coeficiente de Jornada).

Módulo 3: Novedades (El Input del Período)

Son los datos que varían mes a mes. El sistema distingue dos tipos de novedades para procesarlas distinto:

1. Novedades por Cantidad N[]:

• El usuario informa unidades (horas, días, kilómetros).
• La Fórmula: Debe ponerle precio (Cantidad x Precio Unitario).

2. Novedades por Importe I[]:

• El usuario informa dinero directo (ej. "Comisión Ventas $150.000").
• La Fórmula: Pasa el valor directo al recibo, sumando o restando.

Módulo 4: Cálculos Auxiliares A[...] (Estrategias de Cálculo)

Los Auxiliares son la herramienta más potente para el liquidador avanzado. No se imprimen en el recibo, pero son el cerebro detrás del cálculo. Se usan con 3 estrategias:

1. Estrategia de Constantes: Guardar valores fijos legales (SMVM, Topes). Si cambia la ley, tocas un solo Auxiliar y se arreglan 500 legajos.
2. Estrategia de Factorización (Excel Style): Si tienes una lógica compleja (ej. un cálculo de antigüedad con tramos), la escribes una sola vez en un Auxiliar. Luego, todos los conceptos invocan a ese Auxiliar.
3. Estrategia de Invocación de Acumuladores: Un auxiliar tiene la capacidad especial de leer el estado de un Acumulador (ej. "Total Remunerativo") para aplicar lógicas de topes o deducciones sobre la suma total de haberes.

Módulo 5: Acumuladores (La Base Imponible)

Son "bolsas" invisibles que agrupan valores.

• Función Vital: Determinan la base para el F.931 (AFIP) y Ganancias.
• Configuración: Cada vez que creas un Haber Remunerativo, es tu obligación vincularlo al acumulador "Total Haberes Sujetos".

4. Anatomía de los Conceptos y Fórmulas

El Concepto es el ítem que finalmente aparece (o impacta) en el recibo.

Tipos de Conceptos (Naturaleza Contable)

1. Haberes Remunerativos: Suman al Bruto. Pagan aportes y contribuciones. (Signo +)
2. Haberes No Remunerativos: Suman al Neto. Generalmente exentos de cargas sociales (salvo excepciones como Obra Social en algunos acuerdos). (Signo +)
3. Descuentos (Retenciones): Restan al empleado (Jubilación, Ley 19032, Sindicato). (Signo -)
4. Contribuciones Patronales: Costo empresa. No se ven en el recibo del empleado, pero el sistema las calcula para el reporte de costos y F.931.
5. Totales / Estadísticos: Conceptos informativos (ej. "Base Imponible Ganancias") que no suman al pago.

Estructura de la Fórmula

Todo concepto se compone de 4 elementos lógicos que debes configurar:

1. Condición (El "Gatillo"):

• Prueba lógica (Verdadero/Falso). Si no se cumple, el concepto sale en 0 o no aparece.
• Ej: N[5] > 0 (¿Tiene Horas Extras cargadas?).

2. Fórmula del Importe (El "Cálculo"):

• La ecuación algebraica que define el dinero.
• Ej: (L[10] / 200) * 1.5 * N[5].

3. Fórmula de la Unidad (El "Dato"):

• Define qué número sale en la columna "Unidades" del recibo (ej. "30" días, "12" horas).
• Ej: En horas extras, la fórmula de unidad es simplemente N[5].

4. Totaliza:

• Define a qué columna del recibo va el importe (Remunerativo, No Remunerativo o Deducción).

5. Ingeniería de Fórmulas: El Álgebra del Sistema

Para "hablar" con el motor, utilizamos una sintaxis matemática estándar.

Diccionario de Términos

Operadores Permitidos

• Matemáticos: + (Suma), - (Resta), * (Multiplicar), / (Dividir).
• Lógicos (Para condiciones y Auxiliares):
• == (Igual a)
• != (Distinto de)
• >, <, >=, <= (Mayor, Menor, etc.)
• && (Y - Ambas condiciones verdaderas)
• || (O - Alguna condición verdadera)

Ejemplo de "Lectura" de Fórmula

Concepto: Horas Extras al 50% en Comercio

Fórmula: ( ( L[10] / 200 ) * 1.5 ) * N[5]

1. L[10]: El sistema busca el Básico según la escala vigente.
2. / 200: Lo divide por el divisor fijo de convenio (Auxiliar implícito o número fijo) para obtener el valor hora.
3. * 1.5: Le aplica el recargo del 50%.

• N[5]: Lo multiplica por la Cantidad de horas informadas en la noved

Actualizado el: 17/12/2025