Skip to main content
Check out our new content, navigation and design for digital service providers.

COVID-19 - Level 1 If you've been affected by COVID-19, we may be able to help. Find out more

When payday filing through the myIR file upload service, employers must upload to us from their software:

  • employee information each pay cycle
  • details for new and departing employees. 

Payday filing business use cases  

The following are examples of sequences of the myIR file upload service operations that could be used to achieve a specific business outcome.

Keys

  • Employee details:  Dep = Departing
  • The numbers for each use case are the order in which these operations should be called when using this services.
Use case Employee details Employment information
New Amend Dep File Amend
1. First time employee - file employee details (including KiwiSaver enrolment), file employment information 1
2
2. New employee (existing KiwiSaver member) - file employee details, file employment information 1 2
3. Existing employee - file employment information on payday or within 2 days of payday 1 2
4. Existing employee - (opt out of KiwiSaver) file employee details, file employment information 1 2
5. Existing employee - amend previously filed employment information

1
6. Departing employee - file employee details, file employment information 1 2
Payday filing - myIR file upload services business use cases PDF 273KB Download form

Payday filing software development kits (SDKs) for myIR file upload services

Release 2021 tax year

View and download the payday filing SDK for the period April 2020 to March 2021:

  • what's new in this release
  • payday filing specifications for employee details (CSV and Excel formats), employment information, employment information amendments, and EMS and EDF payroll filing (all CSV format) for filing amendments to payroll schedules submitted before 1 April 2019.
  • casebook for employment information scenarios and examples
  • Excel template for employee details
  • sample files for employee details, employment information and employment information amendments.

Payday filing 2021 release software developer kits (SDK) on GitHub


Release 2020 tax year

View and download the payday filing SDK for the period April 2019 to March 2020:

  • payday filing specifications for employee details (CSV and Excel formats), employment information, employment information amendments, and EMS and EDF payroll filing (all CSV format) for filing amendments to payroll schedules submitted before 1 April 2019.
  • casebook for employment information scenarios and examples
  • Excel template for employee details
  • sample files for employee details, employment information and employment information amendments.

Payday filing 2020 release software developer kits (SDK) on GitHub


Find out more about the calculations and business rules that support payday filing.

Payroll calculations and business rules

Testing and support for file upload services

We provide support for development and testing of the payday filing myIR file upload services.

Please register your organisation in our developer portal to access support and to keep up to date with the latest release. Once registered you request access to our Test a file services.

Register for the developer portal


Alternatively, if you do not need support you can submit files to us to validate their compatibility with our payday filing specification. 

Select a file type to test:

Release 2021 tax year 

Employee details (CSV format) R 2021

Employee details (Excel format) R 2021

Employment information (CSV format) R 2021

Employment information amendment (CSV format) R 2021

 

Release 2020 tax year 

Employee details (CSV format) R 2020

Employment information (CSV format) R 2020

Employment information amendment (CSV format) R 2020


Payroll amendments - Pre-release 2020 tax year

Multi-payment option (MPO) for schedular payments 

Employer deduction schedule (EDS) for payroll intermediaries

Amend employer schedules

Payroll intermediary subsidy claim form (SCF)