Configuración Inicial
Después de activar el módulo HRM, se recomiendan algunos pasos de configuración antes de comenzar a gestionar empleados y ejecutar la nómina. Todos los ajustes son accesibles desde Settings > HRM Configuration en la barra lateral.
Ajustes Generales
Navegue a Settings > HRM Configuration > General para configurar las opciones fundamentales.
Mes de Inicio del Año Fiscal
Define cuándo comienza el año fiscal de su organización. Esto afecta el procesamiento de arrastre de permisos y los cálculos de períodos de nómina.
- Predeterminado: Enero
- Opciones: Cualquier mes (enero–diciembre)
Ejemplo: Si su año fiscal va de abril a marzo, establézcalo en abril. El arrastre de permisos se procesará el 1 de abril de cada año.
Formato del Código de Empleado
Controla cómo se generan automáticamente los códigos de empleado al crear nuevos empleados.
| Formato | Ejemplo | Descripción |
|---|---|---|
year_increment | 2026-001, 2026-002 | Con prefijo del año actual, se reinicia cada año |
increment | 001, 002, 003 | Numeración secuencial simple |
Ajustes de Asistencia
Navegue a Settings > HRM Configuration > Attendance.
Horas de Trabajo
| Ajuste | Predeterminado | Descripción |
|---|---|---|
| Horas Estándar por Día | 8 | Usado para cálculos de horas extra y prorrateo de nómina |
| Hora de Inicio de Trabajo | 09:00 | Hora esperada de entrada |
| Hora de Fin de Trabajo | 17:00 | Hora esperada de salida |
Días de Descanso Semanal
Seleccione qué días de la semana son días no laborables.
- Predeterminado: Sábado, Domingo
- Se utiliza en los cálculos de nómina (conteo de días laborables) y marcado automático de asistencia de fin de semana
Ajustes de Gestión de Permisos
Navegue a Settings > HRM Configuration > Leave Management.
Flujo de Aprobación
| Modo | Comportamiento |
|---|---|
| Nivel Único (predeterminado) | Un aprobador revisa y aprueba/rechaza la solicitud |
| Múltiples Niveles | La solicitud pasa por múltiples etapas de aprobación |
| Aprobación Automática | Las solicitudes se aprueban automáticamente al enviarlas |
Tipos de Permiso con Aprobación Automática
Seleccione tipos de permiso específicos que deben omitir completamente el flujo de aprobación. Útil para tipos como Trabajo desde Casa o Compensatorio donde no se requiere aprobación.
Arrastre de Permisos
| Ajuste | Predeterminado | Descripción |
|---|---|---|
| Arrastre Habilitado | Sí | Si los días de permiso no utilizados se trasladan al siguiente año fiscal |
| Máximo de Días de Arrastre | 10 | Número máximo de días que se pueden trasladar |
| Vencimiento del Arrastre (meses) | 3 | Los días trasladados vencen después de estos meses en el nuevo año fiscal |
El arrastre de permisos se procesa automáticamente el primer día del mes de inicio del año fiscal mediante un comando programado.
Ajustes de Nómina
Navegue a Settings > HRM Configuration > Payroll.
Base de Cálculo Salarial
Determina cómo se calcula el salario para meses parciales o períodos prorrateados.
| Modo | Descripción |
|---|---|
| Días Laborables (predeterminado) | El salario se prorratea según los días laborables reales del período |
| Horas Laborables | El salario se calcula según las horas registradas |
| Mensual Fijo | Salario mensual completo independientemente de los días laborables |
Horas Extra
| Ajuste | Predeterminado | Descripción |
|---|---|---|
| Horas Extra Habilitadas | Sí | Si las horas extra se tienen en cuenta en la nómina |
| Multiplicador de Horas Extra | 1.5x | Multiplicador aplicado a la tarifa por hora para horas extra |
Destinatarios de Notificaciones
Seleccione usuarios que deben recibir notificaciones por correo electrónico cuando se completen las ejecuciones de nómina. Generalmente se configura para gerentes de RRHH o miembros del equipo financiero.
Departamentos y Proyectos
Departamentos
Navegue a Settings > HRM Configuration > Departments para crear los departamentos organizacionales antes de añadir empleados. Cada empleado se asigna a un departamento.
Ejemplos: Recursos Humanos, Ingeniería, Ventas, Marketing, Finanzas.
Proyectos
Navegue a Settings > HRM Configuration > Projects para definir proyectos contra los cuales los empleados pueden registrar tiempo en sus hojas de tiempo.
Configuración de Tipos de Permiso
Antes de que los empleados puedan enviar solicitudes de permiso, necesita configurar los tipos de permiso. Navegue a Leave Management > Leave Types desde la barra lateral.
Para cada tipo de permiso, configure:
| Campo | Descripción |
|---|---|
| Nombre | ej., Permiso Anual, Permiso por Enfermedad, Maternidad |
| Días por Año | Asignación anual para este tipo de permiso |
| Es Remunerado | Si este tipo de permiso es pagado |
| Requiere Aprobación | Si las solicitudes necesitan aprobación del gerente |
| Arrastre | Si los días no utilizados se trasladan al siguiente año |
| Máx. Días de Arrastre | Límite de días que se pueden trasladar |
| Está Activo | Habilitar o deshabilitar el tipo de permiso |
Puede usar el comando php artisan hrm:seed-leave-data para crear un conjunto estándar de tipos de permiso (Anual, Enfermedad, Personal, Maternidad, Paternidad, Duelo, No Remunerado, Trabajo desde Casa) con valores predeterminados razonables.
Configuración de Componentes de Nómina
Antes de ejecutar la nómina, defina sus componentes salariales en Payroll > Payroll Components.
Los componentes se dividen en tres categorías:
| Tipo | Ejemplos |
|---|---|
| Asignación (Ingresos) | Salario Base, Asignación por Vivienda, Asignación de Transporte, Bono |
| Deducción | Fondo de Previsión, Prima de Seguro, Pago de Préstamo |
| Impuesto | Impuesto sobre la Renta, Impuesto de Seguridad Social |
Cada componente admite dos métodos de cálculo:
- Fijo: Una cantidad monetaria establecida (ej., $500 Asignación de Transporte)
- Porcentaje: Un porcentaje del salario base o bruto (ej., 12% Fondo de Previsión)
Ejecute php artisan hrm:seed-payroll-data para generar un conjunto estándar de componentes de nómina (4 asignaciones, 3 deducciones, 2 impuestos) con configuraciones típicas.
Configuración del Portal del Empleado
El Portal del Empleado se configura a través del archivo config/employee-portal.php en el directorio del módulo HRM. Estos ajustes controlan lo que los empleados ven y pueden hacer cuando inician sesión.
Opciones Principales
| Ajuste | Predeterminado | Descripción |
|---|---|---|
enabled | true | Habilitar o deshabilitar el portal del empleado |
employee_role_name | Employee | Nombre del rol asignado a los usuarios empleados |
auto_create_user | true | Crear automáticamente una cuenta de usuario CRM cuando se crea un empleado |
landing_page | /timesheets | La página que los empleados ven después de iniciar sesión |
Elementos de Menú Visibles
De forma predeterminada, los empleados pueden acceder a:
- Hojas de Tiempo
- Solicitudes de Permiso
- Asistencia
- Saldos de Permisos
- Recibos de Nómina
Para otorgar a los empleados acceso a páginas de otros módulos, añada la ruta al array allowed_menu_items en el archivo de configuración.
Alcance de Datos
El portal filtra automáticamente los datos para que los empleados solo puedan ver sus propios registros. Esto se aplica a solicitudes de permiso, saldos de permisos, asistencia, hojas de tiempo, estructuras salariales, entradas de nómina y recibos de nómina.
Modelos excluidos del alcance (visibles para todos los empleados):
- Employee — para que el desplegable BelongsTo funcione al crear registros
- Leave Type — para que los empleados puedan ver los tipos de permiso disponibles
Orden de Configuración Recomendado
- Activar el módulo — Ingrese su código de licencia en Settings > HRM Configuration > Activation
- Configurar ajustes generales — Establecer año fiscal y formato de código de empleado
- Crear departamentos — Añadir su estructura organizacional
- Crear proyectos — Definir proyectos para seguimiento de hojas de tiempo (si aplica)
- Configurar tipos de permiso — Configurar categorías y asignaciones de permisos
- Configurar ajustes de asistencia — Establecer horas de trabajo y días de descanso
- Configurar componentes de nómina — Definir ingresos, deducciones e impuestos
- Configurar ajustes de nómina — Establecer base de cálculo y reglas de horas extra
- Añadir empleados — Comenzar a crear registros de empleados (las cuentas de usuario se crean automáticamente)
- Asignar estructuras salariales — Vincular componentes de nómina a cada empleado
- Crear saldos de permisos — Asignar las asignaciones de permisos para el año actual