[ADD] account_bank_statement_import_online_ofx

This commit is contained in:
JasminSForgeFlow
2023-01-24 14:31:22 +05:30
committed by Christopher Ormaza
parent 98714834ef
commit f4449016e9
12 changed files with 399 additions and 0 deletions

View File

@@ -0,0 +1,110 @@
==================================
Online Bank Statements: OFX
==================================
.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! 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/14.0/account_statement_import_online_paypal
: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-14-0/bank-statement-import-14-0-account_statement_import_online_paypal
: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/14.0
:alt: Try me on Runbot
|badge1| |badge2| |badge3| |badge4| |badge5|
This module provides online bank statements from OFX instutitons
**Table of contents**
.. contents::
:local:
Configuration
=============
To configure online bank statements provider:
#. Go to *Invoicing > Configuration > Journals*
#. Open bank journal to configure and edit it
#. Set *Bank Feeds* to *Online*
#. Select *OFX* as online bank statements provider in
*Online Bank Statements (OCA)* section
#. Save the bank journal
#. Click on provider and configure provider-specific settings.
Usage
=====
To pull historical bank statements:
#. Go to *Invoicing > Configuration > Journals*
#. Select specific bank accounts
#. Launch *Actions > Online Bank Statements Pull Wizard*
#. Configure date interval and click *Pull*
Known issues / Roadmap
======================
Bug Tracker
===========
Bugs are tracked on `GitHub Issues <https://github.com/OCA/bank-statement-import/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/bank-statement-import/issues/new?body=module:%20account_statement_import_online_paypal%0Aversion:%2014.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
~~~~~~~
* ForgeFlow
Contributors
~~~~~~~~~~~~
* `ForgeFlow <https://www.forgeflow.com/>`__
* Jasmin Solanki <jasmin.solanki@forgeflow.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-alexey-pelykh| image:: https://github.com/alexey-pelykh.png?size=40px
:target: https://github.com/alexey-pelykh
:alt: alexey-pelykh
Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:
|maintainer-alexey-pelykh|
This module is part of the `OCA/bank-statement-import <https://github.com/OCA/bank-statement-import/tree/14.0/account_statement_import_online_paypal>`_ project on GitHub.
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

View File

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

View File

@@ -0,0 +1,20 @@
# Copyright 2023 ForgeFlow S.L.
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl.html).
{
"name": "Online Bank Statements: OFX",
"version": "14.0.1.0.0",
"author": "ForgeFlow, Odoo Community Association (OCA)",
"website": "https://github.com/OCA/bank-statement-import",
"license": "AGPL-3",
"category": "Accounting",
"summary": "Online bank statements for OFX",
"depends": ["account_statement_import_online"],
"external_dependencies": {"python": ["ofxtools", "ofxparse"]},
"data": [
"security/ir.model.access.csv",
"views/online_bank_statement_provider.xml",
"wizards/online_bank_statement_pull_wizard.xml",
],
"installable": True,
}

View File

@@ -0,0 +1,4 @@
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
from . import ofx_institution
from . import online_bank_statement_provider_ofx

View File

@@ -0,0 +1,14 @@
# Copyright 2023 ForgeFlow S.L.
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl.html).
from odoo import fields, models
class OFXInstitution(models.Model):
_name = "ofx.institution"
_description = "OFX Institution"
name = fields.Char()
nickname = fields.Char()
ofxhome_id = fields.Integer()

View File

