Referencia de la APIRazón Social
Eliminar
Elimina una razón social.
Descripcion general
Este endpoint realiza el borrado de la razón social y la retira de los listados de GET/PATCH/DELETE (las llamadas posteriores responden 404). La respuesta exitosa es 204 No Content con cuerpo vacío.
No se puede eliminar mientras tenga empleos vinculados. Si algún empleo (de cualquier estatus, incluidos los dados de baja) referencia esta razón social, el borrado se rechaza con 409 — primero debes reasignar esos empleos. Es intencional: los empleos dados de baja la siguen refiriendo por integridad histórica/SAT.
El número no se reutiliza. legal_entity_number de una razón social eliminada nunca se reasigna a una creación futura.
Endpoint
DELETE
https://app.integranom.com/api/v1/legal-entities/{legal_entity_number}Path param: legal_entity_number — entero positivo. Cualquier otro valor responde con 400.
Comportamiento
- Rechaza con
409si algún empleo referencia esta razón social (cualquier estatus, incluidos los dados de baja) — reasígnalos primero. - Retira la razón social de los listados.
- La razón social deja de devolverse por
GET /api/v1/legal-entities; las llamadas aPATCH/DELETEposteriores responden404. legal_entity_numberno se reasigna a creaciones futuras.
Errores
| Status | Causa |
|---|---|
400 | legal_entity_number inválido en la URL (no es entero positivo). Cuerpo: { "message": "Invalid 'legal_entity_number' in URL: must be a positive integer." }. |
404 | La razón social no existe o ya fue eliminada. Cuerpo: { "message": "Legal entity not found." }. |
409 | La razón social sigue referenciada por uno o más empleos. Cuerpo: { "message": "This legal entity is still referenced by one or more employments. Reassign them before deleting it." }. |
500 | Error no manejado. Cuerpo: { "message": "Internal Server Error" }. |