{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://docs.demiton.io/registers/leave_category_list/v1.json",
  "title": "leave_category_list contract v1",
  "type": "object",
  "required": [
    "code",
    "leave_category_type",
    "leave_code_entity_id",
    "name",
    "source_external_id",
    "unit_type"
  ],
  "properties": {
    "code": {
      "type": "string",
      "description": "The leave-category code the cross-source alias binding matches on",
      "x-demiton-requiredness": "required"
    },
    "name": {
      "type": "string",
      "description": "Human name of the leave category",
      "x-demiton-requiredness": "required"
    },
    "units": {
      "type": "number",
      "description": "The source's unit count/denomination for the category",
      "x-demiton-requiredness": "optional"
    },
    "unit_type": {
      "type": "string",
      "description": "Unit the entitlement and balance are denominated in",
      "x-demiton-requiredness": "required"
    },
    "is_private": {
      "type": "boolean",
      "description": "Source privacy flag for the category",
      "x-demiton-requiredness": "optional"
    },
    "accrual_rule": {
      "type": "object",
      "description": "The source's accrual-rule object",
      "x-demiton-requiredness": "optional"
    },
    "external_code": {
      "type": "string",
      "description": "Stable manufacturer/award code where the source supplies one",
      "x-demiton-requiredness": "optional"
    },
    "payout_as_etp": {
      "type": "boolean",
      "description": "Whether the category pays out as an employment termination payment",
      "x-demiton-requiredness": "optional"
    },
    "is_name_private": {
      "type": "boolean",
      "description": "Whether the category is hidden from payslips by name",
      "x-demiton-requiredness": "optional"
    },
    "leave_unit_type": {
      "type": "string",
      "description": "The source's second unit field; its distinction from `unitType` is unverified",
      "x-demiton-requiredness": "optional"
    },
    "legal_entity_id": {
      "type": "integer",
      "description": "Owning legal entity where the source is multi-company",
      "x-demiton-requiredness": "optional"
    },
    "contingent_period": {
      "type": "number",
      "description": "The category's contingent period",
      "x-demiton-requiredness": "optional"
    },
    "leave_entitlement": {
      "type": "string",
      "description": "Entitlement value where the source supplies one",
      "x-demiton-requiredness": "optional"
    },
    "entitlement_period": {
      "type": "number",
      "description": "The category's entitlement period",
      "x-demiton-requiredness": "optional"
    },
    "is_pay_run_accrual": {
      "type": "boolean",
      "description": "Whether accrual happens at pay-run time",
      "x-demiton-requiredness": "optional"
    },
    "leave_loading_rate": {
      "type": "number",
      "description": "Leave loading applied to this category",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "percent"
    },
    "source_external_id": {
      "type": "number",
      "description": "The raw record id in the producing system",
      "x-demiton-requiredness": "required"
    },
    "leave_category_type": {
      "type": "string",
      "description": "The category's leave type (annual / personal-carer's / long service / …)",
      "x-demiton-requiredness": "required"
    },
    "is_balance_untracked": {
      "type": "boolean",
      "description": "Whether the category is excluded from balance tracking",
      "x-demiton-requiredness": "optional"
    },
    "leave_code_entity_id": {
      "type": "integer",
      "description": "Demiton canonical `LEAVE_CODE` spine node this fact is about",
      "x-demiton-requiredness": "required"
    },
    "statutory_leave_type": {
      "type": "string",
      "description": "The ATO paid-leave type this category maps to (O/P/W/A/C/U)",
      "x-demiton-requiredness": "optional"
    },
    "automatically_accrues": {
      "type": "boolean",
      "description": "Whether the category accrues automatically",
      "x-demiton-requiredness": "optional"
    },
    "source_classification": {
      "type": "string",
      "description": "The source's own classification of the category's origin",
      "x-demiton-requiredness": "optional"
    },
    "hide_accruals_on_payslip": {
      "type": "boolean",
      "description": "Whether accruals are hidden on the payslip",
      "x-demiton-requiredness": "optional"
    },
    "exclude_from_termination_payout": {
      "type": "boolean",
      "description": "Whether the category is excluded from a termination payout",
      "x-demiton-requiredness": "optional"
    },
    "deduct_from_primary_pay_category": {
      "type": "boolean",
      "description": "Whether the deduction follows the primary pay category",
      "x-demiton-requiredness": "tenant-specific"
    },
    "use_deduct_from_pay_category_rate": {
      "type": "boolean",
      "description": "Whether the deducting category's rate is used",
      "x-demiton-requiredness": "tenant-specific"
    },
    "transfer_to_pay_category_reference": {
      "type": "number",
      "description": "Source id of the tenant-configured pay category this category transfers into",
      "x-demiton-requiredness": "tenant-specific"
    },
    "accrues_first_pay_run_per_period_only": {
      "type": "boolean",
      "description": "Accrual timing within a period",
      "x-demiton-requiredness": "optional"
    },
    "default_deduct_from_pay_category_reference": {
      "type": "number",
      "description": "Source id of the tenant-configured pay category this category deducts from",
      "x-demiton-requiredness": "tenant-specific"
    },
    "transfer_on_termination_pay_category_reference": {
      "type": "number",
      "description": "Source id of the tenant-configured pay category used on termination",
      "x-demiton-requiredness": "tenant-specific"
    },
    "prevent_negative_balance_unpaid_leave_category_reference": {
      "type": "string",
      "description": "Source id of the tenant-configured category used to prevent a negative unpaid balance",
      "x-demiton-requiredness": "tenant-specific"
    }
  },
  "x-demiton-register-type": "leave_category_list",
  "x-demiton-contract-version": "1.0.3",
  "x-demiton-store": "tenant",
  "x-demiton-axes": [],
  "x-demiton-measures": [],
  "x-demiton-provenance": {
    "standards": [
      {
        "code": "Fair Work Act 2009 (Cth)",
        "title": "Fair Work Act 2009 - employee records and National Employment Standards",
        "access": "full_text_verified",
        "clause": "ss.87(1), 96(1), 535(1) ; s.106A",
        "region": "Australia",
        "edition": "compilation 2026-07-07",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Fair Work Regulations 2009 (Cth)",
        "title": "Fair Work Regulations 2009 - employee record content",
        "access": "full_text_verified",
        "clause": "reg 3.36",
        "region": "Australia",
        "edition": "compilation 2026-06-20",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Payday Super (ATO)",
        "title": "Single Touch Payroll reporting under Payday Super",
        "access": "public_summary",
        "region": "Australia",
        "edition": "from 1 Jul 2026",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Single Touch Payroll Phase 2 (ATO)",
        "title": "Single Touch Payroll Phase 2 employer reporting guidelines",
        "access": "public_summary",
        "region": "Australia",
        "edition": "Phase 2 (mandatory from 1 Jan 2022)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "ISO 30414:2025",
        "title": "Human resource management - Requirements and recommendations for human capital reporting and disclosure",
        "access": "paywalled_secondary",
        "region": "International",
        "edition": "2nd ed. 2025 (supersedes ISO 30414:2018)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Employment Leave Act 2026 (NZ)",
        "title": "Employment Leave Act 2026 (2026 No 48)",
        "access": "full_text_verified",
        "clause": "ss.24(1), 73(1), 75(1), 127, 129, 130, 150",
        "region": "New Zealand",
        "edition": "assent 6 Aug 2026; not yet in force",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Holidays Act 2003 (NZ)",
        "title": "Holidays Act 2003 (2003 No 129) - holiday and leave record",
        "access": "full_text_verified",
        "clause": "ss.16, 65(2)",
        "region": "New Zealand",
        "edition": "version as at 20 Dec 2023 (repealed on commencement of Employment Leave Act 2026)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "SI 1998/1833",
        "title": "Working Time Regulations 1998",
        "access": "full_text_verified",
        "clause": "regs 9, 13(1), 13A(2)(e), 13A(3), 15B",
        "region": "United Kingdom",
        "edition": "as amended by SI 2023/1426 from 1 Jan 2024",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Statutory Sick Pay (Social Security Contributions and Benefits Act 1992)",
        "title": "Statutory Sick Pay - weekly statutory payment, no day entitlement",
        "access": "public_summary",
        "region": "United Kingdom",
        "edition": "rate read 2026-09-11",
        "checked_on": "2026-09-14"
      }
    ]
  },
  "description": "Leave types defined in your payroll and operational systems.",
  "x-demiton-contract-url": "https://docs.demiton.io/registers/leave_category_list/",
  "x-demiton-register-catalog": "https://docs.demiton.io/concepts/register-catalog"
}