NominexDocs
Referencia de la APIContratos

Eliminar

Elimina un contrato.

Descripcion general

Este endpoint realiza el borrado del contrato: a partir de ese momento deja de aparecer en GET /api/v1/contracts y se trata como no encontrada en PATCH/DELETE (404). El borrado no procede si el contrato tiene empleados activos o pendientes vinculados: primero debes reasignarlos a otro contrato. Los vínculos con las razones sociales y los conceptos extralegales se conservan.

Endpoint

DELETEhttps://app.integranom.com/api/v1/contracts/{contract_number}

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

Solicitud


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

Comportamiento

  1. Rechaza la solicitud (409) si el contrato tiene empleados activos o pendientes vinculados; el cuerpo informa cuántos empleos quedarían afectados vía affected_count. Reasígnalos a otro contrato antes de reintentar.
  2. Marca el contrato como eliminado. Deja de aparecer en GET /api/v1/contracts.

409 — empleados vigentes

{
  "message": "Cannot delete a contract with active or pending employees.",
  "affected_count": 3
}

Errores

StatusCausa
400contract_number inválido en la URL.
404El contrato no existe o ya fue eliminado en esta organización.
409El contrato tiene empleados activos o pendientes vinculados (affected_count).
Abrir Nominex