Editar cuenta
PUT /api/bank-accounts/{bank_account_id}
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Edita una cuenta. Acepta PUT o PATCH; la edición es parcial.
Quién puede usarlo: solo usuarios de tipo administrador (type = admin). Con el token de un vendedor responde 403.
Campos: los mismos de Crear cuenta. Para desactivar una cuenta con movimientos envía status: 0.
Errores: 422 por validación; 404 si no existe.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
bank_account_id |
ruta | sí | 1 |
Cuerpo
Content-Type: application/json
{
"description": "BCP SOLES PRINCIPAL",
"status": 1,
"show_in_documents": false
}
Respuestas
200 — Editada
{
"success": true,
"data": {
"id": 3,
"type": "bank",
"bank_id": 2,
"description": "BCP SOLES PRINCIPAL",
"number": "191-12345678-0-12",
"currency_type_id": "PEN",
"cci": "00219100123456780122",
"status": 1,
"initial_balance": "0.00",
"show_in_documents": false,
"establishment_id": null,
"receives_income": true,
"allows_payments": true,
"bank_description": "BANCO DE CREDITO DEL PERU",
"type_description": "Cuenta bancaria"
},
"message": "Cuenta editada con éxito"
}
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.