Merge PR #261 into 11.0

Signed-off-by max3903

account_banking_reconciliation/README.rst

@@ -0,0 +1,243 @@
+===========================
+Bank Account Reconciliation
+===========================
+
+.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |badge1| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
+    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
+    :alt: License: AGPL-3
+.. |badge2| image:: https://img.shields.io/badge/github-OCA%2Faccount--reconcile-lightgray.png?logo=github
+    :target: https://github.com/OCA/account-reconcile/tree/11.0/account_banking_reconciliation
+    :alt: OCA/account-reconcile
+.. |badge3| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+    :target: https://translation.odoo-community.org/projects/account-reconcile-11-0/account-reconcile-11-0-account_banking_reconciliation
+    :alt: Translate me on Weblate
+.. |badge4| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png
+    :target: https://runbot.odoo-community.org/runbot/98/11.0
+    :alt: Try me on Runbot
+
+|badge1| |badge2| |badge3| |badge4| 
+
+This module is designed to provide an easy method in which Odoo accounting users
+can manually reconcile/validate their financial transactions from their financial
+institution/transaction providers (e.g. Paypal, A financial institution, google
+wallet, etc) against Odoo GL Chart of Account bank accounts.
+
+Users will be able to validate and indicate if a transaction has "Cleared the
+Bank" using a checkmark on a new Reconcile Financial Account Statement view on
+each individual financial transaction. Users will also be able to mark
+transactions on a bank account for future research.
+
+The idea is that as a first step users will manually look at their paper statement
+and line-by-line check off which financial transactions have cleared the bank in
+Odoo using the new Bank Reconciliation Wizard. These changes will be displayed on
+the  new Reconcile Financial Account Statement tree view screen. This is the
+process in which many companies reconcile (aka Audit) their bank account statements
+and accounting system today and represents good segregation of duties.
+
+Users can save their in-process reconciliations.
+
+Background
+----------
+
+Using the search view filters - users will also be able to effectively sort,
+filter the transactions on a particular GL Financial Account. This new screen
+will display the journal items associated with a particular bank account.
+Several of the field labels have been relabeled to a more common vernacular.
+
+The need for this module is driven by the following:
+
+* Users want to easily record whether bank transactions sent to their bank have
+  "cleared the bank"- definition of "cleared the bank": presented to the bank for
+  payment and paid by the bank - added/subtracted funds on a bank account.
+* Users want the ability to validate if the bank processed the transactions them
+  correctly (e.g. properly encoded transaction - e.g. company sent a payment of
+  $20.20 to the bank. Was it processed for $20.20?). This can be considered
+  "Auditing the bank statement". We don't assume the bank correctly processed any
+  transaction.
+* Users want to understand what payments they've made are still outstanding and
+  have not been paid by the bank.
+* The financial auditing segregation standard of separating the duties of:
+  recording customer payments and making deposits; recording supplier payments
+  and writing checks; and monitoring bank account activity. This segregation of
+  duties is necessary to monitor and help prevent fraud.
+
+Assumptions
+-----------
+
+#. Companies using Odoo have setup a one-to-one relationship between their
+   bank accounts and their Odoo GL accounts. Each bank account should have a
+   corresponding GL account that is not shared with another account.
+   Example:
+
+   +----------------------+------------------------------------------------------------+
+   | Odoo GL Account #    | Corresponding Bank Account                                 |
+   +======================+============================================================+
+   | 10100                | Bank (AR) Account Checking 5434 (held at Institution A)    |
+   +----------------------+------------------------------------------------------------+
+   | 10200                | Master Bank Account 2343 (held at Institution A)           |
+   +----------------------+------------------------------------------------------------+
+   | 10300                | Bank Payable Account Checking  5678 (held at Institution A)|
+   +----------------------+------------------------------------------------------------+
+   | 10400                | Bank Payroll Account 6656 (held at Institution B)          |
+   +----------------------+------------------------------------------------------------+
+   | 10500                | Paypal Account 3343 (held at Paypal)                       |
+   +----------------------+------------------------------------------------------------+
+   | 10600                | Google Wallet Account 6788                                 |
+   +----------------------+------------------------------------------------------------+
+   | 10700                | AMEX Corporate Card Account 9989                           |
+   +----------------------+------------------------------------------------------------+
+
+#. Companies have included a Non-Deposited Funds Account in their GL account
+   (typically in current assets in their bank account areas). This account is
+   used to store payments that have been recorded in Odoo - but not yet
+   deposited into the financial institution. (NOTE: this account is important to
+   have if the user "batches check deposits"- which is the process of making a
+   large single deposits of customer payment into the bank (e.g. $20,000USD), but
+   it is made up of smaller checks (e.g. 20 checks of $1,000 each). Many banks
+   just record the total deposit amount ($20,000) and don￢ﾀﾙt provide the
+   breakdown of the individual checks that make up the larger deposit. This
+   setup approach enables users to drill down and see the individual checks that
+   make up a larger deposit.
+
+Recommendations
+---------------
+
+From a cash management and financial control perspective, it is recommended that
+users establish the following four (4) bank accounts at their financial
+institution at a minimum to handle financial transactions. (NOTE: we recommend
+users place the last 4 digits of their bank account in the GL account name of the
+account. It helps accountants in their management of the system):
+
+* Bank (AR) Account Checking 5434. This is a checking account designated as the
+  account where payments made to the company are deposited (e.g. a customer
+  payment made by check is deposited here, or a customer paying by electronic
+  transaction EFT/ACH is deposited into this GL).
+* Master Bank Account 2343. This is the master account in which the company
+  keeps the majority of their funds. Often with the most limited access.
+* Bank Payable Account Checking  5678. This is a checking account designated for
+  the company to pay their expenses from. (e.g. Company writes a check to pay a
+  supplier for their office supplies).
+* Bank Payroll Account 6656. This is a checking account designated for a company
+  to pay their employees and payroll.
+
+Note
+----
+
+There has been common confusion in the Odoo community about managing bank
+statements in the base Odoo system. This module hopes to alleviate this gap and
+provide users with a sound alternative to maintain fiscal control, be easy to
+understand, and allow for future growth.
+
+Why this approach?
+------------------
+
+Users in Odoo have several options in which to record financial transactions that
+affect the balances of a bank account (GL Bank Account entries). We believe our
+approach allows these to work in conjunction with each other: Import Electronic
+Bank Statements to enter payments (this approach follows the philosophy that you
+first find out that a transaction has occurred from your bank which is very
+common in Europe due to the electronic nature of transactions).
+
+* Payment Order Payments (using the direct Method) - Payments are instantly recorded
+  and financial transactions posted into the GL
+* Voucher Payments - Payments are instantly recorded and financial transactions
+  posted into the GL
+* Sales Receipts/Refunds
+* Transfers between accounts (a new module is being developed to help manage this)
+* Funds moved from the Undeposited Funds GL account to a Bank Account GL account.
+* Direct Journal Entries
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Configuration
+=============
+
+To configure this module
+
+* Go to Settings and activate the developer mode
+* Go to Settings > Users and Companies > Users
+* Add users who will prepare the bank statements to the "Bank Statement Preparer"
+* Add users who will verify them to the "Bank Statement Manager" group
+
+Usage
+=====
+
+To use this module:
+
+* Go to Accounting > Adviser > Bank Statements
+* Create a new bank statement
+* Select the account and provide a name
+* Enter the ending balance from the bank statement
+* Check the transactions that cleared the bank
+* Check the balances
+* Save and submit for review
+* As a reviewer, check the transactions, totals and balances
+* Click on Process
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OCA/account-reconcile/issues>`_.
+In case of trouble, please check there if your issue has already been reported.
+If you spotted it first, help us smashing it by providing a detailed and welcomed
+`feedback <https://github.com/OCA/account-reconcile/issues/new?body=module:%20account_banking_reconciliation%0Aversion:%2011.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
+
+Do not contact contributors directly about support or help with technical issues.
+
+Credits
+=======
+
+Authors
+~~~~~~~
+
+* NovaPoint Group LLC
+* Open Source Integrators
+
+Contributors
+~~~~~~~~~~~~
+
+* Nova Point Group <info@novapointgroup.com>
+* Balaji Kannan <bkannan@opensourceintegrators.com>
+* Bhavesh Odedra <bodedra@opensourceintegrators.com>
+* Sandeep Mangukiya <smangukiya@opensourceintegrators.com>
+* Murtuza Saleh <murtuza.saleh@serpentcs.com>
+
+Other credits
+~~~~~~~~~~~~~
+
+* Nova Point Group <https://www.novapointgroup.com>
+* Open Source Integrators <https://www.opensourceintegrators.com>
+* Serpent Consulting Services Pvt. Ltd. <https://www.serpentcs.com>
+
+Maintainers
+~~~~~~~~~~~
+
+This module is maintained by the OCA.
+
+.. image:: https://odoo-community.org/logo.png
+   :alt: Odoo Community Association
+   :target: https://odoo-community.org
+
+OCA, or the Odoo Community Association, is a nonprofit organization whose
+mission is to support the collaborative development of Odoo features and
+promote its widespread use.
+
+.. |maintainer-max3903| image:: https://github.com/max3903.png?size=40px
+    :target: https://github.com/max3903
+    :alt: max3903
+
+Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:
+
+|maintainer-max3903| 
+
+This module is part of the `OCA/account-reconcile <https://github.com/OCA/account-reconcile/tree/11.0/account_banking_reconciliation>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

account_banking_reconciliation/__init__.py

@@ -0,0 +1,3 @@
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
+
+from . import models

account_banking_reconciliation/__manifest__.py

@@ -0,0 +1,31 @@
+# Copyright (C) 2019 Open Source Integrators
+# <https://www.opensourceintegrators.com>
+# Copyright (C) 2011 NovaPoint Group LLC (<http://www.novapointgroup.com>)
+# Copyright (C) 2004-2010 OpenERP SA (<http://www.openerp.com>)
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
+{
+    "name": "Bank Account Reconciliation",
+    "summary": "Check transactions that cleared the bank",
+    "version": "11.0.1.0.0",
+    "license": "AGPL-3",
+    "category": "Accounting and Financial Management",
+    "author": "NovaPoint Group LLC, "
+              "Open Source Integrators, "
+              "Odoo Community Association (OCA)",
+    "website": "https://github.com/OCA/account-reconcile",
+    "depends": [
+        "account_invoicing",
+        "account_voucher",
+    ],
+    "data": [
+        "security/account_banking_reconciliation.xml",
+        "security/ir.model.access.csv",
+        "views/account_banking_reconciliation.xml",
+        "views/account_move_line.xml",
+        "report/bank_statement_report.xml",
+        "report/report_bank_statement_summary.xml",
+        "report/report_bank_statement_detail.xml"],
+    "installable": True,
+    "development_status": "Stable",
+    "maintainers": ["max3903"],
+}