documentation/content/applications/finance/accounting/bank/bank_synchronization/saltedge.rst
afma-odoo ea54d7f4b6 [IMP] accounting: add info on developer mode for bank online synch
task-4118449

closes odoo/documentation#10965

X-original-commit: 259e6bb272
Signed-off-by: Audrey Vandromme (auva) <auva@odoo.com>
Signed-off-by: Anne-Françoise Marcq (afma) <afma@odoo.com>
2024-09-09 07:58:25 +00:00

100 lines
4.1 KiB
ReStructuredText

=========
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.