diff --git a/account_bank_statement_import_auto_reconcile/README.rst b/account_bank_statement_import_auto_reconcile/README.rst index 4457412..8f23e15 100644 --- a/account_bank_statement_import_auto_reconcile/README.rst +++ b/account_bank_statement_import_auto_reconcile/README.rst @@ -1,12 +1,38 @@ -.. image:: https://img.shields.io/badge/licence-AGPL--3-blue.svg - :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html - :alt: License: AGPL-3 - ===================================== Automatic reconciliation after import ===================================== -This addon allows you have Odoo reconcile transactions from a bank statement import automatically in cases where the matching transaction can be determined unambigously. +.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + !! This file is generated by oca-gen-addon-readme !! + !! changes will be overwritten. !! + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + +.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png + :target: https://odoo-community.org/page/development-status + :alt: Beta +.. |badge2| 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 +.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fbank--statement--import-lightgray.png?logo=github + :target: https://github.com/OCA/bank-statement-import/tree/10.0/account_bank_statement_import_auto_reconcile + :alt: OCA/bank-statement-import +.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png + :target: https://translation.odoo-community.org/projects/bank-statement-import-10-0/bank-statement-import-10-0-account_bank_statement_import_auto_reconcile + :alt: Translate me on Weblate +.. |badge5| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png + :target: https://runbot.odoo-community.org/runbot/174/10.0 + :alt: Try me on Runbot + +|badge1| |badge2| |badge3| |badge4| |badge5| + +This addon allows you have Odoo reconcile transactions from a bank statement +import automatically in cases where the matching transaction can be determined +unambigously. + +**Table of contents** + +.. contents:: + :local: Configuration ============= @@ -14,29 +40,20 @@ Configuration To configure this module, you need to: #. go to the journal your bank account uses -#. in the field ``Automatic reconciliation rules``, add at least one rule - -Usage -===== - -After a journal is configured for automatic reconciliations, it simply happens during an import on this journal. If there were automatic reconciliations, you'll see a notification about that and the lines in question will also show up as reconciled. +#. in tab ``Automatic reconciliation rules``, add at least one rule Reconciliation rules --------------------- +~~~~~~~~~~~~~~~~~~~~ Odoo standard Do exactly what Odoo does when proposing reconciliations. This searches for an exact match on amount and reference first, but falls back to less exact matches if none are found before. If there's only one match, do the reconciliation Exact amount and reference Strictly only match if we have the same partner, amount and reference. Check at least one field one the statement and one field on the move lines to tell the rule which fields to match with each other. -.. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas - :alt: Try me on Runbot - :target: https://runbot.odoo-community.org/runbot/174/8.0 - -Background -========== +Usage +===== -Mainly, this module is a framework for conveniently (for programmers) adding new custom automatic reconciliation rules. To do this, study the provided AbstractModels. +After a journal is configured for automatic reconciliations, it simply happens during an import on this journal if you don't disable the `auto reconcile` checkbox on the import wizard. If there were automatic reconciliations, you'll see a notification about that and the lines in question will also show up as reconciled. Known issues / Roadmap ====================== @@ -49,41 +66,53 @@ Known issues / Roadmap * add some helpers/examples for using the options field * allow to fiddle with the parameters of configured rules during a specific import +Background +~~~~~~~~~~ + +Mainly, this module is a framework for conveniently (for programmers) adding new custom automatic reconciliation rules. To do this, study the provided AbstractModels. + Bug Tracker =========== -Bugs are tracked on `GitHub 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. +Bugs are tracked on `GitHub 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 `_. + +Do not contact contributors directly about support or help with technical issues. Credits ======= -Images ------- +Authors +~~~~~~~ -* Odoo Community Association: `Icon `_. +* Therp BV Contributors ------------- +~~~~~~~~~~~~ * Holger Brunn * George Daramouskas -Do not contact contributors directly about help with questions or problems concerning this addon, but use the `community mailing list `_ or the `appropriate specialized mailinglist `_ for help, and the bug tracker linked in `Bug Tracker`_ above for technical issues. +Other credits +~~~~~~~~~~~~~ + +* Odoo Community Association: `Icon `_. + +Maintainers +~~~~~~~~~~~ -Maintainer ----------- +This module is maintained by the OCA. .. image:: https://odoo-community.org/logo.png :alt: Odoo Community Association :target: https://odoo-community.org -This module is maintained by the OCA. - 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. -To contribute to this module, please visit https://odoo-community.org. +This module is part of the `OCA/bank-statement-import `_ project on GitHub. + +You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute. diff --git a/account_bank_statement_import_auto_reconcile/readme/CONFIGURE.rst b/account_bank_statement_import_auto_reconcile/readme/CONFIGURE.rst new file mode 100644 index 0000000..7eeedff --- /dev/null +++ b/account_bank_statement_import_auto_reconcile/readme/CONFIGURE.rst @@ -0,0 +1,12 @@ +To configure this module, you need to: + +#. go to the journal your bank account uses +#. in tab ``Automatic reconciliation rules``, add at least one rule + +Reconciliation rules +~~~~~~~~~~~~~~~~~~~~ + + Odoo standard + Do exactly what Odoo does when proposing reconciliations. This searches for an exact match on amount and reference first, but falls back to less exact matches if none are found before. If there's only one match, do the reconciliation + Exact amount and reference + Strictly only match if we have the same partner, amount and reference. Check at least one field one the statement and one field on the move lines to tell the rule which fields to match with each other. diff --git a/account_bank_statement_import_auto_reconcile/readme/CONTRIBUTORS.rst b/account_bank_statement_import_auto_reconcile/readme/CONTRIBUTORS.rst new file mode 100644 index 0000000..2dd986b --- /dev/null +++ b/account_bank_statement_import_auto_reconcile/readme/CONTRIBUTORS.rst @@ -0,0 +1,2 @@ +* Holger Brunn +* George Daramouskas diff --git a/account_bank_statement_import_auto_reconcile/readme/CREDITS.rst b/account_bank_statement_import_auto_reconcile/readme/CREDITS.rst new file mode 100644 index 0000000..cc056a8 --- /dev/null +++ b/account_bank_statement_import_auto_reconcile/readme/CREDITS.rst @@ -0,0 +1 @@ +* Odoo Community Association: `Icon `_. diff --git a/account_bank_statement_import_auto_reconcile/readme/DESCRIPTION.rst b/account_bank_statement_import_auto_reconcile/readme/DESCRIPTION.rst new file mode 100644 index 0000000..2915dbf --- /dev/null +++ b/account_bank_statement_import_auto_reconcile/readme/DESCRIPTION.rst @@ -0,0 +1,3 @@ +This addon allows you have Odoo reconcile transactions from a bank statement +import automatically in cases where the matching transaction can be determined +unambigously. diff --git a/account_bank_statement_import_auto_reconcile/readme/ROADMAP.rst b/account_bank_statement_import_auto_reconcile/readme/ROADMAP.rst new file mode 100644 index 0000000..f1e2258 --- /dev/null +++ b/account_bank_statement_import_auto_reconcile/readme/ROADMAP.rst @@ -0,0 +1,12 @@ +* add more matching rules: + * AmountDiffuse (let the user configure the threshold) + * SameCompany (if A from company C bought it, but B from the same company/organization pays) + * AmountTransposedDigits (reconcile if only two digits are swapped. Dangerous and a special case of AmountDiffuse) + * whatever else we can think of +* add some helpers/examples for using the options field +* allow to fiddle with the parameters of configured rules during a specific import + +Background +~~~~~~~~~~ + +Mainly, this module is a framework for conveniently (for programmers) adding new custom automatic reconciliation rules. To do this, study the provided AbstractModels. diff --git a/account_bank_statement_import_auto_reconcile/readme/USAGE.rst b/account_bank_statement_import_auto_reconcile/readme/USAGE.rst new file mode 100644 index 0000000..f616151 --- /dev/null +++ b/account_bank_statement_import_auto_reconcile/readme/USAGE.rst @@ -0,0 +1 @@ +After a journal is configured for automatic reconciliations, it simply happens during an import on this journal if you don't disable the `auto reconcile` checkbox on the import wizard. If there were automatic reconciliations, you'll see a notification about that and the lines in question will also show up as reconciled. diff --git a/account_bank_statement_import_auto_reconcile/static/description/index.html b/account_bank_statement_import_auto_reconcile/static/description/index.html new file mode 100644 index 0000000..8141e53 --- /dev/null +++ b/account_bank_statement_import_auto_reconcile/static/description/index.html @@ -0,0 +1,483 @@ + + + + + + +Automatic reconciliation after import + + + +
+

