[IMP] accounting: add new version of doc about reconciliation models

- redirection: configure -> reconciliation_models

accounting/bank/reconciliation.rst

@@ -6,4 +6,4 @@ Bank Reconciliation
    :titlesonly:
 
    reconciliation/use_cases
-   reconciliation/configure
+   reconciliation/reconciliation_models

accounting/bank/reconciliation/configure.rst

@@ -1,63 +0,0 @@
-==========================
-Configure model of entries
-==========================
-
-Overview
-========
-
-In Odoo you have the possibility to pre-fill some accounting entries in
-order to easily reconcile recurrent entries such as bank fees.
-
-We will take the following example to illustrate the concept : Every
-month my company receives a bank fee cost, which depends of our bank
-account current balance. This fee is thus variable.
-
-Create Reconciliation Models
-============================
-
-First, we need to configure two model reconciliation entries. To do so,
-go to the accounting application dashboard. On your bank journal, click
-on :menuselection:`More --> Reconciliation Models`.
-
-.. image:: media/configure01.png
-   :align: center
-
-We want to be able to book our bank fees easily. Our bank deducts fees
-depending on our balance, meaning that it can vary every month.
-
-We create a button Label called Bank fees, select the correct account to
-book those fees. Moreover we also need to specify that the amount type
-is "Percentage of balance" with an Amount of 100%. This parameter will
-tell Odoo to take the entire fee into account.
-
-.. image:: media/configure02.png
-   :align: center
-
-Save your changes when you are done.
-
-.. note::
-   If the amount of your bank fee is fixed, you can as well select **Fixed**
-   under amount type and specify the amount in the amount tap.
-
-.. seealso::
-   You can also use this functionality to handle discounts. Please refer to
-   :doc:`../../receivables/customer_invoices/cash_discounts`
-
-Register your payments based on a reconciliation model
-======================================================
-
-Register your payment by importing your bank statements that will be
-impacted by the payment of the bank fee.
-
-When doing the reconciliation, you can select an open balance and click
-the **Reconciliation Model** button (in this case, **Bank Fees**) to get all
-the relevant data instantly.
-
-.. image:: media/configure03.png
-   :align: center
-
-Finally, click on **Reconcile** to finish the process.
-
-.. seealso::
-   * :doc:`../feeds/bank_synchronization`
-   * :doc:`use_cases`

accounting/bank/reconciliation/reconciliation_models.rst

