Author: |
Tecnativa, Odoo Community Association (OCA) |
License: |
AGPL-3 |
Branch: |
14.0 |
Repository: |
acsone/pos |
Dependencies: |
point_of_sale |
Languages: |
HTML (383, 53.7%),
JavaScript (147, 20.6%),
Python (47, 6.6%),
XML (39, 5.5%),
and
reStructuredText (97, 13.6%) |
Other branches: |
12.0 |
Other repositories: |
Callino/pos,
Change2improve/pos,
ERPLibre/pos,
LevelPrime/pos,
NeatNerdPrime/pos,
OCA/pos,
Studio73/pos,
Tecnativa/pos,
akretion/pos,
aurestic/pos,
camptocamp/pos,
coopiteasy/pos,
eLBati/pos,
kmee/pos,
legalsylvain/pos,
marionumza/pos,
sunflowerit/pos,
takobi-online/pos,
tegin/pos,
and
wahello/oca-pos |
<h1 class="title">PoS Payment Method CashDro</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/pos/tree/14.0/pos_payment_method_cashdro"><img alt="OCA/pos" src="https://img.shields.io/badge/github-OCA%2Fpos-lightgray.png?logo=github" /></a> <a class="reference external" href="https://translation.odoo-community.org/projects/pos-14-0/pos-14-0-pos_payment_method_cashdro"><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/184/14.0"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p>
<p>This module allows to make payments with a Cashdro (<a class="reference external" href="https://www.cashdro.com">https://www.cashdro.com</a>) terminal
on the Point of Sale frontend.</p>
<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="#known-issues-roadmap" id="id3">Known issues / Roadmap</a></li>
<li><a class="reference internal" href="#bug-tracker" id="id4">Bug Tracker</a></li>
<li><a class="reference internal" href="#credits" id="id5">Credits</a><ul>
<li><a class="reference internal" href="#authors" id="id6">Authors</a></li>
<li><a class="reference internal" href="#contributors" id="id7">Contributors</a></li>
<li><a class="reference internal" href="#maintainers" id="id8">Maintainers</a></li>
</ul>
</li>
</ul>
</div>
<a name="configuration"></a>
<h2><a class="toc-backref" href="#id1">Configuration</a></h2>
<p>To add a Cashdro payment terminal:</p>
<ol class="arabic simple">
<li>Go to <em>Point of Sale > Configuration > Payment Methods</em></li>
<li>Choose a cash payment method or create a new one.</li>
<li>Select <em>Cashdro</em> in the <em>Use a Payment Terminal</em> field.</li>
<li>Configure the Cashdro terminal hostname and credentials.</li>
<li>Configure the desired, Cashdro terminal in the proper PoS configurations.</li>
</ol>
<p>Note that if a single payment method was used for cash in different stores, it should
be splitted in as many phisical stores there are.</p>
<a name="usage"></a>
<h2><a class="toc-backref" href="#id2">Usage</a></h2>
<p>With the proper configuration made:</p>
<ol class="arabic simple">
<li>Make a new PoS order and choose the cash payment method configured with the Cashdro
settings.</li>
<li>Click on <em>Send</em> to send the request to the Cashdro terminal that will ask the
customer for the amount to pay.</li>
<li>The cashier can cancel the amount request discarding the line clicking on the (x)
symbol.</li>
<li>When the customer pays the sale amount in the terminal, the Cashdro reports the
amount received and change delivered back.</li>
<li>The Point of Sale reflects it in the payment line and thus the order can be validated
now.</li>
</ol>
<a name="known-issues-roadmap"></a>
<h2><a class="toc-backref" href="#id3">Known issues / Roadmap</a></h2>
<ul class="simple">
<li>Cashdro terminals are designed to communicate in the local network, so they can't
receive or transmit any request to a remote Odoo server. So in order to implement
further features, la cash control or cash ins/outs it would be necessary to either:<ul>
<li>Prepare the Cashdro terminal for a remote use (VPN, dns, etc.) and implement the
corresponding backend methods.</li>
<li>Develope PoS frontend modules that allow to perform such operations and extend this
one making use of them.</li>
</ul>
</li>
</ul>
<a name="bug-tracker"></a>
<h2><a class="toc-backref" href="#id4">Bug Tracker</a></h2>
<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/pos/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/pos/issues/new?body=module:%20pos_payment_method_cashdro%0Aversion:%2014.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="#id5">Credits</a></h2>
<a name="authors"></a>
<h3><a class="toc-backref" href="#id6">Authors</a></h3>
<ul class="simple">
<li>Tecnativa</li>
</ul>
<a name="contributors"></a>
<h3><a class="toc-backref" href="#id7">Contributors</a></h3>
<ul class="simple">
<li><a class="reference external" href="https://www.acysos.com">Acysos S.L.</a>:<ul>
<li>Ignacio Ibeas</li>
</ul>
</li>
<li><a class="reference external" href="https://www.tecnativa.com">Tecnativa</a><ul>
<li>David Vidal</li>
</ul>
</li>
</ul>
<a name="maintainers"></a>
<h3><a class="toc-backref" href="#id8">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/pos/tree/14.0/pos_payment_method_cashdro">OCA/pos</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>