[FW][IMP] accounting: update the bank accounts documentation

content/applications/finance/accounting/bank/setup/bank_accounts.rst

@@ -1,95 +1,136 @@
-=============
-Bank Accounts
-=============
+======================
+Bank and cash accounts
+======================
 
-You can manage as many **Bank Accounts** as needed on your database. Configuring them well allows
-you to make sure that all your banking data is up to date and ready for the reconciliation with your
-*Journal Entries*.
+You can manage as many bank or cash accounts as needed on your database. Configuring them well
+allows you to have all your banking data up-to-date and ready for :doc:`reconciliation
+<../../bank/reconciliation/use_cases>` with your journal entries.
 
-In Odoo Accounting, each Bank Account is configured to have a dedicated *Journal* which is
-configured to post all entries in a dedicated *Account*.
+In Odoo Accounting, each bank account has a dedicated journal set to post all entries in a dedicated
+account. Both the journal and the account are automatically created and configured whenever you add
+a bank account.
 
-.. note:: Whenever you add a Bank Account, a dedicated journal and a dedicated account are
-   automatically created and configured.
+.. note::
+   Cash journals and accounts must be configured manually.
 
-Every **Bank Journal** is displayed by default on the **Accounting Overview** in the form of a
-convenient card. It includes action buttons that are displayed when appropriate.
+Bank journals are displayed by default on the :guilabel:`Accounting Dashboard` in the form of cards
+which include action buttons.
 
-.. image:: bank_accounts/bank_accounts_card.png
+.. image:: bank_accounts/card.png
    :align: center
-   :alt: Bank Journals Cards are displayed on the Accounting Overview in Odoo Accounting
+   :alt: Bank journals are displayed on the Accounting Dashboard and contain action buttons
 
-.. _bank_accounts_add:
+.. _bank_accounts/manage:
 
-Add a new Bank Account
-======================
+Manage your bank and cash accounts
+==================================
+
+Connect your bank for automatic synchronization
+-----------------------------------------------
 
-You can either connect your bank account to your Odoo database, or configure your bank account
-manually and :doc:`upload the bank statements manually <../feeds/bank_statements>`.
+To connect your bank account to your database, go to :menuselection:`Accounting --> Configuration
+--> Banks: Add a Bank Account`, select your bank in the list, click on :guilabel:`Connect`, and
+follow the instructions.
 
-Bank Synchronization
---------------------
+.. seealso::
+   :doc:`../../bank/feeds/bank_synchronization`
+
+Create a bank account
+---------------------
 
-Connect your bank account to your database and have your bank statements synced automatically.
+If your banking institution is not available in Odoo, or if you don't want to connect your bank
+account to your database, you can configure your bank account manually.
 
-To synchronize a new bank account, go to :menuselection:`Accounting --> Configuration`, click on
-*Add a Bank Account*, then find your bank in the list, click on *Connect*, and follow the
-instructions on-screen.
+To manually add a bank account, go to :menuselection:`Accounting --> Configuration --> Banks:
+Add a Bank Account`, click on :guilabel:`Create it` (at the bottom right), and fill out the form.
 
 .. note::
-   :doc:`Click here <../../bank/feeds/bank_synchronization>` for more information about this bank
-   synchronization.
+   - Odoo automatically detects the bank account type (e.g., IBAN) and enables some features
+     accordingly.
+   - A default bank journal is available and can be used to configure your bank account by going to
+     :menuselection:`Accounting --> Configuration --> Accounting: Journals --> Bank`. Open it and
+     edit the different fields to match your bank account information.
 
-.. image:: bank_accounts/bank_accounts_connect.png
-   :align: center
-   :alt: Select a bank institution in the list and connect it to Odoo Accounting
+Create a cash journal
+---------------------
 
-Manual configuration
---------------------
+To create a new cash journal, go to :menuselection:`Accounting --> Configuration --> Accounting:
+Journals`, click on :guilabel:`Create` and select :guilabel:`Cash` in the :guilabel:`Type` field.
 
-If your Bank Institution can’t be synchronized automatically, or if you prefer not to sync it with
-your database, you may also configure your bank account manually.
+For more information on the accounting information fields, read the
+:ref:`bank_accounts/configuration` section of this page.
 
