diff --git a/account_bank_statement_import_online/README.rst b/account_bank_statement_import_online/README.rst new file mode 100644 index 00000000..8951e010 --- /dev/null +++ b/account_bank_statement_import_online/README.rst @@ -0,0 +1,122 @@ +====================== +Online Bank Statements +====================== + +.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + !! 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/12.0/account_bank_statement_import_online + :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-12-0/bank-statement-import-12-0-account_bank_statement_import_online + :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/12.0 + :alt: Try me on Runbot + +|badge1| |badge2| |badge3| |badge4| |badge5| + +This module provides base for building online bank statements providers. + +**Table of contents** + +.. contents:: + :local: + +Configuration +============= + +To configure online bank statements provider: + +#. Go to *Invoicing > Configuration > Bank Accounts* +#. Open bank account to configure and edit it +#. Set *Bank Feeds* to *Online* +#. Select online bank statements provider in *Online Bank Statements (OCA)* + section +#. Save the bank account +#. Click on provider and configure provider-specific settings. + +or, alternatively: + +#. Go to *Invoicing > Overview* +#. Open settings of the corresponding journal account +#. Switch to *Bank Account* tab +#. Set *Bank Feeds* to *Online* +#. Select online bank statements provider in *Online Bank Statements (OCA)* + section +#. Save the bank account +#. Click on provider and configure provider-specific settings. + +**NOTE**: To access these features, user needs to belong to +*Show Full Accounting Features* group. + +Usage +===== + +To pull historical bank statements: + +#. Go to *Invoicing > Configuration > Bank Accounts* +#. Select specific bank accounts +#. Launch *Actions > Online Bank Statements Pull Wizard* +#. Configure date interval and click *Pull* + +**NOTE**: To access these features, user needs to belong to +*Show Full Accounting Features* group. + +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 +~~~~~~~ + +* Brainbean Apps +* Dataplug + +Contributors +~~~~~~~~~~~~ + +* Alexey Pelykh + +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-alexey-pelykh| image:: https://github.com/alexey-pelykh.png?size=40px + :target: https://github.com/alexey-pelykh + :alt: alexey-pelykh + +Current `maintainer `__: + +|maintainer-alexey-pelykh| + +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_online/__init__.py b/account_bank_statement_import_online/__init__.py new file mode 100644 index 00000000..a82a91d6 --- /dev/null +++ b/account_bank_statement_import_online/__init__.py @@ -0,0 +1,5 @@ +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from . import models +from . import wizards +from .tests import online_bank_statement_provider_dummy diff --git a/account_bank_statement_import_online/__manifest__.py b/account_bank_statement_import_online/__manifest__.py new file mode 100644 index 00000000..597993b2 --- /dev/null +++ b/account_bank_statement_import_online/__manifest__.py @@ -0,0 +1,31 @@ +# Copyright 2019-2020 Brainbean Apps (https://brainbeanapps.com) +# Copyright 2019-2020 Dataplug (https://dataplug.io) +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +{ + 'name': 'Online Bank Statements', + 'version': '11.0.1.0.0', + 'author': + 'Brainbean Apps, ' + 'Dataplug, ' + 'Odoo Community Association (OCA)', + 'maintainers': ['alexey-pelykh'], + 'website': 'https://github.com/OCA/bank-statement-import/', + 'license': 'AGPL-3', + 'category': 'Accounting', + 'summary': 'Online bank statements update', + 'depends': [ + 'account', + 'account_bank_statement_import', + 'web_widget_dropdown_dynamic', + ], + 'data': [ + 'data/account_bank_statement_import_online.xml', + 'security/ir.model.access.csv', + 'security/online_bank_statement_provider.xml', + 'views/account_journal.xml', + 'views/online_bank_statement_provider.xml', + 'wizards/online_bank_statement_pull_wizard.xml', + ], + 'installable': True, +} diff --git a/account_bank_statement_import_online/data/account_bank_statement_import_online.xml b/account_bank_statement_import_online/data/account_bank_statement_import_online.xml new file mode 100644 index 00000000..63add6d2 --- /dev/null +++ b/account_bank_statement_import_online/data/account_bank_statement_import_online.xml @@ -0,0 +1,21 @@ + + + + + + Pull Online Bank Statements + 1 + hours + -1 + code + 2019-01-01 00:10:00 + + + model._scheduled_pull() + + + diff --git a/account_bank_statement_import_online/i18n/account_bank_statement_import_online.pot b/account_bank_statement_import_online/i18n/account_bank_statement_import_online.pot new file mode 100644 index 00000000..c94aa0cb --- /dev/null +++ b/account_bank_statement_import_online/i18n/account_bank_statement_import_online.pot @@ -0,0 +1,468 @@ +# Translation of Odoo Server. +# This file contains the translation of the following modules: +# * account_bank_statement_import_online +# +msgid "" +msgstr "" +"Project-Id-Version: Odoo Server 12.0\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: <>\n" +"Language-Team: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: \n" +"Plural-Forms: \n" + +#. module: account_bank_statement_import_online +#: code:addons/account_bank_statement_import_online/models/online_bank_statement_provider.py:154 +#, python-format +msgid "%(number)s %(type)s" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__message_needaction +msgid "Action Needed" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__active +msgid "Active" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__api_base +msgid "Api Base" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__message_attachment_count +msgid "Attachment Count" +msgstr "" + +#. module: account_bank_statement_import_online +#: model_terms:ir.ui.view,arch_db:account_bank_statement_import_online.online_bank_statement_pull_wizard_form +msgid "Cancel" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__certificate +msgid "Certificate" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__certificate_chain +msgid "Certificate Chain" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__certificate_private_key +msgid "Certificate Private Key" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__certificate_public_key +msgid "Certificate Public Key" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__company_id +msgid "Company" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,help:account_bank_statement_import_online.field_online_bank_statement_provider__company_id +msgid "Company related to this journal" +msgstr "" + +#. module: account_bank_statement_import_online +#: model_terms:ir.ui.view,arch_db:account_bank_statement_import_online.online_bank_statement_provider_form +msgid "Configuration" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__create_uid +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_pull_wizard__create_uid +msgid "Created by" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__create_date +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_pull_wizard__create_date +msgid "Created on" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__currency_id +msgid "Currency" +msgstr "" + +#. module: account_bank_statement_import_online +#: selection:online.bank.statement.provider,statement_creation_mode:0 +msgid "Daily statements" +msgstr "" + +#. module: account_bank_statement_import_online +#: selection:online.bank.statement.provider,interval_type:0 +msgid "Day(s)" +msgstr "" + +#. module: account_bank_statement_import_online +#: model_terms:ir.ui.view,arch_db:account_bank_statement_import_online.online_bank_statement_provider_form +msgid "Details" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__display_name +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_pull_wizard__display_name +msgid "Display Name" +msgstr "" + +#. module: account_bank_statement_import_online +#: code:addons/account_bank_statement_import_online/models/online_bank_statement_provider.py:197 +#, python-format +msgid "Failed to obtain statement data for period since %s until %s: %s. See server logs for more details." +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__message_follower_ids +msgid "Followers" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__message_channel_ids +msgid "Followers (Channels)" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__message_partner_ids +msgid "Followers (Partners)" +msgstr "" + +#. module: account_bank_statement_import_online +#: selection:online.bank.statement.provider,interval_type:0 +msgid "Hour(s)" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__id +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_pull_wizard__id +msgid "ID" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,help:account_bank_statement_import_online.field_online_bank_statement_provider__message_unread +msgid "If checked new messages require your attention." +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,help:account_bank_statement_import_online.field_online_bank_statement_provider__message_needaction +msgid "If checked, new messages require your attention." +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,help:account_bank_statement_import_online.field_online_bank_statement_provider__message_has_error +msgid "If checked, some messages have a delivery error." +msgstr "" + +#. module: account_bank_statement_import_online +#: code:addons/account_bank_statement_import_online/models/online_bank_statement_provider.py:151 +#: model_terms:ir.ui.view,arch_db:account_bank_statement_import_online.online_bank_statement_provider_filter +#, python-format +msgid "Inactive" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__interval_type +msgid "Interval Type" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__message_is_follower +msgid "Is Follower" +msgstr "" + +#. module: account_bank_statement_import_online +#: code:addons/account_bank_statement_import_online/models/online_bank_statement_provider.py:206 +#, python-format +msgid "Issue with Online Bank Statement Provider" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model,name:account_bank_statement_import_online.model_account_journal +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__journal_id +msgid "Journal" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__key +msgid "Key" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider____last_update +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_pull_wizard____last_update +msgid "Last Modified on" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__write_uid +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_pull_wizard__write_uid +msgid "Last Updated by" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__write_date +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_pull_wizard__write_date +msgid "Last Updated on" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__last_successful_run +msgid "Last successful pull" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__message_main_attachment_id +msgid "Main Attachment" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__message_has_error +msgid "Message Delivery error" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__message_ids +msgid "Messages" +msgstr "" + +#. module: account_bank_statement_import_online +#: selection:online.bank.statement.provider,interval_type:0 +msgid "Minute(s)" +msgstr "" + +#. module: account_bank_statement_import_online +#: selection:online.bank.statement.provider,statement_creation_mode:0 +msgid "Monthly statements" +msgstr "" + +#. module: account_bank_statement_import_online +#: code:addons/account_bank_statement_import_online/models/online_bank_statement_provider.py:204 +#, python-format +msgid "N/A" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__name +msgid "Name" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__next_run +msgid "Next scheduled pull" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__message_needaction_counter +msgid "Number of Actions" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__message_has_error_counter +msgid "Number of error" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,help:account_bank_statement_import_online.field_online_bank_statement_provider__message_needaction_counter +msgid "Number of messages which requires an action" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,help:account_bank_statement_import_online.field_online_bank_statement_provider__message_has_error_counter +msgid "Number of messages with delivery error" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,help:account_bank_statement_import_online.field_online_bank_statement_provider__message_unread_counter +msgid "Number of unread messages" +msgstr "" + +#. module: account_bank_statement_import_online +#: code:addons/account_bank_statement_import_online/models/account_journal.py:29 +#, python-format +msgid "Online (OCA)" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model,name:account_bank_statement_import_online.model_online_bank_statement_provider +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_account_journal__online_bank_statement_provider +#: model_terms:ir.ui.view,arch_db:account_bank_statement_import_online.online_bank_statement_provider_form +msgid "Online Bank Statement Provider" +msgstr "" + +#. module: account_bank_statement_import_online +#: model_terms:ir.ui.view,arch_db:account_bank_statement_import_online.online_bank_statement_provider_filter +msgid "Online Bank Statement Providers" +msgstr "" + +#. module: account_bank_statement_import_online +#: code:addons/account_bank_statement_import_online/models/account_journal.py:91 +#: model:ir.model,name:account_bank_statement_import_online.model_online_bank_statement_pull_wizard +#, python-format +msgid "Online Bank Statement Pull Wizard" +msgstr "" + +#. module: account_bank_statement_import_online +#: model_terms:ir.ui.view,arch_db:account_bank_statement_import_online.view_account_bank_journal_form +#: model_terms:ir.ui.view,arch_db:account_bank_statement_import_online.view_account_journal_form +msgid "Online Bank Statements (OCA)" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.actions.server,name:account_bank_statement_import_online.action_online_bank_statements_pull_wizard +msgid "Online Bank Statements Pull Wizard" +msgstr "" + +#. module: account_bank_statement_import_online +#: sql_constraint:online.bank.statement.provider:0 +msgid "Only one online banking statement provider per journal!" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__origin +msgid "Origin" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__passphrase +msgid "Passphrase" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__password +msgid "Password" +msgstr "" + +#. module: account_bank_statement_import_online +#: model_terms:ir.ui.view,arch_db:account_bank_statement_import_online.view_account_bank_journal_form +#: model_terms:ir.ui.view,arch_db:account_bank_statement_import_online.view_account_journal_form +msgid "Provider" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_pull_wizard__provider_ids +msgid "Providers" +msgstr "" + +#. module: account_bank_statement_import_online +#: model_terms:ir.ui.view,arch_db:account_bank_statement_import_online.online_bank_statement_pull_wizard_form +msgid "Pull" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.actions.server,name:account_bank_statement_import_online.ir_cron_account_pull_online_bank_statements_ir_actions_server +#: model:ir.cron,cron_name:account_bank_statement_import_online.ir_cron_account_pull_online_bank_statements +#: model:ir.cron,name:account_bank_statement_import_online.ir_cron_account_pull_online_bank_statements +msgid "Pull Online Bank Statements" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__account_number +msgid "Sanitized Account Number" +msgstr "" + +#. module: account_bank_statement_import_online +#: model_terms:ir.ui.view,arch_db:account_bank_statement_import_online.online_bank_statement_provider_form +msgid "Scheduled Pull" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__interval_number +msgid "Scheduled update interval" +msgstr "" + +#. module: account_bank_statement_import_online +#: sql_constraint:online.bank.statement.provider:0 +msgid "Scheduled update interval must be greater than zero!" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__service +msgid "Service" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_pull_wizard__date_since +msgid "Since" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__statement_creation_mode +msgid "Statement Creation Mode" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_account_journal__online_bank_statement_provider_id +msgid "Statement Provider" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,help:account_bank_statement_import_online.field_online_bank_statement_provider__currency_id +msgid "The currency used to enter statement" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__tz +msgid "Timezone" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,help:account_bank_statement_import_online.field_online_bank_statement_provider__tz +msgid "Timezone to convert transaction timestamps to prior being saved into a statement." +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__message_unread +msgid "Unread Messages" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__message_unread_counter +msgid "Unread Messages Counter" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_pull_wizard__date_until +msgid "Until" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__update_schedule +msgid "Update Schedule" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__username +msgid "Username" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,field_description:account_bank_statement_import_online.field_online_bank_statement_provider__website_message_ids +msgid "Website Messages" +msgstr "" + +#. module: account_bank_statement_import_online +#: model:ir.model.fields,help:account_bank_statement_import_online.field_online_bank_statement_provider__website_message_ids +msgid "Website communication history" +msgstr "" + +#. module: account_bank_statement_import_online +#: selection:online.bank.statement.provider,interval_type:0 +msgid "Week(s)" +msgstr "" + +#. module: account_bank_statement_import_online +#: selection:online.bank.statement.provider,statement_creation_mode:0 +msgid "Weekly statements" +msgstr "" + diff --git a/account_bank_statement_import_online/models/__init__.py b/account_bank_statement_import_online/models/__init__.py new file mode 100644 index 00000000..56bd827c --- /dev/null +++ b/account_bank_statement_import_online/models/__init__.py @@ -0,0 +1,4 @@ +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from . import account_journal +from . import online_bank_statement_provider diff --git a/account_bank_statement_import_online/models/account_journal.py b/account_bank_statement_import_online/models/account_journal.py new file mode 100644 index 00000000..d91649d4 --- /dev/null +++ b/account_bank_statement_import_online/models/account_journal.py @@ -0,0 +1,98 @@ +# Copyright 2019-2020 Brainbean Apps (https://brainbeanapps.com) +# Copyright 2019-2020 Dataplug (https://dataplug.io) +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl.html). + +import logging + +from odoo import models, fields, api, _ + +_logger = logging.getLogger(__name__) + + +class AccountJournal(models.Model): + _inherit = 'account.journal' + + bank_statements_source = fields.Selection( + selection_add=[('online', 'Online (OCA)')], + ) + online_bank_statement_provider = fields.Selection( + selection=lambda self: self.env[ + 'account.journal' + ]._selection_online_bank_statement_provider(), + ) + online_bank_statement_provider_id = fields.Many2one( + string='Statement Provider', + comodel_name='online.bank.statement.provider', + ondelete='restrict', + copy=False, + ) + + @api.model + def _selection_online_bank_statement_provider(self): + return self.env[ + 'online.bank.statement.provider' + ]._get_available_services() + [('dummy', 'Dummy')] + + @api.model + def values_online_bank_statement_provider(self): + res = self.env[ + 'online.bank.statement.provider' + ]._get_available_services() + if self.user_has_groups('base.group_no_one'): + res += [('dummy', 'Dummy')] + return res + + @api.multi + def _update_online_bank_statement_provider_id(self): + OnlineBankStatementProvider = ( + self.env['online.bank.statement.provider'] + ) + for journal in self.filtered('id'): + provider_id = journal.online_bank_statement_provider_id + if journal.bank_statements_source != 'online': + journal.online_bank_statement_provider_id = False + if provider_id: + provider_id.unlink() + continue + if provider_id.service == journal.online_bank_statement_provider: + continue + journal.online_bank_statement_provider_id = False + if provider_id: + provider_id.unlink() + journal.online_bank_statement_provider_id = ( + OnlineBankStatementProvider.create({ + 'journal_id': journal.id, + 'service': journal.online_bank_statement_provider, + }) + ) + + @api.model + def create(self, vals): + rec = super(AccountJournal, self).create(vals) + if 'bank_statements_source' in vals \ + or 'online_bank_statement_provider' in vals: + rec._update_online_bank_statement_provider_id() + return rec + + @api.multi + def write(self, vals): + res = super(AccountJournal, self).write(vals) + if 'bank_statements_source' in vals \ + or 'online_bank_statement_provider' in vals: + self._update_online_bank_statement_provider_id() + return res + + @api.multi + def action_online_bank_statements_pull_wizard(self): + provider_ids = self.mapped('online_bank_statement_provider_id').ids + return { + 'name': _('Online Bank Statement Pull Wizard'), + 'type': 'ir.actions.act_window', + 'res_model': 'online.bank.statement.pull.wizard', + 'views': [[False, 'form']], + 'target': 'new', + 'context': { + 'default_provider_ids': [(6, False, provider_ids)], + 'active_test': False, + }, + } diff --git a/account_bank_statement_import_online/models/online_bank_statement_provider.py b/account_bank_statement_import_online/models/online_bank_statement_provider.py new file mode 100644 index 00000000..9a93a6c7 --- /dev/null +++ b/account_bank_statement_import_online/models/online_bank_statement_provider.py @@ -0,0 +1,440 @@ +# Copyright 2019-2020 Brainbean Apps (https://brainbeanapps.com) +# Copyright 2019-2020 Dataplug (https://dataplug.io) +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl.html). + +from datetime import datetime +from dateutil.relativedelta import relativedelta, MO +from decimal import Decimal +from html import escape +import logging +from pytz import timezone, utc +from sys import exc_info + +from odoo import models, fields, api, _ +from odoo.addons.base.res.res_bank import sanitize_account_number +from odoo.addons.base.res.res_partner import _tz_get + +_logger = logging.getLogger(__name__) + + +class OnlineBankStatementProvider(models.Model): + _name = 'online.bank.statement.provider' + _inherit = ['mail.thread'] + _description = 'Online Bank Statement Provider' + + company_id = fields.Many2one( + related='journal_id.company_id', + readonly=True, + store=True, + ) + active = fields.Boolean() + name = fields.Char( + string='Name', + compute='_compute_name', + store=True, + ) + journal_id = fields.Many2one( + comodel_name='account.journal', + required=True, + readonly=True, + ondelete='cascade', + domain=[ + ('type', '=', 'bank'), + ], + ) + currency_id = fields.Many2one( + related='journal_id.currency_id', + readonly=True, + ) + account_number = fields.Char( + related='journal_id.bank_account_id.sanitized_acc_number', + readonly=True, + ) + tz = fields.Selection( + selection=_tz_get, + string='Timezone', + default=lambda self: self.env.context.get('tz'), + help=( + 'Timezone to convert transaction timestamps to prior being' + ' saved into a statement.' + ), + ) + service = fields.Selection( + selection=lambda self: self._selection_service(), + required=True, + readonly=True, + ) + interval_type = fields.Selection( + selection=[ + ('minutes', 'Minute(s)'), + ('hours', 'Hour(s)'), + ('days', 'Day(s)'), + ('weeks', 'Week(s)'), + ], + default='hours', + required=True, + ) + interval_number = fields.Integer( + string='Scheduled update interval', + default=1, + required=True, + ) + update_schedule = fields.Char( + string='Update Schedule', + compute='_compute_update_schedule', + ) + last_successful_run = fields.Datetime( + string='Last successful pull', + ) + next_run = fields.Datetime( + string='Next scheduled pull', + default=fields.Datetime.now, + required=True, + ) + statement_creation_mode = fields.Selection( + selection=[ + ('daily', 'Daily statements'), + ('weekly', 'Weekly statements'), + ('monthly', 'Monthly statements'), + ], + default='daily', + required=True, + ) + api_base = fields.Char() + origin = fields.Char() + username = fields.Char() + password = fields.Char() + key = fields.Binary() + certificate = fields.Binary() + passphrase = fields.Char() + certificate_public_key = fields.Text() + certificate_private_key = fields.Text() + certificate_chain = fields.Text() + + _sql_constraints = [ + ( + 'journal_id_uniq', + 'UNIQUE(journal_id)', + 'Only one online banking statement provider per journal!' + ), + ( + 'valid_interval_number', + 'CHECK(interval_number > 0)', + 'Scheduled update interval must be greater than zero!' + ) + ] + + @api.model + def _get_available_services(self): + """Hook for extension""" + return [] + + @api.model + def _selection_service(self): + return self._get_available_services() + [('dummy', 'Dummy')] + + @api.model + def values_service(self): + return self._get_available_services() + + @api.multi + @api.depends('service') + def _compute_name(self): + for provider in self: + provider.name = list(filter( + lambda x: x[0] == provider.service, + self._selection_service() + ))[0][1] + + @api.multi + @api.depends('active', 'interval_type', 'interval_number') + def _compute_update_schedule(self): + for provider in self: + if not provider.active: + provider.update_schedule = _('Inactive') + continue + + provider.update_schedule = _('%(number)s %(type)s') % { + 'number': provider.interval_number, + 'type': list(filter( + lambda x: x[0] == provider.interval_type, + self._fields['interval_type'].selection + ))[0][1], + } + + @api.multi + def _pull(self, date_since, date_until): + AccountBankStatement = self.env['account.bank.statement'] + is_scheduled = self.env.context.get('scheduled') + if is_scheduled: + AccountBankStatement = AccountBankStatement.with_context( + tracking_disable=True, + ) + AccountBankStatementLine = self.env['account.bank.statement.line'] + for provider in self: + provider_tz = timezone(provider.tz) if provider.tz else utc + statement_date_since = provider._get_statement_date_since( + date_since + ) + while statement_date_since < date_until: + statement_date_until = ( + statement_date_since + provider._get_statement_date_step() + ) + try: + data = provider._obtain_statement_data( + statement_date_since, + statement_date_until + ) + except: + if is_scheduled: + _logger.warning( + 'Online Bank Statement Provider "%s" failed to' + ' obtain statement data since %s until %s' % ( + provider.name, + statement_date_since, + statement_date_until, + ), + exc_info=True, + ) + provider.message_post( + body=_( + 'Failed to obtain statement data for period ' + 'since %s until %s: %s. See server logs for ' + 'more details.' + ) % ( + statement_date_since, + statement_date_until, + escape(str(exc_info()[1])) or _('N/A') + ), + subject=_( + 'Issue with Online Bank Statement Provider' + ), + ) + break + raise + statement_date = provider._get_statement_date( + statement_date_since, + statement_date_until, + ) + if not data: + statement_date_since = statement_date_until + continue + lines_data, statement_values = data + statement = AccountBankStatement.search([ + ('journal_id', '=', provider.journal_id.id), + ('state', '=', 'open'), + ('date', '=', fields.Date.to_string(statement_date)), + ], limit=1) + if not statement: + statement_values.update({ + 'name': provider.journal_id.sequence_id.with_context( + ir_sequence_date=fields.Date.to_string( + statement_date + ), + ).next_by_id(), + 'journal_id': provider.journal_id.id, + 'date': fields.Date.to_string(statement_date), + }) + statement = AccountBankStatement.with_context( + journal_id=provider.journal_id.id, + ).create( + # NOTE: This is needed since create() alters values + statement_values.copy() + ) + filtered_lines = [] + for line_values in lines_data: + date = line_values['date'] + if not isinstance(date, datetime): + date = fields.Datetime.from_string(date) + + if date.tzinfo is None: + date = date.replace(tzinfo=utc) + date = date.astimezone(utc).replace(tzinfo=None) + + if date < statement_date_since or date < date_since: + if 'balance_start' in statement_values: + statement_values['balance_start'] = ( + Decimal( + statement_values['balance_start'] + ) + Decimal( + line_values['amount'] + ) + ) + continue + elif date >= statement_date_until or date >= date_until: + if 'balance_end_real' in statement_values: + statement_values['balance_end_real'] = ( + Decimal( + statement_values['balance_end_real'] + ) - Decimal( + line_values['amount'] + ) + ) + continue + + date = date.replace(tzinfo=utc) + date = date.astimezone(provider_tz).replace(tzinfo=None) + line_values['date'] = fields.Datetime.to_string(date) + + unique_import_id = line_values.get('unique_import_id') + if unique_import_id: + unique_import_id = provider._generate_unique_import_id( + unique_import_id + ) + line_values.update({ + 'unique_import_id': unique_import_id, + }) + if AccountBankStatementLine.sudo().search( + [('unique_import_id', '=', unique_import_id)], + limit=1): + continue + + bank_account_number = line_values.get('account_number') + if bank_account_number: + line_values.update({ + 'account_number': ( + self._sanitize_bank_account_number( + bank_account_number + ) + ), + }) + + filtered_lines.append(line_values) + statement_values.update({ + 'line_ids': [[0, False, line] for line in filtered_lines], + }) + if 'balance_start' in statement_values: + statement_values['balance_start'] = float( + statement_values['balance_start'] + ) + if 'balance_end_real' in statement_values: + statement_values['balance_end_real'] = float( + statement_values['balance_end_real'] + ) + statement.write(statement_values) + statement_date_since = statement_date_until + if is_scheduled: + provider._schedule_next_run() + + @api.multi + def _schedule_next_run(self): + self.ensure_one() + self.last_successful_run = self.next_run + self.next_run = fields.Datetime.from_string(self.next_run) \ + + self._get_next_run_period() + + @api.multi + def _get_statement_date_since(self, date): + self.ensure_one() + date = date.replace( + hour=0, + minute=0, + second=0, + microsecond=0, + ) + if self.statement_creation_mode == 'daily': + return date + elif self.statement_creation_mode == 'weekly': + return date + relativedelta(weekday=MO(-1)) + elif self.statement_creation_mode == 'monthly': + return date.replace( + day=1, + ) + + @api.multi + def _get_statement_date_step(self): + self.ensure_one() + if self.statement_creation_mode == 'daily': + return relativedelta( + days=1, + hour=0, + minute=0, + second=0, + microsecond=0, + ) + elif self.statement_creation_mode == 'weekly': + return relativedelta( + weeks=1, + weekday=MO, + hour=0, + minute=0, + second=0, + microsecond=0, + ) + elif self.statement_creation_mode == 'monthly': + return relativedelta( + months=1, + day=1, + hour=0, + minute=0, + second=0, + microsecond=0, + ) + + @api.multi + def _get_statement_date(self, date_since, date_until): + self.ensure_one() + # NOTE: Statement date is treated by Odoo as start of period. Details + # - addons/account/models/account_journal_dashboard.py + # - def get_line_graph_datas() + tz = timezone(self.tz) if self.tz else utc + date_since = date_since.replace(tzinfo=utc).astimezone(tz) + return date_since.date() + + @api.multi + def _generate_unique_import_id(self, unique_import_id): + self.ensure_one() + return ( + self.account_number and self.account_number + '-' or '' + ) + str(self.journal_id.id) + '-' + unique_import_id + + @api.multi + def _sanitize_bank_account_number(self, bank_account_number): + """Hook for extension""" + self.ensure_one() + return sanitize_account_number(bank_account_number) + + @api.multi + def _get_next_run_period(self): + self.ensure_one() + if self.interval_type == 'minutes': + return relativedelta(minutes=self.interval_number) + elif self.interval_type == 'hours': + return relativedelta(hours=self.interval_number) + elif self.interval_type == 'days': + return relativedelta(days=self.interval_number) + elif self.interval_type == 'weeks': + return relativedelta(weeks=self.interval_number) + + @api.model + def _scheduled_pull(self): + _logger.info('Scheduled pull of online bank statements...') + + providers = self.search([ + ('active', '=', True), + ('next_run', '<=', fields.Datetime.now()), + ]) + if providers: + _logger.info('Pulling online bank statements of: %s' % ', '.join( + providers.mapped('journal_id.name') + )) + for provider in providers.with_context({'scheduled': True}): + next_run = fields.Datetime.from_string(provider.next_run) + date_since = fields.Datetime.from_string( + provider.last_successful_run + ) if provider.last_successful_run else ( + next_run - provider._get_next_run_period() + ) + date_until = next_run + provider._pull(date_since, date_until) + + _logger.info('Scheduled pull of online bank statements complete.') + + @api.multi + def _obtain_statement_data( + self, date_since, date_until + ): + """Hook for extension""" + # Check tests/online_bank_statement_provider_dummy.py for reference + self.ensure_one() + return [] diff --git a/account_bank_statement_import_online/readme/CONFIGURE.rst b/account_bank_statement_import_online/readme/CONFIGURE.rst new file mode 100644 index 00000000..d2ae6f21 --- /dev/null +++ b/account_bank_statement_import_online/readme/CONFIGURE.rst @@ -0,0 +1,23 @@ +To configure online bank statements provider: + +#. Go to *Invoicing > Configuration > Bank Accounts* +#. Open bank account to configure and edit it +#. Set *Bank Feeds* to *Online* +#. Select online bank statements provider in *Online Bank Statements (OCA)* + section +#. Save the bank account +#. Click on provider and configure provider-specific settings. + +or, alternatively: + +#. Go to *Invoicing > Overview* +#. Open settings of the corresponding journal account +#. Switch to *Bank Account* tab +#. Set *Bank Feeds* to *Online* +#. Select online bank statements provider in *Online Bank Statements (OCA)* + section +#. Save the bank account +#. Click on provider and configure provider-specific settings. + +**NOTE**: To access these features, user needs to belong to +*Show Full Accounting Features* group. diff --git a/account_bank_statement_import_online/readme/CONTRIBUTORS.rst b/account_bank_statement_import_online/readme/CONTRIBUTORS.rst new file mode 100644 index 00000000..1c6a35a1 --- /dev/null +++ b/account_bank_statement_import_online/readme/CONTRIBUTORS.rst @@ -0,0 +1 @@ +* Alexey Pelykh diff --git a/account_bank_statement_import_online/readme/DESCRIPTION.rst b/account_bank_statement_import_online/readme/DESCRIPTION.rst new file mode 100644 index 00000000..cc0aaaf4 --- /dev/null +++ b/account_bank_statement_import_online/readme/DESCRIPTION.rst @@ -0,0 +1 @@ +This module provides base for building online bank statements providers. diff --git a/account_bank_statement_import_online/readme/USAGE.rst b/account_bank_statement_import_online/readme/USAGE.rst new file mode 100644 index 00000000..bbc2fcef --- /dev/null +++ b/account_bank_statement_import_online/readme/USAGE.rst @@ -0,0 +1,9 @@ +To pull historical bank statements: + +#. Go to *Invoicing > Configuration > Bank Accounts* +#. Select specific bank accounts +#. Launch *Actions > Online Bank Statements Pull Wizard* +#. Configure date interval and click *Pull* + +**NOTE**: To access these features, user needs to belong to +*Show Full Accounting Features* group. diff --git a/account_bank_statement_import_online/security/ir.model.access.csv b/account_bank_statement_import_online/security/ir.model.access.csv new file mode 100644 index 00000000..4e04821b --- /dev/null +++ b/account_bank_statement_import_online/security/ir.model.access.csv @@ -0,0 +1,3 @@ +id,name,model_id:id,group_id:id,perm_read,perm_write,perm_create,perm_unlink +access_online_bank_statement_provider_admin,online.bank.statement.provider:base.group_system,model_online_bank_statement_provider,base.group_system,1,1,1,1 +access_online_bank_statement_provider_user,online.bank.statement.provider:account.group_account_user,model_online_bank_statement_provider,account.group_account_user,1,1,1,1 diff --git a/account_bank_statement_import_online/security/online_bank_statement_provider.xml b/account_bank_statement_import_online/security/online_bank_statement_provider.xml new file mode 100644 index 00000000..521e7e97 --- /dev/null +++ b/account_bank_statement_import_online/security/online_bank_statement_provider.xml @@ -0,0 +1,16 @@ + + + + + + Online Bank Statement Provider multi-company + + + ['|', ('company_id', '=', False), ('company_id', 'child_of', [user.company_id.id])] + + + diff --git a/account_bank_statement_import_online/static/description/icon.png b/account_bank_statement_import_online/static/description/icon.png new file mode 100644 index 00000000..3a0328b5 Binary files /dev/null and b/account_bank_statement_import_online/static/description/icon.png differ diff --git a/account_bank_statement_import_online/static/description/index.html b/account_bank_statement_import_online/static/description/index.html new file mode 100644 index 00000000..70ef39aa --- /dev/null +++ b/account_bank_statement_import_online/static/description/index.html @@ -0,0 +1,462 @@ + + + + + + +Online Bank Statements + + + +
+

