EBICS banking protocol

by
Odoo
v 15.0 Third Party 833
Download for v 15.0 Deploy on Odoo.sh
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies Invoicing (account)
Discuss (mail)
Lines of code 2555
Technical Name account_ebics
LicenseLGPL-3
Websitehttps://www.noviat.com
Versions 17.0 12.0 13.0 8.0 10.0 11.0 14.0 15.0 16.0
You bought this module and need support? Click here!
License: LGPL-3

EBICS banking protocol

Implementation of the EBICS banking protocol.

This module facilitates the exchange of files with banks via the EBICS protocol.


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 for EBICS 2.x and fintech 7.2.7 or higher for EBICS 3.0.

SWIFT 3SKey support requires fintech 6.4 or higher.


We also recommend to consider the installation of the following modules:


  • account_ebics_oe

    Required if you are running Odoo Enterprise


  • account_ebics_batch

    This module adds a cron job for the automated import of EBICS files.


  • 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_statement_import_fr_cfonb

    Required to handle french CFONB files.

    Cf. https://github.com/OCA/l10n_france


  • account_statement_import_camt

    Required to handle camt.052 and camt.054 files.

    Cf. https://github.com/OCA/bank-statement-import


  • account_statement_import_helper

    Required if you are processing bank statements with local bank account numbers (e.g. french CFONB files) and using import parsers based upon the OCA account_statement_import module.

    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/noviat-apps


  • account_bank_statement_import_helper

    Required if you are processing bank statements with local bank account numbers and using import parsers based upon the Odoo Enterprise account_bank_statement_import module.

    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/noviat-apps


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.

You should NOT specify this parameter if your license is subsciption based (with monthly recurring billing).


Example:

; fintech
fintech_register_name = MyCompany
fintech_register_keycode = AB1CD-E2FG-3H-IJ4K-5L
fintech_register_users = USER1, USER2

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 File Formats

Check if the EBICS File formats that you want to process in Odoo are defined.

Most commonly used formats for which support is available in Odoo should be there already.

Please open an issue on https://github.com/Noviat/account_ebics to report missing EBICS File Formats.

For File Formats of type 'Downloads' you can also specifiy a 'Download Process Method'.

This is the method that will be executed when hitting the 'Process' button on the downloaded file.

The following methods are currently available:

  • cfonb120
  • camt.053
  • camt.052
  • camt.054

All these methods require complimentary modules to be installed (cf. Installation section supra).

You'll get an error message when the required module is not installed on your Odoo instance.


Go to Accounting > Configuration > Miscellaneous > EBICS > EBICS Configuration

Configure your EBICS configuration according to the contract with your bank.


Usage

Go to Accounting > Bank and Cash > EBICS Processing


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).


Known Issues / Roadmap

  • add support to import externally generated keys & certificates (currently only 3SKey signature certificate)

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author, please use the developer contact information. They can usually be found in the description.
Please choose a rating from 1 to 5 for this module.
There are no ratings yet!
by
Jean-Marc Vandel
on 2/9/23, 3:28 AM

The module itself is free, but if I'm right, and if I want files from the previous day, I will need to pay the fee to Fintec as described below ?

Prices of the EBICS client

In addition to a one-time setup fee of 100.- EUR the license costs are based on the number of EBICS user ids to be used. The first EBICS user id is charged with 25.- EUR per month. Each additional EBICS user id is charged with 10.- EUR per month. All user ids can be canceled without a notice period to the end of the month at any time.


Re:
by
Luc De Meyer
on 2/9/23, 7:12 AM Author

Indeed you need to order a license key via joonis.de, cf. https://www.joonis.de/en/fintech/prices/



Compatibility with Swiss EBICS
by
Andreas Carl
on 1/27/23, 2:31 AM

Hi, is this module (and are your other Odoo apps) compatible with Swiss EBICS 2.5 and/or 3.0 according to ebics.ch?

Re: Compatibility with Swiss EBICS
by
Luc De Meyer
on 1/29/23, 3:40 PM Author

We are running this module for customers in France, Germany, Swiss and Austria.

For some Swiss banks you may need to install some of the complementary modules to get it fully working in both up- and download mode.

EBICS 2.4, 2.5 and 3.0 are supported.

You can contact us via info@noviat.com if you need support in establishing an EBICS connection with your bank.