# Bank accounts

A bank-account entry records a bank, its account number, its currency, and an optional IBAN.
Use the Bank accounts configuration tab to review, add, update, delete, or export these entries.
The sibling [Banks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-finance-banks) page covers bank entries.

## Bank accounts

Bank accounts is the finance-configuration list for account details associated with a bank.
Use it for account-specific finance work; the sibling Banks page covers bank entries.

The application heading is **Banks accounts**. Use the page when finance work needs a bank-account
entry rather than a bank master entry.

| If you need to… | Go to |
| --- | --- |
| Check access and availability conditions | [Before you start](#before-you-start) |
| Open and review the list | [Find and review a bank-account entry](#find-and-review-a-bank-account-entry) |
| Identify fields and visible columns | [Understand the bank-account fields](#understand-the-bank-account-fields) |
| Add or change an entry | [Enter and validate bank-account values](#enter-and-validate-bank-account-values) |
| Remove an entry or begin an export | [Delete or export bank-account data](#delete-or-export-bank-account-data) |
| Resolve an unavailable action or message | [Handle unavailable actions and validation messages](#handle-unavailable-actions-and-validation-messages) |
| Maintain bank entries | [Banks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-finance-banks) |
| Maintain L/G facilities | [L/G facilities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-finance-letters-of-guarantees-facilities) |
| Return to the configuration area | [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) |

## Before you start

Bank-account maintenance is available when the subscription includes the feature and your
account has the permission required for the action. The list is replaced by an upgrade surface
when the subscription feature is not included.

| Condition | What it affects |
| --- | --- |
| The subscription includes the feature | The bank-account list is shown instead of the upgrade surface. |
| The create action is available | **New** is available. |
| Edit permission is available | A row edit action is shown, and selecting a row can open the edit popup. |
| Delete permission is available | The row delete menu is available when its other list condition is met. |
| A new entry or an existing item is selected | The bank-account form is shown. |

No approval step is required before you save or delete a bank-account entry.

## Find and review a bank-account entry

Open the Bank accounts list from Finance settings to review saved entries.

**Prerequisites**

- You are signed in.
- Your subscription and permissions expose the Bank accounts configuration surface.

**Steps**

1. Open **Finance settings**.
2. Select **Bank Accounts**.
3. Confirm that the page heading is **Banks accounts**.
4. Locate the Finance settings navigation.
5. Confirm that the navigation includes **Finance settings**, **Configuration**, **Banks**,
    **Bank Accounts**, **LGs Facilities**, and **Invoice Settings**.
6. Review the list after its columns appear.

The list can show `No data` and `Count: 0` while it loads. The visible list columns are **Bank
short name**, **Account no.**, **currency**, and **IBAN**. The toolbar shows **New**, **Refresh**,
and **Settings**. With no data row, no row edit or delete action is available.

**Result:** The **Banks accounts** list is open, and you can review its columns and current list
state.

## Understand the bank-account fields

Use the list to review saved values and the form to enter or change them.

| Field | List | Form | Guidance |
| --- | --- | --- | --- |
| **Bank short name** | Yes | No | Distinguish one entry from another. |
| **Bank** | No | Yes | Choose the bank you are maintaining. |

**currency** options are the currency codes available for selection in the **currency** field.

Choosing a bank in **Bank** updates the **Bank short name** shown for the account.

- **Account no.** is required; enter it before selecting **Save**.
- **IBAN** is optional; enter it when the bank provides one.

## Enter and validate bank-account values

Use the entry form to create a new bank-account entry or change an existing one.

**Prerequisites**

- The Bank accounts list is open.
- The subscription includes the feature.
- **New** is available when you are creating an entry.
- Edit permission is available when you are changing an existing entry.
- You know the bank, account number, currency if needed, and IBAN if needed.

**Steps**

1. Select the maintenance path for your task.

   | If you need to… | Select |
   | --- | --- |
   | Create a bank-account entry | **New** |
   | Change a saved bank-account entry | The row's edit action |

2. Select the bank in **Bank**.
3. Enter the account number in **Account no.**.
4. If you need to record a currency, select a currency code from the available choices in
   **currency**.
5. If you need to record an IBAN, enter it in **IBAN**.
6. Select **Save**.
7. Use the message you receive to correct the value named in the table.

   | Message | Correction |
   | --- | --- |
   | `Bank is required` | Select a value in **Bank**. |
   | `Account no. is required` | Enter a value in **Account no.**. |
   | `Just '_' '-' And '.' Characters Accepted` | Correct the value to the characters accepted by the field pattern. |
   | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from the affected value. |

8. Select **Save** again after correcting the value.
9. If you need to leave without keeping the popup changes, select **Cancel** or **Don't Save**.

For a new entry, the save result is `Data saved Successfully`. For an existing entry, the update
result is `Data updated Successfully`.

**Result:** The new entry is saved with `Data saved Successfully`, or the edited entry is saved
with `Data updated Successfully`. Selecting **Cancel** or **Don't Save** leaves the popup without
keeping its changes.

## Delete or export bank-account data

Deletion removes a selected bank-account entry through its row delete path and confirmation.
Export starts the list export-options flow without changing the entries.

### Delete a bank-account entry

Use deletion when the selected entry is no longer needed. The delete request is allowed when more
than one list item exists and delete permission is available.

**Prerequisites**

- The Bank accounts list is open.
- A bank-account row exists.
- Delete permission is available.
- More than one list item exists.

**Steps**

1. Open the selected row's delete menu.
2. Select **Delete**.
3. In the confirmation prompt, select **Delete**.
4. If the result is `Related to Saved data, Can't be deleted`, keep the entry and review the saved
   data related to it.
5. If the result is `Failed to Delete`, check whether the row remains before taking another action.
6. Do not select **Delete** when only one entry remains.

**Result:** A permitted deletion removes the selected entry and shows `Data Deleted Successfully`.
The entry remains when a delete refusal message appears.

### Start an export

Use **Export** when you need to begin the bank-account list export flow.

**Prerequisites**

- The Bank accounts list is open.
- **Export** is available in the list toolbar.

**Steps**

1. Select **Export**.
2. Review the export options that open.

**Result:** The bank-account export-options flow is open. Follow the controls shown there for the
next export step.

## Handle unavailable actions and validation messages

Use the visible condition or exact message to choose the next action.

| What you see | What it means | What to do |
| --- | --- | --- |
| The subscription-upgrade surface replaces the list | The subscription does not include the feature. | Ask the person who manages the subscription to include the feature. |
| **New** is absent | The create action is unavailable. | Use an existing row only if an edit action is available. |
| The row edit action is absent | Edit permission is unavailable. | Ask for edit permission before changing an entry. |
| The row delete menu is absent | Delete permission is unavailable. | Ask for delete permission before removing an entry. |
| `No data` appears with a loading indicator | The list is still loading. | Wait for loading to finish before treating the list as empty. |
| A list value is not where you expect it | The list presents bank-account values in its visible columns. | Use **Bank short name**, **Account no.**, **currency**, and **IBAN** to identify the entry. |
| `Bank is required` | **Bank** has no selected value. | Select a bank and select **Save** again. |
| `Account no. is required` | **Account no.** has no value. | Enter an account number and select **Save** again. |
| `Just '_' '-' And '.' Characters Accepted` | The value does not satisfy the character pattern. | Correct the value and select **Save** again. |
| `Forbidden characters detected. Please remove them and try again.` | A value contains a forbidden character. | Remove the forbidden character and select **Save** again. |
| `Related to Saved data, Can't be deleted` | Saved data is related to the entry. | Keep the entry and review the related saved data. |
| `Failed to Delete` | The delete operation failed. | Check whether the row remains before taking another action. |
| `Must have at least one item` | The list cannot be reduced below one item. | Keep at least one bank-account entry. |

## Continue with finance configuration

After maintaining bank accounts, continue with the finance-configuration area that matches your
next task.

| If you need to… | Continue with |
| --- | --- |
| Maintain bank entries | [Banks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-finance-banks) |
| Maintain letter-of-guarantee facilities | [L/G facilities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-finance-letters-of-guarantees-facilities) |
| Maintain invoice settings | [Invoice Settings](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-finance-billing-settings) |
| Return to the broader configuration area | [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) |
