OdooWiki OCA HUB

Coupons Selection Wizard

sale_coupon_selection_wizard folder_open OCA/sale-promotion open_in_new
Sale License: AGPL-3

This module adds a wizard to allow configuring and applying multi criteria and multi gift promotions configuring the optional criterias in a custom wizard.

auto_awesome What this module does

AI-generated from the code · Odoo 15.0

Salespeople can open a wizard from a sales order to see all promotions that fit the order, preview the required products and rewards, and apply the chosen promotion in one click.

On a sales order (in draft, sent or sale state) a new "Add a promotion" button appears next to the coupon recompute button. It opens a wizard that lists the promotion programs that can be applied to that order: multi-criteria, multi-gift, no-code, not yet applied, not expired and matching the customer.

After choosing a program, the wizard shows cards for the products the promotion requires and for the rewards it gives. Mandatory products are shown with the quantity already on the order and the quantity that will be added. Optional criteria (where the customer can choose among several products) show how many more units are needed to reach the minimum, with plus/minus buttons and live feedback. When a reward has several possible products, the user picks one.

Clicking Apply adds the missing products to the order and applies the promotion, checking the promotion rules first; if the promotion cannot be applied, an error message explains why. The wizard only applies the selected program and does not disturb other promotions already on the order.

Models and fields (3)
  • sale.order · extends an existing model
  • coupon.selection.wizard · new modelorder_id, pricelist_id, coupon_program_id, coupon_reward_name (Reward Name), promotion_line_ids, available_coupon_program_ids
  • coupon.selection.wizard.line · new modeloptional, wizard_id, product_id, program_id, qty_to_add, criteria_id, criteria_qty, repeat_product, rule_min_quantity, current_order_quantity

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-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 2 confirmed, 7 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.0

To use this module, you need to create first one or several multi gift and multi criteria promotions.

  • Then create a sale order.
  • Click on the Add promotion button.
  • A selector with applicable promotions for the current order pops up.
  • When the user selects a promotion, the reward product list and the criterias required products are rendered.
  • If a reward has optional product gifts, the user can choose his preference.
  • If a criteria has optional product quantities to chose, the user can configure his preference as well.

No verified information in OCA: Installation, Configuration.

info

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.