View and adjust employee leave balances
View leave balances, manually adjust balances, and download audit history for employee leave management in Zenoti Integrated Payroll (ZIP).
Audience: Managers and HR administrators who manage team leave balances in ZIP.
On this page
- Before you begin
- View leave balances
- Fields in the Team's leave balance view
- Adjust a leave balance
- View and download audit history
- Tips
- Troubleshooting
- Related articles
Before you begin
ZIP must be enabled for your organization by Zenoti's implementation team.
The
enable_ptosetting must be active for your organization.You need the following permissions under Employee Manager in your security role:
Permission: Leave Balances β View β Required to view leave balances on the Team's leave balance tab. Admin path: Configuration > Security > Security Roles > [your role] > Employee Manager > Leave Balances > View
Permission: Leave Balances β Manage β Required to manually adjust a leave balance. Admin path: Configuration > Security > Security Roles > [your role] > Employee Manager > Leave Balances > Manage
Permission: View PTO Balance β View All β Required to view balances for all employees, including when creating a leave request on behalf of an employee. Admin path: Configuration > Security > Security Roles > [your role] > Employee Manager > View PTO Balance β View All
Permission: Edit PTO Balance β Edit All β Required to adjust balances for all employees. Admin path: Configuration > Security > Security Roles > [your role] > Employee Manager > Edit PTO Balance β Edit All
Each employee must have a leave policy assigned before their balance appears in this view. For policy setup, see Create and assign leave policies.
View leave balances
- Navigate to Employee > Leave Management.
- On the Manage Leaves page, select the Team's leave balance tab.
- Review balances by employee and leave type.
Fields in the Team's leave balance view
The following fields appear on the Team's leave balance tab. Column availability depends on the leave policy assigned to each employee β some policies track accrual, others do not.
| Field | What it shows |
|---|---|
| Employee | The employee's name and identifier. |
| Leave type | The leave category (for example, PTO, sick leave, or personal time) governed by the employee's assigned policy. |
| Available balance | The hours the employee can currently take, after accruals and adjustments. |
| Pending balance | Hours already requested but not yet approved or taken. |
| Accrued hours | Hours credited to the balance by the accrual schedule for the current policy period. |
| Used hours | Hours consumed so far in the current policy period. |
For policy-specific field definitions, review the employee's leave policy at Admin > Payroll > Leave Policies.
Adjust a leave balance
Use this procedure to manually add or remove hours from an employee's leave balance. Every adjustment is recorded in the audit history.
Important: If you are migrating an employee from one leave policy to another, balances do not carry forward automatically. After completing the policy migration β delinking the employee from the current policy and assigning the target policy β use this procedure to manually transfer any balance the employee has earned. See Migrate an employee from one leave policy to another.
Worked example: A provider named Jordan has 24 accrued PTO hours but transferred from the quarterly accrual policy to the annual accrual policy mid-year. After the migration, their PTO balance shows 0. You navigate to Team's leave balance, locate Jordan, and enter +24 hours with the reason "Policy migration β carry-forward balance" and an effective date matching the migration date.
- Navigate to Employee > Leave Management and select the Team's leave balance tab.
- Locate the employee whose balance you want to adjust.
- Select the option to adjust the balance next to the relevant leave type.
- Enter the following details:
- Adjustment amount β Enter a positive number to add hours or a negative number to remove hours.
- Reason β Enter a description of why the adjustment is being made. This text appears in the audit history.
- Effective date β Enter the date when the adjustment should take effect.
- Save the adjustment.
The adjustment is recorded immediately in the audit history and reflected in the employee's available balance.
View and download audit history
The audit history shows a record of every balance change for an employee, including accruals, manual adjustments, and approved leave requests.
View audit history
- Navigate to Employee > Leave Management and select the Team's leave balance tab.
- Locate the employee whose history you want to review.
- Select the option to view audit history for that employee.
The history displays each change with the date, type of change, amount, and the user who made the change.
Download audit history
- Navigate to Employee > Leave Management and select the Team's leave balance tab.
- Locate the employee.
- Select the option to download audit history.
A CSV file containing all balance changes for the selected employee is downloaded to your device.
Tips
- Review audit history before adjusting. Before entering a manual adjustment, view the audit history to confirm the current balance discrepancy. This prevents duplicate or conflicting adjustments.
- Use descriptive reasons. The reason you enter during an adjustment is permanently recorded in the audit history and appears in downloaded CSV exports. Write reasons that will be clear to other managers reviewing the history later β for example, "Policy migration carry-forward" or "Correction for approved leave not yet deducted."
- Download CSV for payroll reconciliation. If you need to reconcile leave balances against payroll records, download the audit history CSV and cross-reference it with the payroll register. See Reporting for available payroll reports.
Troubleshooting
| Problem | Resolution |
|---|---|
| An employee does not appear on the Team's leave balance tab. | Confirm the employee has a leave policy assigned. Employees without an assigned leave policy are not listed. See Create and assign leave policies. |
| The balance adjustment option is unavailable or greyed out. | Confirm your security role includes the Leave Balances β Manage permission and the Edit PTO Balance β Edit All permission. See Configure role permissions for leave management. |
| An adjustment was saved but the available balance has not updated. | Verify the effective date entered for the adjustment. If the effective date is in the future, the balance will reflect the change on that date, not immediately. |