Actualizar una cuenta
Actualiza los datos de una cuenta. La caja no se modifica por esta ruta: el campo cashbox_id se ignora (use las rutas de asignación). La moneda y el saldo solo se pueden cambiar mientras la cuenta no tenga movimientos; si el saldo cambia sin movimientos, se regenera la conciliación inicial.
Parámetros de la ruta
Sección titulada «Parámetros de la ruta»idintegerobligatorioIdentificador de la cuenta.
Parámetros del cuerpo
Sección titulada «Parámetros del cuerpo»namestringobligatorioNombre de la cuenta. No puede repetirse otra cuenta con el mismo nombre, tipo y moneda (y banco, si el tipo es virtual); para esa comparación se leen type y bank_id del cuerpo.
coin_idintegerobligatorioMoneda de la cuenta. No puede cambiar si la cuenta ya tiene movimientos. Si account_type es detracción, debe ser Soles.
amountnumberobligatorioSaldo de la cuenta. No puede cambiar si la cuenta ya tiene movimientos.
numberstringNúmero de la cuenta. Debe ser único dentro de la misma caja.
number_ccistringCódigo de cuenta interbancario. Debe ser único dentro de la misma caja.
settingsobjectConfiguración de la cuenta. Acepta overdraft_enabled (booleano).
descriptionstringDescripción de la cuenta. Se guarda en mayúsculas.
responsiblestringResponsable de la cuenta. Se guarda en mayúsculas.
Permiso
Sección titulada «Permiso»cashbox.account.edit, que se valida en AccountPolicy::update. Ver Permisos y políticas.
curl -X PUT \ "https://servererp.allendostmen.app/api/account/1" \ -H "Authorization: Bearer $TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{ "name": "Cuenta corriente soles", "coin_id": 1, "amount": 1500.5, "description": "Cuenta para pagos", "responsible": "Juan Pérez"}'const response = await fetch( "https://servererp.allendostmen.app/api/account/1", { method: "PUT", headers: { Authorization: `Bearer ${token}`, Accept: "application/json", "Content-Type": "application/json", }, body: JSON.stringify({ "name": "Cuenta corriente soles", "coin_id": 1, "amount": 1500.5, "description": "Cuenta para pagos", "responsible": "Juan Pérez" }), },);const data = await response.json();use Illuminate\Support\Facades\Http;
$response = Http::withToken($token) ->acceptJson() ->put('https://servererp.allendostmen.app/api/account/1', [ 'name' => 'Cuenta corriente soles', 'coin_id' => 1, 'amount' => 1500.5, 'description' => 'Cuenta para pagos', 'responsible' => 'Juan Pérez', ]);{ "id": 1, "cashbox_id": 1, "banking_product_id": null, "bank_id": 3, "coin_id": 1, "name": "CUENTA CORRIENTE SOLES", "number": "191-1234567-0-12", "modality": "cuenta bancaria", "swift_code": null, "type": "virtual", "amount": 1500.5, "description": "CUENTA PARA PAGOS", "account_type": "recaudación", "number_cci": "00219100123456701234", "responsible": "JUAN PÉREZ", "settings": { "overdraft_enabled": false }, "conciliated": true, "conciliated_movement_last_date": null, "conciliated_at": "2026-11-19T10:40:15.000000Z", "last_conciliation_id": null, "last_monthly_close_id": null, "status": "activo", "previous_status": null, "status_update_comment": null, "status_update_date": null, "create_user_id": 1, "update_user_id": 1, "delete_user_id": null, "restore_user_id": null, "status_update_user_id": null, "deleted_at": null, "created_at": "2026-11-19T10:40:15.000000Z", "updated_at": "2026-11-19T11:05:00.000000Z"}{ "message": "Esta acción no está autorizada."}{ "message": "No query results for model [App\\Models\\Account] 999"}{ "message": "La moneda de la cuenta no puede ser modificada porque ya tiene movimientos asociados", "errors": { "account_id": [ "La moneda de la cuenta no puede ser modificada porque ya tiene movimientos asociados" ] }}