Instructivo Cálculo de Nómina: Funciones Existentes

Se presenta un detalle de todas las funciones existentes en el modal de formula desde donde se construyen las formulaciones del sistema HCW. Las presentes funciones tienen por objetivo simplificar el desarrollo de las formulas obteniendo diversidad de datos que hacen un módulo más potente.

Es importante conocer que este catálogo de funciones va creciendo todo el tiempo de cara a la evolución de nuestra herramienta como así también de las necesidades de nuestros clientes y partners de la región.

1 ) FnNovedades:

Esta función es para obtener novedades desde el módulo de tiempo y asistencia para su procesamiento en la nómina.

Esta función, necesita le indiquemos: qué tipo de novedad considerará del módulo de tiempo  y asistencia y el estado de la misma.

Ejemplo de algunos tipos de novedades: deberán seleccionar en el check box de la izquierda, aquellas  novedades indicadas para ser recuperadas en la fórmula:

La posibilidad de Estados, se visualizará al presionar el botón de la lista desplegable, por ejemplo: Aprobado, En revisión, Pendiente o Rechazado, cada tipo de novedad, va a tener un estado, por tal motivo, sólo se debe seleccionar un estado de los cuatro posibles. 

2) FnHistorico:

Esta función permite realizar operaciones sobre datos de otras liquidaciones, dentro de un periodo de tiempo determinado, que puede comprender el periodo de la liquidación o bien otros tantos períodos a definir, su nombre de históricos, identifica que se vincula con datos liquidados con anterioridad.

La misma función, permite realizar diferentes acciones, según la opción seleccionada, y los siguientes campos seleccionados en la misma

Acciones: 

• Promedio
• Suma

Promedio, realizará el promedio de, los importes ó unidades (según lo seleccionado en el campo Tipo), al realizar el promedio debemos indicarle de qué conceptos nos interesa dicho promedio y en qué tipo/s de liquidación/es se encuentran los datos a considerar, y comenzando cuándo:  Período de Inicio, y en qué rango de fechas debe considerar,  Desde ingreso del Empleado, Desde un mes fijo, en dicho caso deberemos especificar qué mes de los doce posibles del año calendario o bien la cantidad de Periodos previos a considerar,  El promedio considerará los meses seleccionados para su divisor.

Suma, realizará la sumatoria de los importes ó unidades (según lo seleccionado en el campo Tipo), y en qué tipo/s de liquidación/es se encuentran los datos a considerar, y comenzando cuándo:  Período de Inicio, y en qué rango de fechas debe considerar,  Desde ingreso del Empleado, Desde un mes fijo, en dicho caso deberemos especificar qué mes de los doce posibles del año calendario o bien la cantidad de Periodos previos a considerar,  El promedio considerará los meses seleccionados para su divisor.

Tipo:

Unidades: si nos interesa recuperar la cantidad de días pagados en concepto de licencia por examen, maternidad, etc, seleccionaremos unidades.

Importe: si necesitamos el importe de determinados conceptos como para calcular un promedio de remuneraciones variables, seleccionaremos esta opción.

Conceptos:

Permite seleccionar tantos conceptos como necesitemos, basta con buscarlo con su descripción y luego seleccionar el check, box de la izquierda, en donde figura el nombre del concepto, para que el mismo sea considerado en la acción indicada precedentemente.

Tipo de Liquidación:

Podemos seleccionar una o varios tipos de liquidaciones disponibles, ya configuradas en nuestra base.

Período de Inicio: 

Podemos comenzar la búsqueda, en el mismo período que se está procesando (período productivo) o bien n (cantidad de periodos hacia atrás), hasta un máximo de 12 períodos. 

Tipo de Rango:

Debemos indicarle hasta dónde debe buscar y en función de qué dato

Sí seleccionamos: Mes fijo, debemos indicarle: qué mes del calendario es el límite de búsqueda, como se puede visualizar en la captura.

Si seleccionamos Periodos Previos, debemos indicarle la cantidad de meses, anteriores al mes de inicio para comenzar la búsqueda.

A modo de ejemplo adjunto capturas y su interpretación:

1. Sólo me interesa recuperar los datos del mes anterior, entonces lo configuraré de la siguiente forma:

