Skip to content

Commit 2fd287c

Browse files
committed
[IMP] accounting: update bank synchronization page
task-4981233
1 parent 6121497 commit 2fd287c

File tree

16 files changed

+419
-303
lines changed

16 files changed

+419
-303
lines changed

content/applications/finance/accounting/bank/bank_synchronization.rst

Lines changed: 171 additions & 137 deletions
Large diffs are not rendered by default.

content/applications/finance/accounting/bank/bank_synchronization/enablebanking.rst

Lines changed: 27 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -2,33 +2,40 @@
22
Enable Banking
33
==============
44

5-
**Enable Banking** is a third-party provider aggregating banking information from bank accounts all
6-
in one place. It offers non-intrusive connectivity to ASPSPs' official APIs across Europe without
7-
storing data.
8-
9-
.. image:: enablebanking/enablebanking.png
10-
:alt: Enable Banking logo
11-
12-
**Odoo** synchronizes directly with banks to get access to all bank transactions and automatically
13-
import them into your database.
5+
`Enable Banking <https://enablebanking.com/>`_ is a third-party provider that aggregates banking
6+
information from multiple bank accounts in one place. It provides non-intrusive access to
7+
:abbr:`ASPSPs (account servicing payment service providers)`' official APIs across Europe without
8+
storing data. Odoo uses Enable Banking to synchronize with supported banks automatically and import
9+
all bank transactions into a database.
1410

1511
.. seealso::
1612
- :doc:`../bank_synchronization`
17-
- `Enable Banking website <https://enablebanking.com/>`_
13+
- :ref:`Bank synchronization troubleshooting <accounting/bank-synchronization/troubleshooting>`
14+
- `Enable Banking coverage <https://enablebanking.com/open-banking-apis>`_
15+
16+
.. _accounting/bank-synchronization/enablebanking/configuration:
1817

1918
Configuration
2019
=============
2120

22-
Link bank accounts with Odoo
23-
----------------------------
21+
.. _accounting/bank-synchronization/enablebanking/odoo-connection:
2422

25-
#. Start synchronization by clicking on :menuselection:`Accounting --> Configuration -->
26-
Add a Bank Account`;
27-
#. Select your bank;
28-
#. Make sure you give your consent to share your account information with Odoo by clicking
29-
:guilabel:`Continue authentication`;
23+
Connection with Odoo
24+
--------------------
3025

31-
.. image:: enablebanking/enablebankingauth.png
32-
:alt: Enable Banking authentication page
26+
When :ref:`connecting a bank to Odoo <accounting/bank-synchronization/first-synchronization>`,
27+
verify that the third-party provider is Enable Banking and follow the steps from the bank's login
28+
page.
29+
30+
.. tip::
31+
- Make sure to check the consent checkbox to allow information to be shared with Odoo.
32+
- Select all accounts that need access and synchronization, including those from other banking
33+
institutions.
34+
35+
.. seealso::
36+
- :ref:`Update synchronization credentials <accounting/bank-synchronization/update-credentials>`
37+
- :ref:`Fetch new accounts <accounting/bank-synchronization/fetch-new-accounts>`
3338

34-
#. Finally, you are redirected to your bank's login page.
39+
.. note::
40+
When fetching new accounts, make sure the authorization for all previously synchronized accounts
41+
with Enable Banking is maintained.
Binary file not shown.
Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
=====
2+
Plaid
3+
=====
4+
5+
`Plaid <https://plaid.com/discover-apps/>`_ is a paid, third-party provider that securely connects a
6+
user's bank to Odoo, automating financial data import. It supports over 12,000 institutions in the
7+
U.S. and 200 in Canada. Odoo uses Plaid to synchronize with supported banks automatically and
8+
import all bank transactions into a database.
9+
10+
.. seealso::
11+
- :doc:`../bank_synchronization`
12+
- :ref:`Bank synchronization troubleshooting <accounting/bank-synchronization/troubleshooting>`
13+
- `Plaid US and Canada Bank Coverage Explorer <https://plaid.com/docs/institutions/>`_
14+
15+
.. _accounting/bank-synchronization/plaid/configuration:
16+
17+
Configuration
18+
=============
19+
20+
.. _accounting/bank-synchronization/plaid/odoo-connection:
21+
22+
Connection with Odoo
23+
--------------------
24+
25+
When :ref:`connecting a bank to Odoo <accounting/bank-synchronization/first-synchronization>`,
26+
verify that the third-party provider is Plaid and follow the steps from the bank's login page.
27+
28+
.. tip::
29+
- Make sure to check the consent checkbox to allow information to be shared with Odoo.
30+
- Select all accounts that need access and synchronization, including those from other banking
31+
institutions.
32+
33+
.. seealso::
34+
- :ref:`Update synchronization credentials <accounting/bank-synchronization/update-credentials>`
35+
- :ref:`Fetch new accounts <accounting/bank-synchronization/fetch-new-accounts>`
36+
37+
.. note::
38+
When fetching new accounts, make sure the authorization for all previously synchronized accounts
39+
with Plaid is maintained.

