pos_loyalty_tax_mode/readme.md

POS Loyalty Tax Mode

Custom module for Odoo 19 that adds a Before Tax / After Tax option to the loyalty rule's "per money spent" reward point mode.

Overview

By default, Odoo calculates loyalty reward points based on the total price including tax when the rule is set to "per money spent". This module introduces a configurable dropdown that lets you choose whether points should be calculated on the price before tax or after tax.

Features

• Adds a Tax Option dropdown field on the loyalty.rule model
• The dropdown only appears when the reward point mode is set to "per money spent"
• Two options available:
  • Before Tax — points are calculated based on the subtotal (tax excluded)
  • After Tax — points are calculated based on the total (tax included, default behavior)
• Fully integrated with the POS frontend — the setting syncs to the Point of Sale session automatically

Dependencies

Module	Technical Name
POS Loyalty	pos_loyalty
Loyalty	loyalty

Installation

1. Place the pos_loyalty_tax_mode folder into your custom addons directory
2. Restart the Odoo server
3. Go to Apps → Update Apps List
4. Search for "POS Loyalty Tax Mode" and click Install

Configuration

1. Navigate to Point of Sale → Configuration → Discount & Loyalty
2. Open or create a loyalty program
3. In the Rules section, set the grant mode to "per [currency] spent"
4. A new Tax Option dropdown will appear — select either Before Tax or After Tax
5. Save and close/reopen your POS session to apply the changes

Module Structure

pos_loyalty_tax_mode/
├── __init__.py
├── __manifest__.py
├── readme.md
├── models/
│   ├── __init__.py
│   └── loyalty_rule.py          # Extends loyalty.rule with money_reward_point_mode field
├── views/
│   └── loyalty_rule_views.xml   # Inherits form & kanban views to show the new field
└── static/
    └── src/
        └── app/
            └── pos_order_patch.js  # Patches POS point calculation logic

Technical Details

Backend (models/loyalty_rule.py)

Adds a money_reward_point_mode selection field to loyalty.rule:

Value	Label	Description
before_tax	Before Tax	Points based on price excluding tax
after_tax	After Tax	Points based on price including tax (default)

The field is also registered in _load_pos_data_fields so it is available in the POS frontend.

Frontend (static/src/app/pos_order_patch.js)

Patches two methods on PosOrder.prototype:

• pointsForPrograms(programs) — Modified to use total_excluded or total_included based on the rule's money_reward_point_mode when calculating orderedProductPaid and pointsPerUnit
• _getPointsCorrection(program) — Modified to use the correct price (before/after tax) when computing point corrections for free-product rewards

License

LGPL-3