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 notice period calculator calculator: Where your notice period comes from; Weeks of notice actually worked; Weeks of notice you are paid for; Pay for the notice period, before tax. Missing inputs fall back to their documented defaults.

{
  "type": "object",
  "properties": {
    "agreement": {
      "type": "string",
      "description": "Does your employment agreement state a notice period?",
      "default": "stated"
    },
    "noticeWeeks": {
      "type": "number",
      "minimum": 0,
      "maximum": 26,
      "description": "Notice period in weeks",
      "default": 4
    },
    "arrangement": {
      "type": "string",
      "enum": [
        "work",
        "garden",
        "waived",
        "misconduct"
      ],
      "description": "What is happening with the notice period?",
      "default": "work"
    },
    "weeksNotWorked": {
      "type": "number",
      "minimum": 0,
      "maximum": 26,
      "description": "Weeks of the notice not worked",
      "default": 0
    },
    "weeklyPay": {
      "type": "number",
      "minimum": 0,
      "maximum": 20000,
      "description": "Gross weekly pay",
      "default": 1400
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Read first. States plainly what submit_enquiry does on Notice Period 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 Notice Period 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 Notice Period 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: "Send my contact details to up to three payroll and HR service providers, chosen by Notice Period Calculator NZ, who'll contact me directly. I'll be emailed each firm's name as my details go to it, and can stop any more firms getting them."

{
  "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: Send my contact details to up to three payroll and HR service providers, chosen by Notice Period Calculator NZ, who'll contact me directly. I'll be emailed each firm's name as my details go to it, and can stop any more firms getting them."
    },
    "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#"
}