Compute Pay (Bulk Bonus & Yearly Accruals)

Compute Pay Module - User Guide

⚡ Quick Start: 3-Minute Fast Track

For HR managers performing the yearly bonus run:

1. Selection: Choose the Year Label (e.g., 2024-25) and set Type to B (Bonus).
2. Validation: Click Validate to ensure no duplicate bonus has been posted for this FY.
3. Target: Set the Pay Month (the month you want the bonus to appear in).
4. Compute: Click Compute Bonus to run the bulk calculation engine.
5. Finalize: Review the results in the Payroll Management module for that specific month.

🗺️ Process Flow: Yearly Accrual Cycle

graph TD
    FY[Financial Year Setup] --> Monthly[Standard Monthly Payroll]
    Monthly -- 12 Months Finalized --> Compute[Compute Pay Engine]
    Compute --> Bonus[Yearly Bonus Calculation]
    Bonus --> Post[Post to Target Pay Month]
    Post --> Final[Disburse with Salary]
    
    style Compute fill:#f9f,stroke:#333,stroke-width:2px

✅ Prerequisites Checklist

Before running the yearly computation, ensure:

• Finalized Payroll: All 12 months of the fiscal year must be finalized.
• FY Master: The current financial year must be correctly defined.
• Bonus Rules: Statutory percentages must be configured in the system parameters.
• Backup: A database backup is highly recommended before running this bulk process.

1. Introduction 📝

The Compute Pay module is a specialized high-level engine designed for bulk payroll operations that occur outside the standard monthly salary cycle. Its primary function is the Computation of Yearly Bonus and other statutory accruals.

Typically, this module is used by Payroll Managers and CHROs (Chief Human Resource Officers) once a year.

2. Getting Started 🚀

Accessing the Module

Navigate to Compute Pay. Unlike the standard monthly setup, this module focuses on the Year Label (e.g., 2023-24) to define its calculation boundary.

Core Calculation Types

1. Bonus Computation (Type B): The main operative type, used to calculate the annual bonus for all eligible employees.
2. Statutory Accruals: Logic for calculating other yearly entitlements like Gratuity projections or Leave Encashment accruals (if configured).

3. Features & Benefits ✨

🛡️ One-Time Calculation Lock

• Duplicate Bonus Guard: The system includes a strict fiscal lock. If a bonus has already been computed and posted for the current financial year (FYStart to FYEnd), the system will block any second attempt. This prevents the catastrophic risk of double-posting yearly bonuses.

📅 Fiscal Year Intelligence

• FY-Dates Sync: The module automatically pulls the fystart and fyend from the Financial Year Master. It ensures that the base salary data used for bonuses is accurately clipped to the statutory fiscal period.

⚡ Bulk Generation

• Automated Posting: Once computed, the “Generate Pay” process automatically pushes these amounts into the employee’s payroll record for the selected disbursement month, making them visible in the Payroll Management module for final verification.

4. Complete Flow 🔄

5. Validations and Logic ⚠️

Safety Logic

• The Duplicate Rule: Before starting a bonus run, the system executes GetBonusCount. If the count is > 0, it means the data has already been finalized/extracted for this FY.
• FY Boundary Rule: The system strictly enforces calculations between fystart and fyend. Any salary data from the previous or next fiscal year is ignored to ensure audit compliance.

Operational Guards

• Target Month Matching: The system ensures that the bonus is posted to an “Open” pay month. You cannot post a yearly bonus to a month that has already been finalized.

6. Related Reports 📊

• 📑 Yearly Bonus Summary: A detailed report showing the total qualifying salary and calculated bonus per employee.
• 📈 Statutory Bonus Provision: Financial projection report for accounting provisions before the actual payout.
• 📐 Eligibility Audit: Lists employees who were excluded from the bonus run (e.g., due to joining date or specific category rules).

7. Best Practices / Tips 💡