Aroai
Get started

Business tax · New Zealand

Calculate New Zealand provisional tax

Calculate supported standard, estimation or ratio provisional-tax instalments for eligible New Zealand cases, using the stated tax year and method.

Use Aroai for freeConnect your client

Tool ID

nz_provisional_tax

Calculate supported standard, estimation or ratio provisional-tax instalments for eligible New Zealand cases, using the stated tax year and method.

LiveNew ZealandBusiness tax1 credit
ServerNew Zealand
Information categoryTax calculations
Credit behavior1 credit
AccessWorkspace permissions

Inputs and outputs

Published input schema

Use the discovered runtime schema for the workspace you are connected to.

Public catalog
nz_provisional_tax input schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "tax_year": {
      "type": "string",
      "enum": [
        "2025-26",
        "2026-27"
      ]
    },
    "method": {
      "type": "string",
      "enum": [
        "standard",
        "estimation",
        "ratio"
      ]
    },
    "prior_year_rit": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000
    },
    "two_years_prior_rit": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000
    },
    "has_extension_of_time": {
      "type": "boolean"
    },
    "filing_timing": {
      "type": "string",
      "enum": [
        "before_first",
        "after_first",
        "after_second"
      ]
    },
    "estimated_rit": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000
    },
    "ird_issued_rate": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "description": "Enter a decimal fraction, for example 0.085 for 8.5%."
    },
    "instalment_income_ex_gst": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000
    },
    "period_number": {
      "type": "integer",
      "minimum": 1,
      "maximum": 6
    }
  },
  "required": [
    "tax_year",
    "method"
  ],
  "additionalProperties": false
}

Published output shape

Tool results return structured data or a stable error object.

Shared Aroai tool output schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "summary": {
          "type": "string"
        },
        "data": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        "executionId": {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        "creditsCharged": {
          "type": "number",
          "minimum": 0
        },
        "usage": {
          "type": "object",
          "properties": {
            "credits_charged": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "credits_remaining": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "credits_charged"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "summary",
        "data",
        "creditsCharged"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "error": {
          "type": "object",
          "properties": {
            "code": {
              "type": "string"
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            }
          },
          "required": [
            "code",
            "message",
            "retryable"
          ],
          "additionalProperties": false
        },
        "usage": {
          "type": "object",
          "properties": {
            "credits_charged": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "credits_remaining": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "credits_charged"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

Use this capability

Build on your next business question.

Explore related tools or connect your AI client to get started.

Explore toolsClient setup

Local intelligence. Ready to build.

Put your AI to work.

Create a free workspace and bring local business context into your AI tools.

Use Aroai for freeExplore tools