Gestión de Funcionarios
Objetivo
Section titled “Objetivo”Administrar la información de funcionarios, incluyendo datos personales, laborales, generación de salarios, gestión de préstamos y control de documentación requerida.
/funcionarios
Descripción General
Section titled “Descripción General”El módulo Gestión de Funcionarios permite administrar toda la información de los funcionarios de la institución. Incluye un listado con búsqueda y filtros, una vista detallada con cuatro pestañas (Datos Personales, Datos Laborales, Documentos y Salarios), y funcionalidades para generar salarios mensuales y registrar préstamos.
Funcionalidades
Section titled “Funcionalidades”Listado de Funcionarios
Section titled “Listado de Funcionarios”Se listan todos los funcionarios con sus datos principales: ID, documento, apellidos, nombres y teléfono.
Búsqueda y Filtros
Section titled “Búsqueda y Filtros”- Buscador: Por documento, apellidos, nombres y teléfono.
- Filtro avanzado: Permite combinar búsqueda por cargo, nacionalidad y fecha de nacimiento.
Permisos
Section titled “Permisos”| Acción | Permiso requerido |
|---|---|
| Agregar funcionario | employee_store |
| Editar funcionario | employee_update |
| Eliminar funcionario | employee_destroy |
| Editar salario | Permiso especial + autorización de Rectorado |
Eliminación de Funcionarios
Section titled “Eliminación de Funcionarios”La eliminación es un borrado lógico: el registro se conserva con la fecha de eliminación y puede restaurarse si es necesario.
Generación de Salarios
Section titled “Generación de Salarios”Desde el botón Generar Salario se abre un formulario modal con los siguientes campos:
- Año: Por defecto el año actual.
- Tipo de salario: Salario, aguinaldo o comisión.
- Meses: Selección múltiple mediante autocomplete.
Al confirmar, el sistema calcula automáticamente el monto de cada salario en base a los campos emplo_salary (salario base) y has_ips (booleano que indica si el funcionario aporta al IPS) de la tabla employees. Los salarios se generan únicamente para funcionarios activos y solo si no existe ya un registro para la misma combinación de mes, año y tipo.
Vista Detallada del Funcionario
Section titled “Vista Detallada del Funcionario”Accesible desde el botón Mostrar funcionario. Contiene cuatro pestañas.
Pestaña 1 — Datos Personales
Section titled “Pestaña 1 — Datos Personales”Muestra los datos del funcionario: nombre, apellido, documento, celular, correo, sexo, nacionalidad y dirección.
Incluye una tarjeta de contactos (componente compartido con ficha de cobro, estudiantes y lista de personas) que permite listar, agregar, editar y eliminar contactos.
Pestaña 2 — Datos Laborales
Section titled “Pestaña 2 — Datos Laborales”Muestra los datos salariales y el estado del funcionario (activo/inactivo). El estado se gestiona desde el formulario de edición del funcionario.
Tarjeta de Estado de Cuenta
Section titled “Tarjeta de Estado de Cuenta”Muestra el salario neto y es editable con permiso especial y autorización de Rectorado.
Al editar, se despliegan el salario bruto, el cálculo del IPS y un campo de observación.
La modificación del campo emplo_salary solo afecta a los salarios generados a partir de ese momento. Los salarios ya generados anteriormente no se ven alterados.
Préstamos
Section titled “Préstamos”Permite registrar adelantos al funcionario que se descuentan mes a mes. Cada préstamo requiere:
- Motivo
- Monto total
- Cantidad de cuotas
- Autorización de Rectorado
Pestaña 3 — Documentos
Section titled “Pestaña 3 — Documentos”Lista todos los documentos definidos en la tabla required_docs. Utiliza el componente compartido de documentos (el mismo que se usa para personas), con opciones para listar y editar. Actualmente ningún documento es obligatorio.
Pestaña 4 — Salarios
Section titled “Pestaña 4 — Salarios”Muestra el historial completo de pagos realizados al funcionario.
Filtros disponibles: tipo, mes, año, fecha de inicio y fecha de fin.
Exportación PDF: Genera un documento con el nombre y apellido del funcionario en el encabezado, seguido de la tabla del historial filtrado con el total del período.
Reglas de Negocio
Section titled “Reglas de Negocio”Generación de Salarios
Section titled “Generación de Salarios”El cálculo se basa en emplo_salary (salario base) y has_ips (indicador de aporte a IPS). No se generan duplicados para la misma combinación de mes, año y tipo.
Edición de Salario Base
Section titled “Edición de Salario Base”- Requiere permiso especial + autorización de Rectorado.
- Solo afecta a salarios generados a partir de la fecha de edición.
Estados de Funcionario
Section titled “Estados de Funcionario”El estado (activo/inactivo) se gestiona desde el formulario de edición del funcionario.
Eliminación Lógica
Section titled “Eliminación Lógica”Los funcionarios eliminados se conservan con la fecha de eliminación y pueden restaurarse.
Préstamos a Funcionarios
Section titled “Préstamos a Funcionarios”- Requieren autorización de Rectorado.
- Se descuentan mes a mes del salario.
- Cada préstamo debe especificar: motivo, monto total y cantidad de cuotas.
Última revisión: 29 de junio de 2026