NZ Payday Filing
New Zealand payday filing: build the IRD Employment Information (EI) return file per pay run with IRD-number validation, ESCT and KiwiSaver - own models, no Enterprise dependency.
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 — an HEI2 header carrying the
employer, payday and the control record count and amount totals, and
a DEI line per employee, with amounts in cents and dates
as CCYYMMDD — matching the IRD payday filing file-upload
specification 2026-2027 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 a computed NZ payroll run, 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 & 20 (Community).
Screenshots
Ei Return Ei 2026 0001 3 Emp
Employment Information Retur
Update date: 2026-10-01
User guides (PDF)
Related modules
NZ KiwiSaver PAYE
New Zealand payroll for Odoo: KiwiSaver, PAYE income tax, ACC earner levy, ESCT and student-loan deductions per Inland Revenue.
New Zealand Leave Act
NZ Holidays Act 2003 compliance for Odoo: OWP/AWE annual holiday pay, BAPS daily-pay (RDP/ADP) for sick, bereavement, public and alternative holidays, Mondayisation, and leave-liability valuation.
NZ PINT A-NZ Sender
New Zealand PINT A-NZ (Peppol BIS) UBL e-invoice generator with BYOK Peppol access-point dispatch; NZBN + GST number validation