[17.0][MIG] pos_payment_change

pos_payment_change/README.rst

@@ -0,0 +1,154 @@
+===============================
+Point Of Sale - Change Payments
+===============================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:1c6e8c040d05dda8166904f53fc0ab8ba31c3e0fc1d9c158284f6dbd75c966c4
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |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/17.0/pos_payment_change
+    :alt: OCA/pos
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+    :target: https://translation.odoo-community.org/projects/pos-17-0/pos-17-0-pos_payment_change
+    :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=17.0
+    :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+This module extends the functionnality of the Odoo Point of Sale to
+allow the cashier to change the payments of a PoS order.
+
+This feature is usefull when the user realized that he did a mistake,
+just after he marked the order as paid, or during the close of the
+session, Only if entries has not been generated.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Configuration
+=============
+
+-  Go to Point of Sale.
+-  Choose the view list.
+-  Edit your point of sale, and select a value for the field 'Payment
+   Change Policy'.
+
+Two options are available:
+
+-  'Refund and Resale': Odoo will refund the current Pos Order to cancel
+   it, and create a new PoS Order with the correct payment lines
+-  'Update Payments': Odoo will change payment lines.
+
+|image1|
+
+**Note** In some countries the 'Update Payments' Option is not allowed
+by law, because orders history shouldn't not be altered.
+
+For that purpose, a constrains is present to check the value of this
+field. If the module ``l10n_fr_certification`` is installed and if the
+current company has an inalterable accounting, it will not be possible
+to select the value 'Update Payments'.
+
+.. |image1| image:: https://raw.githubusercontent.com/OCA/pos/17.0/pos_payment_change/static/description/pos_config_form.png
+
+Usage
+=====
+
+-  Go to a PoS Order
+-  Click on the button 'Change Payments'
+
+|image1|
+
+-  In the pop up wizard, select the real payment(s) that have been used
+   to pay the order
+
+|image2|
+
+-  Then click on the button 'Change Payments'
+
+**Note**
+
+If the option 'Refund and Resale' is selected, changing the payments
+will display the three PoS orders. the oringal one, the refund one, and
+the new one.
+
+|image3|
+
+.. |image1| image:: https://raw.githubusercontent.com/OCA/pos/17.0/pos_payment_change/static/description/pos_order_form.png
+.. |image2| image:: https://raw.githubusercontent.com/OCA/pos/17.0/pos_payment_change/static/description/pos_payment_change_wizard_form.png
+.. |image3| image:: https://raw.githubusercontent.com/OCA/pos/17.0/pos_payment_change/static/description/pos_order_tree.png
+
+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_change%0Aversion:%2017.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>
+-  Julien WESTE
+-  Foram Shah <[email protected]>
+-  Manuel Regidor <[email protected]>
+
+Other credits
+-------------
+
+The development of this module has been financially supported by:
+
+-  GRAP, Groupement Régional Alimentaire de proximité
+   (`www.grap.coop <http://www.grap.coop>`__)
+-  Vracoop (`www.vracoop.fr <http://www.vracoop.fr>`__)
+
+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/17.0/pos_payment_change>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

pos_payment_change/__init__.py

@@ -0,0 +1,2 @@
+from . import models
+from . import wizards

pos_payment_change/__manifest__.py

@@ -0,0 +1,23 @@
+# Copyright (C) 2013 - Today: GRAP (http://www.grap.coop)
+# @author: Sylvain LE GAL (https://twitter.com/legalsylvain)
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
+{
+    "name": "Point Of Sale - Change Payments",
+    "version": "17.0.1.0.0",
+    "summary": "Allow cashier to change order payments, as long as"
+    " the session is not closed.",
+    "category": "Point Of Sale",
+    "author": "GRAP, Odoo Community Association (OCA)",
+    "website": "https://github.com/OCA/pos",
+    "license": "AGPL-3",
+    "depends": ["point_of_sale"],
+    "maintainers": ["legalsylvain"],
+    "development_status": "Beta",
+    "data": [
+        "security/ir.model.access.csv",
+        "wizards/view_pos_payment_change_wizard.xml",
+        "views/view_pos_config.xml",
+        "views/view_pos_order.xml",
+    ],
+    "installable": True,
+}