[IMP] accounting: reconciliation models update

taskid-3377307

Author: Donapi

content/applications/finance/accounting/bank.rst

@@ -189,6 +189,5 @@ Payments` tab. To display the outstanding accounts column, click on the toggle b
    bank/bank_synchronization
    bank/transactions
    bank/reconciliation
-   bank/reconciliation_models
    bank/foreign_currency
    bank/cash_register

content/applications/finance/accounting/bank/reconciliation.rst

@@ -93,3 +93,8 @@ right and validate all related payments :
 
 .. seealso::
    :doc:`bank_synchronization`
+
+.. toctree::
+   :titlesonly:
+
+   reconciliation/reconciliation_models

content/applications/finance/accounting/bank/reconciliation/reconciliation_models.rst

@@ -0,0 +1,94 @@
+
+=====================
+Reconciliation models
+=====================
+
+Reconciliation models are used to automate the :doc:`../reconciliation` process, which is especially
+handy when dealing with recurring entries like bank fees. Reconciliation models can also be helpful
+to handle :doc:`cash discounts <../../customer_invoices/cash_discounts>`.
+
+Each model is created based on a :ref:`model type <models/type>` and :guilabel:`bank transactions
+conditions`.
+
+.. seealso::
+   - :doc:`../bank_synchronization`
+   - :doc:`../../customer_invoices/cash_discounts`
+   - `Odoo Tutorials: <https://www.odoo.com/slides/slide/reconciliation-models-1841?fullscreen=1>`_
+
+.. _models/type:
+
+Reconciliation model types
+==========================
+
+For each reconciliation model, a :guilabel:`Type` must be set. Three types of models exist:
+
+- :guilabel:`Rule to match invoices/bills`: used for recurring transactions to match the transaction
+  to existing invoices, bills, or payments based on conditions that must match the information on
+  the transaction;
+- :guilabel:`Rule to suggest counterpart entry`: used for recurring transactions to match the
+  transaction to a new entry based on conditions that must match the information on the transaction;
+- :guilabel:`Button to generate counterpart entry`: a button is created in the resulting entry
+  section of the bank reconciliation view. If clicked, this button generates a counterpart entry to
+  reconcile with the active transaction based on rules set in the model. The rules set in the model
+  determine the counterpart entry's account(s), amount(s), label(s), and analytic distribution.
+
+Default reconciliation models
+=============================
+
+Different models are available by default and can be updated, if needed, by going to
+:menuselection:`Accounting --> Configuration --> Banks: Reconciliation Models`. Users can also
+create their own reconciliation models by clicking :guilabel:`New`.
+
+.. important::
+   If a record matches with several reconciliation models, the first one in the *sequence* of models
+   is applied. You can rearrange the order by dragging and dropping the handle next to the name.
+
+   .. image:: reconciliation_models/list-view.png
+      :alt: Rearrange the sequence of models in the list view.
+
+Invoices/Bills perfect match
+----------------------------
+
+This model should be at the top of the *sequence* of models, as it enables Odoo to suggest matching
+existing invoices or bills with a bank transaction based on set conditions.
+
+.. image:: reconciliation_models/invoices-bills-perfect-match.png
+   :alt: Set rules to trigger the reconciliation.
+
+Odoo automatically reconciles the payment when the :guilabel:`Auto-validate` option is selected, and
+the model conditions are perfectly met. In this case, it expects to find on the bank statement's
+line the invoice/payment's reference (as :guilabel:`Label` is selected) and the partner's name
+(as :guilabel:`Partner is set` is selected) to suggest the correct counterpart entry and reconcile
+the payment automatically.
+
+Invoices/Bills partial match if underpaid (cash discount)
+---------------------------------------------------------
+
+This model suggests a customer invoice or vendor bill that partially matches the payment when the
+amount received is slightly lower than the invoice amount. The difference will be reconciled
+with the account indicated in the :guilabel:`counterpart entries` tab.
+
+The reconciliation model :guilabel:`Type` is :guilabel:`Rule to match invoices/bills`, and the
+:guilabel:`Payment tolerance` should be set.
+
+.. image:: reconciliation_models/partial-match.png
+   :alt: Set rules to trigger the reconciliation.
+
+.. note::
+   The :guilabel:`Payment tolerance` is only applicable to lower payments. It is disregarded when an
+   overpayment is received.
+
+Line with bank fees
+-------------------
+
+This model suggests a counterpart entry according to the rules set in the model. In this case, the
+reconciliation model :guilabel:`Type` is :guilabel:`Rule to suggest counterpart entry`, and the
+:guilabel:`Label` can be used for example, to identify the information referring to the
+:guilabel:`Bank fees` in the label of the transaction.
+
+.. image:: reconciliation_models/bank-fees.png
+   :alt: Set rules to trigger the reconciliation.
+
+.. note::
+   Go to the :guilabel:`Partner Mapping` tab to create a rule to match transactions of a specific
+   partner when a defined text is available in the :guilabel:`Label` or in the :guilabel:`Note`.