pos_reward_point_digits/README.md

34 lines
1.8 KiB
Markdown

# POS Reward Point Digits (Odoo 19)
## Overview
By default, the `reward_point_amount` field on the `loyalty.rule` model within the Odoo Point of Sale restricts inputs to the default 2 decimal places.
This custom module adds a configurable setting inside of the Point of Sale setup screen to allow you to specify the exact number of decimal precision digits for reward points.
## Features
- Overrides the `reward_point_amount` numeric field to utilize a dynamic Point of Sale configuration.
- Introduces a designated "Reward Point" Decimal Precision configuration.
- Provides an easy-to-access integer widget in `res.config.settings` for POS administrators to adjust precision without needing to touch backend code or data files.
## Installation
1. Move the `pos_reward_point_digits` directory into your active Odoo 19 `custom` addons path.
2. Log into your Odoo 19 database as an Administrator.
3. Turn on **Developer Mode**.
4. Go to **Apps** -> **Update Apps List**.
5. Search for "POS Reward Point Digits".
6. Click **Activate**.
## Configuration
1. Navigate to **Point of Sale -> Configuration -> Settings**.
2. Scroll to the **Pricing** section.
3. Locate the **Reward Point Digits** field.
4. Set your desired integer value (e.g. `3` or `4`) to allow that many digits behind the decimal place.
5. Click **Save**.
Going forward, when accessing any Loyalty Program configuration rule, the grant reward setting (`reward_point_amount`) will properly respect the precision set within your Point of Sale configurations.
## Technical Details
- **Module Dependence**: `point_of_sale`, `pos_loyalty`, `loyalty`.
- Modifies `ir.ui.view` `res_config_settings_view_form` to append to the Pricing `<block>`.
- Generates `dp_reward_point` within Odoo's internal `decimal.precision` registry.