---
title: "Eliminar un cliente"
method: DELETE
path: "/clients/{id}"
tags: ["Clientes"]
---

# Eliminar un cliente

`DELETE /clients/{id}`

## Request

- Base URL: `https://api.pirpos.com`
- URL: `https://api.pirpos.com/clients/{id}`
- Auth: HTTP bearer

Realiza una eliminación lógica del cliente (marca el campo `deleted: true`).
El cliente no se borra físicamente de la base de datos.

**Autenticación requerida:** Este endpoint requiere autenticación Bearer Token.
Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header:
`Authorization: Bearer {tokenCurrent}`

**Permiso requerido:** `CL_DELETE` (Eliminar)

**Comportamiento:**
- Marca el campo `deleted: true` y actualiza `modifiedOn` con la fecha actual.
- El cliente ya no aparecerá en las búsquedas (`getAll` filtra `deleted: { $ne: true }`).
- Registra el evento en el historial de cambios.
- Notifica via WebSocket a todos los usuarios del negocio.
- El cliente debe pertenecer al negocio autenticado.

## Ejemplo de Uso

```
DELETE /clients/507f1f77bcf86cd799439021
Authorization: Bearer tu_token_aqui
```

## Path parameters

- `id` string, required

## Response `200`

Cliente eliminado exitosamente

- object
  - `message` string

## Other responses

- `401`: Token de autorización inválido o faltante
- `403`: Sin permisos para eliminar clientes
- `500`: Error interno del servidor o cliente no encontrado

---

[API](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar.md) - [All operations](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar/llms.txt) - [OpenAPI document](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar/revisions/9d4431a3cddc?raw)