Eliminar
Elimina un registro patronal.
Descripcion general
Este endpoint realiza el borrado del registro patronal: a partir de ese momento deja de aparecer en GET /api/v1/employer-registrations y se trata como no encontrada en PATCH/DELETE (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 este registro patronal, el borrado se rechaza con 409 — primero debes reasignar esos empleos por integridad histórica/SAT.
El historial se conserva. Los datos históricos asociados al registro patronal no se borran, para mantener consistentes las declaraciones y reportes previos.
Endpoint
https://app.integranom.com/api/v1/employer-registrations/{employer_registration_number}Path param: employer_registration_number — entero positivo, el número del registro patronal dentro de la organización.
Comportamiento
- Rechaza con
409si algún empleo referencia este registro patronal (cualquier estatus) — reasígnalos primero. - Marca el registro patronal como eliminado.
- La fila deja de devolverse por
GET /api/v1/employer-registrations. - El historial asociado al registro patronal se conserva.
Errores
| Status | Causa |
|---|---|
400 | employer_registration_number inválido en la URL. |
404 | El registro patronal no existe o ya fue eliminado en esta organización. |
409 | El registro patronal sigue referenciado por uno o más empleos. Cuerpo: { "message": "This employer registration is still referenced by one or more employments. Reassign them before deleting it." }. |