Sales Quantity Limit - Feature Overview

Fair, automatic purchase limits per product and time period - enforced in the cart and checkout.

What Is It

Sales Quantity Limit lets you cap how much of a product a customer may buy per day, week, month, quarter, year or over their lifetime. Limits are set directly on the product, checked against the customer's real order history and enforced the moment a quantity is added or changed in the cart.

Key Features

🎯 Per-Product Limits

• Set a time period and a maximum quantity on each product
• Limits can differ per website
• Products without a limit are not affected

🗓️ Flexible Time Periods

• Day, week, month, quarter, year or lifetime
• Counts all orders in the current period; canceled orders are not counted

👥 Choose Who the Limit Applies To

• Per customer
• Per account relation or per company (when the matching Enobis / Proline modules are installed)
• Combined scopes such as company and customer

🛒 Enforced in the Cart

• Quantity changes are checked immediately
• Clear messages tell the customer the maximum available quantity and the period limit
• Works for simple and virtual products and for bundle components
• Quantities of the same product spread over several cart lines are added up

👀 Transparent for Customers

• Optional display of the remaining quantity on the product page
• Messages translated into German, English, French, Italian, Spanish, Polish and Russian

⚙️ Simple to Operate

• One switch to enable, one setting for the scope
• Own ACL resource to restrict who may change the settings

Who Is It For

How It Works

Product: limit value + period
        |
Customer changes cart quantity
        |
Module sums non-canceled orders in the current period (per scope)
        |
Requested qty > remaining qty?
   |-- yes --> cart error message with the maximum quantity
   '-- no  --> order can proceed

Integrations & Requirements

• Magento 2 (Framework 102.0.7+ / 103.0.3+), PHP 8.1 - 8.3
• Optional: Enobis Account Relation Switcher, Ecoplan Proline (extra scopes)

Use Cases

(inferred from the functionality - please review)

• A supplier allows each customer 100 units of a product per quarter
• A promotional item may be bought once per customer (lifetime)
• A company shares one monthly quota across all its users

Sales Quantity Limit - by Enobis

Sales Quantity Limit - Documentation

Table of Contents

1. Requirements
2. Installation
3. Configuration
4. Product attributes
5. Features and behavior
6. Scopes
7. Data model
8. Routes, events and extension points
9. Security and permissions
10. Localization
11. Troubleshooting

1. Requirements

The module is loaded after Magento_Catalog and Magento_Backend.

2. Installation

composer require enobis/module-sales-quantity-limit
bin/magento module:enable Enobis_SalesQuantityLimit
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

setup:upgrade creates the two product attributes (section 4).

3. Configuration

Path: Stores > Configuration > Enobis > Sales Quantity Limit. Visible in Default and Website scope.

About

General

4. Product attributes

Both attributes are created in the attribute group "General" with website scope, are not required and are available in product listings.

Options for the period: NONE (empty), Day, Week, Month, Quarter, Year, Lifetime (stored values day, week, month, quarter, year, lifetime).

A product is limited only when the period is set and the module is enabled. Both attributes are included in the quote-item attribute group so they are available on cart items.

5. Features and behavior

Limit check in the cart

The check runs on the event sales_quote_item_qty_set_after whenever the quantity of a quote item is set.

• It is skipped when the module is disabled, for items without a product, and when the quote is in super mode (is_super_mode, e.g. admin order creation).
• The ordered quantity of the product in the current period is the sum of qty_ordered over sales_order_item of all orders whose status is not canceled, filtered by the scope (section 6).
• Remaining quantity = limit value - ordered quantity (minimum 0).
• If the requested row quantity, or the total quantity of the same product across several cart lines, exceeds the remaining quantity, an error is set on the cart item and the quote. The message names the maximum available quantity, the product name, the limit and the period.
• For bundle products, each selected option product that has a limit is checked with option quantity multiplied by cart quantity.
• A custom registry flag sales_quantity_limitation_skip_apply disables the check for the current request.

Time periods

Orders are grouped by their creation date: day (Y-m-d), week, month (Y-m), quarter (Y-Qn), year (Y), lifetime (all orders). The current period is determined from the current date.

Display on product pages

When "Show Available Period Qty" is enabled, products of type simple, virtual and bundle show:

• "Available Period Qty: n / Period" - remaining quantity in the period
• "Available Total Qty: n" - shown only when the limitation data contains extended quantity information (qty_extend)

The data is loaded by a POST AJAX request to salesquantitylimit/product/ajaxlimitation. The request does not trigger a customer-section reload.

6. Scopes

The scope decides which orders are counted. Every scope adds a filter on a column of sales_order.

Scopes starting with relation or company appear in the dropdown only when the respective module is enabled. The columns active_relation and proline_company_id must exist on sales_order (provided by those modules).

7. Data model

The module adds no tables or columns. It adds two product EAV attributes (section 4) and reads sales_order and sales_order_item.

8. Routes, events and extension points

9. Security and permissions

• ACL resource Enobis_SalesQuantityLimit::config_sales_quantity_limit ("Sales Quantity Limit Section") controls access to the configuration section (under Stores > Settings > Configuration).
• The AJAX controller accepts only POST requests with XHR header and returns only the limit data of the requested product for the current customer/scope.
• The module is disabled by default.

10. Localization

Translations are included for de_DE, en_US, es_ES, fr_FR, it_IT, pl_PL and ru_RU.

11. Troubleshooting