Florent de Labarre
5 years ago
9 changed files with 418 additions and 0 deletions
-
103account_bank_statement_import_online_qonto/README.rst
-
1account_bank_statement_import_online_qonto/__init__.py
-
14account_bank_statement_import_online_qonto/__manifest__.py
-
4account_bank_statement_import_online_qonto/models/__init__.py
-
157account_bank_statement_import_online_qonto/models/online_bank_statement_provider_qonto.py
-
BINaccount_bank_statement_import_online_qonto/static/description/icon.png
-
3account_bank_statement_import_online_qonto/tests/__init__.py
-
120account_bank_statement_import_online_qonto/tests/test_account_bank_statement_import_online_qonto.py
-
16account_bank_statement_import_online_qonto/view/online_bank_statement_provider.xml
@ -0,0 +1,103 @@ |
|||
============================= |
|||
Online Bank Statements: Qonto |
|||
============================= |
|||
|
|||
.. |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_qonto |
|||
: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_qonto |
|||
: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 online bank statements from Qonto Bank. |
|||
|
|||
**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 *Qonto.eu* as 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 *Qonto.eu* as online bank statements provider in |
|||
*Online Bank Statements (OCA)* section |
|||
#. Save the bank account |
|||
#. Click on provider and configure provider-specific settings. |
|||
|
|||
To obtain *Login* and *Key*: |
|||
|
|||
#. Open `Qonto.eu <https://app.qonto.eu/>`_. |
|||
#. Go to *Settings* |
|||
#. Go to *Api Integration*, click *Generate Key* |
|||
|
|||
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* |
|||
|
|||
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_bank_statement_import_online_qonto%0Aversion:%2012.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 |
|||
~~~~~~~ |
|||
|
|||
* Florent de Labarre |
|||
|
|||
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. |
|||
|
|||
This module is part of the `OCA/bank-statement-import <https://github.com/OCA/bank-statement-import/tree/12.0/account_bank_statement_import_online_qonto>`_ project on GitHub. |
|||
|
|||
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute. |
@ -0,0 +1 @@ |
|||
from . import models |
@ -0,0 +1,14 @@ |
|||
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). |
|||
{ |
|||
"name": "Online Bank Statements: Qonto.eu", |
|||
"version": "12.0.1.0.0", |
|||
"category": "Account", |
|||
"website": "https://github.com/OCA/bank-statement-import", |
|||
"author": "Florent de Labarre, Odoo Community Association (OCA)", |
|||
"license": "AGPL-3", |
|||
"installable": True, |
|||
"depends": ["account_bank_statement_import_online"], |
|||
"data": [ |
|||
"view/online_bank_statement_provider.xml" |
|||
], |
|||
} |
@ -0,0 +1,4 @@ |
|||
# Copyright 2020 Florent de Labarre |
|||
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). |
|||
|
|||
from . import online_bank_statement_provider_qonto |
@ -0,0 +1,157 @@ |
|||
# Copyright 2020 Florent de Labarre |
|||
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). |
|||
import requests |
|||
import json |
|||
from datetime import datetime |
|||
import pytz |
|||
|
|||
from odoo import api, models, _ |
|||
from odoo.exceptions import UserError |
|||
from odoo.addons.base.models.res_bank import sanitize_account_number |
|||
|
|||
QONTO_ENDPOINT = 'https://thirdparty.qonto.eu/v2' |
|||
|
|||
|
|||
class OnlineBankStatementProviderQonto(models.Model): |
|||
_inherit = 'online.bank.statement.provider' |
|||
|
|||
@api.model |
|||
def _get_available_services(self): |
|||
return super()._get_available_services() + [ |
|||
('qonto', 'Qonto.eu'), |
|||
] |
|||
|
|||
def _obtain_statement_data(self, date_since, date_until): |
|||
self.ensure_one() |
|||
if self.service != 'qonto': |
|||
return super()._obtain_statement_data( |
|||
date_since, |
|||
date_until, |
|||
) |
|||
return self._qonto_obtain_statement_data(date_since, date_until) |
|||
|
|||
def _get_statement_date(self, date_since, date_until): |
|||
self.ensure_one() |
|||
if self.service != 'qonto': |
|||
return super()._get_statement_date( |
|||
date_since, |
|||
date_until, |
|||
) |
|||
return date_since.astimezone(pytz.timezone('Europe/Paris')).date() |
|||
|
|||
######### |
|||
# qonto # |
|||
######### |
|||
|
|||
def _qonto_header(self): |
|||
self.ensure_one() |
|||
if self.username and self.password: |
|||
return {'Authorization': '%s:%s' % (self.username, self.password)} |
|||
raise UserError(_('Please fill login and key')) |
|||
|
|||
def _qonto_get_slug(self): |
|||
self.ensure_one() |
|||
url = QONTO_ENDPOINT + '/organizations/%7Bid%7D' |
|||
response = requests.get(url, verify=False, headers=self._qonto_header()) |
|||
if response.status_code == 200: |
|||
data = json.loads(response.text) |
|||
res = {} |
|||
for account in data.get('organization', {}).get('bank_accounts', []): |
|||
iban = sanitize_account_number(account.get('iban', '')) |
|||
res[iban] = account.get('slug') |
|||
return res |
|||
raise UserError(_('%s \n\n %s') % (response.status_code, response.text)) |
|||
|
|||
def _qonto_obtain_transactions(self, slug, date_since, date_until): |
|||
self.ensure_one() |
|||
url = QONTO_ENDPOINT + '/transactions' |
|||
params = {'slug': slug, 'iban': self.account_number} |
|||
|
|||
if date_since: |
|||
params['settled_at_from'] = date_since.replace( |
|||
microsecond=0).isoformat() + 'Z' |
|||
if date_until: |
|||
params['settled_at_to'] = date_until.replace( |
|||
microsecond=0).isoformat() + 'Z' |
|||
transactions = [] |
|||
current_page = 1 |
|||
total_pages = 1 |
|||
while current_page <= total_pages: |
|||
params['current_page'] = current_page |
|||
data = self._qonto_get_transactions(url, params) |
|||
transactions.extend(data.get('transactions', [])) |
|||
total_pages = data['meta']['total_pages'] |
|||
current_page += 1 |
|||
return transactions |
|||
|
|||
def _qonto_get_transactions(self, url, params): |
|||
response = requests.get(url, verify=False, params=params, |
|||
headers=self._qonto_header()) |
|||
if response.status_code == 200: |
|||
return json.loads(response.text) |
|||
raise UserError(_('%s \n\n %s') % (response.status_code, response.text)) |
|||
|
|||
def _qonto_prepare_statement_line( |
|||
self, transaction, sequence, journal_currency, currencies_code2id): |
|||
date = datetime.strptime(transaction['settled_at'], '%Y-%m-%dT%H:%M:%S.%fZ') |
|||
side = 1 if transaction['side'] == 'credit' else -1 |
|||
name = transaction['label'] or '/' |
|||
if transaction['reference']: |
|||
name = '%s %s' % (name, transaction['reference']) |
|||
vals_line = { |
|||
'sequence': sequence, |
|||
'date': date, |
|||
'name': name, |
|||
'ref': transaction['reference'], |
|||
'unique_import_id': transaction['transaction_id'], |
|||
'amount': transaction['amount'] * side, |
|||
} |
|||
|
|||
if not transaction['local_currency']: |
|||
raise UserError(_( |
|||
"Transaction ID %s has not local_currency. " |
|||
"This should never happen.") % transaction['transaction_id']) |
|||
if transaction['local_currency'] not in currencies_code2id: |
|||
raise UserError(_( |
|||
"Currency %s used in transaction ID %s doesn't exist " |
|||
"in Odoo.") % ( |
|||
transaction['local_currency'], |
|||
transaction['transaction_id'])) |
|||
|
|||
line_currency_id = currencies_code2id[transaction['local_currency']] |
|||
|
|||
if journal_currency.id != line_currency_id: |
|||
vals_line.update({ |
|||
'currency_id': line_currency_id, |
|||
'amount_currency': transaction['local_amount'] * side, |
|||
}) |
|||
return vals_line |
|||
|
|||
def _qonto_obtain_statement_data(self, date_since, date_until): |
|||
self.ensure_one() |
|||
journal = self.journal_id |
|||
|
|||
slugs = self._qonto_get_slug() |
|||
slug = slugs.get(self.account_number) |
|||
if not slug: |
|||
raise UserError( |
|||
_('Qonto : wrong configuration, unknow account %s') |
|||
% journal.bank_account_id.acc_number) |
|||
|
|||
transactions = self._qonto_obtain_transactions(slug, date_since, date_until) |
|||
|
|||
journal_currency = journal.currency_id or journal.company_id.currency_id |
|||
|
|||
all_currencies = self.env['res.currency'].search_read([], ['name']) |
|||
currencies_code2id = dict([(x['name'], x['id']) for x in all_currencies]) |
|||
new_transactions = [] |
|||
sequence = 0 |
|||
for transaction in transactions: |
|||
sequence += 1 |
|||
vals_line = self._qonto_prepare_statement_line( |
|||
transaction, sequence, journal_currency, currencies_code2id) |
|||
new_transactions.append(vals_line) |
|||
|
|||
if new_transactions: |
|||
return new_transactions, {} |
|||
return |
After Width: 128 | Height: 128 | Size: 9.2 KiB |
@ -0,0 +1,3 @@ |
|||
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). |
|||
|
|||
from . import test_account_bank_statement_import_online_qonto |
@ -0,0 +1,120 @@ |
|||
# Copyright 2020 Florent de Labarre |
|||
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). |
|||
|
|||
from datetime import datetime |
|||
from unittest import mock |
|||
|
|||
from odoo import fields |
|||
from odoo.tests import common |
|||
|
|||
_module_ns = 'odoo.addons.account_bank_statement_import_online_qonto' |
|||
_provider_class = ( |
|||
_module_ns |
|||
+ '.models.online_bank_statement_provider_qonto' |
|||
+ '.OnlineBankStatementProviderQonto' |
|||
) |
|||
|
|||
|
|||
class TestAccountBankAccountStatementImportOnlineQonto( |
|||
common.TransactionCase |
|||
): |
|||
|
|||
def setUp(self): |
|||
super().setUp() |
|||
|
|||
self.now = fields.Datetime.now() |
|||
self.currency_eur = self.env.ref('base.EUR') |
|||
self.currency_usd = self.env.ref('base.USD') |
|||
self.AccountJournal = self.env['account.journal'] |
|||
self.ResPartnerBank = self.env['res.partner.bank'] |
|||
self.OnlineBankStatementProvider = self.env[ |
|||
'online.bank.statement.provider' |
|||
] |
|||
self.AccountBankStatement = self.env['account.bank.statement'] |
|||
self.AccountBankStatementLine = self.env['account.bank.statement.line'] |
|||
|
|||
self.bank_account = self.ResPartnerBank.create( |
|||
{'acc_number': 'FR0214508000302245362775K46', |
|||
'partner_id': self.env.user.company_id.partner_id.id}) |
|||
self.journal = self.AccountJournal.create({ |
|||
'name': 'Bank', |
|||
'type': 'bank', |
|||
'code': 'BANK', |
|||
'currency_id': self.currency_eur.id, |
|||
'bank_statements_source': 'online', |
|||
'online_bank_statement_provider': 'qonto', |
|||
'bank_account_id': self.bank_account.id, |
|||
}) |
|||
self.provider = self.journal.online_bank_statement_provider_id |
|||
|
|||
self.mock_slug = lambda: mock.patch( |
|||
_provider_class + '._qonto_get_slug', |
|||
return_value={'FR0214508000302245362775K46': 'qonto-1234-bank-account-1'}, |
|||
) |
|||
self.mock_transaction = lambda: mock.patch( |
|||
_provider_class + '._qonto_get_transactions', |
|||
return_value={ |
|||
"transactions": [ |
|||
{"transaction_id": "qonto-1234-1-transaction-3", |
|||
"amount": 1200.0, |
|||
"amount_cents": 120000, |
|||
"attachment_ids": [], |
|||
"local_amount": 1200.0, |
|||
"local_amount_cents": 120000, |
|||
"side": "credit", |
|||
"operation_type": "income", |
|||
"currency": "EUR", |
|||
"local_currency": "EUR", |
|||
"label": "INVOICE A", |
|||
"settled_at": "2020-04-16T07:01:55.503Z", |
|||
"emitted_at": "2020-04-16T05:01:55.000Z", |
|||
"updated_at": "2020-04-16T07:04:02.792Z", |
|||
"status": "completed", |
|||
"note": None, |
|||
"reference": "Ref 1233", |
|||
"vat_amount": None, |
|||
"vat_amount_cents": None, |
|||
"vat_rate": None, |
|||
"initiator_id": None, |
|||
"label_ids": [], |
|||
"attachment_lost": False, |
|||
"attachment_required": True}, |
|||
{"transaction_id": "qonto-1234-1-transaction-2", |
|||
"amount": 1128.36, "amount_cents": 112836, |
|||
"attachment_ids": [], |
|||
"local_amount": 1128.36, |
|||
"local_amount_cents": 112836, |
|||
"side": "debit", |
|||
"operation_type": "transfer", |
|||
"currency": "EUR", |
|||
"local_currency": "EUR", |
|||
"label": "BILL A", |
|||
"settled_at": "2020-04-16T07:00:30.979Z", |
|||
"emitted_at": "2020-04-15T18:22:30.296Z", |
|||
"updated_at": "2020-04-16T07:03:01.125Z", |
|||
"status": "completed", |
|||
"note": None, |
|||
"reference": "Invoice", |
|||
"vat_amount": None, |
|||
"vat_amount_cents": None, |
|||
"vat_rate": None, |
|||
"initiator_id": "9b783957-85a6-404a-8320-a298781cb5fa", |
|||
"label_ids": [], |
|||
"attachment_lost": False, |
|||
"attachment_required": True}], |
|||
"meta": {"current_page": 1, |
|||
"next_page": None, |
|||
"prev_page": None, |
|||
"total_pages": 1, |
|||
"total_count": 2, |
|||
"per_page": 100}}, |
|||
) |
|||
|
|||
def test_qonto(self): |
|||
with self.mock_transaction(), self.mock_slug(): |
|||
lines, statement_values = self.provider._obtain_statement_data( |
|||
datetime(2020, 4, 15), |
|||
datetime(2020, 4, 17), |
|||
) |
|||
|
|||
self.assertEqual(len(lines), 2) |
@ -0,0 +1,16 @@ |
|||
<?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_bank_statement_import_online.online_bank_statement_provider_form"/> |
|||
<field name="arch" type="xml"> |
|||
<xpath expr="//page[@name='configuration']" position="inside"> |
|||
<group name="qonto" attrs="{'invisible':[('service','!=','qonto')]}"> |
|||
<field name="username" string="Login"/> |
|||
<field name="password" string="Key"/> |
|||
</group> |
|||
</xpath> |
|||
</field> |
|||
</record> |
|||
</odoo> |
Write
Preview
Loading…
Cancel
Save
Reference in new issue