odoo-addon-shopfloor 16.0.1.0.0.24__py3-none-any.whl

odoo/addons/shopfloor/README.rst

@@ -0,0 +1,160 @@
+=========
+Shopfloor
+=========
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:993547f893f6715d97989e36897fae01ba59faacf8a2a9f66f202d3130bba967
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |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%2Fwms-lightgray.png?logo=github
+    :target: https://github.com/OCA/wms/tree/16.0/shopfloor
+    :alt: OCA/wms
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+    :target: https://translation.odoo-community.org/projects/wms-16-0/wms-16-0-shopfloor
+    :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/wms&target_branch=16.0
+    :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+Shopfloor is a barcode scanner application for internal warehouse operations.
+
+The application supports scenarios, to relate to Operation Types:
+
+* Cluster Picking
+* Zone Picking
+* Checkout/Packing
+* Delivery
+* Location Content Transfer
+* Single Pack Transfer
+
+This module provides REST APIs to support the scenarios. It needs a frontend
+to consume the backend APIs and provide screens for users on barcode devices.
+A default front-end application is provided by ``shopfloor_mobile``.
+
+| Note: if you want to enable a new scenario on an existing application, you must trigger the registry sync on the shopfloor.app in a post_init_hook or a post-migrate script.
+| See an example `here <https://github.com/OCA/wms/pull/520/commits/bccdfd445a9bc943998c4848f183a076e8459a98>`_.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Usage
+=====
+
+An API key is created in the Demo data (for development), using
+the Demo user. The key to use in the HTTP header ``API-KEY`` is: 72B044F7AC780DAC
+
+Curl example::
+
+  curl -X POST "http://localhost:8069/shopfloor/user/menu" -H  "accept: */*" -H  "Content-Type: application/json" -H "API-KEY: 72B044F7AC780DAC"
+
+Known issues / Roadmap
+======================
+
+* improve documentation
+* split out scenario components to their own modules
+* maybe split common stock features to `shopfloor_stock_base`
+  and move scenario to `shopfloor_wms`?
+
+Changelog
+=========
+
+13.0.1.0.0
+~~~~~~~~~~
+
+First official version.
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OCA/wms/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/wms/issues/new?body=module:%20shopfloor%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
+~~~~~~~
+
+* Camptocamp
+* BCIM
+* Akretion
+
+Contributors
+~~~~~~~~~~~~
+
+* Guewen Baconnier <guewen.baconnier@camptocamp.com>
+* Simone Orsi <simahawk@gmail.com>
+* Sébastien Alix <sebastien.alix@camptocamp.com>
+* Alexandre Fayolle <alexandre.fayolle@camptocamp.com>
+* Benoit Guillot <benoit.guillot@akretion.com>
+* Thierry Ducrest <thierry.ducrest@camptocamp.com>
+* Raphaël Reverdy <raphael.reverdy@akretion.com>
+* Jacques-Etienne Baudoux <je@bcim.be>
+* Juan Miguel Sánchez Arce <juan.sanchez@camptocamp.com>
+* Michael Tietz (MT Software) <mtietz@mt-software.de>
+* Souheil Bejaoui <souheil.bejaoui@acsone.eu>
+* Laurent Mignon <laurent.mignon@acsone.eu>
+
+Design
+~~~~~~
+
+* Joël Grand-Guillaume <joel.grandguillaume@camptocamp.com>
+* Jacques-Etienne Baudoux <je@bcim.be>
+
+Other credits
+~~~~~~~~~~~~~
+
+**Financial support**
+
+* Cosanum
+* Camptocamp R&D
+* Akretion R&D
+
+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-guewen| image:: https://github.com/guewen.png?size=40px
+    :target: https://github.com/guewen
+    :alt: guewen
+.. |maintainer-simahawk| image:: https://github.com/simahawk.png?size=40px
+    :target: https://github.com/simahawk
+    :alt: simahawk
+.. |maintainer-sebalix| image:: https://github.com/sebalix.png?size=40px
+    :target: https://github.com/sebalix
+    :alt: sebalix
+
+Current `maintainers <https://odoo-community.org/page/maintainer-role>`__:
+
+|maintainer-guewen| |maintainer-simahawk| |maintainer-sebalix| 
+
+This module is part of the `OCA/wms <https://github.com/OCA/wms/tree/16.0/shopfloor>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

odoo/addons/shopfloor/__init__.py

@@ -0,0 +1,4 @@
+from . import models
+from . import actions
+from . import components
+from . import services

odoo/addons/shopfloor/__manifest__.py

@@ -0,0 +1,65 @@
+# Copyright 2020 Camptocamp SA (http://www.camptocamp.com)
+# Copyright 2020 Akretion (http://www.akretion.com)
+# Copyright 2020 BCIM
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
+
+{
+    "name": "Shopfloor",
+    "summary": "manage warehouse operations with barcode scanners",
+    "version": "16.0.1.0.0",
+    "development_status": "Beta",
+    "category": "Inventory",
+    "website": "https://github.com/OCA/wms",
+    "author": "Camptocamp, BCIM, Akretion, Odoo Community Association (OCA)",
+    "maintainers": ["guewen", "simahawk", "sebalix"],
+    "license": "AGPL-3",
+    "application": True,
+    "depends": [
+        "shopfloor_base",
+        "stock",
+        "stock_picking_batch",
+        "jsonifier",
+        "base_rest",
+        "base_sparse_field",
+        #  OCA / stock-logistics-warehouse
+        "stock_helper",
+        "stock_picking_completion_info",
+        #  OCA / stock-logistics-workflow
+        "stock_move_line_change_lot",
+        "stock_quant_package_dimension",
+        "stock_quant_package_product_packaging",
+        "stock_picking_progress",
+        # TODO: used for manuf info on prod detail.
+        # This must be an optional dep
+        "product_manufacturer",
+        # TODO: used for prod lot expire detail info.
+        # This must be an optional dep
+        "product_expiry",
+        # TODO: used for package.package_type_id detail info.
+        # This must be an optional dep
+        "stock_storage_type",
+        # TODO: used for picking.carrier_id detail info
+        # and to validate packaging/carrier in checkout scenario
+        # This must be an optional dep
+        "delivery",
+        #  OCA / product-attribute
+        "product_packaging_level",
+        #  OCA / delivery
+        "stock_picking_delivery_link",
+    ],
+    "data": [
+        "data/shopfloor_scenario_data.xml",
+        "security/groups.xml",
+        "views/shopfloor_menu.xml",
+        "views/stock_picking_type.xml",
+        "views/stock_location.xml",
+        "views/stock_move_line.xml",
+    ],
+    "demo": [
+        "demo/stock_picking_type_demo.xml",
+        "demo/shopfloor_profile_demo.xml",
+        "demo/shopfloor_menu_demo.xml",
+        "demo/shopfloor_app_demo.xml",
+    ],
+    "installable": True,
+}

odoo/addons/shopfloor/actions/__init__.py

@@ -0,0 +1,15 @@
+from . import change_package_lot
+from . import data
+from . import data_detail
+from . import schema
+from . import schema_detail
+from . import completion_info
+from . import location_content_transfer_sorter
+from . import message
+from . import search
+from . import inventory
+from . import savepoint
+from . import move_line_search
+from . import stock
+from . import stock_unreserve
+from . import packaging

odoo/addons/shopfloor/actions/change_package_lot.py

@@ -0,0 +1,164 @@
+# Copyright 2020 Camptocamp SA (http://www.camptocamp.com)
+# Copyright 2024 Jacques-Etienne Baudoux (BCIM) <je@bcim.be>
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
+from odoo import _, exceptions
+from odoo.exceptions import UserError
+from odoo.tools.float_utils import float_compare, float_is_zero
+
+from odoo.addons.component.core import Component
+
+
+class InventoryError(UserError):
+    pass
+
+
+class ChangePackageLot(Component):
+    """Provide methods for changing a package or a lot on a move line"""
+
+    _name = "shopfloor.change.package.lot.action"
+    _inherit = "shopfloor.process.action"
+    _usage = "change.package.lot"
+
+    def change_lot(self, move_line, lot, response_ok_func, response_error_func):
+        """Change the lot on the move line.
+
+        :param response_ok_func: callable used to return ok response
+        :param response_error_func: callable used to return error response
+        """
+        # If the lot is part of a package, what we really want
+        # is not to change the lot, but change the package (which will
+        # in turn change the lot altogether), but we have to pay attention
+        # to some things:
+        # * cannot replace a package by a lot without package (qty may be
+        #   different, ...)
+        # * if we have several packages for the same lot, we can't know which
+        #   one the operator is moving, ask to scan a package
+        lot_quants = self.env["stock.quant"].search(
+            [
+                ("lot_id", "=", lot.id),
+                ("location_id", "=", move_line.location_id.id),
+                ("quantity", ">", 0),
+            ]
+        )
+        package_quants = lot_quants.filtered(lambda quant: quant.package_id)
+        unit_quants = lot_quants - package_quants
+
+        if len(package_quants) > 1 or (package_quants and unit_quants):
+            # When we can't know which package to take, ask to scan a package.
+            # If we have both units and package, they have to scan the package
+            # first.
+            return response_error_func(
+                move_line,
+                message=self.msg_store.several_packs_in_location(move_line.location_id),
+            )
+        elif len(package_quants) == 1:
+            # change the package directly
+            package = package_quants.package_id
+            return self.change_package(
+                move_line, package, response_ok_func, response_error_func
+            )
+        return self._change_pack_lot_change_lot(
+            move_line, lot, response_ok_func, response_error_func
+        )
+
+    def _change_pack_lot_change_lot(
+        self, move_line, lot, response_ok_func, response_error_func
+    ):
+        previous_lot = move_line.lot_id
+        previous_reserved_uom_qty = move_line.reserved_uom_qty
+
+        inventory = self._actions_for("inventory")
+
+        try:
+            with self.env.cr.savepoint():
+                move_line.write(
+                    {
+                        "lot_id": lot.id,
+                        "package_id": False,
+                        "result_package_id": False,
+                    }
+                )
+                rounding = move_line.product_id.uom_id.rounding
+                if float_is_zero(
+                    move_line.reserved_uom_qty, precision_rounding=rounding
+                ):
+                    # The lot is not found at all, but the user scanned it, which means
+                    # it's an error in the stock data!
+                    raise InventoryError("Lot not available")
+        except InventoryError:
+            inventory.create_control_stock(
+                move_line.location_id,
+                move_line.product_id,
+                lot=lot,
+                name=_(
+                    "Pick: stock issue on lot: %(lot_name)s found in %(location_name)s",
+                    lot_name=lot.name,
+                    location_name=move_line.location_id.name,
+                ),
+            )
+            message = self.msg_store.cannot_change_lot_already_picked(lot)
+            return response_error_func(move_line, message=message)
+        except UserError as e:
+            message = {
+                "message_type": "error",
+                "body": str(e),
+            }
+            return response_error_func(move_line, message=message)
+
+        message = self.msg_store.lot_replaced_by_lot(previous_lot, lot)
+        if (
+            float_compare(
+                move_line.reserved_uom_qty,
+                previous_reserved_uom_qty,
+                precision_rounding=rounding,
+            )
+            != 0
+        ):
+            message["body"] += " " + _("The quantity to do has changed!")
+        return response_ok_func(move_line, message=message)
+
+    def _package_content_replacement_allowed(self, package, move_line):
+        # we can't replace by a package which doesn't contain the product...
+        return move_line.product_id in package.quant_ids.product_id
+
+    def change_package(self, move_line, package, response_ok_func, response_error_func):
+        # Prevent change if package is already set and it's the same
+        if move_line.package_id == package:
+            return response_error_func(
+                move_line,
+                message=self.msg_store.package_change_error_same_package(package),
+            )
+
+        # prevent to replace a package by a package that would not satisfy the
+        # move (different product)
+        content_replacement_allowed = self._package_content_replacement_allowed(
+            package, move_line
+        )
+        if not content_replacement_allowed:
+            return response_error_func(
+                move_line, message=self.msg_store.package_different_content(package)
+            )
+
+        previous_package = move_line.package_id
+
+        # /!\ be sure to box the side-effects before calling "replace_package"
+        # in the savepoint, as we catch the error, we must be sure that any
+        # change is rollbacked
+        try:
+            with self.env.cr.savepoint():
+                # if no quantity is available in the package, this call will
+                # raise a UserError, which will revert the savepoint
+                move_line.replace_package(package)
+        except exceptions.UserError as err:
+            return response_error_func(
+                move_line,
+                message=self.msg_store.package_change_error(package, err.args[0]),
+            )
+
+        if previous_package:
+            message = self.msg_store.package_replaced_by_package(
+                previous_package, package
+            )
+        else:
+            message = self.msg_store.units_replaced_by_package(package)
+        return response_ok_func(move_line, message=message)

odoo/addons/shopfloor/actions/completion_info.py

@@ -0,0 +1,42 @@
+# Copyright 2020 Camptocamp SA (http://www.camptocamp.com)
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
+from odoo import _
+
+from odoo.addons.component.core import Component
+
+
+class CompletionInfo(Component):
+    """Provide methods for completion info of pickings
+
+    They are based on the module "stock_picking_completion_info" from
+    OCA/stock-logistics-warehouse.
+    """
+
+    _name = "shopfloor.completion.info.action"
+    _inherit = "shopfloor.process.action"
+    _usage = "completion.info"
+
+    def popup(self, move_lines):
+        """Return a popup if move lines make chained pickings ready
+
+        Return None in case no popup should be displayed.
+        """
+        pickings = move_lines.mapped("picking_id").filtered(
+            lambda p: p.picking_type_id.display_completion_info
+            and p.completion_info == "next_picking_ready"
+        )
+        if not pickings:
+            return None
+        next_pickings = pickings.mapped("move_ids.move_dest_ids.picking_id").filtered(
+            lambda p: p.state == "assigned"
+        )
+        if not next_pickings:
+            return None
+        return {
+            "body": _(
+                "Last operation of transfer %(picking_names)s. "
+                "Next operation (%(next_picking_names)s) is ready to proceed.",
+                picking_names=", ".join(pickings.mapped("name")),
+                next_picking_names=", ".join(next_pickings.mapped("name")),
+            )
+        }