# Banks

A bank entry contains **Bank short name**, **Bank full name**, and **SWIFT code**. The Banks list
supports reviewing, adding, updating, removing, and exporting bank entries.

## Banks

The Banks page is available at **Finance settings** > **Banks**.

| If you need to… | Go to |
| --- | --- |
| Check whether you have access to the list | [Before you start](#before-you-start) |
| Open the list | [Find the Banks list](#find-the-banks-list) |
| Identify columns, actions, and fields | [Understand the Banks screen](#understand-the-banks-screen) |
| Check the three bank fields | [Fields](#fields) |
| Choose a create, edit, or delete path | [Maintain bank entries](#maintain-bank-entries) |
| Add or change a bank entry | [Add or update a bank entry](#add-or-update-a-bank-entry) |
| Remove a bank entry | [Remove a bank entry](#remove-a-bank-entry) |
| Copy the list | [Export the Banks list](#export-the-banks-list) |
| Understand a hidden or unavailable action | [Handle availability branches](#handle-availability-branches) |
| Resolve a message or loading problem | [When maintenance goes wrong](#when-maintenance-goes-wrong) |
| Maintain bank accounts | [**Banks accounts**](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-finance-banks-accounts) |
| Return to broader configuration | [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) |

This page covers bank entries only. Bank-account fields and actions belong to the sibling
[**Banks accounts**](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-finance-banks-accounts) page.

## Before you start

Banks is available to signed-in users whose subscription and permissions expose the relevant
configuration surfaces. Check the conditions below before looking for a maintenance control.

| Access condition | What it affects |
| --- | --- |
| You are authenticated | Access to the Banks route |
| The subscription includes the feature | The Banks grid instead of the upgrade surface |
| The feature is included and **New** is available | **New** |
| Edit permission is enabled | Editing |
| Delete permission is enabled | Deleting |

## Find the Banks list

The Banks list is under **Finance settings**. A successful arrival shows the **Banks** heading
and the list area.

**Prerequisites**

- You are signed in.
- Your account can open the Banks route.

**Steps**

1. Open **Finance settings**.
2. Select **Banks**.
3. Confirm that the page heading is **Banks**.

![The Banks heading and settled list](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/079503542967aaf8fd152f83699210bc.png)

**Result:** The authenticated Banks list is open. The list uses **Bank short name**, **Bank full
name**, and **SWIFT code** as its visible headers.

## Understand the Banks screen

The Banks screen combines a bank-entry grid, a page toolbar, an action column in each entry's row,
and a maintenance popup.
Use the headers visible in your list.

| Screen area | What to use it for |
| --- | --- |
| Main grid | Review bank entries |
| List columns | Read the bank values shown by the list |
| Page toolbar | Start **New** or use **Export** |
| Entry action column | Open the selected bank for editing or deletion |
| Shared popup | Enter or change bank values, save, or close the form |

The visible bank columns are **Bank short name**, **Bank full name**, and **SWIFT code**. Hidden
configuration properties do not appear as bank columns.

Use **New** in the page toolbar to create an entry. The toolbar also includes **Refresh** and
**Settings**. The edit control in an entry's action column opens it for changes; the delete control
in the same column starts removal.

The shared popup is also used by other configuration entities. For Banks, use only the fields in
[Fields](#fields). Controls for bank accounts, such as selecting a bank or a currency, belong to
[**Banks accounts**](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-finance-banks-accounts).

If `No data` appears while a loading indicator is present, wait for loading to finish before
deciding that the list contains no entries.

> **Note:** The list can receive its columns from the current configuration. Use the headers you
> can see when you work with the list.

### Fields

The Banks form records the name people recognise for a bank, its full name, and its SWIFT code.
The three bank fields are visible text boxes and are configured as required fields.

| Field shown to you | What to enter | Form configuration |
| --- | --- | --- |
| **Bank short name** | The bank's short name | Visible text box; required |
| **Bank full name** | The bank's full name | Visible text box; required |
| **SWIFT code** | The bank's SWIFT code | Visible text box; required |

The form does not include a bank-specific select box, date box, number box, percentage field, or
currency field.

The form fields appear in the shared popup when it is in its new-or-edit state, a selected item is
available, and the field is configured for form visibility. Each field's required setting controls
its required marker.

## Maintain bank entries

Use the Banks list as the starting point for the maintenance path that matches your task. **New**
opens a blank form. The edit control in an entry's action column opens the selected bank, and the
delete control in that column opens the delete menu. **Cancel** closes the delete menu or the popup,
depending on where you select it. **Save**
commits a new or edited bank after validation. **Don't Save** discards popup changes.

| If you need to… | Select |
| --- | --- |
| Create a bank entry | **New** |
| Change an existing bank entry | A saved bank's edit form |
| Remove a bank entry | The delete menu, then **Delete** |
| Leave a delete menu or popup | **Cancel** |
| Keep changes in a new or edited form | **Save** |
| Discard popup changes | **Don't Save** |
| Start a list export | **Export** |

The normal maintenance controls depend on subscription inclusion and the corresponding create,
edit, delete, or export permission. Use the edit and delete controls in each entry's action column.

### Add or update a bank entry

**Prerequisites**

- The Banks list is open.
- The subscription includes the Banks feature.
- **New** is available when you are creating an entry.
- You have edit permission when you are changing an existing entry.
- You have the bank short name, full name, and SWIFT code.

**Steps**

1. Choose the maintenance path that matches your task.

   | If you need to… | Select or open |
   | --- | --- |
   | Create a bank entry | **New** |
   | Change a saved bank entry | The saved bank's edit form |

2. Enter the bank's short name in **Bank short name**.
3. Enter the bank's full name in **Bank full name**.
4. Enter the bank's SWIFT code in **SWIFT code**.
5. Select **Save**.
6. If a validation message identifies forbidden characters, remove them from the affected value.

   | Message | Correction |
   | --- | --- |
   | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from the affected value. |
   | `Just '_' '-' And '.' Characters Accepted` | Use only the characters accepted by the field's pattern rule. |

7. Select **Save** again after correcting the value.
8. Confirm the result for the path you chose.

   | Path | Confirm |
   | --- | --- |
   | New bank | `Data saved Successfully` |
   | Existing bank | `Data updated Successfully` |

**Result:** The new entry is saved with `Data saved Successfully`, or the edited entry is saved
with `Data updated Successfully`. If validation stops the save, the form remains available for
correction.

### Remove a bank entry

Use deletion only when the bank entry is no longer needed. The product protects a list from being
left without an item and refuses deletion when saved data is related to the bank.

**Prerequisites**

- The Banks list is open.
- Delete permission is enabled.
- You have identified the bank row to remove.

**Steps**

1. In the identified entry's action column, select the delete control.
2. Choose one confirmation action after the product displays `Are you sure you want to delete this
   item?`.

   | If you need to… | Select |
   | --- | --- |
   | Keep the bank entry | **Cancel** |
   | Confirm removal | **Delete** |

3. If the deletion succeeds, confirm `Data Deleted Successfully`.
4. If the message is `Must have at least one item`, select **Cancel** and keep at least one bank
   entry in the list.
5. If the message is `Related to Saved data, Can't be deleted`, select **Cancel** and review
   the saved data related to it.
6. If the message is `Failed to Delete`, select **Cancel** and check whether the row remains.

**Result:** The delete menu closes without changing the list when you select **Cancel**. When you
select **Delete**, the entry is removed only when the product accepts the deletion and shows
`Data Deleted Successfully`.

### Export the Banks list

Use **Export** to begin the list-export flow without changing bank entries.

**Prerequisites**

- The Banks list is open.
- Export is available on your Banks toolbar.

**Steps**

1. Select **Export** in the Banks toolbar.

![The export control and export flow](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/82091efba338f3da750055515556d7c6.png)

**Result:** The Banks export flow begins after selecting **Export**.

## Handle availability branches

The Banks page can show a different surface when subscription inclusion or permissions change.
Use the table to identify the branch before following the maintenance procedure.

| Condition | What you see or can do |
| --- | --- |
| The subscription does not include the feature | The upgrade surface appears instead of the main grid |
| The subscription does not include Banks | The upgrade surface replaces the normal Banks grid |
| The configuration does not make **New** available | **New** is unavailable |
| Edit permission is unavailable | Editing is unavailable |
| Delete permission is unavailable | The row delete menu is hidden |
| Another configuration entry is selected | Its controls and fields replace the Banks controls |

If the grid is replaced by the subscription upgrade surface, contact the person who manages your
subscription.

## When maintenance goes wrong

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

| What you see | What it means | What to do |
| --- | --- | --- |
| `Are you sure you want to delete this item?` | The product requests deletion confirmation | Choose **Cancel** or **Delete** |
| `Forbidden characters detected. Please remove them and try again.` | A value contains a forbidden character | Remove the forbidden characters and select **Save** again |
| `Just '_' '-' And '.' Characters Accepted` | The field's pattern accepts only the listed characters | Correct the value to the accepted pattern and select **Save** again |
| `Must have at least one item` | The deletion would leave no item in the list | Keep at least one bank entry |
| `Related to Saved data, Can't be deleted` | Saved data is related to the bank | Keep the entry and review the related saved data |
| `Failed to Delete` | The delete operation failed | Check whether the row remains before retrying |
| `No data` while a loading indicator is present | The list is still loading at the time of the view | Wait for loading to finish before treating the list as empty |

## Messages on related configuration pages

These messages can appear in shared configuration areas reached from the Banks page or in the
export flow:

| Message | Where it applies |
| --- | --- |
| `Exporting List:` | Export flow |
| `Rating value` | Survey answers |
| `Add more` | Survey answers, reference questions, or reference question units |
| `Select a bank` | Bank accounts |
| `Select a Curriency` | Company currencies or bank accounts |

## Continue from Banks

For account-specific maintenance, use **Banks accounts**. For other setup areas, use the
configuration dashboard.

| If you need to… | Continue with |
| --- | --- |
| Maintain bank-account details | [**Banks accounts**](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-finance-banks-accounts) |
| Return to the configuration area | [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) |

Use [**Banks accounts**](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-finance-banks-accounts) when the task involves a bank
account rather than a bank entry. Use [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) when you
need to select another configuration area.
