<h1 class="title">Account Cryptocurrency</h1> <p><a class="reference external" href="https://odoo-community.org/page/development-status"><img alt="Beta" src="https://img.shields.io/badge/maturity-Beta-yellow.png" /></a> <a class="reference external" 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.png" /></a> <a class="reference external" href="https://github.com/OCA/currency/tree/12.0/account_cryptocurrency"><img alt="OCA/currency" src="https://img.shields.io/badge/github-OCA%2Fcurrency-lightgray.png?logo=github" /></a> <a class="reference external" href="https://translation.odoo-community.org/projects/currency-12-0/currency-12-0-account_cryptocurrency"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external" href="https://runbot.odoo-community.org/runbot/259/12.0"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p> <p>This module provides basic support for the management of cryptocurrencies.</p> <ol class="arabic simple"> <li>Cryptocurrencies are commonly considered property from a taxation standpoint.</li> <li>This means that every time that you receive or send cryptocurrencies, you are entering into a taxable transaction, and will need to report on the gain/loss resulting from the receipt/issue of the cryptocurrency.</li> <li>When you receive cryptocurrencies (in exchange for goods delivered, service rendered or because you mined it), that translates into taxable income to the recipient. The valuation should be based on the market value of the cryptocurrency at the time of receipt, and it can be provided by a third party (e.g. the exchange platform) or needs to be identified by you somehow.</li> <li>You have to retain the cost of the crytptocurrency for as long as you keep it.</li> <li>When you pay out cryptocurrencies (in exchange for goods or services purchased, or if you exchanged fpr another crypto or normal currency) this constitutes again a taxable transaction. In that case the gain/loss is computed as the difference between the cost of the cryptocurrency that you pay with, and the value of what you receive back, valued in your operating normal currency.</li> </ol> <p><strong>Table of contents</strong></p> <div class="contents local topic" id="contents"> <ul class="simple"> <li><a class="reference internal" href="#configuration" id="id1">Configuration</a></li> <li><a class="reference internal" href="#usage" id="id2">Usage</a></li> <li><a class="reference internal" href="#bug-tracker" id="id3">Bug Tracker</a></li> <li><a class="reference internal" href="#credits" id="id4">Credits</a><ul> <li><a class="reference internal" href="#authors" id="id5">Authors</a></li> <li><a class="reference internal" href="#contributors" id="id6">Contributors</a></li> <li><a class="reference internal" href="#maintainers" id="id7">Maintainers</a></li> </ul> </li> </ul> </div> <a name="configuration"></a> <h2><a class="toc-backref" href="#id1">Configuration</a></h2> <ol class="arabic simple"> <li>For the user that will do the configuration, make sure to activate the option 'Show Full Accounting Features' in the user profile.</li> <li>Activate the Multi-Currency in 'Invoicing / Configuration / Settings / Multi-Currencies.</li> <li>Create the cryptocurrency in 'Invoicing / Configuration / Accounting / Currencies'. Complete the following fields: 'Inventoried', 'Valuation Method'. Indicate the desired rounding factor.</li> <li>Add to the cryptocurrency an 'Inventory Account'. This Account must indicate in field 'Account Currency' the same currency.</li> <li>Create an Account Journal associated to the payments of the crypto currency, in 'Invoicing / Configuration / Accounting / Journals'. Indicate in the 'Currency' field the cryptocurrency. In the 'Default Credit Account' and 'Default Debit Account' you should indicate a new Account of type 'Expenses', with a name similar to 'Cryptocurrency X Gain/Loss'. The new Account must also refer to the cryptocurrency account.</li> </ol> <p>Additional remarks:</p> <blockquote> <ul class="simple"> <li>In case that your company currency is not EUR, make sure that the main company currency has no exchange rates. Go to 'Invoicing / Configuration / Accounting / Currencies' and for the company currency press the button 'Rates' and delete any rate listed.</li> <li>The maximum allowed decimal places associated to currencies has been increased to 18, that is what Ethereum cryptocurrency accepts as the maximum divisibility.</li> </ul> </blockquote> <a name="usage"></a> <h2><a class="toc-backref" href="#id2">Usage</a></h2> <ul class="simple"> <li>If you have negotiated your invoices with customers / suppliers using crypto currencies, you can indicate them in the corresponding invoice.</li> <li>When you receive/send payments you can indicate the cryptocurrency that you want to use for the payment. Once the payment has been posted you will be able to navigate to the associated currency moves.</li> <li>You cannot make internal transfers using cryptocurrencies.</li> </ul> <a name="bug-tracker"></a> <h2><a class="toc-backref" href="#id3">Bug Tracker</a></h2> <p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/currency/issues">GitHub Issues</a>. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us smashing it by providing a detailed and welcomed <a class="reference external" href="https://github.com/OCA/currency/issues/new?body=module:%20account_cryptocurrency%0Aversion:%2012.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p> <p>Do not contact contributors directly about support or help with technical issues.</p> <a name="credits"></a> <h2><a class="toc-backref" href="#id4">Credits</a></h2> <a name="authors"></a> <h3><a class="toc-backref" href="#id5">Authors</a></h3> <ul class="simple"> <li>Eficent</li> </ul> <a name="contributors"></a> <h3><a class="toc-backref" href="#id6">Contributors</a></h3> <ul class="simple"> <li>Jordi Ballester &lt;<a class="reference external" href="mailto:jordi.ballester&#64;eficent.com">jordi.ballester&#64;eficent.com</a>&gt;</li> </ul> <a name="maintainers"></a> <h3><a class="toc-backref" href="#id7">Maintainers</a></h3> <p>This module is maintained by the OCA.</p> <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>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 module is part of the <a class="reference external" href="https://github.com/OCA/currency/tree/12.0/account_cryptocurrency">OCA/currency</a> project on GitHub.</p> <p>You are welcome to contribute. To learn how please visit <a class="reference external" href="https://odoo-community.org/page/Contribute">https://odoo-community.org/page/Contribute</a>.</p>