Estimate a New Zealand GST return.
LiveNew Zealand1 credit
What it does
Estimate the boxes of a GST return for a full period from your sales and purchase totals, on an invoice, payments or hybrid basis, with anything assumed nil listed.
Ask your AI
Estimate a New Zealand GST return. Ask me for any detail you need first, then show the result with its source and date, and list anything a person should check.
What comes back
Totals are GST-inclusive standard-rated amounts.
Good to know
- Totals are GST-inclusive standard-rated amounts.
- Omitted zero-rated sales or adjustments are listed and can mark the estimate incomplete.
- Mixed-use assets and land transactions are left for review.
For developers
| Tool ID | nz_gst_return_estimate |
|---|---|
| Server | New Zealand |
| Credit behaviour | 1 credit |
Input schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"period_start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"period_end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"filing_frequency": {
"type": "string",
"enum": [
"monthly",
"two_monthly",
"six_monthly"
]
},
"accounting_basis": {
"type": "string",
"enum": [
"invoice",
"payments",
"hybrid"
]
},
"sales": {
"type": "object",
"properties": {
"standard_rated_inclusive": {
"type": "number",
"minimum": 0,
"maximum": 100000000,
"description": "GST-inclusive standard-rated sales for accounting_basis: invoice and hybrid = supplies first attributed to this period by invoice or any earlier payment (whichever comes first, subject to special rules); payments = received. Enter zero-rated and exempt sales separately."
},
"zero_rated": {
"description": "GST-inclusive zero-rated sales under the selected basis.",
"type": "number",
"minimum": 0,
"maximum": 100000000
},
"exempt": {
"description": "Exempt sales under the selected basis; excluded from Box 5.",
"type": "number",
"minimum": 0,
"maximum": 100000000
}
},
"required": [
"standard_rated_inclusive"
],
"additionalProperties": false
},
"purchases": {
"type": "object",
"properties": {
"standard_rated_inclusive": {
"type": "number",
"minimum": 0,
"maximum": 100000000,
"description": "GST-inclusive standard-rated purchases for accounting_basis: invoice = purchases first attributed to this period by invoice or any earlier payment (with a valid taxable supply record); payments/hybrid = paid. Exclude imports; enter Customs GST separately."
}
},
"required": [
"standard_rated_inclusive"
],
"additionalProperties": false
},
"adjustments": {
"default": {},
"type": "object",
"properties": {
"private_use_gst": {
"description": "Calculated private-use GST debit adjustment for this period.",
"type": "number",
"minimum": 0,
"maximum": 100000000
},
"other_debit_gst": {
"description": "Calculated other GST debit adjustments for this period.",
"type": "number",
"minimum": 0,
"maximum": 100000000
},
"customs_gst_paid": {
"description": "Customs GST paid on imports, as calculated from Customs records.",
"type": "number",
"minimum": 0,
"maximum": 100000000
},
"other_credit_gst": {
"description": "Calculated other GST credit adjustments for this period.",
"type": "number",
"minimum": 0,
"maximum": 100000000
}
},
"additionalProperties": false
}
},
"required": [
"period_start",
"period_end",
"filing_frequency",
"accounting_basis",
"sales",
"purchases",
"adjustments"
],
"additionalProperties": false
}Shared 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
}
]
}