Fórmulas y conceptos de liquidación

Esta página sirve como punto de partida para implementar un convenio. Reúne el funcionamiento confirmado en YiQi y ejemplos de la configuración existente.

No copiar sin validar

El catálogo contiene fórmulas históricas y específicas de una empresa, con porcentajes, topes, importes, nombres de categorías y períodos embebidos. Debe revisarse concepto por concepto con el responsable de liquidación antes de utilizarse en otra empresa o período.

Catálogo disponible

El relevamiento adjunto contiene:

Convenio de referencia	Conceptos asociados
Comercio	67
Transporte	53
Construcción	43
Fuera de convenio	41
Pasantes	1

En total hay 170 registros de conceptos y 205 asociaciones concepto/convenio. Algunos códigos están repetidos, existen conceptos discontinuados y no todos los registros tienen fórmulas utilizables.

Descargar el catálogo de fórmulas y convenios (CSV)

El archivo conserva las fórmulas existentes y agrega una columna de estado para señalar registros que requieren revisión evidente. Su finalidad es comparar y seleccionar; no debe importarse directamente como una parametrización aprobada.

Cómo presentar la biblioteca durante una implementación

Recomendamos trabajar con tres niveles:

1. Catálogo completo: el CSV descargable, para buscar antecedentes por nombre, código, tipo o convenio.
2. Matriz del nuevo convenio: una selección de los conceptos que el cliente necesita, con responsable, vigencia y resultado esperado.
3. Ficha de concepto aprobada: definición funcional, fórmula de cantidad, fórmula de importe, dependencias, tipo, orden, marcas ARCA y casos de prueba.

Así se evita entregar una lista extensa como si todos los conceptos fueran aplicables y se conserva la trazabilidad de cada decisión.

Secuencia de evaluación

Para cada empleado, YiQi:

1. busca los conceptos asociados a su convenio;
2. los ordena por Orden;
3. evalúa Fórmula cantidad;
4. evalúa Fórmula importe, donde CANTIDAD contiene el resultado anterior;
5. acumula el importe según el Tipo;
6. deja el resultado disponible para conceptos posteriores mediante CON["Nombre"] y los totales acumulados.

Si cantidad o importe es cero, vacío o inválido, el concepto no se agrega al detalle.

Tipos de concepto

Código	Tipo	Efecto principal
R	Remunerativo	Suma al total remunerativo y al neto.
N	No remunerativo	Suma al total no remunerativo y al neto.
D	Descuento	Suma a deducciones y resta del neto.
C	Contribución	Suma al costo/contribuciones; no modifica el neto del empleado.
P	Puente	Uso técnico para encadenar cálculos. Debe configurarse con asistencia.

Las marcas de aportes y contribuciones son independientes del tipo y determinan las bases imponibles de las salidas de ARCA.

Variables disponibles

Liquidación

Variable	Contenido
TIPOLIQUIDACION	P, S, M, V, F o A.
MES, ANIO, DIA	Componentes del período.
DESDE, HASTA	Intervalo de la liquidación.
DIASANTIG	Diferencia en días desde el ingreso hasta el inicio de la liquidación.

Empleado y categoría

Variable	Ejemplos de uso
empleado	Sueldo base, antigüedad, ingreso, egreso, condición, adicionales u otros atributos.
CAT	CAT.REMUNERACION y CAT.NOMBRE.
CONV	Datos del convenio.
OS	Nombre de la obra social, cuando está informada.

Novedades

El objeto nov expone los campos de la novedad, por ejemplo:

• nov.DIAS_TRABAJADOS;
• nov.HS_EXTRAS_50 y nov.HS_EXTRAS_100;
• nov.DIAS_VACACIONES;
• nov.DIAS_LICENCIA_INC;
• nov.DIAS_INAN_INJUS;
• nov.AJUSTE_REMUNERATIVO;
• nov.AJUSTE_NO_REMUNERATI;
• nov.DESCUENTO_ANTICIPO.

Resultados anteriores

Variable	Contenido disponible hasta el orden actual
CON["Nombre"]	Importe de un concepto calculado previamente.
TOTALREMUN	Total remunerativo acumulado.
TOTALNOREMUN	Total no remunerativo acumulado.
TOTALDEDUC	Total de deducciones acumulado.

Use CON["Nombre"] || 0 cuando el concepto anterior pueda no existir o resultar en cero.

Funciones de consulta histórica

El motor incluye funciones para fórmulas avanzadas:

