Periodos de Nómina

Un periodo de nómina es el intervalo de tiempo por el que se paga a los empleados. En ALTUM ERP cada periodo sigue un ciclo de estados: BORRADOR → CALCULADO → TIMBRADO (o CANCELADO). Solo se puede avanzar al siguiente estado si el anterior está completo.

Requisitos y permisos

Permiso	Qué permite
nomina.consultar	Ver el listado de periodos y el detalle de cada uno
nomina.gestionar	Crear nuevos periodos y ejecutar el cálculo
nomina.timbrar	Enviar a timbrar vía Finkok y cancelar recibos individuales

Pantalla principal: listado de periodos

La ruta /nomina/periodos muestra todos los periodos del tenant ordenados por fecha de inicio descendente. Cada fila indica:

• Tipo (Semanal, Catorcenal, Quincenal, Mensual)
• Fechas de inicio y fin
• Fecha de pago
• Estado con etiqueta de color: Borrador (gris), Calculado (azul), Timbrado (verde), Cancelado (rojo)
• Totales de percepciones, deducciones y neto (cuando el periodo ya fue calculado)

El widget de la pantalla de inicio de Nómina (/nomina) muestra los últimos cinco periodos para acceso rápido.

Crear un nuevo periodo

Desde /nomina/periodos, haga clic en “Nuevo periodo” para abrir el formulario.

Campos del formulario

Campo	Descripción
Tipo de periodo	SEMANAL (7 días), CATORCENAL (14 días), QUINCENAL (15 días) o MENSUAL (28–31 días)
Fecha de inicio	Primer día del periodo
Fecha de fin	Último día del periodo
Fecha de pago	Fecha en que se realizará el pago; debe ser igual o posterior a la fecha de inicio

Validación de coherencia

El sistema valida en tiempo real que el rango de fechas sea coherente con el tipo seleccionado:

Tipo	Días esperados
SEMANAL	7
CATORCENAL	14
QUINCENAL	15
MENSUAL	Los días del mes calendario (28–31)

Si el rango no coincide, se muestra una advertencia en amarillo que no bloquea el envío del formulario. Esto permite registrar periodos parciales en casos justificados.

Prorateo de ISR e IMSS

Los cálculos de ISR, subsidio y cuotas IMSS utilizan el número de días del tipo de periodo para prorratear los montos mensuales. El sistema usa siempre los días nominales del tipo: SEMANAL=7, CATORCENAL=14, QUINCENAL=15, MENSUAL=30 (valor fijo de normalización para el Art. 96 LISR y para IMSS).

Al hacer clic en “Crear periodo”, el periodo se crea en estado BORRADOR sin recibos asociados aún.

Ciclo de estados

BORRADOR ──Calcular──▶ CALCULADO ──Timbrar──▶ TIMBRADO
   │                                              │
   └──────────── CANCELADO ◀─────────────────────┘
                 (cuando todos los recibos quedan cancelados)

BORRADOR

Estado inicial. El periodo existe pero no tiene recibos generados. Solo desde este estado se puede ejecutar el cálculo.

CALCULADO

Se generaron todos los recibos (uno por empleado activo). Se pueden revisar los totales de percepciones, deducciones, otros pagos, neto e IMSS patronal. Desde este estado se puede ejecutar el timbrado.

TIMBRADO

Todos los recibos en estado PENDIENTE_TIMBRADO o TIMBRADO_FALLIDO fueron procesados contra Finkok. El periodo pasa a TIMBRADO solo cuando no quedan recibos pendientes ni fallidos.

CANCELADO

Un periodo llega a este estado automáticamente cuando todos sus recibos individuales han sido cancelados ante el SAT.

Detalle del periodo

Haga clic en cualquier periodo de la lista para ir a /nomina/periodos/:id. La pantalla muestra:

1. Encabezado con tipo, rango de fechas, fecha de pago y estado.
2. Tarjetas de resumen con el total de percepciones, deducciones y neto del periodo.
3. Tabla de recibos con columna de empleado, percepciones, deducciones, neto y estado de timbrado por recibo.

Acciones disponibles según estado

Estado actual	Botón visible	Permiso necesario
BORRADOR	Calcular	nomina.gestionar
CALCULADO	Timbrar	nomina.timbrar
TIMBRADO	—	—
CANCELADO	—	—

Estados de timbrado por recibo

Cada recibo dentro de un periodo tiene su propio estado de timbrado:

Estado	Descripción
PENDIENTE_TIMBRADO	Generado, aún no enviado al PAC
TIMBRADO	CFDI timbrado exitosamente por Finkok
TIMBRADO_FALLIDO	Intento fallido (se puede reintentar hasta 3 veces)
CANCELADO	CFDI cancelado ante el SAT

Casos frecuentes

¿Puedo crear dos periodos con el mismo rango de fechas? El sistema no bloquea esta situación a nivel de validación de formulario; es responsabilidad del administrador evitar duplicados.

¿Qué pasa si agrego empleados después de crear el periodo? Los empleados dados de alta después de que el periodo está en BORRADOR sí quedan incluidos al momento de ejecutar el cálculo, siempre que su fechaInicio sea anterior o igual a la fecha de fin del periodo. Si el periodo ya fue calculado, los nuevos empleados no quedan en ese periodo.

¿Puedo recalcular un periodo ya calculado? No directamente. El botón “Calcular” solo aparece cuando el periodo está en BORRADOR. Si necesita recalcular, debe cancelar el periodo y crear uno nuevo.

¿Cuántos intentos de timbrado tiene cada recibo? Hasta 3 intentos (maxIntentos = 3). Si se agotan, el recibo queda en TIMBRADO_FALLIDO permanente hasta que se ejecute un reintento manual vía la función de reintento (ver página CFDI de Nómina).