[FIX] odoo_sh: change img who explain storage space

closes odoo/documentation#2616

X-original-commit: f52be8da2a
Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com>

Makefile

@@ -26,7 +26,7 @@ SOURCE_DIR     = content
 
 HTML_BUILD_DIR = $(BUILD_DIR)/html
 ifdef VERSIONS
-  HTML_BUILD_DIR := $(HTML_BUILD_DIR)/master
+  HTML_BUILD_DIR := $(HTML_BUILD_DIR)/saas-15.4
 endif
 ifneq ($(CURRENT_LANG),en)
   HTML_BUILD_DIR := $(HTML_BUILD_DIR)/$(CURRENT_LANG)

README.md

@@ -4,11 +4,11 @@
 
 ### Requirements
 
-- [Git](https://www.odoo.com/documentation/master/contributing/documentation.html#install-git)
-- [Python 3.7 or 3.8](https://www.odoo.com/documentation/master/contributing/documentation.html#python)
-- Python dependencies listed in the file [`requirements.txt`](https://github.com/odoo/documentation/tree/master/requirements.txt).
-- [Make](https://www.odoo.com/documentation/master/contributing/documentation.html#make)
-- A local copy of the [odoo/odoo repository in master](https://github.com/odoo/odoo/tree/master) (Optional)
+- [Git](https://www.odoo.com/documentation/saas-15.4/contributing/documentation.html#install-git)
+- [Python 3.7 or 3.8](https://www.odoo.com/documentation/saas-15.4/contributing/documentation.html#python)
+- Python dependencies listed in the file [`requirements.txt`](https://github.com/odoo/documentation/tree/saas-15.4/requirements.txt).
+- [Make](https://www.odoo.com/documentation/saas-15.4/contributing/documentation.html#make)
+- A local copy of the [odoo/odoo repository in saas-15.4](https://github.com/odoo/odoo/tree/saas-15.4) (Optional)
 
 ### Instructions
 
@@ -23,7 +23,7 @@
 
 2. Open the file `documentation/_build/html/index.html` in your web browser to display the render.
 
-3. See [this guide](https://www.odoo.com/documentation/master/contributing/documentation.html#preview-your-changes)
+3. See [this guide](https://www.odoo.com/documentation/saas-15.4/contributing/documentation.html#preview-your-changes)
    for more detailed instructions.
 
 Optional: to fully build the developer documentation with inline docstrings for documented Python
@@ -34,7 +34,7 @@ be shown.
 ## Contribute to the documentation
 
 For contributions to the content of the documentation, please refer to the
-[Introduction Guide](https://www.odoo.com/documentation/master/contributing/documentation.html).
+[Introduction Guide](https://www.odoo.com/documentation/saas-15.4/contributing/documentation.html).
 
 To **report a content issue**, **request new content** or **ask a question**, use the
 [repository's issue tracker](https://github.com/odoo/documentation-user/issues) as usual.

conf.py

@@ -22,7 +22,7 @@ copyright = 'Odoo S.A.'
 # `version` if the version info for the project being documented, acts as replacement for |version|,
 # also used in various other places throughout the built documents.
 # `release` is the full version, including alpha/beta/rc tags. Acts as replacement for |release|.
-version = release = 'master'
+version = release = 'saas-15.4'
 
 # The minimal Sphinx version required to build the documentation.
 needs_sphinx = '3.0.0'
@@ -95,7 +95,7 @@ else:
     import odoo.addons
     odoo.addons.__path__.append(str(odoo_dir) + '/addons')
     from odoo import release as odoo_release  # Don't collide with Sphinx's 'release' config option
-    odoo_version = '.'.join(str(s) for s in odoo_release.version_info[:2]).replace('~', '-')  # Change saas~XX.Y to saas-XX.Y
+    odoo_version = odoo_release.version.replace('~', '-')  # Change saas~XX.Y to saas-XX.Y
     odoo_version = 'master' if 'alpha' in odoo_release.version else odoo_version
     if release != odoo_version:
         _logger.warning(
@@ -187,6 +187,8 @@ sphinx.transforms.i18n.docname_to_domain = (
 # is populated. If a version is passed to `versions` but is not listed here, it will not be shown.
 versions_names = {
     'master': "Master",
+    'saas-15.4': "Odoo Online",
+    'saas-15.3': "Odoo Online",
     'saas-15.2': "Odoo Online",
     '15.0': "Odoo 15",
     '14.0': "Odoo 14",

content/administration/install/deploy.rst

@@ -215,11 +215,11 @@ LiveChat
 --------
 
 In multiprocessing, a dedicated LiveChat worker is automatically started and
-listening on :option:`the gevent port <odoo-bin --gevent-port>` but
+listening on :option:`the longpolling port <odoo-bin --longpolling-port>` but
 the client will not connect to it.
 
 Instead you must have a proxy redirecting requests whose URL starts with
-``/websocket/`` to the gevent port. Other request should be proxied to
+``/longpolling/`` to the longpolling port. Other request should be proxied to
 the :option:`normal HTTP port <odoo-bin --http-port>`
 
 To achieve such a thing, you'll need to deploy a reverse proxy in front of Odoo,
@@ -323,15 +323,9 @@ in ``/etc/nginx/sites-enabled/odoo.conf`` set:
     access_log /var/log/nginx/odoo.access.log;
     error_log /var/log/nginx/odoo.error.log;
 
-    # Redirect websocket requests to odoo gevent port
-    location /websocket {
+    # Redirect longpoll requests to odoo longpolling port
+    location /longpolling {
       proxy_pass http://odoochat;
-      proxy_set_header Upgrade $http_upgrade;
-      proxy_set_header Connection $connection_upgrade;
-      proxy_set_header X-Forwarded-Host $host;
-      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-      proxy_set_header X-Forwarded-Proto $scheme;
-      proxy_set_header X-Real-IP $remote_addr;
     }
 
     # Redirect requests to odoo backend server
@@ -387,12 +381,12 @@ notifications.
 The solutions to support livechat/motifications in a WSGI application are:
 
 * Deploy a threaded version of Odoo (instead of a process-based preforking
-  one) and redirect only requests to URLs starting with ``/websocket/`` to
-  that Odoo, this is the simplest and the websocket URL can double up as the cron 
-  instance.
+  one) and redirect only requests to URLs starting with ``/longpolling/`` to
+  that Odoo, this is the simplest and the longpolling URL can double up as
+  the cron instance.
 * Deploy an evented Odoo via ``odoo-gevent`` and proxy requests starting
-  with ``/websocket/`` to
-  :option:`the gevent port <odoo-bin --gevent-port>`.
+  with ``/longpolling/`` to
+  :option:`the longpolling port <odoo-bin --longpolling-port>`.
 
 .. _deploy/streaming:
 

content/administration/install/install.rst

@@ -700,6 +700,11 @@ A typical way to run the server would be:
       Where `CommunityPath` is the path of the Odoo Community installation, and `mydb` is the name
       of the PostgreSQL database.
 
+      .. warning::
+         Some versions of python on Mac might lead to the following error message: `current limit
+         exceeds maximum limit`. In that case, add the following parameter `--limit-memory-hard 0`
+         to avoid the problem.
+
 After the server has started (the INFO log `odoo.modules.loading: Modules loaded.` is printed), open
 http://localhost:8069 in your web browser and log in with the base administrator account: Use
 `admin` for the :guilabel:`Email` and, again, `admin` for the :guilabel:`Password`. That's it, you

content/administration/maintain/domain_names.rst

@@ -59,14 +59,12 @@ database manager.
      registrar.
    - You are the owner of the domain name and can use it for other purposes.
    - Odoo manages payment and technical support for you.
-   - This offer doesn't include any mailbox. However, you can :ref:`configure your MX records
-     <domain-name/odoo-manage>` to use your own email server or solution such as Google Workspace.
 
-To do so, go to :menuselection:`Website --> Domain Name`. Alternatively, open your `database manager
-<https://www.odoo.com/my/databases>`_, click on the :guilabel:`settings` button next to your
-database, then on :guilabel:`Domain names`.
+To do so, go to :menuselection:`Website --> Go to website --> Promote --> Domain Name`.
+Alternatively, open your `database manager <https://www.odoo.com/my/databases>`_, click on the
+:guilabel:`settings` button next to your database, then on :guilabel:`Domain names`.
 
-.. image:: domain_names/register-menu.png
+.. image:: domain_names/register-promote.png
    :align: center
    :alt: Clicking on Domain Names from an Odoo website
 

content/administration/odoo_sh/getting_started/branches.rst

@@ -71,7 +71,7 @@ The neutralization includes:
 * Disabling outgoing emails by intercepting them with a mailcatcher. An
   :ref:`interface to view <odoosh-gettingstarted-branches-tabs-mails>` the emails sent by your
   database is provided. That way, you do not have to worry about sending test emails to your contacts.
-* Setting payment providers and shipping providers in test mode.
+* Setting payment acquirers and shipping providers in test mode.
 * Disabling IAP services
 
 The latest database will be kept alive indefinitely, older ones from the same branch may get garbage collected

content/applications/finance.rst

@@ -11,4 +11,4 @@ Finance
     finance/expenses
     finance/documents
     finance/sign
-    finance/payment_providers
+    finance/payment_acquirers

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

@@ -64,8 +64,8 @@ Link your Ponto account with your Odoo database
 #. Finish the flow.
 
 .. 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.
+   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 at the second step.
 
 Update your synchronization credentials
 ---------------------------------------

content/applications/finance/accounting/bank/setup/foreign_currency.rst

@@ -1,117 +1,117 @@
-===========================================
-Manage a bank account in a foreign currency
-===========================================
+===================================
+Manage a bank 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
+In Odoo, every transaction is recorded in the default currency of the
+company. Reports are all based on the currency of the company. But for
+transactions occurring in another currency, Odoo stores both the value
+in the currency of the company and the value in the currency of the
+transaction.
+
+When you have a bank account in a foreign currencies, 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*.
+-  The debit/credit in the currency of the company
 
-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.
+-  The debit/credit in the currency of the bank account
+
+Currency rates are updated automatically using yahoo.com, or the
+European Central bank web-services.
 
 Configuration
 =============
 
-Activate multi-currencies
--------------------------
+Activate the multi-currency feature
+-----------------------------------
 
-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`.
+In order to allow your company to work with multiple currencies, you
+should activate the multi-currency mode. In the accounting application,
+go into :menuselection:`Configuration --> Settings --> Accounting & Finance Features`
+make sure the **Allow Multi-currencies** box is ticked. Provide
+a **Currency Exchange Gain / Loss** account, then click on **Apply**.
 
 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`.
+Once the Odoo is configured to support multiple currencies, you should
+activate the currencies you plan to work with. To do that, go to the menu
+:menuselection:`Configuration --> Currencies`. All the currencies are created by default,
+but you should activate the ones you plan to support (to activate a
+currency, check its "Active" field).
 
-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.
+After having activated the currencies, you can configure the parameters
+to automate the currency rate update. These options are also in the
+settings of the Accounting application, in the bottom of the page:
 
-Click on the Update now button (:guilabel:`🗘`) besides the :guilabel:`Next Run` field to update
-the currency rates manually.
+.. image:: foreign_currency/foreign01.png
+   :align: center
+
+Click on the **Update Now** link to update the currency rates now.
 
 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.
+In the accounting application, we first go to :menuselection:`Configuration -->
+Accounting / Bank account`, and we create a new one.
 
-.. image:: foreign_currency/foreign-journal.png
+.. image:: foreign_currency/foreign02.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`.
+Once you save this bank account, Odoo will create all the documents for
+you:
 
-Vendor bill in a foreign currency
-=================================
+- An account in the trial balance
 
-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.
+- A journal in your dashboard
 
-.. image:: foreign_currency/foreign-bill-currency.png
+- Information about the bank account in the footer of your invoices if
+  checked the box **Show in Invoices Footer**
+
+Example: A vendor bill in a foreign currency
+============================================
+
+Based on the above example, let's assume we receive the following bill
+from a supplier in China.
+
+In the :menuselection:`Purchase --> Vendor Bills` , this is what you could see:
+
+.. image:: foreign_currency/foreign03.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.
+Once you are ready to pay this bill, click on register payment on the
+bill to record a payment.
 
-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
+.. image:: foreign_currency/foreign04.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.
+That's all you have to do. Odoo will automatically post the foreign
+exchange gain or loss at the reconciliation of the payment with the
+invoice, depending if the currency rate increased or decreased between
+the invoice and the payment date.
 
-.. image:: foreign_currency/foreign-exchange-rates.png
+Note that you can pay a foreign bill with another currency. In such a
+case, Odoo will automatically convert between the two currencies.
+
+Customers Statements
+====================
+
+Customers and vendor statements are managed in the currency of the
+invoice. So, the amount due by your customer (to your vendor) is always
+expressed in the currency of the invoice.
+
+If you have several invoices with different currencies for the same
+customer, Odoo will split the customer statement by currency, as shown
+in the report below.
+
+.. image:: foreign_currency/foreign05.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`.
+In the above report, the account receivable associated to Camptocamp is
+not managed in a secondary currency, which means that it keeps every
+transaction in its own currency. If you prefer, you can set the account
+receivable for this customer in a secondary currency and all its debts
+will automatically be converted to this currency.
 
-.. 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.
+In such a case, the customer statement always has only one currency. In
+general, this is not what the customer expect as he prefers to see the
+amounts in the currency of the invoices he received;

content/applications/finance/accounting/fiscal_localizations/localizations.rst

@@ -15,7 +15,6 @@ Localizations
    localizations/egypt
    localizations/france
    localizations/germany
-   localizations/india
    localizations/indonesia
    localizations/italy
    localizations/italy_IT

content/applications/finance/accounting/fiscal_localizations/localizations/chile.rst

@@ -17,8 +17,8 @@ The Chilean localization has been improved and extended in Odoo v13. In this ver
 modules are available:
 
 - **l10n_cl:** Adds accounting features for the Chilean localization, which represent the minimal 
-  configuration required for a company to operate in Chile and under the SII (Servicio de Impuestos
-  Internos) regulations and guidelines.
+  configuration required for a company to operate in Chile and under the SII 
+  (Servicio de Impuestos Internos) regulations and guidelines.
   
 - **l10n_cl_edi:** Includes all technical and functional requirements to generate and receive 
   Electronic Invoice via web service, based on the SII regulations. 
@@ -100,8 +100,8 @@ crucial to define the DTE incoming email server, considering this configuration:
 Certificate
 ~~~~~~~~~~~
 
-In order to generate the electronic invoice signature, a digital certificate with the extension
-``pfx`` is required, proceed to this section and load your file and password.
+In order to generate the electronic invoice signature, a digital certificate with the extension ``.pfx``
+is required, proceed to this section and load your file and password. 
 
 .. image:: chile/Chile03_3.png
    :align: center
@@ -118,7 +118,7 @@ certificate for a particular user, just define the users in the certificate.
 .. note::
    In some cases, depending on the certificate format, it is possible that the field Subject Serial
    Number is not loaded automatically. If this is the case, you can manually edit this field by
-   filling it with the Certificate's legal representative RUT.
+   filling it with the Certificate’s legal representative RUT.
 
 Financial Reports
 ~~~~~~~~~~~~~~~~~
@@ -134,8 +134,8 @@ Multicurrency
 ~~~~~~~~~~~~~
 
 The official currency rate in Chile is provided by the Chilean service `mindicador.cl
-<https://mindicador.cl>`_. You can find this service in the currency rate configuration, and you
-can set a predefined interval for the rate updates.
+<https://mindicador.cl>`_. You can find this service in the currency rate configuration, and you can
+set a predefined interval for the rate updates.
 
 .. image:: chile/Chile05_2.png
    :align: center
@@ -296,8 +296,9 @@ Online must be selected. Otherwise, if the journal is used for invoices imported
 system or if you are using the SII portal “Facturación MiPyme“ you can use the option Manual. 
 
 **Use Documents**: This field is used to define if the journal will use Document Types. It is only
-applicable to Purchase and Sales journals that can be related to the different sets of document
-types available in Chile. By default, all the sales journals created will use documents.
+applicable to Purchase and Sales journals that can be related to the
+different sets of document types available in Chile. By default, all the sales journals created will
+use documents. 
   
 .. image:: chile/Chile41.png
    :align: center
@@ -307,8 +308,6 @@ types available in Chile. By default, all the sales journals created will use do
    For the Chilean localization, it is important to define the default Debit and Credit accounts
    as they are required for one of the debit notes use cases.
    
-.. _chile/caf-documentation:
-
 CAF
 ---
 
@@ -320,8 +319,8 @@ Your company can make several requests for folios and obtain several CAFs, each
 with different ranges of folios. The CAFs are shared within all the journals, this means
 that you only need one active CAF per document type and it will be applied on all journals.
 
-Please refer to the `SII documentation <https://palena.sii.cl/dte/mn_timbraje.html>`_ to check the
-detail on how to acquire the CAF.
+Please refer to the SII documentation to check the detail on how to acquire the CAF:
+`SII Timbraje <https://palena.sii.cl/dte/mn_timbraje.html>`_.
 
 .. important::
    The CAFs required by the SII are different from Production to Test (Certification mode). Make
@@ -357,9 +356,9 @@ Usage and Testing
 Electronic Invoice Workflow
 ---------------------------
 
-In the Chilean localization the electronic Invoice workflow covers the Emission of Customer
-Invoices and the reception of Vendor Bills, in the next diagram we explain how the information
-transmitted to the SII and between the customers and Vendors.
+In the Chilean localization the electronic Invoice workflow covers the Emission of
+Customer Invoices and the reception of Vendor Bills, in the next diagram we explain how
+the information transmitted to the SII and between the customers and Vendors. 
 
 .. image:: chile/Chile14.png
    :align: center
@@ -369,8 +368,8 @@ transmitted to the SII and between the customers and Vendors.
 Customer invoice Emission
 -------------------------
 
-After the partners and journals are created and configured, the invoices are created in the
-standard way, for Chile one of the differentiators is the document type which is selected
+After the partners and journals are created and configured, the invoices are created in
+the standard way, for Chile one of the differentiators is the document type which is selected
 automatically based on the Taxpayer. 
 
 You can manually change the document type if needed. 
@@ -383,12 +382,10 @@ You can manually change the document type if needed.
    Documents type 33: Electronic Invoice must have at least one item with tax, otherwise the SII
    rejects the document validation.
 
-.. _chile/electronic-invoice-validation:
-
 Validation and DTE Status
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-When all the invoice information is filled, either manually or automatically when it's created
+When all the invoice information is filled, either manually or automatically when it’s created
 from a sales order, proceed to validate the invoice.  After the invoice is posted:
 
 - The DTE File (Electronic Tax Document) is created automatically and added in the chatter.
@@ -421,9 +418,9 @@ The DTE status workflow is as follows:
       :alt: Identification transaction for invoice and Status update.
 
 
-   There are several internal status in the SII before you get Acceptance or Rejection, in case you
-   click continuously the Button Verify in SII, you will receive in the chatter the detail of
-   those intermediate statuses:
+   There are several internal status in the SII before you get Acceptance or Rejection, in
+   case you click continuously  the Button Verify in SII, you will receive in the chatter the
+   detail of those intermediate statuses:
    
    .. image:: chile/Chile18_2.png
       :align: center
@@ -431,21 +428,22 @@ The DTE status workflow is as follows:
 
 3. The final response from the SII, can take on of these values:
 
-   **Accepted:** Indicates the invoice information is correct, our document is now fiscally valid
-   and it's automatically sent to the customer.
 
-   **Accepted with objections:** Indicates the invoice information is correct but a minor issue was
-   identified, nevertheless our document is now fiscally valid and it's automatically sent to the
-   customer.
+   **Accepted:** Indicates the invoice information is correct, our document is now fiscally valid
+   and it’s automatically sent to the customer. 
+
+   **Accepted with objections:** Indicates the invoice information is correct but a minor issue
+   was identified, nevertheless our document is now fiscally valid and it’s automatically
+   sent to the customer.
 
    .. image:: chile/Chile19.png
       :align: center
       :alt: Email track once it is sent to the customer.
 
-   **Rejected:** Indicates the information in the invoice is incorrect and needs to be corrected,
-   the detail of the issue is received in the emails you registered in the SII, if it is properly
-   configured in Odoo, the details are also retrieved in the chatter once the email server is
-   processed.
+   **Rejected:** Indicates the information in the invoice is incorrect and needs to be
+   corrected, the detail of the issue is received in the emails you registered in the
+   SII, if it is properly configured in Odoo, the details are also retrieved
+   in the chatter once the email server is processed.
 	 
    If the invoice is Rejected please follow this steps:
 	 
@@ -463,8 +461,8 @@ Crossed references
 
 When the Invoice is created as a result of another fiscal document, the information related to the
 originator document must be registered in the Tab Cross Reference, which is commonly used for 
-credit or debit notes, but in some cases can be used on Customer Invoices as well. In the case of
-the credit and debit notes, they are set automatically by Odoo:
+credit or debit notes, but in some cases can be used on Customer Invoices as well. In the case of the
+credit and debit notes, they are set automatically by Odoo:
 
 .. image:: chile/Chile21.png
    :align: center
@@ -503,9 +501,9 @@ Once the invoice has been sent to the customer:
 Processed for Claimed invoices
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Once the invoice has been Accepted by the SII **it can not be cancelled in Odoo**. In case you get
-a Claim for your customer the correct way to proceed is with a Credit Note to either cancel the
-Invoice or correct it. Please refer to the :ref:`chile/credit-notes` section for more details.
+Once the invoice has been Accepted by the SII **it can not be cancelled in Odoo**.  In case you
+get a Claim for your customer the correct way to proceed is with a Credit Note to either cancel
+the Invoice or correct it. Please refer to the Credit Notes section for more details. 
 
 .. image:: chile/Chile24.png
    :align: center
@@ -532,7 +530,7 @@ you might have and which is the related solution.
 - Error: ``Fecha/Número Resolucion Invalido RECHAZO- CAF Vencido : (Firma_DTE[AAAA-MM-DD] -
   CAF[AAAA-MM-DD]) &gt; 6 meses.``
   
-  *Hint:* Try to add a new CAF related to this document as the one you're using is expired.
+  *Hint:* Try to add a new CAF related to this document as the one you’re using is expired.
   
 - Error: ``Element '{http://www.sii.cl/SiiDte%7DRutReceptor': This element is not expected. Expected
   is ( {http://www.sii.cl/SiiDte%7DRutEnvia ).``
@@ -545,10 +543,10 @@ you might have and which is the related solution.
   *Hint:* This error indicates that most likely, your company has not passed the `Certification
   process <https://www.sii.cl/factura_electronica/factura_mercado/proceso_certificacion.htm>`_ in 
   the SII - Sistema de Facturación de Mercado. If this is the case, please contact your Account 
-  Manager or Customer Support as this certification is not part of the the Odoo services, but we
-  can give you some alternatives.
+  Manager or Customer Support as this certification is not part of the the Odoo services,
+  but we can give you some alternatives.
+
 
-.. _chile/credit-notes:
 
 Credit Notes
 ------------
@@ -562,9 +560,8 @@ which is identified as document 64 in the SII.
    :alt: Creation of CAF for Credit notes.
 
 
-.. tip::
-   Refer to the :ref:`CAF section <chile/caf-documentation>` where we described the process to load
-   the CAF on each document type.
+.. tip:: Refer to the CAF section where we described the process to load the CAF on each 
+   document type.
 
 Use Cases
 ~~~~~~~~~
@@ -597,15 +594,15 @@ Odoo creates a Credit Note with the corrected text in an invoice and price 0.
    :alt: Credit note with the corrected value on the invoice lines.
 
 .. important::
-   It's important to define the default credit account in the Sales journal as it
+   It’s important to define the default credit account in the Sales journal as it
    is taken for this use case in specific. 
 
 Corrects Referenced Document Amount
 ***********************************
 
-When a correction on the amounts is required, use the button Add Credit note and select Partial
-Refund. In this case the SII reference Code is automatically set to: Corrige el monto del Documento
-de Referencia.
+When a correction on the amounts is required, use the button Add Credit note
+and select Partial Refund. In this case the SII reference Code is automatically
+set to: Corrige el monto del Documento de Referencia.
 
 .. image:: chile/Chile30.png
    :align: center
@@ -615,8 +612,8 @@ Debit Notes
 -----------
 
 As part of the Chilean localization, besides creating credit notes from an existing document you
-can also create debit Notes. For this just use the button “Add Debit Note”. The two main use cases
-for debit notes are detailed below.
+can also create debit Notes. For this just use the button “Add Debit Note”.  The two main use
+cases for debit notes are detailed below. 
 
 Use Cases
 ~~~~~~~~~
@@ -649,6 +646,7 @@ Documentos de referencia.*
    :align: center
    :alt: Creating a debit note to cancel a credit note with the SII code reference 1.
 
+
 Vendor Bills
 ------------
 
@@ -659,6 +657,7 @@ have register in the SII in order to:
 - Automatically Send the reception acknowledgement to your vendor. 
 - Accept or Claim the document and send this status to your vendor. 
 
+
 Reception
 ~~~~~~~~~
 
@@ -674,13 +673,14 @@ As soon as the vendor email with the attached DTE is received:
 Acceptation
 ~~~~~~~~~~~
 
-If all the commercial information is correct on your vendor bill then you can accept the document
-using the :guilabel:`Aceptar Documento` button. Once this is done the DTE Acceptation Status
-changes to :guilabel:`Accepted`` and an email of acceptance is sent to the vendor.
+If all the commercial information is correct on your vendor bill, you can accept the document using
+the button: Aceptar Documento, once this is done the DTE Acceptation Status  changes to: Accepted and
+an email of acceptance is sent to the vendor. 
 
 .. image:: chile/Chile35.png
    :align: center
-   :alt: Acceptance button in vendor bills to inform vendor the document is comercially accepted.
+   :alt: Acceptance button in vendor bills to inform the vendor all the document is comercially accepted.
+   
 
 Claim
 ~~~~~
@@ -694,178 +694,9 @@ Acceptation Status change to: Claim and an email of acceptance is sent to the ve
    :alt: Claim button in vendor bills to inform the vendor all the document is comercially rejected.
    
 If you claim a vendor bill, the status changes from draft to cancel automatically. Considering this
-as best practice, all the Claim documents should be canceled as they won't be valid for your
+as best practice, all the Claim documents should be canceled as they won’t be valid for your
 accounting records. 
 
-Delivery Guide
---------------
-
-To install the Delivery Guide module, go to :menuselection:`Apps` and search for :guilabel:`Chile
-(l10n_cl)`. Then click :guilabel:`Install` on the module :guilabel:`Chile - E-Invoicing Delivery
-Guide`.
-
-.. note::
-   *Chile - E-Invoicing Delivery Guide* has a dependency with *Chile - Facturación Electrónica*.
-   Odoo will install the dependency automatically when the Delivery Guide module is installed.
-
-The Delivery Guide module includes sending the DTE to SII and the stamp in PDF reports for
-deliveries.
-
-.. image:: chile/chile42.png
-   :align: center
-   :alt: Install Delivery Guide Module
-
-Once all configurations have been made for electronic invoices (e.g., uploading a valid company
-certificate, setting up master data, etc.), Delivery Guides need their own CAFs. Please refer to the
-:ref:`CAF documentation <chile/caf-documentation>` to check the details on how to acquire the CAFs
-for electronic Delivery Guides.
-
-Verify the following important information in the *Price for the Delivery Guide* configuration:
-
-- :guilabel:`From Sales Order`: Delivery Guide takes the product price from the Sales Order and
-  shows it on the document.
-- :guilabel:`From Product Template`: Odoo takes the price configured in the product template and
-  shows it on the document.
-- :guilabel:`No show price`: no price is shown in the Delivery Guide.
-
-Electronic delivery guides are used to move stock from one place to another and they can represent
-sales, sampling, consignment, internal transfers, and basically any product move.
-
-Delivery Guide from a Sales Process
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-When a Sales Order is created and confirmed, a Delivery Order is generated. After validating the
-Delivery Order, the option to create a Delivery Guide is activated.
-
-.. image:: chile/chile43.png
-   :align: center
-   :alt: Create Delivery Guide Button
-
-When clicking on :guilabel:`Create Delivery Guide` for the first time, a warning message pops up,
-showing the following:
-
-.. image:: chile/chile44.png
-   :align: center
-   :alt: An example sequence error when creating a Delivery Guide in Odoo
-
-This warning message means the user needs to indicate the next sequence number Odoo has to take to
-generate the Delivery Guide, and only only happens the *first time* a Delivery Guide is created in
-Odoo. After the first document has been correctly generated, Odoo takes the CAFs next available
-number to generate the following Delivery Guide and so on.
-
-After the Delivery Guide is created:
-
-- The DTE file (Electronic Tax Document) is automatically created and added to the chatter.
-- The DTE SII status is set as: Pending to be sent.
-
-.. image:: chile/chile45.png
-   :align: center
-   :alt: DTE Status in SII and creation of DTE/XML
-
-The DTE Status is automatically updated by Odoo with a scheduled action that runs every day at
-night. To get a response from the SII immediately, press the :guilabel:`Send now to SII` button.
-
-Once the Delivery Guide is sent, it may then be printed by clicking on the :guilabel:`Print
-Delivery Guide` button.
-
-.. image:: chile/chile46.png
-   :align: center
-   :alt: Printing Delivery Guide PDF
-
-Electronic Receipt
-------------------
-
-To install the Electronic Receipt module, go to :menuselection:`Apps` and search for
-:guilabel:`Chile (l10n_cl)`. Then click :guilabel:`Install` on the module :guilabel:`Chile -
-Electronic Receipt`.
-
-.. note::
-   *Chile - Electronic Receipt* has a dependency with *Chile - Facturación Electrónica*. Odoo will
-   install the dependency automatically when the E-invoicing Delivery Guide module is installed.
-
-This module contains the electronic receipt and daily sales report, which are automatically sent to
-SII.
-
-.. image:: chile/chile47.png
-   :align: center
-   :alt: Install Electronic Receipt module
-
-Once all configurations have been made for Electronic Invoices (e.g., uploading a valid company
-certificate, setting up master data, etc.), Electronic Receipts need their own CAFs. Please refer
-to the :ref:`CAF documentation <chile/caf-documentation>` to check the details on how to acquire the
-CAFs for Electronic Receipts.
-
-Electronic Receipts are useful when clients do not need an Electronic Invoice. By default, there is
-a partner in the database called *Anonymous Final Consumer* with a generic RUT 66666666-6 and
-taxpayer type of *Final Consumer*. This partner can be used for Electronic Receipts or a new record
-may be created for the same purpose.
-
-Although Electronic Receipts should be used for final consumers with a generic RUT, it can also be
-used for specific partners. After the partners and journals are created and configured, the
-Electronic Receipts are created in the standard way as Electronic Invoice, but the type of document
-:guilabel:`(39) Electronic Receipt` should be selected, like so:
-
-.. image:: chile/chile48.png
-   :align: center
-   :alt: Select type of Document: (39) Boleta Electrónica
-
-Validation and DTE Status
-~~~~~~~~~~~~~~~~~~~~~~~~~
-
-When all of the Electronic Receipt information is filled, either manually or automatically from a
-Sales Order, proceed to validate the receipt. By default, Electronic Invoice is selected as the
-Document Type, however in order to validate the receipt correctly, make sure to edit the Document
-Type and change to Electronic Receipt.
-
-After the receipt is posted:
-
-- The DTE file (Electronic Tax Document) is created automatically and added to the chatter.
-- The DTE SII status is set as: Pending to be sent.
-
-.. image:: chile/chile49.png
-   :align: center
-   :alt: DTE status in SII and creation of DTE/XML
-
-The DTE Status is automatically updated by Odoo with a scheduled action that runs every day at
-night. To get a response from the SII immediately, press the :guilabel:`Send now to SII` button.
-
-Please refer to the :ref:`DTE Workflow <chile/electronic-invoice-validation>` for Electronic
-Invoices as the workflow for Electronic Receipt follows the same process.
-
-Daily Sales Report
-~~~~~~~~~~~~~~~~~~
-
-Once Electronic Receipts have been created, the system creates a daily sales report containing all
-Electronic Receipts per day. This report is electronically stamped and sent to the SII overnight in
-XML format. These daily reports can be found in :menuselection:`Reports --> Daily Sales Reports`.
-
-.. image:: chile/chile50.png
-   :align: center
-   :alt: Find Electronic Receipts in the Reports menu, under Daily Sales Reports
-
-A list of daily reports is displayed with all daily DTE sent to SII.
-
-.. image:: chile/chile51.png
-   :align: center
-   :alt: List of Daily Reports
-
-If no Electronic Receipt was made on a particular day, the report is sent but it will not have any
-receipts in it. The report will also have an answer from the SII if it was accepted or rejected
-(depending on the company's certificate and validated receipts).
-
-.. image:: chile/chile52.png
-   :align: center
-   :alt: Daily Sales Book example
-
-.. important::
-   For Chilean localization, note that the feature tax included in the price is *not* supported for
-   the Electronic Receipt.
-
-   If a Daily Sales Report has already been created for a specific day in another system, the daily
-   report in Odoo will be rejected due to the sequence number used. If that is the case, the user
-   has to manually click on :guilabel:`Retry` in order for a new sequence number to be generated
-   (this action is automatically done by Odoo). Afterwards, users can manually verify report status
-   with SII or wait for Odoo to update status later at night.
 
 Financial Reports
 =================
@@ -890,7 +721,7 @@ The form F29 is a new system that the SII enabled to taxpayers, and that replace
 Sales Books. This report is integrated by Purchase Register (CR) and the Sales Register (RV).
 Its purpose is to support the transactions related to VAT, improving its control and declaration. 
 
-This record is supplied by the electronic tax documents (DTE's) that have been received by the
+This record is supplied by the electronic tax documents (DTE’s) that have been received by the
 SII.
 
 You can find this report in :menuselection:`Accounting --> Accounting --> Reports`

content/applications/finance/accounting/fiscal_localizations/localizations/india.rst

@@ -1,189 +0,0 @@
-=====
-India
-=====
-
-.. _india/installation:
-
-Installation
-============
-
-:ref:`Install <general/install>` the following modules to get all the features of the Indian
-localization:
-
-.. list-table::
-   :header-rows: 1
-
-   * - Name
-     - Technical name
-     - Description
-   * - :guilabel:`Indian - Accounting`
-     - `l10n_in`
-     - Default :doc:`fiscal localization package <../overview/fiscal_localization_packages>`
-   * - :guilabel:`Indian E-invoice Integration`
-     - `l10n_in_edi`
-     - :ref:`Indian e-invoicing integration <india/e-invoicing>`
-
-.. _india/e-invoicing:
-
-Indian e-invoicing
-==================
-
-Odoo is compliant with the **Indian Good and Services Tax (GST) e-Invoice system** requirements.
-
-.. important::
-   Indian e-invoicing is available from Odoo 15.0. If needed, :doc:`upgrade
-   </administration/upgrade>` your database.
-
-.. _india/e-invoicing-api:
-
-Registration on your NIC e-Invoice web portal
----------------------------------------------
-
-You must register on the **NIC e-Invoice** web portal to get your **API credentials**. You need
-these credentials to :ref:`configure your Odoo Accounting app <india/e-invoicing-configuration>`.
-
-#. Login to the NIC e-Invoice web portal on - https://einvoice1.gst.gov.in/ by clicking on
-   :guilabel:`Login` and entering your :guilabel:`Username` and :guilabel:`Password`.
-
-   .. note::
-      If you have already registered on the NIC Eway Bill Production portal, then you can use the
-      same login credentials here.
-
-   .. image:: india/e-invoice-system-login.png
-      :align: center
-      :alt: Register Odoo ERP system on e-invoice web portal
-
-#. From your dashboard, go to :menuselection:`API Registration --> User Credentials --> Create API
-   User`.
-
-   .. image:: india/e-invoice-create-api-user.png
-      :align: center
-      :alt: Click on User Credentials and Create API User
-
-#. After that, you receive an :abbr:`OTP (one-time password)` code to your registered mobile number.
-#. Enter the OTP code and click on :guilabel:`Verify OTP`.
-
-   .. image:: india/trigger-otp.png
-      :align: center
-      :alt: Trigger an OTP to your registerd phone number
-
-#. Select :guilabel:`Through GSP` in the first field, select :guilabel:`Tera Software Limited`
-   as your GSP, and type in a :guilabel:`Username` and :guilabel:`Password` for your API.
-
-   .. image:: india/submit-api-registration-details.png
-      :align: center
-      :alt: Submit API specific Username and Password
-
-#. Click on :guilabel:`Submit`.
-
-.. _india/e-invoicing-configuration:
-
-Configuration on Odoo
----------------------
-
-To set up the e-invoice service, go to :menuselection:`Accounting --> Configuration --> Settings -->
-Indian Electronic Invoicing`, and enter the :guilabel:`Username` and :guilabel:`Password`.
-
-.. image:: india/e-invoice-setup.png
-   :align: center
-   :alt: Setup e-invoice service
-
-.. _india/e-invoicing-journals:
-
-Journals
-~~~~~~~~
-
-Your default *sales* journal should be already configured correctly. You can check it or configure
-other journals by going to :menuselection:`Accounting --> Configuration --> Journals`. Then, open
-your *sales* journal, and in the :guilabel:`Advanced Settings` tab, under :guilabel:`Electronic Data
-Interchange`, check :guilabel:`E-Invoice (IN)` and :guilabel:`Save`.
-
-.. image:: india/journal-configuration.png
-   :align: center
-   :alt: Journal configuration
-
-.. _india/e-invoicing-workflow:
-
-Workflow
---------
-
-To start invoicing from Odoo, an invoice must be created using the standard invoicing flow, that is,
-either from a sales order or the invoice menu in the Accounting application.
-
-.. _india/invoice-validation:
-
-Invoice validation
-~~~~~~~~~~~~~~~~~~
-
-Once the invoice is validated, a confirmation message is displayed at the top.
-
-Odoo automatically uploads the JSON-signed file to the government portal after a while. If you want
-to process the invoice immediately, you can click on :guilabel:`Process Now`.
-
-.. image:: india/e-invoice-process.png
-   :align: center
-   :alt: Indian e-invoicing confirmation message: "The invoice will be processed asynchronously by
-         the following E-invoicing service : E-Invoice (IN)"
-
-.. note::
-   - You can find the JSON-signed file in the attached files, in the chatter.
-   - You can check the status of EDI with web-service under the :guilabel:`EDI Document` tab or the
-     :guilabel:`Electronic invoicing` field.
-
-.. _india/invoice-pdf-report:
-
-Invoice PDF Report
-~~~~~~~~~~~~~~~~~~
-
-Once the invoice is submitted and validated, you can print the invoice PDF report. The report
-includes the :abbr:`IRN (Invoice Reference Number)`, acknowledgment number and date, and QR code.
-They certify that the invoice is a valid fiscal document.
-
-.. image:: india/invoice-report.png
-   :align: center
-   :alt: IRN and QR code
-
-.. _india/edi-cancellation:
-
-EDI Cancellation
-~~~~~~~~~~~~~~~~
-
-If you want to cancel an e-invoice, go to the :guilabel:`Other info` tab of the invoice and fill out
-the :guilabel:`Cancel reason` and :guilabel:`Cancel remarks` fields. Then, click on
-:guilabel:`Request EDI cancellation`. The status of the :guilabel:`Electronic invoicing` field
-changes to :guilabel:`To Cancel`.
-
-.. image:: india/e-invoice-cancellation.png
-   :align: center
-   :alt: cancel reason and remarks
-
-.. note::
-   If you want to abort the cancellation before processing the invoice, then click on
-   :guilabel:`Call Off EDI Cancellation`.
-
-Once you request to cancel the e-invoice, Odoo automatically submits the JSON Signed file to the
-government portal. If you want to process the invoice immediately, you can process it by clicking on
-:guilabel:`Process Now`.
-
-.. _india/verify-e-invoice:
-
-Verify the e-invoice from the GST
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-After submitting an e-invoice, you can also verify the signed invoice from the GST e-Invoice system
-website.
-
-#. Download the JSON file from the attached files.
-#. Open the e-invoice portal: https://einvoice1.gst.gov.in/ and go to :menuselection:`Search -->
-   Verify Signed Invoice`.
-#. Select the JSON file and submit it.
-
-   .. image:: india/verify-invoice.png
-      :align: center
-      :alt: select the JSON file for verify invoice
-
-#. You can check the verified signed e-invoice here.
-
-   .. image:: india/signed-invoice.png
-      :align: center
-      :alt: verified e-invoice

content/applications/finance/accounting/fiscal_localizations/localizations/luxembourg.rst

@@ -8,21 +8,9 @@ Configuration
 :ref:`Install <general/install>` the following modules to get all the features of the Luxembourgish
 localization:
 
-.. list-table::
-   :header-rows: 1
-
-   * - Name
-     - Technical name
-     - Description
-   * - :guilabel:`Luxembourg - Accounting`
-     - `l10n_lu`
-     - Default :doc:`fiscal localization package <../overview/fiscal_localization_packages>`
-   * - :guilabel:`Luxembourg - Accounting Reports`
-     - `l10n_lu_reports`
-     - Country-specific reports
-   * - :guilabel:`Luxembourg - Annual VAT Report`
-     - `l10n_lu_reports_annual_vat`
-     - Country-specific reports
+- :guilabel:`Luxembourg - Accounting` (module's technical name: ``l10n_lu``).
+- :guilabel:`Luxembourg - Accounting Reports` (module's technical name: ``l10n_lu_reports``).
+- :guilabel:`Luxembourg - Annual VAT Report` (module's technical name: ``l10n_lu_reports_annual_vat``).
 
 .. image:: luxembourg/modules.png
    :align: center

content/applications/finance/accounting/fiscal_localizations/localizations/mexico.rst

@@ -31,8 +31,8 @@ localization in Odoo, it is necessary to meet the following requirements:
 #. Be registered with the SAT and have an RFC.
 #. Have a `Certificate of Digital Seal
    <https://www.gob.mx/sat/acciones-y-programas/certificado-de-sello-digital>`_ (CSD).
-#. Choose a PAC and purchase stamps. Currently the Mexican location in Odoo works with the following
-   PACs: `Solución Factible <https://solucionfactible.com/>`_, `Quadrum (formerly Finkok)
+#. Choose a PAC and purchase stamps. Currently the Mexican location in Odoo works with two PACs:
+   `Solución Factible <https://solucionfactible.com/>`_, `Quadrum (formerly Finkok)
    <https://cfdiquadrum.com.mx/index.html>`_ and `SW Sapien - Smarter Web <https://sw.com.mx/>`_.
 #. Have knowledge and experience with billing, sales and accounting in Odoo. This documentation
    contains only the information necessary to enable the use of Odoo in a company based in Mexico.

content/applications/finance/accounting/fiscal_localizations/localizations/peru.rst

@@ -232,8 +232,9 @@ directly to its services and get the currency rate either automatically or manua
    :align: center
    :alt: Bank of Peru is displayed in Multicurrency Service option
    
-Please refer to the next section in our documentation for more information about
-:doc:`multicurrencies <../../others/multi_currency>`.
+Please refer to the next section in our documentation for more information about :doc:`multicurrency
+<../../others/multicurrencies/how_it_works>`.
+
 
 Configure Master data
 ---------------------

content/applications/finance/accounting/getting_started/initial_configuration/setup.rst

@@ -176,7 +176,7 @@ Payment Method
 This menu helps you configure the payment methods with which your customers can pay you.
 
 .. important::
-   Configuring a *Payment Provider* with this tool also activates the *Invoice Online Payment*
+   Configuring a *Payment Acquirer* with this tool also activates the *Invoice Online Payment*
    option automatically. With this, users can directly pay online, from their Customer Portal.
 
 .. _invoicing-setup-sample:

content/applications/finance/accounting/others.rst

@@ -7,7 +7,7 @@ Others
 .. toctree::
    :titlesonly:
 
-   others/multi_currency
    others/analytic
    others/adviser
+   others/multicurrencies
    others/inventory

content/applications/finance/accounting/others/multi_currency.rst

@@ -1,167 +0,0 @@
-=====================
-Multi-currency system
-=====================
-
-Odoo allows you to issue invoices, receive bills, and record transactions in currencies other than
-the main currency configured for your company. You can also set up bank accounts in other currencies
-and run reports on your foreign currency activities.
-
-.. seealso::
-   - :doc:`../bank/setup/foreign_currency`
-
-.. _multi-currency/config:
-
-Configuration
-=============
-
-.. _multi-currency/config-main-currency:
-
-Main currency
--------------
-
-The **main currency** is defined by default according to the company's country. You can change it by
-going to :menuselection:`Accounting --> Configuration --> Settings --> Currencies` and changing the
-currency in the :guilabel:`Main Currency` setting.
-
-.. _multi-currency/config-enable:
-
-Enable foreign currencies
--------------------------
-
-Go to :menuselection:`Accounting --> Configuration --> Currencies`, and enable the currencies you
-wish to use by toggling the :guilabel:`Active` button.
-
-.. image:: multi_currency/enable-foreign-currencies.png
-   :align: center
-   :alt: Enable the currencies you wish to use.
-
-.. _multi-currency/config-rates:
-
-Currency rates
---------------
-
-Manual update
-~~~~~~~~~~~~~
-
-To manually create and set a currency rate, go to :menuselection:`Accounting --> Configuration -->
-Currencies`, click on the currency you wish to change the rate of, and under the :guilabel:`Rates`
-tab, click :guilabel:`Add a line` to create a new rate.
-
-.. image:: multi_currency/manual-rate-update.png
-  :align: center
-  :alt: Create or modify the currency rate.
-
-Automatic update
-~~~~~~~~~~~~~~~~
-
-When you activate a second currency for the first time, :guilabel:`Automatic Currency Rates` appears
-under :menuselection:`Accounting Dashboard --> Configuration --> Settings --> Currencies`. By
-default, you have to click on the **Update now** button (:guilabel:`🗘`) to update the rates.
-
-Odoo can update the rates at regular intervals. To do so, change the :guilabel:`Interval` from
-:guilabel:`Manually` to :guilabel:`Daily`, :guilabel:`Weekly`, or :guilabel:`Monthly`. You can also
-select the web service from which you want to retrieve the latest currency rates by clicking on the
-:guilabel:`Service` field.
-
-.. _multi-currency/config-exch-diff:
-
-Exchange difference entries
----------------------------
-
-Odoo automatically records exchange differences entries on dedicated accounts, in a dedicated
-journal.
-
-You can define which journal and accounts to use to **post exchange difference entries** by
-going to :menuselection:`Accounting --> Configuration --> Settings --> Default Accounts` and editing
-the :guilabel:`Journal`, :guilabel:`Gain Account`, and :guilabel:`Loss Account`.
-
-.. example::
-   If you receive a payment for a customer invoice one month after it was issued, the exchange rate
-   has likely changed since. Therefore, this fluctuation implies some profit or loss due to the
-   exchange difference, which Odoo automatically records in the default **Exchange Difference**
-   journal.
-
-.. _multi-currency/config-coa:
-
-Chart of accounts
------------------
-
-Each account can have a set currency. By doing so, all moves relevant to the account are forced to
-have that account's currency.
-
-To do so, go to :menuselection:`Accounting --> Configuration --> Charts of Accounts` and select a
-currency in the field :guilabel:`Account Currency`. If left empty, all active currencies are handled
-instead of just one.
-
-.. _multi-currency/config-journals:
-
-Journals
---------
-
-If a currency is set on a **journal**, that journal only handles transactions in that currency.
-
-To do so, go to :menuselection:`Accounting --> Configuration --> Journals`, open the journal you
-want to edit, and select a currency in the field :guilabel:`Currency`. If left empty, all active
-currencies are handled instead of just one.
-
-.. image:: multi_currency/journal-currency.png
-   :align: center
-   :alt: Select the currency for the journal to handle.
-
-.. _multi-currency/mca:
-
-Multi-currency accounting
-=========================
-
-.. _multi-currency/mca-documents:
-
-Invoices, bills, and other documents
-------------------------------------
-
-For all documents, you can select the currency and journal to use for the transaction.
-
-.. image:: multi_currency/currency-field.png
-   :align: center
-   :alt: Select the currency and journal to use.
-
-.. _multi-currency/mca-payment:
-
-Payment registration
---------------------
-
-To register a payment in a currency other than your company's main currency, click on the
-:guilabel:`Register Payment` payment button of your document and, in the pop-up window, select a
-**currency** in the :guilabel:`Amount` field.
-
-.. image:: multi_currency/register-payment.png
-  :align: center
-  :alt: Select the currency and journal to use before registering the payment.
-
-.. _multi-currency/mca-statements:
-
-Bank statements
----------------
-
-When creating or importing bank statements, the amount is in the company's main currency. To see
-additional fields related to foreign currencies, click on the **columns dropdown button**
-(:guilabel:`⋮`) next to :guilabel:`Amount`, and check :guilabel:`Amount Currency` and
-:guilabel:`Foreign Currency`.
-
-.. image:: multi_currency/foreign-fields.png
-  :align: center
-  :alt: The extra fields related to foreign currencies.
-
-When reconciling, Odoo displays both the foreign currency amount and the equivalent amount in your
-company's main currency.
-
-.. _multi-currency/mca-exch-entries:
-
-Exchange rate journal entries
------------------------------
-
-To see **exchange difference journal entries**, go to :menuselection:`Accounting Dashboard -->
-Accounting --> Journals: Miscellaneous`.
-
-.. image:: multi_currency/exchange-journal-currency.png
-   :align: center
-   :alt: Exchange rate journal entry.

content/applications/finance/accounting/others/multicurrencies.rst

@@ -0,0 +1,12 @@
+:nosearch:
+
+=============
+Multicurrency
+=============
+
+.. toctree::
+   :titlesonly:
+
+   multicurrencies/how_it_works
+   multicurrencies/invoices_payments
+   multicurrencies/exchange

content/applications/finance/accounting/others/multicurrencies/exchange.rst

@@ -0,0 +1,112 @@
+=================================
+Record exchange rates at payments
+=================================
+
+Overview
+========
+
+Any company doing international trade faces the case where the payments
+are in a different currency.
+
+After receiving their payments, you have the option to convert the
+amount into your company currency. Multi currency payment implies rates
+fluctuations. The rate differences are automatically recorded by Odoo.
+
+Configuration
+=============
+
+Enable multi-currencies
+-----------------------
+
+In the accounting module, Go to :menuselection:`Configuration --> Settings` 
+and flag **Allow multi currencies**, then click on **apply**.
+
+.. image:: exchange/exchange_rate03.png
+   :align: center
+
+Configure the currency rates in :menuselection:`Configuration --> Currencies`.
+Write down the rate and make sure the currency is active.
+
+.. image:: exchange/exchange_rate02.png
+   :align: center
+
+In this document, the base currency is **Euro** and we will record payments
+in **Dollars**.
+
+.. image:: exchange/exchange_rate08.png
+   :align: center
+
+.. tip:: 
+    You can automatically fetch the currency rates from the **European
+    Central Bank** or from **Yahoo**. Please read the document : 
+    :doc:`how_it_works`.
+
+Configure your journal
+----------------------
+
+In order to register payments in other currencies, you have to **remove
+the currency constraint** on the journal. Go to the accounting
+application, Click on **More** on the journal and **Settings**.
+
+.. image:: exchange/exchange_rate06.png
+   :align: center
+
+Check if the **Currency** field is empty or in the foreign currency in which
+you will register the payments. If a currency is filled in, it means
+that you can register payments only in this currency.
+
+.. image:: exchange/exchange_rate10.png
+   :align: center
+
+Record a payment in a different currency
+========================================
+
+In the **Accounting** application, go to :menuselection:`Sales --> Payments`. 
+Register the payment and indicate that it was done in the foreign currency. Then
+click on **confirm**.
+
+.. image:: exchange/exchange_rate05.png
+   :align: center
+
+The journal entry has been posted but not allocated.
+
+Go back to your invoice (:menuselection:`Sales --> Customer Invoices`) and click on
+**Add** to allocate the payment.
+
+.. image:: exchange/exchange_rate04.png
+   :align: center
+
+Record a bank statement in a different currency
+===============================================
+
+Create or import the bank statement of your payment. The **Amount** is in
+the company currency. There are two complementary fields, the **Amount currency**, 
+which is the amount that was actually paid and the **Currency** in which it was paid.
+
+.. image:: exchange/exchange_rate07.png
+   :align: center
+
+When reconciling it, Odoo will directly match the payment with the right
+**Invoice**. You will get the invoice price in the invoice currency and the
+amount in your company currency.
+
+.. image:: exchange/exchange_rate09.png
+   :align: center
+
+Check the exchange rate differences
+===================================
+
+Go to :menuselection:`Adviser --> Journal Entries` and look for the **Exchange difference**
+journal entries. All the exchange rates differences are recorded in it.
+
+.. image:: exchange/exchange_rate01.png
+   :align: center
+
+.. tip::
+    The Exchange difference journal can be changed in your accounting settings.
+
+.. include:: exchange/full_reconcile_warning.rst
+
+.. seealso::
+    * :doc:`../../bank/reconciliation/reconciliation_models`
+    * :doc:`../../bank/reconciliation/use_cases`

content/applications/finance/accounting/others/multicurrencies/exchange/full_reconcile_warning.rst

@@ -0,0 +1,7 @@
+.. warning::
+    In order for an exchange difference entry to be created automatically, the
+    corresponding invoices and payments need to be fully reconciled. This means
+    the invoices are fully paid and the payments are fully spent on invoices.
+    If you partially pay 3 invoices from 2 payments, and the last invoice still
+    has an amount due, there will be no exchange difference entry for any of
+    them until that final amount is paid.

content/applications/finance/accounting/others/multicurrencies/how_it_works.rst

@@ -0,0 +1,171 @@
+============================
+Odoo's multi-currency system
+============================
+
+Overview
+========
+
+Choosing to use the multi-currency option in Odoo will allow you to send
+sales invoices, quotes and purchase orders or receive bills and payments
+in currencies other than your own. With multi-currency, you can also set
+up bank accounts in other currencies and run reports on your foreign
+currency activities.
+
+Configuration
+=============
+
+Turn on multi-currency
+----------------------
+
+In the accounting module, Go to :menuselection:`Configuration --> Settings` and flag
+**Allow multi currencies**, then click on **Apply**.
+
+.. image:: how_it_works/works01.png
+   :align: center
+
+Exchange Rate Journal
+---------------------
+
+The **Rate Difference Journal** records the differences between the payment
+registration and the expected amount. For example, if a payment is paid
+1 month after the invoice was issued, the exchange rate has probably
+changed. The fluctuation implies some loss or profit that are recorded
+by Odoo.
+
+You can change it in the settings:
+
+.. image:: how_it_works/works02.png
+   :align: center
+
+View or edit rate being used
+----------------------------
+
+You can manually configure the currency rates in :menuselection:`Configuration -->
+Currencies`. Open the currencies you want to use in Odoo and edit it.
+Make sure the currency is active.
+
+.. image:: how_it_works/works03.png
+   :align: center
+
+Click on **View Rates** to edit it and to see the history :
+
+.. image:: how_it_works/works04.png
+   :align: center
+
+Click on **Create** to add the rate. Fill in the date and the rate.
+Click on **Save** when you are done.
+
+.. image:: how_it_works/works05.png
+   :align: center
+
+Live Currency Rate
+------------------
+
+By default, the currencies need to be updated manually. But you can
+synchronize it with `Yahoo <https://finance.yahoo.com/currency-converter/>`__ or
+the `European Central Bank <http://www.ecb.europa.eu>`__. In 
+:menuselection:`Configuration --> Settings`, go to the **Live Currency Rate** section.
+
+Choose the interval : Manually, Daily, Weekly or Monthly. You can always
+force the update by clicking on **Update Now**. Select the provider, and you
+are set !
+
+.. image:: how_it_works/works06.png
+   :align: center
+
+.. note::
+   Only the **active** currencies are updated
+
+Configure your charts of account
+--------------------------------
+
+In the accounting application, go to :menuselection:`Adviser --> Charts of Accounts`.
+On each account, you can set a currency. It will force all moves for
+this account to have the account currency.
+
+If you leave it empty, it means that it can handle all currencies that
+are Active.
+
+.. image:: how_it_works/works07.png
+   :align: center
+
+Configure your journals
+-----------------------
+
+In order to register payments in other currencies, you have to remove
+the currency constraint on the journal. Go to the accounting
+application, Click on **More** on the journal and **Settings**.
+
+.. image:: how_it_works/works08.png
+   :align: center
+
+Check if the currency field is empty or in the foreign currency in which
+you will register the payments. If a currency is filled in, it means
+that you can register payments only in this currency.
+
+.. image:: how_it_works/works09.png
+   :align: center
+
+How is Odoo's multi-currency working?
+=====================================
+
+Now that you are working in a multi-currency environment, all
+accountable items will be linked to a currency, domestic or foreign.
+
+Sales Orders and Invoices
+-------------------------
+
+You are now able to set a different currency than the company one on
+your sale orders and on your invoices. The currency is set for the whole
+document.
+
+.. image:: how_it_works/works10.png
+   :align: center
+
+Purchases orders and Vendor Bills
+---------------------------------
+
+You are now able to set a different currency than the company one on
+your purchase orders and on your vendor bills. The currency is set for
+the whole document.
+
+.. image:: how_it_works/works11.png
+   :align: center
+
+Payment Registrations
+---------------------
+
+In the accounting application, go to :menuselection:`Sales --> Payments`. Register the payment and
+set the currency.
+
+.. image:: how_it_works/works12.png
+   :align: center
+
+Bank Statements
+---------------
+
+When creating or importing bank statements, the amount is in the company
+currency. But there are now two complementary fields, the amount that
+was actually paid and the currency in which it was paid.
+
+.. image:: how_it_works/works13.png
+   :align: center
+
+When reconciling it, Odoo will directly match the payment with the right
+Invoice. You will get the invoice price in the invoice currency and the
+amount in your company currency.
+
+Exchange Rate Journal
+---------------------
+
+Go to :menuselection:`Adviser --> Journal Entries` and look for the Exchange difference
+journal entries. All the exchange rates differences are recorded in it.
+
+.. image:: how_it_works/works14.png
+   :align: center
+
+.. include:: exchange/full_reconcile_warning.rst
+
+.. seealso::
+   * :doc:`invoices_payments`
+   * :doc:`exchange`

content/applications/finance/accounting/others/multicurrencies/invoices_payments.rst

@@ -0,0 +1,121 @@
+==================================================
+Manage invoices and payment in multiple currencies
+==================================================
+
+Overview
+========
+
+Odoo provides multi-currency support with automatic currency gross or
+loss entry adjustment. There are a few things Odoo has been to ease the
+user's life.
+
+All the account transactions will be done using the company currency.
+However you can see two extra fields with the journal entry where
+secondary currency and amount will visible. You can create
+multi-currency journals of force a specific currency.
+
+When creating an invoice, the currency can be changed very easily;
+however Odoo takes the company currency as a default assignment. It will
+convert all the amounts automatically using that currency.
+
+Configuration
+=============
+
+Enable Multi-Currency
+---------------------
+
+For information about enabling Multi-Currency, please read the document:
+:doc:`how_it_works`
+
+Configure your journal
+----------------------
+
+In order to register payments in other currencies, you have to remove
+the currency constraint on the journal. Go to the accounting
+application, on the journal, click on :menuselection:`More --> Settings`.
+
+.. image:: invoices_payments/invoice01.png
+   :align: center
+
+Check if the currency field is empty or in the foreign currency in which
+you will register the payments. If a currency is filled in, it means
+that you can register payments only in this currency.
+
+.. image:: invoices_payments/invoice02.png
+   :align: center
+
+Multi-currency invoices & Vendor Bills
+======================================
+
+Now that you are working in a multi-currency environment, all
+accountable items will be linked to a currency, domestic or foreign.
+
+Invoices
+--------
+
+You are now able to set a different currency than the company one on
+your sale orders and on your invoices. The currency is set for the whole
+document.
+
+.. image:: invoices_payments/invoice03.png
+   :align: center
+
+Vendor Bills
+------------
+
+You are now able to set a different currency than the company one on
+your purchase orders and on your vendor bills. The currency is set for
+the whole document.
+
+.. image:: invoices_payments/invoice04.png
+   :align: center
+
+Multi-currency Payments
+=======================
+
+In the accounting application, go to :menuselection:`Sales --> Payments`. Register the
+payment and indicate that it was done in the foreign currency. Then
+click on **Confirm**.
+
+.. image:: invoices_payments/invoice05.png
+   :align: center
+
+The journal entry has been posted but not allocated.
+
+Go back to your invoice (:menuselection:`Sales --> Customer Invoices`) and click on
+**Add** to allocate the payment.
+
+.. image:: invoices_payments/invoice06.png
+   :align: center
+
+Multi- Currency Bank Statements
+===============================
+
+When creating or importing bank statements, the amount is in the company
+currency. But there are now two complementary fields, the amount that
+was actually paid and the currency in which it was paid.
+
+.. image:: invoices_payments/invoice07.png
+   :align: center
+
+When reconciling it, Odoo will directly match the payment with the right
+invoice. You will get the invoice price in the invoice currency and the
+amount in your company currency.
+
+.. image:: invoices_payments/invoice08.png
+   :align: center
+
+Exchange Rate Journal
+=====================
+
+Go to :menuselection:`Adviser --> Journal Entries` and look for the **Exchange
+Difference** journal entries. All the exchange rates differences are recorded in it.
+
+.. image:: invoices_payments/invoice09.png
+   :align: center
+
+.. include:: exchange/full_reconcile_warning.rst
+
+.. seealso::
+   * :doc:`how_it_works`
+   * :doc:`exchange`