31
Inland Revenue Payroll Software Developers Casebook 1 April 2018 to 31 March 2019 This document supports the IR Electronic Filing – Payroll Specification Document 1 April 2018 to 31 March 2019 V1.0 Prepared by: Inland Revenue, National Office, Wellington Date: 21 December 2017 Version: v1.0 In Confidence

Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

  • Upload
    vokiet

  • View
    221

  • Download
    4

Embed Size (px)

Citation preview

Page 1: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue

Payroll Software Developers Casebook

1 April 2018 to 31 March 2019

This document supports the IR Electronic Filing – Payroll Specification Document 1 April 2018 to 31 March 2019 V1.0

Prepared by: Inland Revenue, National Office, Wellington

Date: 21 December 2017

Version: v1.0

In Confidence

Page 2: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook v1.0

Contents

1. Introduction ........................................................................................3

1.1 Caveats .........................................................................................3

1.2 Change Process ..............................................................................4

1.3 Supporting Documentation ...............................................................4

2. How to Use this Document ...................................................................5

3. Scenarios .............................................................................................6

3.1 PAYE calculations ............................................................................6

3.2 Tax Rate changes and earnings across multiple periods ..................... 10

3.3 Tax Thresholds ............................................................................. 13

3.4 Payroll Donation Threshold ............................................................. 17

3.5 Child Support threshold ................................................................. 19

3.6 Employee start/end dates, lump sum and KiwiSaver ......................... 21

3.7 ESCT (employer superannuation contribution tax) ............................. 23

3.8 Paying PAYE twice a month ............................................................ 25

3.9 Student Loan deductions - SLCIR and SLBOR ................................... 27

3.10 Employee Share Scheme (ESS) ...................................................... 29

Appendix A: Change Log ........................................................................... 31

Page 3: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook V1.0

3 In Confidence

1. Introduction

myIR is Inland Revenue's Online Service that offers employers, tax agents and payroll bureaus a secure and convenient method of filing employer monthly schedules online.

Inland Revenue (IR) publishes the Electronic Filing Payroll Specification Document to detail specifications for the myIR technical interface. The document provides software developers with the data file information for PAYE, KiwiSaver, Employer’s Superannuation Contribution Tax (ESCT), Student Loan and associated tax information necessary for employers to electronically file their returns IR348 and payment deduction form IR348 to Inland Revenue.

The purpose of this Casebook document is to provide scenarios, Employer Monthly Schedule (EMS) and Employer Deduction Forms (EDF) examples to improve the understanding of the components described in the Payroll Specification and supporting documentation outlined in Section 1.2. The document provides a mechanism for external parties to validate and compare their software package outputs with the examples provided.

The Casebook’s aim is to improve the quality of data received by Inland Revenue which will reduce exception processing and the number of queries received by Inland Revenue and Software Developers, over time reducing compliance costs and assisting in the integrity of the New Zealand tax system.

1.1 Caveats

The examples and scenarios have been developed to assist in the generation of myIR data. These are not intended to be exhaustive and do not cover every possible factual situation that may occur. This document is intended as an accompaniment to the Payroll Specification only. The Payroll Specification document is still the ‘document of truth’ for defining the specifications for development of payroll software packages and the myIR technical interface.

Any developer queries regarding this document can be directed to: [email protected]

An electronic version of the final version of this document can be found at the following link: http://www.ird.govt.nz/software-developers/technical/ir-file/

Any updates to the final version of this document will be posted at the following link: http://www.ird.govt.nz/software-developers/

IRD numbers used have been created for testing purposes only and do not represent real persons or organisations. Test data has been manufactured for testing purposes only and does not relate to real persons or organisations.

Page 4: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook V1.0

4 In Confidence

ACC Earners’ Levy

Cabinet considered the 2018/19 ACC levy rates and agreed”

To set the total Earner’s Account levy rate, including GST, at $1.39 per $100 of liable

earnings

To increase the maximum liable earnings that self-employed and businesses pay Work Account levies on as outlined below:

Description 2017/18 (from)

2018/19 (to)

Employees and private domestic workers (Work and Earners’ Accounts)

$124,053 $126,286

Self-employed people (Work and Earners’ Accounts) $122,063 $124,053

To increase the minimum liable earnings for self-employed workers from $31,720 to $32,760.

1.2 Change Process

In general changes to this document will be updated and driven directly from changes to the Payroll Specification for Software Developers. In addition, this document may be republished to clarify the expected data required for myIR. This may be as a result of recommendation from Inland Revenue operational staff reviewing myIR data received, or requests from external parties to clarify the expected inputs. Appendix A contains a change log to all changes to this document.

1.3 Supporting Documentation

This document is based upon information gathered from; IR Electronic Filing

– Payroll Specification Document 1 April 2018 to 31 March 2019 Final V1.0

IR335 Employers Guide

Inland Revenue’s PAYE Calculator on line

IR341 Four-weekly and monthly PAYE deduction tables

IR340 Weekly and fortnightly PAYE deduction tables

KS4 KiwiSaver Employer Guide

Page 5: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook V1.0

5 In Confidence

2. How to Use this Document

This document comprises a set of scenarios that describe various conditions that impact the generation of myIR data. Each scenario will detail the purpose, a business level description,

the inputs and a table representing the EMS line items produced. Accompanying this document is a Comma Separated Values (CSV) file that matches the scenarios inputs and an EMS file matching the EMS line items.

Page 6: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook v1.0

6 In Confidence

3. Scenarios

3.1 PAYE calculations

Purpose 1. Demonstrate the PAYE tax calculations for each tax type.

2. Populate child support, payroll donations, employee, and employer KiwiSaver contributions.

3. Mimic a monthly cycle for employees paid weekly.

4. Demonstrate Student Loan standard deduction rate.

Description This scenario has four payment periods relating to the EMS schedule April 2018. These are starting on: 29/03/2018, 05/04/2018, 12/04/2018 and 19/04/2018. Payment is made to each employee on the last day of the pay period end date. These are paid on: 04/04/2018, 11/04/2018, 18/04/2018 and 25/04/2018. For the pay periods ending 29/03/2018, 05/04/2018, 12/04/2018 and 19/04/2018 They are existing employees with regular weekly gross earnings of $578.78, including employee and employer KiwiSaver contributions of 3%, and $23.81 in payroll donations. Inland Revenue has requested child support deductions of $20.99 per week.

The employer is paying PAYE once a month.

Page 7: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook v1.0

7 In Confidence

Data Input – Pay period Calculation

The following tables represent the data inputs for each payment period and include the interim calculations required in order to generate the monthly EMS schedule.

Periods 1 – 4 (same data for each period)

Data Inputs Pay Period Calculations Employee, Tax Code Gross

Earnings Gross

Earning non ACC

Lump Sum Child

Support KiwiSaver

Employee KiwiSaver

Employer Payroll

Giving ESCT Rate PAYE KiwiSaver

Employee Deduction Amount

KiwiSaver

Employer Deduction Amount

Child

Support Deduction Amount

Payroll

Giving Tax Credit

Student

Loan Deduction Amount

ESCT EMS Filing

Month Tax Year

Paige Chen, M 578.78 20.99 3% 3% 23.81 17.5% 90.48 17.36 14.39 20.99 7.93 0.00 2.97 30/04/18 2019

Sherri Melton, M SL 578.78 20.99 3% 3% 23.81 17.5% 90.48 17.36 14.39 20.99 7.93 24.48 2.97 30/04/18 2019

Gretchen Hill, ME 578.78 20.99 3% 3% 23.81 17.5% 80.48 17.36 14.39 20.99 7.93 0.00 2.97 30/04/18 2019

Karen Puckett, ME SL 578.78 20.99 3% 3% 23.81 17.5% 80.48 17.36 14.39 20.99 7.93 24.48 2.97 30/04/18 2019

