LWF Slab Master
Navigation Path
Company → Masters → LWF Slab Master
Module URLs
- List Page:
/masters/lwf-slab-master - Add Page:
/masters/lwf-slab-master - Edit Page:
/masters/lwf-slab-master/edit-lwf-slab-master/:id
1. LWF Slab List Page
URL
/masters/lwf-slab-master
Page Description
- Displays all configured Labour Welfare Fund (LWF) slabs
- Allows users to search, edit, and delete LWF slab records
- Used for statutory LWF calculation based on state and city
List Table Columns
| Column Name | Description |
|---|---|
| S No | Serial number |
| State | State name |
| City | City name |
| Effect Type | Type of LWF effect |
| Effective From | Effective start date |
| Sequence | Processing sequence |
| Amount | LWF amount |
| Employer Multiple | Employer contribution multiplier |
| LWF Limit | Maximum LWF limit |
| Actions | Edit and Delete |
Row Actions
| Action | Description |
|---|---|
| Edit | Opens Edit LWF Slab page |
| Delete | Opens delete confirmation popup |
2. Add LWF Slab Page
URL
/masters/lwf-slab-master
Page Description
- Allows administrators to create a new LWF slab
- Configures state-wise and city-wise LWF rules
- Defines effective date and contribution limits
Add LWF Slab – Fields
| Field Name | Type | Mandatory | Description |
|---|---|---|---|
| State | Dropdown | Yes | Select applicable state |
| City | Dropdown | Yes | Select applicable city |
| Effect Type | Dropdown | Yes | Select LWF effect type |
| Effective From | Date Picker | Yes | LWF applicability start date |
| Sequence | Number Input | Yes | Processing order |
| Amount | Number Input | Yes | LWF contribution amount |
| Employer Multiple | Number Input | No | Employer contribution multiplier |
| LWF Limit | Number Input | No | Maximum LWF contribution limit |
Actions
| Action | Behavior |
|---|---|
| Save | Validates and saves LWF slab |
| Reset | Clears all entered values |
| Cancel | Navigates back to LWF Slab List |
Validation Rules
- State is mandatory
- City is mandatory
- Effect Type must be selected
- Effective From date is mandatory
- Sequence and Amount must be numeric
- Duplicate slabs for same State, City, and Effective Date are not allowed
3. Edit LWF Slab Page
URL
/masters/lwf-slab-master/edit-lwf-slab-master/:id
Triggered From
LWF Slab List Page → Edit icon
Page Description
- Allows modification of existing LWF slab configuration
- All fields are pre-filled with saved data
Editable Fields
| Field Name | Editable |
|---|---|
| State | Yes |
| City | Yes |
| Effect Type | Yes |
| Effective From | Yes |
| Sequence | Yes |
| Amount | Yes |
| Employer Multiple | Yes |
| LWF Limit | Yes |
Actions
| Action | Behavior |
|---|---|
| Update | Saves updated LWF slab |
| Cancel | Discards changes and returns to list |
4. Delete LWF Slab
Triggered From
LWF Slab List Page → Delete icon
Confirmation Message
“Are you sure you want to delete this LWF slab?”
Actions
- Yes / Confirm → Permanently deletes the LWF slab
- Cancel → Closes confirmation dialog
Summary
The LWF Slab Master ensures accurate statutory Labour Welfare Fund calculations by defining state-wise and city-wise slabs with effective dates and contribution limits.
Field Definitions, Usage, and Calculation Logic
This section providing a technical analysis of the LWF Slab Master's data structure and its role in statutory compliance.
1. Field Definitions
| Field Name | Data Type | Description | Example Value |
|---|---|---|---|
state | ObjectId | Reference to stateMaster. The primary geographic scope. | Maharashtra |
City | ObjectId | Reference to SalaryCityMaster. Specific city scope. | Pune |
effectType | String | Frequency of contribution (Monthly, Yearly, etc.). | Half Yearly |
effectiveFrom | Date | The date from which this specific slab becomes active. | 2024-12-01 |
Sequence | String | Sorting/Processing order for multiple slabs. | 1 |
Amount | Number | Employee Contribution amount (Required). | 12.00 |
employerMultiple | Number | Multiplier to calculate Employer Contribution. | 3 |
lwfLimit | Number | Maximum gross salary limit for LWF applicability. | 3000 |
2. Field Usage & System Impact
| Category | Validation / Rule | System Behavior |
|---|---|---|
| Geography | state + City | Scopes the statutory rule to specific administrative regions. |
| Frequency | effectType | Determines in which payroll months the deduction is triggered. |
| Indexing | companyId + state + City | Enforced unique index to prevent overlapping geographical definitions. |
| Deduction | Amount | Direct deduction from employee's net pay. |
3. Business & Calculation Logic
The LWF Slab Master handles complex statutory deductions with the following technical rules:
A. Contribution Calculation
- Employee Share: Is the fixed
Amountdefined in the slab. - Employer Share: Is calculated dynamically as:
Amount * employerMultiple.- Example: If Amount is ₹10 and Employer Multiple is 3, the total LWF contribution is ₹40 (10 employee + 30 employer).
B. Frequency Mapping (Import Logic)
During bulk Excel imports, the system uses shorthand codes to map frequencies:
M→ MonthlyY→ YearlyH→ Half YearlyQ→ Quarterly
C. All-in-One Integration
The import process is designed for maximum efficiency:
- Auto-Creation: If a State or City referenced in the Excel sheet does not exist in the respective masters, the system auto-creates them on-the-fly (
LWFApplicable: true). - Upsert Pattern: If a slab already exists for the same geographical scope and frequency, the system updates the amounts and sequence instead of creating a duplicate.
API Endpoints
The LWF Slab Master module interacts with the following API endpoints:
Base URL
export const LWFSLABMASTER_URL = '/api/lwfSlabMaster'
Endpoints
| Endpoint | Method | Description | Parameters/Body |
|---|---|---|---|
${LWFSLABMASTER_URL} | POST | Create a new LWF slab master | Body: data |
${LWFSLABMASTER_URL} | GET | Get all LWF slab masters | Query: page, limit |
${LWFSLABMASTER_URL}/:lwfSlabId | GET | Get LWF slab master by ID | Path: lwfSlabId |
${LWFSLABMASTER_URL}/:lwfSlabId | PATCH | Update an existing LWF slab master | Path: lwfSlabId, Body: body |
${LWFSLABMASTER_URL}/delete/:lwfSlabId | PATCH | Delete a LWF slab master | Path: lwfSlabId |
${LWFSLABMASTER_URL}/search | POST | Search LWF slabs | Body: data |
${LWFSLABMASTER_URL}/export | POST | Export LWF slabs | Body: data |
${LWFSLABMASTER_URL}/import | POST | Import LWF slabs | Body: data |
RTK Query Hooks
The following hooks are available for frontend integration:
useCreateLWFSlabMasterMutationuseGetAllLWFSlabMastersQueryuseGetLWFSlabMasterByIdQueryuseUpdateLWFSlabMasterMutationuseDeleteLWFSlabMasterMutationuseSearchLwfSlabsMutationuseExportLwfSlabsMutationuseImportLwfSlabsMutation
End of Documentation