Skip to main content

Budget 2024: The Government has announced FamilyBoost, a proposed new childcare payment to help eligible families with the rising costs of Early Childhood Education (ECE). Find out more: Beehive.govt.nz

Payday filing through our gateway service lets employers send us:

  • employment information each pay cycle using the return service (employment information forms)
  • new and departing employee information as needed using the employment service.

Gateway service capability for employment information

The gateway service used for employment information is the return service. It provides the following capabilities through defined service operations:

Service operation Description
File Lets employers submit employment information for a specific pay cycle and change employee details.
Prepop Not applicable for payday filing.
Retrieve Status Provides the processing status of previously submitted employment information for a specific pay cycle.
Retrieve Return Provides a copy of previously submitted employment information for a specific pay cycle.
Retrieve Filing Obligation Not applicable for payday filing.

Payday filing software developer kits

Gateway service capability for employee details

The gateway service used for employee details is the employment service. It provides the following capabilities through defined service operations:

Description
Create Lets information for a new employee be submitted to us.
Update Lets information for an existing employee be submitted, for example a KS10.
RetrieveList Provides employee details previously submitted for an employee or all employees (depending on what has been requested).
Terminate Lets an employer submit information about a departing employee.

Payday filing business use cases

The following are examples of show sequences that can be used to achieve a specific business outcome for payday filing when calling the service operations through our gateway services.

Payday filing - Employee details and employment information - GWS business use cases

Payday filing - KiwiSaver scenarios

Employer events table

Last updated: 28 Apr 2021
Jump back to the top of the page