Employee payroll configuration — per-center-business config response
When Zenoti retrieves payroll configuration for an employee, it returns a structured response that tells administrators whether a configuration record exists for a given employee–center–business combination, what employment type applies, and whether the employee is included in payroll processing. Understanding this response helps administrators identify gaps in payroll setup and correct them before running payroll.
Note: For conceptual background on how payroll is calculated and what settings drive it, see Configure overtime detection and the employee payroll settings in the Configurations category.
Audience: Payroll administrators and center managers who configure and audit employee payroll records.
On this page
Before you begin
- Your organization must have at least one active center with employees assigned to it.
- You must have access to the employee payroll configuration area in Zenoti.
- Pay periods must be configured for the relevant center before payroll configuration records can be meaningfully reviewed. For pay period setup, see the employee settings documentation in the Configurations category.
Permission: You need permission to view and edit payroll configuration for employees. Contact your Zenoti administrator if you cannot access this area.
Steps
Understand the payroll configuration response
When Zenoti looks up payroll configuration for an employee at a specific center and business combination, it returns three key pieces of information:
| Field | What it tells you |
|---|---|
| Employment type | Whether the employee is classified as Regular or Contractor for this combination |
is_payroll_needed |
Whether the employee is included in payroll processing for this center and business |
is_configured |
Whether a stored payroll configuration record exists for this employee–center–business combination |
These three fields together determine how Zenoti handles the employee during payroll generation. An administrator reviewing payroll setup should check all three fields for each employee–center–business combination they manage.
Interpret the is_configured flag
The is_configured indicator tells you whether a payroll configuration record has been explicitly saved for the employee at the given center and business.
- When a configuration record exists (
is_configuredis true), Zenoti uses the stored values — employment type, payroll inclusion, and any associated pay rates or commission plans — when generating payroll. - When no configuration record exists (
is_configuredis false), Zenoti does not leave the form blank. Instead, it presents Core default values so the administrator can review and complete the setup without starting from scratch.
Important: The absence of a stored configuration record does not mean the employee is excluded from payroll. It means the configuration has not yet been explicitly saved. Review the default values presented and save a configuration record to confirm the intended setup.
Interpret the is_payroll_needed flag
The is_payroll_needed flag indicates whether the employee is included in payroll processing for the specified center and business combination.
- When
is_payroll_neededis true, Zenoti includes this employee when payroll is generated for the center and business. - When
is_payroll_neededis false, the employee is excluded from payroll for this combination. This is appropriate for employees who work at a center but are paid through a different center or business unit, or for contractors whose compensation is handled outside Zenoti payroll.
Review this flag carefully for employees who work across multiple centers. The flag is evaluated per center–business combination, so an employee may be included in payroll at one center and excluded at another.
Interpret the employment type field
The employment type field classifies the employee for payroll purposes at the given center and business combination. Only two values exist:
| Employment type | Description |
|---|---|
| Regular | The employee is a standard employee. This is the default value when no configuration record exists. |
| Contractor | The employee is classified as a contractor for this combination. |
Employment type affects how pay rates, commissions, and deductions are applied during payroll generation. Verify that the employment type matches the employee's actual classification before saving a configuration record.
Review default values presented when no configuration exists
When Zenoti finds no stored configuration record for an employee–center–business combination (is_configured is false), it presents Core default values rather than an empty form. This prevents administrators from inadvertently saving an incomplete or blank configuration.
The default values presented are:
- Employment type: Regular
- Payroll inclusion (
is_payroll_needed): Determined by the Core defaults for the organization
Worked example: An administrator opens the payroll configuration for a new employee, Jordan, at the Downtown center. Because Jordan was recently added and no payroll record has been saved yet,
is_configuredreturns false. Zenoti displays the form pre-filled with employment type Regular andis_payroll_neededset to the organization default. The administrator confirms these values are correct for Jordan's role, then saves the record. After saving,is_configuredreturns true for Jordan at the Downtown center.
Review each pre-filled field before saving. If the defaults do not match the employee's actual situation — for example, if the employee should be classified as Contractor — update the field before saving the configuration record.
Tips
- Audit new employees promptly. When an employee is added to a center, their payroll configuration record does not exist until it is explicitly saved. Run a payroll configuration review for all new employees before the next pay period closes.
- Check all center–business combinations separately. An employee who works at multiple centers has a separate payroll configuration record for each center–business combination. Confirm that
is_payroll_neededand employment type are set correctly at every center where the employee works. - Use the Regular default as a starting point, not a final answer. The default employment type of Regular is a safe starting point, but it must be verified against the employee's actual classification. Saving an incorrect employment type can affect commission calculations and pay rate application during payroll generation.
Troubleshooting
The payroll configuration form appears blank instead of showing default values.
This can occur if the system cannot retrieve Core defaults for the organization. Verify that the organization's payroll settings are fully configured, including pay period and payroll controls. If the issue persists, contact your Zenoti administrator to confirm that payroll settings are saved at the organization level.
An employee appears to be excluded from payroll unexpectedly (is_payroll_needed is false).
Check whether the employee has a saved configuration record for the specific center and business combination. If is_configured is false, no record has been saved and the displayed value may reflect a default rather than an intentional exclusion. Open the configuration, confirm the correct value for is_payroll_needed, and save the record.
The employment type shows Regular but the employee is a contractor.
If is_configured is false, the displayed employment type is the Core default (Regular) and has not been saved. Update the employment type to Contractor and save the configuration record before the next payroll run. If is_configured is true, the value was previously saved as Regular — edit the record and save the corrected employment type.