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