[IMP] accounting: Bank Synchronization: automatic import

closes odoo/documentation#2896

X-original-commit: 7fb5a21d64
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
This commit is contained in:
“Chiara 2022-10-27 12:17:33 +00:00
parent 5ad9d5eb0b
commit 6af8a4d01d
5 changed files with 53 additions and 60 deletions

View File

@ -1,18 +1,15 @@
====================================== ======================================
Bank synchronization: Automatic import Bank synchronization: automatic import
====================================== ======================================
Odoo can synchronize directly with your bank institution to get all bank statements imported Odoo can synchronize directly with your bank institution to get all bank statements imported
automatically into your database. automatically into your database.
To check if your bank is compatible with Odoo, go to `Odoo Accounting Features To check if your bank is compatible with Odoo, go to `Odoo Accounting Features
<https://www.odoo.com/page/accounting-features>`_, and click on *See list of supported institutions*. <https://www.odoo.com/page/accounting-features>`_, and click on
:guilabel:`See list of supported institutions`.
.. image:: bank_synchronization/online-sync-doc.png Odoo supports more than 25,000 institutions around the world.
:align: center
:alt: Checking a bank's compatibility with Odoo
More than 20,000 institutions around the world are supported.
To connect to the banks, Odoo uses multiple web-services: To connect to the banks, Odoo uses multiple web-services:
@ -20,9 +17,7 @@ To connect to the banks, Odoo uses multiple web-services:
- **Yodlee**: Worldwide - **Yodlee**: Worldwide
- **Salt Edge**: Europe (:doc:`more information <saltedge>`) - **Salt Edge**: Europe (:doc:`more information <saltedge>`)
- **Ponto**: Europe (:doc:`more information <ponto>`) - **Ponto**: Europe (:doc:`more information <ponto>`)
- **EnableBanking**: Scandinavian countries
.. important::
- Bank synchronization is not available for trial databases.
Configuration Configuration
============= =============
@ -38,49 +33,50 @@ following address:
- https://production.odoofin.com/ - https://production.odoofin.com/
First Synchronization First synchronization
--------------------- ---------------------
You can start synchronization either by going to :menuselection:`Accounting --> Configuration You can start synchronization either by going to the Accounting app and
--> Add a Bank Account` or via the configuration bar on the accounting dashboard. :menuselection:`Accounting Dashboard --> Configuration --> Banks: Add a Bank Account`.
Now you can search for your bank institution. Select it and follow the steps to synchronize with it. Now you can search for your bank institution. Select it and follow the steps to synchronize with it.
.. note:: .. note::
If you have any issues during your first synchronization, please verify that your If you have any issues during your first synchronization, please verify that your
web browser doesn't block pop-ups and that your adblocker is disabled. web browser doesn't block pop-ups and that your ad-blocker is disabled.
During your first synchronization, you will be asked for a phone number to secure your account. .. important::
The reason we ask for such information is that we don't want your data falling into the wrong When choosing the date for the first bank statement synchronization, pick the date when you
hands. Therefore, if we detect suspicious activity on your account, we block all requests coming start recording accounting transaction on your Odoo accounting database. For example, if you
from your account, and you need to reactivate it using that phone number. import your closing balance in Odoo on the 31/12/2022 and you start recording accounting
The third-party provider may request more information in order to connect with your bank institution. transactions on the 01/01/2023, your synchronization date should be 01/01/2023.
You must provide a phone number during your first synchronization to secure your account. We ask for
such information because we don't want your data falling into the wrong hands. Therefore, if we
detect suspicious activities on your account, we block all requests coming from your account, and
you need to reactivate it using that phone number.
The third-party provider may request more information in order to connect with your
bank institution.
This information is not stored on Odoo's servers. This information is not stored on Odoo's servers.
By default, transactions fetched from an online source are grouped inside the same statement, and By default, transactions fetched from an online source are grouped inside the same statement, and
one bank statement is created per month. You can change the bank statement creation periodicity one bank statement is created per month. You can change the bank statement creation periodicity
in your journal settings. in your journal settings.
You can find all your synchronizations by going to :menuselection:`Accounting --> Configuration --> You can find all your synchronizations by going to :menuselection:`Accounting Dashboard -->
Online Synchronization`. Configuration --> Accounting: Online Synchronization`.
Synchronize manually Synchronize manually
-------------------- --------------------
After your first synchronization, the created journals are synchronized by default every 12 hours. After your first synchronization, the created journals are synchronized by default every 12 hours.
If you wish, you can synchronize manually by clicking on the *Synchronize Now* button on the If you wish, you can synchronize manually by clicking on the :guilabel:`Synchronize Now` button on
dashboard. the dashboard.
.. image:: bank_synchronization/online-sync-sync-now-dashboard.png Or you can go to :menuselection:`Accounting Dashboard --> Configuration -->
:align: center Accounting: Online Synchronization`, select your institution and then click on the
:alt: Synchronize Now Button :guilabel:`fetch transactions` button.
Or you can go to :menuselection:`Accounting --> Configuration --> Online Synchronization`,
select your institution and then click on the *Fetch Transactions* button.
.. image:: bank_synchronization/online-sync-form-view.png
:align: center
:alt: Online Synchronization Form view
.. important:: .. important::
Some institutions do not allow transactions to be fetched automatically. For such institutions, Some institutions do not allow transactions to be fetched automatically. For such institutions,
@ -95,14 +91,14 @@ Synchronization in error
------------------------ ------------------------
To report a connection error to the `Odoo support <https://www.odoo.com/help>`_, go to To report a connection error to the `Odoo support <https://www.odoo.com/help>`_, go to
:menuselection:`Accounting --> Configuration --> Online Synchronization`, select the connection :menuselection:`Accounting Dashboard--> Configuration --> Accounting: Online Synchronization`,
that failed, and copy the error description and the reference. select the connection that failed, and copy the error description and the reference.
Synchronization disconnected Synchronization disconnected
---------------------------- ----------------------------
If your connection with the proxy is disconnected, you can reconnect with the proxy using the If your connection with the proxy is disconnected, you can reconnect with the proxy using the
*Reconnect* button. :guilabel:`Fetch Account` button.
.. note:: .. note::
This disconnection can be caused by the Odoo support. In this case, please contact the `support This disconnection can be caused by the Odoo support. In this case, please contact the `support
@ -121,24 +117,19 @@ Users who have created a database before December 2020 need to install the new m
use the new functionalities. use the new functionalities.
To do so, go to :menuselection:`Apps --> Update Apps List`, remove the default filter in the search To do so, go to :menuselection:`Apps --> Update Apps List`, remove the default filter in the search
bar and type: **account_online_synchronization**. You can then click on the *Install* button to bar and type `account_online_synchronization`. You can then click on :guilabel:`Install`.
install the new module.
.. image:: bank_synchronization/online-sync-module.png
:align: center
:alt: Installation button of the account_online_synchronization module
Finally, make sure all your users refresh their Odoo page by pressing CTRL+F5. Finally, make sure all your users refresh their Odoo page by pressing CTRL+F5.
.. Note:: .. Note::
- All previous synchronizations are disconnected during the installation and won't work anymore. - All previous synchronizations are disconnected during the installation and won't work anymore.
You can find them directly in the synchronization menu (:menuselection:`Accounting --> - You can find them directly in the synchronization menu
Configuration --> Online Synchronization`). It is not possible to resynchronize these (:menuselection:`Accounting Dashboard --> Configuration -->
connections; you have to make new ones. Accounting: Online Synchronization`). It is not possible to resynchronize these connections;
- Please do not uninstall *account_online_sync* which is the previous module for online you have to make new ones.
- Do not uninstall `account_online_sync`, which is the previous module for online
synchronization. The new one overrides it. synchronization. The new one overrides it.
- By default *account_online_synchronization* is installed automatically with Accounting. - By default, `account_online_synchronization` is installed automatically with Accounting.
FAQ FAQ
=== ===
@ -148,14 +139,15 @@ The synchronization is not working in real-time. Is that normal?
The process is not intended to work in real-time as third party providers synchronize your accounts The process is not intended to work in real-time as third party providers synchronize your accounts
at different intervals. To force the synchronization and fetch the statements, go to your at different intervals. To force the synchronization and fetch the statements, go to your
*Accounting dashboard*, and click on the *Synchronize Now* button. You can also synchronize and :guilabel:`Accounting Dashboard`, and click on the :guilabel:`Synchronize Now` button. You can also
fetch transactions through :menuselection:`Accounting --> Configuration --> Online Synchronization`. synchronize and fetch transactions through :menuselection:`Accounting Dashboard -->
Some providers only allow one refresh per day, so it is possible that clicking on *Synchronize Now* Configuration --> Accounting: Online Synchronization`. Some providers only allow one refresh per
does not get your latest transactions if you already performed such action earlier in the day. day, so it is possible that clicking on :guilabel:`Synchronize Now` does not get your latest
transactions if you already performed such action earlier in the day.
A transaction can be visible on your bank account, but not be fetched if it has the status A transaction can be visible on your bank account but not be fetched if it has the status
*Pending*. Only transactions with the *Posted* status will be retrieved. If it is not *Posted* yet, :guilabel:`Pending`. Only transactions with the :guilabel:`Posted` status will be retrieved. If the
you will have to wait until the status changes. transaction is not **Posted** yet, you will have to wait until the status changes.
Is the Online Bank Synchronization feature included in my contract? Is the Online Bank Synchronization feature included in my contract?
------------------------------------------------------------------- -------------------------------------------------------------------
@ -188,8 +180,9 @@ Why don't I see any transactions?
--------------------------------- ---------------------------------
During your first synchronization, you selected the bank accounts you decided to synchronize with During your first synchronization, you selected the bank accounts you decided to synchronize with
Odoo. If you didn't synchronize any of your accounts, you can go to :menuselection:`Accounting --> Odoo. If you didn't synchronize any of your accounts, you can go to
Configuration --> Online Synchronization` to click on the *Fetch Accounts* button on the connection. :menuselection:`Accounting Dashboard --> Configuration --> Accounting: Online Synchronization` to
click on the :guilabel:`Fetch Account` button on the connection.
There may also be no new transactions. There may also be no new transactions.
@ -199,9 +192,9 @@ database, please `submit a support ticket <https://www.odoo.com/help>`_.
How can I update my bank credentials? How can I update my bank credentials?
------------------------------------- -------------------------------------
You can update your credentials by going to :menuselection:`Accounting --> Configuration --> Online You can update your credentials by going to :menuselection:`Accounting Dashboard -->
Synchronization`, open the connection you want to update your credentials and click on the *Update Configuration --> Accounting: Online Synchronization`,open the connection you want to update your
Credentials* button. credentials and click on the :guilabel:`Update Credentials` button.
.. seealso:: .. seealso::
* :doc:`bank_statements` * :doc:`bank_statements`

Binary file not shown.

Before

Width:  |  Height:  |  Size: 28 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 4.1 KiB