Variables-Conceptos
Variables de conceptos
Las variables de conceptos permiten acceder dentro de una fórmula a datos configurados o calculados del concepto de liquidación que se está evaluando.
Se utilizan principalmente en campos de fórmula como Factor Multiplicador, Base Imponible, fórmula principal del importe, variables auxiliares y Referencia por fórmula.
El valor de cada variable depende del concepto específico que se está calculando en ese momento. Por eso, una misma variable puede devolver valores distintos según el contexto.
Para entender cómo se relacionan estos campos dentro del cálculo del concepto, consulta 🟢03-formulas-en-concepto-liquidacion.
Variables disponibles
Las variables de conceptos se dividen en dos categorías según su origen:
Variables de resultado calculado
| Variable | Tipo de dato | Descripción | Referencia |
|---|---|---|---|
| @FACTMULT | Numérico | Resultado del Factor Multiplicador | Calculado antes de base imponible |
| @BASIMP | Numérico | Resultado de la Base Imponible | Calculado si Factor ≠ 0 |
| @VAR1 | Numérico | Resultado de Variable 1 | Calculado cuando se invoca |
| @VAR2 | Numérico | Resultado de Variable 2 | Calculado cuando se invoca |
Variables de configuración
| Variable | Tipo de dato | Descripción | Referencia |
|---|---|---|---|
| @PORCE | Numérico | Porcentaje del concepto, expresado como valor decimal | Tomado de configuración |
| @CONLIQIMP | Numérico | Importe fijo configurado en el concepto | Tomado de configuración |
| @DESCRIPCION | Texto | Descripción del concepto | Tomado de configuración |
| @CODCONCEPTO | Numérico | Código identificador del concepto | Tomado de configuración |
Detalle de variables
Variables de resultado calculado
Estas variables contienen el resultado numérico de evaluar las fórmulas configuradas en el concepto. No devuelven el texto de las fórmulas, sino sus resultados.
@FACTMULT
Tipo de dato: Numérico
Origen: Resultado del Factor Multiplicador
El valor calculado del Factor Multiplicador durante la evaluación del concepto. Puede representar unidades, cantidades, días, horas, porcentajes, alícuotas u otro factor necesario para el cálculo.
Cuándo se calcula:
Antes de la Base Imponible y antes del importe del concepto.
Ejemplo de uso:
@BASIMP * @FACTMULT
@BASIMP
Tipo de dato: Numérico
Origen: Resultado de la Base Imponible
El valor calculado de la Base Imponible. Se utiliza como base de cálculo para obtener el importe del concepto o para combinarse con otros valores en la fórmula principal.
Cuándo se calcula:
Después del Factor Multiplicador, únicamente si este es distinto de 0.
Ejemplo de uso:
@BASIMP * @PORCE
@VAR1
Tipo de dato: Numérico
Origen: Resultado de Variable 1
Cálculo auxiliar del concepto. Se utiliza para guardar un resultado intermedio y reutilizarlo en otros campos de fórmula como Factor Multiplicador, Base Imponible, fórmula principal o Fórmula Concepto Informativo.
Cuándo se calcula:
Únicamente cuando otra fórmula del concepto la invoca mediante @VAR1.
Ejemplo de uso:
@BASIMP * @VAR1
@VAR2
Tipo de dato: Numérico
Origen: Resultado de Variable 2
Segunda variable auxiliar del concepto. Permite separar cálculos intermedios adicionales o reutilizar expresiones dentro de otras fórmulas.
Cuándo se calcula:
Únicamente cuando otra fórmula del concepto la invoca mediante @VAR2.
Ejemplo de uso:
@BASIMP * @FACTMULT * @VAR2
Variables de configuración
Estas variables toman valores directamente de la configuración del concepto, sin cálculos intermedios.
@PORCE
Tipo de dato: Numérico
Origen: Campo Porcentaje del concepto
El porcentaje configurado, expresado como valor decimal. Por ejemplo, si en pantalla aparece 3, esta variable devuelve 0.03.
Ejemplo de uso:
@BASIMP * @PORCE
Diferencia con @CONLIQIMP:
- @PORCE es un porcentaje (se multiplica)
- @CONLIQIMP es un importe fijo (se suma o usa directo)
@CONLIQIMP
Tipo de dato: Numérico
Origen: Campo Importe del concepto
El importe fijo configurado en el concepto. Es el valor definido en la configuración, no el importe liquidado final del ítem.
Ejemplo de uso:
@CONLIQIMP * @CANTHIJOS
Diferencia con @PORCE:
- @CONLIQIMP es un importe fijo (se usa directo o se multiplica)
- @PORCE es un porcentaje (se convierte a decimal: 3 → 0.03)
@DESCRIPCION
Tipo de dato: Texto
Origen: Campo Descripción del concepto
La descripción configurada del concepto. Se utiliza en fórmulas que necesiten el texto descriptivo, especialmente en referencias dinámicas o construcciones de descripción a partir de datos del sistema.
Ejemplo de uso:
@DESCRIPCION
@CODCONCEPTO
Tipo de dato: Numérico
Origen: Campo Código del concepto
El identificador numérico del concepto que se está evaluando.
Ejemplo de uso:
@CODCONCEPTO
Variables NO disponibles
Algunos datos del concepto existen en la configuración del sistema, pero no están disponibles como variables directas en fórmulas de Liquidación de Haberes.
| Variable | Disponibilidad | Alternativa |
|---|---|---|
| @CONCEPTO | ❌ No disponible | No existe variable directa; usa funciones si necesitas datos de otros conceptos |
| @TIPOCONCEPTO | ❌ No disponible | El tipo existe en configuración pero no está expuesto como variable |
| @ORDENLIQ | ❌ No disponible | El orden existe en configuración pero no está expuesto como variable |
Consideraciones clave
Origen de los valores
Las variables de conceptos se dividen en dos categorías según cómo obtienen sus valores:
- Calculadas: @FACTMULT, @BASIMP, @VAR1, @VAR2 → resultan de evaluar fórmulas durante el proceso
- De configuración: @PORCE, @CONLIQIMP, @DESCRIPCION, @CODCONCEPTO → se toman directamente de la configuración del concepto
Resultados vs. fórmulas
Las variables calculadas nunca devuelven el texto de la fórmula. Siempre devuelven el resultado numérico de evaluarla.
Ejemplo: @FACTMULT devuelve 5 (el resultado), no @HORASNORMALES (la fórmula que se escribió).
Orden de cálculo
El orden importa:
| Secuencia | Qué sucede |
|---|---|
| 1 | Factor Multiplicador se calcula |
| 2 | Si Factor = 0, el concepto se detiene |
| 3 | Si Factor ≠ 0, se calcula Base Imponible |
| 4 | Variables auxiliares se calculan solo cuando se invocan |
Esto significa que @BASIMP solo tiene un valor válido si @FACTMULT ≠ 0.
Uso de porcentajes
Cuando uses @PORCE en multiplicaciones:
- El sistema la convierte a decimal automáticamente
- Si está configurada como 3, la variable devuelve 0.03
- Úsala directamente: @BASIMP * @PORCE (no dividas ni hagas conversiones adicionales)
Diferencia: importe configurado vs. importe liquidado
- @CONLIQIMP = importe fijo definido en la configuración del concepto
- Importe final del ítem = resultado de evaluar la fórmula principal del concepto
- Estos pueden ser completamente distintos
Variables auxiliares
Cuando uses @VAR1 o @VAR2:
- Verifica que estén configuradas en el concepto
- Recuerda que se calculan solo si se invocan en otra fórmula
- Si no se usan, no intervienen en el cálculo
Referencias adicionales
- Orden de evaluación detallado: Pipeline de cálculo del concepto
- Sintaxis y operadores: 🟢02-operadores-y-sintaxis
- Tipos de dato: 🟢01-tipos-de-dato
- Definiciones: 🟢04-glosario