Formulas Liquidacion

Propósito

Esta documentación explica el lenguaje de fórmulas utilizado en el módulo Liquidación de Haberes.

Las fórmulas permiten definir cómo se calculan valores dentro del sistema combinando variables, funciones, operadores y valores fijos. A través de ellas es posible obtener datos del empleado, de la liquidación, de horas trabajadas, novedades, conceptos liquidados, parámetros del sistema y centros de costo.

El objetivo es que usuarios funcionales, soporte, implementación y administración puedan comprender cómo se construyen, interpretan y mantienen estas fórmulas. La documentación explica los componentes del lenguaje sin describir individualmente todos los conceptos de liquidación existentes.

Alcance

Esta documentación abarca:

• Elementos del lenguaje: variables, funciones, operadores, tipos de dato y sintaxis
• Contextos de uso: Liquidación de Haberes, exportaciones, reportes personalizados, S.I.C.O.S.S. y Libro de Sueldos Digital
• Ejemplos orientativos: casos de uso que muestran cómo se combinan los elementos en fórmulas reales

No documenta individualmente todos los conceptos de liquidación existentes, sino los componentes que permiten entenderlos.

Importante: esta documentación no reemplaza la validación funcional dentro del sistema. Las variables, funciones y comportamientos se documentan solo cuando están confirmados. Si algo no está validado, se registra como pendiente de revisión.

Dónde se utilizan las fórmulas

Las fórmulas aparecen en distintos puntos del sistema donde es necesario obtener, calcular, transformar o validar valores.

Contexto principal: la configuración de Conceptos de Liquidación, donde se utilizan en campos como:

• Factor Multiplicador
• Base Imponible
• Fórmula por Defecto
• Variable 1 y Variable 2
• Fórmulas del Convenio

Otros contextos: reportes, exportaciones, formatos personalizados, S.I.C.O.S.S., Libro de Sueldos Digital y procesos específicos que requieren datos del empleado, liquidación, conceptos liquidados, horas, novedades o parámetros.

Dentro de esta documentación, las variables y funciones de S.I.C.O.S.S. y Libro de Sueldos Digital se tratan como contextos de uso del lenguaje de fórmulas, no como módulos separados.

Para entender cómo se aplican las fórmulas en un Concepto de Liquidación, consultar 03-formulas-en-concepto-liquidacion.

Organización de esta documentación

La documentación se divide en páginas y carpetas para facilitar consulta, mantenimiento e incorporación progresiva de información.

Páginas iniciales:

• 01-tipos-de-dato — Tipos de valores que devuelven variables y funciones
• 02-operadores-y-sintaxis — Reglas para escribir fórmulas
• 03-formulas-en-concepto-liquidacion — Aplicación de fórmulas en Conceptos de Liquidación

Carpeta variables/ — Variables agrupadas por contexto (empleado, liquidación, conceptos, parámetros, horas, novedades, anticipos, embargos)

Carpeta funciones/ — Funciones agrupadas por tipo (texto, numéricas, fechas, lógicas, conceptos liquidados, centro de costo, etc.)

Carpeta ejemplos/ — Casos de uso que muestran cómo combinar variables, funciones y operadores en fórmulas reales

04-glosario — Definiciones de términos clave (variable, función, operador, fórmula, tipo de dato, sintaxis, S.I.C.O.S.S., Libro de Sueldos Digital)

pendientes-validacion — Registro central de dudas, comportamientos no confirmados y elementos pendientes de revisión

Conceptos básicos

Para interpretar una fórmula es importante reconocer sus elementos componentes.

Variables

Una variable representa un valor que obtiene el sistema desde un contexto determinado (empleado, liquidación, horas, novedades, conceptos liquidados, parámetros, etc.).

Se utilizan para tomar datos ya disponibles en el sistema y aplicarlos dentro de una fórmula.

Ejemplo:

@HORASNORMALES

Funciones

Una función es una operación que recibe parámetros y devuelve un resultado. Permiten realizar cálculos, sumar importes, obtener datos de un período, consultar novedades, trabajar con fechas, transformar textos o aplicar reglas específicas del sistema.

Ejemplo:

SUMCONCEPTO(@FEINICIAL, @FEFINAL, '500')

Operadores

Un operador es un símbolo que combina valores dentro de una fórmula. Se utilizan para sumar, restar, multiplicar, dividir, agrupar expresiones o comparar valores.

Ejemplo:

@HORASNORMALES * @VALORHORA

Fórmulas

Una fórmula es una expresión que combina variables, funciones, operadores y valores fijos para obtener un resultado. Ese resultado puede utilizarse para calcular un concepto de liquidación, definir una base imponible, determinar un factor multiplicador, construir una referencia, validar una condición o completar un dato requerido.

Ejemplo:

@BASIMP * @FACTMULT * @VAR2

Criterio de validación

La documentación diferencia claramente la información confirmada de aquella que requiere revisión.

Una variable, función, regla o comportamiento se documenta como funcionamiento real solo cuando:

• Ha sido validado en el sistema
• Está confirmado por un referente funcional
• Está respaldado por documentación vigente

La información de documentación anterior, manuales viejos o relevamientos incompletos debe revisarse antes de incorporarse como definición final.

Aplica especialmente a:

• Variables cuyo origen no está confirmado
• Funciones con parámetros incompletos o ambiguos
• Comportamientos que varían según contexto de uso
• Fórmulas de S.I.C.O.S.S., Libro de Sueldos Digital o reportes personalizados
• Reglas de negocio con impacto en liquidación, aportes, contribuciones o cálculos legales

Las dudas y puntos no confirmados se registran en pendientes-validacion, evitando documentar supuestos como reglas del sistema.

Uso futuro como base de conocimiento

Esta documentación está pensada para ser consultada por usuarios propios y externos de la empresa que necesiten comprender cómo funcionan las fórmulas dentro del sistema.

Además, su estructura facilita la reutilización futura como base de conocimiento para asistentes de inteligencia artificial o sistemas RAG. Para eso:

• Las variables, funciones, operadores y reglas se organizan de forma consistente
• Se utilizan nombres claros y categorías definidas
• Se establecen relaciones entre páginas mediante enlaces internos

Una herramienta de asistencia podrá utilizar esta información para:

• Explicar fórmulas existentes en lenguaje simple
• Identificar variables y funciones que intervienen en una fórmula
• Orientar sobre qué elementos utilizar para resolver un cálculo
• Detectar información pendiente o no validada
• Evitar respuestas basadas en supuestos no documentados

La prioridad permanece siendo la claridad funcional y la validación del comportamiento real del sistema.

Pendientes generales

Durante el relevamiento pueden aparecer variables, funciones, reglas o comportamientos no completamente confirmados. Estos elementos se registran en pendientes-validacion para su revisión posterior y no se documentan como funcionamiento definitivo hasta estar validados.

Ejemplos de pendientes a relevar:

• Variables o funciones sin descripción confirmada
• Diferencias entre funciones similares o variantes con sufijos como CC, T, SLA o CODS
• Variables y funciones de contextos específicos (S.I.C.O.S.S., Libro de Sueldos Digital, reportes)
• Comportamiento exacto de fórmulas informativas
• Reglas de centro de costo, novedades, ganancias, aportes o contribuciones
• Ejemplos de fórmulas que requieran validación funcional

La página pendientes-validacion es el registro central de dudas y evita que la documentación principal incorpore información no confirmada.

Mapa de navegación

A continuación se muestra una vista automática de todas las notas disponibles en esta documentación: