NominexDocs
Referencia de la APICentro de costos

Eliminar

Elimina un centro de costos.

Descripcion general

Este endpoint realiza el borrado del centro de costos: a partir de ese momento deja de aparecer en GET /api/v1/cost-centers y se trata como no encontrada en PATCH/DELETE (404). El borrado no es recursivo: si el CC tiene hijos vivos, la solicitud falla — primero debes eliminarlos o re-asignarlos a otro padre. Los empleos que referenciaban el CC se desvinculan (cost_center_code → null) y los departamentos vinculados se desvinculan en cascada conservando sus últimos valores espejados.

Endpoint

DELETEhttps://app.integranom.com/api/v1/cost-centers/{cost_center_number}

Path param: cost_center_number — entero positivo, el número de centro de costos dentro de la organización.

Solicitud


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

Comportamiento

Las tres acciones ocurren dentro de una sola transacción:

  1. Rechaza la solicitud (400) si el CC tiene hijos vivos — primero elimínalos o reasígnalos a otro padre con PATCH.
  2. Desvincula cada empleo que referenciaba el CC: su cost_center_code queda en null. Los departamentos vinculados sobreviven, por lo que los empleos conservan su department_code.
  3. Desvincula en cascada cada departamento vivo vinculado: el costCenterId de cada departamento se pone en null. Los departamentos conservan los últimos valores espejados de name, code, description, is_active, sort_order.
  4. Marca el CC como eliminado. Deja de aparecer en GET /api/v1/cost-centers.

Errores

StatusCausa
400cost_center_number inválido en la URL, o el CC tiene hijos vivos.
404El centro de costos no existe o ya fue eliminado en esta organización.
Abrir Nominex