Automatic reconciliation after import

+ + +

Beta License: AGPL-3 OCA/bank-statement-import Translate me on Weblate Try me on Runbot

+

This addon allows you have Odoo reconcile transactions from a bank statement +import automatically in cases where the matching transaction can be determined +unambigously.

+

Table of contents

+ +
+

Configuration

+

To configure this module, you need to:

+
    +
  1. go to the journal your bank account uses
    2. +
  2. in tab Automatic reconciliation rules, add at least one rule
    3. +
+
+

Reconciliation rules

+
+
+
Odoo standard
+
Do exactly what Odoo does when proposing reconciliations. This searches for an exact match on amount and reference first, but falls back to less exact matches if none are found before. If there’s only one match, do the reconciliation
+
Exact amount and reference
+
Strictly only match if we have the same partner, amount and reference. Check at least one field one the statement and one field on the move lines to tell the rule which fields to match with each other.
+
+
+
+
+
+

Usage

+

After a journal is configured for automatic reconciliations, it simply happens during an import on this journal if you don’t disable the auto reconcile checkbox on the import wizard. If there were automatic reconciliations, you’ll see a notification about that and the lines in question will also show up as reconciled.

+
+
+

Known issues / Roadmap

+
    +
  • +
    add more matching rules:
    +
      +
    • AmountDiffuse (let the user configure the threshold)
      • +
    • SameCompany (if A from company C bought it, but B from the same company/organization pays)
      • +
    • AmountTransposedDigits (reconcile if only two digits are swapped. Dangerous and a special case of AmountDiffuse)
      • +
    • whatever else we can think of
      • +
    +
    +
    +
    • +
  • add some helpers/examples for using the options field
    • +
  • allow to fiddle with the parameters of configured rules during a specific import
    • +
+
+

Background

+

Mainly, this module is a framework for conveniently (for programmers) adding new custom automatic reconciliation rules. To do this, study the provided AbstractModels.

+
+
+
+

Bug Tracker

+

Bugs are tracked on GitHub 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.

+

Do not contact contributors directly about support or help with technical issues.

+
+
+

Credits

+
+

Authors

+
    +
  • Therp BV
    • +
+
+
+

Contributors

+ +
+
+

Other credits

+
    +
  • Odoo Community Association: Icon.
    • +
+
+
+

Maintainers

+

This module is maintained by the OCA.

+Odoo Community Association +

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.

+

This module is part of the OCA/bank-statement-import project on GitHub.

+

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

+
+
+
+ +