Online Bank Statements

+ + +

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

+

This module provides base for building online bank statements providers.

+

Table of contents

+ +
+

Configuration

+

To configure online bank statements provider:

+
    +
  1. Go to Invoicing > Configuration > Bank Accounts
    2. +
  2. Open bank account to configure and edit it
    3. +
  3. Set Bank Feeds to Online
    4. +
  4. Select online bank statements provider in Online Bank Statements (OCA) +section
    5. +
  5. Save the bank account
    6. +
  6. Click on provider and configure provider-specific settings.
    7. +
+

or, alternatively:

+
    +
  1. Go to Invoicing > Overview
    2. +
  2. Open settings of the corresponding journal account
    3. +
  3. Switch to Bank Account tab
    4. +
  4. Set Bank Feeds to Online
    5. +
  5. Select online bank statements provider in Online Bank Statements (OCA) +section
    6. +
  6. Save the bank account
    7. +
  7. Click on provider and configure provider-specific settings.
    8. +
+

NOTE: To access these features, user needs to belong to +Show Full Accounting Features group.

+
+
+

Usage

+

To pull historical bank statements:

+
    +
  1. Go to Invoicing > Configuration > Bank Accounts
    2. +
  2. Select specific bank accounts
    3. +
  3. Launch Actions > Online Bank Statements Pull Wizard
    4. +
  4. Configure date interval and click Pull
    5. +
