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
