Recursos Humanos

El módulo de Recursos Humanos concentra todo lo relacionado con tus empleados: desde el alta de la ficha hasta el cálculo de la planilla (ISSS, AFP, ISR y aguinaldo) y la liquidación al terminar la relación laboral. Todos los montos se capturan y se muestran en dólares.

1. Empleados: listado

Vista en tarjetas de todo tu personal, con búsqueda y filtros. Es el punto de entrada para crear, ver y editar empleados.

Pasos:

1. Entra a Recursos Humanos → Empleados. Verás tarjetas (12 por página); cada una muestra iniciales, Nombre y Apellido, insignia de Cargo, punto de Estado (Activo / Inactivo / Permiso), Especialización, Teléfono, Email y Salario Base.
2. Filtra por cargo con los chips: Todos, Administradores, Gerentes, Cajeros, Contadores, Operadores, Solo lectura.
3. Usa el buscador “Buscar por nombre, DUI…” (busca por nombre, apellido o DUI).
4. Pulsa “Nuevo Empleado” (arriba a la derecha) para crear uno.
5. En el menú ”⋯” de cada tarjeta encuentras “Ver Detalle” y “Editar”. Un clic en la tarjeta abre el detalle.

Nota: el listado oculta a los empleados inactivos por defecto. Los chips de cargo no filtran por estado, así que un empleado dado de baja no aparecerá en esta vista.

Estados del empleado: Activo (punto verde), Inactivo (punto gris), Permiso (punto amarillo). El botón “Nuevo Empleado” solo aparece con permiso employees:create.

2. Crear y editar un empleado

El mismo formulario sirve para crear (“Nuevo Empleado”) y editar (“Editar”). Está dividido en cuatro secciones.

Sección “Datos Personales”:

Sección “Información Laboral”:

Sección “Seguridad Social”:

Sección “Contacto de Emergencia”: Nombre, Teléfono (+503 XXXX-XXXX) y Parentesco (ej. “Madre”, “Esposo”).

Termina con “Registrar Empleado” (al crear) o “Guardar Cambios” (al editar). Si intentas salir con cambios sin guardar, aparece el aviso “Tienes cambios sin guardar…”.

Reglas fiscales/laborales de El Salvador:

• Los “cargos” son roles operativos (Administrador, Gerente, Cajero, Contador, Operador, Solo lectura), no puestos descriptivos.
• La AFP se limita a las dos administradoras privadas: Confiar y Crecer.
• El salario mínimo aplicado es $365.00 (comercio y servicios).

3. Detalle del empleado

Ficha de solo lectura con las acciones de estado y baja.

Contenido: cuatro tarjetas — Datos Personales, Información Laboral (con la insignia de estado), Seguridad Social y Contacto de Emergencia.

Acciones (barra superior, requieren employees:update):

1. Volver.
2. Editar.
3. Desactivar / Activar — alterna el estado entre Activo e Inactivo con un diálogo de confirmación. Al desactivar, “se le revocará el acceso y no aparecerá en listas activas”.
4. Dar de baja (en rojo) — solo visible si el empleado está activo. Abre el diálogo de finiquito (ver sección 4).

Diferencia clave: Desactivar es un cambio de estado reversible (se revierte con Activar); Dar de baja es la terminación formal con finiquito (genera una planilla de liquidación).

4. Dar de baja: finiquito

Termina la relación laboral calculando el finiquito según el Código de Trabajo y dejando el registro como una planilla de liquidación.

Pasos:

1. Tipo de baja * — Despido injustificado / Despido justificado / Renuncia voluntaria (por defecto “Renuncia voluntaria”).
2. Fecha de baja * — no puede ser futura ni anterior a la fecha de contratación.
3. Motivo * — obligatorio.
4. Pulsa “Calcular finiquito” para ver la vista previa (sin guardar): Años de servicio, Indemnización (si aplica), Aguinaldo proporcional, Vacaciones proporcional + 30% y Total bruto.
5. Pulsa “Confirmar baja” para ejecutar la terminación.

Cómo se calcula el finiquito (salario diario = salario base ÷ 30):

• Indemnización: solo para Despido injustificado (30 días por año trabajado, prorrateado). En despido justificado y renuncia es $0.
• Aguinaldo proporcional: acumulado desde el 12 de diciembre del año anterior, según antigüedad.
• Vacaciones proporcionales: desde el último aniversario, 15 días/año prorrateados + 30 % de prima.
• Total bruto = indemnización + aguinaldo prop. + vacaciones prop. Se le aplica ISR (no se descuenta ISSS ni AFP del finiquito).

Validaciones:

• Bloqueo por planillas en borrador: si el empleado tiene planillas en estado “Borrador”, verás “Este empleado tiene planillas en borrador. Apruébelas o anúlelas antes de procesar la baja.” y el botón queda deshabilitado.
• No se puede dar de baja a un empleado ya inactivo.
• Debes ejecutar “Calcular finiquito” antes de poder confirmar.

Al confirmar, se crea una planilla de tipo Finiquito en estado Borrador con el desglose y el empleado pasa a inactivo.

5. Asistencia

Registra entradas y salidas del personal y consulta los marcajes por día.

Pasos:

1. En “Registro Rápido” (visible con employees:update), elige el Empleado (solo activos) y pulsa el botón verde “Entrada” o el naranja “Salida”.
2. Usa el selector de fecha para consultar los registros de ese día.
3. La lista se agrupa por empleado con las horas de entrada y salida, o “Sin entrada” / “Sin salida”.

