Grade Master
The Grade Master enables structured classification of employee grades for payroll, benefits, and operational rules. It allows for definitive pay scales or percentage-based increments specific to stations and salary heads.
Navigation Path
Company → Masters → Grade Master
1. Grade List Page
URL
/masters/grade-master
Page Description
- Displays all configured grades and their associated amounts/limits.
- Provides a centralized interface to manage grade-level compensation rules.
- Grades are used during employee onboarding and payroll processing to determine basic pay or allowances.
Filter & Search Section
| Field Name | Type | Description |
|---|---|---|
| Description | Text Input | Search for a specific grade by its descriptive name. |
Actions:
- Search → Filters the grade list based on the entered description.
- Reset → Clears the search field and reloads the full list.
List Table Columns
| Column Name | Description |
|---|---|
| S No | Serial number. |
| Description | The human-readable name of the grade. |
| Amount | The fixed amount or percentage value assigned to this grade. |
| Order No | Priority/Display sequence number. |
| Max Limit | The maximum ceiling value for this grade (if applicable). |
| Actions | Edit and Delete options. |
Row Actions
| Action | Description |
|---|---|
| Edit | Opens the Edit Grade drawer/form with pre-filled data. |
| Delete | Opens a delete confirmation alert. |
2. Add Grade Page
Triggered From
Grade List Page → Add Grade button
Page Description
- Allows administrators to create a new grade with specific calculation rules.
- Associates the grade with a specific Station and Salary Head.
Add Grade – Fields
| Field Name | Type | Mandatory | Description |
|---|---|---|---|
| Description | Text Input | Yes | Enter the grade’s name (e.g., Grade A, Senior). |
| Order No | Number Input | Yes | Define the sorting priority (Lower numbers appear first). |
| Stationed At | Dropdown | Yes | Select the physical location mapping for this grade. |
| Head | Dropdown | Yes | Select the Salary Head (e.g., Basic) this grade applies to. |
| Amount | Number Input | Yes | Enter the fixed value or percentage. |
| Max Limit | Number Input | No | Set a maximum cap for calculation. |
| Percent Applicable | Checkbox | No | If checked, the Amount is treated as a percentage. |
| Yearly | Checkbox | No | If checked, the amount is processed on a yearly basis. |
Actions
| Action | Behavior |
|---|---|
| Save | Validates the configuration and saves the new grade. |
| Reset | Clears all input fields. |
| Cancel | Returns to the Grade List page. |
Validation Rules
- Description and Order No are mandatory.
- Stationed At and Head must be selected from existing Masters.
- Input is validated to ensure numeric values for amounts and limits.
3. Edit Grade Page
Triggered From
Grade List Page → Edit icon
Page Description
- Updates existing grade rules.
- Changes here impact future salary calculations for employees linked to this grade.
Editable Fields
| Field Name | Editable |
|---|---|
| Description | Yes |
| Stationed At | Yes |
| Head | Yes |
| Amount | Yes |
| Limit Flags | Yes |
Actions
| Action | Behavior |
|---|---|
| Update | Saves the modified grade configuration. |
| Cancel | Discards changes and returns to the list view. |
4. Delete Grade Confirmation Alert
Triggered From
Grade List Page → Delete icon
Alert Content
- "Are you sure you want to delete this Grade?"
Actions:
- Confirm / Yes → Soft deletes the grade (
isDeleted.status: true). - Cancel → Dismisses the alert.
Field Definitions, Usage, and Calculation Logic
1. Technical Field Definitions
| Field Name | Data Type | Description |
|---|---|---|
Description | String | Commercial/Official name of the grade category. |
Order | Number | Sorting priority for UI and reporting. |
Amount | Number | The base value or percentage factor. |
MaxLimit | Number | The ceiling value; system will not exceed this during calculation. |
PercentApplicable | Boolean | Determines if Amount is a multiplier or a fixed sum. |
Yearly | Boolean | Defines the periodicity of the grade amount. |
2. Business Logic & System Impact
A. Multi-Dimensional Scoping
Grades are unique in that they bridge Stationed At and Salary Heads. This allows a company to have different "Basic" amounts for the same grade name if the employees are stationed at different locations (e.g., Delhi vs. Mumbai).
B. Calculation Behavior
- If PercentApplicable = true: The system treats the amount as a decimal/percentage (e.g.,
10= 10%) typically applied to a base component. - If Yearly = true: The amount reflects an annual figure, which may be divided by 12 during monthly payroll processing depending on the specific engine config.
API Endpoints
Base URL
export const GRADEMASTER_URL = '/api/salaryGradeMaster'
Endpoints
| Endpoint | Method | Description | Parameters/Body |
|---|---|---|---|
${GRADEMASTER_URL} | POST | Create a new grade | Body: data |
${GRADEMASTER_URL} | GET | Get all grades | Query: page, limit |
${GRADEMASTER_URL}/:id | GET | Get grade details by ID | Path: gradeId |
${GRADEMASTER_URL}/:id | PATCH | Update grade details | Path: id, Body: data |
${GRADEMASTER_URL}/delete/:id | PATCH | Soft delete a grade | Path: id |
RTK Query Hooks
Available in gradeMasterSlice.js:
useCreateGradeMasterMutationuseGetAllGradeMastersQueryuseGetGradeMasterByIdQueryuseUpdateGradeMasterMutationuseDeleteGradeMasterMutation
Summary
The Grade Master provides the technical backbone for varied pay structures. By combining stationing constraints with flexible percentage/fixed amount logic, it supports complex organizational compensation models.
End of Documentation