Calcular

Descripcion general

Este endpoint corre la nómina de un periodo. Si el periodo todavía no está abierto, lo abre, creando la corrida y congelando los empleados, sus salarios y las prestaciones de sus contratos, y a continuación lo calcula. Si el periodo ya estaba abierto, simplemente lo (re)calcula.

Abrir y calcular son un solo paso: el campo opened de la respuesta te dice si esta llamada abrió el periodo (true) o si ya estaba abierto (false).

La llamada es idempotente en el resultado mientras no cambien sus insumos: repetirla sobre un periodo ya calculado lo vuelve a calcular con los mismos empleados congelados y deja los mismos resultados. Los conceptos y los catálogos fiscales se leen como están en cada cálculo, así que un cambio en un concepto se refleja al volver a calcular. Para incorporar cambios de empleados o de asistencia posteriores a la apertura, utiliza recalcular.

No lleva cuerpo. Requiere que la API key tenga el permiso Calcular nómina.

Endpoint

Path params:

• payroll_calendar_number — entero positivo, el número del calendario.
• period_number — el periodo, con el formato {fiscal_year}-{sequence_number} (por ejemplo 2026-14).

Comportamiento

1. Si el periodo no tiene corrida, la abre: valida el calendario y la plantilla, y congela los datos de los empleados (empleados activos del calendario, salario diario, prestaciones del contrato de cada empleado). Los conceptos y los catálogos fiscales se leen en cada cálculo.
2. En el primer cálculo, aplica a la corrida la asistencia capturada en el registro global para las fechas del periodo. En los cálculos posteriores respeta la asistencia ya aplicada (para volver a sincronizarla, usa recalcular).
3. Ejecuta el motor de cálculo: percepciones, deducciones, ISR, IMSS, INFONAVIT, ISN y costo patronal.
4. Deja la corrida y el periodo en estado calculated.

Al cerrar, la corrida conserva los datos con los que se calculó por última vez, así que una corrida cerrada se puede reproducir idénticamente aunque después cambien salarios, contratos, conceptos o catálogos.

Errores