Reglas: solo una entrada y una salida por día. El botón Entrada se deshabilita si el empleado ya marcó entrada; el de Salida, si aún no hay entrada (“Primero debe registrar entrada”) o si ya marcó salida. No se registra asistencia de empleados inactivos.

El resumen mensual calcula las horas trabajadas (salida − entrada) y marca los días incompletos (falta entrada o salida).

6. Vacaciones

Solicita, aprueba y rechaza vacaciones controlando el saldo acumulado de cada empleado.

Pasos (listado):

1. La tabla muestra Empleado, Inicio, Fin, Días, Motivo, Estado.
2. Filtra por: Todas, Pendientes, Aprobadas, Rechazadas.
3. En las filas Pendientes, el menú ”⋯” ofrece “Aprobar” y “Rechazar”.

Nueva solicitud (diálogo “Solicitar vacaciones”):

1. Empleado * (solo activos).
2. Inicio * y Fin * (Fin no puede ser anterior a Inicio).
3. Motivo (opcional).
4. El recuadro de saldo muestra en vivo: Días acumulados, Consumidos, Pendientes, Disponibles y “Esta solicitud: X días” (en rojo si excede lo disponible).
5. Pulsa “Enviar solicitud”.

Rechazar: el campo “Motivo del rechazo” * es obligatorio.

Cálculo del saldo (Art. 177 del Código de Trabajo):

• Acumulados = años completos de servicio × 15 días/año.
• Consumidos = días de solicitudes aprobadas.
• Pendientes = días de solicitudes pendientes (se reservan aunque no estén aprobadas).
• Disponibles = Acumulados − Consumidos − Pendientes.
• Los días se cuentan en días calendario inclusivos (Fin − Inicio + 1). Un empleado con menos de un año de servicio tiene 0 días acumulados. Estados: Pendiente, Aprobada, Rechazada, Cancelada.

7. Planilla (nómina)

Genera, aprueba, paga y anula planillas; consulta el desglose salarial y exporta el pago al banco.

Listado: tabla con Empleado, Período, Salario Bruto, Deducciones, Salario Neto, Estado. El período se muestra legible (“Enero 2026”, “Enero 2026 · 1ª quincena”, “Aguinaldo 2026”, “Finiquito 2026”). Filtros: Todos, Borrador, Aprobada, Pagada, Anulada.

Permisos: ver employees:payroll:read; generar employees:payroll:create; aprobar/pagar/reversar employees:payroll:update.

Generar planilla (diálogo “Generar Planilla”):

1. Elige el Tipo: Mensual / Quincenal / Semanal / Aguinaldo anual.
2. Según el tipo, selecciona Mes, Quincena (Primera 1–15 / Segunda 16–fin), Semana o Año.
3. Pulsa “Generar”. Se crea en lote para todos los empleados activos, en estado Borrador; se omite a quien ya tenga planilla de ese período.

Acciones del período (diálogo “Acciones del período”): muestra un conteo (Borradores / Aprobadas / Pagadas) con tres acciones:

• “Aprobar N borradores”.
• “Marcar como pagadas (N)” — paga las aprobadas y registra automáticamente el asiento contable.
• “Exportar CSV para banco” — descarga un CSV con DUI, NIT, Empleado, Banco, Cuenta, Monto Neto (USD).

Acciones por fila (menú ”⋯”): Ver detalle, Descargar boleta (PDF), Aprobar (solo Borrador), Marcar como Pagada (solo Aprobada), Reversar Planilla (solo Pagada; pide motivo y crea un contra-asiento).

Ciclo de vida: Borrador → Aprobada → Pagada → (Anulada).

Cálculos de la planilla (salario bruto = base + horas extra + comisiones + bonos):

• ISSS empleado = 3 % del bruto, con base tope de $1,000.
• AFP empleado = 7.25 % del bruto (sin tope).
• Renta / ISR sobre la renta gravable (bruto − ISSS − AFP), según la tabla mensual salvadoreña (ver abajo).
• Neto = bruto − ISSS − AFP − ISR − otras deducciones.
• Contribuciones patronales (informativas): ISSS 7.5 % (tope $1,000), AFP 7.25 %, INSAFORP 1 %.
• Prorrateo: mensual ×1, quincenal ×0.5, semanal ×12/52.

Tabla de ISR mensual (renta gravable = bruto − ISSS − AFP):

Aguinaldo (Art. 198): período de devengo del 12 de diciembre (año anterior) al 11 de diciembre. Días según antigüedad al 11 de diciembre: 15 días (1 a <3 años), 19 días (3 a <10 años), 21 días (10+ años). Menos de un año → proporcional. Está exento de ISSS y AFP, pero sujeto a ISR.

Detalle no obvio: el costo salarial y el asiento contable se materializan al marcar la planilla como pagada, no al generarla. Un empleado no puede tener dos planillas del mismo período.

8. Resumen de RRHH

Indicadores de personal y planilla de un vistazo.

Contenido:

• Activos — con leyenda “X en permiso · Y inactivos”.
• Costo mensual — suma de los salarios brutos de las planillas del mes actual no anuladas.
• Borradores de planilla — pendientes de aprobación (se resalta si hay).
• Aprobadas sin pagar — listas para marcar como pagadas.
• Tabla “Por cargo” — número de empleados y suma de salarios base por rol (excluye inactivos).

Detalle no obvio: “Costo mensual” usa las planillas realmente generadas del mes (bruto), mientras que “Por cargo” suma los salarios base configurados en las fichas: pueden no coincidir.