site

The inputs this calculator takes (with units, ranges and defaults), the outputs it returns, and the assumptions and tables behind it.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Run the New Zealand final pay calculator calculator: Rate for unused annual holidays; Unused annual holidays; 8% of gross earnings; Final pay before tax. Missing inputs fall back to their documented defaults.

{
  "type": "object",
  "properties": {
    "service": {
      "type": "string",
      "description": "How long had you worked there?",
      "default": "entitled"
    },
    "wagesOwed": {
      "type": "number",
      "minimum": 0,
      "maximum": 200000,
      "description": "Wages for hours worked but not yet paid",
      "default": 1600
    },
    "noticePay": {
      "type": "number",
      "minimum": 0,
      "maximum": 200000,
      "description": "Pay for the rest of the notice period",
      "default": 0
    },
    "leaveWeeks": {
      "type": "number",
      "minimum": 0,
      "maximum": 20,
      "description": "Unused annual holidays you are entitled to (weeks)",
      "default": 2
    },
    "owp": {
      "type": "number",
      "minimum": 0,
      "maximum": 20000,
      "description": "Ordinary weekly pay",
      "default": 1400
    },
    "awe": {
      "type": "number",
      "minimum": 0,
      "maximum": 20000,
      "description": "Average weekly earnings",
      "default": 1475
    },
    "grossEarnings": {
      "type": "number",
      "minimum": 0,
      "maximum": 1000000,
      "description": "Gross earnings for the 8% payment",
      "default": 24000
    },
    "alreadyPaid": {
      "type": "number",
      "minimum": 0,
      "maximum": 200000,
      "description": "Holiday pay you have already had",
      "default": 0
    },
    "publicHolidays": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000,
      "description": "Public and alternative holidays owed",
      "default": 0
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Read first. States plainly what submit_enquiry does on Final Pay Calculator NZ: it starts an enquiry with human providers who quote directly. Nothing is bought, ordered or paid; no quote is guaranteed; it is free. Also returns who receives the details, the consent wording, and how the person confirms.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Every field of the Final Pay Calculator NZ enquiry: key, label, type, whether required, help text and the allowed options where there are any. Pass answers to submit_enquiry keyed by field key.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Submits an enquiry to Final Pay Calculator NZ — NOT a purchase, NOT a guaranteed quote. Step 1: call with the answers (keyed by field key from enquiry_fields) and consent=true; it validates and returns a summary, the consent line and a confirmation token — show the person the summary and the consent line. Step 2: only if the person agrees, call again with the same answers, consent=true and the confirmation token; the enquiry is then submitted, and the person receives an email with a link they must click before any provider sees it. Consent means the person has read and agreed to: "Happy for my details to go to an employment adviser or payroll specialist, who'll contact me directly."

{
  "type": "object",
  "properties": {
    "answers": {
      "type": "object",
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      },
      "description": "the person's answers, keyed by field key"
    },
    "consent": {
      "type": "boolean",
      "description": "true only when the person has agreed to: Happy for my details to go to an employment adviser or payroll specialist, who'll contact me directly."
    },
    "confirmation": {
      "type": "string",
      "description": "the confirmation token from step 1, after the person has approved the summary"
    }
  },
  "required": [
    "answers",
    "consent"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}