Introduction
Keka allows administrators to enter negative amounts for benefit and post-tax deduction (PTD) overrides in Run Payroll to correct previous over-contributions. Negative reimbursement amounts are also supported in applicable scenarios, provided they do not result in invalid payroll calculations.
These amounts are validated to ensure that they comply with Check HQ's year-to-date (YTD) limits and that the employee's or contractor's net pay does not become negative.
All overrides and reimbursement changes made during payroll processing apply only to the current payroll. They do not change the employee's or contractor's ongoing configuration.
1. Enter Negative Benefit and Deduction Overrides
You can enter positive, negative, or zero amounts in the Benefit and Deduction override fields on the Employee step in Run Payroll.
- Benefit overrides: Negative amounts can be used to correct previous benefit contributions.
- Deduction overrides: Negative amounts can be used to correct previous post-tax deductions.
The Deduction override field must be editable, just like the Benefit override field.
Keka does not block negative values when you enter them. Check HQ validates whether the amount is within the applicable YTD limit when you update the payroll.
How are negative overrides validated?
Check HQ applies different YTD validation rules to benefits and post-tax deductions:
- Benefits: YTD validation is aggregated by benefit type. For example, if an employee has two benefits of the same type with contributions of $250 each, the combined YTD contribution is $500. A negative override of $400 is valid, but an override of $600 is not, because it would bring the combined amount below zero.
- Post-tax deductions: YTD validation is performed separately for each deduction ID. It is not aggregated across multiple deductions.
If there is a pending payroll, Check HQ validates YTD amounts both with and without that pending payroll's contributions. This prevents reopening a payroll from causing the YTD amount to become negative.
2. Update and Validate Negative Overrides
When you edit any field on the Employee step, the payroll must be updated before you can continue.
- Enter the required amount in the Benefit or Deduction override field.
- Once you make a change, the Continue button is disabled. An Update button appears along with a message indicating the number of changes made.
- Select Update to submit the changes to Check HQ for validation.
- If the amounts pass validation, the changes are saved, the change notification disappears, and the Continue button is enabled again.
What happens if an override fails validation?
If Check HQ rejects an override, Keka displays an error on the Employee step.
- A red error banner appears at the top of the step.
- The affected employee's row is marked with a red indicator.
- The relevant override field is outlined in red.
- A message prompts you to fix the errors before proceeding.
- You can hover over the flagged field to view the YTD validation details returned by Check HQ.
The Continue button remains disabled until the errors are resolved.
3. Resolve Override Errors from Need Attention
If you leave an invalid override unresolved and exit the Employee step, the value remains on the payroll item. However, Keka cannot generate the payroll preview while the override is invalid.
To resolve the error:
- Return to the Run Payroll dashboard.
- Under Need Attention, open the Warnings section.
- Select Resolve payroll preview run errors.
- In the Payroll preview category, locate the relevant error card:
- Benefit override error
- Deduction amount exceeds available YTD
- Review the affected employee, component, and YTD details.
- Edit the amount in the card and correct the value.
- Alternatively, select Skip from payroll for the affected employee if the component should be excluded from the payroll.
Select How to resolve on the relevant error card to view the contextual guidance for correcting the error.
The error is cleared once the underlying issue is resolved.
4. Resolve Errors When the Payroll Preview Fails
If an invalid override remains unresolved when you select Run Payroll, Keka may be unable to generate the payroll preview.
In this case, a Payroll preview failed message appears before the preview loads. It displays the error details and a summary of the affected employees.
- Select Let's Fix! to open the Need Attention panel and resolve the error.
- Select Cancel to return to the Run Payroll dashboard. The payroll remains blocked until the underlying error is corrected.
This validation also applies to invalid overrides introduced through bulk import or API.
5. Handle Negative Reimbursements
Negative reimbursement amounts must be validated to ensure that they do not result in negative net pay.
Keka validates reimbursement amounts across the applicable reimbursement entry paths, including advance settlements. This ensures that a negative reimbursement cannot bypass the net pay validation.
A negative reimbursement is valid only when the resulting net pay is zero or more.
6. Validate Contractor Net Pay for Advance Settlements
When a contractor receives an advance for business expenses, the settlement is reflected in the contractor's next payroll as a reimbursement-type component.
A negative settlement amount may reduce the contractor's payable amount. If the negative settlement exceeds the amount payable, it can result in negative net pay.
Keka validates the contractor's net pay using the following calculation:
Net Pay = Contractor Amount + Total Reimbursement Amount
The resulting net pay must be greater than or equal to zero.
What happens if the settlement results in negative net pay?
If a negative advance settlement or reimbursement would make the contractor's net pay negative:
- Keka blocks the invalid entry with an inline error when it is entered through the supported entry flow.
- The error identifies the amount that caused the validation failure.
- If the invalid amount reaches payroll through another route, such as an API-driven entry, Keka flags it under Need Attention using the existing Net pay negative validation.
Correct the reimbursement amount so that the contractor's net pay is not negative.
A negative settlement that does not reduce net pay below zero can proceed through payroll normally.
Important Points to Remember
- Negative Benefit and Deduction overrides are validated by Check HQ against their respective YTD limits.
- Benefit validation is aggregated by benefit type, while PTD validation is performed separately for each deduction ID.
- Negative overrides are validated when you select Update, not simply when you enter the amount.
- Unresolved override errors must be corrected through the Employee step or Need Attention before the payroll preview can be generated.
- Negative reimbursements and contractor advance settlements must not result in negative net pay.
- All override and reimbursement changes are limited to the current payroll.
- Negative Tax overrides are not supported.
Comments
0 comments
Please sign in to leave a comment.