Metadata-Version: 2.1
Name: odoo-addon-pos_payment_method_cashdro
Version: 18.0.1.0.1
Requires-Python: >=3.10
Requires-Dist: odoo==18.0.*
Summary: Allows to pay with CashDro Terminals on the Point of Sale
Home-page: https://github.com/OCA/pos
License: AGPL-3
Author: Tecnativa, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 18.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Description-Content-Type: text/x-rst

.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

==========================
PoS Payment Method CashDro
==========================

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:f15a0167b57fe8cf8a3cb61c33b1f9731c54ab8f613e8ccc572773550c949c32
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
    :target: https://odoo-community.org/page/development-status
    :alt: Beta
.. |badge2| image:: https://img.shields.io/badge/license-AGPL--3-blue.png
    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
    :alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fpos-lightgray.png?logo=github
    :target: https://github.com/OCA/pos/tree/18.0/pos_payment_method_cashdro
    :alt: OCA/pos
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/pos-18-0/pos-18-0-pos_payment_method_cashdro
    :alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
    :target: https://runboat.odoo-community.org/builds?repo=OCA/pos&target_branch=18.0
    :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

This module allows to make payments with a Cashdro
(https://www.cashdro.com) terminal on the Point of Sale frontend.

**Table of contents**

.. contents::
   :local:

Configuration
=============

To add a Cashdro payment terminal:

1. Go to *Point of Sale > Configuration > Payment Methods*
2. Choose a cash payment method or create a new one.
3. Select *Cashdro* in the *Use a Payment Terminal* field.
4. Configure the Cashdro terminal hostname and credentials.
5. Configure the desired, Cashdro terminal in the proper PoS
   configurations.

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.

Usage
=====

With the proper configuration made:

1. Make a new PoS order and choose the cash payment method configured
   with the Cashdro settings.
2. Click on *Send* to send the request to the Cashdro terminal that will
   ask the customer for the amount to pay.
3. The cashier can cancel the amount request discarding the line
   clicking on the (x) symbol.
4. When the customer pays the sale amount in the terminal, the Cashdro
   reports the amount received and change delivered back.
5. The Point of Sale reflects it in the payment line and thus the order
   can be validated now.

Known issues / Roadmap
======================

- Integrate cash control (money inputs / outputs).
- This module should be evaluated during the migration to 19.0, since
  Odoo has integrated similar functionality into the core (pos_cashdro
  addon). It may no longer be necessary to maintain this module
  separately, and deprecation or consolidation should be considered.
  https://github.com/odoo/odoo/tree/19.0/addons/pos_cashdro

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/pos/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/pos/issues/new?body=module:%20pos_payment_method_cashdro%0Aversion:%2018.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Do not contact contributors directly about support or help with technical issues.

Credits
=======

Authors
-------

* Tecnativa

Contributors
------------

- `Acysos S.L. <https://www.acysos.com>`__:

  - Ignacio Ibeas

- `Tecnativa <https://www.tecnativa.com>`__

  - David Vidal
  - Eduardo Ezerouali

- `ACSONE SA/NV <https://acsone.eu>`__:

  - Bejaoui Souheil

Maintainers
-----------

This module is maintained by the OCA.

.. image:: https://odoo-community.org/logo.png
   :alt: Odoo Community Association
   :target: https://odoo-community.org

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.

This module is part of the `OCA/pos <https://github.com/OCA/pos/tree/18.0/pos_payment_method_cashdro>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
