diff --git a/setup/shopfloor_single_product_transfer_full_reservation/odoo/addons/shopfloor_single_product_transfer_full_reservation b/setup/shopfloor_single_product_transfer_full_reservation/odoo/addons/shopfloor_single_product_transfer_full_reservation new file mode 120000 index 0000000000..6d2cf2545b --- /dev/null +++ b/setup/shopfloor_single_product_transfer_full_reservation/odoo/addons/shopfloor_single_product_transfer_full_reservation @@ -0,0 +1 @@ +../../../../shopfloor_single_product_transfer_full_reservation \ No newline at end of file diff --git a/setup/shopfloor_single_product_transfer_full_reservation/setup.py b/setup/shopfloor_single_product_transfer_full_reservation/setup.py new file mode 100644 index 0000000000..28c57bb640 --- /dev/null +++ b/setup/shopfloor_single_product_transfer_full_reservation/setup.py @@ -0,0 +1,6 @@ +import setuptools + +setuptools.setup( + setup_requires=['setuptools-odoo'], + odoo_addon=True, +) diff --git a/shopfloor_single_product_transfer_full_reservation/README.rst b/shopfloor_single_product_transfer_full_reservation/README.rst new file mode 100644 index 0000000000..7af9d56c33 --- /dev/null +++ b/shopfloor_single_product_transfer_full_reservation/README.rst @@ -0,0 +1,129 @@ +.. image:: https://odoo-community.org/readme-banner-image + :target: https://odoo-community.org/get-involved?utm_source=readme + :alt: Odoo Community Association + +================================================== +Shopfloor Single Product Transfer Full Reservation +================================================== + +.. + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + !! This file is generated by oca-gen-addon-readme !! + !! changes will be overwritten. !! + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + !! source digest: sha256:512d9cce3c579f9c8f6178efd6ea19d223e054bf127d38d76e5185450b7cbfbb + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + +.. |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%2Fwms-lightgray.png?logo=github + :target: https://github.com/OCA/wms/tree/16.0/shopfloor_single_product_transfer_full_reservation + :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_single_product_transfer_full_reservation + :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| + +This module extends the *Single Product Transfer* shopfloor scenario +with support for the *Full Location Reservation* feature. + +When the **Process full location reservation** option is enabled on the +shopfloor menu, the system automatically extends the reservation each +time the operator is assigned a move line to work on. The reservation is +expanded to cover all available quantity sharing the same product, lot, +package, and owner at the source location — not just the quantity +originally requested. + +This allows operators to clear a source location in a single pass +without having to process the remaining quantity through separate +operations. + +**Table of contents** + +.. contents:: + :local: + +Use Cases / Context +=================== + +The *Single Product Transfer* scenario is designed for picking +operations where operators process one product at a time: they scan a +source location or package, scan a product, enter the quantity, and +confirm the destination. By default, the move lines are limited to +exactly the quantities already reserved in the stock operations. + +In some warehouse workflows — such as quality control restocking, +inventory consolidation, or location clearance — operators must move the +entire available quantity of a product from a source location in one go, +even when the original picking only reserved part of it. The +``stock_full_location_reservation`` module provides the underlying +mechanism to extend a stock reservation to the full available content of +a location. + +The ``shopfloor_full_location_reservation`` module exposes that +mechanism as a per-menu option (*Process full location reservation*) for +shopfloor scenarios. However, because the *Single Product Transfer* +scenario works line by line and filters by product/lot/package/owner, a +plain full-location reservation (which would capture every product in +the location) is too coarse. + +This module bridges the gap: it hooks into +``_get_next_move_line_to_work`` and, when the option is active, triggers +a **strict** full location reservation scoped to the exact product, lot, +package, and owner of the assigned move line. + +Bug Tracker +=========== + +Bugs are tracked on `GitHub 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 `_. + +Do not contact contributors directly about support or help with technical issues. + +Credits +======= + +Authors +------- + +* ACSONE SA/NV + +Contributors +------------ + +- Laurent Mignon laurent.mignon@acsone.eu (https://www.acsone.eu) + +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-lmignon| image:: https://github.com/lmignon.png?size=40px + :target: https://github.com/lmignon + :alt: lmignon + +Current `maintainer `__: + +|maintainer-lmignon| + +This module is part of the `OCA/wms `_ project on GitHub. + +You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute. diff --git a/shopfloor_single_product_transfer_full_reservation/__init__.py b/shopfloor_single_product_transfer_full_reservation/__init__.py new file mode 100644 index 0000000000..95d8980c80 --- /dev/null +++ b/shopfloor_single_product_transfer_full_reservation/__init__.py @@ -0,0 +1,2 @@ +from . import services +from .hooks import post_init_hook diff --git a/shopfloor_single_product_transfer_full_reservation/__manifest__.py b/shopfloor_single_product_transfer_full_reservation/__manifest__.py new file mode 100644 index 0000000000..3fbfde0337 --- /dev/null +++ b/shopfloor_single_product_transfer_full_reservation/__manifest__.py @@ -0,0 +1,19 @@ +# Copyright 2026 ACSONE SA/NV +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +{ + "name": "Shopfloor Single Product Transfer Full Reservation", + "summary": """Adds a configuration to the single product transfer " + "scenario which allows to trigger the full reservation of product " + "available at location for the selected lot/packaging""", + "version": "16.0.1.0.0", + "license": "AGPL-3", + "author": "ACSONE SA/NV,Odoo Community Association (OCA)", + "website": "https://github.com/OCA/wms", + "maintainers": ["lmignon"], + "depends": [ + "shopfloor_single_product_transfer", + "shopfloor_full_location_reservation", + ], + "post_init_hook": "post_init_hook", +} diff --git a/shopfloor_single_product_transfer_full_reservation/hooks.py b/shopfloor_single_product_transfer_full_reservation/hooks.py new file mode 100644 index 0000000000..afd749efd8 --- /dev/null +++ b/shopfloor_single_product_transfer_full_reservation/hooks.py @@ -0,0 +1,15 @@ +# Copyright 2026 ACSONE SA/NV +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). +import json + +from odoo import SUPERUSER_ID, api + + +def post_init_hook(cr, registry): + env = api.Environment(cr, SUPERUSER_ID, {}) + scenario = env.ref( + "shopfloor_single_product_transfer.scenario_single_product_transfer" + ) + options = scenario.options + options["full_location_reservation"] = True + scenario.options_edit = json.dumps(options) diff --git a/shopfloor_single_product_transfer_full_reservation/readme/CONTEXT.md b/shopfloor_single_product_transfer_full_reservation/readme/CONTEXT.md new file mode 100644 index 0000000000..260f46e8dd --- /dev/null +++ b/shopfloor_single_product_transfer_full_reservation/readme/CONTEXT.md @@ -0,0 +1,22 @@ +The *Single Product Transfer* scenario is designed for picking operations where +operators process one product at a time: they scan a source location or package, +scan a product, enter the quantity, and confirm the destination. By default, the +move lines are limited to exactly the quantities already reserved in the stock +operations. + +In some warehouse workflows — such as quality control restocking, inventory +consolidation, or location clearance — operators must move the entire available +quantity of a product from a source location in one go, even when the original +picking only reserved part of it. The `stock_full_location_reservation` module +provides the underlying mechanism to extend a stock reservation to the full +available content of a location. + +The `shopfloor_full_location_reservation` module exposes that mechanism as a +per-menu option (*Process full location reservation*) for shopfloor scenarios. +However, because the *Single Product Transfer* scenario works line by line and +filters by product/lot/package/owner, a plain full-location reservation (which +would capture every product in the location) is too coarse. + +This module bridges the gap: it hooks into `_get_next_move_line_to_work` and, +when the option is active, triggers a **strict** full location reservation scoped +to the exact product, lot, package, and owner of the assigned move line. diff --git a/shopfloor_single_product_transfer_full_reservation/readme/CONTRIBUTORS.md b/shopfloor_single_product_transfer_full_reservation/readme/CONTRIBUTORS.md new file mode 100644 index 0000000000..a15e3ef244 --- /dev/null +++ b/shopfloor_single_product_transfer_full_reservation/readme/CONTRIBUTORS.md @@ -0,0 +1 @@ +- Laurent Mignon (https://www.acsone.eu) diff --git a/shopfloor_single_product_transfer_full_reservation/readme/DESCRIPTION.md b/shopfloor_single_product_transfer_full_reservation/readme/DESCRIPTION.md new file mode 100644 index 0000000000..9742b7f424 --- /dev/null +++ b/shopfloor_single_product_transfer_full_reservation/readme/DESCRIPTION.md @@ -0,0 +1,11 @@ +This module extends the *Single Product Transfer* shopfloor scenario with support +for the *Full Location Reservation* feature. + +When the **Process full location reservation** option is enabled on the shopfloor +menu, the system automatically extends the reservation each time the operator is +assigned a move line to work on. The reservation is expanded to cover all +available quantity sharing the same product, lot, package, and owner at the +source location — not just the quantity originally requested. + +This allows operators to clear a source location in a single pass without having +to process the remaining quantity through separate operations. diff --git a/shopfloor_single_product_transfer_full_reservation/services/__init__.py b/shopfloor_single_product_transfer_full_reservation/services/__init__.py new file mode 100644 index 0000000000..3225992cdb --- /dev/null +++ b/shopfloor_single_product_transfer_full_reservation/services/__init__.py @@ -0,0 +1 @@ +from . import single_product_transfer diff --git a/shopfloor_single_product_transfer_full_reservation/services/single_product_transfer.py b/shopfloor_single_product_transfer_full_reservation/services/single_product_transfer.py new file mode 100644 index 0000000000..f4a99c1db7 --- /dev/null +++ b/shopfloor_single_product_transfer_full_reservation/services/single_product_transfer.py @@ -0,0 +1,18 @@ +# Copyright 2026 ACSONE SA/NV +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from odoo.addons.component.core import Component + + +class ShopfloorSingleProductTransfer(Component): + _inherit = "shopfloor.single.product.transfer" + + def _get_next_move_line_to_work(self): + move_line = super()._get_next_move_line_to_work() + if move_line and self.work.menu.full_location_reservation: + # we want the same product, lot, package and owner as the move line to work on, + # but we want to get all available quantities so use strict=True + move_line._full_location_reservation( + reservation_mode="strict" + ).move_line_ids[:1] + return move_line diff --git a/shopfloor_single_product_transfer_full_reservation/static/description/icon.png b/shopfloor_single_product_transfer_full_reservation/static/description/icon.png new file mode 100644 index 0000000000..3a0328b516 Binary files /dev/null and b/shopfloor_single_product_transfer_full_reservation/static/description/icon.png differ diff --git a/shopfloor_single_product_transfer_full_reservation/static/description/index.html b/shopfloor_single_product_transfer_full_reservation/static/description/index.html new file mode 100644 index 0000000000..8df86ac799 --- /dev/null +++ b/shopfloor_single_product_transfer_full_reservation/static/description/index.html @@ -0,0 +1,467 @@ + + + + + +README.rst + + + +
+ + + +Odoo Community Association + +
+