b. Quiero recuperar los seis meses anteriores al período actual: les recuerdo los meses previos son vinculados al periodo de inicio (un mes atrás), no al mes que se está procesando. 

c. Solo me interesa recupera la información dentro del período que estoy procesando entonces lo configuraré de la siguiente forma: 

3) fnValoresParaFormulas:

Esta función permite recuperar información almacenada en la opción del menú: Valores para fórmulas, cuando dicha información es del tipo tabla, la forma de configuración es la siguiente:

El parámetro para saber qué valor debe devolver la tabla, puede estar almacenado en una Variable, en el caso referido podría será la Variable Interna Antigüedad,  VI:Antigüedad, o bien como el ejemplo, en una fórmula definida previamente (ejemplo en la captura de pantalla previo), que refleja la lógica a considerar para valorizar la cantidad de años antigüedad, también puede ser referido a la valorización de un concepto, en dicho caso deberemos seleccionar el concepto correspondiente, un acumulador, o un valor fijo, todos estos parámetros son mutuamente excluyentes, es decir debo seleccionar un  parámetros, el contenido de dicho parámetro será el valor buscado en la tabla referida y al encontrarlo devolverá el valor correspondiente.

4)  FnSAC:

Función a los efectos de valorizar el Sueldo Anual Complementario.

Debe indicarse el mes de cálculo, cuántos meses debe considerar, el año al cual aplica y si la cantidad de días a tomar en cuenta, está almacenado en un concepto, o bien lo recupera de la cantidad de días trabajados informados en el módulo de tiempo y asistencia. El valor base para el SAC, lo almacena internamente el sistema, de acuerdo a los conceptos que tienen en su definición, activado el check box que dice:

Acumula SAC, considerando para ello la fecha de afectación de la novedad ingresada. 

5) fnFinDeAno

Esta función tiene por finalidad componer el último día de un año, suele utilizarse para calcular la antigüedad al último día de un año, debemos ingresar como parámetro un campo fecha.

De esta fecha el sistema extraerá el año y compondrá el 31/12 del año de la fecha indicada.

6) fnInicioDeAno:

Es una función que trabaja de igual manera que la de Fin de Año, pero devuelve el primer día del año, considerando el año indicado como parámetro.

7) FnInicioDeMes:

Esta función es para componer el primer día del mes/año indicado en el parámetro fecha seleccionada.

8) FnFinDeMes: 

Esta función es para componer el último día del mes/año indicado en la fecha indicada como variable seleccionada.

9) fnDiasHabiles 

Especificaciones:

La función debe contar con 5 parámetros:

Parametro 1: Fecha Desde

Debe poder elegirse variables o funciones, como en el ejemplo siguiente de otra función:

Parametro 2: Fecha Hasta

Debe poder elegirse variables o funciones, como en el ejemplo siguiente de otra función:

Parametro 3: Dias Laborales de la semana

Consiste en un multiselect con 7 opciones detalladas a continuación (incluir el numero en el nombre para que estén ordenadas):

1 - Lunes

2 - Martes

3 - Miercoles

4 - Jueves

5 - Viernes

6 - Sabado

7 - Domingo

Parametro 4: Utilizar calendario das No Laborales HCW

Radio buttons Si / No para determinar si se consideran las fechas del modulo de Dias No Laborales de HCW (/schedule-module/non-working-day)

Parametro 5: Tipo de dia No Laborable

SI PARAMETRO 4 == true se desplega este 5to parametro que es un multiselect con las siguientes opciones:

Feriado

Dia No Laborable

Que corresponden a los valores del atributo nonWorkingType LEGAL_HOLYDAY y NON_WORKING respectivamente.

El resto de los atributos de los días no laborables no serán tenidos en cuenta por el momento.

Funcionamiento técnico:

Las siguientes consideraciones deben tomarse en cuenta pero cómo realizarlo queda a criterio de Desarrollo:

a) Tienen que contarse la cantidad de días según el parámetro 3 entre las dos fechas (o bien contar todos los días entre las dos fechas y restarle los días de la semana no seleccionados).

Ejemplo: contar todos los lunes, martes, miercoles, jueves y viernes entre el 01/01/2019 y el 01/01/2020 = 262

