View payroll plan history
Zenoti tracks the history of commission plan associations for each employee. When payroll is recalculated for a past period, the system uses the plan that was active during that period to ensure accurate historical calculations. This article covers how to view and understand plan association history.
On this page:
- Before you begin
- View plan association history
- How history affects payroll recalculation
- Related articles
Before you begin
- Commission plans must be enabled and configured. See Configure employee commissions.
Permission: View (under Payroll Plan) β Required to view payroll plan history. Grant it on the Payroll Plan row in the Employee Manager section of the security role (Configuration > Security > Security roles > the role > Permissions).
View plan association history
Commission plan associations are versioned internally by Zenoti. When an employee's plan assignment changes, the system records the effective date of the change. There is no dedicated "Plan History" tab on the Commission Plans page, but the versioned data is used automatically during payroll recalculation.
How history affects payroll recalculation
When payroll is regenerated for a past period:
- Employee-level and job-level slab configurations are versioned. The system uses the historical values from the pay period being recalculated, ensuring accurate retroactive calculations.
- Item-level commission overrides are not versioned. If payroll is recalculated, the system uses the latest item-level value, not the historical value at the time of the original calculation.
This distinction is important for understanding why recalculated payroll might produce different results if item-level overrides have changed since the original calculation.
Field-level details
Because there is no dedicated Plan History UI surface, there is no column-level reference for this article. Versioned plan data is stored internally and consumed automatically by the payroll recalculation flow. To audit the exact plan version applied to a specific pay period, or to request a point-in-time export of plan assignments for an employee, contact Zenoti Support.