odoo-forge-bundle 0.1.0

package/payload/skills/odoo18-docs/references/docs/applications/finance/accounting/bank/bank_synchronization/saltedge.md

@@ -0,0 +1,96 @@
+---
+title: "Salt Edge"
+source_url: "https://docs.odoo.sbggai.top/applications/finance/accounting/bank/bank_synchronization/saltedge.html"
+---
+
+=========
+# Salt Edge
+
+**Salt Edge** is a third-party provider that aggregates banking information
+from your bank accounts. It supports ~5000 institutions in more than 50
+countries.
+
+Odoo can synchronize directly with your bank to get all bank statements imported
+automatically into your database.
+
+.. seealso::
+   - :doc:`../bank_synchronization`
+   - :doc:`../transactions`
+
+# Configuration
+
+## Link your bank accounts with Odoo
+
+#. Start synchronization by clicking on :menuselection:`Accounting --> Configuration
+   --> Add a Bank Account`.
+#. Select the institution you want to synchronize. You can see if Salt Edge is the
+   third party provider of the institution by selecting it.
+#. After giving your phone number, you are asked for an email address. This email
+   address is used to create your Salt Edge account. Please make sure you enter a
+   valid email address, as otherwise, you will not be able to access your Salt Edge
+   account.
+
+   .. image:: saltedge/saltedge-contact-email.png
+      :alt: Email address to provide to Salt Edge for the creation of your account.
+
+#. After entering your email address, you are redirected to Salt Edge to continue
+   the synchronization process.
+
+   .. image:: saltedge/saltedge-login-page.png
+      :alt: Salt Edge Login page.
+
+#. Make sure you give your consent by checking the consent checkbox.
+
+   .. image:: saltedge/saltedge-give-consent.png
+      :alt: Salt Edge give consent page.
+
+#. Complete the synchronization by following the steps.
+
+
+## Update your credentials
+
+To update your Salt Edge credentials or modify the synchronization settings, activate the
+:ref:`developer mode <developer-mode>`, go to :menuselection:`Accounting --> Configuration -->
+Online Synchronization`, and select the institution you want to update credentials. Click
+:guilabel:`Update Credentials` to start the flow and follow the steps.
+
+Don't forget to check the consent checkbox. Otherwise, Odoo may not be able to access
+your information.
+
+## Fetch new accounts
+
+To add new online accounts to your connection, activate the :ref:`developer mode <developer-mode>`,
+go to :menuselection:`Accounting --> Configuration --> Online Synchronization`, and select the
+institution to fetch the new accounts. Click :guilabel:`Fetch Accounts` to start the flow and
+follow the steps.
+
+> **note**:
+>    Don't forget to check the consent checkbox. Otherwise, Odoo may not be able to access your
+   information.
+
+# FAQ
+
+## I have an error when I try to delete my synchronization within Odoo
+
+Odoo can't permanently delete the connection you have created with the banking institution. However,
+it can revoke the consent you gave so that Odoo won't be able to access your account anymore. The
+error you are seeing is probably a message telling you that the consent was revoked, but the record
+could not be deleted as it still exists within Salt edge. If you want to remove the connection
+completely, please connect to your [Salt Edge account ](https://www.saltedge.com/dashboard)
+and manually delete your synchronization. Once this is done, you can go back to Odoo to delete the
+record.
+
+## I have an error saying that I have already synchronized this account
+
+You have probably already synchronized your bank account with Salt Edge, please check on your
+[dashboard ](https://www.saltedge.com/dashboard) that you don't already have a connection with the
+same credentials.
+
+If you already have a synchronization with the same credentials present on your Salt Edge
+dashboard and this synchronization has not been created with Odoo, delete it and create it from your
+Odoo database.
+
+If you already have a connection with the same credentials present on your Salt Edge dashboard
+and this synchronization was created with Odoo, activate the :ref:`developer
+mode <developer-mode>`, go to :menuselection:`Accounting --> Configuration --> Online
+Synchronization`, and click :guilabel:`Update Credentials` to reactivate the connection.

package/payload/skills/odoo18-docs/references/docs/applications/finance/accounting/bank/bank_synchronization.md

@@ -0,0 +1,197 @@
+---
+title: ""
+source_url: "https://docs.odoo.sbggai.top/applications/finance/accounting/bank/bank_synchronization.html"
+---
+
+:show-content:
+# 
+# Bank synchronization
+
+Odoo can synchronize directly with your bank institution to get all bank statements imported
+automatically into your database.
+
+To check if your bank is compatible with Odoo, go to [Odoo Accounting Features
+](https://www.odoo.com/page/accounting-features), and click on
+:guilabel:`See list of supported institutions`.
+
+Odoo supports more than 26,000 institutions around the world.
+
+To connect to the banks, Odoo uses multiple web-services:
+
+- **Plaid**: United States of America and Canada
+- **Yodlee**: Worldwide
+- :doc:`Salt Edge <bank_synchronization/saltedge>`: Worldwide
+- :doc:`Ponto <bank_synchronization/ponto>`: Europe
+- :doc:`Enable Banking <bank_synchronization/enablebanking>`: Scandinavian countries
+
+.. seealso::
+   :doc:`transactions`
+
+# 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/
+
+## First synchronization
+
+You can start synchronization either by going to the Accounting app and
+:menuselection:`Accounting --> Configuration --> Add a Bank Account`.
+
+Now you can search for your bank institution. Select it and follow the steps to synchronize with it.
+
+> **note**:
+>    If you have any issues during your first synchronization, please verify that your
+   web browser doesn't block pop-ups and that your ad-blocker is disabled.
+
+> **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.
+
+You must provide a phone number during your first synchronization to secure your account. We ask for
+such information because we don't want your data falling into the wrong hands. Therefore, if we
+detect suspicious activities on your account, we block all requests coming from your account, and
+you need to reactivate it using that phone number.
+
+The third-party provider may request more information in order to connect with your bank
+institution. This information is not stored on Odoo's servers.
+
+By default, transactions fetched from an online source are grouped inside the same statement, and
+one bank statement is created per month. You can change the bank statement creation periodicity
+in your journal settings.
+
+To view all your synchronizations, activate the :ref:`developer mode <developer-mode>` and go to
+:menuselection:`Accounting --> Configuration --> Online Synchronization`.
+
+## Synchronize manually
+
+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.
+
+Alternatively, activate the :ref:`developer mode <developer-mode>`, go to
+:menuselection:`Accounting --> Configuration --> Online Synchronization`, select your institution,
+and then click the :guilabel:`Fetch transactions` button.
+
+> **important**:
+>    Some institutions do not allow transactions to be fetched automatically. For such institutions,
+   during the automatic synchronization of the account, you receive an error message asking you to
+   disable the automatic synchronization. This message can be found in the chatter of your online
+   synchronizations. In this case, make sure to perform manual synchronizations.
+
+# Issues
+
+## Synchronization in error
+
+To report a connection error to the [Odoo support ](https://www.odoo.com/help), activate the
+:ref:`developer mode <developer-mode>`, go to :menuselection:`Accounting --> Configuration -->
+Online Synchronization`, select the connection that failed, and copy the error description and the
+reference.
+
+## Synchronization disconnected
+
+If your connection with the proxy is disconnected, you can reconnect with the proxy using the
+:guilabel:`Fetch Account` button.
+
+> **note**:
+>    If you are unable to reconnect using the :guilabel:`Reconnect` button, please contact the
+   [support ](https://www.odoo.com/help) directly with your client id or the reference of the error
+   listed in the chatter.
+
+.. _MigrationOnlineSync:
+
+# Migration process for users having installed Odoo before December 2020
+
+If you are on-premise, please first make sure that your source is up-to-date with the latest version
+of Odoo.
+
+Users who have created a database before December 2020 need to install the new module manually to
+use the new functionalities.
+
+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.
+
+> **Note**:
+>    - All previous synchronizations are disconnected during the installation and will not work
+     anymore. To view them, activate the :ref:`developer mode <developer-mode>` and go to
+     :menuselection:`Accounting --> Configuration --> Online Synchronization`). It is not possible
+     to resynchronize these connections; you have to make new ones.
+   - Do not uninstall the `account_online_sync` module, which is the previous module for online
+     synchronization. The new one overrides it.
+   - By default, the `account_online_synchronization` module is installed automatically with
+     Accounting.
+
+# FAQ
+
+## The synchronization is not working in real-time. Is that normal?
+
+The process is not intended to work in real-time as third party providers synchronize your accounts
+at different intervals. To force the synchronization and fetch the statements, go to your
+:guilabel:`Accounting Dashboard`, and click on the :guilabel:`Synchronize Now` button. Synchronize
+and fetch transactions by activating the :ref:`developer mode <developer-mode>` and going to
+:menuselection:`Accounting --> Configuration --> Online Synchronization`. Some providers only allow
+one refresh per day, so it is possible that clicking on :guilabel:`Synchronize Now` does not get
+your latest transactions if you already performed such action earlier in the day.
+
+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.
+
+## Is the Online Bank Synchronization feature included in my contract?
+
+- **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.
+
+## Some banks have a status "Beta." What does this mean?
+
+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.
+
+## 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.
+
+## Not all of my past transactions are in Odoo, why?
+
+For some institutions, transactions can only be fetched up to 3 months in the past.
+
+## Why don't I see any transactions?
+
+During your first synchronization, you selected the bank accounts you decided to synchronize with
+Odoo. If you didn't synchronize any of your accounts, activate the :ref:`developer mode
+<developer-mode>`, go to :menuselection:`Accounting --> Configuration --> Online Synchronization`,
+and click the :guilabel:`Fetch Account` button on the connection.
+
+There may also be no new transactions.
+
+If your bank account is properly linked to a journal and posted transactions are not visible in your
+database, please [submit a support ticket ](https://www.odoo.com/help).
+
+## How can I update my bank credentials?
+
+To update your credentials, activate the :ref:`developer mode <developer-mode>` and go to
+:menuselection:`Accounting --> Configuration --> Online Synchronization`. Open the connection you
+want to update your credentials and click the :guilabel:`Update Credentials` button.
+
+.. toctree::
+   :titlesonly:
+
+   bank_synchronization/saltedge
+   bank_synchronization/ponto
+   bank_synchronization/enablebanking

package/payload/skills/odoo18-docs/references/docs/applications/finance/accounting/bank/foreign_currency.md

@@ -0,0 +1,115 @@
+---
+title: "Manage a bank account in a foreign currency"
+source_url: "https://docs.odoo.sbggai.top/applications/finance/accounting/bank/foreign_currency.html"
+---
+
+===========================================
+# Manage a bank account in a foreign currency
+
+In Odoo, every transaction is recorded in the default currency of the company, and reports are all
+based on that default currency. When you have a bank account in a foreign currency, for every
+transaction, Odoo stores two values:
+
+-  The debit/credit in the currency of the *company*;
+-  The debit/credit in the currency of the *bank account*.
+
+Currency rates are updated automatically using the web services of a banking institution. By
+default, Odoo uses the European Central Bank's web services but other options are available.
+
+# Configuration
+
+## Activate multi-currencies
+
+To work with multiple currencies, go to :menuselection:`Accounting --> Configuration --> Settings
+--> Currencies` and tick :guilabel:`Multi-Currencies`. Under :guilabel:`Post Exchange difference
+entries in:`, provide a :guilabel:`Journal`, a :guilabel:`Gain Account`, a :guilabel:`Loss Account`,
+and then click on :guilabel:`Save`.
+
+## Configure currencies
+
+Once Odoo is configured to support multiple currencies, they are all created by default, but not
+necessarily active. To activate the new currencies, click on :guilabel:`Activate Other Currencies`
+under the :guilabel:`Multi-Currencies` setting or go to :menuselection:`Accounting --> Configuration
+--> Accounting: Currencies`.
+
+When the currencies are activated, you can choose to **automate** the currency rate update, or leave
+it on **manual**. To configure the rate update, go back to :menuselection:`Accounting -->
+Configuration --> Settings --> Currencies`, check :guilabel:`Automatic Currency Rates`, set
+:guilabel:`Interval` to your desired frequency, and then click on :guilabel:`Save`. You also have
+the option to choose the :guilabel:`Service` you wish to obtain currency rates from.
+
+Click on the Update now button (:guilabel:`🗘`) besides the :guilabel:`Next Run` field to update
+the currency rates manually.
+
+## Create a new bank account
+
+In the accounting application, go to :menuselection:`Accounting --> Configuration --> Journals` and
+create a new one. Enter a :guilabel:`Journal Name` and set the :guilabel:`Type` to `Bank`. In the
+:guilabel:`Journal Entries` tab, enter a **short code**, a **currency**, and then finally click on
+the :guilabel:`Bank Account` field to create a new account. In the pop-up window of the account
+creation, enter a name, a code (ex.: 550007), set its type to `Bank and Cash`, set a currency type,
+and save. When you are back on the **journal**, click on the :guilabel:`Account Number` field, and
+in the pop-up window, fill out the :guilabel:`Account Number`, :guilabel:`Bank` of your account, and
+save.
+
+.. image:: foreign_currency/foreign-journal.png
+   :align: center
+   :alt: Example of a created bank journal.
+
+Upon creation of the journal, Odoo automatically links the bank account to the journal. It can be
+found under :menuselection:`Accounting --> Configuration --> Accounting: Chart of Accounts`.
+
+# Vendor bill in a foreign currency
+
+To pay a bill in a foreign currency, simply select the currency next to the :guilabel:`Journal`
+field and register the payment. Odoo automatically creates and posts the foreign **exchange gain or
+loss** as a new journal entry.
+
+.. image:: foreign_currency/foreign-bill-currency.png
+   :align: center
+   :alt: How to set a bill currency.
+
+> **note**:
+>    Note that you can pay a foreign bill with another currency. In that case, Odoo automatically
+   converts between the two currencies.
+
+# Unrealized Currency Gains/Losses Report
+
+This report gives an overview of all unrealized amounts in a foreign currency on your balance sheet,
+and allows you to adjust an entry or manually set an exchange rate. To access this report, go to
+:menuselection:`Reporting --> Management: Unrealized Currency Gains/Losses`. From here, you have
+access to all open entries in your **balance sheet**.
+
+.. image:: foreign_currency/foreign-gains-losses.png
+   :align: center
+   :alt: View of the Unrealized Gains/Losses journal.
+
+If you wish to use a different currency rate than the one set in :menuselection:`Accounting -->
+Configuration --> Settings --> Currencies`, click the :guilabel:`Exchange Rates` button and change
+the rate of the foreign currencies in the report.
+
+.. image:: foreign_currency/foreign-exchange-rates.png
+   :align: center
+   :alt: Menu to manually change exchange rates.
+
+When manually changing **exchange rates**, a yellow banner appears allowing you to reset back to
+Odoo's rate. To do so, simply click on :guilabel:`Reset to Odoo's Rate`.
+
+.. image:: foreign_currency/foreign-reset-rates.png
+   :align: center
+   :alt: Banner to reset back to Odoo's rates.
+
+In order to update your **balance sheet** with the amount of the :guilabel:`adjustment` column,
+click on the :guilabel:`Adjustment Entry` button. In the pop-up window, select a
+:guilabel:`Journal`, :guilabel:`Expense Account` and :guilabel:`Income Account` to calculate and
+process the **unrealized gains and losses**.
+
+You can set the date of the report in the :guilabel:`Date` field. Odoo automatically reverses the
+booking entry to the date set in :guilabel:`Reversal Date`.
+
+Once posted, the :guilabel:`adjustment` column should indicate `0.00`, meaning all **unrealized
+gains/losses** have been adjusted.
+
+.. image:: foreign_currency/foreign-adjustment.png
+   :align: center
+   :alt: Unrealized Currency Gains/Losses report once adjusted.

