Frontend
Voucher
Voucher Arrear
(DEPRECATED)

Navigation Path

Voucher → Arrear Process


Voucher Arrear Process Page

URL

/voucher/arrear-process


Deprecation Notice

⚠️ This module is deprecated.
This page was previously used for creating arrear vouchers for employees based on historical payment adjustments.
This functionality is no longer in active use and may be removed or replaced in future releases.
Please use the standard voucher process for current operations.


Page Description

  • Used to create and manage arrear vouchers for employees
  • Allows filtering by Employee, Unit, and Department
  • Supports Month-wise or Date-range arrear calculation
  • Handles both Increment and Amount-based arrears
  • DEPRECATED: This page exists for legacy support only

1. Employee Selection Section

Search Fields

Field NameTypeDescription
EmployeeSearch DropdownSearch and select specific employee(s)
Employee NameText InputEnter or display employee name

Employee Field Details

Employee Field

  • Type: Dropdown with search functionality
  • Format: Searchable dropdown
  • Placeholder: "Search and select employees..."
  • Features:
    • Search by employee code or name
    • Single or multiple employee selection
    • Dropdown with scrollable list
  • Validation: Optional (can be left empty for all employees)

Employee Name Field

  • Type: Text input
  • Placeholder: "Enter Employee Name"
  • Purpose: Manual name entry or display
  • Validation: Optional

2. Unit and Department Filter Section

Unit Selection

Field NameTypeDescription
UnitMulti-select with SearchFilter by unit(s)
Deselect AllButtonClear all selected units

Unit Field Details

  • Type: Multi-select checkbox list with search
  • Placeholder: "Search units with code"
  • Display Format: [Unit Code] | [Unit Name]
  • Examples:
    • UNT00007683 | TATA TELE SERVICES, NOIDA
    • UNTPFS00008321 | BLS INTERNATIONAL SERVICES LTD.
    • UNT004989 | GOLDEN SPARROW KESSEL MALL, KURUKSHETRA
    • UNTPFS00008316 | M/S.IBS SOFTWARE ,SHANTINIKETAN, WHITEFIELD ,BANGALORE
  • Features:
    • Search units by code or name
    • Select multiple units using checkboxes
    • Scrollable list
    • "Deselect All" button to clear selections
  • Selection: All selected units are checked by default

Department Selection

Field NameTypeDescription
DepartmentMulti-select with SearchFilter by department(s)
Deselect AllButtonClear all selected departments

Department Field Details

  • Type: Multi-select checkbox list with search
  • Placeholder: "Search departments..."
  • Options:
    • OPERATIONS
    • ADMIN
    • NA
    • BUSINESS DEVELOPMENT
    • HR
    • (Other departments as configured)
  • Features:
    • Search departments by name
    • Select multiple departments using checkboxes
    • Scrollable list
    • "Deselect All" button to clear selections
  • Selection: All selected departments are checked by default

3. Arrear Period Configuration

Date and Period Fields

Field NameTypeDescription
Pay MonthDropdownSelect payment month for arrear
Pay YearDropdownSelect payment year for arrear
From DateDate PickerStart date for arrear calculation
To DatedDate PickerEnd date for arrear calculation

Field Details

Pay Month

  • Type: Dropdown
  • Default: Current month (e.g., DECEMBER)
  • Options: JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC
  • Required: Yes
  • Purpose: Month in which arrear will be paid

Pay Year

  • Type: Dropdown
  • Default: Current year (e.g., 2025)
  • Options: Available years (typically current year ± 2 years)
  • Required: Yes
  • Purpose: Year in which arrear will be paid

From Date

  • Type: Date Picker
  • Label: "From Date:"
  • Placeholder: "Select From Date"
  • Format: DD/MM/YYYY
  • Required: Yes (for date-range based arrear)
  • Purpose: Starting date of arrear period

To Dated

  • Type: Date Picker
  • Label: "To Dated:"
  • Placeholder: "Select To Date"
  • Format: DD/MM/YYYY
  • Required: Yes (for date-range based arrear)
  • Purpose: Ending date of arrear period
  • Validation: Must be after "From Date"

4. Arrear Type Configuration

Arrear Type Options

OptionDescription
Month WiseCalculate arrear based on monthly periods
Date RangeCalculate arrear based on custom date range

Arrear Type Field

  • Type: Radio button
  • Label: "Arrear Type:"
  • Default: Month Wise (selected in blue/purple)
  • Options:
    • Month Wise: Uses Pay Month and Pay Year for calculation
    • Date Range: Uses From Date and To Dated for calculation

5. Arrear Calculation Method

Calculation Type Options

OptionDescription
IncrementCalculate arrear based on salary increment percentage
AmountCalculate arrear based on fixed amount

Is Increment Field

  • Type: Radio button
  • Label: "Is Increment:"
  • Default: Increment (selected in blue/purple)
  • Options:
    • Increment: Arrear calculated as percentage of salary
    • Amount: Arrear calculated as fixed amount

6. Action Buttons

Available Actions

