Payroll submission failure β user-facing error messages
When payroll submission fails, Zenoti displays a specific error message to help you identify and resolve the issue before resubmitting. This article describes each error message, explains what causes it, and outlines the steps to resolve it.
Audience: Payroll administrators who manage payroll submission for one or more centers.
On this page
Before you begin
- Your organization must have payroll configured and at least one pay period defined.
- You need the following permissions to view and manage payroll:
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).
Permission: View (under General Settings) β Required to view the employee list and search employees. 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).
- Payroll submission errors appear at the point of submission. Review the error message carefully before taking corrective action.
- If your organization uses Zenoti Integrated Payroll, some error types are returned by the payroll provider. Contact your payroll provider representative if an unrecognized error message appears and no raw provider message is shown.
Steps
Understand the error messages
When payroll submission fails, Zenoti displays one of the following messages depending on the error type detected.
The following table summarizes each error and its cause.
| Error message displayed | Cause |
|---|---|
| "The business is not in good standing to process payroll, review failed payments and try again to run payroll." | The organization has failed payments that must be resolved before payroll can be processed. |
| "One or more employees have a negative net pay. Review their earnings and deductions, then resubmit payroll." | At least one employee's deductions exceed their earnings for the pay period, resulting in a negative net pay amount. |
| "This payroll has no payable earnings. Add at least one employee with earnings before resubmitting." | The payroll contains no employees with payable earnings for the selected pay period. |
| "This payroll has already been submitted." | The payroll for the selected pay period has already been approved and cannot be submitted again. |
| A raw provider message, or "Payroll submission failed. Please review and resubmit." | An unrecognized error occurred. If the payroll provider returned a message, that message is shown. Otherwise, the generic fallback message appears. |
Resolve a company not in good standing error
Error message: "The business is not in good standing to process payroll, review failed payments and try again to run payroll."
This error means the organization has one or more failed payments on record that prevent payroll processing.
- Navigate to Employee > Payroll.
- Review any failed payment records associated with the organization.
- Resolve each failed payment β this may involve updating payment method details or contacting your payroll provider.
- Once all failed payments are resolved and the organization is returned to good standing, return to the payroll submission screen and resubmit.
Important: Do not attempt to resubmit payroll until all failed payments are resolved. Repeated submission attempts while the organization is not in good standing will produce the same error.
Resolve a negative net pay error
Error message: "One or more employees have a negative net pay. Review their earnings and deductions, then resubmit payroll."
This error means at least one employee's total deductions exceed their total earnings for the pay period.
- Navigate to Employee > Payroll.
- Identify the employees with negative net pay. Review the payroll details for each affected employee.
- For each affected employee, check:
- Earnings β Verify that all service commissions, hourly pay, and other earnings are correctly recorded for the pay period.
- Deductions β Verify that commission deductions, standard deductions, and any invoice-level deductions are correctly configured and not overstated.
- Correct any data entry errors in earnings or deductions.
- If the negative net pay is the result of a legitimate deduction that exceeds earnings, adjust the deduction or earnings configuration as appropriate for your organization's policy.
- After correcting all affected employees, resubmit payroll.
Note: Deductions are configured at the commission plan level, slab level, and individual service or product level. Confirm which level is causing the excess deduction before making changes. Employee and job-level slab configurations are versioned and retain historical values; item-level overrides are not versioned and use the latest value.
Resolve a no payable earnings error
Error message: "This payroll has no payable earnings. Add at least one employee with earnings before resubmitting."
This error means the payroll for the selected pay period contains no employees with payable earnings.
- Navigate to Employee > Payroll.
- Verify that the correct pay period is selected.
- Confirm that at least one employee has recorded earnings for the pay period β for example, service commissions, hourly pay, or other payable amounts.
- If no earnings exist for the period, check whether:
- Attendance records have been entered for the pay period.
- Commissions have been calculated for the pay period.
- The correct center and pay period are selected.
- Add or correct earnings records as needed, then resubmit payroll.
Resolve a payroll already submitted error
Error message: "This payroll has already been submitted."
This error means the payroll for the selected pay period has already been approved. Zenoti does not allow a pay period to be submitted more than once after approval.
- Verify that you have selected the correct pay period. If you intended to submit a different period, select the correct one and proceed.
- If you need to make corrections to a pay period that has already been submitted, contact your payroll administrator or payroll provider to determine the appropriate correction process.
- If your organization allows overlapping pay periods, confirm that the period you are attempting to submit is not a duplicate of an already-approved period.
Important: Once a payroll has been approved, it cannot be resubmitted through the standard submission flow. Corrections to approved payroll must follow your organization's payroll correction policy.
Resolve an unrecognized error
Error message: A raw provider message, or "Payroll submission failed. Please review and resubmit."
This error appears when the submission fails for a reason that does not match any of the recognized error types. If the payroll provider returned a specific message, that message is displayed. Otherwise, the generic fallback message appears.
- Read the error message carefully. If a provider-specific message is shown, use that message to identify the issue.
- Review the payroll data for the selected pay period β check earnings, deductions, employee records, and pay period configuration for any anomalies.
- Correct any issues identified, then attempt to resubmit payroll.
- If the error persists and no provider message is shown, contact your payroll provider representative with details about the pay period and the steps you have already taken.
Tips
- Resolve errors in order of severity. Address company standing issues first, as they block all payroll processing regardless of other data quality. Then address negative net pay and missing earnings before resubmitting.
- Calculate commissions before submitting payroll. Ensure that commissions have been calculated for the pay period before submission. Unrecalculated commissions can result in missing or incorrect earnings that trigger submission errors.
- Check the payroll lock window. If the pay period falls within the payroll lock window configured for your organization, attendance records and commission recalculations may be restricted. Confirm the lock status before making corrections.
- Use the Employee Payroll Details report to audit earnings and deductions. Before resubmitting, review the report to confirm that all employees have accurate earnings and that no deductions produce a negative net pay result.
Troubleshooting
The same error appears after I resolve the issue and resubmit.
Verify that you saved all changes before resubmitting. For negative net pay errors, confirm that the correction was applied to the correct employee and pay period. For company standing errors, confirm with your payroll provider that the failed payment has been fully resolved on their end, not only on the Zenoti side.
I cannot identify which employees have negative net pay.
Navigate to Employee > Payroll and review the payroll details for the pay period. Look for employees whose net pay column shows a negative value. If the payroll report does not surface individual employee net pay clearly, use the Employee Payroll Details report to drill down by employee.
The payroll was submitted successfully in a previous period but fails now with an unrecognized error.
Unrecognized errors can result from changes to the payroll provider configuration, changes to the organization's payment method, or transient provider-side issues. Review whether any configuration changes were made since the last successful submission. If no changes were made, attempt resubmission after a short interval. If the error persists, contact your payroll provider.