HR Birthday Bonus

Version: 1.0 (Odoo 19)

Description: Module that automates the calculation and application of the birthday bonus for employees in Odoo Payroll.

---

Main Features

• "Birthday Bonus Amount" field: New field in the employee form to define the birthday bonus amount.
• Automatic salary rule: A salary rule is created to apply the birthday bonus in payroll.
• Smart calculation: The system prioritizes manual payslip inputs over the automatic rule.
• Payslip integration: The bonus appears as a separate line in the payslip.
• Easy configuration: No additional configuration required after installation.
• Audit trail: All birthday bonus changes are stored in the employee history.

---

How It Works

Step 1: Configure the employee bonus

In the employee form, fill in the "Birthday Bonus Amount" field with the desired amount.

Step 2: Salary rule

The module automatically creates a salary rule that checks whether the employee's birthday falls within the payroll period.

Step 3: Generate payroll

When generating the payslip, Odoo automatically calculates the birthday bonus for eligible employees.

Step 4: Payslip visualization

The bonus is displayed as a separate line named "Birthday Bonus" in the payslip.

---

Calculation Priority Logic

The birthday bonus calculation follows this priority order:

1. Manual payslip input: If a manual value is entered in the payslip, it has the highest priority.
2. Automatic salary rule: If no manual input exists, the value configured on the employee is used.
3. No bonus applied: If no value is defined, the bonus is not applied.

---

Installation

Step 1: Copy the module

Copy the module folder into the Odoo addons directory.

Step 2: Update apps list

In Odoo, go to Apps and update the apps list.

Step 3: Install the module

Search for HR Birthday Bonus and install it.

Step 4: Configure employees

Go to Human Resources → Employees and configure the birthday bonus amount.

---

Requirements

• Odoo 19 or later
• Human Resources module (hr)
• Payroll module (hr_payroll)

---

Support

To report issues or request new features, please contact the module developer.

---

Last update: 01/18/2026
Author: Eliottgs