[IMP] accounting: update bank synchronization page
task-4981233
closes odoo/documentation#15006
X-original-commit: 87c24cc8b0
Signed-off-by: Audrey Vandromme (auva) <auva@odoo.com>
Signed-off-by: Anne-Françoise Marcq (afma) <afma@odoo.com>
@@ -4,208 +4,286 @@
|
||||
Bank synchronization
|
||||
====================
|
||||
|
||||
Odoo can synchronize directly with your bank institution to get all bank statements imported
|
||||
automatically into your database.
|
||||
Odoo synchronizes directly with your bank institution to automatically import all bank transactions
|
||||
into the database. It supports over 26,000 financial institutions worldwide and relies on multiple
|
||||
:ref:`third-party providers <accounting/bank-synchronization/third-party-providers>` to connect with
|
||||
banks.
|
||||
|
||||
.. note::
|
||||
To use this service, a valid Odoo Enterprise subscription is required.
|
||||
|
||||
.. tip::
|
||||
To check if your bank is compatible with Odoo, go to `Odoo Accounting Features
|
||||
<https://www.odoo.com/page/accounting-features>`_, and click on
|
||||
:guilabel:`See list of supported institutions`.
|
||||
|
||||
Odoo supports more than 26,000 institutions around the world.
|
||||
|
||||
To connect to the banks, Odoo uses multiple web-services:
|
||||
|
||||
- **Plaid**: United States of America and Canada
|
||||
- **Yodlee**: Worldwide
|
||||
- :doc:`Salt Edge <bank_synchronization/saltedge>`: Worldwide
|
||||
- :doc:`Ponto <bank_synchronization/ponto>`: Europe
|
||||
- :doc:`Enable Banking <bank_synchronization/enablebanking>`: Scandinavian countries
|
||||
<https://www.odoo.com/app/accounting-features#part_5>`_, and click :guilabel:`See list of
|
||||
supported institutions` in the :guilabel:`Bank & Cash` section.
|
||||
|
||||
.. seealso::
|
||||
:doc:`transactions`
|
||||
|
||||
.. _accounting/bank-synchronization/configuration:
|
||||
|
||||
Configuration
|
||||
=============
|
||||
|
||||
On-Premise users
|
||||
----------------
|
||||
|
||||
To be able to use this service, you need to have a valid Odoo Enterprise subscription.
|
||||
So make sure that your database is registered with your Odoo Enterprise contract.
|
||||
We also use a proxy between your database and the third party provider so, in case of
|
||||
a connection error, please check that you don't have a firewall or a proxy blocking the
|
||||
following address:
|
||||
|
||||
- https://production.odoofin.com/
|
||||
.. _accounting/bank-synchronization/first-synchronization:
|
||||
|
||||
First synchronization
|
||||
---------------------
|
||||
|
||||
You can start synchronization either by going to the Accounting app and
|
||||
:menuselection:`Accounting --> Configuration --> Add a Bank Account`.
|
||||
To synchronize the database with a bank, go to the Accounting Dashboard, click the
|
||||
:icon:`fa-ellipsis-v` :guilabel:`(vertical ellipsis)` icon of the :guilabel:`Bank` journal, and
|
||||
:guilabel:`Connect bank`. In the :guilabel:`Search for an institution` window, select the relevant
|
||||
bank and click :guilabel:`Connect`.
|
||||
|
||||
Now you can search for your bank institution. Select it and follow the steps to synchronize with it.
|
||||
|
||||
.. note::
|
||||
If you have any issues during your first synchronization, please verify that your
|
||||
web browser doesn't block pop-ups and that your ad-blocker is disabled.
|
||||
.. tip::
|
||||
- Alternatively, go to :menuselection:`Accounting --> Configuration --> Add a Bank Account` or
|
||||
click :guilabel:`Search over 26000 banks` in the Accounting dashboard.
|
||||
- Depending on your bank and country, you can select the :guilabel:`Type of account` and/or
|
||||
choose another :ref:`third-party provider <accounting/bank-synchronization/third-party-providers>`
|
||||
to connect with the bank if needed before clicking :guilabel:`Connect`.
|
||||
- If your bank is not listed in the :guilabel:`Search for an institution` window, scroll down the
|
||||
list and click :icon:`fa-plus` :guilabel:`Add new bank` to create a bank account manually. Fill
|
||||
in the :guilabel:`Account Number`, :guilabel:`Bank`, and :guilabel:`SWIFT Code` and click
|
||||
:guilabel:`Connect`. A bank journal is then created and named using the account number. Note
|
||||
that in this case, the bank is not synchronized.
|
||||
- If issues occur during the first synchronization, check that no firewall or proxy is blocking
|
||||
the address https://production.odoofin.com/. Make sure your web browser allows pop-ups and that
|
||||
any ad-blocker is disabled.
|
||||
|
||||
.. important::
|
||||
When setting up the bank statement synchronization, Odoo automatically starts recording the
|
||||
accounting transactions from the last transaction’s date +1 day (if the last transaction day is
|
||||
31/12/2022, the recording starts on 01/01/2023). If the journal contains no transaction, Odoo
|
||||
retrieves transactions as far back as possible. You can limit how far back Odoo retrieves
|
||||
transactions by opening the Accounting app, going to :menuselection:`Accounting --> Lock Dates`,
|
||||
and setting a date in the :guilabel:`Journal Entries Lock Date` field.
|
||||
When setting up bank synchronization, accounting transactions are automatically recorded from the
|
||||
date of the last transaction +1 day (e.g., if the last transaction date is 31/12/2025, the
|
||||
recording starts on 01/01/2026). If the journal contains no transactions, all available past
|
||||
transactions are retrieved. To limit the retrieval period, go to :menuselection:`Accounting -->
|
||||
Accounting --> Lock Dates`, and set a date in the :guilabel:`Lock Everything` field.
|
||||
|
||||
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.
|
||||
|
||||
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
|
||||
in your journal settings.
|
||||
|
||||
To view all your synchronizations, activate the :ref:`developer mode <developer-mode>` and go to
|
||||
.. note::
|
||||
- Some banks are in a :guilabel:`Beta` status, meaning they're not yet fully supported by
|
||||
third-party providers. This may lead to bugs or other issues. Although they can be used, Odoo
|
||||
does not provide technical support in this case.
|
||||
- The :ref:`third-party provider <accounting/bank-synchronization/third-party-providers>` may
|
||||
request more information to connect with a bank. This information is not stored on Odoo's
|
||||
servers.
|
||||
- To view all past synchronizations, activate the :ref:`developer mode <developer-mode>` and go to
|
||||
:menuselection:`Accounting --> Configuration --> Online Synchronization`.
|
||||
|
||||
Synchronize manually
|
||||
--------------------
|
||||
.. _accounting/bank-synchronization/manual-synchronization:
|
||||
|
||||
After your first synchronization, the created journals are synchronized by default every 12 hours.
|
||||
If you wish, you can synchronize them manually by clicking on the :guilabel:`Synchronize Now` button
|
||||
on the dashboard.
|
||||
Manual synchronization
|
||||
----------------------
|
||||
|
||||
After the :ref:`first synchronization <accounting/bank-synchronization/first-synchronization>`, bank
|
||||
journals are synchronized by default every twelve hours. To manually trigger synchronization, go to
|
||||
the Accounting dashboard and click :guilabel:`Fetch Transactions` on the relevant bank journal.
|
||||
|
||||
.. tip::
|
||||
Alternatively, activate the :ref:`developer mode <developer-mode>`, go to
|
||||
:menuselection:`Accounting --> Configuration --> Online Synchronization`, select your institution,
|
||||
and then click the :guilabel:`Fetch transactions` button.
|
||||
|
||||
.. important::
|
||||
Some institutions do not allow transactions to be fetched automatically. For such institutions,
|
||||
during the automatic synchronization of the account, you receive an error message asking you to
|
||||
disable the automatic synchronization. This message can be found in the chatter of your online
|
||||
synchronizations. In this case, make sure to perform manual synchronizations.
|
||||
|
||||
Issues
|
||||
======
|
||||
|
||||
Synchronization in error
|
||||
------------------------
|
||||
|
||||
To report a connection error to the `Odoo support <https://www.odoo.com/help>`_, activate the
|
||||
:ref:`developer mode <developer-mode>`, go to :menuselection:`Accounting --> Configuration -->
|
||||
Online Synchronization`, select the connection that failed, and copy the error description and the
|
||||
reference.
|
||||
|
||||
Synchronization disconnected
|
||||
----------------------------
|
||||
|
||||
If your connection with the proxy is disconnected, you can reconnect with the proxy using the
|
||||
:guilabel:`Fetch Account` button.
|
||||
:menuselection:`Accounting --> Configuration --> Online Synchronization`, select the relevant
|
||||
bank, and click :guilabel:`Fetch transactions`.
|
||||
|
||||
.. note::
|
||||
If you are unable to reconnect using the :guilabel:`Reconnect` button, please contact the
|
||||
`support <https://www.odoo.com/help>`_ directly with your client id or the reference of the error
|
||||
listed in the chatter.
|
||||
- Some banks do not support automatic transaction fetching. For these institutions, an error
|
||||
message appears during the automatic account synchronization, prompting the user to disable the
|
||||
automatic synchronization. This message is also logged in the chatter of the online
|
||||
synchronization. In such cases, disable the :guilabel:`Automatic synchronization` option in the
|
||||
corresponding bank's :guilabel:`Online Synchronization` and make sure to perform manual
|
||||
synchronizations by clicking :guilabel:`Fetch Transactions` on the relevant bank journal.
|
||||
- For some bank institutions, transactions can only be fetched up to three months in the past. If
|
||||
older transactions are needed, they can be :ref:`imported <accounting/transactions/import>`.
|
||||
|
||||
.. _MigrationOnlineSync:
|
||||
.. _accounting/bank-synchronization/update-credentials:
|
||||
|
||||
Migration process for users having installed Odoo before December 2020
|
||||
======================================================================
|
||||
Update synchronization credentials
|
||||
----------------------------------
|
||||
|
||||
If you are on-premise, please first make sure that your source is up-to-date with the latest version
|
||||
of Odoo.
|
||||
To update bank credentials, activate the :ref:`developer mode <developer-mode>`, and go to
|
||||
:menuselection:`Accounting --> Configuration --> Online Synchronization`. Open the connection that
|
||||
needs to be updated, click :guilabel:`Update Credentials`, and follow the steps.
|
||||
|
||||
Users who have created a database before December 2020 need to install the new module manually to
|
||||
use the new functionalities.
|
||||
.. note::
|
||||
- The steps may vary depending on the third-party provider, as each provider follows its own
|
||||
process.
|
||||
- When updating bank credentials, make sure all accounts are selected for synchronization,
|
||||
including those from other banking institutions if applicable.
|
||||
|
||||
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 :guilabel:`Install`.
|
||||
Finally, make sure all your users refresh their Odoo page by pressing CTRL+F5.
|
||||
.. _accounting/bank-synchronization/third-party-providers:
|
||||
|
||||
.. Note::
|
||||
Third-party providers
|
||||
---------------------
|
||||
|
||||
- All previous synchronizations are disconnected during the installation and will not work
|
||||
anymore. To view them, activate the :ref:`developer mode <developer-mode>` and go to
|
||||
:menuselection:`Accounting --> Configuration --> Online Synchronization`. It is not possible
|
||||
to resynchronize these connections; you have to make new ones.
|
||||
- Do not uninstall the `account_online_sync` module, which is the previous module for online
|
||||
synchronization. The new one overrides it.
|
||||
- By default, the `account_online_synchronization` module is installed automatically with
|
||||
Accounting.
|
||||
Odoo relies on third-party providers to securely connect to your bank accounts and automatically
|
||||
import transactions and financial data into the database. The following providers are used:
|
||||
|
||||
FAQ
|
||||
===
|
||||
- `Plaid <https://plaid.com/discover-apps/>`_ (supported in the `United States of America and Canada
|
||||
<https://plaid.com/docs/institutions/>`_)
|
||||
- `Yodlee <https://www.yodlee.com/>`_ (supported in Europe)
|
||||
- `Salt Edge <https://www.saltedge.com/>`_ (supported `worldwide
|
||||
<https://www.saltedge.com/products/account_information/coverage>`_)
|
||||
- :doc:`Ponto <bank_synchronization/ponto>` (supported in Europe)
|
||||
- `Enable Banking <https://enablebanking.com/>`_ (supported in `Scandinavian countries
|
||||
<https://enablebanking.com/open-banking-apis>`_)
|
||||
|
||||
The synchronization is not working in real-time. Is that normal?
|
||||
----------------------------------------------------------------
|
||||
.. tip::
|
||||
When :ref:`connecting a bank to Odoo <accounting/bank-synchronization/first-synchronization>`:
|
||||
|
||||
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
|
||||
:guilabel:`Accounting Dashboard`, and click on the :guilabel:`Synchronize Now` button. Synchronize
|
||||
and fetch transactions by activating the :ref:`developer mode <developer-mode>` and going to
|
||||
:menuselection:`Accounting --> Configuration --> Online Synchronization`. Some providers only allow
|
||||
one refresh per 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.
|
||||
- Depending on your bank and country, change the default third-party provider when selecting the
|
||||
bank, if necessary.
|
||||
- Make sure to check the consent checkbox to allow information to be shared with Odoo.
|
||||
- Select all accounts that need access and synchronization, including those from other banking
|
||||
institutions.
|
||||
|
||||
A transaction can be visible on your bank account but not be fetched if it has the status
|
||||
:guilabel:`Pending`. Only transactions with the :guilabel:`Posted` status will be retrieved. If the
|
||||
transaction is not **Posted** yet, you will have to wait until the status changes.
|
||||
.. seealso::
|
||||
- :ref:`Bank synchronization troubleshooting <accounting/bank-synchronization/troubleshooting>`
|
||||
- :ref:`Salt Edge bank synchronization troubleshooting
|
||||
<accounting/bank-synchronization/troubleshooting-saltedge>`
|
||||
- :ref:`Ponto bank synchronization troubleshooting
|
||||
<accounting/bank-synchronization/ponto/troubleshooting>`
|
||||
|
||||
Is the Online Bank Synchronization feature included in my contract?
|
||||
-------------------------------------------------------------------
|
||||
.. _accounting/bank-synchronization/duplicate-transactions:
|
||||
|
||||
- **Community Edition**: No, this feature is not included in the Community Version.
|
||||
- **Online Edition**: Yes, even if you benefit from the One App Free contract.
|
||||
- **Enterprise Edition**: Yes, if you have a valid enterprise contract linked to your database.
|
||||
Duplicate transactions
|
||||
======================
|
||||
|
||||
Some banks have a status "Beta." What does this mean?
|
||||
-----------------------------------------------------
|
||||
When importing transactions, some may appear duplicated due to the same online transaction
|
||||
identifier or the same currency, amount, account number, and date.
|
||||
|
||||
This means that banking institutions are not yet fully supported by our Third Party Provider. Bugs
|
||||
or other problems may arise. Odoo does not support technical problems that occur with banks in the
|
||||
Beta phase, but the user may still choose to connect. Connecting with these banks contributes to the
|
||||
development process since the Provider will have real data and feedback from the connection.
|
||||
To search for duplicate transactions, access the :ref:`bank reconciliation view
|
||||
<accounting/reconciliation/access>`, then follow these steps:
|
||||
|
||||
#. Click the :icon:`fa-cog` :guilabel:`(gear)` icon, and select :guilabel:`Find Duplicate
|
||||
Transactions`.
|
||||
#. All duplicate transactions from the starting date are displayed in the :guilabel:`Transactions`
|
||||
tab. Update the :guilabel:`Starting Date` if needed.
|
||||
#. To delete a transaction, select it, click :guilabel:`Delete Selected`, and confirm.
|
||||
|
||||
.. note::
|
||||
Journal entries can only be deleted if they have not been reconciled.
|
||||
|
||||
.. _accounting/bank-synchronization/missing-transactions:
|
||||
|
||||
Missing transactions
|
||||
====================
|
||||
|
||||
Missing or pending transactions are entries that the bank has not yet validated.
|
||||
|
||||
To find missing and pending transactions, access the :ref:`bank reconciliation view
|
||||
<accounting/reconciliation/access>`, click the :icon:`fa-cog` :guilabel:`(gear)` icon, and select
|
||||
:guilabel:`Find Missing Transactions`.
|
||||
|
||||
To import a posted missing transaction, select it and click :guilabel:`Import Transactions`.
|
||||
|
||||
.. note::
|
||||
- Make sure the connection with the bank is active to find missing transactions.
|
||||
- :guilabel:`Pending` transactions cannot be imported.
|
||||
|
||||
.. _accounting/bank-synchronization/troubleshooting:
|
||||
|
||||
Troubleshooting
|
||||
===============
|
||||
|
||||
.. seealso::
|
||||
:ref:`Bank synchronization troubleshooting - Ponto
|
||||
<accounting/bank-synchronization/ponto/troubleshooting>`
|
||||
|
||||
.. _accounting/bank-synchronization/troubleshooting/synchronization:
|
||||
|
||||
Synchronization errors or disconnections
|
||||
----------------------------------------
|
||||
|
||||
To report a connection error to `Odoo support <https://www.odoo.com/help>`_, activate the
|
||||
:ref:`developer mode <developer-mode>`, go to :menuselection:`Accounting --> Configuration -->
|
||||
Online Synchronization`, select the failed connection, and copy the error description and the
|
||||
reference.
|
||||
|
||||
If the connection with the proxy is lost and reconnection using the :guilabel:`Reconnect` option
|
||||
isn't successful, contact `support <https://www.odoo.com/help>`_ directly. Provide the client ID or
|
||||
the error reference from the chatter.
|
||||
|
||||
.. _accounting/bank-synchronization/troubleshooting/real-time:
|
||||
|
||||
Why is the synchronization not working in real-time?
|
||||
----------------------------------------------------
|
||||
|
||||
Synchronization is not designed to work in real time, as third-party providers synchronize accounts
|
||||
at different intervals. To manually trigger synchronization and retrieve bank transactions, go to
|
||||
the :guilabel:`Accounting Dashboard`, and click :guilabel:`Fetch Transactions`.
|
||||
|
||||
Alternatively, to synchronize and fetch transactions, activate the :ref:`developer mode
|
||||
<developer-mode>` and go to :menuselection:`Accounting --> Configuration --> Online
|
||||
Synchronization`.
|
||||
|
||||
Some providers restrict refreshes to once per day. If transactions have already been fetched,
|
||||
clicking :guilabel:`Fetch Transactions` again may not retrieve the latest data.
|
||||
|
||||
Transactions may appear on a bank account, but cannot be fetched if they have a :guilabel:`Pending`
|
||||
status; only transactions with a :guilabel:`Posted` status are retrieved.
|
||||
|
||||
.. _accounting/bank-synchronization/troubleshooting/refresh-manually:
|
||||
|
||||
Why do my transactions only synchronize when I refresh manually?
|
||||
----------------------------------------------------------------
|
||||
|
||||
Some banks have additional security measures and require extra steps, such as an SMS/email
|
||||
authentication code or another type of MFA. Because of this, the integrator cannot pull transactions
|
||||
until the security code is provided.
|
||||
Some banks implement additional security measures and require extra steps, such as an SMS or email
|
||||
authentication code, or another type of :abbr:`MFA (multi-factor authentication)`. As a result,
|
||||
the third-party provider cannot retrieve transactions until the security code is provided.
|
||||
|
||||
Not all of my past transactions are in Odoo, why?
|
||||
-------------------------------------------------
|
||||
.. _accounting/bank-synchronization/troubleshooting/visible-transactions:
|
||||
|
||||
For some institutions, transactions can only be fetched up to 3 months in the past.
|
||||
Why are no transactions visible?
|
||||
--------------------------------
|
||||
|
||||
Why don't I see any transactions?
|
||||
---------------------------------
|
||||
There are a few possible reasons for this issue:
|
||||
|
||||
During your first synchronization, you selected the bank accounts you decided to synchronize with
|
||||
Odoo. If you didn't synchronize any of your accounts, activate the :ref:`developer mode
|
||||
<developer-mode>`, go to :menuselection:`Accounting --> Configuration --> Online Synchronization`,
|
||||
and click the :guilabel:`Fetch Account` button on the connection.
|
||||
- No bank accounts were synchronized during the :ref:`first synchronization
|
||||
<accounting/bank-synchronization/first-synchronization>`.
|
||||
- There may be no new transactions available to fetch.
|
||||
|
||||
There may also be no new transactions.
|
||||
If the bank account is correctly linked to a journal, but posted transactions still aren't visible
|
||||
in the database, contact `support <https://www.odoo.com/help>`_.
|
||||
|
||||
If your bank account is properly linked to a journal and posted transactions are not visible in your
|
||||
database, please `submit a support ticket <https://www.odoo.com/help>`_.
|
||||
.. _accounting/bank-synchronization/troubleshooting/no-account-appearing:
|
||||
|
||||
How can I update my bank credentials?
|
||||
-------------------------------------
|
||||
Why are no accounts shown after synchronization?
|
||||
------------------------------------------------
|
||||
|
||||
During the synchronization process, a bank institution was selected, but no bank accounts from this
|
||||
institution were authorized during the :ref:`first synchronization
|
||||
<accounting/bank-synchronization/first-synchronization>`.
|
||||
|
||||
.. _accounting/bank-synchronization/troubleshooting-saltedge:
|
||||
|
||||
Saltedge troubleshooting
|
||||
------------------------
|
||||
|
||||
.. _accounting/bank-synchronization/troubleshooting/saltedge/deleting-error:
|
||||
|
||||
Why is there an error when deleting a synchronization in Odoo?
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
Odoo can't permanently delete the connection established with the banking institution. However,
|
||||
it revokes consent, which prevents Odoo from accessing the account. The error message indicates that
|
||||
the consent has been revoked, but the record could not be deleted as it remains in Salt Edge.
|
||||
|
||||
To delete the connection, connect to the `Salt Edge account <https://www.saltedge.com/dashboard>`_
|
||||
and manually remove the synchronization. Once this is done, the record can be deleted in Odoo.
|
||||
|
||||
.. _accounting/bank-synchronization/troubleshooting/saltedge/account-already-synchronized:
|
||||
|
||||
I have an error saying that this account has already been synchronized
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
The bank account has already been synchronized with Salt Edge. Access the Salt Edge `dashboard
|
||||
<https://www.saltedge.com/dashboard>`_ to check if a connection with the same credentials exists.
|
||||
There are two options:
|
||||
|
||||
- If a connection with the same credentials exists in Salt Edge but has not been synchronized with
|
||||
Odoo, delete the existing connection and create a new one from the Odoo database.
|
||||
- If a connection with the same credentials exists in Salt Edge and has already been synchronized
|
||||
with Odoo, :ref:`update the synchronization credentials
|
||||
<accounting/bank-synchronization/update-credentials>` to reactivate the connection.
|
||||
|
||||
To update your credentials, activate the :ref:`developer mode <developer-mode>` and go to
|
||||
:menuselection:`Accounting --> Configuration --> Online Synchronization`. Open the connection you
|
||||
want to update your credentials and click the :guilabel:`Update Credentials` button.
|
||||
|
||||
.. toctree::
|
||||
:titlesonly:
|
||||
|
||||
bank_synchronization/saltedge
|
||||
bank_synchronization/ponto
|
||||
bank_synchronization/enablebanking
|
||||
|
||||
@@ -1,34 +0,0 @@
|
||||
==============
|
||||
Enable Banking
|
||||
==============
|
||||
|
||||
**Enable Banking** is a third-party provider aggregating banking information from bank accounts all
|
||||
in one place. It offers non-intrusive connectivity to ASPSPs' official APIs across Europe without
|
||||
storing data.
|
||||
|
||||
.. image:: enablebanking/enablebanking.png
|
||||
:alt: Enable Banking logo
|
||||
|
||||
**Odoo** synchronizes directly with banks to get access to all bank transactions and automatically
|
||||
import them into your database.
|
||||
|
||||
.. seealso::
|
||||
- :doc:`../bank_synchronization`
|
||||
- `Enable Banking website <https://enablebanking.com/>`_
|
||||
|
||||
Configuration
|
||||
=============
|
||||
|
||||
Link bank accounts with Odoo
|
||||
----------------------------
|
||||
|
||||
#. Start synchronization by clicking on :menuselection:`Accounting --> Configuration -->
|
||||
Add a Bank Account`;
|
||||
#. Select your bank;
|
||||
#. Make sure you give your consent to share your account information with Odoo by clicking
|
||||
:guilabel:`Continue authentication`;
|
||||
|
||||
.. image:: enablebanking/enablebankingauth.png
|
||||
:alt: Enable Banking authentication page
|
||||
|
||||
#. Finally, you are redirected to your bank's login page.
|
||||
|
Before Width: | Height: | Size: 2.5 KiB |
|
Before Width: | Height: | Size: 15 KiB |
@@ -2,107 +2,113 @@
|
||||
Ponto
|
||||
=====
|
||||
|
||||
**Ponto** is a service that allows companies and professionals to aggregate their accounts in one
|
||||
place and directly see all their transactions within one app. It is a third-party solution that is
|
||||
continuously expanding the number of bank institutions that can be synchronized with Odoo.
|
||||
`Ponto <https://myponto.com/>`_ is a paid third-party service that enables companies and
|
||||
professionals to connect multiple bank accounts to a single platform. It provides a unified view of
|
||||
all transactions within a single interface. When integrated with Odoo, it automatically synchronizes
|
||||
bank transactions directly into its database.
|
||||
|
||||
**Odoo** can synchronize directly with your bank to get all bank statements imported automatically
|
||||
into your database.
|
||||
|
||||
Ponto is a paid third-party provider that can handle the synchronization between your bank accounts
|
||||
and Odoo.
|
||||
.. note::
|
||||
Using Ponto is subject to applicable fees.
|
||||
|
||||
.. seealso::
|
||||
- :doc:`../bank_synchronization`
|
||||
- :doc:`../transactions`
|
||||
- `Financial institutions connected to Ponto <https://www.isabelgroup.eu/banks>`_
|
||||
|
||||
.. _accounting/bank-synchronization/ponto/configuration:
|
||||
|
||||
Configuration
|
||||
=============
|
||||
|
||||
Link your bank accounts with Ponto
|
||||
----------------------------------
|
||||
To connect a bank with Odoo using Ponto as the third-party provider, follow these steps:
|
||||
|
||||
#. Go to `Ponto's website (https://myponto.com) <https://myponto.com>`_.
|
||||
#. Create an account if you don't have one yet.
|
||||
#. Once you are logged in, create an *organization*.
|
||||
#. Set up your email address: Click the profile icon in the upper-right corner, select
|
||||
:guilabel:`My profile`, and fill in the :guilabel:`Email` field.
|
||||
#. :ref:`Create a Ponto account <accounting/bank-synchronization/ponto/ponto-account-creation>` if
|
||||
needed.
|
||||
#. :ref:`Connect Odoo to your bank <accounting/bank-synchronization/ponto/odoo-connection>`.
|
||||
|
||||
.. image:: ponto/ponto-organization.png
|
||||
:alt: Fill out the form to add an organization in Ponto.
|
||||
.. _accounting/bank-synchronization/ponto/ponto-account-creation:
|
||||
|
||||
#. Go to :menuselection:`Accounts --> Live`, and click :guilabel:`Add account`. You might have to
|
||||
add your **Billing Information** first.
|
||||
#. Select your country, your bank institutions, give your consent to Ponto, and follow the steps
|
||||
on-screen to link your bank account with your Ponto account.
|
||||
Ponto account creation
|
||||
----------------------
|
||||
|
||||
.. image:: ponto/ponto-add-account.png
|
||||
:alt: Add bank accounts to your Ponto account.
|
||||
|
||||
#. Add all bank accounts you want to synchronize with your Odoo database and move to the next steps.
|
||||
|
||||
Link your Ponto account with your Odoo database
|
||||
-----------------------------------------------
|
||||
|
||||
#. Go to :menuselection:`Accounting --> Configuration --> Add a Bank Account`.
|
||||
#. Search for your institution and select it so you can verify that the third party provider is
|
||||
Ponto.
|
||||
#. Click :guilabel:`Connect` and follow the steps.
|
||||
#. Select **all accounts** you want to access and synchronize in Odoo, even the ones coming from
|
||||
other banking institutions.
|
||||
|
||||
.. image:: ponto/ponto-select-accounts.png
|
||||
:alt: Selection of the accounts you wish to synchronize with Odoo.
|
||||
|
||||
#. Finish the flow.
|
||||
#. Access the `Ponto website <https://myponto.com>`_.
|
||||
#. Click :guilabel:`Login`, then :guilabel:`Not a user yet?` and follow the instructions to create a
|
||||
new account.
|
||||
|
||||
.. note::
|
||||
You have to authorize all the accounts you want to access in Odoo, but Odoo will filter the
|
||||
accounts based on the institution you selected in the second step.
|
||||
Use the same email address as the one :ref:`used for your Odoo profile
|
||||
<accounting/bank-synchronization/ponto/configuration>`.
|
||||
|
||||
Update your synchronization credentials
|
||||
---------------------------------------
|
||||
#. After logging in, create an :guilabel:`Organization` and provide the necessary contact details.
|
||||
#. Give consent to Ponto to access the bank account data.
|
||||
#. Click :guilabel:`Accounts`, :guilabel:`Add account`, then :guilabel:`Choose your bank`, enter the
|
||||
bank account reference, and follow the on-screen steps to complete the linking process.
|
||||
#. Add all relevant bank accounts that need to be synchronized with Odoo, then proceed to the next
|
||||
steps.
|
||||
|
||||
To update your Ponto credentials or modify the synchronization settings, activate the
|
||||
:ref:`developer mode <developer-mode>`, go to :menuselection:`Accounting --> Configuration -->
|
||||
Online Synchronization`, and select the institution from which you want to fetch the other
|
||||
accounts. Click :guilabel:`Fetch Accounts` to start the flow.
|
||||
.. _accounting/bank-synchronization/ponto/odoo-connection:
|
||||
|
||||
.. note::
|
||||
During the update, select **all accounts** you want to synchronize, even the ones coming from
|
||||
other banking institutions.
|
||||
Connection with Odoo
|
||||
--------------------
|
||||
|
||||
Fetch new accounts
|
||||
------------------
|
||||
When :ref:`connecting a bank to Odoo <accounting/bank-synchronization/first-synchronization>` using
|
||||
Ponto as the third-party provider, follow these steps:
|
||||
|
||||
To add new online accounts to your connection, activate the :ref:`developer mode <developer-mode>`,
|
||||
go to :menuselection:`Accounting --> Configuration --> Online Synchronization`, and select the
|
||||
institution from which you want to fetch the other accounts. Click :guilabel:`Fetch Accounts` to
|
||||
start the flow.
|
||||
#. When connecting to the desired bank, make sure Ponto is selected as the third-party
|
||||
:guilabel:`Provider`.
|
||||
#. Select the account(s) to grant Ponto access to account balances and transactions, then confirm
|
||||
the selection.
|
||||
#. Authorize Odoo to request account information and initiate payment orders.
|
||||
#. Select the specific bank account to connect.
|
||||
|
||||
.. note::
|
||||
Don't forget to keep authorization for existing accounts (for all institutions that you have
|
||||
synchronized with Ponto).
|
||||
.. tip::
|
||||
- Make sure to check the consent checkbox to allow information to be shared with Odoo.
|
||||
- Select all accounts that need access and synchronization, including those from other banking
|
||||
institutions.
|
||||
|
||||
FAQ
|
||||
===
|
||||
.. seealso::
|
||||
:ref:`Update synchronization credentials <accounting/bank-synchronization/update-credentials>`
|
||||
|
||||
After my synchronization, no account appears
|
||||
--------------------------------------------
|
||||
.. _accounting/bank-synchronization/ponto/payments:
|
||||
|
||||
You selected an institution from the list and did not authorize any accounts from this institution.
|
||||
|
||||
I have an error about that my authorization has expired
|
||||
-------------------------------------------------------
|
||||
|
||||
Every **6 months** (180 days) you must re-authorize the connection between your bank account
|
||||
and Ponto. This must be done from the `Ponto website <https://myponto.com>`_. If you do not
|
||||
do this, the synchronization will stop for these accounts.
|
||||
|
||||
I have some errors with my beta institution
|
||||
-------------------------------------------
|
||||
|
||||
Ponto provides institutions in *beta*, these institutions are not directly supported by Odoo
|
||||
and we advise you to contact Ponto directly.
|
||||
Vendor payments with Ponto
|
||||
==========================
|
||||
|
||||
.. important::
|
||||
Using an institution in beta is beneficial for Ponto, it allows them to have real
|
||||
feedback on the connection with the institution.
|
||||
Before managing vendor payments with Ponto, make sure the following steps are completed:
|
||||
|
||||
- :ref:`SEPA Credit Transfer is activated (SCT) <accounting/pay_sepa/activate-sepa>`.
|
||||
- :ref:`The SEPA Credit Transfer payment method has been added to the bank journal
|
||||
<accounting/pay_sepa/activate-sepa-bank-journal>`.
|
||||
- :doc:`The vendor's bank account has been marked as trusted <../../payments/trusted_accounts>`.
|
||||
- The :guilabel:`Account Online Payment` (`account_online_payment`) module is :ref:`installed
|
||||
<general/install>`.
|
||||
|
||||
To register a vendor payment using Ponto, follow these steps:
|
||||
|
||||
#. Go to :menuselection:`Accounting --> Vendors --> Payments` and create the payment. Fill in the
|
||||
relevant bank :guilabel:`Journal` field, select :ref:`SEPA Credit Transfer
|
||||
<accounting/pay_sepa/registering-payments-sepa>` as the :guilabel:`Payment Method`, and enter the
|
||||
:guilabel:`Vendor Bank Account`. Then click :guilabel:`Confirm`.
|
||||
#. Go to :menuselection:`Accounting --> Vendors --> Batch Payments` and :ref:`create a batch
|
||||
<accounting/batch/creation>`. Select the same bank :guilabel:`Journal` and :guilabel:`Payment
|
||||
Method`, and click :guilabel:`Add a line` to select the payment created in the previous step.
|
||||
#. Click :guilabel:`Initiate Payment` to connect to Ponto and follow the steps to sign the payment.
|
||||
|
||||
.. _accounting/bank-synchronization/ponto/troubleshooting:
|
||||
|
||||
Troubleshooting
|
||||
===============
|
||||
|
||||
.. seealso::
|
||||
:ref:`Bank synchronization troubleshooting <accounting/bank-synchronization/troubleshooting>`
|
||||
|
||||
.. _accounting/bank-synchronization/ponto/troubleshooting/expired-authorization:
|
||||
|
||||
Why has the authorization expired?
|
||||
----------------------------------
|
||||
|
||||
Every six months (180 days), the connection between a bank account and Ponto must be re-authorized
|
||||
via the `Ponto website <https://myponto.com>`_. Failure to do so will result in synchronization
|
||||
stopping for those accounts.
|
||||
|
||||
|
Before Width: | Height: | Size: 9.3 KiB |
|
Before Width: | Height: | Size: 20 KiB |
|
Before Width: | Height: | Size: 30 KiB |
@@ -1,99 +0,0 @@
|
||||
=========
|
||||
Salt Edge
|
||||
=========
|
||||
|
||||
**Salt Edge** is a third-party provider that aggregates banking information
|
||||
from your bank accounts. It supports ~5000 institutions in more than 50
|
||||
countries.
|
||||
|
||||
Odoo can synchronize directly with your bank to get all bank statements imported
|
||||
automatically into your database.
|
||||
|
||||
.. seealso::
|
||||
- :doc:`../bank_synchronization`
|
||||
- :doc:`../transactions`
|
||||
|
||||
Configuration
|
||||
=============
|
||||
|
||||
Link your bank accounts with Odoo
|
||||
---------------------------------
|
||||
|
||||
#. Start synchronization by clicking on :menuselection:`Accounting --> Configuration
|
||||
--> Add a Bank Account`.
|
||||
#. Select the institution you want to synchronize. You can see if Salt Edge is the
|
||||
third party provider of the institution by selecting it.
|
||||
#. After giving your phone number, you are asked for an email address. This email
|
||||
address is used to create your Salt Edge account. Please make sure you enter a
|
||||
valid email address, as otherwise, you will not be able to access your Salt Edge
|
||||
account.
|
||||
|
||||
.. image:: saltedge/saltedge-contact-email.png
|
||||
:alt: Email address to provide to Salt Edge for the creation of your account.
|
||||
|
||||
#. After entering your email address, you are redirected to Salt Edge to continue
|
||||
the synchronization process.
|
||||
|
||||
.. image:: saltedge/saltedge-login-page.png
|
||||
:alt: Salt Edge Login page.
|
||||
|
||||
#. Make sure you give your consent by checking the consent checkbox.
|
||||
|
||||
.. image:: saltedge/saltedge-give-consent.png
|
||||
:alt: Salt Edge give consent page.
|
||||
|
||||
#. Complete the synchronization by following the steps.
|
||||
|
||||
|
||||
Update your credentials
|
||||
-----------------------
|
||||
|
||||
To update your Salt Edge credentials or modify the synchronization settings, activate the
|
||||
:ref:`developer mode <developer-mode>`, go to :menuselection:`Accounting --> Configuration -->
|
||||
Online Synchronization`, and select the institution you want to update credentials. Click
|
||||
:guilabel:`Update Credentials` to start the flow and follow the steps.
|
||||
|
||||
Don't forget to check the consent checkbox. Otherwise, Odoo may not be able to access
|
||||
your information.
|
||||
|
||||
Fetch new accounts
|
||||
------------------
|
||||
|
||||
To add new online accounts to your connection, activate the :ref:`developer mode <developer-mode>`,
|
||||
go to :menuselection:`Accounting --> Configuration --> Online Synchronization`, and select the
|
||||
institution to fetch the new accounts. Click :guilabel:`Fetch Accounts` to start the flow and
|
||||
follow the steps.
|
||||
|
||||
.. note::
|
||||
Don't forget to check the consent checkbox. Otherwise, Odoo may not be able to access your
|
||||
information.
|
||||
|
||||
FAQ
|
||||
===
|
||||
|
||||
I have an error when I try to delete my synchronization within Odoo
|
||||
-------------------------------------------------------------------
|
||||
|
||||
Odoo can't permanently delete the connection you have created with the banking institution. However,
|
||||
it can revoke the consent you gave so that Odoo won't be able to access your account anymore. The
|
||||
error you are seeing is probably a message telling you that the consent was revoked, but the record
|
||||
could not be deleted as it still exists within Salt edge. If you want to remove the connection
|
||||
completely, please connect to your `Salt Edge account <https://www.saltedge.com/dashboard>`_
|
||||
and manually delete your synchronization. Once this is done, you can go back to Odoo to delete the
|
||||
record.
|
||||
|
||||
I have an error saying that I have already synchronized this account
|
||||
--------------------------------------------------------------------
|
||||
|
||||
You have probably already synchronized your bank account with Salt Edge, please check on your
|
||||
`dashboard <https://www.saltedge.com/dashboard>`_ that you don't already have a connection with the
|
||||
same credentials.
|
||||
|
||||
If you already have a synchronization with the same credentials present on your Salt Edge
|
||||
dashboard and this synchronization has not been created with Odoo, delete it and create it from your
|
||||
Odoo database.
|
||||
|
||||
If you already have a connection with the same credentials present on your Salt Edge dashboard
|
||||
and this synchronization was created with Odoo, activate the :ref:`developer
|
||||
mode <developer-mode>`, go to :menuselection:`Accounting --> Configuration --> Online
|
||||
Synchronization`, and click :guilabel:`Update Credentials` to reactivate the connection.
|
||||
|
Before Width: | Height: | Size: 7.9 KiB |
|
Before Width: | Height: | Size: 22 KiB |
|
Before Width: | Height: | Size: 5.4 KiB |
@@ -60,6 +60,10 @@ journal's main account and its suspense account until it is fully reconciled. At
|
||||
suspense account is replaced with the account of the counterpart item or, in the case of
|
||||
:ref:`manual matching <accounting/reconciliation/set-account>`, the selected account.
|
||||
|
||||
.. seealso::
|
||||
- :ref:`Duplicate transactions <accounting/bank-synchronization/duplicate-transactions>`
|
||||
- :ref:`Missing transactions <accounting/bank-synchronization/missing-transactions>`
|
||||
|
||||
.. _accounting/reconciliation/action-buttons:
|
||||
|
||||
Possible action buttons
|
||||
|
||||
@@ -45,6 +45,8 @@ with actual bank statements.
|
||||
Configuration
|
||||
=============
|
||||
|
||||
.. _accounting/pay_sepa/activate-sepa:
|
||||
|
||||
Activate SEPA Credit Transfer (SCT)
|
||||
-----------------------------------
|
||||
|
||||
@@ -57,6 +59,8 @@ SCT option when paying your vendor.
|
||||
According to the localization package installed, the **SEPA Direct Debit** and **SEPA Credit
|
||||
Transfer** modules may be installed by default. If not, they need to be :ref:`installed <general/install>`.
|
||||
|
||||
.. _accounting/pay_sepa/activate-sepa-bank-journal:
|
||||
|
||||
Activate SEPA payment methods on banks
|
||||
--------------------------------------
|
||||
|
||||
@@ -67,6 +71,8 @@ present, add :guilabel:`SEPA Credit Transfer` under :guilabel:`Payment Method`.
|
||||
Make sure to specify the IBAN account number (domestic account numbers do not work with SEPA) and
|
||||
the BIC (bank identifier code) in the :guilabel:`Journal Entries` tab.
|
||||
|
||||
.. _accounting/pay_sepa/registering-payments-sepa:
|
||||
|
||||
Registering payments
|
||||
--------------------
|
||||
|
||||
|
||||
@@ -5,6 +5,8 @@ applications/finance/payment_providers/sips.rst applications/finance/payment_pro
|
||||
applications/finance/accounting/payments/internal_transfers.rst applications/finance/accounting/bank/internal_transfers.rst
|
||||
applications/finance/accounting/payments/checks.rst applications/finance/accounting/payments.rst
|
||||
applications/finance/fiscal_localizations/employment_hero.rst applications/hr/payroll/payroll_localizations/employment_hero.rst
|
||||
applications/finance/accounting/bank/bank_synchronization/enablebanking.rst applications/finance/accounting/bank/bank_synchronization.rst
|
||||
applications/finance/accounting/bank/bank_synchronization/saltedge.rst applications/finance/accounting/bank/bank_synchronization.rst
|
||||
|
||||
# applications/point of sale
|
||||
|
||||
|
||||