Patrick Song, SB SL 578.78 20.99 3% 3% 23.81 17.5% 68.72 17.36 14.39 20.99 7.93 69.36 2.97 30/04/18 2019

Elsie Hamilton, S 578.78 20.99 3% 3% 23.81 17.5% 109.18 17.36 14.39 20.99 7.93 0.00 2.97 30/04/18 2019

Hazel Bender, SB 578.78 20.99 3% 3% 23.81 17.5% 68.72 17.36 14.39 20.99 7.93 0.00 2.97 30/04/18 2019

Malcolm Wagner, SH 578.78 20.99 3% 3% 23.81 17.5% 181.43 17.36 14.39 20.99 7.93 0.00 2.97 30/04/18 2019

Dolores McLaughlin, ST 578.78 20.99 3% 3% 23.81 17.5% 198.77 17.36 14.39 20.99 7.93 0.00 2.97 30/04/18 2019

Francis McNamara, S SL 578.78 20.99 3% 3% 23.81 17.5% 109.18 17.36 14.39 20.99 7.93 69.36 2.97 30/04/18 2019

Sandy Raynor, SH SL 578.78 20.99 3% 3% 23.81 17.5% 181.43 17.36 14.39 20.99 7.93 69.36 2.97 30/04/18 2019

Marion Moon, ST SL 578.78 20.99 3% 3% 23.81 17.5% 198.77 17.36 14.39 20.99 7.93 69.36 2.97 30/04/18 2019

Beth Woodard, CAE 578.78 20.99 3% 3% 23.81 17.5% 109.18 17.36 14.39 20.99 7.93 0.00 2.97 30/04/18 2019

Julia Desai, EDW 578.78 20.99 3% 3% 23.81 17.5% 109.18 17.36 14.39 20.99 7.93 0.00 2.97 30/04/18 2019

Jerome Wallace, ND 578.78 20.99 3% 3% 23.81 17.5% 268.13 17.36 14.39 20.99 7.93 0.00 2.97 30/04/18 2019

Neal Lawrence, NSW 578.78 20.99 23.81 17.5% 68.72 0.00 0.00 20.99 7.93 0.00 0.00 30/04/18 2019

Page 8: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook v1.0

8 In Confidence

Notes

Refer to IR335 Employers Guide, for the KiwiSaver, Child Support and Student Loan implications for the Recognised Seasonal Workers, NSW tax code.

The gross amount has been standardised across all tax codes to simplify the data inputs. The gross amount is not to be assumed a regular payment across the year, which in the case of ME and SB would be outside the tax code threshold.

EMPLOYER MONTHLY SCHEDULE (EMS-IR 348)

The following tables represent the structure and data on an EMS file.

Header Record

Header

Record Indicator

Employer

IRD number Return

Period Name of

payroll contact person

Payroll

contact work phone number

Total PAYE

/ tax Total child

support Total

student loans

Total

KiwiSaver deductions

Total

employer contributions

total Tax

credits for payroll

donations

Total family

tax credits Total gross

earnings Total

earnings not liable

for earners'

levy (EL)

Payroll package

and version no. identifier

Email of payroll contact

person IR form

version number

HDR 048125352 20180430 John Jones 063048474 805332 134336 130560 104160 86340 50752 0 3704000 0 IRDPayrollV1.1 [email protected] 0004

Detail Record

Detail

record indicator

Employee

IRD number employee name Employee

tax code Start date Finish date Gross

earnings and/ or

schedular (withholding) payments

Earnings and

/ or schedular

(withholding) payments

not liable for

ACC earner levy

Lump sum

(extra pay) indicator

PAYE / tax Child

support deductions

Child

support code

Student loan

deductions KiwiSaver

deductions KiwiSaver

employer contributions

Tax credits

for payroll donations

Family tax

credits

DTL 048125360 Chen Paige M 231500 0 0 36192 8396 0 6944 5756 3172 0

DTL 048125379 Melton Sherri M SL 231500 0 0 36192 8396 9792 6944 5756 3172 0

DTL 048125387 Hill Gretchen ME 231500 0 0 32192 8396 0 6944 5756 3172 0

DTL 048125395 Puckett Karen ME SL 231500 0 0 32192 8396 9792 6944 5756 3172 0

DTL 048125409 Song Patrick SB SL 231500 0 0 27488 8396 27744 6944 5756 3172 0

DTL 048125417 Hamilton Elsie S 231500 0 0 43672 8396 0 6944 5756 3172 0

DTL 048125425 Bender Hazel SB 231500 0 0 27488 8396 0 6944 5756 3172 0

DTL 048125433 Wagner Malcolm SH 231500 0 0 72572 8396 0 6944 5756 3172 0

DTL 048125441 McLaughlin Dolores ST 231500 0 0 79508 8396 0 6944 5756 3172 0

DTL 048125451 McNamara Francis S SL 231500 0 0 43672 8396 27744 6944 5756 3172 0

DTL 048125468 Raynor Sandy SH SL 231500 0 0 72572 8396 27744 6944 5756 3172 0

DTL 048125476 Moon Marion ST SL 231500 0 0 79508 8396 27744 6944 5756 3172 0

DTL 048125484 Woodard Beth CAE 231500 0 0 43672 8396 0 6944 5756 3172 0

DTL 048125492 Desai Julia EDW 231500 0 0 43672 8396 0 6944 5756 3172 0

DTL 048125506 Wallace Jerome ND 231500 0 0 107252 8396 0 6944 5756 3172 0

DTL 048125514 Lawrence Neal NSW 231500 0 0 27488 8396 0 0 0 3172 0

Page 9: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook v1.0

9 In Confidence

EMPLOYER DEDUCTION FORM (EDF-IR 345)

The following table represents the structure and data on an EDF file.

Detail

Record Indicator

Employer

IRD number Payment

Date Total PAYE

and Tax (on schedular

payments)

Total Child

Support Deductions

Total

Student Loan

Deductions

Total

KiwiSaver Deductions

Total

KiwiSaver Employer

Contributions

Total ESCT

Deducted Total

Amounts Payable

IR Form

Version Number

EDF 048125352 20180430 754580 134336 130560 104160 86340 17820 1227796 0003

Page 10: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook v1.0

10 In Confidence

3.2 Tax Rate changes and earnings across multiple periods

Purpose

1. Demonstrate the allocation of earnings across two EMS filing periods.

2. Demonstrate the PAYE year calculation during which a change to tax rates and/or thresholds is applied.

Description

An existing employee earns regular income of $ 4615.38 fortnightly.

This example has five payment periods across two EMS periods. See below for the pay period and payment dates. The employer is paying PAYE once a month.

Data Input

The following table details the inputs into this scenario and the interim calculations required in order to generate the monthly EMS schedules.

Data Inputs Pay Period Calculations Employee, Tax Code Pay Period

End Date Payment

Date Freq Gross

Earnings KiwiSaver

Employee KiwiSaver

Employer Payroll

Giving ESCT Rate PAYE KiwiSaver

Employee Deduction Amount

KiwiSaver

Employer Deduction Amount

Child

Support Deduction Amount

Payroll

Giving Tax Credit

Student

Loan Deduction Amount

ESCT EMS Filing

Month Tax Year

Kristine Dougherty, M 24/02/18 03/03/18 fortnightly 4,615.38 30% 1,237.98 0.00 0.00 0.00 0.00 0.00 0.00 31/03/18 2018

Kristine Dougherty, M 12/03/18 19/03/18 fortnightly 4,615.38 30% 1,237.98 0.00 0.00 0.00 0.00 0.00 0.00 31/03/18 2018

