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
DELETE
https://app.integranom.com/api/v1/contracts/{contract_number}Path param: contract_number — entero positivo, el número de contrato dentro de la organización.
Comportamiento
- Rechaza la solicitud (
409) si el contrato tiene empleados activos o pendientes vinculados; el cuerpo informa cuántos empleos quedarían afectados víaaffected_count. Reasígnalos a otro contrato antes de reintentar. - 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
| Status | Causa |
|---|---|
400 | contract_number inválido en la URL. |
404 | El contrato no existe o ya fue eliminado en esta organización. |
409 | El contrato tiene empleados activos o pendientes vinculados (affected_count). |

