Payroll submission failure β user-friendly error messages
When a payroll submission fails, Zenoti displays a specific error message on the payroll submission failure screen to help you understand what went wrong and what to do next. This article explains each error message, its cause, and the steps to resolve it.
Audience: Payroll administrators who manage payroll submissions for their organization.
On this page
Before you begin
- Your organization must have Zenoti Integrated Payroll configured and active.
- You need the following permissions to view and act on payroll submissions:
Permission: Payroll (under View Employee Reports) β Required to view payroll report data. Grant it on the View Employee Reports row in the Employee Manager section of the security role (Configuration > Security > Security roles > the role > Permissions). Admin path: Configuration > Security > Security roles > [your role] > Permissions > Employee Manager > View Employee Reports > Payroll
Permission: View (under General Settings) β Required to view the employee list when reviewing earnings and deductions. The employee list also opens for roles that have Add General Settings or Delete on the Employee row, Edit on the General Settings row, or View All or Edit on the Commission Settings row. If the role has View Self on the Commission Settings row but neither View All nor Edit, the list shows only the signed-in employee. Grant it on the General Settings row in the Employee Manager section of the security role (Configuration > Security > Security roles > the role > Permissions). Admin path: Configuration > Security > Security roles > [your role] > Permissions > Employee Manager > General Settings > View
- Payroll must not be locked for the pay period you are resubmitting. If the pay period is under payroll lock, attendance and commission data cannot be edited.
Error messages and how to resolve them
When a payroll submission fails, Zenoti displays an error message on the payroll submission failure screen. The message shown depends on the type of failure returned by the payroll provider.
Business not in good standing
Message displayed:
The business is not in good standing to process payroll, review failed payments and try again to run payroll.
What this means: The payroll provider has flagged the business account as not in good standing. This typically occurs when there are outstanding failed payments or unresolved account issues with the payroll provider.
Steps to resolve:
- Log in to your payroll provider account and review any outstanding failed payments or account alerts.
- Resolve all flagged payment issues or account holds.
- Return to Zenoti and resubmit payroll once the account is in good standing.
Note: If you are unsure which payments have failed, check the payroll provider's dashboard for a list of declined or pending transactions before resubmitting.
Negative net pay
Message displayed:
One or more employees have a negative net pay. Review their earnings and deductions, then resubmit payroll.
What this means: At least one employee's total deductions exceed their total earnings for the pay period, resulting in a negative net pay amount. Payroll cannot be submitted when any employee has a negative net pay.
Steps to resolve:
- Navigate to Employee > Employees and open the profile of each employee flagged in the payroll run.
- Select the Commissions tab to review commission earnings for the pay period.
- Select the Payrates tab to review hourly pay and salary amounts.
- Review all deductions applied to the employee's commissions, including:
- Standard deductions
- Invoice-level deductions
- Service-level deductions
- Adjust earnings or deductions as needed so that each employee's net pay is zero or greater.
- Resubmit payroll.
Important: Verify that deduction amounts are correct before adjusting. Incorrect deductions may affect commission calculations for the pay period.
No payable earnings
Message displayed:
This payroll has no payable earnings. Add at least one employee with earnings before resubmitting.
What this means: The payroll run contains no employees with earnings that qualify for payment. This can occur if all employees have zero earnings for the pay period, or if no employees have been included in the payroll run.
Steps to resolve:
- Confirm that the correct pay period is selected for the payroll run.
- Navigate to Employee > Employees and verify that at least one employee has recorded attendance, commissions, or hourly pay for the pay period.
- If attendance records are missing, navigate to Employee > Check in and add or correct attendance records for the affected employees.
- Recalculate commissions for the pay period if needed.
- Resubmit payroll.
Note: Payroll cannot be submitted for a pay period in which no employee has payable earnings. Ensure that attendance and pay data are complete before resubmitting.
Payroll already submitted
Message displayed:
This payroll has already been submitted.
What this means: The payroll for this pay period has already been successfully submitted to the payroll provider. Duplicate submissions are blocked to prevent double payment.
Steps to resolve:
- Verify the submission status of the pay period in the payroll report.
- Navigate to Employee > Payroll and confirm that the pay period shows a successful submission status.
- If you believe the submission was made in error, contact your payroll provider to discuss options for reversing or correcting the submitted payroll.
- Do not resubmit payroll for this pay period unless the provider has confirmed that the original submission was voided or reversed.
Important: Resubmitting an already-approved payroll can result in duplicate payments to employees. Confirm with your payroll provider before taking any corrective action.
Unrecognized error
Message displayed:
If the error type returned by the payroll provider is not one of the recognized types above, Zenoti displays either:
- The raw error message returned by the payroll provider, if one is available, or
- The following fallback message if no provider message is available:
Payroll submission failed. Please review and resubmit.
What this means: An unexpected error occurred during payroll submission that does not match a known error type. The cause may vary depending on the provider's response.
Steps to resolve:
- Read the raw provider message carefully, if one is displayed. It may contain specific guidance about the failure.
- Review the payroll data for the pay period β check attendance records, earnings, deductions, and employee information for any anomalies.
- Correct any issues identified and resubmit payroll.
- If the error persists and no provider message is displayed, contact your payroll provider with the details of the failed submission for further investigation.
Tips
- Review payroll data before submitting. Check that all attendance records are complete, commissions have been calculated, and no employee has a negative net pay before initiating a payroll submission. Catching issues before submission avoids the need to resubmit.
- Keep your payroll provider account in good standing. Monitor your payroll provider account regularly for failed payments or account alerts. Unresolved account issues will block all future payroll submissions until resolved.
- Use the payroll lock setting to protect finalized pay periods. Once a pay period has been successfully submitted, the payroll lock prevents accidental changes to attendance, tips, and commission data. Confirm the lock is applied after each successful submission.
- Check the pay period dates carefully. Submitting payroll for the wrong pay period is a common cause of the "payroll already submitted" error. Always confirm the pay period dates before initiating a submission.
Troubleshooting
The same error appears every time I resubmit payroll.
Verify that you have fully resolved the underlying issue before resubmitting. For example, if the error is about negative net pay, confirm that all affected employees now have a non-negative net pay by reviewing their earnings and deductions again. Resubmitting without resolving the root cause will produce the same error.
I resolved the failed payments with the provider, but the "business not in good standing" error still appears.
Allow a few minutes for the payroll provider's account status to update after resolving failed payments. If the error persists after waiting, log in to your payroll provider account and confirm that all account holds have been fully cleared before resubmitting.
I cannot edit attendance or commission data for the pay period.
The pay period may be under payroll lock. Payroll lock prevents changes to attendance, tips, and commission data after a specified number of days following the pay period end date. Check the payroll lock configuration in your organization's employee settings. If the lock needs to be lifted to correct an error, contact your organization's administrator.
The fallback error message appears and I do not know what caused the failure.
Note the exact time of the failed submission and contact your payroll provider with that information. The provider can review their system logs to identify the specific cause of the failure and advise on the correct resolution steps.
Payroll was submitted successfully but employees report they were not paid.
Confirm with your payroll provider that the submission was processed and funds were disbursed. A successful submission in Zenoti indicates that the payroll data was accepted by the provider, but disbursement timing depends on the provider's processing schedule and the employees' bank processing times.