b) La fecha de inicio y la fecha de fin están incluídas en el rango.

c) Si el parámetro 4 == true y consecuentemente el 5 están configurados, se tomarán los registros entre las fechas desde / hasta según los Tipos de Dias No Laborales seleccionados y se descuentan a los días previamente calculados.

Ejemplo:

01/01/2019 Feriado Año Nuevo (martes)

18/04/2019 Dia No Laborable Jueves Santo (jueves)

Si el multiselect está configurado para tomar los dos casos, el resultado de esta parte es 2.

Del ejemplo de dias entre las dos fechas = 262 se le restan los dos días obtenidos del modulo Dias No Laborales, resultado final 260.

d) Si alguno de los registros obtenidos en del módulo de Dias No Laborales es un día no seleccionado en parametro 3 (es decir, es un dia que no se trabajaba de todas formas), no se descuenta.

Ejemplo:

01/01/2019 Feriado Año Nuevo (martes)

18/04/2019 Dia No Laborable Jueves Santo (jueves)

25/05/2019 Feriado Dia de la Revolucion de Mayo (sabado) --> cae sabado que es un día que no se trabaja según el parametro 3, por lo tanto no se considera!

El resultado sigue siendo 262 dias laborales - 2 dias del modulo dias no lab = 260 dias habiles

Nota: todos los parametros son obligatorios excepto el 5 que solo es obligatorio si el 4 es == true

Nota 2: si la fecha desde es superior (si es igual no hay problema) a la fecha hasta, entonces el proceso debe devolver un error de liquidación "Error fecha desde no puede ser superior a fecha hasta".

Nota 3: se adjunta un simulador de casos para testeo

10) fnMaximo:

Esta función devuelve el mayor valor comparando dos parámetros, los cuales podrán estar almacenados en diferentes componentes del sistema, en el ejemplo que se adjunta a comparación, es el mayor valor (importe)  del resultado de dos conceptos de la liquidación.

También puede utilizarse esta función, para asegurarse que un concepto no considere un valor negativo, si los parámetros indicados son como en la captura adjunta, donde seleccionar el mayor entre cero (0), y el resultado del concepto, que valoriza el monto para embargo. 

12) fnMinimo:

Esta función permite obtener en forma inversa a la función precedente, el menor valor entre dos parámetros indicados, estos valores pueden estar almacenados, en variables, conceptos o bien el resultado de la valorización de una fórmula.

13) fnDiferenciaEntreFechas:

Esta función, devolverá la diferencia en las unidades indicadas en el tercer parámetro (meses, años ó días), entre dos fechas (estas fecha puede obtenerse de variables internas como fecha de alta, fecha antigüedad reconocida, etc. , o bien a través de la aplicación de otras funciones.

14) FnAno: Esta función Valoriza ó Extrae el Año de un campo fecha indicado como parámetro. 

15) fnMes: Valoriza ó Extrae el Mes de un campo fecha indicado como parámetro. 

16) fnDia: Esta función Valoriza ó Extrae el Día de un campo fecha indicado como parámetro. 

17) FnUnidades:  

Esta función recupera las unidades del concepto que la invoca, estas unidades serán las informadas a través del ingreso de novedades o bien si el campo importe unidades es un fórmula, entonces aplicará a la valorización de dicha fórmula.

18) fnIfExist:

Esta función se utiliza, básicamente para evitar errores en fórmulas por referenciar campos que no exista en el colaborador en cual aplica la fórmula, cuando se agregan campos adicionales los mismo sólo existen en aquellos a los cuales se les ingresan novedad, entonces podrían presentarse la situación de colaboradores sin ese campo en la estructura de datos, por lo cual al referirlo en un fórmula, si no existe daría error, por tal motivo, se disponibilizó de esta función para evitar este inconveniente y teniendo una alternativa ante la no existencia del campo.

19) FnVacaciones:

Esta función está vinculada con el contenido del módulo de Tiempo y Asistencia más concretamente el de vacaciones, lo que va devolver, es del módulo de vacaciones, la siguiente información, según el parámetro que se referencie.