ButtonColorActionDescription
SavePurpleCreate/UpdateSaves arrear voucher configuration
ResetGrayClearClears all form fields and selections

7. CRUD Operations

CREATE Operation

Purpose

Create new arrear vouchers for selected employees

Steps

  1. Select Employees

    • Use Employee dropdown to select specific employees
    • OR leave empty to include all employees
  2. Select Units and Departments

    • Check units from the Unit multi-select list
    • Check departments from the Department multi-select list
    • Use "Deselect All" to clear selections
  3. Configure Period

    • Select Pay Month (when arrear will be paid)
    • Select Pay Year
    • If using Date Range, select From Date and To Dated
  4. Choose Arrear Type

    • Select "Month Wise" for monthly calculation
    • Select "Date Range" for custom period
  5. Choose Calculation Method

    • Select "Increment" for percentage-based calculation
    • Select "Amount" for fixed amount
  6. Save

    • Click "Save" button
    • System creates arrear vouchers
    • Success message displayed

Validation Rules

  • Pay Month and Pay Year are mandatory
  • If Date Range is selected, From Date and To Dated are mandatory
  • To Dated must be after From Date
  • At least one Unit or Department must be selected
  • Increment/Amount calculation method must be selected

Success Response

  • "Arrear vouchers created successfully"
  • Arrear vouchers generated for matching employees
  • Vouchers added to voucher process workflow

READ Operation

Purpose

View existing arrear voucher configurations

Access Methods

  1. Load Saved Configuration

    • Navigate to Arrear Process page
    • Previously saved arrear configurations may be displayed
    • Review arrear vouchers created in voucher list
  2. Search Arrear Vouchers

    • Go to Voucher Process page
    • Filter by Pay Month and Pay Year
    • Filter by Type = "Arrear"
    • View all arrear vouchers created

Display Information

  • Employee details
  • Selected units and departments
  • Arrear period (month/year or date range)
  • Arrear type and calculation method
  • Voucher amounts

UPDATE Operation

Purpose

Modify existing arrear voucher configurations (before processing)

Steps

  1. Navigate to Voucher Process

    • Go to Voucher → Voucher Process
    • Search for arrear vouchers
  2. Select Vouchers to Update

    • Find vouchers with "Arrear" type
    • Select unprocessed arrear vouchers
  3. Modify Details

    • Update voucher amounts
    • Change employee assignments
    • Adjust voucher details
  4. Save Changes

    • Click update/save action
    • Confirm changes

Important Notes

  • Can only update unprocessed arrear vouchers
  • Processed vouchers require revert before update
  • Locked vouchers cannot be updated

Alternative Method

  • Delete existing arrear voucher
  • Create new arrear voucher with corrected details

DELETE Operation

Purpose

Remove arrear vouchers that are no longer needed

Steps

  1. Navigate to Voucher Process

    • Go to Voucher → Voucher Process
    • Search for arrear vouchers using filters
  2. Select Vouchers to Delete

    • Select arrear voucher(s) using checkboxes
    • Ensure vouchers are in unprocessed state
  3. Initiate Delete

    • Click "Delete Voucher" button
    • Confirmation modal appears
  4. Confirm Deletion

    • Review selected vouchers
    • Click "Confirm" to delete
    • Success message displayed

Restrictions

  • Can only delete unprocessed arrear vouchers
  • Processed vouchers must be reverted first
  • Locked vouchers cannot be deleted
  • Deletion is permanent and cannot be undone

Alternative: Revert

  • For processed arrears, use Revert Voucher page
  • Provide reason for reverting
  • Arrear returns to unprocessed state
  • Then can be deleted or modified

8. Workflow Integration

Arrear Voucher Lifecycle

Create Arrear (Arrear Process Page)

Unprocessed (Voucher Process Page)

Process → Branch → Billing → Accounts → Account Verified → Locked

After Creation

  1. Arrear vouchers appear in Voucher Process page with "Unprocessed" status
  2. Standard voucher workflow applies to arrear vouchers
  3. Approval process follows normal Branch → Billing → Accounts flow
  4. Final payment processed after Account Verified and Locked

9. Validation Rules

Form Validation

FieldValidation Rule
Pay MonthMust be selected from dropdown
Pay YearMust be selected from dropdown
From DateRequired if Date Range arrear type selected
To DatedRequired if Date Range arrear type selected; must be after From Date
Arrear TypeOne option must be selected (Month Wise or Date Range)
Is IncrementOne option must be selected (Increment or Amount)
Unit/DepartmentAt least one unit or department must be selected

Business Validation

RuleDescription
Duplicate CheckSystem checks for existing arrear for same employee/period
Employee EligibilityOnly active employees are eligible for arrear
Period ValidityArrear period cannot be in future
Amount ValidationCalculated amounts must be positive

10. Success/Error Messages

ScenarioMessage TypeSample Message
Arrear createdSuccess"Arrear vouchers created successfully for [X] employees"
No employees matchWarning"No employees found matching the selected criteria"
Missing required fieldsError"Please fill all required fields"
Invalid date rangeError"To Date must be after From Date"
Duplicate arrearError"Arrear already exists for selected employees in this period"
No selectionError"Please select at least one unit or department"
Save failedError"Failed to create arrear vouchers. Please try again"
Form resetInfo"Form has been reset"

