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 Annual holiday pay calculator calculator: Ordinary weekly pay used; Average weekly earnings; Weekly rate the law requires; Annual holiday pay for this period. Missing inputs fall back to their documented defaults.

{
  "type": "object",
  "properties": {
    "weeks": {
      "type": "number",
      "minimum": 0,
      "maximum": 12,
      "description": "Weeks of annual holidays you are taking",
      "default": 2
    },
    "owpMode": {
      "type": "string",
      "description": "How should we work out ordinary weekly pay?",
      "default": "known"
    },
    "owp": {
      "type": "number",
      "minimum": 0,
      "maximum": 20000,
      "description": "Ordinary weekly pay",
      "default": 1500
    },
    "lastFourWeeks": {
      "type": "number",
      "minimum": 0,
      "maximum": 80000,
      "description": "Gross earnings in the last 4 weeks (formula only)",
      "default": 6200
    },
    "irregular": {
      "type": "number",
      "minimum": 0,
      "maximum": 80000,
      "description": "One-off or irregular payments in those 4 weeks",
      "default": 0
    },
    "grossEarnings": {
      "type": "number",
      "minimum": 0,
      "maximum": 2000000,
      "description": "Gross earnings over the last 12 months",
      "default": 82000
    },
    "weeksEmployed": {
      "type": "number",
      "minimum": 1,
      "maximum": 52,
      "description": "Weeks to divide by",
      "default": 52
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Read first. States plainly what submit_enquiry does on Holiday 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 Holiday 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 Holiday 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 a payroll specialist or employment adviser, 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 a payroll specialist or employment adviser, 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#"
}