Skip to main content

Takapuna office closure | Takapuna office closure. The Takapuna office is relocating to a new address so will be closed from 22 November 4pm to 26 November 4pm. From 27 November you can find the new office at: 74 Taharoto Road Smales Farm, One NZ Building, Takapuna.

Some services unavailable 23 - 24 November | myIR, gateway services and our self-service phone line will not be available from 3pm Saturday 23 November to 9am Sunday 24 November while we do planned system testing. This will not affect any tax entitlements or payments scheduled during this time.

AIM is a provisional tax option that uses accounting software to work out how much provisional tax small businesses will have to pay throughout the year. 

How AIM-capable software works

AIM-capable software works out business AIM profit which is the total profit (or loss) for a specific period including adjustments.

When integrated through our gateway services it lets businesses:

  • check if they're eligible to use AIM
  • file statements of activity
  • query losses and residual taxes
  • query period balances
  • retrieve statements of activity already filed.

For access to myIR File Upload and Gateway Services detailed technical documentation, register your organisation or login to Gateway Customer Support Portal using the links below.

Accounting income method (AIM) 

Gateway service capability for AIM

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

Service operation Description
Prepop Provides eligibility to use AIM and information relating to this.
File Customers can file a single statement of activity.
RetrieveStatus Provides the processing status of previously filed statements of activity.
RetrieveReturn Provides a copy of previously filed statements of activity.
RetrieveFilingObligation Provides the next due date for the statement of activity.

AIM business use cases

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

Keys

  • Gateway service operations: RS = Retrieve Status, RR = Retrieve Return, RFO = Retrieve Filing Obligation
  • The numbers for each use case are the order in which these operations should be called when using this services.
Use case Gateway service operation
File Prepop RS RR RFO
1. Confirm user's eligibility to use AIM service 1
2. File a new statement of activity 2 1
3. Retrieve the status of a previously filed statement of activity and next filing obligation 1 2
4. Retrieve previously filed statement of activity 1
5. Amend and file a statement of activity 3 2 1
Last updated: 28 Aug 2024
Jump back to the top of the page