Variables de Anticipos

Introducción

Las variables de anticipos permiten trabajar dentro de una fórmula con anticipos o préstamos personales asociados al empleado en el contexto de cálculo.

En el sistema actual, los préstamos personales del manual anterior se gestionan mediante el flujo de anticipos. Por eso, las variables vigentes utilizan el prefijo @ANTICIPO*.

Estas variables pueden utilizarse para liquidar la entrega de un anticipo, consultar el estado del anticipo asociado o calcular el descuento de una cuota dentro de la Liquidación de Haberes.

Important

Algunas variables @ANTICIPO* no solo devuelven datos: también pueden seleccionar o reservar un anticipo dentro del contexto de cálculo. Deben utilizarse con especial cuidado.

Flujo general de anticipos

El cálculo de anticipos sigue una secuencia particular dentro de la liquidación.

De forma general, el flujo puede resumirse así:

Este flujo implica que algunas variables @ANTICIPO* participan en la selección del anticipo que luego quedará asociado al ítem de liquidación generado.

Si el ítem generado tiene valor distinto de 0, el sistema vincula el ítem con el anticipo correspondiente. Si el valor resulta 0, puede revertirse la reserva realizada durante el cálculo.

Variables disponibles

La tabla distingue el comportamiento funcional de cada variable: si solo consulta datos del anticipo activo o si puede seleccionar y reservar un anticipo durante el cálculo.

Variables de entrega

@ANTICIPOENTREGA

Tipo de dato: Numérico entero

Descripción:
Indica si existe un anticipo pendiente de entrega para el empleado.

Devuelve:

• 1: si existe un anticipo pendiente de entrega.
• 0: si no existe un anticipo pendiente de entrega.

Origen:
Anticipos asociados al legajo del empleado.

Ejemplo de uso:
if(@ANTICIPOENTREGA == 1, @ANTICIPOMONTOTOTAL, 0)

Conviene utilizarla como condición previa antes de consultar variables asociadas a la entrega del anticipo.

@ANTICIPOMONTOTOTAL

Tipo de dato: Numérico

Descripción:
Devuelve el monto total del anticipo pendiente de entrega.

Origen:
Anticipo asociado al empleado, campo de monto total.

Ejemplo de uso:
@ANTICIPOMONTOTOTAL

Consideraciones:
Esta variable también puede seleccionar y preparar el anticipo pendiente de entrega dentro del cálculo.

Se utiliza normalmente en Conceptos de Liquidación destinados a liquidar la entrega del anticipo.

Si el ítem de liquidación generado tiene valor distinto de 0, el sistema puede vincular el ítem con el anticipo correspondiente.

No debe confundirse con @ANTICIPODESCUENTO, que se utiliza para calcular el descuento de cuotas.

Variables de estado del anticipo

Estas variables dependen de que exista un anticipo activo en memoria. No buscan un anticipo por sí solas: requieren que otra variable lo haya seleccionado previamente dentro del mismo cálculo.

@ANTICIPOMONTOSALDADO

Tipo de dato: Numérico

Descripción:
Devuelve el monto ya descontado o saldado del anticipo activo.

Origen:
Anticipo seleccionado en memoria durante el cálculo.

Ejemplo de uso:
@ANTICIPOMONTOSALDADO

Consideraciones:
Depende de que previamente otra variable haya seleccionado un anticipo dentro del contexto de cálculo, como @ANTICIPOENTREGA, @ANTICIPOMONTOTOTAL o @ANTICIPODESCUENTO.

@ANTICIPOCANTIDADCUOTAS

Tipo de dato: Numérico entero

Descripción:
Devuelve la cantidad total de cuotas configuradas en el anticipo.

Origen:
Anticipo activo en el contexto del cálculo.

Ejemplo de uso:
@ANTICIPOCANTIDADCUOTAS

Consideraciones:
Puede tomar el anticipo de entrega o el anticipo de descuento, según el contexto que haya sido establecido previamente.

Si no existe un anticipo activo en memoria, devuelve 0.

@ANTICIPODESCRIPCION

Tipo de dato: Texto

Descripción:
Devuelve la descripción cargada en el anticipo activo.

Origen:
Anticipo seleccionado en memoria durante el cálculo.

Ejemplo de uso:
@ANTICIPODESCRIPCION

Consideraciones:
No busca un anticipo por sí sola. Debe existir un anticipo activo previamente seleccionado.

