Skip to main content

2023 Income tax assessments | From now until the end of July we’re issuing income tax assessments. Most people will receive theirs by 10 June. Timelines at the end of the tax year.

Inland Revenue Inland Revenue
  • About us
    • About us
    • IR careers
  • News
    • Media releases
    • Updates
    • Subscribe
    • Seminars
  • Related Websites
    • Tax Technical
    • Tax Policy
    • International
  • Contact us
    • Contact us
    • Media queries
    • Tax Technical queries
    • Tax Policy queries
  • English
Register myIR login
myIR login
Individuals and families Ngā tāngata me ngā whānau
  • IRD numbers Ngā tau IRD
  • Income tax for individuals Te tāke moni whiwhi mō ngā tāngata takitahi
  • File my individual tax return Te tuku i tētahi puka tāke takitahi
  • Support for families Ngā tautoko i ngā whānau
  • KiwiSaver Poua he Oranga
  • Student loans Student loans
  • Self-employed Mahi ā-kiri
  • More... Tāpiri atu…
Business and organisations Ngā pakihi me ngā whakahaere
  • Income tax Tāke moni whiwhi mō ngā pakihi
  • Employing staff Te tuku mahi ki ngā kaimahi
  • KiwiSaver for employers Te KiwiSaver mō ngā kaituku mahi
  • Goods and services tax (GST) Tāke mō ngā rawa me ngā ratonga
  • Non-profits and charities Ngā umanga kore-huamoni me ngā umanga aroha
  • International Tāwāhi
  • More... Tāpiri atu…
Intermediaries and others Ngā takawaenga me ētahi atu
  • Tax agents Ngā māngai tāke
  • Bookkeepers Te kaikaute
  • PAYE intermediaries Ngā takawaenga PAYE
  • Payroll bureaus Ngā tari utu ā-rārangi
  • Digital service providers Ngā kaiwhakarato pūmanawa rorohiko
  • More... Tāpiri atu…
About us
  • About us
  • IR careers
News
  • Media releases
  • Updates
  • Subscribe
  • Seminars
Related Websites
  • Tax Technical
  • Tax Policy
  • International
Contact us
  • Contact us
  • Media queries
  • Tax Technical queries
  • Tax Policy queries
English
Register
myIR login
Inland Revenue
Home
Individuals and families Ngā tāngata me ngā whānau
Popular pages Ngā wharangi rongonui
Cost of Living Payment Utu mō te utu oranga IRD numbers Ngā tau IRD File my individual tax return Te tuku i tētahi puka tāke takitahi Support for families Ngā tautoko i ngā whānau Managing my tax Te whakahaere i taku tāke
More individuals and families
Familes Ngā whānau
Working for Families Working for families Child support Te tautoko tamariki Paid parental leave Te utu tiaki pēpi
Property and Trusts Ngā wharangi rongonui
Trusts and estates Ngā rōpū kaitiaki me ngā rawa tuku iho Property Ngā rawa
Individuals Ngā tāngata
Income tax for individuals Te tāke moni whiwhi mō ngā tāngata takitahi Non-residents Ngā kainoho-tāwāhi Self-employed Mahi ā-kiri Kiwisaver for individuals Kiwisaver mā te tangata takitahi Student loans Ngā pūtea taurewa ākonga Cryptoassets for individuals Ngā rawa whiti-rangi mā te tangata takitahi Unclaimed money
Situations Ngā āhuatanga
I am going overseas Kei te haere ahau ki tāwāhi I received an income tax assessment I whiwhi i ahau tētahi aromatawai tāke moni whiwhi I'm struggling to file and pay my tax
More situations
Business and organisations Ngā pakihi me ngā whakahaere
Popular pages Ngā wharangi rongonui
Covid-19 Businesses and organisations KOWHEORI-19 Ngā pakihi me ngā whakahaere File a companies income tax return - IR4 Te tuku i tētahi puka tāke moni whiwhi kamupene - IR4 Not-for-profits and charities PAYE calculator to work out salary and wage deductions Property Ngā rawa IRD numbers Ngā tau IRD
More business and organisations
Income tax Te tāke moni whiwhi
Types of business income Ngā momo moni whiwhi pakihi Tax rates for businesses Ngā pāpātanga tāke mō te pakihi Balance dates Ngā rā mutunga tau pūtea
GST Tāke hokohoko (GST)
Charging GST Te uta i te tāke hokohoko Claiming GST Te kerēme tāke hokohoko
Employing staff Te tuku mahi ki ngā kaimahi
Register as an employer Te rēhita hei kaituku mahi Paying staff Utu kaimahi Payday filing Te tāpaetanga rā utu Deductions from income Ngā tangohanga mai i ngā moni whiwhi Kiwisaver for employers Te KiwiSaver mō ngā kaituku mahi
International Tāwāhi
International tax for business Te tāke aowhānui mō ngā pakihi
Situations Ngā āhuatanga
I am starting a new business Kei te tīmata au i tētahi pakihi hou I am going to employ someone Kei te tuku mahi ahau ki tētahi tangata My business is making a loss Kei te hapa taku pakihi
More situations
Intermediaries and others Ngā takawaenga me ētahi atu
Intermediaries Ngā takawaenga
Becoming an intermediary Te tū hei takawaenga Getting authority to act Te whiwhi whakamanatanga Executive office holders Ngā kaipupuri tūnga whakahaere Linking client accounts Te honohono pūkete kiritaki Nominated person Te tangata kua whakaingoatia Tax pooling Te whakarōpū tāke Gateway services
More intermediaries and others
Tax agents Ngā māngai tāke
Agents answers Ngā Whakautu Māngai Tax agent status Te tūnga māngai tāke Extension of time arrangements Te whakaroa i ngā whakaritenga wā Managing consolidated groups Te whakahaere rōpū tōpū Income tax for individual clients of tax agents Te tāke moni whiwhi mā ngā kiritaki takitahi a ngā takawaenga News updates for tax agents
More tax agents
Digital service providers Ngā kaiwhakarato ratonga matihiko
Getting started guide About the developer portal Mō te tomokanga kaiwhakawhanake Gateway services architecture Te hanganga ratonga tomokanga Services catalogue Te putumōhio ratonga
More digital service providers
Roles Ngā tūranga
Tax agents Ngā māngai tāke Bookkeepers Ngā kaikaute PAYE intermediaries Ngā takawaenga PAYE Payroll bureaus Ngā tari ripanga utu kaimahi Other representatives Ētahi atu māngai
Search tips

