Author: |
Akretion, Nicolas JEUDY, Odoo Community Association (OCA) |
License: |
AGPL-3 |
Branch: |
12.0 |
Repository: |
ScopeaFrance/odoo-mooncard-connector |
Dependencies: |
base_business_document_import,
and
decimal_precision |
Languages: |
Python (726, 54.2%),
XML (573, 42.8%),
and
reStructuredText (40, 3.0%) |
Other branches: |
10.0,
11.0,
and
8.0 |
Other repositories: |
RL-OtherApps/odoo-mooncard-connector,
akretion/odoo-mooncard-connector,
alecvinent/odoo-mooncard-connector,
kryskool/odoo-mooncard-connector,
mga-team-odoo/odoo-mooncard-connector,
njeudy/odoo-mooncard-connector,
sc4you/odoo-mooncard-connector,
simmatica/odoo-mooncard-connector,
vidtsin/odoo-mooncard-connector,
and
westlyou/odoo-mooncard-connector |
<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="mooncard-base"></a>
<h2>Mooncard Base</h2>
<p>This is the base module of the Odoo-Mooncard connector. <a class="reference external" href="http://www.mooncard.co/">Mooncard</a> is a new-generation corporate card that propose:</p>
<ul class="simple">
<li>instant notification of each card payment on your mobile phone,</li>
<li>easy and fast recording of your card expenses from your mobile phone.</li>
</ul>
<p>Mooncard is only available in France for the moment, but it will be extended to other countries in the future.</p>
<p>This module doesn't do anything useful by itself. It must be used together with:</p>
<ul class="simple">
<li>the module <em>mooncard_invoice</em> if the Mooncard is attached to the bank account of the company,</li>
<li>the module <em>mooncard_expense</em> (to be developped) if the Mooncard is attached to the private bank account of the employee.</li>
</ul>
<a name="installation"></a>
<h3>Installation</h3>
<p>To install this module, you need some additional Python librairies:</p>
<pre class="code">
<code class="code">sudo pip install pycountry
sudo pip install unicodecsv</code>
</pre>
<p>Note: you should not use the Debian/Ubuntu package <em>python-pycountry</em> because, as of Ubuntu 16.04, the version is too old and has a slightly different API than the latest version of <a class="reference external" href="https://pypi.python.org/pypi/pycountry/">pycountry on Pypi</a> (and we are using the latest version of the API of pycountry in this module).</p>
<a name="configuration"></a>
<h3>Configuration</h3>
<p>The Mooncard products have been configured with a generic supplier <em>Mooncard Misc Suppliers</em> and a special <em>Supplier Product Code</em>: don't change those parameters!</p>
<p>In the menu <em>Accounting > Configuration > Miscellaneous > Moon Cards</em>, you must create your Moon Cards, one for each of your Mooncards.</p>
<p>In the Mooncard Web interface <a class="reference external" href="https://app.mooncard.co/">app.mooncard.co</a>, go to <em>Paramètres > Natures de dépense</em> and update the column <em>Compte de charge</em> so that it matches exactly the account codes that you have in Odoo.</p>
<a name="usage"></a>
<h3>Usage</h3>
<p>Go to the menu <em>Accounting > Mooncard > Mooncard Import</em> and upload the CSV file that you downloaded from your <a class="reference external" href="https://app.mooncard.co/">Mooncard account</a> under <em>Comptes > Relevés et soldes > Exporter > Odoo</em>:</p>
<ul class="simple">
<li>Odoo will create the new Mooncard transactions,</li>
<li>Odoo will update the existing Mooncard transactions that are still in draft.</li>
</ul>
<p>For mileage expenses, use the same Odoo menu and upload the CSV file that you downloaded from your <a class="reference external" href="https://app.mooncard.co/">Mooncard account</a> under <em>Dépenses > Frais kilométriques > Exporter</em>.</p>
<a name="roadmap"></a>
<h3>Roadmap</h3>
<ul class="simple">
<li>When the Mooncard webservices will be available, the module will be updated: the mooncard transactions will be automatically downloaded.</li>
</ul>
<a name="bug-tracker"></a>
<h3>Bug Tracker</h3>
<p>Bugs are tracked on <a class="reference external" href="https://github.com/akretion/odoo-mooncard-connector/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 feedback.</p>
<a name="credits"></a>
<h3 class="with-subtitle">Credits</h3>
<h3 class="section-subtitle" id="contributors"><span class="section-subtitle">Contributors</span></h3>
<ul class="simple">
<li>Alexis de Lattre <<a class="reference external" href="mailto:alexis.delattre@akretion.com">alexis.delattre@akretion.com</a>></li>
<li>Nicolas JEUDY <<a class="reference external" href="https://github.com/njeudy">https://github.com/njeudy</a>></li>
</ul>