package/payload/skills/odoo18-docs/references/docs/applications/finance/accounting/bank/internal_transfers.md

@@ -0,0 +1,73 @@
+---
+title: "Internal transfers"
+source_url: "https://docs.odoo.sbggai.top/applications/finance/accounting/bank/internal_transfers.html"
+---
+
+==================
+# Internal transfers
+
+Internal money transfers can be handled in Odoo. At least two bank or cash accounts are needed to
+make internal transfers.
+
+.. seealso::
+   :ref:`How to add an additional bank account <accounting/bank/create>`
+
+# Configuration
+
+An internal transfer account is automatically created on your database based on your company's
+:doc:`localization <../../fiscal_localizations>` and depending on your country’s legislation. To
+modify the default :guilabel:`Internal Transfer` account, go to :menuselection:`Accounting -->
+Configuration --> Settings` and scroll down to the :guilabel:`Default Accounts` section.
+
+# Register an internal transfer from one bank to another
+
+When money is transferred from one bank or cash account to another, that amount appears as two
+transactions on the corresponding journals, whether the transactions are created manually, via
+import, or via :doc:`bank synchronization <bank_synchronization>`. When reconciling the transaction,
+select the :guilabel:`Internal Transfers` :doc:`reconciliation model <reconciliation_models>`
+button. This reconciliation model button writes the transaction off to the :guilabel:`Internal
+Transfer` account.
+
+> **tip**:
+>    Remember to reconcile the transaction for both the outgoing transaction on the journal that sends
+   the payment and the incoming transaction on the journal that receives the payment.
+
+.. example::
+   Take, for example, a transfer of $1000 from Bank A to Bank B:
+
+   - Bank journal (Bank A)
+
+     .. list-table::
+        :header-rows: 1
+        :stub-columns: 1
+
+        * - **Account**
+          - **Debit**
+          - **Credit**
+        * - Bank A account
+          -
+          - $1,000
+        * - **Internal transfer account**
+          - **$1,000**
+          -
+
+   - Bank journal (Bank B)
+
+
+     .. list-table::
+        :header-rows: 1
+        :stub-columns: 1
+
+        * - **Account**
+          - **Debit**
+          - **Credit**
+        * - Bank B account
+          - $1,000
+          -
+        * - **Internal transfer account**
+          -
+          - **$1,000**
+
+.. seealso::
+   :doc:`reconciliation`
+   :doc:`reconciliation_models`

