Referencia de la APIPuestos
Eliminar
Elimina un puesto.
Descripcion general
Este endpoint realiza el borrado del puesto: a partir de ese momento deja de aparecer en GET /api/v1/job-positions y se trata como no encontrada en PATCH/DELETE (404).
La respuesta exitosa es 204 No Content con cuerpo vacío.
A diferencia de departamentos y sucursales, los puestos no forman un árbol, así que no se verifica que tengan hijos vivos. Al eliminar el puesto, se desvincula de cada empleo que lo referenciaba: su job_position_code queda en null (misma transacción), de modo que ningún empleo queda apuntando a un puesto eliminado.
Endpoint
DELETE
https://app.integranom.com/api/v1/job-positions/{job_position_number}Path param: job_position_number — entero positivo, el número de puesto dentro de la organización.
Comportamiento
- Marca el puesto como eliminado.
- La fila deja de devolverse por
GET /api/v1/job-positions. - Sin verificación de hijos (los puestos no forman árbol). Sí se desvincula el puesto de cada empleo que lo referenciaba: su
job_position_codequeda ennull.
Errores
| Status | Causa |
|---|---|
400 | job_position_number inválido en la URL. |
404 | El puesto no existe o ya fue eliminado en esta organización. |
409 | El puesto tiene plazas sin cancelar. Cancélalas antes de eliminarlo. |