Te tāpaetanga rā utu mā ngā ratonga tukuatu kōnae Payday filing through file upload services

Services catalogue
Services catalogue
  • Returns and information
    • Payday filing for digital service providers
      • Payroll calculations and business rules
      • Payday filing through gateway services
      • Payday filing through file upload services
        • Payday filing software developer kits

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


From 1 April 2021, we'll require all employers to use payday filing version 2.

Payday filing version 2

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 these 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 business use cases 2019 (PDF 237KB) Download guide

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

View and download the latest payday filing SDK, and archived versions from past years:

  • payday filing specifications for employee details (CSV and Excel formats), employment information, employment information amendments (all CSV format)
  • 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 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

Multi-Payment Option (MPO)

The Multi-Payment Option (MPO) account at Inland Revenue allows tax preparers to submit a single payment that must be posted against multiple customers’ accounts.

The detailed specifications for MPO filing

Multi Payment Option FIle Upload Specification 2020 (PDF 197KB) Download guide

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 onwards

Employee details (CSV format)

Employee details (Excel format)

Employment information (CSV format)

Employment information amendment (CSV format)


Release 2020 tax year 

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)


Pages in this section
  • Payday filing software developer kits The payday filing software developer kits for employment information and employee details.

Tasks

  • Getting started guide

Other Sites

  • Log in to the developer portal
  • Register for the developer portal

Moving between Inland Revenue sites

picto--truck

Heads up. We're taking you to our old site, where the page you asked for still lives

Continue to old site
Last updated: 28 Apr 2021
Jump back to the top of the page top
Inland Revenue Inland Revenue

FOLLOW US

  • Facebook
  • Twitter
  • Youtube
  • LinkedIn
  • Subscribe

CONTACT US

  • Contact Information
    • Contact us
    • Media queries
    • Tax Policy enquiries
    • Tax Technical enquiries
  • About us
  • Careers
  • International

SHARE THIS PAGE

  • Email this page
  • Linkedin
  • Facebook
  • Twitter

SHARE THIS PAGE

  • About the site
  • Conditions of use
  • Privacy
  • Glossary
  • Accessibility
  • Copyright
  • MyIR Help
© Copyright 2023 Inland Revenue
New Zealand Government
Shielded website