Make a payment
Software providers Kaiwhakarato Pūmanawa Rorohiko

Push Notifications Service

The Push Notifications service is a business service which provides notification of change to the status of a return via software packages.

Information about the Push Notifications service

The Push Notifications service uses Secure File Transfer Protocol (SFTP) to provide software with notifications of changes to return status.

This service is currently only available for the following tax type:

  • Income tax

The service is expected to be extended in future to accommodate additional notification types.

If you have any questions about this service or using gateway services email GatewayServices@ird.govt.nz

Gateway services capabilities for the Push Notifications service

The push notification service is a daily file transfer service from Inland Revenue. It provides software with an overnight notification of changes to return status for intermediaries and customers using their software.

Download and view the Push Notifications build pack and sample files:

  • to find out technical requirements and specifications
  • to view the processes and data definitions for the sample payloads

Supporting services for Push Notifications

Return Service (for Income Tax filing)

This service allows the filing of Income tax returns to Inland Revenue for individuals and non-individual entities.

Find out more about the return service for income tax

Software intermediation service

This service allows the linking of tax agents and customers to software providers. These links are used by the bulk file feed and history bulk file feed services.

Find out more about the software intermediation service

Intermediation service

This service allows the linking, delinking or updating of the intermediary client list to their clients' accounts or customer master and additionally the ability to retrieve clients and client lists that have already been established.

Find out more about the intermediation service

Back to top

Push notification service business use cases

The following are examples of sequences of the gateway services and operations that could be used to achieve a specific business outcome.

Number Use case Return Service /
File Operation
Push Notification
Service
1
Submit a new Income Tax return, then at a later date receive a Push Notification that status updates are available for the return
1
2
2
Amend an Income Tax return, then at a later date receive a Push Notification that status updates are available for the return
1
2

Back to top