mirror of
https://github.com/OCA/bank-statement-import.git
synced 2025-01-20 12:37:43 +02:00
[ADD] account_bank_statement_import_online_ofx
This commit is contained in:
committed by
Christopher Ormaza
parent
98714834ef
commit
f4449016e9
110
account_statement_import_online_ofx/README.rst
Normal file
110
account_statement_import_online_ofx/README.rst
Normal 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.
|
||||||
4
account_statement_import_online_ofx/__init__.py
Normal file
4
account_statement_import_online_ofx/__init__.py
Normal file
@@ -0,0 +1,4 @@
|
|||||||
|
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
|
||||||
|
|
||||||
|
from . import models
|
||||||
|
from . import wizards
|
||||||
20
account_statement_import_online_ofx/__manifest__.py
Normal file
20
account_statement_import_online_ofx/__manifest__.py
Normal 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,
|
||||||
|
}
|
||||||
4
account_statement_import_online_ofx/models/__init__.py
Normal file
4
account_statement_import_online_ofx/models/__init__.py
Normal 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
|
||||||
@@ -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()
|
||||||
@@ -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()
|
||||||
@@ -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
|
||||||
|
BIN
account_statement_import_online_ofx/static/description/icon.png
Normal file
BIN
account_statement_import_online_ofx/static/description/icon.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 9.2 KiB |
@@ -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>
|
||||||
3
account_statement_import_online_ofx/wizards/__init__.py
Normal file
3
account_statement_import_online_ofx/wizards/__init__.py
Normal file
@@ -0,0 +1,3 @@
|
|||||||
|
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
|
||||||
|
|
||||||
|
from . import online_bank_statement_pull_wizard
|
||||||
@@ -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()
|
||||||
@@ -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>
|
||||||
Reference in New Issue
Block a user