Función	Uso
LIQ_SUEL_X_EMPLEADO.MAXIMOPERIODO(...)	Mayor suma mensual de determinados conceptos dentro de una cantidad de períodos anteriores. Se usa en SAC y liquidaciones finales.
LIQ_SUEL_X_EMPLEADO.MAXIMO(...)	Consulta un máximo del período anterior para conceptos determinados.
LIQ_SUEL_X_EMPLEADO.MINPERIODO(...)	Menor suma mensual de los conceptos indicados.
LIQ_SUEL_X_EMPLEADO.SUM(...)	Suma histórica de conceptos de un empleado.
LIQ_SUEL_X_EMPLEADO.DIASLICENCIA(...)	Días de una licencia determinada que se superponen con un intervalo.
LIQ_SUEL_X_EMPLEADO.DifEnDias(...)	Diferencia entre dos fechas.
LIQ_SUEL_X_EMPLEADO.NETO_TABLA_SUELDO(...)	Recupera un valor del historial de sueldos.

Estas funciones requieren una prueba con historia real del empleado; un caso aislado sin períodos anteriores puede devolver vacío.

Patrones de referencia

Los siguientes patrones muestran la intención funcional. Ajuste nombres, porcentajes, bases y condiciones.

Sueldo mensual por días trabajados

Cantidad:

nov.DIAS_TRABAJADOS

Importe recomendado:

((empleado.SUELDO_BASE || CAT.REMUNERACION) / 30) * CANTIDAD

Antigüedad en años completos

Cantidad:

if (TIPOLIQUIDACION == "M" || TIPOLIQUIDACION == "F") {
  Math.floor(empleado.ANTIGUEDAD / 12)
}

Importe de referencia:

(
  ((empleado.SUELDO_BASE || CAT.REMUNERACION) / 30) * nov.DIAS_TRABAJADOS
  + (CON["INASISTENCIA JUSTIFICADA ENFERMEDAD"] || 0)
) * CANTIDAD / 100

En este ejemplo CANTIDAD representa años y cada año equivale al 1 %. Si el convenio establece otro porcentaje, debe incorporarse explícitamente y documentarse.

Horas extras al 50 %

Cantidad:

nov.HS_EXTRAS_50

Importe de referencia:

CANTIDAD * base_mensual / divisor_horas * 1.5

Defina qué conceptos componen base_mensual y cuál es el divisor aplicable al convenio.

Importe variable ingresado como novedad

// Cantidad
1

// Importe remunerativo
CANTIDAD * nov.AJUSTE_REMUNERATIVO

Deducción porcentual con tope

if (TOTALREMUN >= TOPE) {
  TOPE * CANTIDAD / 100
} else {
  TOTALREMUN * CANTIDAD / 100
}

El porcentaje puede devolverse en la fórmula de cantidad. El tope no debería quedar oculto en la fórmula sin vigencia ni fuente documentada.

Contribución sobre remunerativos y no remunerativos alcanzados

(TOTALREMUN + TOTALNOREMUN) * CANTIDAD / 100

No todos los conceptos no remunerativos integran todas las bases. Antes de usar este patrón, confirme las marcas y el alcance normativo.

Cómo definir el orden

El motor sólo exige un número ascendente; la siguiente escala facilita la lectura:

Rango sugerido	Grupo
1–999	Haberes remunerativos, licencias y adicionales.
1000–1999	Importes no remunerativos y ajustes.
2000–2999	Deducciones y retenciones.
3000–3999	Contribuciones patronales.

Dentro de cada grupo, ubique primero las bases y luego los conceptos que las consultan. Por ejemplo, sueldo → antigüedad → presentismo → deducciones → contribuciones.

Ficha recomendada para aprobar un concepto

Antes de habilitarlo, documente:

• propósito y convenio;
• vigencia desde/hasta;
• tipo y efecto en el neto;
• fórmula de cantidad e importe;
• variables de novedad utilizadas;
• conceptos de los que depende;
• orden;
• tratamiento ARCA y bases imponibles;
• ejemplo numérico;
• casos de cero y excepciones;
• responsable que validó el resultado.

Controles mínimos

• No repetir código ni nombre funcional.
• No referenciar un concepto con un orden posterior.
• Probar valores cero, ingreso, egreso y mes parcial.
• Probar topes por debajo, igual y por encima del límite.
• Probar empleados jubilados u otras condiciones excluyentes cuando corresponda.
• Probar ausencia del concepto referenciado.
• Comparar neto, contribuciones y bases imponibles.
• Registrar la fecha y el motivo de cada cambio.