Technical Specifications & Compatibility
Technical Module Name
Supported Odoo Versions
v19.0
License
Odoo
Deployment Support
Odoo OnlineOdoo.shOn Premise
Lines of Code
631 lines (Python / XML / JS)
Overview & Description
Odoo 19 Odoo 20 Community and Enterprise OPL-1 Version 19.0.1.0.0 eCommerce Minimum Order Sell the way you actually ship: a minimum order quantity, a case multiple, a per-line maximum and a minimum order value on your webshop. Set them on a product, on a category, or for one group of customers. A wholesaler who ships beer by the case cannot let a website sell seven bottles. Module Overview What this module solves. The webshop will sell any number Odoo's webshop has no minimum quantity, no sales multiple and no minimum order value. A customer can order seven bottles of something you only ship in cases of twenty-four, and somebody in the warehouse finds out afterwards. Three independent numbers A minimum, a multiple and a maximum are separate facts. Minimum two, sold in cases of twenty-four is a perfectly sensible rule, and a product can set one of the three and inherit the others from its category. Enforced on the server, not just in the browser. The product page and the cart both guide the customer, but every add and every quantity change is checked again server-side, because a cart edited outside the browser is the one that gets through. Key Features Everything included in the module. What A Rule Can Say A minimum quantity, the fewest a customer may order A sales multiple: sold in sixes, in cases of 24, by the pallet A maximum per line, for the thing you only have so much of A minimum order value before checkout will open The three quantities are independent of each other A product can set one and inherit the rest Who And What A Rule Covers Route a rule at eCommerce categories; children are included Or set the numbers on a single product, which always wins Limit a rule to one or more customer groups Trade buys in pallets while retail carries on buying one at a time Limit a rule to specific websites Rules can be archived rather than deleted On The Product Page The rule is printed above Add to Cart, in words The quantity box opens on the smallest quantity the shop will sell Plus and minus move by the case, not by one The minus button stops at the minimum instead of walking to one Choosing a variant refreshes the box without a reload Redundant wording is left unsaid when minimum equals multiple In The Cart The cart's plus and minus move by the case too The rule appears on the quantity box as a tooltip Zero stays reachable, so a case minimum cannot trap goods in the basket A corrected quantity comes back with a sentence saying why The correction uses Odoo's own cart warning The shortfall notice sits above the checkout button it explains Enforcement Every add and update is checked through core's designed hook A cart edited outside the browser gets the same answer Quantities are rounded up, Odoo's own packaging convention Raising to the minimum re-lands on the multiple A maximum that is not a multiple is cut to the highest one under it Quantities convert through the product's own unit Minimum Order Value Checkout is closed below the threshold you set Blocked on the button and again at the payment step The shortfall is named, not merely refused Read on the tax basis the shop displays So the figure quoted is the figure on screen Delivery never counts towards the minimum Business Benefits Why it matters. No Broken Cases The website only sells quantities you can actually pick and ship, so the warehouse never has to split a case or ring the customer. Orders Worth Shipping A minimum order value stops the small orders that cost more to pack and deliver than they bring in. One Shop, Two Audiences Trade accounts buy in pallets and retail keeps buying singles, from the same catalogue, decided by a customer tag. No Corrections To Explain The box opens on a sellable quantity and steps by the case, so the common path never meets a correction at all. Screenshots A tour of the shop. Product Page Screenshot Placeholder The rule printed above Add to Cart, and the box opening on the case. Cart With A Correction Screenshot Placeholder A quantity raised to the multiple, with the sentence explaining why. Minimum Order Value Screenshot Placeholder The shortfall notice sitting above the checkout button. Rule Setup Screenshot Placeholder Quantities, categories, customer groups and websites on one form. Workflow From a rule to a shippable order. Switch the feature on for a website. Order Quantity Rules is off until you enable it, so installing the module changes nothing on a live shop. Write a rule. Point it at an eCommerce category, set a minimum, a multiple or a maximum, and limit it to customer groups or websites if you need to. Override on a product where needed. The product's own numbers always win over any rule that would otherwise cover it. Set a minimum order value. Optional, per website, and read on whichever tax basis your shop displays. The customer shops. The box opens on a sellable quantity, the buttons step by the case, and the rule is written out above Add to Cart. The server has the last word. Anything that arrives outside those numbers is corrected on the way in, with a sentence saying what changed and why. How A Quantity Is Resolved Situation What wins The product sets its own numbers The product, always, over any rule A rule covers a parent category It applies to the children too, without listing them Two rules could both apply The strictest wins each number separately Strictest, defined Highest minimum, largest multiple, lowest maximum A rule is limited to a customer group It only applies to customers carrying that tag The product has no eCommerce category Only its own fields can govern it Configuration Settings, rules and guard rails. Website Settings Setting Default Order Quantity Rules Off Minimum Order Value 0, no minimum Both are per website, so one shop can enforce trade rules while another in the same database sells to the public unchanged. Where To Set Things Place What it holds Website, Catalog, Order Quantity Rules The rules, their quantities and who they cover The product form Per-product overrides that beat every rule Website settings The master switch and the minimum order value Guard Rails Refused When A minimum above the maximum At save, not discovered later by a customer A negative quantity At save, on a rule or on a product Any enforcement at all Where the website switch is off, or no rule covers the product Prices are not touched. A quantity break is a price list rule, which Odoo already has and this module respects. It governs how many a customer may buy, never what they pay for them. Technical Details Models, dependencies and design. Module Information Technical Name website_sale_moq_aura Version 19.0.1.0.0 Category Website License OPL-1 Dependencies website_sale only External Libraries None beyond a standard Odoo installation External Service None. Everything runs inside your own Odoo instance. Automated Tests 36 tests, including two browser tours of the real shop What It Adds And Extends Model Role website.sale.qty.rule The rule: quantities, categories, groups and websites product.template Extended with the per-product overrides sale.order and its lines Extended to enforce quantities and the order value website Extended with the switch and the minimum order value Design Notes Core's own hook does the enforcing. The same one product availability uses, so a cart edited anywhere gets the same answer as one edited in the browser. Rounding goes up, never down. Odoo's convention for packaging, and the only safe direction: rounding down means picking a broken case. Raising to a minimum re-lands on the multiple. A minimum of ten sold in fours ends at twelve, not at ten. Access is resolved as superuser. A shopper cannot read customer tags, so the lookup runs elevated with the company filter written into the domain. Zero always stays reachable. A minimum of twenty-four must not trap twenty-four bottles in somebody's basket, so emptying a line is never blocked by the rule that governs adding to it. Compatibility Where the module runs. Item Supported Odoo Version 19.0 Current Hosting Odoo.sh, On-Premise and any self-managed deployment Multi-Website Yes, settings and rules are both per website Multi-Company Yes, the company filter is applied when rules are resolved Product Variants Yes, changing a variant refreshes the quantity box Units of Measure Yes, quantities convert through the product's own unit Price Lists Untouched. Quantity breaks remain a price list matter. Mobile and Tablet Yes, the shop templates stay responsive Supported Editions Both editions, one code base. Community Edition Supported Depends on website_sale alone, so it runs on any Community installation with the webshop enabled. Enterprise Edition Supported Runs unchanged on Enterprise, using the same core cart hooks rather than anything edition-specific. Odoo.sh Supported No extra Python packages to install, so it deploys with no change to your build configuration. Installation Four steps, and nothing changes until you say so. Copy the module. Place the website_sale_moq_aura folder in your Odoo addons path, then update the apps list from developer mode. Install eCommerce Minimum Order. Only website_sale is required. Enable it for a website. Website settings, then Order Quantity Rules. Until you do, the shop behaves exactly as before. Add your first rule. Website, then Catalog, then Order Quantity Rules. Point it at a category and set the numbers. Installing on a live shop is safe: the switch is off by default, and with it off no quantity is corrected and no checkout is blocked. Frequently Asked Questions The questions asked most often. No. The page and the cart guide the customer, but every add and every quantity change goes through the same server-side check core uses for product availability. A cart edited outside the browser gets exactly the same answer, which is the whole reason the check lives there. Yes. A rule can be limited to one or more customer groups, so tagging your trade accounts makes them buy in pallets while retail carries on buying one at a time, from the same catalogue and the same product pages. The strictest wins, and each number is decided separately: the highest minimum, the largest multiple and the lowest maximum. It is never whichever rule happened to be created first. A product that sets its own numbers beats every rule that would otherwise cover it. It is corrected upwards to the nearest sellable quantity, and the cart says what changed and why on Odoo's own warning. Rounding is always up, because rounding down would mean picking a broken case. Raising to a minimum also re-lands on the multiple, so a minimum of ten sold in fours ends at twelve. Yes. Zero is always reachable. A minimum of twenty-four governs how many you may buy, not whether you may change your mind, so it must never trap twenty-four bottles in somebody's basket. It is read on whichever tax basis your shop displays, so the figure quoted to the customer is the figure they can see on screen. Delivery never counts towards it. Checkout is closed below the threshold on the button and again at the payment step, with the shortfall named rather than merely refused. No. It governs how many a customer may buy, never what they pay. Quantity breaks are a price list rule, which Odoo already has and this module leaves entirely alone. Yes. The website switch is off by default, and with it off nothing is enforced, no quantity is corrected and no checkout is blocked. Nothing happens either for a product no rule covers. Changelog Release history. Version 19.0.1.0.0 Initial Release Minimum quantity, sales multiple and per-line maximum Rules routed at eCommerce categories, children included Per-product overrides that beat every rule Rules limited by customer group and by website Strictest-wins resolution, per number rather than per rule The rule written out above Add to Cart, without redundant wording Quantity box opening on the smallest sellable quantity Plus and minus stepping by the case, with a floor at the minimum Variant changes refreshing the box without a reload Case stepping and rule tooltips in the cart, with zero reachable Server-side enforcement through core's own cart hook Rounding up, minimums re-landing on the multiple, maximums cut to fit Minimum order value with a named shortfall, excluding delivery Validation of impossible and negative quantities at save 36 tests, including two browser tours of the real shop Support We answer, and we keep our modules current. Email odooaura@gmail.com Website www.auraodoo.tech YouTube youtube.com/@Auraodoo Free support for bug fixes on the Odoo version you downloaded. Customisation and installation help available on request. Aura Odoo Tech Odoo modules built to be understood, not just installed. Odoo 19 OPL-1 website_sale_moq_aura www.auraodoo.tech | odooaura@gmail.com | youtube.com/@Auraodoo
Key Capabilities & Features
- A minimum quantity, the fewest a customer may order
- A sales multiple: sold in sixes, in cases of 24, by the pallet
- A maximum per line, for the thing you only have so much of
- A minimum order value before checkout will open
- The three quantities are independent of each other
- A product can set one and inherit the rest
- Route a rule at eCommerce categories; children are included
- Or set the numbers on a single product, which always wins
- Limit a rule to one or more customer groups
- Trade buys in pallets while retail carries on buying one at a time
- Limit a rule to specific websites
- Rules can be archived rather than deleted
- The rule is printed above Add to Cart, in words
- The quantity box opens on the smallest quantity the shop will sell
- Plus and minus move by the case, not by one
- The minus button stops at the minimum instead of walking to one
- Choosing a variant refreshes the box without a reload
- Redundant wording is left unsaid when minimum equals multiple
- The cart's plus and minus move by the case too
- The rule appears on the quantity box as a tooltip
- Zero stays reachable, so a case minimum cannot trap goods in the basket
- A corrected quantity comes back with a sentence saying why
- The correction uses Odoo's own cart warning
- The shortfall notice sits above the checkout button it explains
- Every add and update is checked through core's designed hook
- A cart edited outside the browser gets the same answer
- Quantities are rounded up, Odoo's own packaging convention
- Raising to the minimum re-lands on the multiple
- A maximum that is not a multiple is cut to the highest one under it
- Quantities convert through the product's own unit
- Checkout is closed below the threshold you set
- Blocked on the button and again at the payment step
- The shortfall is named, not merely refused
- Read on the tax basis the shop displays
- So the figure quoted is the figure on screen
- Delivery never counts towards the minimum
- Switch the feature on for a website. Order Quantity Rules is off until you enable it, so installing the module changes nothing on a live shop.
- Write a rule. Point it at an eCommerce category, set a minimum, a multiple or a maximum, and limit it to customer groups or websites if you need to.
- Override on a product where needed. The product's own numbers always win over any rule that would otherwise cover it.
- Set a minimum order value. Optional, per website, and read on whichever tax basis your shop displays.
- The customer shops. The box opens on a sellable quantity, the buttons step by the case, and the rule is written out above Add to Cart.
- The server has the last word. Anything that arrives outside those numbers is corrected on the way in, with a sentence saying what changed and why.
- Core's own hook does the enforcing. The same one product availability uses, so a cart edited anywhere gets the same answer as one edited in the browser.
- Rounding goes up, never down. Odoo's convention for packaging, and the only safe direction: rounding down means picking a broken case.
- Raising to a minimum re-lands on the multiple. A minimum of ten sold in fours ends at twelve, not at ten.
- Access is resolved as superuser. A shopper cannot read customer tags, so the lookup runs elevated with the company filter written into the domain.
- Copy the module. Place the website_sale_moq_aura folder in your Odoo addons path, then update the apps list from developer mode.
- Install eCommerce Minimum Order. Only website_sale is required.
- Enable it for a website. Website settings, then Order Quantity Rules. Until you do, the shop behaves exactly as before.
- Add your first rule. Website, then Catalog, then Order Quantity Rules. Point it at a category and set the numbers.
- Minimum quantity, sales multiple and per-line maximum
- Rules routed at eCommerce categories, children included
- Per-product overrides that beat every rule
- Rules limited by customer group and by website
- Strictest-wins resolution, per number rather than per rule
- The rule written out above Add to Cart, without redundant wording
- Quantity box opening on the smallest sellable quantity
- Plus and minus stepping by the case, with a floor at the minimum
- Variant changes refreshing the box without a reload
- Case stepping and rule tooltips in the cart, with zero reachable
- Server-side enforcement through core's own cart hook
- Rounding up, minimums re-landing on the multiple, maximums cut to fit
- Minimum order value with a named shortfall, excluding delivery
- Validation of impossible and negative quantities at save
- 36 tests, including two browser tours of the real shop
- The author can leave a single reply to each comment.
- This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
- If you want to start a discussion with the author or have a question related to your purchase, please use the support page.
Screenshots & Previews
1 image availableExpand Preview
The AuraOdoo Quality Guarantee
100% Tested
Verified with Odoo 17, 18, and 19 test pipelines for stability and no conflicts.
Clean Architecture
Built according to official Odoo guidelines and PEP 8 standards with zero bloat.
Dedicated Support
Free installation assistance and quick bug turnaround from our team.