[MERGE] Forward-port of branch 12.0 to 13.0

content/applications/finance/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`

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

@@ -0,0 +1,108 @@
+=======================================
+Bank reconciliation process - use cases
+=======================================
+
+Overview
+========
+
+Matching your bank statements with your accounting records can be a tedious task. You need to find the corresponding invoices, compare the amounts and partners' details with those in the bank statement. These steps can take a lot of time. Luckily, with Odoo you can very easily match your invoices or any other payment document with your bank statements.
+
+Two options of the reconciliation process exist in Odoo.
+
+1. We can directly specify the payment on the invoice
+2. We can reconcile open invoices with bank statements
+
+Configuration
+=============
+
+No special configuration is necessary to record invoices. All we need
+to do is to install the accounting app.
+
+.. image:: media/use01.png
+   :align: center
+
+Use cases
+=========
+
+Case 1: Payments registration
+-----------------------------
+
+We received the proof of payment of our invoice in the amount of 2100 euros issued to
+Smith & Co.
+
+We start at our issued Invoice of 2100 euros for Smith & Co. Because the
+sold product is a service we demand an immediate payment. Our accountant
+only handles bank statements at the end of week, so we have to mark
+this invoice as paid immediately in order to indicate that we can start rendering services to our
+customer.
+
+Our customer send us a payment confirmation. We can thus register a
+payment and mark the invoice as paid.
+
+.. image:: media/use02.png
+   :align: center
+
+By clicking on **register payment,** we are telling Odoo that our
+customer has paid the Invoice. We thus have to specify the amount and the
+payment method.
+
+.. image:: media/use03.png
+   :align: center
+
+Now we can always find the payment details in the Invoice by clicking on the
+:menuselection:`Info --> Open Payment`.
+
+.. image:: media/use04.png
+   :align: center
+
+The invoice has been paid and **the reconciliation has been done
+automatically.**
+
+Case 2: Bank statements reconciliations
+---------------------------------------
+
+We start at our issued Invoice of 3000 euros for Smith & Co. Let's also
+assume that other Invoices are open for different customers.
+
+.. image:: media/use05.png
+   :align: center
+
+We receive our bank statement and find that not only the invoice issued to Smith & Co has
+been paid, but the one to Buzz of 92 euros as well.
+
+**Import** or **Create** the bank statements. Please refer to the
+documents from the Bank Feeds section.
+
+.. image:: media/use06.png
+   :align: center
+
+On the dashboard, click on **Reconcile # Items**
+
+.. image:: media/use07.png
+   :align: center
+
+If everything was right (correct partner name, right amount) odoo will
+do the reconciliations **automatically**.
+
+.. image:: media/use08.png
+   :align: center
+
+If some issues are found, you will need to take **manual actions**.
+
+For example, if the partner is missing from your bank statement, just
+fill it in :
+
+.. image:: media/use09.png
+   :align: center
+
+If the payment is done with a down payment, just check if it is all
+right and validate all related payments :
+
+.. image:: media/use10.png
+   :align: center
+
+.. tip::
+   Hit CTRL-Enter to reconcile all the balanced items in the sheet.
+
+.. seealso::
+   * :doc:`../feeds/bank_synchronization`