| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Employees (hr) |
| Community Apps Dependencies | Show |
| Lines of code | 1966 |
| Technical Name |
l10n_nz_payday_filing |
| License | OPL-1 |
| Website | https://gencbaris.com/odoo_plugins/ |
| Versions | 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Employees (hr) |
| Community Apps Dependencies | Show |
| Lines of code | 1966 |
| Technical Name |
l10n_nz_payday_filing |
| License | OPL-1 |
| Website | https://gencbaris.com/odoo_plugins/ |
| Versions | 18.0 19.0 |
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
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module