@@ -0,0 +1,140 @@
# Copyright 2023 ForgeFlow S.L.
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl.html).
import io
import time
from datetime import datetime
from ofxparse import OfxParser
from ofxtools import ofxhome, utils
from ofxtools.Client import OFXClient, StmtRq
from odoo import _, api, fields, models
from odoo.exceptions import UserError
class OnlineBankStatementProviderOFX(models.Model):
_inherit = "online.bank.statement.provider"
ofx_institution_line_ids = fields.One2many("ofx.institution.line", "provider_id")
@api.model
def _get_available_services(self):
return super()._get_available_services() + [
("OFX", "OFX"),
]
def get_statements(self, client, password, s1, try_no=1):
statements = client.request_statements(password, s1, skip_profile=True)
file_data = statements.read()
if b"Request unsuccessful. Incapsula incident ID" in file_data and try_no <= 3:
time.sleep(3)
return self.get_statements(client, password, s1, try_no + 1)
ofx = OfxParser.parse(io.BytesIO(file_data))
if ofx.status.get("code") != 0:
raise UserError(file_data)
return ofx
def _obtain_statement_data(self, date_since, date_until):
self.ensure_one()
is_scheduled = self.env.context.get("scheduled")
# set date_until as today's date if its greter than today's date
# to avoid failure of request.
today = datetime.now()
today = today.replace(hour=0, minute=0, second=0, microsecond=0)
if date_until > today:
date_until = today
if self.service != "OFX":
return super()._obtain_statement_data(
date_since,
date_until,
) # pragma: no cover
lines = []
if is_scheduled:
ofx_institution_lines = self.ofx_institution_line_ids
else:
ofx_institution_lines = self.env["ofx.institution.line"].browse(
self._context.get("ofx_institution_ids")
)
for ofx_institution_line in ofx_institution_lines:
try:
username = ofx_institution_line.username
password = ofx_institution_line.password
bankid = ofx_institution_line.bankid
ofxhome_id = ofx_institution_line.institution_id.ofxhome_id
acctid = ofx_institution_line.account_id
institute = ofxhome.lookup(ofxhome_id)
if institute is None or institute.url is None:
raise UserError(_("OFX Data is not available"))
ofxhome_id = institute.id
client = OFXClient(
institute.url,
userid=username,
org=institute.org,
fid=institute.fid,
bankid=bankid,
)
dtstart = date_since.replace(tzinfo=utils.UTC)
dtend = date_until.replace(tzinfo=utils.UTC)
s1 = StmtRq(
acctid=acctid,
dtstart=dtstart,
dtend=dtend,
accttype="CHECKING",
)
ofx = self.get_statements(client, password, s1)
for account in ofx.accounts:
if not account.statement.transactions:
continue
for transaction in account.statement.transactions:
vals = self._prepare_ofx_transaction_line(transaction)
if vals:
lines.append(vals)
except Exception as e:
raise UserError(
_("The following problem occurred during import.\n\n %s") % str(e)
)
return lines, {}
@api.model
def _prepare_ofx_transaction_line(self, transaction):
payment_ref = transaction.payee
if transaction.checknum:
payment_ref += " " + transaction.checknum
if transaction.memo:
payment_ref += " : " + transaction.memo
vals = {
"date": transaction.date,
"payment_ref": payment_ref,
"amount": float(transaction.amount),
"unique_import_id": transaction.id,
}
return vals
def import_ofx_institutions(self):
OfxInstitution = self.env["ofx.institution"]
for ofxhome_id, name in ofxhome.list_institutions().items():
institute = OfxInstitution.search([("ofxhome_id", "=", ofxhome_id)])
vals = {
"name": name,
"ofxhome_id": ofxhome_id,
}
if institute:
institute.write(vals)
else:
OfxInstitution.create(vals)
class OFXInstitutionLine(models.Model):
_name = "ofx.institution.line"
_description = "OFX Institution Line"
_rec_name = "institution_id"
institution_id = fields.Many2one("ofx.institution", "Institution")
username = fields.Char()
password = fields.Char()
bankid = fields.Char()
provider_id = fields.Many2one("online.bank.statement.provider")
account_id = fields.Char()

View File