11. Calculation Examples

Month Wise Arrear

Scenario: 5% increment arrear for December 2025

  • Employee: GOWRAMMA (Code: PFSBBAN691)
  • Current Salary: ₹20,000
  • Increment: 5%
  • Pay Month: December
  • Pay Year: 2025
  • Arrear Type: Month Wise
  • Calculation Method: Increment

Calculation:

Arrear Amount = Current Salary × (Increment % / 100)
Arrear Amount = 20,000 × (5 / 100)
Arrear Amount = ₹1,000

Date Range Arrear

Scenario: ₹500 fixed arrear for Nov 1-30, 2025

  • Employee: GOWRAMMA
  • From Date: 01/11/2025
  • To Dated: 30/11/2025
  • Pay Month: December
  • Pay Year: 2025
  • Arrear Type: Date Range
  • Calculation Method: Amount

Calculation:

Arrear Amount = Fixed Amount × Number of Days / Total Days in Period
Arrear Amount = ₹500 (fixed for the period)

12. Best Practices

For Creating Arrear Vouchers

  1. Verify Employee Data

    • Ensure employees are active
    • Check current salary information
    • Verify unit and department assignments
  2. Double-Check Dates

    • Confirm Pay Month and Pay Year are correct
    • Ensure From Date and To Dated are accurate
    • Validate date ranges don't overlap with existing arrears
  3. Use Appropriate Calculation Method

    • Use "Increment" for percentage-based adjustments
    • Use "Amount" for fixed arrear payments
    • Document calculation basis for audit
  4. Filter Carefully

    • Select specific units/departments to avoid mass creation
    • Review selections before saving
    • Use "Deselect All" to start fresh if needed
  5. Test with Small Group First

    • Create arrear for few employees first
    • Verify calculations are correct
    • Then proceed with larger batches
  6. Documentation

    • Keep records of why arrear was created
    • Note approval/authorization details
    • Maintain calculation worksheets

13. Common Use Cases

When to Create Arrear Vouchers

  1. Salary Increment Arrears

    • Increment approved but not applied in previous months
    • Retroactive salary increase
    • Pay grade revision
  2. Missed Allowances

    • Allowances not paid in previous months
    • New allowance with retrospective effect
    • Correction of underpayment
  3. Policy Changes

    • Company policy changes with retroactive dates
    • Government mandated pay revisions
    • Union settlement arrears
  4. Calculation Errors

    • Previous month calculation mistakes
    • System errors in salary processing
    • Manual correction required

14. Troubleshooting

No Employees Found

  • Cause: Selected units/departments have no active employees
  • Solution: Verify unit and department selections; check employee status

Cannot Save Arrear

  • Cause: Missing required fields or validation errors
  • Solution: Fill all mandatory fields; check date validations

Duplicate Arrear Error

  • Cause: Arrear already exists for same period
  • Solution: Check existing vouchers; delete duplicate first or use different period

Units Not Loading

  • Cause: Data loading issue or permission problem
  • Solution: Refresh page; check user permissions; contact admin

Date Picker Not Working

  • Cause: Browser compatibility or JavaScript error
  • Solution: Try different browser; clear cache; check browser console

15. Migration Path

For Future Updates

Since this module is deprecated, consider:

  1. Use Standard Voucher Process

    • Create arrear vouchers manually in Voucher Process page
    • Use custom voucher types for arrears
    • Better integration with approval workflow
  2. Arrear Management Module (if available)

    • New dedicated arrear management system
    • Enhanced calculation capabilities
    • Better reporting and audit trail
  3. Salary Arrear Integration

    • Process arrears through salary module
    • Automatic calculation based on salary changes
    • Unified arrear processing

16. Related Pages

Connected Modules

  • Voucher Process: Where created arrear vouchers appear
  • Voucher Branch: Approve arrear vouchers at branch level
  • Voucher Billing: Process arrear vouchers for billing
  • Voucher Accounts: Final verification and payment
  • Revert Voucher: Revert incorrectly created arrears

17. Notes

Important Considerations

  • ⚠️ This page is deprecated and should not be used for new arrear creation
  • Arrear vouchers created here follow standard voucher approval workflow
  • Once arrear vouchers are created, they appear in Voucher Process page
  • Arrear calculation should be verified manually before processing
  • System does not automatically calculate arrear amounts
  • Arrear payments are subject to same approval process as regular vouchers
  • All arrear transactions are auditable and traceable

Security & Compliance

  • All arrear creation actions are logged with user ID and timestamp
  • Arrear reasons should be documented externally
  • Audit reports include arrear voucher history
  • Unauthorized arrear creation attempts are blocked and logged

Future Development

  • This functionality may be replaced with enhanced arrear management module
  • Consider using alternative methods for arrear processing
  • Contact system administrator for current arrear creation procedures
  • Refer to updated documentation for latest arrear processing workflows

End of Documentation