New Zealand only: Piece-work functionality in SmoothPay is specific to New Zealand payrolls.
How piece work is paid
Piece workers are generally paid according to production rather than hours worked.
For example, an employee may be paid according to:
the number of sheep shorn
the number of bins picked
the number of vines completed
another measurable unit of production
Because the employee's earnings are based on production, two additional considerations apply:
the employee still needs to be paid for applicable paid rest breaks, even though they are not producing during that time
the employee's production earnings need to meet the applicable minimum wage for the time they worked
SmoothPay handles these using:
Paid Rest Break (PRB) transactions
Total Hours Worked (THW)
an automatically calculated Top-up based on minimum wage, where required
PRB and Top-up serve different purposes and can apply independently. An employee may require PRB without requiring a Top-up, or both may apply within the same pay.
Configure the employee as a piece worker
Before the piece-work functions can operate, the employee must be identified as a piece worker.
Go to the Staff screen.
Select the employee.
Select the Contract tab.
Select the nested Employment tab.
Click Edit.
Set Employment field to Piece work.
Save the changes.
This enables THW to be recorded against an employee's pay.
For more information about the employee's employment settings, refer to:
<Contract tab - Staff screen>
Create the piece-rate Allowance codes
Piece-work production is normally paid using Allowance codes.
Create a separate Allowance code for each type of production that needs its own description or rate.
For example, a shearing business may have separate codes for ewes and rams.
An Ewes code could be configured as:
Field | Setting |
Abbreviation | EW |
Description | Ewes shorn |
Classification | Taxable |
Calculation | Units × rate |
A separate Rams code can be created using an appropriate abbreviation and description, with the same Taxable classification and Units × rate calculation.
The rate does not need to be defined by the Allowance code itself. When processing the pay, the Units represent the quantity produced and the applicable Rate is entered against the transaction.
For example:
50 ewes × $1.50 = $75.00
For instructions on creating the codes themselves, refer to:
<Creating Allowance codes>
Create the Paid Rest Break and Top-up codes
Two additional Allowance codes are required for SmoothPay's piece-worker calculations.
Paid Rest Break
Create an Allowance code identified as the Paid Rest Break code.
For example:
Field | Setting |
Abbreviation | PRB |
Description | Paid Rest Break |
Classification | Paid Rest Break |
PRB is used to pay the employee for paid rest-break time that would otherwise produce no piece-work earnings.
When entering PRB in a pay, enter the Units as decimal hours only. Do not assign the rate manually. SmoothPay calculates the applicable rate automatically.
For example:
10 minutes = 0.167 hours
20 minutes = 0.333 hours
For an employee working five 8-hour days, with 20 minutes of paid rest breaks for each day:
0.333 × 5 = approximately 1.67 hours of PRB
PRB can be entered manually or supplied through an applicable payroll transaction import.
Top-up
Create another Allowance code for the minimum-wage Top-up.
For example:
Field | Setting |
Abbreviation | TOPUP |
Description | Top-up |
Classification | Top-up (not worked) |
Unlike PRB, the Top-up transaction is not normally entered manually.
Where all of the required conditions are met, SmoothPay creates the Top-up transaction automatically.
For more information about the broader minimum-wage functionality, refer to:
<Minimum wage>
Enable automatic piece-worker Top-ups
The applicable piece-worker settings are available under the Options tab in the Settings screen.
Auto-topup piece-worker pay (requires THW)
Auto-topup piece-worker pay should be enabled when paying piece workers.
This allows SmoothPay to compare the employee's relevant production earnings with their Total Hours Worked and automatically apply a Top-up where their earnings are below the required minimum.
For the automatic Top-up to operate:
the employee must be configured as Piece work
Auto-topup piece-worker pay must be enabled
an appropriately classified Topup Allowance code must exist
THW must be recorded for the pay
the employee's applicable earnings must fall below the amount required for their recorded THW
If no Top-up is required, no Top-up transaction is added.
Cumulative THW
Cumulative THW is relevant when THW is being imported.
Enable this option where multiple THW transactions may be imported for the same employee and those transactions need to be added together to produce the employee's total THW for the pay period, instead of one single THW total per employee.
For example, an import could contain one THW transaction for each day worked rather than a single total for the entire pay period.
If THW is being provided as one total value, cumulative THW is not required for that purpose.
Top-up to contract rate if greater than minimum
The Top-up to contract rate if greater than minimum option allows the Top-up calculation to use the employee's contract rate where that rate is greater than the applicable minimum wage.
For more information about the available Settings options, refer to:
<Minimum wage>
Record Total Hours Worked
Total Hours Worked (THW) tells SmoothPay how many hours of work the employee's production earnings relate to.
THW is essential to the automatic Top-up calculation because piece-work units themselves do not tell SmoothPay how long the employee spent producing them.
For example:
An employee may shear 50 ewes, but that quantity alone does not establish whether the work took 2 hours, 8 hours, or 20 hours.
THW provides that missing time component.
Enter THW manually
THW is manually enter by using the Summary button on the payrun control bar, in the Payrun screen
Enter the total hours in the THW field to record the THW.
Import THW
THW can also be supplied through the Pay transactions import using the alias "THW".
This is particularly useful where piece quantities and working time are coming from another time, attendance, or production system.
If multiple THW records are supplied for the same employee, consider whether Cumulative THW needs to be enabled.
For more information about importing payroll information, refer to:
Processing a piece worker's pay
A typical piece-worker pay therefore contains three different types of information:
Production
Enter the quantity produced against the applicable piece-work Allowance code(s) and enter the appropriate rate.Paid Rest Breaks
Enter the employee's PRB units in decimal hours manually. SmoothPay calculates the rate automatically.Total Hours Worked
Record THW manually through the Payrun Summary or supply it through an import.
If a minimum-wage Top-up is required, SmoothPay then creates the Top-up transaction automatically.
How PRB and Top-up interact
PRB and Top-up are separate calculations.
The Top-up exists to ensure that the employee's production earnings meet the required hourly value for their THW.
The PRB exists to pay the employee for paid rest-break time during which they were not producing pieces.
Where both apply, they are calculated independently from the pay before either adjustment is applied. The PRB value does not reduce the required Top-up, and the
Top-up does not replace the employee's paid rest-break entitlement.
This is why a pay may contain:
production payments only
production payments and PRB
production payments and a Top-up
production payments, PRB and a Top-up
Worked example
Consider a piece worker who has worked 40 hours during the week.
Their production is:
50 Ewes shorn × $1.50 = $75.00
30 Rams shorn × $2.00 = $60.00
Their piece-work production earnings are therefore:
$75.00 + $60.00 = $135.00
The employee's pay also records:
THW: 40.00 hours
PRB: 1.67 hours
The employee has not produced enough piece-work earnings to satisfy the required hourly value for their 40 hours worked, so SmoothPay automatically creates a Top-up.
In this example, the resulting pay is:
Payment | Units | Rate | Value |
Ewes shorn | 50.00 | $1.50 | $75.00 |
Paid Rest Break | 1.67 | $23.95 | $40.00 |
Rams shorn | 30.00 | $2.00 | $60.00 |
Top-up | 40.00 | $20.575 | $823.00 |
Gross pay |
|
| $998.00 |
The $823.00 Top-up, together with the employee's $135.00 production earnings, brings their earnings for the 40 THW to the required hourly value.
The $40.00 Paid Rest Break payment is then separately included for the employee's 1.67 hours of paid rest-break time.
The result demonstrates the two separate protections:
Top-up ensures the employee receives the required value for their working time.
PRB ensures they are also paid for their paid rest breaks.
How the Top-up & Paid Rest Break are calculated
Then structure it like this:
In this example, the applicable minimum hourly rate is $23.95 and the employee has recorded 40.00 THW.
SmoothPay first calculates the minimum amount the employee must receive for those hours:
40 hours × $23.95 = $958.00
The employee has already earned $135.00 from their piece-work production:
$75.00 Ewes shorn + $60.00 Rams shorn = $135.00
SmoothPay therefore calculates the remaining amount required:
$958.00 − $135.00 = $823.00 Top-up
The Top-up transaction is displayed across the employee's 40 THW, giving an effective Top-up rate of:
$823.00 ÷ 40 = $20.575 per hour
The resulting minimum-wage calculation is therefore:
$135.00 piece-work earnings + $823.00 Top-up = $958.00
or:
$958.00 ÷ 40 THW = $23.95 per hour
The Paid Rest Break is calculated separately.
In this example, the employee has 1.67 hours of paid rest-break time. SmoothPay applies the calculated average hourly rate of $23.95:
1.67 × $23.95 = $40.00
The Paid Rest Break value is not included when calculating the Top-up shortfall.
The final gross pay is therefore:
$958.00 minimum-wage-adjusted piece-work earnings + $40.00 Paid Rest Break = $998.00




