From 36514ea7dccaeb7541050c2100eb75bf123d2219 Mon Sep 17 00:00:00 2001
From: Felicious <feku@odoo.com>
Date: Mon, 13 Oct 2025 16:48:02 -0700
Subject: [PATCH] [IMP] inventory: multiple qty

closes odoo/documentation#14853

Signed-off-by: Felicia Kuan (feku) <feku@odoo.com>
Co-authored-by: Jess Rogers <104637850+jero-odoo@users.noreply.github.com>
---
 .../replenishment/reordering_rules.rst        |  51 ++++++++++++++----
 .../reordering_rules/multiple.png             | Bin 0 -> 9526 bytes
 2 files changed, 42 insertions(+), 9 deletions(-)
 create mode 100644 content/applications/inventory_and_mrp/inventory/warehouses_storage/replenishment/reordering_rules/multiple.png

diff --git a/content/applications/inventory_and_mrp/inventory/warehouses_storage/replenishment/reordering_rules.rst b/content/applications/inventory_and_mrp/inventory/warehouses_storage/replenishment/reordering_rules.rst
index e422d9c14..4bfeb66f1 100644
--- a/content/applications/inventory_and_mrp/inventory/warehouses_storage/replenishment/reordering_rules.rst
+++ b/content/applications/inventory_and_mrp/inventory/warehouses_storage/replenishment/reordering_rules.rst
@@ -77,13 +77,10 @@ the :guilabel:`Purchase` checkbox is enabled under the product name. In the :gui
 tab, add at least one vendor to the :doc:`vendor pricelist <../../../purchase/products/pricelist>`.
 Odoo uses the vendor at the top of the list to generate |RFQs| when reordering rules are triggered.
 
-In the :guilabel:`Inventory` tab's :guilabel:`Routes` field, tick the :guilabel:`Buy` checkbox.
-
 .. seealso::
    :doc:`Vendor pricelist <../../../purchase/products/pricelist>`
 
-If the product is manufactured, :ref:`install <general/install>` the **Manufacturing** app, and in
-the :guilabel:`Inventory` tab's :guilabel:`Routes` field, tick the :guilabel:`Manufacture` checkbox.
+If the product is manufactured, :ref:`install <general/install>` the **Manufacturing** app.
 
 Next, ensure at least one :doc:`bill of materials
 <../../../manufacturing/basic_setup/bill_configuration>` (BoM) is displayed in the :guilabel:`Bill
@@ -98,8 +95,8 @@ button, then click :guilabel:`New` to configure a new |BoM|.
 
 .. _inventory/warehouses_storage/rr-fields:
 
-Create new reordering rules
----------------------------
+Create a reordering rule
+------------------------
 
 To create a new reordering rule, navigate to :menuselection:`Inventory app --> Operations -->
 Replenishment`, then click :guilabel:`New`, and fill out the following fields for the new reordering
@@ -111,9 +108,6 @@ rule line item:
   triggered. When forecasted stock falls below this number, a replenishment order for the product is
   created.
 - :guilabel:`Max`: The maximum quantity at which the stock is replenished.
-- :guilabel:`Multiple Quantity`: If the product should be ordered in specific quantities, enter the
-  number that should be ordered. For example, if the :guilabel:`Multiple Quantity` is set to `5`,
-  and only 3 are needed, 5 products are replenished.
 
 .. figure:: reordering_rules/reordering-rule-form.png
    :alt: The form for creating a new reordering rule.
@@ -135,6 +129,7 @@ For advanced usage, learn about the following reordering rule fields:
 - :ref:`Preferred route <inventory/warehouses_storage/route>`
 - :ref:`Vendor <inventory/warehouses_storage/set-vendor>`
 - :ref:`Bill of materials <inventory/warehouses_storage/set-bom-field>`
+- :ref:`Multiple <inventory/warehouses_storage/multiple>`
 - :ref:`Procurement group <inventory/warehouses_storage/procurement-grp>`
 
 .. note::
@@ -200,6 +195,44 @@ is used to replenish the product in one-unit increments, back up to the :guilabe
    now one unit on-hand, but it is not reserved for the |SO| which triggered its purchase. It can be
    used to fulfill that |SO|, or reserved for a different order.
 
+.. _inventory/warehouses_storage/multiple:
+
+Multiple
+--------
+
+The :guilabel:`Multiple` field on the replenishment report (:menuselection:`Inventory app -->
+Operations --> Replenishment`) defines the unit used when replenishing a product. Odoo rounds the
+ordered quantity *up* to the nearest multiple that meets or slightly exceeds the :guilabel:`Max`
+quantity set on the reordering rule. If no multiples apply, select :guilabel:`Units`.
+
+.. example::
+   A vendor sells soda only in cases of six cans, but your company tracks quantities per can.
+   Setting the :guilabel:`Multiple` to `6` ensures soda is ordered in multiples of six (6, 12,
+   18...).
+
+   For a reordering rule with the :guilabel:`Min` = `10` and :guilabel:`Max` = `40`:
+
+   - If the forecasted quantity is `10`, the amount :guilabel:`To Order` is `30`, a multiple of six
+     that will bring the :guilabel:`On Hand` quantity to exactly the maximum.
+   - If the forecasted quantity is `8`, the quantity needed to reach the max is `32`. But 32 is not
+     a multiple of six, so Odoo rounds the :guilabel:`To Order` quantity up to `36`. This will cause
+     the :guilabel:`On Hand` quantity to slightly exceed the maximum.
+
+   .. image:: reordering_rules/multiple.png
+      :alt: Reordering rule with the Multiple set to 6.
+
+.. note::
+   If the maximum is exceeded, expect to see a :icon:`fa-warning` warning indicating the possibility
+   of excessive stock.
+
+Configuration
+~~~~~~~~~~~~~
+
+Multiples are based on defined :doc:`packagings <../../product_management/configure/packaging>`.
+Only packaging types listed on the product's :doc:`vendor pricelist
+<../../../purchase/products/pricelist>` appear as options in the :guilabel:`Multiple` field when
+configuring reordering rules.
+
 .. _inventory/warehouses_storage/trigger:
 
 Trigger
diff --git a/content/applications/inventory_and_mrp/inventory/warehouses_storage/replenishment/reordering_rules/multiple.png b/content/applications/inventory_and_mrp/inventory/warehouses_storage/replenishment/reordering_rules/multiple.png
new file mode 100644
index 0000000000000000000000000000000000000000..443aae42e036a7165235842649d2a1af62d4a266
GIT binary patch
literal 9526
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
U9UN6Z0000007*qoM6N<$f~yr|u>b%7

literal 0
HcmV?d00001