Total Solicitado: Devuelve el total de vacaciones solicitadas, en el período: mes y año productivo.

Período en Curso: Devuelve la cantidad de días a gozar dentro del mes, año productivo en la que fueron solicitadas.

Período siguiente: Devuelve la cantidad de días a gozar, que se solicitan en el mes productivo pero se gozan en el mes siguiente.

Período Subsiguiente: Devuelve la cantidad de días a gozar, que se solicitan en el mes productivo pero se gozan en el mes subsiguiente.

20) fnMejorSueldo:

Esta función permite determinar el mejor sueldo, de la lista de conceptos indicados en la selección, basta marcar el check box de la izquierda de los conceptos seleccionas, dentro del  periodo especificado en el mismo, pudiéndose obtener, tanto el dato del importe y si se quisiera en otro concepto con la misma definición e indicándose el mes, esto permite identificar el mes de esa mejor remuneración.

21)FnEntre: Es función se utiliza en condicionales, Permite indicarle un valor, y condicionar si el valor 1er parámetro de la función, se encuentra entre el Valor1 , valor 2 , que puede estar almacenado en una fórmula o bien una variable interna. 

22) FnEntero

Esta función devuelve el valor entero del importe de un concepto, unidad o variable referenciada en la misma.

23) fnResiduo,

Esta función retorna el residuo de dividir un valor por un divisor entero.

24) fnEdadFam:

Esta función retorna la cantidad de familiares con el parentesco indicado en la selección que cumplan la condición de edad especificada a través del operador, en el ejemplo sería la cantidad de hijos menores de seis años.

25) fnCentroCosto:

Esta función retorna true si el centro de costos seleccionado, se corresponde con el centro de costos principal del colaborador.

26) fnFamiliares: 

Esta función devuelve la cantidad de familiares, que cumplen las condiciones indicadas en los distintos parámetros.

27) FnRedondearMas:

Esta función permite redondear hacía en más, hasta la cantidad de posiciones indicadas en el parámetro, posiciones decimales admitidas, en el caso adjunto redondeará al entero superior.

En forma análoga trabaja la función FnRedondearMenos, pero como su nombre lo indica , redondea hacia el valor inferior.

28) FnValorcategoria:

Esta función tiene como responsabilidad el hecho de traer el valor cargado en la tabla de categorías dentro de la entrada de menú sindicato, pudiendo pasarle los parámetros de que composición Salarial y Categoría y la función me devuelve el valor cargado en dicha tabla.

29) FnScale: Esta función trae los rangos de la escala a la que se solicitó que llame y en función del resultado del valor de la formula devolverá el dato indicado el valor almacenado en la escala.

En este ejemplo devolverá el dato del campo Valor Quinquenal que es la primera columna siguiente al rango que le corresponde. 

30) FN AnexoIV: Exclusivo Impuesto 4ta Categoria (Argentina)

31) FNRedondear:

Esta función permite, a partir del resultado formula referenciada redondear a una cantidad determinada de decimales indicados en el campo valor manual del apartado Posiciones decimales aceptadas.

32) FNnovedades2:

Esta función amplía los atributos de la función  FNnovedades permitiendo seleccionar variables de entorno de la liquidación, con fecha desde/hasta dentro de la lista de desplegables y para uno o más tipos de novedades según se especifiquen.

33) ) FNAcumuladores:

Esta función amplía los atributos de la opción Acumulador, asimilándola a la FNHistorico, ya que se pueden llamar los acumuladores, pero con atributos mejorados:

Esto permite, por ejemplo, contar cuántas veces se procesó un determinado acumulador en un periodo de tiempo específico, como cuántas veces se pagaron horas extras en el semestre o las otras opciones vigentes

34) FnDiasHabilesPorNovedad:

Esta función considera los días hábiles en que un empleado tiene ausencias, por ejemplo si el empleado trabaja de lunes a viernes y se encuentra ausente de jueves a martes inclusive, traerá 4 dias ya que no tendrá en cuenta los días no laborales. También al igual que la FnDiasHabiles puede o no considerar los feriados.

35) FnCalculoTotalAcumulador:

Esta función considera para un acumulador determinado, el total de ese acumulador para toda la empresa en un periodo determinado: