[16.0][MIG] pos_picking_load: Migration to 16.0

pos_picking_load/README.rst

@@ -0,0 +1,231 @@
+============================
+Point Of Sale - Picking Load
+============================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:f611363ccf5abedf323385e889a842a9338fc5a6f55cec96ea24959a9a87bcb2
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |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_picking_load
+    :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_picking_load
+    :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 extends the functionality of point of sale to allow you to
+load your pickings in the Point of Sale, in order to add / remove products
+and so create a PoS Order and mark it as paid.
+
+**Detailled Use Case**
+
+This module is usefull for the following use case
+
+* You have many Sale Orders that have generated pickings. Typically if you have
+  connected your Odoo instance to an online store like Shop Invader,
+  Prestashop, Magento, or if you use light Odoo shop (``website_sale``
+  module).
+* Once the order validated, you prepare your pickings
+* The customer come in your shop to recover his order
+* the customer add (or remove) some products
+* the customer pay his order, based on the real delivered products list
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Configuration
+=============
+
+To configure this module, you need to:
+
+#. Go to Warehouse / Configuration / Types of Operation
+#. Select the picking type(s) you want to see in the point of sale
+#. Check the box 'Available in Point of Sale'
+
+.. figure:: https://raw.githubusercontent.com/OCA/pos/16.0/pos_picking_load/static/description/stock_picking_type_form.png
+   :width: 800 px
+
+Note: This box is NOT enabled by default except in demo data for the type
+'Delivery Orders' of the demo company 'YourCompany'.
+
+#. Go to Point of Sale / Configuration / Point of Sales
+#. Select the Point(s) of Sales witch those you want to enable the feature
+#. Check the box 'Load Pickings'
+#. Set the max quantity of pickings you want to load
+
+.. figure:: https://raw.githubusercontent.com/OCA/pos/16.0/pos_picking_load/static/description/pos_config_form.png
+   :width: 800 px
+
+Note: This box is enabled by default
+
+**Technical Notes**
+
+* By default, the Point of Sale will display only the pickings if the state is
+  in  'Waiting Availability', 'Partially Available' or 'Ready to Transfer'.
+
+You can change this filter by overloading the ``_prepare_filter_for_pos``
+function of the model ``stock.picking``.
+
+* By default, the search of pickings will be done on the fields ``name``,
+  ``origin`` and ``partner_id`` of the picking.
+
+You can change this feature by overloading the
+``_prepare_filter_query_for_pos`` function of the model ``stock.picking``.
+
+* By default, when the PoS order is confirmed, the original picking is
+  cancelled and the sale order is set to the state 'Done'.
+
+You can change this behaviour by overloading
+``_handle_orders_with_original_picking`` function of the model ``pos.order``.
+
+Usage
+=====
+
+To use this module, you need to:
+
+* Launch the point of sale
+* On a new order (without lines), click on the 'Load Picking' button.
+
+.. figure:: https://raw.githubusercontent.com/OCA/pos/16.0/pos_picking_load/static/description/load_picking_01_load_button.png
+   :width: 800 px
+
+* Point of sale will load available pickings. (About displayed pickings, see
+  'Technical Notes' section).
+
+.. figure:: https://raw.githubusercontent.com/OCA/pos/16.0/pos_picking_load/static/description/load_picking_02_picking_list.png
+   :width: 800 px
+
+* Click on a picking will check if the picking is loadable and if yes, will
+  display a 'Select' button. (See 'Possible Warnings' Section)
+
+.. figure:: https://raw.githubusercontent.com/OCA/pos/16.0/pos_picking_load/static/description/load_picking_03_confirm.png
+   :width: 800 px
+
+* Confirm the selection, by clicking on 'Select' button. It will display
+  the content of the moves (as PoS Order Lines)
+
+.. figure:: https://raw.githubusercontent.com/OCA/pos/16.0/pos_picking_load/static/description/load_picking_04_pos_order.png
+   :width: 800 px
+
+The price and the discount will be the sale price and the discount set in
+the according Sale Order Line, if it was found. Otherwise, discount will be
+set to 0, and unit price will be the unit price of the product when it has been
+loaded in the Point of Sale.
+
+**Related Sale Order:**
+
+.. figure:: https://raw.githubusercontent.com/OCA/pos/16.0/pos_picking_load/static/description/load_picking_sale_order.png
+   :width: 800 px
+
+**Related Picking:**
+
+.. figure:: https://raw.githubusercontent.com/OCA/pos/16.0/pos_picking_load/static/description/load_picking_stock_picking.png
+   :width: 800 px
+
+
+* Finally, you can add / remove products or change quantity and collect the
+  payment.
+
+When, the order is marked as paid, the original picking will be cancelled,
+because Point Of Sale generates a new picking related to the real delivered
+products and the original Sale Order will pass to the state 'Done'. (Delivery
+exception is ignored).
+(See 'Technical Notes' section).
+
+**Possible Warnings**
+
+Some warning messages can appear:
+
+* if some products are not available in the Point of Sale
+
+.. figure:: https://raw.githubusercontent.com/OCA/pos/16.0/pos_picking_load/static/description/load_picking_warning_product.png
+   :width: 800 px
+
+* if the partner is not available in the Point of Sale
+
+.. figure:: https://raw.githubusercontent.com/OCA/pos/16.0/pos_picking_load/static/description/load_picking_warning_partner.png
+   :width: 800 px
+
+* if the picking has been still loaded in another PoS order
+
+.. figure:: https://raw.githubusercontent.com/OCA/pos/16.0/pos_picking_load/static/description/load_picking_warning_picking_still_loaded.png
+   :width: 800 px
+
+Known issues / Roadmap
+======================
+
+* This module will try to get original unit price from the sale order and not
+  use the Current unit price of the product.
+  (The price at which you pledged to sell the product).
+  Some VAT troubles will occure if a product is set with VAT marked as
+  'VAT included' and if in the sale order line, there are some VAT marked as
+  'VAT excluded' for exemple.
+
+**The VAT settings should be consistent.**
+
+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_picking_load%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)
+* Stefan Rijnhart <stefan@opener.am>
+* `Heliconia Solutions Pvt. Ltd. <https://www.heliconia.io>`_
+
+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_picking_load>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

pos_picking_load/__init__.py

@@ -0,0 +1,5 @@
+# Copyright (C) 2017 - 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).
+
+from . import models

pos_picking_load/__manifest__.py

@@ -0,0 +1,42 @@
+# Copyright (C) 2017 - 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 - Picking Load",
+    "summary": "Load and confirm stock pickings via Point Of Sale",
+    "version": "16.0.1.0.0",
+    "category": "Point Of Sale",
+    "author": "GRAP,Odoo Community Association (OCA)",
+    "website": "https://github.com/OCA/pos",
+    "license": "AGPL-3",
+    "maintainers": ["legalsylvain"],
+    "development_status": "Beta",
+    "depends": [
+        "sale_stock",
+        "point_of_sale",
+    ],
+    "data": [
+        "views/view_pos_config.xml",
+        "views/view_sale_order.xml",
+        "views/view_stock_picking.xml",
+        "views/view_stock_picking_type.xml",
+    ],
+    "assets": {
+        "point_of_sale.assets": [
+            "/pos_picking_load/static/src/css/pos_picking_load.css",
+            "/pos_picking_load/static/src/js/LoadPickingButtonWidget.js",
+            "/pos_picking_load/static/src/xml/LoadPickingButtonWidget.xml",
+            "/pos_picking_load/static/src/xml/screen/LoadPickingScreenWidget.xml",
+            "/pos_picking_load/static/src/xml/screen/PickingLoadControlPanel.xml",
+            "/pos_picking_load/static/src/xml/screen/PickingLoadList.xml",
+            "/pos_picking_load/static/src/xml/screen/PickingLoadRow.xml",
+            "/pos_picking_load/static/src/js/Screen/LoadPickingScreenWidget.js",
+            "/pos_picking_load/static/src/js/Screen/PickingLoadControlPanel.js",
+            "/pos_picking_load/static/src/js/Screen/PickingLoadFetcher.js",
+            "/pos_picking_load/static/src/js/Screen/PickingLoadList.js",
+            "/pos_picking_load/static/src/js/Screen/PickingLoadRow.js",
+            "/pos_picking_load/static/src/js/db.js",
+        ]
+    },
+    "installable": True,
+}

pos_picking_load/demo/product_template.xml

@@ -0,0 +1,31 @@
+<odoo>
+
+    <!-- for demo pickings created by this module -->
+
+    <record id="product.product_product_4_product_template" model="product.template">
+        <field name="available_in_pos" eval="True" />
+    </record>
+
+    <record id="product.product_product_7_product_template" model="product.template">
+        <field name="available_in_pos" eval="True" />
+    </record>
+
+    <record id="product.product_product_9_product_template" model="product.template">
+        <field name="available_in_pos" eval="True" />
+    </record>
+
+    <record id="product.product_product_24_product_template" model="product.template">
+        <field name="available_in_pos" eval="True" />
+    </record>
+
+    <!-- For demo pickings created before the installation of this module -->
+
+    <record id="product.product_product_27_product_template" model="product.template">
+        <field name="available_in_pos" eval="True" />
+    </record>
+
+    <record id="product.product_product_6_product_template" model="product.template">
+        <field name="available_in_pos" eval="True" />
+    </record>
+
+</odoo>

pos_picking_load/demo/res_groups.xml

@@ -0,0 +1,7 @@
+<odoo>
+
+    <record id="sale.group_discount_per_so_line" model="res.groups">
+        <field name="users" eval="[(4, ref('base.user_admin'))]" />
+    </record>
+
+</odoo>

pos_picking_load/demo/res_partner.xml

@@ -0,0 +1,10 @@
+<odoo>
+
+    <!-- Fix Odoo Demo data:
+    Picking WH/OUT/0008 is associated to a customer 'Wood Corner'
+    that is not flagged as a customer -->
+    <record id="base.res_partner_1" model="res.partner">
+        <field name="customer" eval="True" />
+    </record>
+
+</odoo>

pos_picking_load/demo/sale_order.xml

@@ -0,0 +1,53 @@
+<odoo>
+
+    <!-- Sale Order 1-->
+    <record id="sale_order_1" model="sale.order">
+        <field name="partner_id" ref="base.res_partner_2" />
+        <!-- <field name="order_policy">picking</field> -->
+    </record>
+
+    <record id="sale_order_line_11" model="sale.order.line">
+        <field name="order_id" ref="sale_order_1" />
+        <field name="product_id" ref="product.product_product_7" />
+        <field name="product_uom_qty">5</field>
+        <field name="price_unit">100</field>
+        <field name="discount">20</field>
+    </record>
+
+    <record id="sale_order_line_12" model="sale.order.line">
+        <field name="order_id" ref="sale_order_1" />
+        <field name="product_id" ref="product.product_product_9" />
+        <field name="product_uom_qty">3</field>
+    </record>
+
+    <function model="sale.order" name="action_confirm" eval="[[ref('sale_order_1')]]" />
+
+    <!-- Sale Order 2-->
+    <record id="sale_order_2" model="sale.order">
+        <field name="partner_id" ref="base.res_partner_18" />
+        <!-- <field name="order_policy">picking</field> -->
+    </record>
+
+    <record id="sale_order_line_21" model="sale.order.line">
+        <field name="order_id" ref="sale_order_2" />
+        <field name="product_id" ref="product.product_product_7" />
+        <field name="product_uom_qty">15</field>
+        <field name="discount">10</field>
+    </record>
+
+    <record id="sale_order_line_22" model="sale.order.line">
+        <field name="order_id" ref="sale_order_2" />
+        <field name="product_id" ref="product.product_product_4" />
+        <field name="product_uom_qty">1</field>
+    </record>
+
+    <record id="sale_order_line_23" model="sale.order.line">
+        <field name="order_id" ref="sale_order_2" />
+        <field name="product_id" ref="product.product_product_24" />
+        <field name="product_uom_qty">3</field>
+        <field name="price_unit">555</field>
+    </record>
+
+    <function model="sale.order" name="action_confirm" eval="[[ref('sale_order_2')]]" />
+
+</odoo>

pos_picking_load/demo/stock_picking_type.xml

@@ -0,0 +1,7 @@
+<odoo>
+
+    <record id="stock.picking_type_out" model="stock.picking.type">
+        <field name="available_in_pos" eval="True" />
+    </record>
+
+</odoo>