Skip to main content

myIR outage Some areas in myIR, such as child support, will be unavailable from 12am until 6am Sunday 20 September. Thank you for your patience.

Offices closed All Inland Revenue offices are currently closed to the public to help limit the spread of COVID-19.

COVID-19 - Level 2 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. 

For more details on how to file

File employment information with file upload

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 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

Express file transfer service

The express file transfer service in myIR provides a place to drop all payday related files. This includes all versions of EI and ED.  The service allows zip files to be uploaded as long as all the files in the zip are employer related that meet our specifications.

The following employer files are supported:

  • File transfer Payday schedules: Upload multiple payday employment information schedules.
  • File transfer Payday amendments: Upload amendments to multiple payday employment information schedules.
  • File transfer employee details: Upload new and departing employee details
  • Upload KiwiSaver file: Upload a KiwiSaver file to enrol multiple employees in KiwiSaver at the same time.
  • Upload compressed zip file: For this account upload one or more Non-payday or KiwiSaver files.
  • File transfer employer schedules: File transfer employer monthly schedules for multiple filing periods (IR348).
  • File transfer EMS amendments: Upload amendments to multiple employer monthly schedules (IR348).
  • File transfer employer deductions: Upload multiple employer deductions forms (IR345).

There is no test a file service for express file transfer. Individual files can be tested using the appropriate individual test a file service. The express file transfer service evaluates the files in the zip using the same validation as the individual test a file services, which can be found in the file specifications.

For more details on how to file

File employment information with express file transfer

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)