Skip to main content
Check out our new content, navigation and design for digital service providers.

COVID-19 - Level 2/3 If you've been affected by COVID-19, we may be able to help. Find out more

The software intermediation 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.

About the software intermediation service

The software intermediation service is a SOAP web service that enables intermediaries to either link or delink: 

  • a business intermediary client list to, or from, a transaction data service (TDS) software intermediary customer
  • an organisation account to, or from, a TDS software provider. 

If you have any questions about using gateway services for the software intermediation service, email GatewayServices@ird.govt.nz.

Information on the different types of intermediaries that interact with us:

Intermediaries and others

Software intermediation service software development kit (SDK)

This SDK helps you integrate:

  • the schema (XSD) and supporting WSDL for the return service
  • the build pack to view data definitions and response status codes
  • sample request and response messages.

Software intermediation service software developer kit (SDK) on Github)

 

Use the 'Getting started guide' to find out how to access our sandbox (mock services) and test environments.

Getting started guide

Gateway services capability

Service operation Description
Link

Enables linking of:

  • a business intermediary client list to a transaction data service (TDS) software intermediary customer
  • an organisation account to a TDS software provider.
Delink

Enables delinking (ceasing) of:

  • a business intermediary client list to a transaction data service (TDS) software intermediary customer
  • an organisation account to a TDS software provider. 
Retrieve client list

Enables retrieving of a business intermediary client list to a transaction data service (TDS) software intermediary customer. This can be filtered by client account type or client list ID. 

 Services supporting software intermediation

Identity and access

Intermediation service

Transaction data services (TDS)