Eliminar cliente o proveedor
DELETE /api/persons/{customer_id}
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Elimina una persona que no esté siendo usada por comprobantes u otros registros.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
Formato de respuesta: heredado {success, message?, data?} sin paginación. Ante reglas de negocio puede responder HTTP 200 con success: false: revisa siempre success.
Reglas:
- El cliente Clientes varios no se puede eliminar.
Errores:
- En uso o protegido: HTTP 200 con
success: false. - Id inexistente: HTTP 500 con
success: false(no404).
Clientes - Varios (DNI 0 / 99999999, el cliente genérico de las boletas sin datos) es un registro del sistema protegido: intentar eliminarlo responde HTTP 200 con {"success": false, "message": "Clientes - Varios es un registro del sistema y no se puede eliminar."} y no se modifica.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
customer_id |
ruta | sí | 1 |
Respuestas
200 — Eliminado
{
"success": true,
"message": "Cliente eliminado con éxito"
}
200 — En uso
{
"success": false,
"message": "El Cliente esta siendo usado por otros registros, no puede eliminar"
}
200 — Clientes - Varios protegido
{
"success": false,
"message": "Clientes - Varios es un registro del sistema y no se puede eliminar."
}
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.