From f9dc2d88938e8e3c139eaff12ed7ecb48eec88cd Mon Sep 17 00:00:00 2001
From: Xavier Morel <xmo@odoo.com>
Date: Wed, 18 Mar 2015 15:57:03 +0100
Subject: [PATCH] [ADD] bank reconciliation, checks handling sections

---
 _static/misc.js | 32 +++++++++++++++++++++
 conf.py         |  1 +
 index.rst       | 74 +++++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 107 insertions(+)
 create mode 100644 _static/misc.js

diff --git a/_static/misc.js b/_static/misc.js
new file mode 100644
index 000000000..c3d559f9a
--- /dev/null
+++ b/_static/misc.js
@@ -0,0 +1,32 @@
+(function () {
+    document.addEventListener('DOMContentLoaded', function () {
+        var $section = $('.checks-handling');
+        if (!$section.length) { return; }
+
+        var $ul = $section.find('ul')
+            .find('li').each(function () {
+                var txt = this.textContent;
+                while (this.firstChild) {
+                    this.removeChild(this.firstChild)
+                }
+                
+                $('<label style="display: block;">')
+                    .append('<input type="radio" name="checks-handling">')
+                    .append(' ')
+                    .append(txt)
+                    .appendTo(this);
+            }).end()
+            .on('change', 'input', update);
+        update();
+        function update() {
+            var $inputs = $ul.find('input');
+            var idx = 0;
+            $inputs.each(function (index) {
+                if (this.checked) {
+                    idx = index;
+                }
+            }).eq(idx).prop('checked', true);
+            $ul.nextAll('div').hide().eq(idx).show();
+        }
+    });
+})();
diff --git a/conf.py b/conf.py
index bedc037b0..dac3c3a00 100644
--- a/conf.py
+++ b/conf.py
@@ -274,3 +274,4 @@ def setup(app):
     app.add_javascript('chart-of-accounts.js')
     app.add_javascript('entries.js')
     app.add_javascript('reconciliation.js')
+    app.add_javascript('misc.js')
diff --git a/index.rst b/index.rst
index 03b29434b..c11a3e5bb 100644
--- a/index.rst
+++ b/index.rst
@@ -124,6 +124,7 @@ to the sum of all its credits.
      - Bank Account: defined on the related bank journal
      - Account Receivable: defined on the customer
 
+.. _accounting/reconciliation:
 
 Reconciliation
 ==============
@@ -172,3 +173,76 @@ Customer Statement Example
 |Total To Pay             |50                       |                         |
 +-------------------------+-------------------------+-------------------------+
 
+
+Bank Reconciliation
+===================
+
+Bank reconciliation is the matching of bank statement lines (provided by your
+bank) with transactions recorded internally (payments to suppliers or from
+customers). For each line in a bank statement, it can be:
+
+matched with a previously recorded payment:
+  a payment is registered when a check is received from a customer, then
+  matched when checking the bank statement
+recorded as a new payment:
+  the payment's journal entry is created and :ref:`reconciled
+  <accounting/reconciliation>` with the related invoice when processing the
+  bank statement
+recorded as another transaction:
+  bank transfer, direct charge, etc.
+
+Odoo should automatically reconcile most transactions, only a few of them
+should need manual review. When the bank reconciliation process is finished,
+the balance on the bank account in Odoo should match the bank statement's
+balance.
+
+.. rst-class:: checks-handling
+
+Checks Handling
+===============
+
+There are two approaches to manage checks and internal wire transfer:
+
+* Two journal entries and a reconciliation
+* One journal entry and a bank reconciliation
+
+.. h:div:: force-right
+
+   The first journal entry is created by registering the payment on the
+   invoice. The second one is created when registering the bank statement.
+
+   .. rst-class:: table-condensed d-c-table
+
+   +-------------------------+--------------+------------+---------------+
+   |Account                  |Debit         |Credit      |Reconciliation |
+   +=========================+==============+============+===============+
+   |Account Receivable       |              |100         |Invoice ABC    |
+   +-------------------------+--------------+------------+---------------+
+   |Undeposited funds        |100           |            |Check 0123     |
+   +-------------------------+--------------+------------+---------------+
+
+   .. rst-class:: table-condensed d-c-table
+
+   +-------------------------+--------------+------------+---------------+
+   |Account                  |Debit         |Credit      |Reconciliation |
+   +=========================+==============+============+===============+
+   |Undeposited funds        |              |100         |Check 0123     |
+   +-------------------------+--------------+------------+---------------+
+   |Bank                     |100           |            |               |
+   +-------------------------+--------------+------------+---------------+
+
+.. h:div:: force-right
+
+   A journal entry is created by registering the payment on the invoice. When
+   reconciling the bank statement, the statement line is linked to the
+   existing journal entry.
+
+   .. rst-class:: table-condensed d-c-table
+
+   +-------------------------+--------------+------------+---------------+---------------+
+   |Account                  |Debit         |Credit      |Reconciliation |Bank Statement |
+   +=========================+==============+============+===============+===============+
+   |Account Receivable       |              |100         |Invoice ABC    |               |
+   +-------------------------+--------------+------------+---------------+---------------+
+   |Bank                     |100           |            |               |Statement XYZ  |
+   +-------------------------+--------------+------------+---------------+---------------+