Fórmulas en Concepto de Liquidación

Introducción

La pantalla Concepto de Liquidación permite configurar distintas fórmulas asociadas al cálculo y comportamiento de un concepto dentro del proceso de liquidación.

Un concepto no se calcula a partir de una única expresión aislada, sino mediante una secuencia de campos que pueden intervenir en distintas etapas del cálculo. Entre ellos se encuentran:

• Factor Multiplicador
• Base Imponible
• Fórmula principal del importe
• Variables auxiliares
• Fecha de Aplicación
• Referencia por fórmula
• Fórmula Concepto Informativo (en casos específicos)

Esta página explica cómo se relacionan esos campos dentro del cálculo del concepto, qué resultado espera cada uno y qué variables internas permiten reutilizar valores calculados previamente.

La explicación se enfoca en el uso de fórmulas dentro de un Concepto de Liquidación. Para las reglas generales de escritura, consulta 🟢Operadores y Sintaxis. Para entender los tipos de valores, consulta 🟢Tipos de Dato.

Pipeline de cálculo del concepto

El cálculo de un concepto sigue una secuencia lógica. Cada etapa puede depender de valores calculados previamente o de fórmulas configuradas en el propio concepto.

Orden de evaluación

De forma general, el sistema evalúa el concepto siguiendo este orden:

Puntos críticos

Fórmula principal

La fórmula principal del importe puede provenir de:

• Fórmula por Defecto (general para el concepto)
• Fórmula del Convenio (específica según el convenio del empleado)

El sistema utiliza la fórmula específica si existe; en caso contrario, utiliza la fórmula general.

Variables auxiliares

Las fórmulas auxiliares (Variable 1 y Variable 2) se calculan solo cuando son invocadas por otros campos mediante @VAR1 o @VAR2. Si no se utilizan, no intervienen en el cálculo.

Campos de fórmula

La configuración del concepto incluye distintos campos que pueden contener fórmulas.

Cada campo cumple una función específica dentro del cálculo y puede ser utilizado por otros campos mediante variables internas del concepto.

Factor Multiplicador

El **Factor Multiplicador** permite definir una fórmula numérica previa al cálculo del importe del concepto.

Este campo puede representar:

• Unidades o cantidades
• Días u horas
• Porcentajes o alícuotas
• Cualquier factor necesario para el cálculo

El resultado queda disponible para otras fórmulas mediante la variable @FACTMULT.

Ejemplo: @HORASNORMALES (toma la cantidad de horas normales liquidadas)

Base Imponible

La **Base Imponible** permite definir una fórmula numérica que representa la base de cálculo del concepto.

El resultado queda disponible para otras fórmulas mediante la variable @BASIMP.

Ejemplo: @VALORHORA (toma el valor hora del empleado)

Fórmula principal del importe

La **fórmula principal** del importe es la expresión utilizada para calcular el valor liquidado del concepto.

Esta fórmula puede utilizar variables calculadas en etapas previas:

Ejemplo: @BASIMP * @FACTMULT (multiplica base imponible por factor multiplicador)

La fórmula principal proviene de:

• Fórmula por Defecto (general)
• Fórmula del Convenio (si existe para el convenio del empleado)

Fórmula por Defecto

La **Fórmula por Defecto** es la fórmula general del concepto.

Se utiliza para calcular el importe cuando no existe una fórmula específica aplicable para el convenio del empleado.

Si existe una Fórmula del Convenio para el convenio correspondiente, el sistema utiliza esa en su lugar.

Ejemplo: @BASIMP * @FACTMULT

Fórmulas del Convenio

Las **Fórmulas del Convenio** permiten definir fórmulas específicas para determinados convenios.

Se utilizan cuando el cálculo del importe de un concepto varía según el convenio del empleado.

Qué reemplazan:

• ✓ Fórmula principal del importe

Qué NO reemplazan:

• ✗ Factor Multiplicador
• ✗ Base Imponible
• ✗ Variables auxiliares

Ejemplo: Un concepto tiene una fórmula general para la mayoría de los convenios, pero un convenio específico requiere un cálculo distinto. Se configura una fórmula exclusiva para ese convenio.

Variables auxiliares

**Variable 1** y **Variable 2** permiten definir fórmulas auxiliares dentro del concepto.

Para qué sirven:

• Separar cálculos intermedios
• Evitar repetir expresiones extensas
• Facilitar la lectura de la fórmula principal

Disponibilidad:

• @VAR1: resultado de Variable 1
• @VAR2: resultado de Variable 2

Ejemplo: @BASIMP * @VAR1 (utiliza la base imponible junto con el resultado de Variable 1)

Uso especial con #X

En determinados casos, Variable 1 o Variable 2 pueden contener la referencia #X.

Esta referencia se utiliza en fórmulas que deben evaluarse por obra o por centro de costo, permitiendo reemplazar #X por el valor correspondiente durante el cálculo.

Se utiliza junto con funciones específicas que procesan la fórmula de la variable para cada obra, centro de costo o zona involucrada.

Fecha Aplicación

La **Fecha Aplicación** permite definir la fecha que el sistema debe asociar al importe liquidado del concepto.

