Manual de Generación de Nómina - Objetos y Funciones

Parametrización de Conceptos

Los conceptos se pueden crear utilizando expresiones LIF (descritas en “Manual de Expresiones LIF”) y los siguientes componentes, descritos más abajo: Objetos Globales y Locales, Constantes Globales y de Locales, Opciones Globales y de Usuario, Series, Campos de Trabajadores, Funciones especiales, y otros Conceptos anidados.

Objetos Globales y Locales Disponibles

Son objetos, con propiedades, disponibles en todo momento en los conceptos de nómina. Los primeros tres (goEmpresa, goSucursal y goUsuario) son objetos globales, como los encontrados al parametrizar Gastos de Importación, Eventos y Reglas de Integración.
El resto (loNomina, loContrato, loTrabajador y loConcepto) son objetos, con propiedades, asociados al proceso de generación actual, y dependen de los parámetros de la misma.

goEmpresa: Hace referencia a la empresa donde se está generando la nómina.	goEmpresa.pcCodigo goEmpresa.pcNombre goEmpresa.pcMonedaBase goEmpresa.pcMonedaAdicional
goSucursal: Hace referencia a la sucursal donde se está generando la nómina.	goSucursal.pcCodigo goSucursal.pcNombre goSucursal.pnNivel
goUsuario: Hace referencia al usuario que está generando la nómina.	goUsuario.pcCodigo goUsuario.pcNombre goUsuario.pnNivel goUsuario.pcCorreo
loNomina: Hace referencia al documento de Generación de Nómina que se está generando.	loNomina.pcDocumento loNomina.pdFechaDesde: Fecha inicial de esta nómina. loNomina.pdFechaHasta: Fecha final de esta nómina. loNomina.pdFechaRecibo: Fecha de emisión del recibo.
loContrato: Hace referencia al contrato asociado al documento de Generación de Nómina.	loContrato.pcCodigo loContrato.pcNombre loContrato.pcTipo: Semanal, Quincenal, Mensual… loContrato.pcCalendario: Código el calendario asociado al contrato. loContrato.pdInicio: Fecha inicial del contrato (puede diferir de la fecha inicial de la nómina). loContrato.pdFin: Fecha final del contrato (puede diferir de la fecha final de la nómina).
loTrabajador: Hace referencia al trabajador para el cual se está generando el recibo de nómina (se genera un recibo por trabajador, si aplica).	loTrabajador.pcCodigo loTrabajador.pcNombre loTrabajador.pcSexo loTrabajador.pdFechaNacimiento loTrabajador.pcNacionalidad loTrabajador.pcEstadoCivil loTrabajador.pcGradoInstruccion loTrabajador.pcDepartamento loTrabajador.pcCargo loTrabajador.pcTurno loTrabajador.pcContrato: Código del contrato asociado al trabajador. Puede diferir del contrato seleccionado para la generación. loTrabajador.pdIngreso: Fecha de ingreso del trabajador. loTrabajador.pdEgreso: Fecha de egreso del trabajador. NOTA: esta propiedad muestra el valor almacenado, pero todos los trabajadores generados están activos.
loConcepto: Hace referencia al concepto que está siendo evaluado para el trabajador actual (se genera un renglón de recibo por concepto, si aplica).	loConcepto.pcCodigo loConcepto.pcNombre loConcepto.pcTipo: El tipo de concepto puede ser "Asignacion", "Deduccion", "Retencion" u "Otro".

Constantes Globales

Son valores definidos en el módulo de Sistemas, en la actualización Constantes.

Función: mObtenerConstanteGlobal("CONSTANTE") CADENA, NUMERO, FECHA, LOGICO
Descripción	Devuelve el valor de una constante Global.
Parámetros	"CONSTANTE": Código de una constante global (constante de sistema) válida.
Valor devuelto	Si el código de constante es válido, devuelve el valor de la misma. Si no es válida genera un error.
Observaciones	El tipo de valor devuelto dependerá del tipo de constante definida.

Constantes Locales

Son valores definidos en el módulo de Nómina, en la actualización Constantes Locales.

Función: mObtenerConstanteLocal("CONSTANTE") CADENA, NUMERO, FECHA, LOGICO
Descripción	Devuelve el valor de una constante de Nómina.
Parámetros	"CONSTANTE": Código de una constante local (constante de nómina) válida.
Valor devuelto	Si el código de constante es válido, devuelve el valor de la misma. Si no es válida genera un error.
Observaciones	El tipo de valor devuelto dependerá del tipo de constante definida.

Opciones Globales

Son opciones definidas a nivel de la empresa, en el módulo de Sistemas, en la actualización Opciones.

Expresión: {{goOpcionGlobal.CODIGO}} CADENA, NUMERO, FECHA, LOGICO
Descripción	Devuelve el valor de una opción del sistema.
Parámetros	CODIGO: Código de una opción global (opción de sistema) válida.
Valor devuelto	Si el código de la opción es válido, devuelve el valor de la misma. Si no es válido genera un error.
Observaciones	El tipo de valor devuelto dependerá del tipo de opción definida.

