Referencia de la APIDepartamentos
Eliminar
Elimina un departamento.
Descripcion general
Este endpoint realiza el borrado del departamento: a partir de ese momento deja de aparecer en GET /api/v1/departments y se trata como no encontrada en PATCH/DELETE (404). El borrado no es recursivo: si el departamento tiene hijos vivos, la solicitud falla — primero debes eliminarlos o re-asignarlos a otro padre. Si el departamento está vinculado a un centro de costos, el CC controla su ciclo de vida y el borrado directo se rechaza con 409 — elimina o desvincula el CC. Al eliminar el departamento, se desvincula de cada empleo que lo referenciaba (su department_code queda en null).
Endpoint
DELETE
https://app.integranom.com/api/v1/departments/{department_number}Path param: department_number — entero positivo, el número de departamento dentro de la organización.
Comportamiento
- La fila deja de devolverse por
GET /api/v1/departments. - Rechaza la solicitud (
409) si el departamento está vinculado a un centro de costos — el CC controla su ciclo de vida; elimínalo o desvincúlalo primero. - Rechaza la solicitud (
400) si el departamento tiene hijos vivos — primero elimínalos o reasígnalos a otro padre con PATCH. - Desvincula el departamento de cada empleo que lo referenciaba: el
department_codede esos empleos queda ennull(dentro de la misma transacción).
Errores
| Status | Causa |
|---|---|
400 | department_number inválido en la URL, o el departamento tiene hijos vivos. |
409 | El departamento está vinculado a un centro de costos. Cuerpo: { "message": "This department is managed by a cost center. Unlink or delete the cost center instead." }. |
404 | El departamento no existe o ya fue eliminado en esta organización. |

