This module allows to configure a limit on the times a promotion can be applied. Two limits can be configured: customer and salesman. Those limits apply to either programs or coupons.
auto_awesome What this module does
AI-generated from the code · Odoo 15.0Limit how many times a promotion or coupon can be used per customer or per salesperson. When a limit is reached, Odoo blocks the promotion and shows an error message.
This module adds usage limits to promotions and coupons in Odoo Sales. You can set a maximum number of times a promotion can be applied for a customer, and also set limits per salesperson.
When a customer or salesperson tries to apply a promotion that has reached its limit, Odoo prevents it and displays a message explaining the limit. For example, if a customer already used a promotion twice and the limit is two, they will see an error.
You can also restrict a promotion to only specific salespeople. If a salesperson not on the list tries to use it, they get an error saying the promotion is restricted.
The module works with both coupon codes and automatic promotions. It checks limits when a coupon code is entered or when a promotion is automatically applied.
It also adds informative counters on promotion rules showing how many times each salesperson has used the promotion. These counters are updated automatically.
Access rights are set so that salespeople can view the salesperson limit settings, while sales managers can create, edit, and delete them.
Models and fields (4)
- coupon.rule · extends an existing model
- coupon.coupon · extends an existing model
- coupon.program · extends an existing model
- coupon.rule.salesmen.limit · extends an existing model
Text generated by AI (DeepSeek) from reading the Odoo 15.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub
Availability by version
Reviewed: 2026-11-03Confirmation status: 3 confirmed, 6 with no information of 9 versions.
Sources · Odoo 13.0
Confirmed on 2026-11-03 in branch 13.0 of OCA/sale-promotion.
terminal Installation and usage
OCA documentation · Odoo 15.0Configuration
Source · Odoo 15.0To configure customer limits:
- Go to Sales > Catalog > Coupon Programs and select or create a new one.
- Set the Maximum Customer Applications to the number of times a coupon can be used by a customer.
NOTE: The customer limit is applied at commercial entity level, not for each contact inside the entity.
To configure salesmen limits:
- Go to Sales > Catalog > Coupon Programs and select or create a new one.
- Add salesmen to the Salesmen Limits list and their maximum number of applications.
- You can add different limits to different salesmen groups.
- If you want to constrain the use of the promotion to the salesmen list, set the option Strict limit on, so any other salesman won't be able to apply the promotion.
Usage
Source · Odoo 15.0Once the program limits are configured, apply the programs as usual in your sale orders.
Once the limit for a customer or a salesman is reached, if we try to apply a promotion:
- A code promotion will raise an error.
- A program with no code won't be applied.
- A coupon belonging to a limited program will raise an error.
- A promotion applied on the next order won't generate the coupon.
No verified information in OCA: Installation.
Installation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.
Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.