content/applications/finance/accounting/bank/bank_synchronization/ponto.rst

Lines changed: 84 additions & 72 deletions
Original file line numberDiff line numberDiff line change
@@ -2,107 +2,119 @@
22
Ponto
33
=====
44

5-
**Ponto** is a service that allows companies and professionals to aggregate their accounts in one
6-
place and directly see all their transactions within one app. It is a third-party solution that is
7-
continuously expanding the number of bank institutions that can be synchronized with Odoo.
5+
`Ponto <https://myponto.com/>`_ is a third-party service that enables companies and professionals to
6+
connect multiple bank accounts to a single platform. It provides a unified view of all transactions
7+
within a single interface. When integrated with Odoo, it automatically synchronizes bank
8+
transactions directly into a database.
89

9-
**Odoo** can synchronize directly with your bank to get all bank statements imported automatically
10-
into your database.
11-
12-
Ponto is a paid third-party provider that can handle the synchronization between your bank accounts
13-
and Odoo.
10+
.. note::
11+
Using Ponto is subject to applicable fees.
1412

1513
.. seealso::
1614
- :doc:`../bank_synchronization`
17-
- :doc:`../transactions`
15+
- `Financial institutions connected to Ponto <https://www.isabelgroup.eu/banks>`_
16+
17+
.. _accounting/bank-synchronization/ponto/configuration:
1818

1919
Configuration
2020
=============
2121

22-
Link your bank accounts with Ponto
23-
----------------------------------
22+
To connect a bank with Odoo using Ponto as the third-party provider, follow these steps:
2423

25-
#. Go to `Ponto's website (https://myponto.com) <https://myponto.com>`_.
26-
#. Create an account if you don't have one yet.
27-
#. Once you are logged in, create an *organization*.
24+
#. Make sure the :guilabel:`Account Online Payment` (`account_online_payment`) module is
25+
:ref:`installed <general/install>`.
26+
#. Set up your email address: Click the profile icon in the upper-right corner, select
27+
:guilabel:`My profile`, and fill in the :guilabel:`Email` field.
28+
#. :ref:`Create a Ponto account <accounting/bank-synchronization/ponto/ponto-account-creation>` if
29+
needed.
30+
#. :ref:`Connect Odoo to your bank <accounting/bank-synchronization/ponto/odoo-connection>`.
2831

29-
.. image:: ponto/ponto-organization.png
30-
:alt: Fill out the form to add an organization in Ponto.
32+
.. _accounting/bank-synchronization/ponto/ponto-account-creation:
3133

32-
#. Go to :menuselection:`Accounts --> Live`, and click :guilabel:`Add account`. You might have to
33-
add your **Billing Information** first.
34-
#. Select your country, your bank institutions, give your consent to Ponto, and follow the steps
35-
on-screen to link your bank account with your Ponto account.
34+
Ponto account creation
35+
----------------------
3636

37-
.. image:: ponto/ponto-add-account.png
38-
:alt: Add bank accounts to your Ponto account.
37+
#. Access the `Ponto website <https://myponto.com>`_.
38+
#. Click :guilabel:`Login`, then :guilabel:`Not a user yet?` and follow the instructions to create a
39+
new account.
3940

40-
#. Add all bank accounts you want to synchronize with your Odoo database and move to the next steps.
41+
.. note::
42+
Use the same email address entered during the :ref:`configuration
43+
<accounting/bank-synchronization/ponto/configuration>` step.
4144

42-
Link your Ponto account with your Odoo database
43-
-----------------------------------------------
45+
#. After logging in, create an :guilabel:`Organization` and provide the necessary contact details.
46+
#. Give consent to Ponto to access the bank account data.
47+
#. Click :guilabel:`Accounts`, :guilabel:`Add account`, then :guilabel:`Choose your bank`, enter the
48+
bank account reference, and follow the on-screen steps to complete the linking process.
49+
#. Add all relevant bank accounts that need to be synchronized with Odoo, then proceed to the next
50+
steps.
4451

45-
#. Go to :menuselection:`Accounting --> Configuration --> Add a Bank Account`.
46-
#. Search for your institution and select it so you can verify that the third party provider is
47-
Ponto.
48-
#. Click :guilabel:`Connect` and follow the steps.
49-
#. Select **all accounts** you want to access and synchronize in Odoo, even the ones coming from
50-
other banking institutions.
52+
.. _accounting/bank-synchronization/ponto/odoo-connection:
5153

52-
.. image:: ponto/ponto-select-accounts.png
53-
:alt: Selection of the accounts you wish to synchronize with Odoo.
54+
Connection with Odoo
55+
--------------------
5456

55-
#. Finish the flow.
57+
When :ref:`connecting a bank to Odoo <accounting/bank-synchronization/first-synchronization>` using
58+
Ponto as the third-party provider, follow these steps:
5659

57-
.. note::
58-
You have to authorize all the accounts you want to access in Odoo, but Odoo will filter the
59-
accounts based on the institution you selected in the second step.
60+
#. Initiate the connection with Ponto.
61+
#. Connect to the desired bank.
62+
#. Select the account(s) to grant Ponto access to account balances and transactions, then confirm
63+
the selection.
64+
#. Authorize Odoo to request account information and initiate payment orders.
65+
#. Select the specific bank account to connect.
6066