Kristine Dougherty, M 26/03/18 02/04/18 fortnightly 4,615.38 30% 1,237.98 0.00 0.00 0.00 0.00 0.00 0.00 30/04/18 2018

Kristine Dougherty, M 09/04/18 16/04/18 fortnightly 4,615.38 30% 1,237.98 0.00 0.00 0.00 0.00 0.00 0.00 30/04/18 2019

Kristine Dougherty, M 23/04/18 30/04/18 fortnightly 4,615.38 30% 1,237.98 0.00 0.00 0.00 0.00 0.00 0.00 30/04/18 2019

Notes See IR340 Weekly and fortnightly PAYE deduction tables for details on the EMS and tax rates to apply.

Page 11: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook v1.0

11 In Confidence

EMPLOYER MONTHLY SCHEDULE (EMS-IR 348)

The following tables represent the structure and data on an EMS file for the March 2018 filing.

March

Header Record

Header

Record Indicator

Employer

IRD number Return

Period Name of

payroll contact person

Payroll

contact work phone number

Total PAYE

/ tax Total child

support Total

student loans

Total

KiwiSaver deductions

Total

employer contributions

total Tax

credits for payroll

donations

Total family

tax credits Total gross

earnings Total

earnings not liable

for earners'

levy (EL)

Payroll package

and version no. identifier

Email of payroll contact

person IR form

version number

HDR 048125352 20180331 John Jones 063048474 247596 0 0 0 0 0 0 923000 0 IRDPayrollV1.1 [email protected] 0004

Detail Record

Detail record

indicator

Employee IRD number

employee name Employee tax code

Start date Finish date Gross earnings and/ or

schedular (withholding) payments

Earnings and / or

schedular

(withholding) payments

not liable for

ACC earner levy

Lump sum (extra pay) indicator

PAYE / tax Child support

deductions

Child support

code

Student loan deductions

KiwiSaver deductions

KiwiSaver employer

contributions

Tax credits for payroll donations

Family tax credits

DTL 048125530 Dougherty Kristine M 923000 0 0 247596 0 0 0 0 0 0

EMPLOYER DEDUCTION FORM (EDF-IR 345)

The following table represents the structure and data on an EDF file.

Detail Record

Indicator

Employer IRD number

Payment Date

Total PAYE and Tax (on schedular

payments)

Total Child Support

Deductions

Total Student

Loan

Deductions

Total KiwiSaver Deductions

Total KiwiSaver Employer

Contributions

Total ESCT Deducted

Total Amounts Payable

IR Form Version Number

EDF 048125352 20180331 247596 0 0 0 0 0 247596 0003

Page 12: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook v1.0

12 In Confidence

EMPLOYER MONTHLY SCHEDULE (EMS-IR 348)

The following tables represent the structure and data on an EMS file for April 2018 filing. Note: Total PAYE/tax includes the change in ACC rate.

April

Header Record

Header

Record Indicator

Employer

IRD number Return

Period Name of

payroll contact person

Payroll

contact work phone

number

Total PAYE

/ tax Total child

support Total

student loans

Total

KiwiSaver deductions

Total

employer contributions

total Tax

credits for payroll

donations

Total family

tax credits Total gross

earnings Total

earnings not liable

for earners'

levy (EL)

Payroll package

and version no. identifier

Email of payroll contact

person IR form

version number

HDR 048125352 20180430 John Jones 063048474 371394 0 0 0 0 0 0 1384600 0 IRDPayrollV1.1 [email protected] 0004

Detail Record

Detail record

indicator

Employee IRD number

employee name Employee tax code

Start date Finish date Gross earnings and/ or

schedular (withholding) payments

Earnings and / or

schedular

(withholding) payments

not liable for

ACC earner levy

Lump sum (extra pay) indicator

PAYE / tax Child support

deductions

Child support

code

Student loan deductions

KiwiSaver deductions

KiwiSaver employer

contributions

Tax credits for payroll donations

Family tax credits

DTL 048125530 Dougherty Kristine M 1384600 0 0 371394 0 0 0 0 0 0

EMPLOYER DEDUCTION FORM (EDF-IR 345)

The following table represents the structure and data on an EDF file.

Detail Record

Indicator

Employer IRD number

Payment Date

Total PAYE and Tax (on schedular

payments)

Total Child Support

Deductions

Total Student

Loan

Deductions

Total KiwiSaver Deductions

Total KiwiSaver Employer

Contributions

Total ESCT Deducted

Total Amounts Payable

IR Form Version Number

EDF 048125352 20180430 371394 0 0 0 0 0 371394 0003

Page 13: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook v1.0

13 In Confidence

3.3 Tax Thresholds

Purpose

1. Demonstrate the PAYE tax calculations within each tax threshold.

2. Ensure that the thresholds have been applied correctly.

3. PAYE tax calculations for minimum wage.

Description

Existing employees paying PAYE based on each tax threshold.

This example has one payment period end date with weekly, fortnightly, 4 weekly and monthly frequencies relating to the EMS schedule December 2018. The employer is paying PAYE once a month.

Data Input

The following table details the inputs into this scenario and the interim calculations required in order to generate the monthly EMS schedules.

Notes:

It is assumed that the employers annualised PAYE including ESCT is less than $500,000.

The following table details how the Gross Earnings have been derived.

M Tax Thresholds

Threshold 14000 48000 70000

=,+$1 14000.00 14,001.00 48000.00 48,001.00 70000.00 70,001.00

weekly 52 269.23 269.25 923.08 923.10 1,346.15 1,346.17

fortnightly 26 538.46 538.50 1,846.15 1,846.19 2,692.31 2,692.35

4 weekly 13 1,076.92 1,077.00 3,692.31 3,692.38 5,384.62 5,384.69

monthly 12 1,166.67 1,166.75 4,000.00 4,000.08 5,833.33 5,833.42

Data Inputs Pay Period Calculations Employee, Tax Code Pay Period

End Date Payment

Date Freq Gross

Earnings KiwiSaver Employee

KiwiSaver Employer

Payroll Giving

ESCT Rate PAYE KiwiSaver Employee

Deduction Amount

KiwiSaver Employer

Deduction Amount

Child Support

Deduction Amount

Payroll Giving Tax

Credit

Student Loan

Deduction Amount

ESCT EMS Filing Month

Tax Year

Patricia Mangum, M 07/12/18 08/12/18 weekly 269.23 10.5% 32.00 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Lois Joseph, M 07/12/18 08/12/18 weekly 269.25 10.5% 32.01 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Louis Rosenthal, M 07/12/18 08/12/18 weekly 923.08 17.5% 155.52 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Christina Bowden, M 07/12/18 08/12/18 weekly 923.10 17.5% 155.52 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Darlene Barton, M 07/12/18 08/12/18 weekly 1,346.15 30% 288.32 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Harvey Underwood, M 07/12/18 08/12/18 weekly 1,346.17 30% 288.32 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Page 14: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook v1.0

14 In Confidence

