---
id: SCR-ACC-BKS-004
title: Bank accounts configuration
route: '/console/{tenantId}/configuration/accounting/bankAccounts'
surface: console
product_area: accounting
module: books
revision: 1
status: draft
design_intent: proposed
implementation_evidence: observed
inference: []
source_sha:
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
  services-accounting: f47cb263875bbc0c5640fba7dae6785ec32695f8
purpose: Maintain bank destinations and the GL account used to record their cash.
supports:
  - JNY-ACC-BKS-001
  - CAP-ACC-BKS-007
permission: >-
  accounting.bank-accounts.read (the console's configuration bank-accounts view
  alias); writes as listed per action
entry_from:
  - >-
    '/console/{tenantId}/configuration' (Accounting group in the configuration
    catalogue)
  - Navigation between Accounting setup screens
exits_to:
  - >-
    '/console/{tenantId}/configuration' (Accounting group in the configuration
    catalogue)
displays:
  - field: >-
      Bank destinations by unit and name, showing currency, cash destination and
      bank
    source: listBankAccounts
  - field: >-
      Bank details, optional account suffix, currency, GL destination and
      availability
    source: getBankAccount
actions:
  - label: Add Bank Account
    operation_id: createBankAccount
    permission: accounting.bank-accounts.create
    confirm: false
  - label: Save
    operation_id: updateBankAccount
    permission: accounting.bank-accounts.update
    confirm: false
  - label: Deactivate or Activate
    operation_id: updateBankAccount
    permission: accounting.bank-accounts.update
    confirm: false
  - label: Delete
    operation_id: deleteBankAccount
    permission: accounting.bank-accounts.delete
    confirm: true
states:
  - empty
  - loading
  - error
  - read-only
  - inactive
validation:
  - BR-CAP-ACC-BKS-007-01
  - BR-CAP-ACC-BKS-007-02
  - BR-CAP-ACC-BKS-007-03
  - BR-CAP-ACC-BKS-007-07
  - BR-CAP-ACC-BKS-007-09
  - BR-CAP-ACC-BKS-002-06
patterns:
  - >-
    Shared configuration list with search, sorting, availability filtering and
    an empty state
  - 'Permission-gated bulk activation, deactivation and deletion'
  - Deletion confirmation; availability changes are immediate
  - Editor unsaved-changes protection
  - Accounting read loading and error panels
  - Side-panel bank editor
  - Working-unit filter
  - Currency control locked after creation
component: components/configuration/resources/accounting-bank-accounts.tsx
evidence:
  - >-
    react-console at baf6dae3:
    components/configuration/resources/accounting-bank-accounts.tsx
  - >-
    react-console:components/configuration/config-list-screen.tsx:changeStatus;
    components/configuration/standard.tsx:standardCapabilities (shared-list
    behavior where applicable)
controls: [TC-IAM-001, TC-IAM-002, TC-IAM-004, TC-IAM-005, TC-AZ-001, TC-AZ-002, TC-AZ-003, TC-AZ-004, TC-AZ-005, TC-AZ-006, TC-TEN-001, TC-TEN-002, TC-TEN-003, TC-DAT-004, TC-LOG-001, TC-LOG-002, TC-LOG-003, TC-LOG-004, TC-LOG-005, TC-PI-001, TC-PI-005]
---

# Bank accounts configuration

## What the Screen Is For

Maintain bank destinations and the GL account used to record their cash.

## What It Shows and Lets People Do

The list opens bank details in a side panel. Staff with the corresponding action permission can add, save, change availability or delete records. The form stores descriptive bank information and the optional final four account digits, rather than full bank credentials.

## States and Errors

The console fixes the unit and currency for existing records. The suffix must be empty or four digits, and the GL destination must belong to the unit. Restricting references can prevent deletion or a service-side currency change. Read, save and refusal states use the shared configuration treatments.

## Patterns It Must Respect

Shared configuration list with search, sorting, availability filtering and an empty state. Permission-gated bulk activation, deactivation and deletion. Deletion confirmation; availability changes are immediate. Editor unsaved-changes protection. Accounting read loading and error panels. Side-panel bank editor. Working-unit filter. Currency control locked after creation.