Comportamiento:

• Si no se configura una fórmula, el sistema usa la fecha de fin de la liquidación
• Se utiliza en procesos que analizan importes según el período al que corresponden
• Ejemplos: cálculos de máxima remuneración, totales por mes de aplicación

Tipo esperado: Debe devolver un valor de tipo fecha

Ejemplo: @FEFINAL (usa la fecha final de la liquidación)

Referencia por fórmula

La **Referencia por fórmula** permite construir de forma dinámica la descripción o referencia del ítem generado.

Cuando está activada, el sistema utiliza la fórmula configurada para definir la descripción que aparecerá en:

• Ítems de liquidación
• Recibos de sueldo
• Reportes relacionados

Permite incorporar datos variables: obra social, centro de costo, período, y otros valores disponibles en el contexto de la liquidación.

Tipo esperado: Texto

Ejemplo: @DESCRIPCION (utiliza la descripción del concepto)

Fórmula Concepto Informativo

La **Fórmula Concepto Informativo** permite calcular importes informativos dentro de una liquidación normal.

Propósito:
Se utiliza principalmente para conceptos asociados a:

• Contribuciones patronales
• Provisiones
• Otras contribuciones del empleador

Los importes se calculan y muestran como información complementaria, pero no modifican el neto a cobrar del empleado.

Procesamiento:
El concepto se procesa como ítem informativo. El sistema:

1. Calcula el Factor Multiplicador
2. Utiliza la Fórmula Concepto Informativo para obtener el importe a informar

Ejemplo típico: @TOTHA * @FACTMULT / 100

• ✓ Fórmula principal válida

• ✓ Fórmula informativa válida

• ✓ Factor Multiplicador distinto de 0

Variables internas del concepto

Dentro de las fórmulas de un concepto pueden utilizarse variables internas que representan:

• Valores propios de la configuración del concepto
• Resultados calculados en etapas previas

Permiten reutilizar información sin repetir fórmulas completas.

Tabla de variables internas

Resolución de contexto

Estas variables se resuelven dentro del contexto del concepto que se está calculando. Su valor puede variar según:

• Configuración del concepto
• Datos del empleado
• Período de liquidación
• Convenio del empleado
• Horas trabajadas
• Novedades registradas
• Otros datos disponibles en el momento del cálculo

Ejemplo de uso

@BASIMP * @FACTMULT

En este ejemplo, la fórmula utiliza la base imponible calculada y el factor multiplicador calculado para obtener el importe del concepto.

Ejemplo con variables auxiliares

@BASIMP * @VAR1

En este caso, la fórmula utiliza el resultado de Variable 1 como parte del cálculo del importe.

Condiciones en las que el concepto no genera ítem

Existen situaciones en las que el concepto no genera un ítem dentro de la liquidación.

Condiciones de no generación

Propósito

Estas condiciones evitan la generación de ítems sin valor o sin fórmula aplicable, manteniendo la liquidación limpia y funcional.

Testear fórmulas

La opción Testear Fórmulas permite validar las fórmulas configuradas en el concepto.

El sistema intenta evaluar las fórmulas con un contexto mínimo para detectar:

• Errores de escritura
• Problemas de sintaxis
• Referencias no válidas

Fórmulas validadas

• Factor Multiplicador
• Base Imponible
• Fórmula por Defecto
• Variable 1 y Variable 2
• Referencia por fórmula
• Fecha Aplicación

Limitaciones

• ✗ No valida fórmulas específicas por convenio

• ✗ No valida Fórmula Concepto Informativo

• ✗ No verifica que el resultado corresponda a la regla de negocio

Consideraciones clave

Integración de campos:

• Las fórmulas en un concepto son partes de un mismo proceso de cálculo
• El Factor Multiplicador, Base Imponible, variables auxiliares y fórmula principal pueden depender entre sí mediante @FACTMULT, @BASIMP, @VAR1 y @VAR2

Factor Multiplicador:

• Revisar con especial atención: si devuelve 0, el concepto no continúa su cálculo
• Es la etapa crítica que determina si el concepto se procesa

Fórmula por Defecto:

• Funciona como fórmula general del concepto
• Solo se usa si no existe fórmula específica para el convenio del empleado

Fórmulas del Convenio:

• Reemplazan únicamente la fórmula principal del importe
• No reemplazan: Factor Multiplicador, Base Imponible, variables auxiliares

Otros campos:

• **Fecha Aplicación**: asocia el importe a una fecha específica; afecta procesos que consultan por período
• **Referencia por fórmula**: modifica la descripción del ítem, no el importe
• **Fórmula Concepto Informativo**: calcula importes informativos sin afectar el neto

Validación:

• Cuando modifiques una fórmula, valida tanto sintaxis como resultado funcional en una liquidación de prueba
• Utiliza "Testear Fórmulas" como herramienta de validación inicial, no como validación final

Referencias adicionales:

• Reglas de escritura: 🟢Operadores y Sintaxis
• Tipos de valor: 🟢Tipos de Dato.
• Definiciones: 🟢Glosario de Términos