Alta y Gestión de Empleados

El módulo de Nómina gestiona el ciclo completo de los empleados activos: desde su registro inicial hasta su baja, pasando por la actualización de datos laborales y salariales que determinan los cálculos de cada periodo.

Requisitos y permisos

Permiso	Qué permite
nomina.consultar	Ver el listado, buscar y consultar el detalle de cualquier empleado
nomina.gestionar	Crear, editar y desactivar empleados

Pantalla principal: listado de empleados

La ruta /nomina/empleados muestra la tabla de empleados activos del tenant. Las columnas visibles incluyen nombre completo, RFC, NSS, puesto, departamento y salario diario. Empleados inactivos (activo = false) o con fecha de baja registrada no aparecen en el listado por defecto.

Desde la tabla puede:

• Hacer clic en una fila para abrir el detalle/edición del empleado.
• Usar el botón “Nuevo empleado” para iniciar el alta.

Alta de empleado

Haga clic en “Nuevo empleado” para abrir el formulario. El formulario está organizado en cuatro pestañas:

Pestaña: Datos Personales

Capture los datos de identificación oficial del trabajador:

Campo	Obligatorio	Validación
Nombre	Sí	Texto libre
Primer Apellido	Sí	Texto libre
Segundo Apellido	No	Texto libre
Fecha de Nacimiento	No	Selector de fecha
RFC	Sí	Persona física: 4 letras + 6 dígitos (AAMMDD) + 3 alfanuméricos (13 chars). Persona moral: 3 letras + 6 dígitos + 3 alfanuméricos (12 chars). El sistema valida el formato según la regex del SAT.
CURP	Sí	18 caracteres exactos (formato SAT).
NSS	Sí	11 dígitos numéricos.

RFC único por tenant

El sistema rechaza el alta si el RFC, CURP o NSS ya están registrados para otro empleado del mismo tenant. Los RFC genéricos XAXX010101000 y XEXX010101000 tampoco son aceptados.

Pestaña: Contrato

Registre las condiciones laborales que se reportarán en el complemento Nómina 1.2 del CFDI:

Campo	Obligatorio	Catálogo SAT
Tipo de Régimen	Sí	02 Sueldos y Salarios / 99 Otro Régimen
Tipo de Contrato	Sí	01 Tiempo indeterminado / 02 Obra determinada / 03 Tiempo determinado / 07 Honorarios / 08 Otro
Tipo de Jornada	Sí	01 Diurna / 02 Nocturna / 03 Mixta / 04 Por hora / 99 Otra
Riesgo del Puesto	Sí	Clase I (0.54355%) a Clase V (7.58875%), conforme al IMSS
Departamento	No	Texto libre
Puesto	No	Texto libre
Fecha de Inicio (relación laboral)	Sí	Selector de fecha
Fecha de Alta IMSS	Sí	Selector de fecha

Antigüedad en el CFDI

La antigüedad que se incluye en cada recibo timbrado se calcula automáticamente a partir de la Fecha de Inicio registrada aquí y la fecha de fin del periodo, expresada en semanas completas (formato ISO PnW requerido por el XSD de Nómina 1.2).

Pestaña: Salario

Capture los datos salariales necesarios para calcular el SBC:

Campo	Obligatorio	Notas
Salario Diario	Sí	Monto en MXN, dos decimales
Factor de Integración	Sí	Predeterminado 1.0452. Representa las partes proporcionales de aguinaldo, vacaciones y prima vacacional.

Mientras captura estos datos, el formulario muestra una vista previa del SBC estimado calculado como:

SBC = mín( salarioDiario × factorIntegracion,  25 × UMA_DIARIO )

Si el resultado supera el tope de 25 UMAs diarias, el SBC se topa automáticamente y se muestra un aviso. El cálculo definitivo del SBC se realiza en el backend con la UMA vigente del año correspondiente (modelo UmaVigencia), nunca con un valor fijo.

SBC topado a 25 UMAs

El tope de cotización ante el IMSS es de 25 veces la UMA diaria vigente. El sistema aplica este tope automáticamente al calcular el SBC almacenado en el registro del empleado.

Pestaña: Banco

Datos bancarios opcionales que se incluyen en el complemento Nómina del CFDI:

Campo	Notas
Banco	Nombre de la institución financiera
CLABE Interbancaria	18 dígitos. Se valida longitud máxima; el sistema no verifica el dígito verificador.
Tiene crédito Infonavit	Checkbox. Si se activa, aparece el campo Porcentaje Infonavit (0–100%).

El porcentaje Infonavit se utiliza directamente en el cálculo de la deducción por descuento al crédito (clave SAT 006).

Edición de empleado

Navegue a /nomina/empleados/:id. El formulario se carga con los valores actuales del empleado. Modifique los campos necesarios y haga clic en “Guardar cambios”.

Re-cálculo del SBC

Cada vez que se guarda una modificación al salario diario o al factor de integración, el backend recalcula y persiste el SBC actualizado. Los periodos de nómina ya calculados o timbrados no se recalculan retroactivamente.

Desactivación de empleado

Desde la página de detalle del empleado, el botón “Desactivar” (visible solo para usuarios con nomina.gestionar) abre un diálogo de confirmación. Al confirmar:

• El campo activo pasa a false.
• Se registra la fechaBaja con la fecha actual.
• El empleado deja de aparecer en el listado activo y no se incluye en futuros cálculos de periodos.

Empleados con baja dentro del periodo

Si la fechaBaja de un empleado cae dentro de un periodo en estado BORRADOR, el cálculo solo incluirá los días trabajados efectivos desde el inicio del periodo hasta la fecha de baja.

Reglas de negocio adicionales

• RFC no genérico: el sistema rechaza el alta con RFC XAXX010101000 o XEXX010101000.
• Unicidad: RFC, CURP y NSS son únicos por tenant. Un intento de duplicado devuelve error de conflicto.
• Empleados inactivos en el cálculo: el handler de cálculo de periodo excluye automáticamente a empleados con activo = false o con fechaBaja anterior o igual a la fecha de inicio del periodo.

Casos frecuentes

¿Puedo registrar el mismo empleado en dos tenants distintos? Sí. La unicidad de RFC, CURP y NSS es por tenant; el mismo empleado puede tener registros independientes en tenants diferentes.

¿Qué ocurre si el empleado ingresó a mitad del periodo? El sistema calcula automáticamente los días trabajados desde fechaInicio del empleado hasta el fin del periodo, y proratea el sueldo y las cuotas IMSS sobre esos días.

¿Puedo reactivar a un empleado dado de baja? La interfaz actual no expone esta función. La baja modifica activo y fechaBaja en la base de datos; una reactivación requeriría un nuevo alta o edición directa de esos campos.