<a class="reference external image-reference" href="https://www.gnu.org/licenses/lpgl"><img alt="License: LGPL-3" src="https://img.shields.io/badge/license-LGPL--3-blue.png" /></a> <a name="ebics-banking-protocol"></a> <h2>EBICS banking protocol</h2> <p>Implementation of the EBICS banking protocol.</p> <p>This module facilitates the exchange of files with banks via the EBICS protocol.</p> <div class="line-block"> <div class="line"><br /></div> </div> <a name="installation"></a> <h3>Installation</h3> <p>The module depends upon</p> <ul class="simple"> <li><a class="reference external" href="https://pypi.python.org/pypi/fintech">https://pypi.python.org/pypi/fintech</a></li> <li><a class="reference external" href="https://pypi.python.org/pypi/cryptography">https://pypi.python.org/pypi/cryptography</a></li> </ul> <p>Remark:</p> <p>The EBICS 'Test Mode' for uploading orders requires Fintech 4.3.4 or higher.</p> <p>SWIFT 3SKey support requires Fintech 6.4 or higher.</p> <div class="line-block"> <div class="line"><br /></div> </div> <p>We also recommend to consider the installation of the following modules:</p> <div class="line-block"> <div class="line"><br /></div> </div> <ul> <li><p class="first">account_ebics_oe</p> <p>Required if you are running Odoo Enterprise</p> </li> </ul> <div class="line-block"> <div class="line"><br /></div> </div> <ul> <li><p class="first">account_ebics_batch_payment</p> <p>Recommended if you are using the Odoo Enterprise account_batch_payment module</p> </li> </ul> <div class="line-block"> <div class="line"><br /></div> </div> <ul> <li><p class="first">account_ebics_payment_order</p> <p>Recommended if you are using the OCA account_payment_order module.</p> <p>Cf. <a class="reference external" href="https://github.com/OCA/bank-payment">https://github.com/OCA/bank-payment</a></p> </li> </ul> <div class="line-block"> <div class="line"><br /></div> </div> <ul> <li><p class="first">account_statement_import_fr_cfonb</p> <p>Required to handle french CFONB files.</p> <p>Cf. <a class="reference external" href="https://github.com/OCA/l10n_france">https://github.com/OCA/l10n_france</a></p> </li> </ul> <div class="line-block"> <div class="line"><br /></div> </div> <ul> <li><p class="first">account_statement_import_camt</p> <p>Required to handle camt.052 and camt.054 files.</p> <p>Cf. <a class="reference external" href="https://github.com/OCA/bank_statement_import">https://github.com/OCA/bank_statement_import</a></p> </li> </ul> <div class="line-block"> <div class="line"><br /></div> </div> <ul> <li><p class="first">account_statement_import_helper</p> <p>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.</p> <p>The import helper will match the local bank account number with the IBAN number specified on the Odoo Financial journal.</p> <p>Cf. <a class="reference external" href="https://github.com/Noviat/noviat-apps">https://github.com/Noviat/noviat-apps</a></p> </li> </ul> <div class="line-block"> <div class="line"><br /></div> </div> <ul> <li><p class="first">account_bank_statement_import_helper</p> <p>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.</p> <p>The import helper will match the local bank account number with the IBAN number specified on the Odoo Financial journal.</p> <p>Cf. <a class="reference external" href="https://github.com/Noviat/noviat-apps">https://github.com/Noviat/noviat-apps</a></p> </li> </ul> <div class="line-block"> <div class="line"><br /></div> </div> <a name="fintech-license"></a> <h4>Fintech license</h4> <p>If you have a valid Fintech.ebics license, you should add the following licensing parameters to the odoo server configuration file:</p> <ul class="simple"> <li>fintech_register_name</li> </ul> <p>The name of the licensee.</p> <ul class="simple"> <li>fintech_register_keycode</li> </ul> <p>The keycode of the licensed version.</p> <ul class="simple"> <li>fintech_register_users</li> </ul> <p>The licensed EBICS user ids. It must be a string or a list of user ids.</p> <p>You should NOT specify this parameter if your license is subsciption based (with monthly recurring billing).</p> <div class="line-block"> <div class="line"><br /></div> <div class="line">Example:</div> <div class="line"><br /></div> </div> <pre> <code>; fintech fintech_register_name = MyCompany fintech_register_keycode = AB1CD-E2FG-3H-IJ4K-5L fintech_register_users = USER1, USER2</code> </pre> <div class="line-block"> <div class="line"><br /></div> </div> <a name="configuration"></a> <h3>Configuration</h3> <p>Go to <strong>Settings &gt; Users</strong></p> <p>Add the users that are authorised to maintain the EBICS configuration to the 'EBICS Manager' Group.</p> <div class="line-block"> <div class="line"><br /></div> </div> <p>Go to <strong>Accounting &gt; Configuration &gt; Miscellaneous &gt; EBICS &gt; EBICS File Formats</strong></p> <p>Check if the EBICS File formats that you want to process in Odoo are defined.</p> <p>Most commonly used formats for which support is available in Odoo should be there already.</p> <p>Please open an issue on <a class="reference external" href="https://github.com/Noviat/account_ebics">https://github.com/Noviat/account_ebics</a> to report missing EBICS File Formats.</p> <p>For File Formats of type 'Downloads' you can also specifiy a 'Download Process Method'.</p> <p>This is the method that will be executed when hitting the 'Process' button on the downloaded file.</p> <p>The following methods are currently available:</p> <ul class="simple"> <li>cfonb120</li> <li>camt.053</li> <li>camt.052</li> <li>camt.054</li> </ul> <p>All these methods require complimentary modules to be installed (cf. Installation section supra).</p> <p>You'll get an error message when the required module is not installed on your Odoo instance.</p> <div class="line-block"> <div class="line"><br /></div> </div> <p>Go to <strong>Accounting &gt; Configuration &gt; Miscellaneous &gt; EBICS &gt; EBICS Configuration</strong></p> <p>Configure your EBICS configuration according to the contract with your bank.</p> <div class="line-block"> <div class="line"><br /></div> </div> <a name="usage"></a> <h3>Usage</h3> <p>Go to <strong>Accounting &gt; Bank and Cash &gt; EBICS Processing</strong></p> <div class="line-block"> <div class="line"><br /></div> </div> <a name="ebics-return-codes"></a> <h4>EBICS Return Codes</h4> <p>During the processing of your EBICS upload/download, your bank may return an Error Code, e.g.</p> <p>EBICS Functional Error: EBICS_NO_DOWNLOAD_DATA_AVAILABLE (code: 90005)</p> <p>A detailled explanation of the codes can be found on <a class="reference external" href="http://www.ebics.org">http://www.ebics.org</a>. You can also find this information in the doc folder of this module (file EBICS_Annex1_ReturnCodes).</p> <div class="line-block"> <div class="line"><br /></div> </div> <a name="known-issues-roadmap"></a> <h3>Known Issues / Roadmap</h3> <ul class="simple"> <li>add support for EBICS 3.0</li> <li>add support to import externally generated keys &amp; certificates (currently only 3SKey signature certificate)</li> </ul>