2019-12-22 09:54:00 +00:00
|
|
|
.. image:: https://img.shields.io/badge/license-LGPL--3-blue.png
|
|
|
|
|
:target: https://www.gnu.org/licenses/lpgl
|
|
|
|
|
:alt: License: LGPL-3
|
2018-08-14 15:04:39 +00:00
|
|
|
|
|
|
|
|
======================
|
|
|
|
|
EBICS banking protocol
|
|
|
|
|
======================
|
|
|
|
|
|
|
|
|
|
Implementation of the EBICS banking protocol.
|
|
|
|
|
|
|
|
|
|
This module facilitates the exchange of files with banks via the EBICS protocol.
|
|
|
|
|
|
2020-07-14 19:07:53 +00:00
|
|
|
|
|
|
|
|
|
|
2018-08-14 15:04:39 +00:00
|
|
|
Installation
|
|
|
|
|
============
|
|
|
|
|
|
|
|
|
|
The module depends upon
|
|
|
|
|
|
|
|
|
|
- https://pypi.python.org/pypi/fintech
|
|
|
|
|
- https://pypi.python.org/pypi/cryptography
|
|
|
|
|
|
|
|
|
|
Remark:
|
|
|
|
|
|
|
|
|
|
The EBICS 'Test Mode' for uploading orders requires Fintech 4.3.4 or higher.
|
|
|
|
|
|
2020-07-14 19:07:53 +00:00
|
|
|
|
|
|
|
|
|
|
2020-07-18 16:37:18 +00:00
|
|
|
We also recommend to consider the installation of the following modules:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- account_ebics_oe
|
|
|
|
|
|
|
|
|
|
Required if you are running Odoo Enterprise
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- account_ebics_batch_payment
|
|
|
|
|
|
|
|
|
|
Recommended if you are using the Odoo Enterprise account_batch_payment module
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- account_ebics_payment_order
|
|
|
|
|
|
|
|
|
|
Recommended if you are using the OCA account_payment_order module.
|
|
|
|
|
|
|
|
|
|
Cf. https://github.com/OCA/bank-payment
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- account_bank_statement_import_fr_cfonb
|
|
|
|
|
|
|
|
|
|
Required to handle french CFONB files.
|
|
|
|
|
|
|
|
|
|
Cf. https://github.com/OCA/l10n_fr
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- account_bank_statement_import_helper
|
|
|
|
|
|
|
|
|
|
Required if you are processing bank statements with local bank account numbers (e.g. french CFONB files).
|
|
|
|
|
|
|
|
|
|
The import helper will match the local bank account number with the IBAN number specified on the Odoo Financial journal.
|
|
|
|
|
|
|
|
|
|
Cf. https://github.com/noviat-apps
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2018-08-14 15:04:39 +00:00
|
|
|
Fintech license
|
|
|
|
|
---------------
|
|
|
|
|
|
|
|
|
|
If you have a valid Fintech.ebics license, you should add the following
|
|
|
|
|
licensing parameters to the odoo server configuration file:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- fintech_register_name
|
|
|
|
|
|
|
|
|
|
The name of the licensee.
|
|
|
|
|
|
|
|
|
|
- fintech_register_keycode
|
|
|
|
|
|
|
|
|
|
The keycode of the licensed version.
|
|
|
|
|
|
|
|
|
|
- fintech_register_users
|
|
|
|
|
|
|
|
|
|
The licensed EBICS user ids. It must be a string or a list of user ids.
|
|
|
|
|
|
2020-07-14 19:07:53 +00:00
|
|
|
|
|
|
|
|
|
| Example:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
::
|
|
|
|
|
|
|
|
|
|
; fintech
|
|
|
|
|
fintech_register_name = MyCompany
|
|
|
|
|
fintech_register_keycode = AB1CD-E2FG-3H-IJ4K-5L
|
|
|
|
|
fintech_register_users = USER1, USER2
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2018-08-14 15:04:39 +00:00
|
|
|
Configuration
|
|
|
|
|
=============
|
|
|
|
|
|
|
|
|
|
Go to **Settings > Users**
|
|
|
|
|
|
|
|
|
|
Add the users that are authorised to maintain the EBICS configuration to the 'EBICS Manager' Group.
|
|
|
|
|
|
|
|
|
|
Go to **Accounting > Configuration > Miscellaneous > EBICS > EBICS Configuration**
|
|
|
|
|
|
|
|
|
|
Configure your EBICS configuration according to the contract with your bank.
|
|
|
|
|
|
2020-07-14 19:07:53 +00:00
|
|
|
|
|
|
|
|
|
|
2018-08-14 15:04:39 +00:00
|
|
|
Usage
|
|
|
|
|
=====
|
|
|
|
|
|
|
|
|
|
Go to **Accounting > Bank and Cash > EBICS Processing**
|
|
|
|
|
|
2020-07-14 19:07:53 +00:00
|
|
|
|
|
|
|
|
|
|
2018-08-14 15:04:39 +00:00
|
|
|
EBICS Return Codes
|
|
|
|
|
------------------
|
|
|
|
|
|
|
|
|
|
During the processing of your EBICS upload/download, your bank may return an Error Code, e.g.
|
|
|
|
|
|
|
|
|
|
EBICS Functional Error:
|
|
|
|
|
EBICS_NO_DOWNLOAD_DATA_AVAILABLE (code: 90005)
|
|
|
|
|
|
|
|
|
|
A detailled explanation of the codes can be found on http://www.ebics.org.
|
|
|
|
|
You can also find this information in the doc folder of this module (file EBICS_Annex1_ReturnCodes).
|
2020-07-05 06:24:57 +00:00
|
|
|
|
2020-07-14 19:07:53 +00:00
|
|
|
|
|
|
|
|
|
|
2020-07-05 06:24:57 +00:00
|
|
|
Known Issues / Roadmap
|
|
|
|
|
======================
|
|
|
|
|
|
|
|
|
|
- add support for 3SKEY signed transactions
|
|
|
|
|
- add support for EBICS 3.0
|
