From 04f9ea14cd4ef9d48060c276c7a957917032d763 Mon Sep 17 00:00:00 2001 From: Felicious Date: Wed, 21 Feb 2024 03:10:21 +0000 Subject: [PATCH] [IMP] inventory: putaway rules closes odoo/documentation#8049 X-original-commit: 43f2ecd375a796d0049b9b4555b8f82736ab3022 Signed-off-by: Zachary Straub (zst) Signed-off-by: Felicia Kuan (feku) Co-authored-by: brse-odoo --- .../advanced_operations_warehouse/putaway.rst | 193 +++++++++++------- .../putaway/create-putaway-rules.png | Bin 0 -> 10070 bytes .../putaway/putaway-example.png | Bin 20151 -> 15078 bytes 3 files changed, 117 insertions(+), 76 deletions(-) create mode 100644 content/applications/inventory_and_mrp/inventory/warehouses_storage/advanced_operations_warehouse/putaway/create-putaway-rules.png diff --git a/content/applications/inventory_and_mrp/inventory/warehouses_storage/advanced_operations_warehouse/putaway.rst b/content/applications/inventory_and_mrp/inventory/warehouses_storage/advanced_operations_warehouse/putaway.rst index a7a3d9a52..acc0400f1 100644 --- a/content/applications/inventory_and_mrp/inventory/warehouses_storage/advanced_operations_warehouse/putaway.rst +++ b/content/applications/inventory_and_mrp/inventory/warehouses_storage/advanced_operations_warehouse/putaway.rst @@ -2,106 +2,124 @@ Putaway rules ============= -What is a Putaway Rule? -======================= +Putaway is the process of routing products to appropriate storage locations upon shipment arrival. -A good warehouse implementation makes sure that products automatically move to their appropriate -destination location. To make that process easier, Odoo uses *Putaway Rules*. Putaway is the -process of taking products from the received shipments and putting them into the appropriate -location. +Odoo can accomplish this seamlessly using *putaway rules*, which dictate how products move through +specified warehouse locations. -If, for example, a warehouse contains volatile substances, it is important to make sure that certain -products are not stored close to each other because of a potential chemical reaction. That's where -putaway rules intervene, to avoid storing products wrongly. +Upon shipment arrival, operations are generated based on putaway rules to efficiently move products +to specified locations, and ensure easy retrieval for future delivery orders. + +In warehouses that process specific kinds of products, putaway rules can also prevent volatile +substances from being stored in close proximity, by directing them to different locations determined +by the warehouse manager. + +.. seealso:: + `Odoo Tutorials: Putaway Rules `_ Configuration -------------- +============= -In the :guilabel:`Inventory` app, go to :menuselection:`Configuration --> Settings` and activate -the :guilabel:`Multi-Step Routes` feature. By doing so, the :guilabel:`Storage Locations` feature -is also automatically activated. +To use putaway rules, navigate to :menuselection:`Inventory app --> Configuration --> Settings`, and +activate the :guilabel:`Multi-Step Routes` feature under the :guilabel:`Warehouse` section. By doing +so, the :guilabel:`Storage Locations` feature is also automatically activated. + +Finally, click :guilabel:`Save`. .. image:: putaway/activate-multi-step-routes.png :align: center :alt: Activate Multi-Step Routes in Inventory configuration settings. -Setting up a putaway rule -------------------------- +.. _inventory/routes/putaway-rule: -In some cases, like for a retail shop storing fruits and vegetables, products should be stored in -different locations depending on several factors like frequency, size, product category, specific -environment needs, and so on. +Define putaway rule +------------------- -In this example, suppose there is one warehouse location, **WH/Stock**, with the following -sub-locations: - -- WH/Stock/Pallets - - - WH/Stock/Pallets/PAL1 - - WH/Stock/Pallets/PAL2 - - WH/Stock/Pallets/PAL3 - -- WH/Stock/Shelf 1 - -- WH/Stock/Shelf 2 - - - WH/Stock/Shelf 2/Small Refrigerator - -- WH/Stock/Shelf 3 - -Manage those locations with putaway rules. To create a putaway rule, open the :guilabel:`Inventory` -app and go to :menuselection:`Configuration --> Putaway Rules`. Then, click on :guilabel:`Create` -and configure a putaway rule that indicated the main location the product will enter before being -redirected to the right storage location. +To manage where specific products are routed for storage, navigate to :menuselection:`Inventory app +--> Configuration --> Putaway Rules`. Use the :guilabel:`Create` button to configure a new putaway +rule on a :guilabel:`Product` or :guilabel:`Product Category` that the rule affects. .. important:: - The putaway rules can be defined either per product/product category and/or package type (the - :guilabel:`Packages` setting must be enabled for that). Putaway rules are read sequentially - until a match is found. + Putaway rules can be defined either per product/product category, and/or package type (the + *Packages* setting must be enabled in :menuselection:`Inventory app --> Configuration --> + Settings` for that). -Take the following example: +In the same line, the :guilabel:`When product arrives in` location is where the putaway rule is +triggered to create an operation to move the product to the :guilabel:`Store to` location. -- If water (category All/drinks) is received, whatever the package, it will be redirected to - WH/Stock/Shelf 2/Small Refrigerator. -- If orange juice cans, packaged in boxes, are received, they will be redirected to - WH/Stock/Shelf 2. -- If water or apple juice bottles, packaged in boxes, are received, they will be redirected to - WH/Stock/Shelf 3. -- If a pallet of lemonade cans are receieved, it will be redirected to WH/Stock/Pallets/PAL1. +For this to work, the :guilabel:`Store to` location must be a *sub-location* of the first (e.g., +`WH/Stock/Fruits` is a specific, named location inside `WH/Stock` to make the products stored here +easier to find). -.. image:: putaway/putaway-example.png - :align: center - :alt: Some examples of putaway rules. +.. example:: + In a warehouse location, **WH/Stock**, there are the following sub-locations: -Using Storage Categories -======================== + - WH/Stock/Fruits + - WH/Stock/Vegetables -A *Storage Category* is an extra location attribute. Storage categories allow the user to define -the quantity of products that can be stored in the location and how the location will be selected + Ensure all apples are stored in the fruits section by filling the field :guilabel:`Store to` with + the location `WH/Stock/Fruits` when the :guilabel:`Product`, `Apple` arrives in `WH/Stock`. + + Repeat this for all products and hit :guilabel:`Save`. + + .. image:: putaway/create-putaway-rules.png + :align: center + :alt: Create putaway rules for apples and carrots. + +Putaway rule priority +--------------------- + +Odoo selects a putaway rule based on the following priority list (from highest to lowest) until a +match is found: + +#. Package type and product +#. Package type and product category +#. Package type +#. Product +#. Product category + +.. example:: + The product `Lemonade can` has the following putaway rules configured: + + #. When receiving a `Pallet` (:guilabel:`Package Type`) of `Lemonade cans`, it is redirected to + `WH/Stock/Pallets/PAL1`. + #. `Lemonade can`'s :guilabel:`Product Category` is `All/drinks`, and when receiving a `Box` of + any item in this product category, items are redirected to `WH/Stock/Shelf 1`. + #. Any product on a `Pallet` is redirected to `WH/Stock/Pallets` + #. The product `Lemonade can` is redirected to `WH/Stock/Shelf 2` + #. Items in the `All/drinks` product category are redirected to `WH/Stock/Small Refrigerator`. + + .. image:: putaway/putaway-example.png + :align: center + :alt: Some examples of putaway rules. + +Storage categories +================== + +A *storage category* is an extra location attribute. Storage categories allow the user to define +the quantity of products that can be stored in the location, and how the location will be selected with putaway rules. Configuration ------------- -In the :guilabel:`Inventory` app, go to :menuselection:`Configuration --> Settings` and activate -the :guilabel:`Storage Categories` feature. By doing so, the :guilabel:`Storage Locations` feature -is also automatically activated. +To enable storage categories, go to :menuselection:`Inventory app --> Configuration --> Settings`, +and activate the :guilabel:`Storage Categories` feature in the :guilabel:`Warehouse` section. Then, +click :guilabel:`Save`. -Create a Storage Category -------------------------- +.. important:: + The :guilabel:`Storage Locations` feature **must** be enabled to enable :guilabel:`Storage + Categories`. -To create a storage category, go to :menuselection:`Inventory --> Configuration --> Storage -Categories` and click :guilabel:`Create`. Then, click :guilabel:`Save` and click :guilabel:`Storage -Categories` or go to :menuselection:`Configuration --> Storage Categories` to create a new storage -category. +Define storage category +----------------------- -.. image:: putaway/storage-category.png - :align: center - :alt: Create Storage Categories inside Odoo Inventory configuration settings. +To create a storage category, go to :menuselection:`Inventory app --> Configuration --> Storage +Categories` and click :guilabel:`Create`. -First, click :guilabel:`Create` and type a name for the storage category. +On the storage category form, type a name for the :guilabel:`Storage Category` field. -Then, there are options to limit the capacity by weight, by product, or by package type. The +Options are available to limit the capacity by weight, by product, or by package type. The :guilabel:`Allow New Product` field defines when the location is considered available to store a product: @@ -111,17 +129,40 @@ product: - :guilabel:`Allow mixed products`: several different products can be stored in this location at the same time. +.. example:: + Create putaway rules for pallet-stored items and ensure real-time storage capacity checks by + creating the `High Frequency pallets` storage category. + + Name the :guilabel:`Storage Category`, and select :guilabel:`If all products are same` in the + :guilabel:`Allow New Product` field. + + Then, define package capacity in the :guilabel:`Capacity by Package` tab, specifying the number + of packages for the designated :guilabel:`Package Type` and setting a maximum of `2.00` `Pallets` + for a specific location. + + .. image:: putaway/storage-category.png + :align: center + :alt: Create a storage category on the page. + Once the storage category settings are saved, the storage category can be linked to a location. -.. image:: putaway/location-storage-category.png - :align: center - :alt: When a Storage Category is created, it can be linked to a warehouse location. +To do that, navigate to the location by going to :menuselection:`Inventory app --> Configuration --> +Locations`, and select the location. Click :guilabel:`Edit` and select the created category in the +:guilabel:`Storage Category` field. + +.. example:: + Assign the `High Frequency pallets` storage category to the `WH/Stock/pallets/PAL 1` + sub-location. + + .. image:: putaway/location-storage-category.png + :align: center + :alt: When a Storage Category is created, it can be linked to a warehouse location. Storage categories in putaway rules ----------------------------------- -To continue the example from above, apply the "High Frequency Pallets" on the PAL1 and PAL2 -locations and rework the putaway rules as follows: +To continue the example from above, apply the `High Frequency Pallets` on the `PAL1` and `PAL2` +locations and :ref:`rework the putaway rules ` as follows: Assume one pallet of lemonade cans is received: diff --git a/content/applications/inventory_and_mrp/inventory/warehouses_storage/advanced_operations_warehouse/putaway/create-putaway-rules.png b/content/applications/inventory_and_mrp/inventory/warehouses_storage/advanced_operations_warehouse/putaway/create-putaway-rules.png new file mode 100644 index 0000000000000000000000000000000000000000..f45934ebc874a21d04ae1f86e63a618af9a4f021 GIT binary patch literal 10070 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 literal 0 HcmV?d00001 diff --git a/content/applications/inventory_and_mrp/inventory/warehouses_storage/advanced_operations_warehouse/putaway/putaway-example.png b/content/applications/inventory_and_mrp/inventory/warehouses_storage/advanced_operations_warehouse/putaway/putaway-example.png index b6aa7901b850e128f600ccb810cc45209780e3d5..6e80b5cc11f7794cf71f31674438f12bcf441944 100644 GIT binary patch literal 15078 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 literal 20151 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