About Salary Execptional Cases

Troubleshoot the possible exceptional cases when disbursing salaries in RazorpayX Payroll.


Check the troubleshooting guide to resolve some exceptional cases in XPayroll. The case, the reason, and the solutions to some issues are explained below.

Sometimes when you put in a deduction, XPayroll removes the custom salary structure. This applies specifically to employees to whom ESI and PF apply.

Consider an employee with the following custom salary structure:

Basic Salary8,000
House Rent Allowance (HRA)4,000
Special Allowance4,000
Employer ESI Contribution520
Employer PF Contribution1,440
Gross Monthly Earnings17,960

Now, let us say we need to put a deduction of ₹5,000 to this month's payroll. The gross pay then is 17,960-5,000 = ₹12,960.

To make that deduction, it is sensible to remove the amount proportionately from the rest of the salary components, as shown.

Basic Salary5500 (8000-2500)
House Rent Allowance (HRA)2750 (4000-1250)
Special Allowance2750 (4000-1250)
Employer ESI Contribution520
Employer PF Contribution1,440
Gross Monthly Earnings12,960

But by doing so, our ESI and PF of employer contributions will be incorrect, as these are calculated as a percentage of other components.

In such a case, you should manually lower the value of other components to correct the gross pay can as per the PF and ESI values, which can pose discrepancies.

  • There is the added complication of unknown or missing components.
  • It presents problems in the payroll database of the employee which can raise issues during audit.

Overall, this problem cannot be reliably solved using mathematical calculations.

Hence, in such cases, XPayroll removes the custom salary structure, and assigns a new structure that back-calculates from the required gross pay.

To accurately calculate an employee's TDS liability, you must provide the employee's previous payroll data. This is important even if you have joined XPayroll recently and have already processed employees' salaries.

To add previous payroll data:

  1. Log in to the .
  2. Go to People and select the employee for whom you are adding the previous payroll data.
  3. Navigate to Past Payroll In FY 2023-2024EDIT.
    1. Enter the previous year's salary details in the first section.
    2. Enter the past salary details in the past employer(s) salary section.
  4. Click CONTINUE.

With the details provided, XPayroll automatically calculates the TDS.

In XPayroll, to execute a payroll, it first needs to be finalised.

  • Previously, you could finalise payroll for different months and then request execution in any order.
  • However, this often led to incorrect TDS calculations because XPayroll only considers the past income from executed payroll, and not from finalised payroll.

To combat this, effective from September 2021, XPayroll has added a limitation: you can finalise payroll for one month at a time only. If a particular month's payroll is finalised and you attempt to finalise the payroll for another month, then XPayroll shows an error message.

In such a situation, you have two options -

  • Go to the other month's payroll and un-finalise it by clicking on Make Changes.
  • Go to the other month's payroll and execute it.

You cannot modify the salary after the payroll for a month is executed. Such changes create inconsistencies in the salary disbursals process and can lead to differences in the compliance calculations.

  • In XPayroll, it is not possible to make modifications retrospectively, especially after payroll has already been executed.
  • If there is a necessity to change the salary or make changes to the employee's profile that affects the salary, we suggest you do so in the upcoming payrolls.

For instance, if an employee's salary needed to be increased in the past month and was not, you can add the additional amount to the next or upcoming payrolls as arrears.

That way, your past calculations will not change, and the employee receives the required modifications in their next payroll.

Handy Tips

On the Run Payroll dashboard, we use the following action buttons:

  • FINALIZE PAYROLL
  • REQUEST EXECUTION

This is to imply a two-step process before positively finalising the payroll. You can always make changes to a finalised payroll by clicking on the MAKE CHANGES button and then clicking on REQUEST EXECUTION.

You cannot make or request modifications after clicking Request Execution.

You can execute payroll for past months for which TDS returns have already been filed.

However, we cannot change the TDS returns. This can lead to inaccurate data for the employees whose payroll is executed later. Especially if TDS is deducted, the employee(s) will not see it in their

. In such a case, you need to get a correction filed externally in such a case.


Was this page helpful?