Si no existe un anticipo activo, puede devolver una cadena vacía.

@ANTICIPONROCUOTA

Tipo de dato: Numérico entero

Descripción:
Devuelve el conteo de ítems de liquidación asociados al anticipo activo.

Origen:
Ítems de liquidación asociados al anticipo.

Ejemplo de uso:
@ANTICIPONROCUOTA

Si no existe un anticipo activo, puede devolver 1.

Variable de descuento

@ANTICIPODESCUENTO

Tipo de dato: Numérico

Descripción:
Devuelve el monto de la cuota a descontar del anticipo en la liquidación actual.

Origen:
Anticipo activo del empleado, configurado para descontarse mediante el Concepto de Liquidación que se está evaluando.

Ejemplo de uso:
@ANTICIPODESCUENTO

Important

Esta variable no es solo informativa. Al invocarse, puede buscar un anticipo activo, preparar el cálculo del descuento y actualizar valores internos relacionados con el saldo.

Consideraciones:
Debe utilizarse en conceptos destinados al descuento de anticipos o préstamos personales.

Si la entrega del anticipo ocurre en la misma liquidación, puede devolver 0, ya que el sistema no descuenta el anticipo en la misma liquidación en la que se entrega.

Para que funcione correctamente, el anticipo debe estar asociado al concepto de liquidación correspondiente para el descuento.

No debe confundirse con @ANTICIPOMONTOTOTAL, que se utiliza para liquidar la entrega del anticipo.

Variables del manual no disponibles

@ENTREGAPRESTAMOPERSONAL

Estado: No disponible como variable directa.

Descripción:
En el manual anterior aparecía asociada a la entrega de préstamos personales.

Situación actual:
No se encuentra disponible como variable invocable en fórmulas de Liquidación de Haberes.

Alternativas relacionadas:

• @ANTICIPOENTREGA
• @ANTICIPOMONTOTOTAL

@DESCUENTOPRESTAMOPERSONAL

Estado: No disponible como variable directa.

Descripción:
En el manual anterior aparecía asociada al descuento de préstamos personales.

Situación actual:
No se encuentra disponible como variable invocable en fórmulas de Liquidación de Haberes.

Alternativa relacionada:

• @ANTICIPODESCUENTO

Consideraciones:
Para descontar cuotas de anticipos o préstamos personales, debe utilizarse la variable vigente @ANTICIPODESCUENTO, siempre que el anticipo esté correctamente configurado para descontarse mediante el concepto correspondiente.

Variables relacionadas documentadas en otras páginas

Consideraciones

Variables que seleccionan o reservan un anticipo:
@ANTICIPOENTREGA, @ANTICIPOMONTOTOTAL y @ANTICIPODESCUENTO pueden buscar, seleccionar o reservar anticipos durante la evaluación de la fórmula. Su uso incorrecto puede afectar el contexto de cálculo.

Variables que solo consultan el anticipo activo:
@ANTICIPOMONTOSALDADO, @ANTICIPOCANTIDADCUOTAS, @ANTICIPODESCRIPCION y @ANTICIPONROCUOTA dependen de que exista un anticipo activo en memoria. Si no hay anticipo activo, devuelven 0 o cadena vacía según el tipo.

Flujo de entrega:
Para liquidar la entrega de un anticipo, normalmente se utilizan @ANTICIPOENTREGA y @ANTICIPOMONTOTOTAL en el concepto correspondiente.

Flujo de descuento:
Para descontar cuotas de un anticipo, se utiliza @ANTICIPODESCUENTO en el concepto de descuento, que debe estar asociado al anticipo configurado.

Sobre ítems con valor 0:
Si una fórmula genera un ítem de liquidación con valor 0, puede revertirse la reserva realizada durante el cálculo.

Sobre el manual anterior:
El sistema no debe interpretar las variables antiguas de préstamos personales como variables válidas actuales. En esta documentación, el flujo se refiere exclusivamente a anticipos.

Reglas de escritura de fórmulas: 🟢02-operadores-y-sintaxis · Tipos de valores: 🟢01-tipos-de-dato · Variables de parámetros: 🟢variables-parametros-y-contexto · Variables de liquidación: 🟢variables-liquidacion · Variables de conceptos: 🟢variables-conceptos · Pendientes: 🟨pendientes-validacion