Saltar al contenido
Facturador

Eliminar cuenta

DELETE /api/bank-accounts/{bank_account_id}

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Elimina una cuenta sin movimientos.

Quién puede usarlo: solo usuarios de tipo administrador (type = admin). Con el token de un vendedor responde 403.

Responde 409 cuando:

  • la cuenta ya recibió o pagó dinero (desactívala con status: 0);
  • es el destino por defecto de algún método de pago.

404 si no existe.

Parámetros

Parámetro Dónde Obligatorio Ejemplo Descripción
bank_account_id ruta sí 1

Respuestas

200 — Eliminada

{
  "success": true,
  "data": {
    "id": 3
  },
  "message": "Cuenta eliminada con éxito"
}

409 — Con pagos

{
  "success": false,
  "message": "La cuenta tiene pagos registrados, no se puede eliminar. Desactívala (status = 0) en su lugar."
}

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.