OdooWiki OCA HUB

Coupons multi gift

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

This module allows to define multiple reward products on promotions.

auto_awesome What this module does

AI-generated from the code · Odoo 15.0

Lets you configure several gift products (with quantities) as the reward of a single promotion, instead of only one free product.

When you set up a promotion (coupon program) and choose the reward type "Multi Gift", a new "Gift list" table appears on the promotion form. In that table you can add one line per gift: the quantity to give and the gift product(s) to choose from. The single reward product field is hidden for this reward type, so the promotion uses the list instead.

Each line stores a quantity and a list of gift options. The first product in the options list is automatically shown as the "Default gift" and is read-only; it is kept in sync when you change the options. The promotion's reward description is generated automatically, for example "Free Products - 2x Product A, 1x Product B", so users can see at a glance what the promotion gives.

This module extends the existing coupon reward model (coupon.reward) and adds a new gift line model (coupon.reward.product_line). It only changes the promotion form view; no new menus are added. Access to the gift lines is restricted to system administrators.

Depends on

coupon

Required by other modules

Models and fields (2)
  • coupon.reward · extends an existing modelreward_type, coupon_multi_gift_ids (Gift list)
  • coupon.reward.product_line · new modelreward_id, reward_product_ids (Gift Options), reward_product_quantity (Quantity), reward_default_product_id

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: 1 confirmed, 8 with no information of 9 versions.

Sources · Odoo 15.0

Confirmed on 2026-11-03 in branch 15.0 of OCA/sale-promotion.

terminal Installation and usage

OCA documentation · Odoo 15.0

To configure multiple product rewards:

  • Go to Sales > Catalog > Coupon Programs and select or create a new one.
  • Choose the criteria of appliance you want to use and the minimum quantities, that will be used to calculate the times the rewards can be applied.
  • On the Reward Type field choose Multi Gift.
  • You'll see a now the Gift list on which you can add the products you want to give away and the quantities for each of them.

An example:

===== ================ Qty Products ===== ================ 3 Prod A 2 Prod B ===== ================

With a minimum quantity of 3, for every 3 units of products that fulfill the domain we'd get 3 units of A and 2 of B. So if the valid products quantities are 11, we'd get 9 of product A and 6 of product B.

This module is a base to be used by extra modules that use it in sale orders, PoS orders, etc.

No verified information in OCA: Installation.

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.