Baja

Descripcion general

Este endpoint da de baja al empleado: marca su estado como terminated y guarda la termination_date enviada. El empleado no se elimina — su registro personal se conserva y queda en el historial. Para volver a contratarlo, llama a /reactivate.

La razón social, fecha de alta y demás datos laborales se conservan tal cual para fines históricos (declaraciones SUA, reportes, etc.).

Endpoint

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

{ "termination_date": "2026-06-30" }

Campos del cuerpo

Comportamiento

1. Carga al empleado activo (status != "terminated").
2. Si la fecha de baja cae dentro de un periodo cerrado, exige confirm_retro (ver abajo).
3. Asigna status = "terminated" y terminationDate = termination_date.
4. Si el empleado aporta al IMSS, genera su baja en Movimientos IMSS: pendiente de presentar, o ya presentada si envías already_registered_with_imss: true.
5. Genera los ajustes retroactivos que correspondan y los reporta en retros_touched.
6. Los demás datos laborales (razón social, fecha de alta, FKs) se conservan para el historial.

Baja con fecha dentro de un periodo cerrado

Cerrar un periodo es definitivo. Una baja fechada dentro de sus fechas contradice los recibos ya pagados: el empleado cobró días que, con la nueva fecha, no le correspondían.

Por eso la baja no se aplica en silencio. Si la fecha cae en un periodo cerrado, la llamada se rechaza con 409 RETRO_CONFIRMATION_REQUIRED (con retro_periods, los periodos afectados). Reenvíala con confirm_retro: true para aceptar: la baja se registra y la diferencia se corrige con un ajuste retroactivo negativo en el siguiente periodo — la respuesta lo reporta en retros_touched.

Es la misma regla que aplica la plataforma; el API no la puede saltar.

Forma de la respuesta

200 OK — los datos laborales del empleado recién dado de baja:

{
  "employee_number": 5,
  "status": "terminated",
  "hire_date": "2026-01-15T00:00:00.000Z",
  "seniority_date": "2026-01-15T00:00:00.000Z",
  "termination_date": "2026-06-30T00:00:00.000Z",
  "created_at": "2026-01-15T00:00:00.000Z",
  "retros_touched": 0
}

Errores