61-
Update your synchronization credentials
62-
---------------------------------------
67+
.. tip::
68+
- Make sure to check the consent checkbox to allow information to be shared with Odoo.
69+
- Select all accounts that need access and synchronization, including those from other banking
70+
institutions.
71+
- When fetching new accounts, make sure that the authorization remains active for all accounts
72+
previously synchronized with Ponto.
6373

64-
To update your Ponto credentials or modify the synchronization settings, activate the
65-
:ref:`developer mode <developer-mode>`, go to :menuselection:`Accounting --> Configuration -->
66-
Online Synchronization`, and select the institution from which you want to fetch the other
67-
accounts. Click :guilabel:`Fetch Accounts` to start the flow.
74+
.. seealso::
75+
- :ref:`Update synchronization credentials <accounting/bank-synchronization/update-credentials>`
76+
- :ref:`Fetch new accounts <accounting/bank-synchronization/fetch-new-accounts>`
6877

69-
.. note::
70-
During the update, select **all accounts** you want to synchronize, even the ones coming from
71-
other banking institutions.
78+
.. _accounting/bank-synchronization/ponto/payments:
7279

73-
Fetch new accounts
74-
------------------
80+
Vendor payments with Ponto
81+
==========================
7582

76-
To add new online accounts to your connection, activate the :ref:`developer mode <developer-mode>`,
77-
go to :menuselection:`Accounting --> Configuration --> Online Synchronization`, and select the
78-
institution from which you want to fetch the other accounts. Click :guilabel:`Fetch Accounts` to
79-
start the flow.
83+
.. important::
84+
Before managing vendor payments with Ponto, make sure the following steps are completed:
8085

81-
.. note::
82-
Don't forget to keep authorization for existing accounts (for all institutions that you have
83-
synchronized with Ponto).
86+
- :ref:`SEPA Credit Transfer is activated (SCT) <accounting/pay_sepa/activate-sepa>`.
87+
- :ref:`SEPA Credit Transfer payment methods is added to the bank journal
88+
<accounting/pay_sepa/activate-sepa-bank-journal>`.
89+
- :doc:`The vendor bank account is marked as trusted <../../payments/trusted_accounts>`.
8490

85-
FAQ
86-
===
91+
To register a vendor payment using Ponto, the following steps must be followed:
8792

88-
After my synchronization, no account appears
89-
--------------------------------------------
93+
#. When :ref:`connecting a bank to Odoo <accounting/bank-synchronization/first-synchronization>` via
94+
Ponto, make sure the :guilabel:`Transactions and payments` option is selected in the
95+
:guilabel:`Search for an institution` window.
96+
#. Go to :menuselection:`Accounting --> Vendors --> Payments` to create the payment. Fill in the
97+
relevant bank :guilabel:`Journal` field, select :ref:`SEPA Credit Transfer
98+
<accounting/pay_sepa/registering-payments-sepa>` as the :guilabel:`Payment Method`, and enter the
99+
:guilabel:`Vendor Bank Account`. Then click :guilabel:`Confirm`.
100+
#. Go to :menuselection:`Accounting --> Vendors --> Batch Payments` to :ref:`create a batch
101+
<accounting/batch/creation>`. Select the same bank :guilabel:`Journal` and :guilabel:`Payment
102+
Method`, and click :guilabel:`Add a line` to select the payment created in the previous step.
103+
#. Click :guilabel:`Initiate Payment` to connect to Ponto and follow the steps to sign the payment.
90104

91-
You selected an institution from the list and did not authorize any accounts from this institution.
105+
.. _accounting/bank-synchronization/ponto/troubleshooting:
92106

93-
I have an error about that my authorization has expired
94-
-------------------------------------------------------
107+
Troubleshooting
108+
===============
95109

96-
Every **6 months** (180 days) you must re-authorize the connection between your bank account
97-
and Ponto. This must be done from the `Ponto website <https://myponto.com>`_. If you do not
98-
do this, the synchronization will stop for these accounts.
110+
.. seealso::
111+
:ref:`Bank synchronization troubleshooting <accounting/bank-synchronization/troubleshooting>`
99112

100-
I have some errors with my beta institution
101-
-------------------------------------------
113+
.. _accounting/bank-synchronization/ponto/troubleshooting/expired-authorization:
102114

103-
Ponto provides institutions in *beta*, these institutions are not directly supported by Odoo
104-
and we advise you to contact Ponto directly.
115+
Why has the authorization expired?
116+
----------------------------------
105117

106-
.. important::
107-
Using an institution in beta is beneficial for Ponto, it allows them to have real
108-
feedback on the connection with the institution.
118+
Every six months (180 days), the connection between a bank account and Ponto must be re-authorized
119+
via the `Ponto website <https://myponto.com>`_. Failure to do so will result in synchronization
120+
stopping for those accounts.
Binary file not shown.
Binary file not shown.
Binary file not shown.

0 commit comments

Comments
 (0)