The bill service provides the provisional tax assessment information held by Inland Revenue.
How the bill service works
By providing the ‘bill ID’ from a provisional tax assessment bill, the bill service will retrieve the information, ordered by provisional tax transaction, linked to that bill.
The version 1.0 release of this service is only available to digital service providers who have integrated with our transaction data services.
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.
Gateway service capability for the bill service
The gateway service used is the bill API. It provides the following capabilities through defined service operations:
| Service operation | Description |
|---|---|
| Post | Retrieves provisional tax assessment information from Inland Revenue. Requires a Bill ID. |
The information returned from a request can include:
- Transaction information: customer, account period, bill, process date, filing period, due date, amount, method, transaction and whether reversed or not.
- The provisional tax option used for the bill, and then the assessment: standard, estimate, ratio or AIM.
- Percentages used for ratio options.
- Return periods the standard option used for bill calculations (for example last period, the period before that) and the filing date.
- Ratios used in the standard option: 110% for instalments until the return is filed, 105% for the remaining instalments.
The bill service business use case
The following is an example of a business use case on the gateway bill service operation that could be used to achieve a specific business outcome.
| Number | Use case | Post |
|---|---|---|
| 1 | View the provisional tax assessment information | 1 |