William Jones, M 07/12/18 08/12/18 fortnightly 538.46 10.5% 64.00 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Frederick Baker, M 07/12/18 08/12/18 fortnightly 538.50 10.5% 64.02 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Shirley Merritt, M 07/12/18 08/12/18 fortnightly 1,846.15 17.5% 311.02 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Jason Cross, M 07/12/18 08/12/18 fortnightly 1,846.19 17.5% 311.04 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Judith Cooper, M 07/12/18 08/12/18 fortnightly 2,692.31 30% 576.64 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Getchen Holmes, M 07/12/18 08/12/18 fortnightly 2,692.35 30% 576.66 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Don Sharpe, M 07/12/18 08/12/18 4 weekly 1,076.92 10.5% 128.00 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Glenda Morgan, M 07/12/18 08/12/18 4 weekly 1,077.00 10.5% 128.04 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Scott Hoyle, M 07/12/18 08/12/18 4 weekly 3,692.31 17.5% 622.08 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Pat Allen, M 07/12/18 08/12/18 4 weekly 3,692.38 17.5% 622.08 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Michelle Rich, M 07/12/18 08/12/18 4 weekly 5,384.62 30% 1,153.28 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Jessica Rich, M 07/12/18 08/12/18 4 weekly 5,384.69 30% 1,153.28 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Evan Grant, M 07/12/18 08/12/18 monthly 1,166.67 10.5% 138.71 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Melinda Proctor, M 07/12/18 08/12/18 monthly 1,166.75 10.5% 138.71 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Calvin Diaz, M 07/12/18 08/12/18 monthly 4,000.00 17.5% 673.92 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Eugene Graham, M 07/12/18 08/12/18 monthly 4,000.08 17.5% 673.92 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Vickie Watkins, M 07/12/18 08/12/18 monthly 5,833.33 30% 1,249.38 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Luis Hinton, M 07/12/18 08/12/18 monthly 5,833.42 30% 1,249.43 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Allan Marsh, M 07/12/18 08/12/18 weekly 2,428.56 33% 660.56 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Melanie Hewitt, M 07/12/18 08/12/18 weekly 2,428.60 33% 660.57 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Marianne Branch, M 07/12/18 08/12/18 fortnightly 4,857.12 33% 1,321.12 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Natalie Walton, M 07/12/18 08/12/18 fortnightly 4,857.19 33% 1,321.14 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Caroline O'Brien, M 07/12/18 08/12/18 4 weekly 9,714.23 33% 2,642.20 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Arlene Case, M 07/12/18 08/12/18 4 weekly 9,714.38 33% 2,642.28 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Kyle Watts, M 07/12/18 08/12/18 monthly 10,523.75 33% 2,862.42 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Calvin Christensen, M 07/12/18 08/12/18 monthly 10,523.92 33% 2,862.47 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Curtis Love, M 07/12/18 08/12/18 monthly 1,768.00 17.5% 252.28 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Dana McLean, M 07/12/18 08/12/18 weekly 408.00 17.5% 58.22 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Jennifer Christian, M 07/12/18 08/12/18 fortnightly 816.00 17.5% 116.44 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Brett Lamb, M 07/12/18 08/12/18 4 weekly 1,632.00 17.5% 232.88 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Max Schultz, M 07/12/18 08/12/18 weekly 510.00 17.5% 77.49 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Holly Perez, M 07/12/18 08/12/18 fortnightly 1,020.00 17.5% 154.98 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Margaret Vogel, M 07/12/18 08/12/18 4 weekly 2,040.00 17.5% 309.96 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Peter Kenney, M 07/12/18 08/12/18 monthly 2,210.00 17.5% 335.79 0.00 0.00 0.00 0.00 0.00 0.00 31/12/18 2019

Page 15: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook v1.0

15 In Confidence

EMPLOYER MONTHLY SCHEDULE (EMS-IR 348)

The following tables represent the structure and data on an EMS file.

Header Record

Header Record

Indicator

Employer IRD number

Return Period

Name of payroll contact

person

Payroll contact work

phone number

Total PAYE / tax

Total child support

Total student

loans

Total KiwiSaver

deductions

Total employer

contributions

total Tax credits for

payroll donations

Total family tax credits

Total gross earnings

Total earnings

not liable for earners'

levy (EL)

Payroll package and version no.

identifier

Email of payroll contact person

IR form version

number

HDR 048125352 20181231 John Jones 063048474 2729670 0 0 0 0 0 0 12297900 0 IRDPayrollV1.1 [email protected] 0004

Detail Record

Detail

record indicator

Employee

IRD number employee name Employee

tax code Start date Finish date Gross

earnings and/ or

schedular

(withholding) payments

Earnings and

/ or schedular

(withholding)

payments not liable for

ACC earner levy

Lump sum

(extra pay) indicator

PAYE / tax Child

support deductions

Child

support code

Student loan

deductions KiwiSaver

deductions KiwiSaver

employer contributions

Tax credits

for payroll donations

Family tax

credits

DTL 048125786 Mangum Patricia M 26900 0 0 3200 0 0 0 0 0 0

DTL 048125794 Joseph Lois M 26900 0 0 3201 0 0 0 0 0 0

DTL 048125808 Rosenthal Louis M 92300 0 0 15552 0 0 0 0 0 0

DTL 048125816 Bowden Christina M 92300 0 0 15552 0 0 0 0 0 0

DTL 048125824 Barton Darlene M 134600 0 0 28832 0 0 0 0 0 0

DTL 048125832 Underwood Harvey M 134600 0 0 28832 0 0 0 0 0 0

DTL 048125840 Jones William M 53800 0 0 6400 0 0 0 0 0 0

DTL 048125859 Baker Frederick M 53800 0 0 6402 0 0 0 0 0 0

DTL 048125867 Merritt Shirley M 184600 0 0 31102 0 0 0 0 0 0

DTL 048125875 Cross Jason M 184600 0 0 31104 0 0 0 0 0 0

DTL 048125883 Cooper Judith M 269200 0 0 57664 0 0 0 0 0 0

DTL 048125891 Holmes Getchen M 269200 0 0 57666 0 0 0 0 0 0

DTL 048125905 Sharpe Don M 107600 0 0 12800 0 0 0 0 0 0

DTL 048125913 Morgan Glenda M 107700 0 0 12804 0 0 0 0 0 0

DTL 048125921 Hoyle Scott M 369200 0 0 62208 0 0 0 0 0 0

DTL 048125930 Allen Pat M 369200 0 0 62208 0 0 0 0 0 0

DTL 048125948 Rich Michelle M 538400 0 0 115328 0 0 0 0 0 0

DTL 048125956 Rich Jessica M 538400 0 0 115328 0 0 0 0 0 0

DTL 048125964 Grant Evan M 116600 0 0 13871 0 0 0 0 0 0

DTL 048125972 Proctor Melinda M 116600 0 0 13871 0 0 0 0 0 0

DTL 048125980 Diaz Calvin M 400000 0 0 67392 0 0 0 0 0 0

Page 16: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook v1.0

16 In Confidence

DTL 048125999 Graham Eugene M 400000 0 0 67392 0 0 0 0 0 0

DTL 048126006 Watkins Vickie M 583300 0 0 124938 0 0 0 0 0 0

DTL 048126014 Hinton Luis M 583300 0 0 124943 0 0 0 0 0 0

DTL 048126022 Marsh Allan M 242800 0 0 66056 0 0 0 0 0 0

DTL 048126030 Hewitt Melanie M 242800 0 0 66057 0 0 0 0 0 0

DTL 048126049 Branch Marianne M 485700 0 0 132112 0 0 0 0 0 0

DTL 048126057 Walton Natalie M 485700 0 0 132114 0 0 0 0 0 0

DTL 048126065 O'Brien Caroline M 971400 0 0 264220 0 0 0 0 0 0

DTL 048126073 Case Arlene M 971400 0 0 264228 0 0 0 0 0 0

DTL 048126081 Watts Kyle M 1052300 0 0 286242 0 0 0 0 0 0

DTL 048126093 Christensen Calvin M 1052300 0 0 286247 0 0 0 0 0 0

DTL 048126278 Love Curtis M 176800 0 0 25228 0 0 0 0 0 0

DTL 048126286 McLean Dana M 40800 0 0 5822 0 0 0 0 0 0

DTL 048126294 Christian Jennifer M 81600 0 0 11644 0 0 0 0 0 0

DTL 048126308 Lamb Brett M 163200 0 0 23288 0 0 0 0 0 0

DTL 048175660 Schultz Max M 51000 0 0 7749 0 0 0 0 0 0

