22 :target: https://odoo-community.org/get-involved?utm_source=readme
33 :alt: Odoo Community Association
44
5- =======================
6- Sale order min quantity
7- =======================
5+ =====================================================
6+ Sale order restricted quantity: min, max, multiple-of
7+ =====================================================
88
99..
1010 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
1111 !! This file is generated by oca-gen-addon-readme !!
1212 !! changes will be overwritten. !!
1313 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
14- !! source digest: sha256:11c109b03c7404989c3814a5675fcc5ae0cb3088674059b409bc202355156177
14+ !! source digest: sha256:1c96b9ab4a5f52f04233a4d0d47e6c5b19d7871794cec15c15d9a8821109c2dc
1515 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
1616
1717.. |badge1 | image :: https://img.shields.io/badge/maturity-Beta-yellow.png
@@ -32,16 +32,10 @@ Sale order min quantity
3232
3333|badge1 | |badge2 | |badge3 | |badge4 | |badge5 |
3434
35- This module allows to define min, max and multiple order quantity on
36- product. Min and Max order quantity is either required or recommanded.
37- If you check "Force mini/max Qty" on product the min/max qty do not
38- block sale order. This can be used if the available stock is less then
39- the min qty or if you want to sell sample products. Max qty can be used
40- if we dont want to sale more than available qty (end of series product)
41-
42- Setings are defined on product, if values are not set we use settings
43- from product template. If settings are not set on product template we
44- use settings from product category otherwise parent category.
35+ This module allows to set mininal, maximal, and multiple-of quantity
36+ constraints on product categories and products, and to check and
37+ optionally enforce these constraints on sale orders (either as strict
38+ blocking or soft warnings).
4539
4640**Table of contents **
4741
@@ -51,16 +45,47 @@ use settings from product category otherwise parent category.
5145Usage
5246=====
5347
54- 1. | Go to **Sales > Products > Product Variants ** and Set "Min Sale
55- Qty".
56- | If you dont want block product sale if qty is less the "Min Sale
57- Qty", chek "Force Min Qty"
48+ To set quantity constraints on a product: navigate to **Sales > Products
49+ > Products **, open the product, and on the **Sales ** tab in the **Qty
50+ Constraints ** section set corresponding values in the *Min Qty *, *Max
51+ Qty *, or *Multiple-Of Qty * fields.
52+
53+ **Constraint Types: **
54+
55+ - **Min Qty **: Minimum quantity required for a sale.
56+ - **Max Qty **: Maximum quantity allowed for a sale.
57+ - **Multiple-Of Qty **: Quantity must be a multiple of this value.
58+
59+ **Enforcement Levels (Restrict): ** For each constraint, you can choose
60+ the enforcement level:
61+
62+ - **Blocking **: Strictly enforces the rule. The user cannot confirm the
63+ line with an invalid quantity.
64+ - **Warning **: Displays a warning (yellow/orange indication) but allows
65+ the user to proceed.
66+
67+ - *Use Case *: Use **Warning ** when you want to allow flexibility, such
68+ as selling **samples ** (below min qty) or clearing out **leftover
69+ stock ** (remainder not matching multiple-of qty).
70+
71+ **Auto-Suggest: ** When you select a product in a Sales Order line, if a
72+ Minimum Quantity is strictly enforced (**Blocking **) and the current
73+ quantity is not set (or is 0/1), the system will automatically populate
74+ the quantity with the Minimum Quantity.
5875
59- 2. | Create a sale order and add a sale order line with this product and
60- check
61- | if Qty is less then "Min Qty" A message in displayed "Min Qty
62- Required" Or "Min Qty Recommanded". Check if Min qty is required
63- you can't validate order.
76+ To set quantity constraints on a product variant: navigate to **Sales >
77+ Products > Product Variants **, open the product variant, and on the
78+ **Sales ** tab in the **Qty Constraints ** section set corresponding
79+ values.
80+
81+ To set quantity constraints on a product category: navigate to **Sales >
82+ Configuration > Product Categories **, open the product category, and in
83+ the **Sales Qty Constraints ** section set corresponding values.
84+
85+ The settings are inherited from the product category to the product, and
86+ from the product to the product variant. To override the inherited
87+ settings, check the checkbox next to the corresponding value and set the
88+ value in the product or product variant.
6489
6590Bug Tracker
6691===========
@@ -86,13 +111,20 @@ Contributors
86111- Mourad EL HADJ MIMOUN <mourad.elhadj.mimoune@akretion.com>
87112- `Ooops <https://www.ooops404.com/ >`__:
88113
89- - Ashish Hirpara
90- <`https://ashish-hirpara.com\\ > <https://ashish-hirpara.com\> >`__
114+ - Ashish Hirpara <https://ashish-hirpara.com>
91115
92116- `Aion Tech <https://aiontech.company/ >`__:
93117
94118 - Simone Rubino <simone.rubino@aion-tech.it>
95119
120+ - `CorporateHub <https://corporatehub.eu/ >`__
121+
122+ - Alexey Pelykh <alexey.pelykh@corphub.eu>
123+
124+ - `Apik <https://apik.cloud/ >`__
125+
126+ - Thomas HERBIN <the@apik.cloud>
127+
96128Maintainers
97129-----------
98130
0 commit comments