-To add a new bank account manually, go to :menuselection:`Accounting --> Configuration`, click on
-*Add a Bank Account*, then on *Create it*, and fill out the form.
+.. note::
+   A default cash journal is available and can be used straight away. You can review it by going to
+   :menuselection:`Accounting --> Configuration --> Accounting: Journals --> Cash`.
 
-- **Name**: the bank account's name, as displayed on Odoo.
-- **Account Number**: your bank account number (IBAN in Europe).
-- **Bank**: click on *Create and Edit* to configure the bank's details. Add the bank institution's
-  name and its Identifier Code (BIC or SWIFT).
-- **Code**: this code is your Journal's *Short Code*, as displayed on Odoo. By default, Odoo creates
-  a new Journal with this Short Code.
-- **Journal**: This field is displayed if you have an existing Bank Journal that is not linked yet
-  to a bank account. If so, then select the *Journal* you want to use to record the financial
-  transactions linked to this bank account or create a new one by clicking on *Create and Edit*.
+Edit an existing bank or cash journal
+-------------------------------------
 
-.. note::
-   Odoo detects the bank account type (e.g., IBAN) and enables some features accordingly.
+To edit an existing bank journal, go to :menuselection:`Accounting --> Configuration --> Accounting:
+Journals` and select the journal you want to modify.
+
+.. _bank_accounts/configuration:
+
+Configuration
+=============
+
+You can edit the accounting information and bank account number according to your needs.
 
-.. image:: bank_accounts/bank_accounts_manual.png
+.. image:: bank_accounts/bank-journal-config.png
    :align: center
-   :alt: Add manually a new bank account in Odoo Accounting
-.. _bank_accounts_configuration:
+   :alt: Manually configure your bank information
 
-Advanced configuration
-======================
+.. seealso::
+   - :doc:`../../others/multi_currency`
+   - :doc:`../../bank/feeds/bank_statements`
+   - :doc:`../../bank/setup/outstanding_accounts`
+
+Suspense account
+----------------
+
+Bank statement transactions are posted on the :guilabel:`Suspense Account` until the final
+reconciliation allows finding the right account.
+
+Profit and loss accounts
+------------------------
 
-To edit an existing bank account, go to :menuselection:`Accounting --> Configuration --> Bank
-Accounts`, and open the bank account you want to modify.
+The :guilabel:`Profit Account` is used to register a profit when the ending balance of a cash
+register differs from what the system computes, while the :guilabel:`Loss Account` is used to
+register a loss when the ending balance of a cash register differs from what the system computes.
 
-If you need to edit the bank account details, go to the *Bank Account* field and click on the
-*External Link* button next to the list arrow. There, you can edit the bank account's number,
-Account Holder, Account Holder Name, and your Bank Institution's details by clicking on the
-*External Link* next to the *Bank* field. These details are used to register some payments.
+Currency
+--------
 
-You can configure which types of payments are enabled in the **Payment Method Types** section and
-how the bank statements are recorded and posted in the **Bank Statements** section.
+You can edit the currency used to enter the statements.
 
-.. image:: bank_accounts/bank_accounts_configuration.png
+.. seealso::
+   :doc:`../../others/multi_currency`
+
+Account number
+--------------
+
+If you need to **edit your bank account details**, click on the external link arrow next to your
+:guilabel:`Account Number`. On the new page, click on the external link arrow next to your
+:guilabel:`Bank` and update your bank information accordingly. These details are used when
+registering payments.
+
+.. image:: bank_accounts/bank-account-number.png
    :align: center
-   :alt: Advanced configuration of a bank account in Odoo Accounting
+   :alt: Edit your bank information
+
+Bank feeds
+----------
+
+:guilabel:`Bank Feeds` defines how the bank statements are registered. Three options are available:
+
+- :guilabel:`Undefined yet`, which should be selected when you don’t know yet if you will
+  synchronize your bank account with your database or not.
+- :guilabel:`Import (CAMT, CODA, CSV, OFX, QIF)`, which should be selected if you want to import
+  your bank statement using a different format.
+- :guilabel:`Automated Bank Synchronization`, which should be selected if your bank is synchronized
+  with your database.
 
 .. seealso::
-   * :doc:`../../bank/feeds/bank_synchronization`
-   * :doc:`../feeds/bank_statements`
-   * `Odoo Tutorials: Accounting Basics <https://www.odoo.com/r/lsZ>`_
+   - :doc:`../../bank/feeds/bank_synchronization`
+   - :doc:`../../bank/feeds/bank_statements`