diff --git a/content/applications/finance/accounting/bank/bank_synchronization.rst b/content/applications/finance/accounting/bank/bank_synchronization.rst index 318599f626..ca9eaf1679 100644 --- a/content/applications/finance/accounting/bank/bank_synchronization.rst +++ b/content/applications/finance/accounting/bank/bank_synchronization.rst @@ -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 ` to connect with +banks. -To check if your bank is compatible with Odoo, go to `Odoo 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: +.. note:: + To use this service, a valid Odoo Enterprise subscription is required. -- **Plaid**: United States of America and Canada -- **Yodlee**: Worldwide -- :doc:`Salt Edge `: Worldwide -- :doc:`Ponto `: Europe -- :doc:`Enable Banking `: Scandinavian countries +.. tip:: + To check if your bank is compatible with Odoo, go to `Odoo Accounting Features + `_, 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`. + +.. 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 ` + 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. -Now you can search for your bank institution. Select it and follow the steps to synchronize with it. +.. important:: + 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. .. 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. + - 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 ` 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 ` and go to + :menuselection:`Accounting --> Configuration --> Online Synchronization`. -.. 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. +.. _accounting/bank-synchronization/manual-synchronization: -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. +Manual synchronization +---------------------- -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. +After the :ref:`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. -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. +.. tip:: + Alternatively, activate the :ref:`developer mode `, go to + :menuselection:`Accounting --> Configuration --> Online Synchronization`, select the relevant + bank, and click :guilabel:`Fetch transactions`. -To view all your synchronizations, activate the :ref:`developer mode ` and go to -:menuselection:`Accounting --> Configuration --> Online Synchronization`. +.. note:: + - 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 `. -Synchronize manually --------------------- +.. _accounting/bank-synchronization/update-credentials: -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. +Update synchronization credentials +---------------------------------- -Alternatively, activate the :ref:`developer mode `, go to -:menuselection:`Accounting --> Configuration --> Online Synchronization`, select your institution, -and then click the :guilabel:`Fetch transactions` button. +To update bank credentials, activate the :ref:`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. -.. 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. +.. 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. -Issues -====== +.. _accounting/bank-synchronization/third-party-providers: -Synchronization in error ------------------------- +Third-party providers +--------------------- -To report a connection error to the `Odoo support `_, activate the -:ref:`developer mode `, go to :menuselection:`Accounting --> Configuration --> -Online Synchronization`, select the connection that failed, and copy the error description and the -reference. +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: + +- `Plaid `_ (supported in the `United States of America and Canada + `_) +- `Yodlee `_ (supported in Europe) +- `Salt Edge `_ (supported `worldwide + `_) +- :doc:`Ponto ` (supported in Europe) +- `Enable Banking `_ (supported in `Scandinavian countries + `_) + +.. tip:: + When :ref:`connecting a bank to Odoo `: + + - 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. + +.. seealso:: + - :ref:`Bank synchronization troubleshooting ` + - :ref:`Salt Edge bank synchronization troubleshooting + ` + - :ref:`Ponto bank synchronization troubleshooting + ` + +.. _accounting/bank-synchronization/duplicate-transactions: + +Duplicate transactions +====================== + +When importing transactions, some may appear duplicated due to the same online transaction +identifier or the same currency, amount, account number, and date. -Synchronization disconnected ----------------------------- +To search for duplicate transactions, access the :ref:`bank reconciliation view +`, then follow these steps: -If your connection with the proxy is disconnected, you can reconnect with the proxy using the -:guilabel:`Fetch Account` button. +#. 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:: - If you are unable to reconnect using the :guilabel:`Reconnect` button, please contact the - `support `_ directly with your client id or the reference of the error - listed in the chatter. + Journal entries can only be deleted if they have not been reconciled. -.. _MigrationOnlineSync: +.. _accounting/bank-synchronization/missing-transactions: -Migration process for users having installed Odoo before December 2020 -====================================================================== +Missing transactions +==================== -If you are on-premise, please first make sure that your source is up-to-date with the latest version -of Odoo. +Missing or pending transactions are entries that the bank has not yet validated. -Users who have created a database before December 2020 need to install the new module manually to -use the new functionalities. +To find missing and pending transactions, access the :ref:`bank reconciliation view +`, click the :icon:`fa-cog` :guilabel:`(gear)` icon, and select +:guilabel:`Find Missing Transactions`. -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. +To import a posted missing transaction, select it and click :guilabel:`Import Transactions`. -.. Note:: +.. note:: + - Make sure the connection with the bank is active to find missing transactions. + - :guilabel:`Pending` transactions cannot be imported. - - All previous synchronizations are disconnected during the installation and will not work - anymore. To view them, activate the :ref:`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. +.. _accounting/bank-synchronization/troubleshooting: -FAQ -=== +Troubleshooting +=============== -The synchronization is not working in real-time. Is that normal? ----------------------------------------------------------------- +.. seealso:: + :ref:`Bank synchronization troubleshooting - Ponto + ` + +.. _accounting/bank-synchronization/troubleshooting/synchronization: + +Synchronization errors or disconnections +---------------------------------------- -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 ` 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. +To report a connection error to `Odoo support `_, activate the +:ref:`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 `_ directly. Provide the client ID or +the error reference from the chatter. -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. +.. _accounting/bank-synchronization/troubleshooting/real-time: -Is the Online Bank Synchronization feature included in my contract? -------------------------------------------------------------------- +Why is the synchronization not working in real-time? +---------------------------------------------------- -- **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. +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`. -Some banks have a status "Beta." What does this mean? ------------------------------------------------------ +Alternatively, to synchronize and fetch transactions, activate the :ref:`developer mode +` and go to :menuselection:`Accounting --> Configuration --> Online +Synchronization`. -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. +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. + +.. _accounting/bank-synchronization/troubleshooting/visible-transactions: + +Why are no transactions visible? +-------------------------------- + +There are a few possible reasons for this issue: + +- No bank accounts were synchronized during the :ref:`first synchronization + `. +- There may be no new transactions available to fetch. + +If the bank account is correctly linked to a journal, but posted transactions still aren't visible +in the database, contact `support `_. + +.. _accounting/bank-synchronization/troubleshooting/no-account-appearing: + +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/troubleshooting-saltedge: + +Saltedge troubleshooting +------------------------ + +.. _accounting/bank-synchronization/troubleshooting/saltedge/deleting-error: -Not all of my past transactions are in Odoo, why? -------------------------------------------------- +Why is there an error when deleting a synchronization in Odoo? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -For some institutions, transactions can only be fetched up to 3 months in the past. +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. -Why don't I see any transactions? ---------------------------------- +To delete the connection, connect to the `Salt Edge account `_ +and manually remove the synchronization. Once this is done, the record can be deleted in Odoo. -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 -`, go to :menuselection:`Accounting --> Configuration --> Online Synchronization`, -and click the :guilabel:`Fetch Account` button on the connection. +.. _accounting/bank-synchronization/troubleshooting/saltedge/account-already-synchronized: -There may also be no new transactions. +I have an error saying that this account has already been synchronized +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -If your bank account is properly linked to a journal and posted transactions are not visible in your -database, please `submit a support ticket `_. +The bank account has already been synchronized with Salt Edge. Access the Salt Edge `dashboard +`_ to check if a connection with the same credentials exists. +There are two options: -How can I update my bank credentials? -------------------------------------- +- 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 + ` to reactivate the connection. -To update your credentials, activate the :ref:`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 diff --git a/content/applications/finance/accounting/bank/bank_synchronization/enablebanking.rst b/content/applications/finance/accounting/bank/bank_synchronization/enablebanking.rst deleted file mode 100644 index adcf2eec0f..0000000000 --- a/content/applications/finance/accounting/bank/bank_synchronization/enablebanking.rst +++ /dev/null @@ -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 `_ - -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. diff --git a/content/applications/finance/accounting/bank/bank_synchronization/enablebanking/enablebanking.png b/content/applications/finance/accounting/bank/bank_synchronization/enablebanking/enablebanking.png deleted file mode 100644 index 80680dc238..0000000000 Binary files a/content/applications/finance/accounting/bank/bank_synchronization/enablebanking/enablebanking.png and /dev/null differ diff --git a/content/applications/finance/accounting/bank/bank_synchronization/enablebanking/enablebankingauth.png b/content/applications/finance/accounting/bank/bank_synchronization/enablebanking/enablebankingauth.png deleted file mode 100644 index 32c19f3a5d..0000000000 Binary files a/content/applications/finance/accounting/bank/bank_synchronization/enablebanking/enablebankingauth.png and /dev/null differ diff --git a/content/applications/finance/accounting/bank/bank_synchronization/ponto.rst b/content/applications/finance/accounting/bank/bank_synchronization/ponto.rst index 8ebf5f1f3e..b7ef4b5d4e 100644 --- a/content/applications/finance/accounting/bank/bank_synchronization/ponto.rst +++ b/content/applications/finance/accounting/bank/bank_synchronization/ponto.rst @@ -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 `_ 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 `_ + +.. _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) `_. -#. 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 ` if + needed. +#. :ref:`Connect Odoo to your bank `. - .. 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. +#. Access the `Ponto website `_. +#. Click :guilabel:`Login`, then :guilabel:`Not a user yet?` and follow the instructions to create a + new account. -#. Add all bank accounts you want to synchronize with your Odoo database and move to the next steps. + .. note:: + Use the same email address as the one :ref:`used for your Odoo profile + `. -Link your Ponto account with your Odoo database ------------------------------------------------ +#. 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. -#. 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. +.. _accounting/bank-synchronization/ponto/odoo-connection: - .. image:: ponto/ponto-select-accounts.png - :alt: Selection of the accounts you wish to synchronize with Odoo. +Connection with Odoo +-------------------- -#. Finish the flow. +When :ref:`connecting a bank to Odoo ` using +Ponto as the third-party provider, follow these steps: -.. 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. +#. 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. -Update your synchronization credentials ---------------------------------------- +.. 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. -To update your Ponto credentials or modify the synchronization settings, activate the -:ref:`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. +.. seealso:: + :ref:`Update synchronization credentials ` -.. note:: - During the update, select **all accounts** you want to synchronize, even the ones coming from - other banking institutions. +.. _accounting/bank-synchronization/ponto/payments: -Fetch new accounts ------------------- +Vendor payments with Ponto +========================== -To add new online accounts to your connection, activate the :ref:`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. +.. important:: + Before managing vendor payments with Ponto, make sure the following steps are completed: -.. note:: - Don't forget to keep authorization for existing accounts (for all institutions that you have - synchronized with Ponto). + - :ref:`SEPA Credit Transfer is activated (SCT) `. + - :ref:`The SEPA Credit Transfer payment method has been added to the 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 + `. -FAQ -=== +To register a vendor payment using Ponto, follow these steps: -After my synchronization, no account appears --------------------------------------------- +#. Go to :menuselection:`Accounting --> Vendors --> Payments` and create the payment. Fill in the + relevant bank :guilabel:`Journal` field, select :ref:`SEPA Credit Transfer + ` 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 + `. 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. -You selected an institution from the list and did not authorize any accounts from this institution. +.. _accounting/bank-synchronization/ponto/troubleshooting: -I have an error about that my authorization has expired -------------------------------------------------------- +Troubleshooting +=============== -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 `_. If you do not -do this, the synchronization will stop for these accounts. +.. seealso:: + :ref:`Bank synchronization troubleshooting ` -I have some errors with my beta institution -------------------------------------------- +.. _accounting/bank-synchronization/ponto/troubleshooting/expired-authorization: -Ponto provides institutions in *beta*, these institutions are not directly supported by Odoo -and we advise you to contact Ponto directly. +Why has the authorization expired? +---------------------------------- -.. important:: - Using an institution in beta is beneficial for Ponto, it allows them to have real - feedback on the connection with the institution. +Every six months (180 days), the connection between a bank account and Ponto must be re-authorized +via the `Ponto website `_. Failure to do so will result in synchronization +stopping for those accounts. diff --git a/content/applications/finance/accounting/bank/bank_synchronization/ponto/ponto-add-account.png b/content/applications/finance/accounting/bank/bank_synchronization/ponto/ponto-add-account.png deleted file mode 100644 index e3c08979ba..0000000000 Binary files a/content/applications/finance/accounting/bank/bank_synchronization/ponto/ponto-add-account.png and /dev/null differ diff --git a/content/applications/finance/accounting/bank/bank_synchronization/ponto/ponto-organization.png b/content/applications/finance/accounting/bank/bank_synchronization/ponto/ponto-organization.png deleted file mode 100644 index b261eda8c3..0000000000 Binary files a/content/applications/finance/accounting/bank/bank_synchronization/ponto/ponto-organization.png and /dev/null differ diff --git a/content/applications/finance/accounting/bank/bank_synchronization/ponto/ponto-select-accounts.png b/content/applications/finance/accounting/bank/bank_synchronization/ponto/ponto-select-accounts.png deleted file mode 100644 index 9258a26740..0000000000 Binary files a/content/applications/finance/accounting/bank/bank_synchronization/ponto/ponto-select-accounts.png and /dev/null differ diff --git a/content/applications/finance/accounting/bank/bank_synchronization/saltedge.rst b/content/applications/finance/accounting/bank/bank_synchronization/saltedge.rst deleted file mode 100644 index 70ce0bdc5f..0000000000 --- a/content/applications/finance/accounting/bank/bank_synchronization/saltedge.rst +++ /dev/null @@ -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 `, 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 `, -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 `_ -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 `_ 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 `, go to :menuselection:`Accounting --> Configuration --> Online -Synchronization`, and click :guilabel:`Update Credentials` to reactivate the connection. diff --git a/content/applications/finance/accounting/bank/bank_synchronization/saltedge/saltedge-contact-email.png b/content/applications/finance/accounting/bank/bank_synchronization/saltedge/saltedge-contact-email.png deleted file mode 100644 index 7103631d5b..0000000000 Binary files a/content/applications/finance/accounting/bank/bank_synchronization/saltedge/saltedge-contact-email.png and /dev/null differ diff --git a/content/applications/finance/accounting/bank/bank_synchronization/saltedge/saltedge-give-consent.png b/content/applications/finance/accounting/bank/bank_synchronization/saltedge/saltedge-give-consent.png deleted file mode 100644 index 683e2637a9..0000000000 Binary files a/content/applications/finance/accounting/bank/bank_synchronization/saltedge/saltedge-give-consent.png and /dev/null differ diff --git a/content/applications/finance/accounting/bank/bank_synchronization/saltedge/saltedge-login-page.png b/content/applications/finance/accounting/bank/bank_synchronization/saltedge/saltedge-login-page.png deleted file mode 100644 index 65930d9689..0000000000 Binary files a/content/applications/finance/accounting/bank/bank_synchronization/saltedge/saltedge-login-page.png and /dev/null differ diff --git a/content/applications/finance/accounting/bank/reconciliation.rst b/content/applications/finance/accounting/bank/reconciliation.rst index 560c92516b..c2ed196641 100644 --- a/content/applications/finance/accounting/bank/reconciliation.rst +++ b/content/applications/finance/accounting/bank/reconciliation.rst @@ -44,6 +44,10 @@ Transactions The transactions section on the left shows all bank transactions, with the newest displayed first. Click a transaction to select it. +.. seealso:: + - :ref:`Duplicate transactions ` + - :ref:`Missing transactions ` + Counterpart entries The counterpart entries section on the bottom right displays the options to match the selected bank transaction. Multiple tabs are available, including diff --git a/content/applications/finance/accounting/payments/pay_sepa.rst b/content/applications/finance/accounting/payments/pay_sepa.rst index 5b9e9155fe..15fd2a9ad6 100644 --- a/content/applications/finance/accounting/payments/pay_sepa.rst +++ b/content/applications/finance/accounting/payments/pay_sepa.rst @@ -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 `. +.. _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 -------------------- diff --git a/redirects/18.0.txt b/redirects/18.0.txt index 7f1891281e..6468bee255 100644 --- a/redirects/18.0.txt +++ b/redirects/18.0.txt @@ -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