<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> <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_bank_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_fr">https://github.com/OCA/l10n_fr</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 (e.g. french CFONB files).</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-apps">https://github.com/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> <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> <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>