+

NOTE: To access these features, user needs to belong to +Show Full Accounting Features group.

+
+
+

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

+
    +
  • Brainbean Apps
    • +
  • Dataplug
    • +
+
+ +
+

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.

+

Current maintainer:

+

alexey-pelykh

+

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_online/tests/__init__.py b/account_bank_statement_import_online/tests/__init__.py new file mode 100644 index 00000000..c631b1f0 --- /dev/null +++ b/account_bank_statement_import_online/tests/__init__.py @@ -0,0 +1,3 @@ +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from . import test_account_bank_statement_import_online diff --git a/account_bank_statement_import_online/tests/online_bank_statement_provider_dummy.py b/account_bank_statement_import_online/tests/online_bank_statement_provider_dummy.py new file mode 100644 index 00000000..34f84d46 --- /dev/null +++ b/account_bank_statement_import_online/tests/online_bank_statement_provider_dummy.py @@ -0,0 +1,86 @@ +# Copyright 2019-2020 Brainbean Apps (https://brainbeanapps.com) +# Copyright 2019-2020 Dataplug (https://dataplug.io) +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl.html). + +from datetime import datetime, timedelta +from dateutil.relativedelta import relativedelta +from pytz import timezone +from random import randrange + +from odoo import api, fields, models + + +class OnlineBankStatementProviderDummy(models.Model): + _inherit = 'online.bank.statement.provider' + + @api.multi + def _obtain_statement_data(self, date_since, date_until): + self.ensure_one() + if self.service != 'dummy': + return super(OnlineBankStatementProviderDummy, self) \ + ._obtain_statement_data( + date_since, + date_until, + ) # pragma: no cover + + if self.env.context.get('crash', False): + exception = self.env.context.get( + 'exception', + Exception('Expected') + ) + raise exception + + line_step_options = self.env.context.get('step', { + 'minutes': 5, + }) + line_step = relativedelta(**line_step_options) + expand_by = self.env.context.get('expand_by', 0) + data_since = self.env.context.get('data_since', date_since) + data_until = self.env.context.get('data_until', date_until) + data_since -= expand_by * line_step + data_until += expand_by * line_step + + balance_start = self.env.context.get( + 'balance_start', + randrange(-10000, 10000, 1) * 0.1 + ) + balance = balance_start + + tz = self.env.context.get('tz') + if tz: + tz = timezone(tz) + + timestamp_mode = self.env.context.get('timestamp_mode') + + lines = [] + date = data_since + while date < data_until: + amount = self.env.context.get( + 'amount', + randrange(-100, 100, 1) * 0.1 + ) + transaction_date = date.replace(tzinfo=tz) + if timestamp_mode == 'date': + transaction_date = transaction_date.date() + elif timestamp_mode == 'str': + transaction_date = fields.Datetime.to_string(transaction_date) + lines.append({ + 'name': 'payment', + 'amount': amount, + 'date': transaction_date, + 'unique_import_id': str(int( + (date - datetime(1970, 1, 1)) / timedelta(seconds=1) + )), + 'partner_name': 'John Doe', + 'account_number': 'XX00 0000 0000 0000', + }) + balance += amount + date += line_step + balance_end = balance + statement = {} + if self.env.context.get('balance', True): + statement.update({ + 'balance_start': balance_start, + 'balance_end_real': balance_end, + }) + return lines, statement diff --git a/account_bank_statement_import_online/tests/test_account_bank_statement_import_online.py b/account_bank_statement_import_online/tests/test_account_bank_statement_import_online.py new file mode 100644 index 00000000..048da677 --- /dev/null +++ b/account_bank_statement_import_online/tests/test_account_bank_statement_import_online.py @@ -0,0 +1,637 @@ +# Copyright 2019-2020 Brainbean Apps (https://brainbeanapps.com) +# Copyright 2019-2020 Dataplug (https://dataplug.io) +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from datetime import datetime +from dateutil.relativedelta import relativedelta +from psycopg2 import IntegrityError +from urllib.error import HTTPError + +from odoo.tests import common +from odoo.tools import mute_logger +from odoo import fields + + +class TestAccountBankAccountStatementImportOnline(common.TransactionCase): + + def setUp(self): + super(TestAccountBankAccountStatementImportOnline, self).setUp() + + self.now = fields.Datetime.from_string(fields.Datetime.now()) + self.AccountJournal = self.env['account.journal'] + self.OnlineBankStatementProvider = self.env[ + 'online.bank.statement.provider' + ] + self.OnlineBankStatementPullWizard = self.env[ + 'online.bank.statement.pull.wizard' + ] + self.AccountBankStatement = self.env['account.bank.statement'] + self.AccountBankStatementLine = self.env['account.bank.statement.line'] + + def test_provider_unlink_restricted(self): + journal = self.AccountJournal.create({ + 'name': 'Bank', + 'type': 'bank', + 'code': 'BANK', + }) + journal.bank_statements_source = 'online' + journal.online_bank_statement_provider = 'dummy' + + with self.assertRaises(IntegrityError), mute_logger('odoo.sql_db'): + journal.online_bank_statement_provider_id.unlink() + + def test_cascade_unlink(self): + journal = self.AccountJournal.create({ + 'name': 'Bank', + 'type': 'bank', + 'code': 'BANK', + }) + journal.bank_statements_source = 'online' + journal.online_bank_statement_provider = 'dummy' + + self.assertTrue(journal.online_bank_statement_provider_id) + journal.unlink() + self.assertFalse(self.OnlineBankStatementProvider.search([])) + + def test_source_change_cleanup(self): + journal = self.AccountJournal.create({ + 'name': 'Bank', + 'type': 'bank', + 'code': 'BANK', + }) + journal.bank_statements_source = 'online' + journal.online_bank_statement_provider = 'dummy' + + self.assertTrue(journal.online_bank_statement_provider_id) + + journal.bank_statements_source = 'undefined' + + self.assertFalse(journal.online_bank_statement_provider_id) + self.assertFalse(self.OnlineBankStatementProvider.search([])) + + def test_pull_boundary(self): + journal = self.AccountJournal.create({ + 'name': 'Bank', + 'type': 'bank', + 'code': 'BANK', + 'bank_statements_source': 'online', + 'online_bank_statement_provider': 'dummy', + }) + + provider = journal.online_bank_statement_provider_id + provider.active = True + provider.with_context( + expand_by=1, + )._pull( + self.now - relativedelta(hours=1), + self.now, + ) + + statement = self.AccountBankStatement.search( + [('journal_id', '=', journal.id)], + ) + self.assertEqual(len(statement), 1) + self.assertEqual(len(statement.line_ids), 12) + + def test_pull_mode_daily(self): + journal = self.AccountJournal.create({ + 'name': 'Bank', + 'type': 'bank', + 'code': 'BANK', + 'bank_statements_source': 'online', + 'online_bank_statement_provider': 'dummy', + }) + + provider = journal.online_bank_statement_provider_id + provider.active = True + provider.statement_creation_mode = 'daily' + + provider.with_context(step={'hours': 2})._pull( + self.now - relativedelta(days=1), + self.now, + ) + self.assertEqual( + len(self.AccountBankStatement.search( + [('journal_id', '=', journal.id)] + )), + 2 + ) + + def test_pull_mode_weekly(self): + journal = self.AccountJournal.create({ + 'name': 'Bank', + 'type': 'bank', + 'code': 'BANK', + 'bank_statements_source': 'online', + 'online_bank_statement_provider': 'dummy', + }) + + provider = journal.online_bank_statement_provider_id + provider.active = True + provider.statement_creation_mode = 'weekly' + + provider.with_context(step={'hours': 8})._pull( + self.now - relativedelta(weeks=1), + self.now, + ) + self.assertEqual( + len(self.AccountBankStatement.search( + [('journal_id', '=', journal.id)] + )), + 2 + ) + + def test_pull_mode_monthly(self): + journal = self.AccountJournal.create({ + 'name': 'Bank', + 'type': 'bank', + 'code': 'BANK', + 'bank_statements_source': 'online', + 'online_bank_statement_provider': 'dummy', + }) + + provider = journal.online_bank_statement_provider_id + provider.active = True + provider.statement_creation_mode = 'monthly' + + provider.with_context(step={'hours': 8})._pull( + self.now - relativedelta(months=1), + self.now, + ) + self.assertEqual( + len(self.AccountBankStatement.search( + [('journal_id', '=', journal.id)] + )), + 2 + ) + + def test_pull_scheduled(self): + journal = self.AccountJournal.create({ + 'name': 'Bank', + 'type': 'bank', + 'code': 'BANK', + 'bank_statements_source': 'online', + 'online_bank_statement_provider': 'dummy', + }) + + provider = journal.online_bank_statement_provider_id + provider.active = True + provider.next_run = ( + self.now - relativedelta(days=15) + ) + + self.assertFalse(self.AccountBankStatement.search( + [('journal_id', '=', journal.id)], + )) + + provider.with_context(step={'hours': 8})._scheduled_pull() + + statement = self.AccountBankStatement.search( + [('journal_id', '=', journal.id)], + ) + self.assertEqual(len(statement), 1) + + def test_pull_skip_duplicates_by_unique_import_id(self): + journal = self.AccountJournal.create({ + 'name': 'Bank', + 'type': 'bank', + 'code': 'BANK', + 'bank_statements_source': 'online', + 'online_bank_statement_provider': 'dummy', + }) + + provider = journal.online_bank_statement_provider_id + provider.active = True + provider.statement_creation_mode = 'weekly' + + provider.with_context(step={'hours': 8})._pull( + self.now - relativedelta(weeks=2), + self.now, + ) + self.assertEqual( + len(self.AccountBankStatementLine.search( + [('journal_id', '=', journal.id)] + )), + 14 * (24 / 8) + ) + + provider.with_context(step={'hours': 8})._pull( + self.now - relativedelta(weeks=3), + self.now - relativedelta(weeks=1), + ) + self.assertEqual( + len(self.AccountBankStatementLine.search( + [('journal_id', '=', journal.id)] + )), + 21 * (24 / 8) + ) + + provider.with_context(step={'hours': 8})._pull( + self.now - relativedelta(weeks=1), + self.now, + ) + self.assertEqual( + len(self.AccountBankStatementLine.search( + [('journal_id', '=', journal.id)] + )), + 21 * (24 / 8) + ) + + def test_interval_type_minutes(self): + journal = self.AccountJournal.create({ + 'name': 'Bank', + 'type': 'bank', + 'code': 'BANK', + 'bank_statements_source': 'online', + 'online_bank_statement_provider': 'dummy', + }) + + provider = journal.online_bank_statement_provider_id + provider.active = True + provider.interval_type = 'minutes' + provider._compute_update_schedule() + + def test_interval_type_hours(self): + journal = self.AccountJournal.create({ + 'name': 'Bank', + 'type': 'bank', + 'code': 'BANK', + 'bank_statements_source': 'online', + 'online_bank_statement_provider': 'dummy', + }) + + provider = journal.online_bank_statement_provider_id + provider.active = True + provider.interval_type = 'hours' + provider._compute_update_schedule() + + def test_interval_type_days(self): + journal = self.AccountJournal.create({ + 'name': 'Bank', + 'type': 'bank', + 'code': 'BANK', + 'bank_statements_source': 'online', + 'online_bank_statement_provider': 'dummy', + }) + + provider = journal.online_bank_statement_provider_id + provider.active = True + provider.interval_type = 'days' + provider._compute_update_schedule() + + def test_interval_type_weeks(self): + journal = self.AccountJournal.create({ + 'name': 'Bank', + 'type': 'bank', + 'code': 'BANK', + 'bank_statements_source': 'online', + 'online_bank_statement_provider': 'dummy', + }) + + provider = journal.online_bank_statement_provider_id + provider.active = True + provider.interval_type = 'weeks' + provider._compute_update_schedule() + + def test_pull_no_crash(self): + journal = self.AccountJournal.create({ + 'name': 'Bank', + 'type': 'bank', + 'code': 'BANK', + 'bank_statements_source': 'online', + 'online_bank_statement_provider': 'dummy', + }) + + provider = journal.online_bank_statement_provider_id + provider.active = True + provider.statement_creation_mode = 'weekly' + + provider.with_context( + crash=True, + scheduled=True, + )._pull( + self.now - relativedelta(hours=1), + self.now, + ) + self.assertFalse(self.AccountBankStatement.search( + [('journal_id', '=', journal.id)], + )) + + def test_pull_crash(self): + journal = self.AccountJournal.create({ + 'name': 'Bank', + 'type': 'bank', + 'code': 'BANK', + 'bank_statements_source': 'online', + 'online_bank_statement_provider': 'dummy', + }) + + provider = journal.online_bank_statement_provider_id + provider.active = True + provider.statement_creation_mode = 'weekly' + + with self.assertRaises(Exception): + provider.with_context( + crash=True, + )._pull( + self.now - relativedelta(hours=1), + self.now, + ) + + def test_pull_httperror(self): + journal = self.AccountJournal.create({ + 'name': 'Bank', + 'type': 'bank', + 'code': 'BANK', + 'bank_statements_source': 'online', + 'online_bank_statement_provider': 'dummy', + }) + + provider = journal.online_bank_statement_provider_id + provider.active = True + provider.statement_creation_mode = 'weekly' + + with self.assertRaises(HTTPError): + provider.with_context( + crash=True, + exception=HTTPError(None, 500, 'Error', None, None), + )._pull( + self.now - relativedelta(hours=1), + self.now, + ) + + def test_pull_no_balance(self): + journal = self.AccountJournal.create({ + 'name': 'Bank', + 'type': 'bank', + 'code': 'BANK', + 'bank_statements_source': 'online', + 'online_bank_statement_provider': 'dummy', + }) + + provider = journal.online_bank_statement_provider_id + provider.active = True + provider.statement_creation_mode = 'daily' + + provider.with_context( + step={'hours': 2}, + balance_start=0, + amount=100.0, + balance=False, + )._pull( + self.now - relativedelta(days=1), + self.now, + ) + statements = self.AccountBankStatement.search( + [('journal_id', '=', journal.id)], + order='date asc', + ) + self.assertFalse(statements[0].balance_start) + self.assertFalse(statements[0].balance_end_real) + self.assertTrue(statements[0].balance_end) + self.assertTrue(statements[1].balance_start) + self.assertFalse(statements[1].balance_end_real) + + def test_wizard(self): + journal = self.AccountJournal.create({ + 'name': 'Bank', + 'type': 'bank', + 'code': 'BANK', + 'bank_statements_source': 'online', + 'online_bank_statement_provider': 'dummy', + }) + action = journal.action_online_bank_statements_pull_wizard() + self.assertTrue(action['context']['default_provider_ids'][0][2]) + + wizard = self.OnlineBankStatementPullWizard.with_context( + action['context'] + ).create({ + 'date_since': self.now - relativedelta(hours=1), + 'date_until': self.now, + }) + self.assertTrue(wizard.provider_ids) + + wizard.action_pull() + self.assertTrue(self.AccountBankStatement.search( + [('journal_id', '=', journal.id)], + )) + + def test_pull_statement_partially(self): + journal = self.AccountJournal.create({ + 'name': 'Bank', + 'type': 'bank', + 'code': 'BANK', + 'bank_statements_source': 'online', + 'online_bank_statement_provider': 'dummy', + }) + + provider = journal.online_bank_statement_provider_id + provider.active = True + provider.statement_creation_mode = 'monthly' + + provider_context = { + 'step': {'hours': 24}, + 'data_since': datetime(2020, 1, 1), + 'data_until': datetime(2020, 2, 29), + 'amount': 1.0, + 'balance_start': 0, + } + + provider.with_context(**provider_context)._pull( + datetime(2020, 1, 1), + datetime(2020, 1, 31), + ) + statements = self.AccountBankStatement.search( + [('journal_id', '=', journal.id)], + order='date asc', + ) + self.assertEqual(len(statements), 1) + self.assertEqual(statements[0].balance_start, 0.0) + self.assertEqual(statements[0].balance_end_real, 30.0) + + provider.with_context(**provider_context)._pull( + datetime(2020, 1, 1), + datetime(2020, 2, 15), + ) + statements = self.AccountBankStatement.search( + [('journal_id', '=', journal.id)], + order='date asc', + ) + self.assertEqual(len(statements), 2) + self.assertEqual(statements[0].balance_start, 0.0) + self.assertEqual(statements[0].balance_end_real, 31.0) + self.assertEqual(statements[1].balance_start, 31.0) + self.assertEqual(statements[1].balance_end_real, 45.0) + + provider.with_context(**provider_context)._pull( + datetime(2020, 1, 1), + datetime(2020, 2, 29), + ) + statements = self.AccountBankStatement.search( + [('journal_id', '=', journal.id)], + order='date asc', + ) + self.assertEqual(len(statements), 2) + self.assertEqual(statements[0].balance_start, 0.0) + self.assertEqual(statements[0].balance_end_real, 31.0) + self.assertEqual(statements[1].balance_start, 31.0) + self.assertEqual(statements[1].balance_end_real, 59.0) + + def test_tz_utc(self): + journal = self.AccountJournal.create({ + 'name': 'Bank', + 'type': 'bank', + 'code': 'BANK', + 'bank_statements_source': 'online', + 'online_bank_statement_provider': 'dummy', + }) + + provider = journal.online_bank_statement_provider_id + provider.active = True + provider.tz = 'UTC' + provider.with_context( + step={'hours': 1}, + tz='UTC', + )._pull( + datetime(2020, 4, 17, 22, 0), + datetime(2020, 4, 18, 2, 0), + ) + + statement = self.AccountBankStatement.search( + [('journal_id', '=', journal.id)], + ) + self.assertEqual(len(statement), 2) + + lines = statement.mapped('line_ids').sorted() + self.assertEqual(len(lines), 4) + self.assertEqual(lines[0].date, '2020-04-17') + self.assertEqual(lines[1].date, '2020-04-17') + self.assertEqual(lines[2].date, '2020-04-18') + self.assertEqual(lines[3].date, '2020-04-18') + + def test_tz_non_utc(self): + journal = self.AccountJournal.create({ + 'name': 'Bank', + 'type': 'bank', + 'code': 'BANK', + 'bank_statements_source': 'online', + 'online_bank_statement_provider': 'dummy', + }) + + provider = journal.online_bank_statement_provider_id + provider.active = True + provider.tz = 'Etc/GMT-2' + provider.with_context( + step={'hours': 1}, + tz='UTC', + )._pull( + datetime(2020, 4, 17, 22, 0), + datetime(2020, 4, 18, 2, 0), + ) + + statement = self.AccountBankStatement.search( + [('journal_id', '=', journal.id)], + ) + self.assertEqual(len(statement), 2) + + lines = statement.mapped('line_ids').sorted() + self.assertEqual(len(lines), 4) + self.assertEqual(lines[0].date, '2020-04-18') + self.assertEqual(lines[1].date, '2020-04-18') + self.assertEqual(lines[2].date, '2020-04-18') + self.assertEqual(lines[3].date, '2020-04-18') + + def test_other_tz_to_utc(self): + journal = self.AccountJournal.create({ + 'name': 'Bank', + 'type': 'bank', + 'code': 'BANK', + 'bank_statements_source': 'online', + 'online_bank_statement_provider': 'dummy', + }) + + provider = journal.online_bank_statement_provider_id + provider.active = True + provider.with_context( + step={'hours': 1}, + tz='Etc/GMT-2', + data_since=datetime(2020, 4, 18, 0, 0), + data_until=datetime(2020, 4, 18, 4, 0), + )._pull( + datetime(2020, 4, 17, 22, 0), + datetime(2020, 4, 18, 2, 0), + ) + + statement = self.AccountBankStatement.search( + [('journal_id', '=', journal.id)], + ) + self.assertEqual(len(statement), 2) + + lines = statement.mapped('line_ids').sorted() + self.assertEqual(len(lines), 4) + self.assertEqual(lines[0].date, '2020-04-17') + self.assertEqual(lines[1].date, '2020-04-17') + self.assertEqual(lines[2].date, '2020-04-18') + self.assertEqual(lines[3].date, '2020-04-18') + + def test_timestamp_date_only(self): + journal = self.AccountJournal.create({ + 'name': 'Bank', + 'type': 'bank', + 'code': 'BANK', + 'bank_statements_source': 'online', + 'online_bank_statement_provider': 'dummy', + }) + + provider = journal.online_bank_statement_provider_id + provider.active = True + provider.with_context( + step={'hours': 1}, + timestamp_mode='date', + )._pull( + datetime(2020, 4, 18, 0, 0), + datetime(2020, 4, 18, 4, 0), + ) + + statement = self.AccountBankStatement.search( + [('journal_id', '=', journal.id)], + ) + self.assertEqual(len(statement), 1) + + lines = statement.line_ids + self.assertEqual(len(lines), 4) + self.assertEqual(lines[0].date, '2020-04-18') + self.assertEqual(lines[1].date, '2020-04-18') + self.assertEqual(lines[2].date, '2020-04-18') + self.assertEqual(lines[3].date, '2020-04-18') + + def test_timestamp_date_only(self): + journal = self.AccountJournal.create({ + 'name': 'Bank', + 'type': 'bank', + 'code': 'BANK', + 'bank_statements_source': 'online', + 'online_bank_statement_provider': 'dummy', + }) + + provider = journal.online_bank_statement_provider_id + provider.active = True + provider.with_context( + step={'hours': 1}, + timestamp_mode='str', + )._pull( + datetime(2020, 4, 18, 0, 0), + datetime(2020, 4, 18, 4, 0), + ) + + statement = self.AccountBankStatement.search( + [('journal_id', '=', journal.id)], + ) + self.assertEqual(len(statement), 1) + + lines = statement.line_ids + self.assertEqual(len(lines), 4) + self.assertEqual(lines[0].date, '2020-04-18') + self.assertEqual(lines[1].date, '2020-04-18') + self.assertEqual(lines[2].date, '2020-04-18') + self.assertEqual(lines[3].date, '2020-04-18') diff --git a/account_bank_statement_import_online/views/account_journal.xml b/account_bank_statement_import_online/views/account_journal.xml new file mode 100644 index 00000000..554c6466 --- /dev/null +++ b/account_bank_statement_import_online/views/account_journal.xml @@ -0,0 +1,125 @@ + + + + + + account.journal.form + account.journal + + + + + + + + + + + account.journal.form + account.journal + + + + + + + + + + + account.journal.dashboard.kanban + account.journal + + + + dashboard.bank_statements_source == 'file_import' + + + dashboard.bank_statements_source == 'file_import' + + + + + + Online Bank Statements Pull Wizard + ir.actions.server + + + code + + if records: + action = records.action_online_bank_statements_pull_wizard() + + + + diff --git a/account_bank_statement_import_online/views/online_bank_statement_provider.xml b/account_bank_statement_import_online/views/online_bank_statement_provider.xml new file mode 100644 index 00000000..5fb927e7 --- /dev/null +++ b/account_bank_statement_import_online/views/online_bank_statement_provider.xml @@ -0,0 +1,97 @@ + + + + + + online.bank.statement.provider.filter + online.bank.statement.provider + + + + + + + + + online.bank.statement.provider.tree + online.bank.statement.provider + + + + + + + + + + + + + + online.bank.statement.provider.form + online.bank.statement.provider + +
+ +
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+
+ + + + diff --git a/account_bank_statement_import_online/wizards/__init__.py b/account_bank_statement_import_online/wizards/__init__.py new file mode 100644 index 00000000..a8ac6626 --- /dev/null +++ b/account_bank_statement_import_online/wizards/__init__.py @@ -0,0 +1,3 @@ +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from . import online_bank_statement_pull_wizard diff --git a/account_bank_statement_import_online/wizards/online_bank_statement_pull_wizard.py b/account_bank_statement_import_online/wizards/online_bank_statement_pull_wizard.py new file mode 100644 index 00000000..b4984c3f --- /dev/null +++ b/account_bank_statement_import_online/wizards/online_bank_statement_pull_wizard.py @@ -0,0 +1,39 @@ +# Copyright 2019-2020 Brainbean Apps (https://brainbeanapps.com) +# Copyright 2019-2020 Dataplug (https://dataplug.io) +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from odoo import fields, models, api + + +class OnlineBankStatementPullWizard(models.TransientModel): + _name = 'online.bank.statement.pull.wizard' + _description = 'Online Bank Statement Pull Wizard' + + date_since = fields.Datetime( + string='Since', + required=True, + default=fields.Datetime.now, + ) + date_until = fields.Datetime( + string='Until', + required=True, + default=fields.Datetime.now, + ) + provider_ids = fields.Many2many( + string='Providers', + comodel_name='online.bank.statement.provider', + column1='wizard_id', + column2='provider_id', + relation='online_bank_statement_provider_pull_wizard_rel', + ) + + @api.multi + def action_pull(self): + self.ensure_one() + self.with_context( + active_test=False, + ).provider_ids._pull( + fields.Datetime.from_string(self.date_since), + fields.Datetime.from_string(self.date_until) + ) + return {'type': 'ir.actions.act_window_close'} diff --git a/account_bank_statement_import_online/wizards/online_bank_statement_pull_wizard.xml b/account_bank_statement_import_online/wizards/online_bank_statement_pull_wizard.xml new file mode 100644 index 00000000..665c67d2 --- /dev/null +++ b/account_bank_statement_import_online/wizards/online_bank_statement_pull_wizard.xml @@ -0,0 +1,33 @@ + + + + + + online.bank.statement.pull.wizard.form + online.bank.statement.pull.wizard + +
+ + + + + + + + + + + + + +
+ + +