Eliminar establecimiento
DELETE /api/establishments/{establishment_id}
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Elimina un establecimiento y su almacén.
Quién puede usarlo: solo usuarios de tipo administrador (type = admin). Con el token de un vendedor responde 403.
Responde 409 (no se elimina) cuando:
- es el único establecimiento de la empresa;
- tiene usuarios asignados;
- tiene series registradas (elimínalas antes en 2. Series);
- su almacén tiene movimientos de inventario;
- tiene comprobantes u otros registros relacionados.
404 si no existe.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
establishment_id |
ruta | sí | 1 |
Respuestas
200 — Eliminado
{
"success": true,
"data": {
"id": 2
},
"message": "Establecimiento eliminado con éxito"
}
409 — Con usuarios
{
"success": false,
"message": "El establecimiento tiene usuarios asignados, no se puede eliminar."
}
404 — No existe
{
"success": false,
"message": "Registro no encontrado."
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.