DTL 048175678 Perez Holly M 102000 0 0 15498 0 0 0 0 0 0

DTL 048175686 Vogel Margaret M 204000 0 0 30996 0 0 0 0 0 0

DTL 048175694 Kenney Peter M 221000 0 0 33579 0 0 0 0 0 0

EMPLOYER DEDUCTION FORM (EDF-IR 345)

The following table represents the structure and data on an EDF file.

Detail

Record Indicator

Employer

IRD number Payment

Date Total PAYE

and Tax (on schedular

payments)

Total Child

Support Deductions

Total

Student Loan

Deductions

Total

KiwiSaver Deductions

Total

KiwiSaver Employer

Contributions

Total ESCT

Deducted Total

Amounts Payable

IR Form

Version Number

EDF 048125352 20181231 2729670 0 0 0 0 0 2729670 0003

Page 17: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook v1.0

17 In Confidence

3.4 Payroll Donation Threshold

Purpose

1. Demonstrate the calculation for payroll donation tax credits.

2. Demonstrate the maximum tax credit for payroll donations, i.e. the tax credit is less the 33.33% of the donation amount.

Description

Existing employees paid gross earnings of $1923.04 four weekly, deducting 8% to KiwiSaver, with employer contributions of 8%. The employer is paying PAYE once a month.

Data Input

Data Inputs Pay Period Calculations Employee, Tax Code Pay Period

End Date Payment

Date Freq Gross

Earnings KiwiSaver Employee

KiwiSaver Employer

Payroll Giving

ESCT Rate PAYE KiwiSaver Employee

Deduction Amount

KiwiSaver Employer

Deduction Amount

Child Support

Deduction Amount

Payroll Giving Tax

Credit

Student Loan

Deduction Amount

ESCT EMS Filing Month

Tax Year

Gary Parks, M 23/01/19 30/01/19 4 weekly 1,923.04 8% 8% 780 17.5% 287.84 153.84 127.07 0.00 259.99 0.00 26.77 31/01/19 2019

Samantha Hardin, M 23/01/19 30/01/19 4 weekly 1,923.04 8% 8% 1,015.75 17.5% 287.84 153.84 127.07 0.00 261.14 0.00 26.77 31/01/19 2019

Notes

ESCT has been calculated using the standard method as per pages 15 & 16 of the IR335 Employer’s Guide

Refer to Section 6.16 of Payroll Specification document for information on Payroll Giving.

Page 18: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook v1.0

18 In Confidence

EMPLOYER MONTHLY SCHEDULE (EMS-IR 348)

The following tables represent the structure and data on an EMS file.

Header Record

Header Record

Indicator

Employer IRD number

Return Period

Name of payroll contact

person

Payroll contact work

phone number

Total PAYE / tax

Total child support

Total student

loans

Total KiwiSaver

deductions

Total employer

contributions

total Tax credits for

payroll donations

Total family tax credits

Total gross earnings

Total earnings

not liable for earners'

levy (EL)

Payroll package and version no.

identifier

Email of payroll contact person

IR form version

number

HDR 048125352 20190131 John Jones 063048474 57568 0 0 30768 25414 52113 0 384600 0 IRDPayrollV1.1 [email protected] 0004

Detail Record

Detail

record indicator

Employee

IRD number employee name Employee

tax code Start date Finish date Gross

earnings and/ or

schedular

(withholding) payments

Earnings and

/ or schedular

(withholding)

payments not liable for

ACC earner levy

Lump sum

(extra pay) indicator

PAYE / tax Child

support deductions

Child

support code

Student loan

deductions KiwiSaver

deductions KiwiSaver

employer contributions

Tax credits

for payroll donations

Family tax

credits

DTL 048126103 Parks Gary M 192300 0 0 28784 0 0 15384 12707 25999 0

DTL 048126111 Hardin Samantha M 192300 0 0 28784 0 0 15384 12707 26114 0

EMPLOYER DEDUCTION FORM (EDF-IR 345)

The following table represents the structure and data on an EDF file.

Detail Record

Indicator

Employer IRD number

Payment Date

Total PAYE and Tax (on

schedular payments)

Total Child Support

Deductions

Total Student

Loan Deductions

Total KiwiSaver

Deductions

Total KiwiSaver

Employer Contribution

s

Total ESCT Deducted

Total Amounts

Payable

IR Form Version

Number

EDF 048125352 20190131 5455 0 0 30768 25414 5354 66991 0003

Page 19: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook v1.0

19 In Confidence

3.5 Child Support threshold

1. Populate the child support amount.

2. Demonstrate the calculation for child support where the “protected net earnings” amount is reached. 60% net (after tax) pay.

Description

An existing employee with fortnightly pays. Inland Revenue has requested child support deductions of $360.71 fortnightly, deducting 4% to KiwiSaver, employer contributions are 4%. The employer is paying PAYE once a month.

Data Input

Data Inputs Pay Period Calculations Employee, Tax Code Pay Period

End Date Payment

Date Freq Gross

Earnings Child

Support KiwiSaver

Employee KiwiSaver

Employer ESCT Rate PAYE KiwiSaver

Employee Deduction Amount

KiwiSaver

Employer Deduction Amount

Child

Support Deduction Amount

Payroll

Giving Tax Credit

Student

Loan Deduction Amount

ESCT EMS Filing

Month Tax Year

Sara Lucas, M 01/04/18 02/04/18 fortnightly 1,153.83 360.71 4% 4% 17.5% 180.26 46.15 38.10 360.71 0.00 0.00 8.05 30/04/18 2019

Sara Lucas, M 15/04/18 16/04/18 fortnightly 923.56 360.71 4% 4% 17.5% 136.76 36.94 30.64 319.85 0.00 0.00 6.30 30/04/18 2019

Sara Lucas, M 29/04/18 30/04/18 fortnightly 1,153.83 360.71 4% 4% 17.5% 180.26 46.15 38.10 360.71 0.00 0.00 8.05 30/04/18 2019

Notes:

ESCT has been calculated using the standard method as per pages 15 & 16 of the IR335 Employer’s Guide

Refer to Section 6.15 of the Payroll Specification for details on Child Support ‘protected net earnings’.

Page 20: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook v1.0

20 In Confidence

EMPLOYER MONTHLY SCHEDULE (EMS-IR 348)

The following tables represent the structure and data on an EMS file.

Header Record

Header Record

Indicator

Employer IRD number

Return Period

Name of payroll contact

person

Payroll contact work

phone number

Total PAYE / tax

Total child support

Total student

loans

Total KiwiSaver

deductions

Total employer

contributions

total Tax credits for

payroll donations

Total family tax credits

Total gross earnings

Total earnings

not liable for earners'

levy (EL)

Payroll package and version no.

identifier

Email of payroll contact person

IR form version

number

HDR 048125352 20180430 John Jones 063048474 49728 104127 0 12924 10684 0 0 323100 0 IRDPayrollV1.1 [email protected] 0004

Detail Record

Detail

record indicator

Employee

IRD number employee name Employee

tax code Start date Finish date Gross

earnings and/ or

schedular

(withholding) payments

Earnings and

/ or schedular

(withholding)

payments not liable for

ACC earner levy

Lump sum

(extra pay) indicator

PAYE / tax Child

support deductions

Child

support code

Student loan

deductions KiwiSaver

deductions KiwiSaver

employer contributions

Tax credits

for payroll donations

Family tax

credits

DTL 048126125 Lucas Sara M 323100 0 0 49728 104127 0 12924 10684 0 0

EMPLOYER DEDUCTION FORM (EDF-IR 345)

The following table represents the structure and data on an EDF file.

Detail

Record Indicator

Employer

IRD number Payment

Date Total PAYE

and Tax (on schedular payments)

Total Child

Support Deductions

Total

Student Loan

