NominexDocs
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

DELETEhttps://app.integranom.com/api/v1/departments/{department_number}

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

Solicitud


Sin cuerpo. La API responde 204 No Content si el borrado tuvo éxito.

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_code de esos empleos queda en null (dentro de la misma transacción).

Errores

StatusCausa
400department_number inválido en la URL, o el departamento tiene hijos vivos.
409El 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." }.
404El departamento no existe o ya fue eliminado en esta organización.
Abrir Nominex