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 e626718b6d..de3cb684cc 100644 --- a/content/applications/finance/accounting/bank/reconciliation.rst +++ b/content/applications/finance/accounting/bank/reconciliation.rst @@ -55,10 +55,30 @@ expanded to show additional information and buttons. Transactions ------------ +<<<<<<< 9a4029373476cd18f64fbeadf040d0f2a7c9a2c9 Every :doc:`transaction ` is linked to a journal entry that debits/credits the journal's main account and its suspense account until it is fully reconciled. At that point, the suspense account is replaced with the account of the counterpart item or, in the case of :ref:`manual matching `, the selected account. +||||||| 6121497185404327defd9137544f8e852a23e172 +Counterpart entries + The counterpart entries section on the bottom right displays the options to match the selected + bank transaction. Multiple tabs are available, including + :ref:`reconciliation/existing-entries`, :ref:`reconciliation/batch-payments`, + :ref:`reconciliation/manual-operations`, and :guilabel:`Discuss`, which contains the chatter for + the selected bank transaction. +======= +.. 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 + :ref:`reconciliation/existing-entries`, :ref:`reconciliation/batch-payments`, + :ref:`reconciliation/manual-operations`, and :guilabel:`Discuss`, which contains the chatter for + the selected bank transaction. +>>>>>>> abf42bc7c3b5f50f8185a370341476087d224831 .. _accounting/reconciliation/action-buttons: 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 f227cf7459..de9cb906e0 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