Deductions

Total

KiwiSaver Deductions

Total

KiwiSaver Employer

Contribution

s

Total ESCT

Deducted Total

Amounts Payable

IR Form

Version Number

EDF 048125352 20180430 49728 108213 0 12924 10684 2240 183789 0003

Page 21: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook v1.0

21 In Confidence

3.6 Employee start/end dates, lump sum and KiwiSaver

Purpose

1. Populate the start and end dates and KiwiSaver requirements.

2. Populate lump sum.

Description

A new employee joins KiwiSaver and is deducting 4% to KiwiSaver, with employer contributions of 4%. An existing employee finishes employment within the period and receives a lump sum payment. The pay period end date is 30/04/2018 and the payment date is 20/04/2018. The employer is paying PAYE once a month.

Data Input

Data Inputs Pay Period Calculations Employee, Tax Code Pay Period

End Date Payment

Date Freq Start Date Finish Date Gross

Earnings Lump Sum KiwiSaver

Employee KiwiSaver Employer

ESCT Rate

PAYE KiwiSaver Employee

Deduction Amount

KiwiSaver Employer

Deduction Amount

Child Support

Deduction Amount

Payroll Giving

Tax Credit

Student Loan Deduction

Amount

ESCT EMS Filing Month

Tax Year

Stacy Eason, M 30/04/18 20/04/18 monthly 02/04/18 21,548.57 4% 4% 33% 6,500.60 861.94 577.81 0.00 0.00 0.00 284.13 30/04/18 2019

Gladys Davidson, M 30/04/18 20/04/18 monthly 28/04/18 64,645.71 43,097.14 33% 20,722.65 0.00 0.00 0.00 0.00 0.00 0.00 30/04/18 2019

Notes:

The Lump Sum Payment amount is included in the Gross Earnings.

ESCT has been calculated using the standard method as per pages 15 & 16 of the Employer’s Guide IR335

For new employees, ensure that the KS1 KiwiSaver Employee Details form or the KS10 New Employee opt-out notice is sent before the EMS. See the KiwiSaver Employer Guide (KS4) page 4 for details.

Page 22: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook v1.0

22 In Confidence

Header Record

Header Record

Indicator

Employer IRD number

Return Period

Name of payroll contact

person

Payroll contact work

phone number

Total PAYE / tax

Total child support

Total student

loans

Total KiwiSaver

deductions

Total employer

contributions

total Tax credits for

payroll donations

Total family tax credits

Total gross earnings

Total earnings

not liable for earners' levy (EL)

Payroll package and version no.

identifier

Email of payroll contact person

IR form version

number

HDR 048125352 20180430 John Jones 063048474 1300120 0 0 86194 57781 0 0 8619300 0 IRDPayrollV1.1 [email protected] 0004

Detail Record

Detail record

indicator

Employee IRD number

employee name Employee tax code

Start date Finish date Gross earnings

and/ or schedular

(withholding) payments

Earnings and / or

schedular (withholding)

payments not liable for ACC earner

levy

Lump sum (extra pay)

indicator

PAYE / tax Child support

deductions

Child support

code

Student loan deductions

KiwiSaver deductions

KiwiSaver employer

contributions

Tax credits for payroll

donations

Family tax credits

DTL 048126128 Eason Stacy M 20180402 2154800 0 0 650060 0 0 86194 57781 0 0

DTL 048126146 Davidson Gladys M 20180428 6464500 0 1 2072265 0 0 0 0 0 0

EMPLOYER DEDUCTION FORM (EDF-IR 345)

The following table represents the structure and data on an EDF file.

Detail Record

Indicator

Employer IRD number

Payment Date

Total PAYE and Tax (on schedular

payments)

Total Child Support

Deductions

Total Student

Loan

Deductions

Total KiwiSaver Deductions

Total KiwiSaver Employer

Contributions

Total ESCT Deducted

Total Amounts Payable

IR Form Version Number

EDF 048125352 20180430 1300120 0 0 86194 57781 28413 1472508 0003

Page 23: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook v1.0

23 In Confidence

3.7 ESCT (employer superannuation contribution tax)

Purpose

1. Populate each KiwiSaver contribution percentage and calculate ESCT.

Description

Existing employees gross earnings of $861.85, employee and employer KiwiSaver contributions. The employer is paying PAYE once a month.

Data Input

Data Inputs Pay Period Calculations Employee, Tax Code Pay Period

End Date Payment

Date Freq Gross

Earnings KiwiSaver Employee

KiwiSaver Employer

ESCT Rate PAYE KiwiSaver Employee

Deduction Amount

KiwiSaver Employer

Deduction Amount

Child Support

Deduction Amount

Payroll Giving Tax

Credit

Student Loan

Deduction Amount

ESCT EMS Filing Month

Tax Year

Mike Whitehead, M 03/05/18 09/05/18 weekly 861.85 3% 3% 10.5% 143.95 25.85 23.23 0.00 0.00 0.00 2.62 31/05/18 2019

Lynne Rose, M 03/05/18 09/05/18 weekly 861.85 3% 3% 17.5% 143.95 25.85 21.48 0.00 0.00 0.00 4.37 31/05/18 2019

Faye Sparks, M 03/05/18 09/05/18 weekly 861.85 3% 3% 30% 143.95 25.85 18.35 0.00 0.00 0.00 7.50 31/05/18 2019

Diana Moore, M 03/05/18 09/05/18 weekly 861.85 3% 3% 33% 143.95 25.85 17.60 0.00 0.00 0.00 8.25 31/05/18 2019

Leon Pearson, M 03/05/18 09/05/18 weekly 861.85 4% 4% 10.5% 143.95 34.47 30.90 0.00 0.00 0.00 3.57 31/05/18 2019

Ethel Rodgers, M 03/05/18 09/05/18 weekly 861.85 4% 4% 17.5% 143.95 34.47 28.52 0.00 0.00 0.00 5.95 31/05/18 2019

Steve Graves, M 03/05/18 09/05/18 weekly 861.85 4% 4% 30% 143.95 34.47 24.27 0.00 0.00 0.00 10.20 31/05/18 2019

Alison Scarborough, M 03/05/18 09/05/18 weekly 861.85 4% 4% 33% 143.95 34.47 23.25 0.00 0.00 0.00 11.22 31/05/18 2019

Sherri Sutton, M 03/05/18 09/05/18 weekly 861.85 8% 8% 10.5% 143.95 68.94 61.80 0.00 0.00 0.00 7.14 31/05/18 2019

Patsy Sinclair, M 03/05/18 09/05/18 weekly 861.85 8% 8% 17.5% 143.95 68.94 57.04 0.00 0.00 0.00 11.90 31/05/18 2019

Kelly Bowman, M 03/05/18 09/05/18 weekly 861.85 8% 8% 30% 143.95 68.94 48.54 0.00 0.00 0.00 20.40 31/05/18 2019

Stacy Olsen, M 03/05/18 09/05/18 weekly 861.85 8% 8% 33% 143.95 68.94 46.50 0.00 0.00 0.00 22.44 31/05/18 2019

Notes:

ESCT has been calculated using the standard method as per pages 15 & 16 of the IR335 Employer’s Guide

ESCT is Section 6.20 of the Payroll specification document.

The pay period 31/05/2018 includes 5 pay weeks.

Page 24: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook v1.0

24 In Confidence

EMPLOYER MONTHLY SCHEDULE (EMS-IR 348)

The following tables represent the structure and data on an EMS file.

Header Record

Header Record

Indicator

Employer IRD number

Return Period

Name of payroll contact

person

Payroll contact work

phone number

Total PAYE / tax

Total child support

Total student

loans

Total KiwiSaver

deductions

Total employer

contributions

total Tax credits for

payroll donations

Total family tax credits

