Saltar al contenido
Facturador

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.