@@ -0,0 +1,129 @@
+=====================
+Reconciliation Models
+=====================
+
+Once the bank statements are correctly imported, it is essential to *reconcile* the records properly
+and ensure all *Journal Entries* are balanced and in agreement. To ease and speed up the
+reconciliation process, you can configure **Reconciliation Models**, which are particularly useful
+with recurrent entries such as bank fees.
+
+.. todo:: Add a link to the Reconciliation process in the paragraph above, once the doc will have
+   been updated.
+
+.. note::
+   Reconciliation Models are also useful to handle *Cash Discounts*. Please refer to
+   :doc:`this documentation <../../receivables/customer_invoices/cash_discounts>` for more
+   information.
+
+.. _reconciliation_models_types:
+
+Types of Reconciliation Models
+==============================
+
+There are three types of Reconciliation Models:
+
+#. :ref:`Write-off Button <reconciliation_models_button>`
+#. :ref:`Suggestion of counterpart values <reconciliation_models_suggestion>`
+#. :ref:`Match existing invoices/bills <reconciliation_models_match>`
+
+.. _reconciliation_models_button:
+
+Manually create a write-off on clicked button
+---------------------------------------------
+
+When you are reconciling an entry with an *Open Balance*, you can use the buttons available under
+the *Manual Operations* tab to pre-fill all the values automatically, before validating the
+reconciliation. Each button is a different Reconciliation Model.
+
+.. image:: media/reconciliation_models_button.png
+   :align: center
+   :alt: Example of a Reconciliation Model with a write-off button in Odoo Accounting
+
+.. _reconciliation_models_suggestion:
+
+Suggest counterpart values
+--------------------------
+
+This type of Reconciliation Model suggests immediately counterpart values that only need to be
+validated. This automation is based on a set of rules defined in the reconciliation model.
+
+.. image:: media/reconciliation_models_suggestion.png
+   :align: center
+   :alt: Example of a Reconciliation Model that suggests counterpart values in Odoo Accounting
+
+.. _reconciliation_models_match:
+
+Match existing invoices/bills
+-----------------------------
+
+This type of Reconciliation Model automatically selects the right Customer Invoice or Vendor Bill
+that matches the payment. All that is left to do is to validate the entry. This automation is based
+on a set of rules defined in the reconciliation model.
+
+.. image:: media/reconciliation_models_match.png
+   :align: center
+   :alt: Example of a Reconciliation Model that matches existing invoices and bills automatically
+         in Odoo Accounting
+
+Configuration
+=============
+
+To manage or create new **Reconciliation Models**, go to :menuselection:`Accounting -->
+Reconciliation --> Reconciliation Models`. Alternatively, you can also open this menu from the
+Accounting Overview, by going to your Bank Journal card, clicking on the three little dots, and then
+on *Reconciliation Models*.
+
+.. image:: media/reconciliation_models_overview.png
+   :align: center
+   :alt: Open the Reconciliation Model menu from the overview dashboard in Odoo Accounting
+
+.. important::
+   The first entry, named *Invoices Matching Rule*, is the one responsible for the current matching
+   of invoices and bills. Therefore, it is advised to leave it at the top of the list and not to
+   delete it.
+
+Open the model you want to modify, or click on *Create* to create a new one, then fill out the form.
+
+Type
+----
+
+See :ref:`above <reconciliation_models_types>` for an explanation about the different types of
+Reconciliation Models.
+
+.. note::
+   If the *Documents* application is installed on your database, an additional **Activity type**
+   field appears when *To check* is ticked. Selecting the value *Reconciliation request* implies
+   that, whenever you use this model, a *Request Document* window pops up to request a document from
+   a user.
+
+Conditions on Bank Statement Line
+---------------------------------
+
+Define here all the conditions that are required for a Reconciliation Model to be applied.
+
+.. important::
+   If a record matches with several Reconciliation Models, the first one in the *sequence* of models
+   will be applied. The sequence is simply the order of the models in the *list view*. They can be
+   rearranged by dragging-and-dropping the handle next to the name.
+
+.. image:: media/reconciliation_models_conditions.png
+   :align: center
+   :alt: Conditions for the Reconciliation Model to be applied in Odoo Accounting
+
+Counterpart Values
+------------------
+
+This section comprises the values that are applied by the Reconciliation Model.
+
+If the value to reconcile needs to be written-off in two separate accounts, click on *Add a second
+line*.
+
+.. image:: media/reconciliation_models_counterparts.png
+   :align: center
+   :alt: Counterparts values of a Reconciliation Model in Odoo Accounting
+
+.. seealso::
+
+   - :doc:`use_cases`
+   - :doc:`../feeds/bank_synchronization`
+   - :doc:`../../receivables/customer_invoices/cash_discounts`

accounting/others/multicurrencies/exchange.rst

@@ -106,5 +106,5 @@ journal entries. All the exchange rates differences are recorded in it.
     The Exchange difference journal can be changed in your accounting settings.
 
 .. seealso::
-    * :doc:`../../bank/reconciliation/configure`
+    * :doc:`../../bank/reconciliation/reconciliation_models`
     * :doc:`../../bank/reconciliation/use_cases`

accounting/payables/pay/multiple.rst

@@ -144,5 +144,4 @@ model for cash discount.
 Now we are going back to bank statement and opening reconcile view.
 
 .. seealso::
-   - :doc:`../../bank/reconciliation/configure`
+   - :doc:`../../bank/reconciliation/reconciliation_models`
-

accounting/receivables/customer_invoices/cash_discounts.rst

@@ -65,4 +65,4 @@ match the payment with the two related journal entries.
 
 .. seealso::
   * :doc:`../../receivables/customer_invoices/payment_terms`
-  * :doc:`../../bank/reconciliation/configure`
+  * :doc:`../../bank/reconciliation/reconciliation_models`

redirects.txt

@@ -81,6 +81,7 @@ accounting/localizations/netherlands.rst accounting/fiscal_localizations/localiz
 accounting/localizations/spain.rst accounting/fiscal_localizations/localizations/spain.rst                        # localizations/* --> fiscal_localizations/localizations/*
 accounting/localizations/switzerland.rst accounting/fiscal_localizations/localizations/switzerland.rst            # localizations/* --> fiscal_localizations/localizations/*
 accounting/payables/supplier_bills/bills_or_receipts.rst accounting/payables/supplier_bills/purchase_receipts.rst # bills_or_receipts.rst -> purchase_receipts.rst
+accounting/bank/reconciliation/configure.rst accounting/bank/reconciliation/reconciliation_models.rst             # configure -> reconciliation_models (#613)
 
 social_marketing/social_marketing.rst social_marketing/overview.rst    # social_marketing/* -> overview/* (#578)