Shopfloor Single Product Transfer Full Reservation

+ +

Beta License: AGPL-3 OCA/wms Translate me on Weblate Try me on Runboat

+

This module extends the Single Product Transfer shopfloor scenario +with support for the Full Location Reservation feature.

+

When the Process full location reservation option is enabled on the +shopfloor menu, the system automatically extends the reservation each +time the operator is assigned a move line to work on. The reservation is +expanded to cover all available quantity sharing the same product, lot, +package, and owner at the source location — not just the quantity +originally requested.

+

This allows operators to clear a source location in a single pass +without having to process the remaining quantity through separate +operations.

+

Table of contents

+ +
+

Use Cases / Context

+

The Single Product Transfer scenario is designed for picking +operations where operators process one product at a time: they scan a +source location or package, scan a product, enter the quantity, and +confirm the destination. By default, the move lines are limited to +exactly the quantities already reserved in the stock operations.

+

In some warehouse workflows — such as quality control restocking, +inventory consolidation, or location clearance — operators must move the +entire available quantity of a product from a source location in one go, +even when the original picking only reserved part of it. The +stock_full_location_reservation module provides the underlying +mechanism to extend a stock reservation to the full available content of +a location.

+

The shopfloor_full_location_reservation module exposes that +mechanism as a per-menu option (Process full location reservation) for +shopfloor scenarios. However, because the Single Product Transfer +scenario works line by line and filters by product/lot/package/owner, a +plain full-location reservation (which would capture every product in +the location) is too coarse.

