This help guide explains how to use Tanda's IRD Gateway integration for New Zealand payroll. It covers connecting your Tanda account to the IRD, submitting employee information, filing payday information after each pay run, and using CSV files as a fallback.
This help guide covers:
Connecting to the IRD
Before you can submit employee or payday information directly from Tanda, you'll need to connect your account to the IRD gateway.
How to connect
Navigate to Payroll > Settings
Find the IRD Gateway section
Click Connect to IRD
A popup window will open asking you to log in to your myIR account
Enter your myIR credentials and authorise Tanda to submit on your behalf
Once authorised, the popup will close and you'll see a confirmation that your account is connected
Tanda securely stores your IRD connection tokens and will automatically refresh them when needed. If your connection expires or is revoked, you can reconnect at any time from the same settings page.
Once connected, you will be able to submit Employee Details and Employment Information (Pay Details) directly to the IRD from the relevant pay run.
How to disconnect
If you need to disconnect your IRD account, go to Payroll > Settings and click Disconnect next to the IRD Gateway section. This will revoke the connection and clear all stored tokens.
Employee information submissions
When you run payroll, Tanda automatically detects new, modified, or terminated employees and prepares submissions to the IRD. This keeps the IRD's records in sync with your employee data.
What triggers a submission
Tanda checks your employee data against what the IRD currently has on file and creates submissions for the following scenarios:
New employees — Any employee included in a pay run who doesn't yet exist in the IRD's records will be submitted as a new employee
Modified employees — If any tracked employee fields have changed since the last successful submission, a modification will be detected (see below)
Terminated employees — Employees with an employment end date that falls within the pay run period will be submitted as terminated
How modifications are detected
Tanda uses two methods to detect changes to employee information:
Direct comparison — For the following fields, Tanda compares the current value in your account directly against the IRD's records:
IRD number
Name
Tax code
Date of birth
Employment start date
Last updated date — For address and KiwiSaver details, the IRD does not return these fields for comparison. Instead, Tanda checks whether these records have been updated since the last successful submission. If they have, a modification is flagged.
How to review and submit
After posting a pay run, navigate to the Employee Submissions tab for that pay run
Click Sync to check for any new, modified, or terminated employees
Review the list of pending submissions — each entry will show the employee name, the type of change (Add, Modify, or Terminate), and which fields have changed
If data needs to be updated in Tanda to match the IRD, you can do so then re-sync to check the submissions again.
Click Submit All to send all pending submissions to the IRD, or submit individual employees one at a time
Once submitted, you can view the IRD's response for each employee by clicking View Response
Note: All employee submissions must be completed before you can file payday information for the same pay run.
Payday information filing
Payday filing (also known as Employment Information or EI filing) is the process of submitting your pay run details to the IRD. This includes gross earnings, PAYE, student loan deductions, KiwiSaver contributions, and other tax-related information for each employee.
What is included
Each payday filing submission includes:
Total gross earnings and PAYE/tax withheld for the pay run
Student loan deductions (PAYE, SLCIR, SLBOR)
Child support deductions
KiwiSaver contributions (employee and employer)
Employer superannuation contribution tax (ESCT)
Per-employee breakdown of all earnings and deductions
How to file
Ensure the pay run has been posted and all employee submissions have been completed
Navigate to the pay run and click Submit to IRD
Tanda will submit the filing to the IRD gateway
Processing timeline
After submitting, the IRD processes filings in stages:
Initial acknowledgement — Tanda checks for an initial status from the IRD approximately 10 minutes after submission
Overnight processing — The IRD processes submissions overnight (between 5pm and midnight NZ time). Tanda automatically checks for the final status the following morning
Final status — Once processed, the submission will show as either Processed (on time or late) or Failed
You can view the history of all payday filings and their current status by navigating to Payroll > EI Submissions.
CSV fallback files
If you're unable to submit directly through the IRD gateway, Tanda can generate CSV files that you can upload manually to the IRD's myIR portal. Two CSV files are available for each posted pay run.
Employment Information CSV
This file contains the same payday filing data that would be submitted via the gateway — earnings, tax, deductions, and KiwiSaver details for each employee in the pay run.
Employee Details CSV
This file contains personal information for new and terminated employees, including contact details, date of birth, bank details, and KiwiSaver eligibility.
How to download
Navigate to the posted pay run
Click the Employment Information CSV or Employee Details CSV download button
The file will download to your computer
Log in to myIR and upload the file in the appropriate section
These CSV files follow the IRD's official payday filing file upload specification and can be used as a fallback whenever the direct gateway connection is unavailable.