Search 1.9 billion lines of Odoo code on GitHub

l10n_cl_currency_rate_update

Author: Intellego-BI.com, Camptocamp, Odoo Community Association (OCA)
License: AGPL-3
Branch: master
Repository: flectra-chile/odoo-cl-12
Dependencies: account, base, currency_rate_inverted, and mail
Languages: HTML (56, 5.5%), PO File (98, 9.6%), Python (627, 61.2%), XML (177, 17.3%), and reStructuredText (67, 6.5%)
Other branches: master-report-payslit, master-resources, and master-salary-rule
Other repositories: GiraffosCom/odoo-cl-12, KurrufERP/odoo-cl-12, Mefistous/odoo-cl-12, Normatica/odoo-cl-12, UnknownInfo/odoo-cl-12, alvarojimenezpaz/odoo-cl-12, intellego-bi/odoo-12, intellego-bi/odoo-cl-12, jriveros/odoo-cl-12, mallconnectionorg/openerp, marcel1981/odoo-cl-12, maurolguin1/odoo-cl-12, and vidtsin/odoo-cl-12

<a class="reference external image-reference" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.svg"> </a> <a name="currency-rate-update-sbif-chile"></a> <h2>Currency Rate Update (SBIF Chile)</h2> <p>Base module to download exchange rates automatically from the SBIF API for Chilean currencies (UF, UTM, USD and EUR).</p> <p>This module is a fork from the original OCA module <em>(currency_rate_update)</em> that downloads exchange rates automatically from <em>European Central Bank (ECB)</em> service (ported by Grzegorz Grzelak - OpenGLOBE.pl)</p> <p>The functionality from the original OCA Module has been replaced and repurposed in order to retrieve exchange rates relating to Chilean Peso (CLP) from API (Web Service) provided by SBIF Chile (<a class="reference external" href="https://api.sbif.cl">https://api.sbif.cl</a>) The service that retrieves rates from the ECB has been removed from this fork.</p> <a name="configuration"></a> <h3>Configuration</h3> <p>Installing this module will create two additional currencies for Chile: <em>UF (Unidad de Fomento)</em> and <em>UTM (Unidad Tributaria Mensual)</em>. It will also set the position of the symbols and decimal places.</p> <p>This module must be used jointly with the OCA module <em>&quot;Currency Rate Inverted&quot;</em> which is used in order to set CLP as an <em>&quot;Inverted Rate Currency&quot;</em>. You must manually set <em>&quot;CLP&quot;</em> as an <em>&quot;Inverted Rate Currency&quot;</em> after installing this module.</p> <p><strong>WARNING:</strong> This module must not be deployed on live production systems as it modifies the logic for saving amounts in parallel and local currencies in the Odoo database. Doing so may generate permanent and irreversible damage to data in your database. It is intended for fresh development or greenfield production installations only.</p> <p>To configure the module, follow the configuration instructions published for OCA module <em>&quot;Currency Rate Update&quot;</em> and the steps outlined here.</p> <a name="installation"></a> <h3>Installation</h3> <p>Download and install <em>&quot;currency_rate_inverted&quot;</em> and <em>&quot;l10n_cl_currency_rate_update&quot;</em> and deploy to your <em>&quot;addons&quot;</em> folder on your Odoo server. Installing <em>&quot;l10n_cl_currency_rate_update&quot;</em> will also install <em>&quot;currency_rate_inverted&quot;</em>. After installing both modules follow these steps:</p> <ul class="simple"> <li>Go to <em>Accounting &gt; Settings &gt; Currencies</em></li> <li>Edit <em>CLP</em> currency and activate <em>&quot;Inverted Currency Rate&quot;</em> for this currency <em>only</em></li> <li>Go to the SBIF website and follow the process to request your own API Key (<a class="reference external" href="https://api.sbif.cl/uso-de-api-key.html">https://api.sbif.cl/uso-de-api-key.html</a>)</li> <li>Once you have your new API Key (mail reply from SBIF takes a couple of minutes at most), in Odoo, go to <em>Accounting &gt; General Settings</em> and scroll down until you find the setting for <em>Chilean Currency Update</em></li> <li>Enter your <em>API Key</em> in the provided field and <em>SAVE</em> your settings</li> <li>Go to <em>Accounting &gt; Settings</em> and select menu item <em>&quot;Actualizar Tipos de Cambio SBIF&quot;</em></li> <li>Press <em>&quot;Create&quot;</em> to enter new settings for SBIF web service</li> <li>Select <em>&quot;SBIF Web Service&quot;</em> and enter parameters as described for original <em>&quot;currency_rate_update&quot;</em> module</li> <li>Select currencies to update: <em>USD, EUR, UF and/or UTM</em> as per your requirements and <em>SAVE</em></li> <li>Press <em>&quot;Actualizar Ahora&quot;</em> and after a couple of seconds you should see the new exchange rates updated from SBIF</li> </ul> <p>A <em>cron job</em> is automatically created and scheduled to run 24 hours after this first execution. You may alter these settings for periodic update by activating <em>Developer Mode</em> in Odoo and then in <em>Settings &gt; Technical &gt; Scheduled Actions</em> you can configure the cron job parameters as per your needs. It is recommended to run the update everyday during the morning. This will retrieve the currency rates for the previous day from SBIF. If you want to run it immediately, use the button <em>Run Manually</em> or go to the menu item created in <em>Accounting &gt; Settings</em> and press <em>&quot;Actualizar Ahora&quot;</em>.</p> <a name="known-issues"></a> <h3>Known Issues</h3> <p>Issues:</p> <ul class="simple"> <li>Cronjob will run on weekends and holidays when there is no valid response from SBIF web service. This is logged as an Error/Warning, without further consequences for the update process.</li> <li>Set a <em>Max Delta Days</em> of 6 or more days in order to cover longer holidays in Chile (Fiestas Patrias, mainly).</li> </ul> <a name="further-development"></a> <h3>Further Development</h3> <ul class="simple"> <li>No further development is planned.</li> <li>The original structure of the <em>&quot;currency_rate_update&quot;</em> module on which this is based has been preserved to the best of our abilities so (hopefuly) this Chilean module may be backported into the original OCA module and added as another <em>Currency Rate Update Service</em> provider there.</li> </ul> <a name="credits"></a> <h3>Credits</h3> <a name="contributors"></a> <h4>Contributors</h4> <ul class="simple"> <li>Nicolas Bessi &lt;<a class="reference external" href="mailto:nicolas.bessi&#64;camptocamp.com">nicolas.bessi&#64;camptocamp.com</a>&gt;</li> <li>Jean-Baptiste Aubort &lt;<a class="reference external" href="mailto:jean-baptiste.aubort&#64;camptocamp.com">jean-baptiste.aubort&#64;camptocamp.com</a>&gt;</li> <li>Joël Grand-Guillaume &lt;<a class="reference external" href="mailto:joel.grandguillaume&#64;camptocamp.com">joel.grandguillaume&#64;camptocamp.com</a>&gt;</li> <li>Grzegorz Grzelak &lt;<a class="reference external" href="mailto:grzegorz.grzelak&#64;openglobe.pl">grzegorz.grzelak&#64;openglobe.pl</a>&gt; (ECB, NBP)</li> <li>Vincent Renaville &lt;<a class="reference external" href="mailto:vincent.renaville&#64;camptocamp.com">vincent.renaville&#64;camptocamp.com</a>&gt;</li> <li>Yannick Vaucher &lt;<a class="reference external" href="mailto:yannick.vaucher&#64;camptocamp.com">yannick.vaucher&#64;camptocamp.com</a>&gt;</li> <li>Guewen Baconnier &lt;<a class="reference external" href="mailto:guewen.baconnier&#64;camptocamp.com">guewen.baconnier&#64;camptocamp.com</a>&gt;</li> <li>Lorenzo Battistini &lt;<a class="reference external" href="mailto:lorenzo.battistini&#64;agilebg.com">lorenzo.battistini&#64;agilebg.com</a>&gt; (Port to V7)</li> <li>Agustin Cruz &lt;openpyme.mx&gt; (BdM)</li> <li>Jacque-Etienne Baudoux &lt;<a class="reference external" href="mailto:je&#64;bcim.be">je&#64;bcim.be</a>&gt;</li> <li>Juan Jose Scarafia &lt;<a class="reference external" href="mailto:jjscarafia&#64;paintballrosario.com.ar">jjscarafia&#64;paintballrosario.com.ar</a>&gt;</li> <li>Mathieu Benoi &lt;<a class="reference external" href="mailto:mathben963&#64;gmail.com">mathben963&#64;gmail.com</a>&gt;</li> <li>Fekete Mihai &lt;<a class="reference external" href="mailto:feketemihai&#64;gmail.com">feketemihai&#64;gmail.com</a>&gt; (Port to V8)</li> <li>Dorin Hongu &lt;<a class="reference external" href="mailto:dhongu&#64;gmail.com">dhongu&#64;gmail.com</a>&gt; (BNR)</li> <li>Paul McDermott</li> <li>Alexis de Lattre &lt;<a class="reference external" href="mailto:alexis&#64;via.ecp.fr">alexis&#64;via.ecp.fr</a>&gt;</li> <li>Miku Laitinen</li> <li>Assem Bayahi</li> <li>Daniel Dico &lt;<a class="reference external" href="mailto:ddico&#64;oerp.ca">ddico&#64;oerp.ca</a>&gt; (BOC)</li> <li>Dmytro Katyukha &lt;<a class="reference external" href="mailto:firemage.dima&#64;gmail.com">firemage.dima&#64;gmail.com</a>&gt;</li> <li>Jesús Ventosinos Mayor &lt;<a class="reference external" href="mailto:jesus&#64;comunitea.com">jesus&#64;comunitea.com</a>&gt;</li> <li>Rodolfo Bermúdez Neubauer (<a class="reference external" href="mailto:rbermudez&#64;intellego-bi.com">rbermudez&#64;intellego-bi.com</a>)</li> </ul> <a name="maintainer"></a> <h4>Maintainer</h4> <a class="reference external image-reference" href="https://odoo-community.org"><img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" /></a> <p>The original <em>&quot;Currency Rate Update&quot;</em> module is maintained by the OCA. To contribute to the original module, please visit <a class="reference external" href="https://odoo-community.org">https://odoo-community.org</a>. 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.</p> <p>This is a fork of that model <strong>excusively for Chilean specific currency rates</strong> using the SBIF API. Chilean version developed and maintaind by Intellego-BI.com (Santiago, Chile).</p> <a class="reference external image-reference" href="https://intellego-bi.com"><img alt="Intellego-BI.com (Chile)" src="https://i2.wp.com/intellego-bi.com/ws/wp-content/uploads/2016/05/Intellego-BI-112x35.jpg" /></a> <p>Intellego-BI.com is a private consultancy based in Santiago, Chile.</p> <p>Sharing is caring!</p>