People Ops Buyer.

Payroll / New Zealand migration

NZ payroll migration: validate leave balances and retain their history

People Ops Buyer research desk · New Zealand · Payroll buyers migrating before the 2028 leave transition · Updated

Do not migrate New Zealand payroll by copying a single leave-balance column. Preserve its unit, work-pattern assumptions, anniversary dates and supporting history.

If you are buying now, require a separate plan for the 2028 leave transition—but do not switch today’s calculations to future rules.

Now
Current payroll migration and the future statutory transition are separate projects.
Evidence
A balance needs its unit, date, definition and supporting history.
Contract
Ask who owns validation now and the supplier’s later transition work.
In this guide
  1. Current rules continue until the 2028 transition
  2. Ask what the exported number actually includes
  3. Eighty hours is not one universal number of weeks
  4. Require an opening-balance evidence pack
  5. Specify support for the 2028 transition
  6. Resolve unexplained balances before switching

Current rules continue until the 2028 transition

MBIE states that the Employment Leave Act 2026 received Royal assent on 6 August 2026 and replaces the Holidays Act on 6 August 2028. The new rules apply from the beginning of an employee’s first pay period starting on or after that date.

Employment New Zealand’s guidance timeline says the Holidays Act remains in force and no employer action is required at the August–October 2026 stage. Further technical and employer guidance is scheduled in stages; the timetable is indicative.

Our buying view: do not replace functioning payroll merely because a new Act exists. If you have an independent reason to move now, make current migration quality and future product support visible in the proposal.

Ask what the exported number actually includes

PayHero’s opening-balance instructions distinguish leave already due, holiday earnings, holiday pay and the next anniversary. Its Current Leave Due field excludes estimated leave since the last anniversary, which the product calculates separately.

Confirm which components the old system includes in its exported balance. A source system’s “available” figure may not have the same meaning as the target field. Have the payroll owner explain the source definition before anyone maps the columns.

Write a short mapping note for each value: source field, meaning, unit, cutoff date, target field and validation owner. Carry unresolved differences as exceptions; do not make them disappear by forcing the totals to match.

Eighty hours is not one universal number of weeks

Use this fictional, deliberately simple example: both employees have an agreed accurate balance of 80 hours of leave due and unchanged regular work patterns. It illustrates units only; it is not the 2028 statutory conversion method.

Illustrative regular-pattern conversion
Fictional employeeEstablished weekly hours80 hours expressed as weeks
NZ-014080 ÷ 40 = 2 weeks
NZ-023280 ÷ 32 = 2.5 weeks

PayHero’s conversion guide describes division for regular weeks and separate consideration where patterns are variable or have changed. A default 40-hour divisor is not a company-wide answer.

For changed or unclear patterns, have the payroll specialist resolve the underlying history and appropriate treatment. Software importing a number successfully does not validate the number’s meaning.

Require an opening-balance evidence pack

  1. Agree the cutoff: identify the final old-system pay and the first new-system pay. Capture leave and corrections around that boundary.
  2. Preserve definitions: retain the source export, field descriptions, units, anniversaries and the relevant work-pattern history.
  3. Separate components: map leave due and other holiday-pay or estimated values to their proper target fields.
  4. Resolve exceptions: inspect changed patterns, negative balances and missing history individually. Record the decision and its owner.
  5. Reconcile the result: check the new system against the agreed source evidence and explain differences before the first live pay.

Use approved test records for the supplier demonstration. Include one employee with a simple regular pattern, one changed pattern and one leave-in-advance position. Have the payroll owner supply expected outcomes; do not invent an entitlement to make the software pass.

Specify support for the 2028 transition

Ask what the subscription includes as the supplier implements the new framework: product changes, customer guidance, conversion tools, testing support and any separately charged services. At this stage, a credible delivery plan is more useful than an unsupported claim that every edge case is already solved.

Two separate supplier deliverables
Buying nowPreparing for the transition
Validated opening data under current rules.A documented product roadmap tied to published guidance.
Retained source history and explained differences.A defined conversion, evidence and exception process when available.
Named implementation and payroll owners.Named responsibility for release communications and customer testing.
Clear current migration fees.Clear inclusion or exclusion of later transition services.

Do not assume a promise to update the software includes cleaning historical records or making employment-agreement decisions for the employer. Ask for the boundary in writing.

Resolve unexplained balances before switching

We would choose the provider that can explain and preserve the migration evidence over one that promises the quickest upload. Retained context helps the payroll team investigate both today’s discrepancies and later transition work.

We would hold a migration with unexplained opening differences. We would also challenge a supplier that uses the future reform to pressure a buyer into an unnecessary immediate switch.

This is a procurement and data-validation guide dated 2 October 2026. Have a qualified New Zealand payroll adviser resolve employee-specific leave treatment and validate the eventual transition against the applicable official guidance.

Questions buyers ask

Does the Employment Leave Act change NZ payroll leave calculations immediately?

MBIE says the Act replaces the Holidays Act on 6 August 2028, with the new rules applying from the employee’s first pay period starting on or after that date. Current rules still govern a migration in October 2026.

Can we copy annual leave hours straight into a weeks field?

No. Establish the source balance’s meaning and the appropriate work-pattern basis first. A simple division can illustrate regular unchanged patterns; changed or variable patterns need specific validation.

What should a payroll supplier deliver during migration?

An agreed cutoff, field and unit mapping, retained source history, resolved exceptions and reconciled opening balances. Future statutory-transition support should be scoped separately.

Sources and research scope

Official and provider primary material, including PayHero’s migration field definitions, inspected 2 October 2026. Fictional arithmetic is not employee advice or the statutory 2028 conversion method. No supplier readiness certification claimed.

  1. MBIE leave reformRoyal assent and 6 August 2028 commencement; indexed official text read after direct retrieval returned 403.
  2. Employment NZ guidance timelineCurrent rules remain; staged indicative technical/employer guidance.
  3. PayHero opening balancesSeparate leave due, holiday earnings/pay and anniversary fields.
  4. PayHero conversion guideRegular-week conversion and changed-pattern boundary.