Feature Overview Status: Enabled by Zr Ware® Support
This feature simplifies the payroll process by allowing your team to:
Import Hours: Easily upload CSV files containing employee hours.
Manage Compensation: Configure individual employee wages within the system.
Generate Reports: Create payroll reports based on uploaded hours, current wages, and commissions.
Adapt: Update employee wages as needed; reports automatically use the correct value for the specified pay period.
Audit: View a complete history of all past payroll runs.
Important Note: Commission percentages are currently hard-coded. Adjusting front-end payroll percentage settings will not alter the calculation.
Table of Contents
- Payroll Processing Procedure
- Admin Payroll Pages
- Splitting Revenue between technicians
- Technician App View
- System-Wide Commission Rules
- Payroll Glossary
1. Payroll Processing Procedure
Follow these steps to effectively process payroll within Zr Ware®:
Retrieve Data: Obtain the timecard report from your timekeeping system (e.g., Paylocity).
Upload Report: Navigate to Admin > Payroll Settings > Run Payroll and upload the timecard report.
-
Link Employee IDs (New Employees Only):
Click "Click here to return to old admin view."
Navigate to Admin > Payroll > Payroll.
Link the Timecard Report ID to the corresponding Zr Ware® profile for each new hire.
-
Set Wages (New Employees Only):
While in the legacy view, navigate to the Wage tab.
Input wage information for new employees.
> Note: Commission settings in this tab are disabled.
-
Input Adjustments:
Return to the standard view (click V2 in the upper right).
Go to Admin > Payroll Settings > Adjustments.
Add necessary adjustments (e.g., cash tips, deductions, direct pay modifications).
-
Generate Report:
- Go to Run Payroll and click Run Payroll.
- Result: Payroll becomes viewable to technicians in the mobile app with message “This payroll pay period is still in progress. This information is subject to change.” Technicians can view it and request adjustments.
-
Complete Report:
- Click Complete to notify Payroll Leaders that the payroll is finished and ready for their review.
-
Review:
- Payroll Leaders review the submitted completed reports from the Payroll > Management view.
-
Publish:
- Payroll leaders click Publish in the admin view.
- Result: Technicians are notified that payroll is finalized.
External Upload: Upload the generated report to your processing system (e.g., Paylocity).
2. Admin Payroll Pages
Admin > Payroll Management
Admin > Payroll
Admin > Payroll Settings
- Run Payroll
- Settings(Not used anymore)
- Adjustments
A. Wage
Location: Admin > Payroll > Wage
View and edit employee wages here.
Add Wage: Click the Green Plus (+) button to create a new wage.
History: Click the dropdown arrow on the left to view wage history.
Edit: Click on an employee row to edit their current wage.
Note: Commission inputs here do not function. Commission percentages are hard-coded.
B. Payroll
Location: Admin > Payroll > Payroll
This list shows users uploaded via Payroll IDs.
Unlinked Users: If a row lacks a User ID, the payroll data is not yet linked to a Zr Ware account.
Linking: Click a row to link the Payroll User to a Zr Ware User.
Search/Filter: Use the search bar for names/IDs or filter by Active/Deactivated status.
C. Pay Period
Location: Admin > Payroll > Pay Period
Edit specific payroll details here.
Search: Filter by Start/End date, User Name, Payroll ID, or Work Date.
Edit Daily Hours: Click on a specific day for an employee to update hours for that date.
D. Run Payroll
Location: Admin > Payroll Settings > Run Payroll
Upload, view, and process payroll.
Filters: Filter by Year or Pay Period.
Audit: View all payrolls created for a specific time period.
-
Run Payroll: Calculates hours and opens the report in a new window.
V1: Payroll run before department threshold grouping.
V2: Payroll run after department threshold grouping.
Edit Hours: Link to the legacy page to view/edit daily hours.
+ Upload Pay Period: Upload the Paylocity CSV. Ensure strict adherence to the required format.
E. Adjustments
Location: Admin > Payroll Settings > Adjustments
Input any manual financial changes here, including:
Cash Reported Tips
Deductions
Direct Pay Adjustments
Memo dropdown will have options based on the selected payroll adjustment type.
Remember to save your changes!
Back to the admin page overview
F. Settings (Legacy/Deprecated)
Location: Admin > Payroll Settings > Settings
Note: This section is largely deprecated. However, it displays historical configuration for NPS Bonus Thresholds, Revenue Benchmarks, and Lifetime Benchmarks.
Blank Rows: Indicate the benchmark applies to the department listed directly above.
Department Groups: Click "Add" to create a new group of departments with shared benchmarks.
Copying: Click the copy button to duplicate a benchmark for slight modification (useful for tiered structures).
Back to the admin page overview
G. Payroll Management
Location: Admin > Payroll Management
This high-level dashboard allows Payroll Leaders to view and manage the payroll status across multiple bases from a single screen.
Note: This page is only viewable by users with the "Payroll Management" permission. This permission can only be granted by someone holding the "User - Grant Payroll Management/publish" permission.
Filters: Use the dropdowns in the top right to filter the view by Year and Pay Period.
Base Name: Click on a specific base's name (e.g., Zerorez - Bay Area) to navigate directly to that base's specific payroll environment for review.
Payroll Status: Quickly identify where a base is in the payroll cycle (e.g.,
NOT_RUN,COMPLETED,PUBLISHED).Audit Trail: Track accountability with timestamps and user records under the Completed Date, Completed By, Published Date, and Published By columns.
Actions: Click the three vertical dots to access additional localized actions for a specific base.
Back to the admin page overview
3. Splitting Revenue
Location: Client Screen > Action Dropdown > Edit Work Users
Use this feature to split revenue between technicians for a specific job.
Requirements: You must be an Admin, and the base must have the Payroll feature enabled.
Function: Adjust the
split_revenue_multiplicandto allocate revenue share.
- View this link for more info on this page.
4. Technician App View
Technicians access payroll via the Performance Dashboard in the mobile app.
Navigate to Performance Dashboard.
Select Pay (bottom left).
Scroll to Details and click the down arrow for a breakdown.
Status Messages:
In Progress: "This payroll pay period is still in progress. This information is subject to change."
Finalized: "This payroll pay period has been published."
5. System-Wide Commission Rules
General Settings (All Departments)
Pay Period: 6 Weeks (3 Pay Periods).
Redo Deduction/Bonus: 0% / 0.00% (No deduction/bonus currently active).
Bonus Multipliers These percentages are added to the employee's commission rate based on performance.
| Metric | Tier/Achievement | Bonus % |
|---|---|---|
| NPS Score | 85 | +1.00% |
| 90 | +2.00% | |
| 100 | +3.00% | |
| Lifetime Revenue | $500,000 | +1.00% |
| $1,000,000 | +1.50% | |
| $1,500,000 | +2.00% | |
| $2,000,000 | +2.50% | |
| $2,500,000 | +3.00% | |
| $3,000,000 | +3.50% | |
| $3,500,000 | +4.00% | |
| $4,000,000 | +4.50% |
Department Specifics
Each department has a different Base Commission and Added Value (AV) Bonus structure.
| Department | Base Commission | Max Potential | Added Value (AV) Bonus Structure |
|---|---|---|---|
| Residential / Rugs | 16.00% | 27.50% |
25%: +1.0% 30%: +2.0% 35%: +3.0% 40%: +4.0% |
| Commercial | 18.00% | 25.50% | No AV Bonus listed. |
| Ducts | 15.00% | 26.50% |
15%: +1.0% 20%: +2.0% 25%: +3.0% 30%: +4.0% |
Summary Comparison
| Department | Base Comm. | Max AV Bonus | Max NPS Bonus | Max Lifetime Bonus | Total Max % |
|---|---|---|---|---|---|
| Residential | 16.00% | +4.00% | +3.00% | +4.50% | 27.50% |
| Commercial | 18.00% | — | +3.00% | +4.50% | 25.50% |
| Ducts | 15.00% | +4.00% | +3.00% | +4.50% | 26.50% |
6. Payroll Glossary
| Term | Definition |
|---|---|
| Cash Reported Tips | Total of Cash Reported Tips stored in Admin > Payroll Settings > Adjustments. |
| Commission | Calculated as: Pay Period Revenue Commission + NPS Bonus + Total Revenue Bonus + Total Redo Bonus + Total Adjustments. |
| Deductions | Sum of all deductions entered in Adjustments (e.g., "Pay Fixed Amount"). |
| Gross Pay | The greater value between "Hourly" and "Commission" calculations. |
| Gross Total | Gross Pay + Cash Tips + Paycheck Tips + Salary + Vacation Pay - Deductions. |
| Holiday | Number of holiday hours recorded for the pay period. |
| Hours | Number of hours the technician worked during the pay period. |
| Lifetime Payroll Revenue | Sum of all payroll revenue for all time, up to the end date of the current period. |
| Net Commission | The greater of: ("Commission" - "Hourly" + "Fixed Adjustments") OR 0. |
| Net Min | Gross Total / ((1.5 * OT) + Hours). |
| NPS 6 Week Rolling |
NPS score of reviews from the last 6 weeks. (Promoters - Detractors) / Total Reviews Note: Considers all scores, unlike L360 which may discard older reviews from the same customer. |
| NPS Bonus |
$10 per promoter review meeting the base threshold (9 or 10). Condition: Rolling Score must meet the base's 6-week threshold. |
| OT | Overtime hours worked during the period. |
| Paycheck Collected Tips | Tips recorded directly in Zr Ware. Paid to primary tech unless split settings are enabled. |
| Payroll Revenue | Sum of: (Quantity × Price × Payroll % of line items) for completed bookings. |
| Probationary Period | The lesser of: 10 weeks OR the number of weeks since training completion. |
| Total Adjustments | Sum of fixed commission adjustments + (Commission Amount × Dept Commission %). |
| Total Hourly Pay | Wage × (Hours + (1.5 × OT)). |
| Total Redo Bonus |
Redo Scalar × (Redos Performed - Redo Count). Scalar = Configured bonus amount. Redos Performed = Jobs this tech redid. Redo Count = This tech's jobs redone by others. |
| Variance | Shows payroll revenue per day due to split bookings. These values are already included in total revenue; they are not added separately. |
| Wage | Hourly pay rate. If multiple wages exist in a period, the one with the latest application date applies to the whole period. |
Comments
0 comments
Please sign in to leave a comment.