@@ -0,0 +1,5 @@
id,name,model_id:id,group_id:id,perm_read,perm_write,perm_create,perm_unlink
access_ofx_institution_manager,ofx_institution,model_ofx_institution,account.group_account_user,1,1,1,1
access_ofx_institution_user,ofx_institution,model_ofx_institution,base.group_user,1,0,0,0
access_ofx_institution_line_user,access_ofx_institution_line,model_ofx_institution_line,base.group_user,1,0,0,0
access_ofx_institution_line_manager,access_ofx_institution_line,model_ofx_institution_line,account.group_account_user,1,1,1,1
1 id name model_id:id group_id:id perm_read perm_write perm_create perm_unlink
2 access_ofx_institution_manager ofx_institution model_ofx_institution account.group_account_user 1 1 1 1
3 access_ofx_institution_user ofx_institution model_ofx_institution base.group_user 1 0 0 0
4 access_ofx_institution_line_user access_ofx_institution_line model_ofx_institution_line base.group_user 1 0 0 0
5 access_ofx_institution_line_manager access_ofx_institution_line model_ofx_institution_line account.group_account_user 1 1 1 1

Binary file not shown.

After

Width:  |  Height:  |  Size: 9.2 KiB

View File

@@ -0,0 +1,45 @@
<?xml version="1.0" encoding="utf-8" ?>
<odoo>
<record model="ir.ui.view" id="online_bank_statement_provider_form">
<field name="name">online.bank.statement.provider.form</field>
<field name="model">online.bank.statement.provider</field>
<field
name="inherit_id"
ref="account_statement_import_online.online_bank_statement_provider_form"
/>
<field name="arch" type="xml">
<xpath expr="//sheet" position="before">
<header>
<button
name="import_ofx_institutions"
type="object"
string="Import OFX Institutions"
attrs="{'invisible': [('service', '!=', 'OFX')]}"
/>
</header>
</xpath>
<xpath expr="//sheet" position="inside">
<notebook>
<page
name="ofx_institutions_list"
string="OFX Institutions"
attrs="{'invisible': [('service', '!=', 'OFX')]}"
>
<field name="ofx_institution_line_ids" mode="tree">
<tree editable="top">
<field
name="institution_id"
options="{'no_create_edit': True, 'no_quick_create': True}"
/>
<field name="username" required="1" />
<field name="password" password="1" required="1" />
<field name="bankid" required="1" />
<field name="account_id" required="1" />
</tree>
</field>
</page>
</notebook>
</xpath>
</field>
</record>
</odoo>

View File

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

View File

@@ -0,0 +1,32 @@
# Copyright 2023 ForgeFlow S.L.
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl.html).
from odoo import api, fields, models
class OnlineBankStatementPullWizard(models.TransientModel):
_inherit = "online.bank.statement.pull.wizard"
ofx_institution_ids = fields.Many2many(
string="OFX Institutions",
comodel_name="ofx.institution.line",
column1="wizard_id",
column2="institution_line_id",
relation="ofx_institution_line_pull_wizard_rel",
)
is_ofx_provider = fields.Boolean()
@api.onchange("provider_ids")
def onchange_provider_ids(self):
for rec in self:
rec.is_ofx_provider = False
for provider in rec.provider_ids:
if provider.service == "OFX":
rec.is_ofx_provider = True
break
def action_pull(self):
return super(
OnlineBankStatementPullWizard,
self.with_context(ofx_institution_ids=self.ofx_institution_ids.ids),
).action_pull()

View File

@@ -0,0 +1,22 @@
<?xml version="1.0" encoding="UTF-8" ?>
<odoo>
<record model="ir.ui.view" id="online_bank_statement_pull_wizard_form">
<field name="name">online.bank.statement.pull.wizard.form</field>
<field name="model">online.bank.statement.pull.wizard</field>
<field
name="inherit_id"
ref="account_statement_import_online.online_bank_statement_pull_wizard_form"
/>
<field name="arch" type="xml">
<field name="provider_ids" position="after">
<field name="is_ofx_provider" invisible="1" />
<field
name="ofx_institution_ids"
options="{'no_create_edit': True, 'no_quick_create': True}"
widget="many2many_tags"
attrs="{'invisible':[('is_ofx_provider','!=',True)],'required':[('is_ofx_provider','=',True)]}"
/>
</field>
</field>
</record>
</odoo>