New Zealand Payday Filing
Build the Inland Revenue Employment Information (EI) return file for every payday — IRD-number validated, ESCT & KiwiSaver ready
New Zealand employers must file an Employment Information return
within two working days of every payday. This module assembles
that EI return in the documented IRD file-upload layout, ready to upload
through your own myIR or gateway-services credentials. Built on Odoo
Community hr — no Enterprise payroll dependency.
EI return per pay run
One Employment Information document per payday: employer IRD number, the payday and pay-period dates, and a detail line per employee paid — IRD number, IR330 tax code, gross earnings, earnings not liable for ACC, PAYE, child support, student loan, KiwiSaver and payroll-giving donations, plus start / finish dates and a prior-period indicator.
IRD file-upload format
A record-typed CSV — a HED header, a DET
line per employee and a TRL trailer carrying the control
record count and amount hash totals — matching the IRD payday
filing file-upload specification so it loads cleanly in myIR.
Real IRD-number validation
Inland Revenue's official weighted modulus-11 check-digit algorithm — with the documented primary and secondary weight sets and the allocation-range check — runs on the company and every employee, so bad IRD numbers are caught before you file.
ESCT & KiwiSaver
The employer superannuation contribution tax is computed from each employee's ESCT-rate-threshold amount against an editable band table (10.5 / 17.5 / 30 / 33 / 39%), splitting the gross employer KiwiSaver contribution into ESCT withheld and the net amount reported.
Two-working-day deadline
The statutory filing due date is computed by counting two working days after the payday, skipping weekends and the nationwide public holidays — including Matariki and the mondayised holidays — and overdue returns are flagged in red.
Fast population
Populate the return from your NZ employees in one click, or paste a pay-run CSV from another system — each row is matched to an employee by IRD number, with the KiwiSaver and ESCT figures filled in.
BYOK transmission
This module builds the EI return file; it does not transmit it. Upload is performed through your own myIR or gateway-services credentials. Confirm all rates, thresholds and the file specification against the latest official Inland Revenue guidance before filing live.
Compatible with Odoo 18 & 19 (Community).
Screenshots
Ei Return Ei 2026 0001 3 Emp
Employment Information Retur
Update date: 2026-07-02