Formulas Liquidacion

== Propósito ==

Esta documentación explica el lenguaje de fórmulas utilizado en el módulo **[[Liquidación de Haberes>>path:Liquidación de Haberes]]**.

4

5

Las [[fórmulas>>path:04-glosario#Fórmula]] permiten definir cómo se calculan valores dentro del sistema combinando [[variables>>path:04-glosario#Variable]], [[funciones>>path:04-glosario#Función]], [[operadores>>path:04-glosario#Operador]] 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.

6

7

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:

14

15

* **Elementos del lenguaje:** [[variables>>path:04-glosario#Variable]], [[funciones>>path:04-glosario#Función]], [[operadores>>path:04-glosario#Operador]], [[tipos de dato>>path:04-glosario#Tipo de dato]] y [[sintaxis>>path:04-glosario#Sintaxis]]

16

* **Contextos de uso:** Liquidación de Haberes, exportaciones, reportes personalizados, S.I.C.O.S.S. y Libro de Sueldos Digital

17

* **Ejemplos orientativos:** casos de uso que muestran cómo se combinan los elementos en fórmulas reales

18

19

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

20

21

**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 ==

26

27

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

28

29

**Contexto principal:** la configuración de **[[Conceptos de Liquidación>>path:Concepto Liquidación]]**, donde se utilizan en campos como:

30

31

* Factor Multiplicador

32

* Base Imponible

33

* Fórmula por Defecto

34

* Variable 1 y Variable 2

35

* Fórmulas del Convenio

36

37

**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.

38

39

Dentro de esta documentación, las [[variables>>path:04-glosario#Variable]] y [[funciones>>path:04-glosario#Función]] de [[S.I.C.O.S.S.>>path:04-glosario#S.I.C.O.S.S.]] y [[Libro de Sueldos Digital>>path:04-glosario#Libro de Sueldos Digital]] se tratan como contextos de uso del lenguaje de [[fórmulas>>path:04-glosario#Fórmula]], no como módulos separados.

40

41

Para entender cómo se aplican las fórmulas en un [[Concepto de Liquidación>>path:04-glosario#Concepto de Liquidación]], consultar [[03-formulas-en-concepto-liquidacion>>path:03-formulas-en-concepto-liquidacion]].

----

== Organización de esta documentación ==

46

47

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

48

49

**Páginas iniciales:**

50

51

* **[[01-tipos-de-dato>>path:01-tipos-de-dato]]** — Tipos de valores que devuelven variables y funciones

52

* **[[02-operadores-y-sintaxis>>path:02-operadores-y-sintaxis]]** — Reglas para escribir fórmulas

53

* **[[03-formulas-en-concepto-liquidacion>>path:03-formulas-en-concepto-liquidacion]]** — Aplicación de fórmulas en [[Conceptos de Liquidación>>path:Concepto Liquidación]]

54

55

**Carpeta variables/** — [[Variables>>path:04-glosario#Variable]] agrupadas por contexto (empleado, liquidación, conceptos, parámetros, horas, novedades, anticipos, embargos)

56

57

**Carpeta funciones/** — [[Funciones>>path:04-glosario#Función]] agrupadas por tipo (texto, numéricas, fechas, lógicas, conceptos liquidados, centro de costo, etc.)

58

59

**Carpeta ejemplos/** — Casos de uso que muestran cómo combinar [[variables>>path:04-glosario#Variable]], [[funciones>>path:04-glosario#Función]] y [[operadores>>path:04-glosario#Operador]] en [[fórmulas>>path:04-glosario#Fórmula]] reales

60

61

**[[04-glosario>>path: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)

62

63

**[[pendientes-validacion>>path:pendientes-validacion]]** — Registro central de dudas, comportamientos no confirmados y elementos pendientes de revisión

----

== Conceptos básicos ==

68

69

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.).

74

75

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 ==

112

113

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

114

115

Una [[variable>>path:04-glosario#Variable]], [[función>>path:04-glosario#Función]], regla o comportamiento se documenta como funcionamiento real solo cuando:

116

117

* Ha sido validado en el sistema

118

* Está confirmado por un referente funcional

119

* Está respaldado por documentación vigente

120

121

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

122

123

**Aplica especialmente a:**

124

125

* [[Variables>>path:04-glosario#Variable]] cuyo origen no está confirmado

126

* [[Funciones>>path:04-glosario#Función]] con parámetros incompletos o ambiguos

127

* Comportamientos que varían según contexto de uso

128

* [[Fórmulas>>path:04-glosario#Fórmula]] de [[S.I.C.O.S.S.>>path:04-glosario#S.I.C.O.S.S.]], [[Libro de Sueldos Digital>>path:04-glosario#Libro de Sueldos Digital]] o reportes personalizados

129

* Reglas de negocio con impacto en liquidación, aportes, contribuciones o cálculos legales

130

131

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

----

== Uso futuro como base de conocimiento ==

136

137

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.

138

139

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

140

141

* Las [[variables>>path:04-glosario#Variable]], [[funciones>>path:04-glosario#Función]], [[operadores>>path:04-glosario#Operador]] y reglas se organizan de forma consistente

142

* Se utilizan nombres claros y categorías definidas

143

* Se establecen relaciones entre páginas mediante enlaces internos

144

145

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

146

147

* Explicar [[fórmulas>>path:04-glosario#Fórmula]] existentes en lenguaje simple

148

* Identificar [[variables>>path:04-glosario#Variable]] y [[funciones>>path:04-glosario#Función]] que intervienen en una [[fórmula>>path:04-glosario#Fórmula]]

149

* Orientar sobre qué elementos utilizar para resolver un cálculo

150

* Detectar información pendiente o no validada

151

* Evitar respuestas basadas en supuestos no documentados

152

153

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

----

== Pendientes generales ==

158

159

Durante el relevamiento pueden aparecer [[variables>>path:04-glosario#Variable]], [[funciones>>path:04-glosario#Función]], reglas o comportamientos no completamente confirmados. Estos elementos se registran en [[pendientes-validacion>>path:pendientes-validacion]] para su revisión posterior y no se documentan como funcionamiento definitivo hasta estar validados.

160

161

**Ejemplos de pendientes a relevar:**

162

163

* [[Variables>>path:04-glosario#Variable]] o [[funciones>>path:04-glosario#Función]] sin descripción confirmada

164

* Diferencias entre [[funciones>>path:04-glosario#Función]] similares o variantes con sufijos como CC, T, SLA o CODS

165

* [[Variables>>path:04-glosario#Variable]] y [[funciones>>path:04-glosario#Función]] de contextos específicos ([[S.I.C.O.S.S.>>path:04-glosario#S.I.C.O.S.S.]], [[Libro de Sueldos Digital>>path:04-glosario#Libro de Sueldos Digital]], reportes)

166

* Comportamiento exacto de [[fórmulas informativas>>path:04-glosario#Fórmula informativa]]

167

* Reglas de centro de costo, novedades, ganancias, aportes o contribuciones

168

* Ejemplos de fórmulas que requieran validación funcional

169

170

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

----

== Mapa de navegación ==

175

176

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

177

178

|=File35|=Nota|=Carpeta

179

|[[🟢variables-anticipos>>url:app://obsidian.md/formulas-liquidacion/variables/variables-anticipos.md]]|variables-anticipos|formulas-liquidacion/variables

180

|[[🟢variables-centro-costo-zona>>url:app://obsidian.md/formulas-liquidacion/variables/variables-centro-costo-zona.md]]|variables-centro-costo-zona|formulas-liquidacion/variables

181

|[[🟢variables-conceptos>>url:app://obsidian.md/formulas-liquidacion/variables/variables-conceptos.md]]|variables-conceptos|formulas-liquidacion/variables

182

|[[🟢variables-embargos>>url:app://obsidian.md/formulas-liquidacion/variables/variables-embargos.md]]|variables-embargos|formulas-liquidacion/variables

183

|[[🟢variables-empleado>>url:app://obsidian.md/formulas-liquidacion/variables/variables-empleado.md]]|variables-empleado|formulas-liquidacion/variables

184

|[[🟢variables-ganancias>>url:app://obsidian.md/formulas-liquidacion/variables/variables-ganancias.md]]|variables-ganancias|formulas-liquidacion/variables

185

|[[🟢variables-generales>>url:app://obsidian.md/formulas-liquidacion/variables/variables-generales.md]]|variables-generales|formulas-liquidacion/variables

186

|[[🟢variables-horas-y-novedades>>url:app://obsidian.md/formulas-liquidacion/variables/variables-horas-y-novedades.md]]|variables-horas-y-novedades|formulas-liquidacion/variables

187

|[[🟨variables-libro-sueldos-digital>>url:app://obsidian.md/formulas-liquidacion/variables/variables-libro-sueldos-digital.md]]|variables-libro-sueldos-digital|formulas-liquidacion/variables

188

|[[🟢variables-liquidacion>>url:app://obsidian.md/formulas-liquidacion/variables/variables-liquidacion.md]]|variables-liquidacion|formulas-liquidacion/variables

189

|[[🟢variables-parametros-y-contexto>>url:app://obsidian.md/formulas-liquidacion/variables/variables-parametros-y-contexto.md]]|variables-parametros-y-contexto|formulas-liquidacion/variables

190

|[[🟨variables-sicoss>>url:app://obsidian.md/formulas-liquidacion/variables/variables-sicoss.md]]|variables-sicoss|formulas-liquidacion/variables

191

|[[🟢funciones-conceptos-liquidados>>url:app://obsidian.md/formulas-liquidacion/funciones/funciones-conceptos-liquidados.md]]|funciones-conceptos-liquidados|formulas-liquidacion/funciones

192

|[[🟢funciones-fechas>>url:app://obsidian.md/formulas-liquidacion/funciones/funciones-fechas.md]]|funciones-fechas|formulas-liquidacion/funciones

193

|[[🟢funciones-ganancias>>url:app://obsidian.md/formulas-liquidacion/funciones/funciones-ganancias.md]]|funciones-ganancias|formulas-liquidacion/funciones

194

|[[🟢funciones-generales-sistema>>url:app://obsidian.md/formulas-liquidacion/funciones/funciones-generales-sistema.md]]|funciones-generales-sistema|formulas-liquidacion/funciones

195

|[[🟢funciones-horas-novedades-partes>>url:app://obsidian.md/formulas-liquidacion/funciones/funciones-horas-novedades-partes.md]]|funciones-horas-novedades-partes|formulas-liquidacion/funciones

196

|[[🟢funciones-libro-sueldos-digital>>url:app://obsidian.md/formulas-liquidacion/funciones/funciones-libro-sueldos-digital.md]]|funciones-libro-sueldos-digital|formulas-liquidacion/funciones

197

|[[🟢funciones-logicas>>url:app://obsidian.md/formulas-liquidacion/funciones/funciones-logicas.md]]|funciones-logicas|formulas-liquidacion/funciones

198

|[[🟢funciones-numericas>>url:app://obsidian.md/formulas-liquidacion/funciones/funciones-numericas.md]]|funciones-numericas|formulas-liquidacion/funciones

199

|[[🟢funciones-obras-centro-costo>>url:app://obsidian.md/formulas-liquidacion/funciones/funciones-obras-centro-costo.md]]|funciones-obras-centro-costo|formulas-liquidacion/funciones

200

|[[🟢funciones-rectificativas-lsd-y-reportes>>url:app://obsidian.md/formulas-liquidacion/funciones/funciones-rectificativas-lsd-y-reportes.md]]|funciones-rectificativas-lsd-y-reportes|formulas-liquidacion/funciones

201

|[[🟢funciones-texto>>url:app://obsidian.md/formulas-liquidacion/funciones/funciones-texto.md]]|funciones-texto|formulas-liquidacion/funciones

202

|[[🟢funciones-vacaciones>>url:app://obsidian.md/formulas-liquidacion/funciones/funciones-vacaciones.md]]|funciones-vacaciones|formulas-liquidacion/funciones

203

|[[ejemplos-aportes-retenciones>>url:app://obsidian.md/formulas-liquidacion/ejemplos/ejemplos-aportes-retenciones.md]]|ejemplos-aportes-retenciones|formulas-liquidacion/ejemplos

204

|[[ejemplos-centro-costo>>url:app://obsidian.md/formulas-liquidacion/ejemplos/ejemplos-centro-costo.md]]|ejemplos-centro-costo|formulas-liquidacion/ejemplos

205

|[[ejemplos-libro-sueldos-digital>>url:app://obsidian.md/formulas-liquidacion/ejemplos/ejemplos-libro-sueldos-digital.md]]|ejemplos-libro-sueldos-digital|formulas-liquidacion/ejemplos

206

|[[ejemplos-novedades>>url:app://obsidian.md/formulas-liquidacion/ejemplos/ejemplos-novedades.md]]|ejemplos-novedades|formulas-liquidacion/ejemplos

207

|[[ejemplos-remunerativos>>url:app://obsidian.md/formulas-liquidacion/ejemplos/ejemplos-remunerativos.md]]|ejemplos-remunerativos|formulas-liquidacion/ejemplos

208

|[[ejemplos-sicoss>>url:app://obsidian.md/formulas-liquidacion/ejemplos/ejemplos-sicoss.md]]|ejemplos-sicoss|formulas-liquidacion/ejemplos

209

|[[🟢01-tipos-de-dato>>url:app://obsidian.md/formulas-liquidacion/01-tipos-de-dato.md]]|01-tipos-de-dato|formulas-liquidacion

210

|[[🟢02-operadores-y-sintaxis>>url:app://obsidian.md/formulas-liquidacion/02-operadores-y-sintaxis.md]]|02-operadores-y-sintaxis|formulas-liquidacion

211

|[[🟢03-formulas-en-concepto-liquidacion>>url:app://obsidian.md/formulas-liquidacion/03-formulas-en-concepto-liquidacion.md]]|03-formulas-en-concepto-liquidacion|formulas-liquidacion

212

|[[🟢04-glosario>>url:app://obsidian.md/formulas-liquidacion/04-glosario.md]]|04-glosario|formulas-liquidacion

213

|[[🟨pendientes-validacion>>url:app://obsidian.md/formulas-liquidacion/pendientes-validacion.md]]|pendientes-validacion|formulas-liquidacion

Wiki source code of Formulas Liquidacion

Applications

Navigation

Need help?