Total gross earnings

Total earnings

not liable for earners'

levy (EL)

Payroll package and version no.

identifier

Email of payroll contact person

IR form version

number

HDR 048125352 20180531 John Jones 063048474 172740 0 0 51704 40148 0 0 1033200 0 IRDPayrollV1.1 [email protected] 0004

Detail Record

Detail

record indicator

Employee

IRD number employee name Employee

tax code Start date Finish date Gross

earnings and/ or

schedular

(withholding) payments

Earnings and

/ or schedular

(withholding)

payments not liable for

ACC earner levy

Lump sum

(extra pay) indicator

PAYE / tax Child

support deductions

Child

support code

Student loan

deductions KiwiSaver

deductions KiwiSaver

employer contributions

Tax credits

for payroll donations

Family tax

credits

DTL 048126154 Whitehead Mike M 86100 0 0 14395 0 0 2585 2323 0 0

DTL 048126162 Rose Lynne M 86100 0 0 14395 0 0 2585 2148 0 0

DTL 048126170 Sparks Faye M 86100 0 0 14395 0 0 2585 1835 0 0

DTL 048126189 Moore Diana M 86100 0 0 14395 0 0 2585 1760 0 0

DTL 048126197 Pearson Leon M 86100 0 0 14395 0 0 3447 3090 0 0

DTL 048126200 Rodgers Ethel M 86100 0 0 14395 0 0 3447 2852 0 0

DTL 048126219 Graves Steve M 86100 0 0 14395 0 0 3447 2427 0 0

DTL 048126227 Scarborough Alison M 86100 0 0 14395 0 0 3447 2325 0 0

DTL 048126235 Sutton Sherri M 86100 0 0 14395 0 0 6894 6180 0 0

DTL 048126243 Sinclair Patsy M 86100 0 0 14395 0 0 6894 5704 0 0

DTL 048126251 Bowman Kelly M 86100 0 0 14395 0 0 6894 4854 0 0

DTL 048126267 Olsen Stacy M 86100 0 0 14395 0 0 6894 4650 0 0

EMPLOYER DEDUCTION FORM (EDF-IR 345)

The following table represents the structure and data on an EDF file.

Detail Record

Indicator

Employer IRD number

Payment Date

Total PAYE and Tax (on schedular

payments)

Total Child Support

Deductions

Total Student

Loan

Deductions

Total KiwiSaver Deductions

Total KiwiSaver Employer

Contributions

Total ESCT Deducted

Total Amounts Payable

IR Form Version Number

EDF 048125352 20180531 172740 0 0 51704 40148 11556 276148 0003

Page 25: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook v1.0

25 In Confidence

3.8 Paying PAYE twice a month

Purpose

1. Demonstrate the filing of EDF (IR345) filing for large employers.

Description

An existing employee earns regular income of $ 5924.87 weekly, with employee and employer KiwiSaver contributions of 4%. The employer is paying PAYE twice a month.

Data Input

Data Inputs Pay Period Calculations Employee, Tax Code Pay Period

End Date Payment

Date Freq Gross

Earnings KiwiSaver Employee

KiwiSaver Employer

ESCT Rate PAYE KiwiSaver Employee

Deduction Amount

KiwiSaver Employer

Deduction Amount

Child Support

Deduction Amount

Payroll Giving Tax

Credit

Student Loan

Deduction Amount

ESCT EMS Filing Month

Tax Year

Curtis Love, M 01/05/18 02/05/18 weekly 5,924.87 4% 4% 33% 1,814.34 236.99 159.11 0.00 0.00 0.00 77.88 31/05/18 2019

Curtis Love, M 08/05/18 09/05/18 weekly 5,924.87 4% 4% 33% 1,814.34 236.99 159.11 0.00 0.00 0.00 77.88 31/05/18 2019

Curtis Love, M 15/05/18 16/05/18 weekly 5,924.87 4% 4% 33% 1,814.34 236.99 159.11 0.00 0.00 0.00 77.88 31/05/18 2019

Curtis Love, M 22/05/18 23/05/18 weekly 5,924.87 4% 4% 33% 1,814.34 236.99 159.11 0.00 0.00 0.00 77.88 31/05/18 2019

Curtis Love, M 29/05/18 30/05/18 weekly 5,924.87 4% 4% 33% 1,814.34 236.99 159.11 0.00 0.00 0.00 77.88 31/05/18 2019

Notes:

ESCT has been calculated using the standard method as per pages 15 & 16 of the IR335 Employer’s Guide

Page 26: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook v1.0

26 In Confidence

EMPLOYER MONTHLY SCHEDULE (EMS-IR 348)

The following tables represent the structure and data on an EMS file.

Header Record

Header Record

Indicator

Employer IRD number

Return Period

Name of payroll contact

person

Payroll contact work

phone number

Total PAYE / tax

Total child support

Total student

loans

Total KiwiSaver

deductions

Total employer

contributions

total Tax credits for

payroll donations

Total family tax credits

Total gross earnings

Total earnings

not liable for earners'

levy (EL)

Payroll package and version no.

identifier

Email of payroll contact person

IR form version

number

HDR 048125352 20180531 John Jones 063048474 907170 0 0 118495 79555 0 0 2962400 0 IRDPayrollV1.1 [email protected] 0004

Detail Record

Detail

record indicator

Employee

IRD number employee name Employee

tax code Start date Finish date Gross

earnings and/ or

schedular

(withholding) payments

Earnings and

/ or schedular

(withholding)

payments not liable for

ACC earner levy

Lump sum

(extra pay) indicator

PAYE / tax Child

support deductions

Child

support code

Student loan

deductions KiwiSaver

deductions KiwiSaver

employer contributions

Tax credits

for payroll donations

Family tax

credits

DTL 048126278 Love Curtis M 2962400 0 0 907170 0 0 118495 79555 0 0

EMPLOYER DEDUCTION FORM (EDF-IR 345)

The following table represents the structure and data on an EDF file.

Detail

Record Indicator

Employer

IRD number Payment

Date Total PAYE

and Tax (on schedular payments)

Total Child

Support Deductions

Total

Student Loan

Deductions

Total

KiwiSaver Deductions

Total

KiwiSaver Employer

Contribution

s

Total ESCT

Deducted Total

Amounts Payable

IR Form

Version Number

EDF 048125352 20180515 362868 0 0 47398 31822 15576 457664 0003 EDF 048125352 20180531 544302 0 0 71097 47733 23364 686496 0003

Page 27: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook v1.0

27 In Confidence

3.9 Student Loan deductions - SLCIR and SLBOR

Purpose

1. Demonstrate the filing of EDF (IR345) for SLCIR and SLBOR tax types.

2. SLCIR rate used was 41.67%

Description

Shows employee’s earning regular income of $ 2000 and $1500 monthly to show student loan threshold.

Data Input

Data Inputs Pay Period Calculations Employee, Tax Code Pay Period

End Date Payment

Date Freq SLCIR SLBOR Gross

Earnings KiwiSaver Employee

KiwiSaver Employer

ESCT Rate PAYE KiwiSaver Employee

Deduction Amount

KiwiSaver Employer

Deduction Amount

Child Support

Deduction Amount

Payroll Giving Tax

Credit

Student Loan

Deduction Amount

ESCT EMS Filing Month

Tax Year

Wayne Weiner, M SL 30/11/18 20/11/18 monthly Y 2,000.00 0% 296.09 0.00 0.00 0.00 0.00 64.48 0.00 30/11/18 2019

Nancy Durham, M SL 30/11/18 20/11/18 monthly N 80.00 2,000.00 0% 296.09 0.00 0.00 0.00 0.00 125.52 0.00 30/11/18 2019

