OdooWiki OCA HUB

Sale Loyalty Multi Gift

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

This module allows to define multiple reward products on promotions on sale orders.

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Lets you offer several different free gift products in a single sales promotion, and lets the salesperson choose which gift to give for each gift line when applying the reward on a sale order.

This module extends sales promotions (loyalty programs) so that one promotion can contain more than one free gift product. When a customer qualifies for a multi-gift reward, the reward wizard opens with a new list of "Loyalty Gift Lines". For each gift line you see the allowed gift products and pick the one you want to give; the list is read-only for adding or deleting rows, so you only choose among the products already configured in the promotion.

When the reward is applied, the system creates one discounted sale order line per gift line, each with a 100% discount and a name like "Free Product - ...". The chosen product is remembered on the order line, so re-applying or updating the reward keeps the same selection. If a product that is not allowed is chosen, an error is raised ("Invalid product to claim.").

The module also changes the reward button behaviour: if there is exactly one claimable reward and it is a multi-gift reward with more than one product per gift line, the wizard opens directly instead of the usual reward selection screen.

It touches sale.order, sale.order.line and the reward wizard, and adds a new wizard model for the gift lines. Salespeople can read the gift configuration; sales managers can fully manage it.

Models and fields (4)
  • sale.order · extends an existing model
  • sale.order.line · extends an existing modelmulti_gift_reward_line_id, multi_gift_reward_line_id_option_product_id
  • sale.loyalty.reward.wizard · extends an existing modelmulti_gift_reward, loyalty_gift_line_ids (Loyalty Gift Lines), loyalty_multi_gift_ids
  • sale.loyalty.reward.product_line.wizard · new modelline_id, gift_ids, reward_id, wizard_id, multi_gift_ids, selected_gift_id

Text generated by AI (DeepSeek) from reading the Odoo 18.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 18.0

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

terminal Installation and usage

OCA documentation · Odoo 18.0

Configure the promotion as told in loyalty_multi_gift readme.

Once configured, apply the programs as usual to get the expected rewards.

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.