+

This module bridges the gap: it hooks into +_get_next_move_line_to_work and, when the option is active, triggers +a strict full location reservation scoped to the exact product, lot, +package, and owner of the assigned move line.

+
+
+

Bug Tracker

+

Bugs are tracked on GitHub 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.

+

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

+
+
+

Credits

+
+

Authors

+
    +
  • ACSONE SA/NV
    • +
+
+ +
+

Maintainers

+

This module is maintained by the OCA.

+ +Odoo Community Association + +

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.

+

Current maintainer:

+

lmignon

+

This module is part of the OCA/wms project on GitHub.

+

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

+
+
+
+
+ + diff --git a/shopfloor_single_product_transfer_full_reservation/tests/__init__.py b/shopfloor_single_product_transfer_full_reservation/tests/__init__.py new file mode 100644 index 0000000000..c46d8db688 --- /dev/null +++ b/shopfloor_single_product_transfer_full_reservation/tests/__init__.py @@ -0,0 +1 @@ +from . import test_shopfloor_single_product_transfer_full_reservation diff --git a/shopfloor_single_product_transfer_full_reservation/tests/common.py b/shopfloor_single_product_transfer_full_reservation/tests/common.py new file mode 100644 index 0000000000..2b7c19c580 --- /dev/null +++ b/shopfloor_single_product_transfer_full_reservation/tests/common.py @@ -0,0 +1,43 @@ +# Copyright 2026 ACSONE SA/NV +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from odoo import fields + +from odoo.addons.shopfloor_single_product_transfer.tests.common import ( + CommonCase as BaseCommonCase, +) + + +class CommonCase(BaseCommonCase): + @classmethod + def setUpClass(cls): + super().setUpClass() + cls.menu.sudo().allow_get_work = True + cls.location_src_a = ( + cls.env["stock.location"] + .sudo() + .create( + { + "name": "Source A", + "location_id": cls.location_src.id, + } + ) + ) + + def _data_for_start_line( + self, move_line, selected_location_id=None, selected_package_id=None + ): + return { + "move_line": self._data_for_move_line(move_line), + "selected_location_id": selected_location_id, + "selected_package_id": selected_package_id, + "scan_location_or_pack_first": self.menu.scan_location_or_pack_first, + } + + def _find_work(self): + """Dispatch find_work, assert the response and return the assigned move line.""" + response = self.service.dispatch("find_work") + move_line = fields.first(self.picking_1.move_line_ids) + data = self._data_for_start_line(move_line) + self.assert_response(response, next_state="start_line", data=data) + return move_line diff --git a/shopfloor_single_product_transfer_full_reservation/tests/test_shopfloor_single_product_transfer_full_reservation.py b/shopfloor_single_product_transfer_full_reservation/tests/test_shopfloor_single_product_transfer_full_reservation.py new file mode 100644 index 0000000000..9a1274f360 --- /dev/null +++ b/shopfloor_single_product_transfer_full_reservation/tests/test_shopfloor_single_product_transfer_full_reservation.py @@ -0,0 +1,138 @@ +# Copyright 2026 ACSONE SA/NV +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from .common import CommonCase + + +class TestFullReservation(CommonCase): + @classmethod + def setUpClass(cls): + super().setUpClass() + cls._add_stock_to_product(cls.product_a, cls.location_src_a, 10) + cls.picking_1 = cls._create_picking(lines=[(cls.product_a, 5)]) + cls.picking_1.move_line_ids.sudo().location_dest_id = cls.dispatch_location.id + + def test_no_full_reservation(self): + """With full_location_reservation disabled, only the initially reserved qty is kept.""" + self.menu.sudo().full_location_reservation = False + move_line = self._find_work() + self.assertEqual(move_line.reserved_uom_qty, 5) + self.assertEqual(move_line.location_id, self.location_src_a) + + def test_full_reservation(self): + """With full_location_reservation enabled, all available qty at the location is + reserved.""" + self.menu.sudo().full_location_reservation = True + self._find_work() + total_qty = sum( + self.picking_1.move_line_ids.filtered( + lambda l: l.product_id == self.product_a + and l.location_id == self.location_src_a + ).mapped("reserved_uom_qty") + ) + self.assertEqual(total_qty, 10) + + +class TestFullReservationMultipleProducts(CommonCase): + """Strict mode: full reservation must not spill over to other products.""" + + @classmethod + def setUpClass(cls): + super().setUpClass() + cls.menu.sudo().full_location_reservation = True + + # Same location contains two different products. + cls._add_stock_to_product(cls.product_a, cls.location_src_a, 10) + cls._add_stock_to_product(cls.product_b, cls.location_src_a, 8) + + # Only part of the available qty is initially reserved for each product. + cls.picking_1 = cls._create_picking(lines=[(cls.product_a, 5)]) + cls.picking_2 = cls._create_picking(lines=[(cls.product_b, 3)]) + + ( + cls.picking_1 | cls.picking_2 + ).move_line_ids.sudo().location_dest_id = cls.dispatch_location.id + + def test_full_reservation_strict_does_not_overflow_to_other_product(self): + """Full reservation with strict=True must only extend the reservation for + the product of the assigned move line, leaving the other product untouched.""" + self._find_work() + + # product_a: full stock (10) must now be reserved. + product_a_qty = sum( + self.picking_1.move_line_ids.filtered( + lambda l: l.product_id == self.product_a + and l.location_id == self.location_src_a + ).mapped("reserved_uom_qty") + ) + self.assertEqual( + product_a_qty, + 10, + "Full reservation should have extended product_a to its full available qty", + ) + + # product_b: must remain at the originally reserved qty (3), not 8. + product_b_qty = sum( + self.picking_2.move_line_ids.filtered( + lambda l: l.product_id == self.product_b + and l.location_id == self.location_src_a + ).mapped("reserved_uom_qty") + ) + self.assertEqual( + product_b_qty, + 3, + "Strict mode must not extend the reservation to other products at the same " + "location", + ) + + +class TestFullReservationMultipleLots(CommonCase): + """Strict mode: full reservation must not spill over to other lots of the same product.""" + + @classmethod + def setUpClass(cls): + super().setUpClass() + cls.menu.sudo().full_location_reservation = True + cls._set_product_tracking_by_lot(cls.product_a) + + cls.lot_1 = cls._create_lot_for_product(cls.product_a, "LOT-001") + cls.lot_2 = cls._create_lot_for_product(cls.product_a, "LOT-002") + + # Same location, same product, two different lots. + cls._add_stock_to_product(cls.product_a, cls.location_src_a, 5, lot=cls.lot_1) + cls._add_stock_to_product(cls.product_a, cls.location_src_a, 8, lot=cls.lot_2) + + # Only part of lot_1 is initially reserved; lot_2 has no picking. + cls.picking_1 = cls._create_picking(lines=[(cls.product_a, 2)]) + cls.picking_1.move_line_ids.sudo().lot_id = cls.lot_1.id + cls.picking_1.move_line_ids.sudo().location_dest_id = cls.dispatch_location.id + + def test_full_reservation_strict_does_not_overflow_to_other_lot(self): + """Full reservation with strict=True must extend the reservation only for + the lot of the assigned move line, leaving the other lot unreserved.""" + self._find_work() + + # lot_1: full stock at the location (5) must now be reserved. + lot_1_qty = sum( + self.picking_1.move_line_ids.filtered( + lambda l: l.lot_id == self.lot_1 + and l.location_id == self.location_src_a + ).mapped("reserved_uom_qty") + ) + self.assertEqual( + lot_1_qty, + 5, + "Full reservation should have extended lot_1 to its full available qty", + ) + + # lot_2: must remain unreserved (no assigned move line for it). + lot_2_lines = self.env["stock.move.line"].search( + [ + ("lot_id", "=", self.lot_2.id), + ("location_id", "=", self.location_src_a.id), + ] + ) + self.assertFalse( + lot_2_lines, + "Strict mode must not create a reservation for other lots at the same location", + ) diff --git a/test-requirements.txt b/test-requirements.txt index 689482e20d..04731e79b1 100644 --- a/test-requirements.txt +++ b/test-requirements.txt @@ -1,2 +1,5 @@ vcrpy-unittest odoo_test_helper +odoo-addon-stock-full-location-reservation @ git+https://github.com/OCA/wms.git@refs/pull/1194/head#subdirectory=setup/stock_full_location_reservation +odoo-addon-shopfloor-full-location-reservation @ git+https://github.com/OCA/wms.git@refs/pull/798/head#subdirectory=setup/shopfloor_full_location_reservation +odoo-addon-shopfloor-single-product-transfer @ git+https://github.com/OCA/wms.git@refs/pull/1188/head#subdirectory=setup/shopfloor_single_product_transfer