package/payload/skills/odoo18-docs/references/docs/applications/finance/accounting/bank/loans.md

@@ -0,0 +1,70 @@
+---
+title: "Loans management"
+source_url: "https://docs.odoo.sbggai.top/applications/finance/accounting/bank/loans.html"
+---
+
+================
+# Loans management
+
+Odoo's loan management gives a comprehensive list of all loans undertaken by your company in order
+to maintain a holistic and forecasted view of upcoming due dates (e.g., cash forecast). Set up
+amortization schedules—or import them—and let Odoo automatically handle monthly interest and
+principal adjustments so that your financial reports are always accurate with minimal effort.
+
+## Create a new loan
+
+Create a new loan by going to :menuselection:`Accounting --> Accounting --> Loans`. When creating a
+new loan, there are three options for how to create amortization schedules:
+
+- importing it from a supported file;
+- calculating it from multiple input values (e.g., the :guilabel:`Amount Borrowed`, the
+  :guilabel:`Duration`, etc.) using the :guilabel:`Compute` button;
+- manually filling in the lines of the schedule.
+
+In each case, three different fields are required for each line of the amortization schedule: the
+:guilabel:`Date`, the :guilabel:`Principal`, and the :guilabel:`Interest`.
+
+The :guilabel:`Amount Borrowed`, :guilabel:`Interest`, and :guilabel:`Duration` fields will be red
+if the sum of the lines does not match the total of the amortization schedule lines.
+
+## Loan entries mechanism
+
+When the amount borrowed is credited to a bank account, it should be transferred to a long-term
+account (defined in the :guilabel:`Loan Settings` tab). Then, upon the validation of the loan, Odoo
+creates the necessary journal entries so that there is always a holistic and forecasted view of
+upcoming due dates. The entire process is completely automated with a long-term and short-term
+principal reclassification mechanism.
+
+For each line of the amortization schedule, Odoo creates the following entries:
+
+A payment entry on the same date that
+  - debits the principal amount to the long-term account;
+  - debits the interest amount to the expense account;
+  - credits the payment amount to the short-term account: this is the amount that will be
+    withdrawn by the bank.
+
+A reclassification entry on the same date that
+  - debits the sum of the principal amounts of the next 12 months to the long-term account;
+  - credits the sum of the principal amounts of the next 12 months to the short-term account.
+
+A reversed entry of the reclassification entry on *the next day* that simply reverses the previous
+one.
+
+With this mechanism, month after month, the short-term account is always up to date with the
+current short-term due amounts.
+
+## Closing a loan
+
+By default, a loan will be closed whenever its last payment entry is posted. However, it can also
+be manually closed (e.g., because it is being paid off early) by clicking on the :guilabel:`Close`
+button. A wizard will appear asking from which date the loan should be closed. All draft entries
+after this date will be deleted too.
+
+A loan can also be cancelled. In that case, all entries will be deleted even if they were already
+posted.
+
+## Loans Analysis Report
+
+By going to :menuselection:`Accounting --> Reporting --> Loans Analysis`, you can access a
+report with a pivot view of your ongoing loans. By default, the report shows the principal,
+interest, and total payment for each year for the loan duration.