City Master
Navigation Path
Company → Masters → City Master
1. City List Page
URL
/masters/city-master
Page Description
- Displays a list of all cities configured in the system
- Shows statutory applicability details per city
- Provides actions to add, edit, and delete city records
List Table Columns
| Column Name | Description |
|---|---|
| S No | Serial number |
| State | State associated with the city |
| City Name | Name of the city |
| Central / State | Indicates whether Central or State |
| Central Type | Central classification type |
| PF No | PF number mapped to the city |
| ESI No | ESI number mapped to the city |
| Is Metro | Indicates whether the city is metro |
| PT Applicable | Professional Tax applicability |
| LWF Applicable | Labour Welfare Fund applicability |
| Actions | Edit and Delete options |
Row Actions
| Action | Description |
|---|---|
| Edit | Opens Edit City page with pre-filled data |
| Delete | Opens delete confirmation alert |
2. Add City Page
Triggered From
City List Page → Add City button
Page Description
- Allows admins to add a new city under a selected state
- Enables statutory and tax-related configuration at city level
Add City – Fields
| Field Name | Type | Mandatory | Description |
|---|---|---|---|
| State | Dropdown | Yes | Select or create a state |
| City Name | Text Input | Yes | Enter the city name |
| Central / State | Dropdown | Yes | Select Central or State |
| Central Type | Dropdown | Conditional | Enabled when Central is selected |
| PF No | Text Input | No | Enter PF number |
| ESI No | Text Input | No | Enter ESI number |
| Is Metro | Checkbox | No | Indicates metro city |
| PT Applicable | Checkbox | No | Enables Professional Tax |
| LWF Applicable | Checkbox | No | Enables Labour Welfare Fund |
Actions
| Action | Behavior |
|---|---|
| Save | Validates and saves the city |
| Reset | Clears all entered values |
| Cancel | Returns to City List page |
Validation Rules
- State selection is mandatory
- City Name cannot be empty
- Central Type is mandatory if Central is selected
- Duplicate city names are not allowed within the same state
3. Edit City Page
/masters/city-master/edit/:id
Triggered From
City List Page → Edit icon
Page Description
- Allows updating existing city details
- All fields are pre-filled with saved data
Editable Fields
| Field Name | Editable |
|---|---|
| State | Yes |
| City Name | Yes |
| Central / State | Yes |
| Central Type | Yes |
| PF No | Yes |
| ESI No | Yes |
| Is Metro | Yes |
| PT Applicable | Yes |
| LWF Applicable | Yes |
Actions
| Action | Behavior |
|---|---|
| Update | Saves changes |
| Cancel | Discards changes and navigates back |
4. Delete City Confirmation Alert
Triggered From
City List Page → Delete icon
Alert Content
- Confirmation message before deletion
Actions:
- Confirm / Yes → Deletes the city
- Cancel → Closes the alert without action
Delete Behavior
- City is removed permanently after confirmation
- If the city is mapped to other records, deletion may be restricted
End of Documentation