Eliminar

Descripcion general

Este endpoint realiza el borrado del calendario de nómina: a partir de ese momento deja de aparecer en GET /api/v1/payroll-calendars y se trata como no encontrada en PATCH/DELETE (404). El borrado no es destructivo: las corridas de nómina ya cerradas siguen siendo reproducibles. Si hay empleados activos o pendientes asignados al calendario, la solicitud falla — primero debes reasignarlos a otro calendario.

Endpoint

Path param: payroll_calendar_number — entero positivo, el número de calendario dentro de la organización.

Comportamiento

• Rechaza la solicitud (409) si hay empleados activos o pendientes asignados al calendario — la respuesta incluye affected_count. Reasígnalos a otro calendario y reintenta.
• Marca el calendario como eliminado. La fila deja de aparecer en GET /api/v1/payroll-calendars.
• Conserva el historial para lectura: las corridas ya cerradas siguen siendo reproducibles.

Errores

Ejemplo de cuerpo 409:

{
  "message": "Cannot deactivate a payroll calendar while active or pending employees are assigned to it. Reassign them first.",
  "affected_count": 12
}