> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://e-sueldos.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 📘 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**:

![](https://storage.crisp.chat/users/helpdesk/website/-/3/b/5/d/3b5dfa844c31c000/image_1690y2a.png)


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**
| **Término** | **Significado** | **Origen del Dato** |
| **L[ n ]** | Variable de Legajo | Ficha del Empleado |
| **N[ n ]** | Novedad Cantidad | Carga de Novedades |
| **I[ n ]** | Novedad Importe | Carga de Novedades (Dinero) |
| **A[ n ]** | Auxiliar | Tabla de Auxiliares |
| **R[ n ]** | Resultado Concepto | Valor ya calculado de otro concepto |
### **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