Saltar al contenido
Facturador

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 (no 404).

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.