Peter Guthrie, M SL 30/11/18 20/11/18 monthly Y 80.00 2,000.00 0% 296.09 0.00 0.00 0.00 0.00 144.48 0.00 30/11/18 2019

Benjamin Hensley, M SL 30/11/18 20/11/18 monthly Y 80.00 1,500.00 0% 201.67 0.00 0.00 0.00 0.00 80.00 0.00 30/11/18 2019

Page 28: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook v1.0

28 In Confidence

EMPLOYER MONTHLY SCHEDULE (EMS-IR 348)

The following tables represent the structure and data on an EMS file.

Header Record

Header Record

Indicator

Employer IRD number

Return Period

Name of payroll contact

person

Payroll contact work

phone number

Total PAYE / tax

Total child support

Total student

loans

Total KiwiSaver

deductions

Total employer

contributions

total Tax credits for

payroll donations

Total family tax credits

Total gross earnings

Total earnings

not liable for earners'

levy (EL)

Payroll package and version no.

identifier

Email of payroll contact person

IR form version

number

HDR 048125352 20181130 John Jones 063048474 108994 0 41708 0 0 0 0 750000 0 IRDPayrollV1.1 [email protected] 0004

Detail Record

Detail

record indicator

Employee

IRD number employee name Employee

tax code Start date Finish date Gross

earnings and/ or

schedular

(withholding) payments

Earnings and

/ or schedular

(withholding)

payments not liable for

ACC earner levy

Lump sum

(extra pay) indicator

PAYE / tax Child

support deductions

Child

support code

Student loan

deductions KiwiSaver

deductions KiwiSaver

employer contributions

Tax credits

for payroll donations

Family tax

credits

DTL 048130003 Weiner Wayne M SL 200000 0 0 29609 0 4552 0 0 0 0

DTL 048130003 Weiner Wayne SLCIR 0 0 0 0 0 2026 0 0 0 0

DTL 048130011 Durham Nancy M SL 200000 0 0 29609 0 4552 0 0 0 0

DTL 048130011 Durham Nancy SLBOR 0 0 0 0 0 8000 0 0 0 0

DTL 048130028 Guthrie Peter M SL 200000 0 0 29609 0 4552 0 0 0 0

DTL 048130028 Guthrie Peter SLCIR 0 0 0 0 0 2026 0 0 0 0

DTL 048130028 Guthrie Peter SLBOR 0 0 0 0 0 8000 0 0 0 0

DTL 048130038 Hensley Benjamin M SL 150000 0 0 20167 0 0 0 0 0 0

DTL 048130038 Hensley Benjamin SLBOR 0 0 0 0 0 8000 0 0 0 0

EMPLOYER DEDUCTION FORM (EDF-IR 345)

The following table represents the structure and data on an EDF file.

Detail Record

Indicator

Employer IRD number

Payment Date

Total PAYE and Tax (on

schedular payments)

Total Child Support

Deductions

Total Student

Loan Deductions

Total KiwiSaver

Deductions

Total KiwiSaver

Employer Contribution

s

Total ESCT Deducted

Total Amounts

Payable

IR Form Version

Number

EDF 048125352 20181130 108994 0 41708 0 0 0 150702 0003

Page 29: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook v1.0

29 In Confidence

3.10 Employee Share Scheme (ESS)

Purpose

1. Demonstrate ESS amount being declared where the employer chooses to deduct tax – Tax type M SL

2. Demonstrate ESS amount being declared where the employer chooses to deduct tax – Tax type M

3. Demonstrate ESS amount being declared where the employer chooses not to deduct tax – Tax type M

Description

Each of the examples below shows a 4-weekly pay of 3,500 declaring Employee Share scheme amount of $2,500.00.

Data Input

Data Inputs Pay Period Calculations Employee, Tax Code Pay Period

End Date Payment

Date Freq Gross

Earnings Lump Sum Child

Support KiwiSaver Employee

KiwiSaver Employer

ESCT Rate PAYE KiwiSaver Employee Deduction

Amount

KiwiSaver Employer Deduction

Amount

Child Support

Deduction

Amount

Payroll Giving Tax

Credit

Student Loan

Deduction

Amount

ESCT EMS Filing Month

Tax Year

Derek Freedman, M SL 31/05/18 17/05/18 4 weekly 6,000.00 2,500 3% 3% 17.5% 1,023.26 105.00 86.63 0.00 0.00 540.48 18.37 31/05/18 2019

Marlene Wiggins, M 31/05/18 17/05/18 4 weekly 6,000.00 2,500 3% 3% 17.5% 1,023.26 105.00 86.63 0.00 0.00 0.00 18.37 31/05/18 2019

Clara Best, M 31/05/18 17/05/18 4 weekly 6,000.00 2,500 3% 3% 17.5% 585.76 105.00 86.63 0.00 0.00 0.00 18.37 31/05/18 2019

Page 30: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook v1.0

30 In Confidence

EMPLOYER MONTHLY SCHEDULE (EMS-IR 348)

The following tables represent the structure and data on an EMS file.

Header Record

Header Record

Indicator

Employer IRD number

Return Period

Name of payroll contact

person

Payroll contact work

phone number

Total PAYE / tax

Total child support

Total student

loans

Total KiwiSaver

deductions

Total employer

contributions

total Tax credits for

payroll donations

Total family tax credits

Total gross earnings

Total earnings

not liable for earners'

levy (EL)

Payroll package and version no.

identifier

Email of payroll contact person

IR form version

number

HDR 048125352 20180531 John Jones 063048474 263228 0 54048 31500 25989 0 0 1800000 750000 IRDPayrollV1.1 [email protected] 0004

Detail Record

Detail

record indicator

Employee

IRD number employee name Employee

tax code Start date Finish date Gross

earnings and/ or

schedular

(withholding) payments

Earnings and

/ or schedular

(withholding)

payments not liable for

ACC earner levy

Lump sum

(extra pay) indicator

PAYE / tax Child

support deductions

Child

support code

Student loan

deductions KiwiSaver

deductions KiwiSaver

employer contributions

Tax credits

for payroll donations

Family tax

credits

DTL 048130046 Freedman Derek M SL 350000 0 0 58576 0 24048 10500 8663 0 0

DTL 048130046 Freedman Derek ESS 250000 250000 1 43750 0

30000 0 0 0 0

DTL 048130054 Wiggins Marlene M 350000 0 0 58576 0 0 10500 8663 0 0

DTL 048130054 Wiggins Marlene ESS 250000 250000 1 43750 0

0 0 0 0

DTL 048130062 Best Clara M 350000 0 0 58576 0 0 10500 8663 0 0

DTL 048130062 Best Clara ESS 250000 250000 0 0 0

0 0 0 0 0

EMPLOYER DEDUCTION FORM (EDF-IR 345)

The following table represents the structure and data on an EDF file.

Detail Record

Indicator

Employer IRD number

Payment Date

Total PAYE and Tax (on

schedular payments)

Total Child Support

Deductions

Total Student

Loan Deductions

Total KiwiSaver

Deductions

Total KiwiSaver

Employer Contribution

s

Total ESCT Deducted

Total Amounts

Payable

IR Form Version

Number

EDF 048125352 20180531 263228 0 54048 31500 25989 5511 380276 0003

Page 31: Payroll Software Developers Casebook 1 April 2018 to 31 ...v1.0.pdf · Inland Revenue Payroll Software Developers Casebook V1.0 3 In Confidence 1. Introduction myIR is Inland Revenue's

Inland Revenue Payroll Software Developers Casebook V1.0

31 In Confidence

Appendix A: Change Log

Themed colours:

Highlighted in yellow are changes

Highlighted in blue are with notations of ‘still to be confirmed’

Version No.

Date Change Description Updated By

1.00 Annual year update (period end, pay period end date & payment date

Update ACC thresholds

System Design and Implementation

- END -