Opciones de Usuario

Son opciones definidas a nivel de cada usuario, en el módulo de Sistemas, en la actualización Usuarios>>Avanzados>>Opciones. El valor de estas opciones depende de la configuración del usuario que esté ejecutando la generación de la nómina.
Nótese que la sintaxis de las opciones requiere que estén encerradas entre llaves dobles.

Expresión: {{goOpcionUsuario.CODIGO}} CADENA, NUMERO, FECHA, LOGICO
Descripción	Devuelve el valor de una opción del Usuario.
Parámetros	CODIGO: Código de una opción de usuario válida.
Valor devuelto	Si el código de la opción es válido, devuelve el valor de la misma. Si no es válido genera un error.
Observaciones	El tipo de valor devuelto dependerá del tipo de opción definida. Si el usuario no tiene definida y activa la opción, entonces intentará leer la opción global existente, si tampoco está definida genera un error.

Series

Son Series definidas en el módulo de Sistemas, en la actualización Series. Esta función admite series cuyo valor de entrada sea numérico, de fecha o de cadena. El valor de salida dependerá del tipo de serie.

Función: mObtenerValorSerie("SERIE"; VALOR) CADENA, NUMERO, FECHA, LOGICO
Descripción	Devuelve el valor de una constante de Nómina.
Parámetros	"SERIE": Código de una serie del sistema válida. VALOR: Valor tipo número, fecha o cadena de entrada de la serie.
Valor devuelto	Si el código de la serie es válido, devuelve el valor de la serie asociado al valor de entrada indicado. Si no es válido genera un error.
Observaciones	Esta función acepta series de entrada tipo número, fecha o cadena. El tipo de valor devuelto dependerá del tipo de serie definida. Si la serie indicada está definida, pero el valor no corresponde a ninguno de los rangos definidos para la misma, devolverá el valor por defecto según el tipo de datos de salida: CADENA"", NUMERO0, FECHA#19000101#, LOGICOFALSE.

Campos de Trabajadores

Son Campos definidos en el módulo de Nómina, en la actualización Campos de Trabajadores. Los valores se asignan a cada trabajador en la actualización Trabajadores ficha Avanzados.

Función: mObtenerCampo("CAMPO") CADENA, NUMERO, FECHA, LOGICO
Descripción	Devuelve el valor de un campo de nómina para el trabajador actual.
Parámetros	"CAMPO": Código de un Campo de Trabajador válido.
Valor devuelto	Si el código del campo de trabajador es válido, devuelve el valor del campo para el trabajador actual. Si no es válido genera un error.
Observaciones	El tipo de valor devuelto dependerá del tipo de campo definido.

Funciones Especiales

Son Campos definidos en el módulo de Nómina, en la actualización Campos de Trabajadores. Los valores se asignan a cada trabajador en la actualización Trabajadores ficha Avanzados.

Función: mFuncion("CODIGO"[; [[ParamN]]...]) CADENA, NUMERO, FECHA, LOGICO
Descripción	Devuelve el resultado de ejecutar la función seleccionada, con los parámetros indicados, si los hay.
Parámetros	"CODIGO": Código de una Función de Nómina válida. [[ParamN…]]: Cero o más parámetros opcionales que serán usados al ejecutar la función seleccionada. Los parámetros deben estar incluidos entre corchetes dobles.
Valor devuelto	Si el código de función de nómina válido, devuelve el valor resultante de ejecutar la función con los parámetros indicados. Si no es válido genera un error.
Observaciones	El número de parámetros adicionales debe ser igual al número de parámetros definidos en la función seleccionada. Si hay más parámetros de los necesarios, los últimos serán descartados, si hay menos se mostrará un mensaje de error y se detendrá la generación. El tipo de valor devuelto dependerá de la fórmula definida en la función.

Conceptos Anidados

Es posible calcular el monto de otros Conceptos para utilizarlos en el concepto actual.
Es posible anidar varios niveles de conceptos de esta forma, bajo la única restricción de que será más difícil identificar y corregir errores durante la parametrización.
En un concepto anidado, la única restricción es que el concepto esté activo; la condición de ejecución (campo “Ejecutar Cuando”) del concepto anidado no es evaluada, solo se evalúa el campo Valor.

Función: mConcepto("CODIGO") NUMERO
Descripción	Devuelve el valor calculado de un concepto.
Parámetros	"CODIGO": Código de un Concepto de Nómina.
Valor devuelto	Si el código del campo de trabajador es válido, devuelve el Valor resultante del concepto. Si no es válido genera un error.
Observaciones	El tipo de valor devuelto será siempre numérico. El campo Ejecutar Cuando no es evaluado por esta función.