=========================
PoS Order - Change Policy
=========================

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

.. |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/licence-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/16.0/pos_payment_method_change_policy
    :alt: OCA/pos
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/pos-16-0/pos-16-0-pos_payment_method_change_policy
    :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=16.0
    :alt: Try me on Runboat

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

This module improves the 'Change' feature in Odoo Point of Sale,
when a customer pays more that the amount of the PoS Order:

.. figure:: https://raw.githubusercontent.com/OCA/pos/16.0/pos_payment_method_change_policy/static/description/cash_1_payment_screen.png

By default, a "Change" line is added on the receipt:

.. figure:: https://raw.githubusercontent.com/OCA/pos/16.0/pos_payment_method_change_policy/static/description/cash_2_bill.png

from an accounting point of view, it adds a second payment line in 'Cash' method
with a negative amount corresponding to the surplus:

.. figure:: https://raw.githubusercontent.com/OCA/pos/16.0/pos_payment_method_change_policy/static/description/cash_3_back_office.png

In some countries and for some payment methods, this is not the right way to proceed.

This module adds extra "Change Policy" option to manage differently the giving of change.

**Table of contents**

.. contents::
   :local:

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

**Exceptional Profit Product**

* Create a dedicated 'No change' Product.
  The type of the product should be 'Service' and the product should available in PoS.
  Generally, no VAT is applied on such product.

* Go to the payment method form.

* set 'Change Option' as 'Exceptional Profit Product'

* set the new product in the 'Change Product field'

.. figure:: https://raw.githubusercontent.com/OCA/pos/16.0/pos_payment_method_change_policy/static/description/payment_screen_profit_policy.png

Usage
=====

**Exceptional Profit Product**

A dedicated warning will be displayed:

.. figure:: https://raw.githubusercontent.com/OCA/pos/16.0/pos_payment_method_change_policy/static/description/profit_policy_1_payment_screen.png

By default, a new sale order line is added on the receipt:

.. figure:: https://raw.githubusercontent.com/OCA/pos/16.0/pos_payment_method_change_policy/static/description/profit_policy_2_bill.png

So, from an accounting point of view, it adds a new line that will
impact a profit and loss account:

.. figure:: https://raw.githubusercontent.com/OCA/pos/16.0/pos_payment_method_change_policy/static/description/profit_policy_3_back_office.png

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

* Implement the ability to print a voucher.

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_change_policy%0Aversion:%2016.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
~~~~~~~

* GRAP

Contributors
~~~~~~~~~~~~

* Sylvain LE GAL (https://twitter.com/legalsylvain)

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.

.. |maintainer-legalsylvain| image:: https://github.com/legalsylvain.png?size=40px
    :target: https://github.com/legalsylvain
    :alt: legalsylvain

Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:

|maintainer-legalsylvain| 

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

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