retention_position contract v2

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://docs.demiton.io/registers/retention_position/v2.json",
  "title": "retention_position contract v2",
  "type": "object",
  "required": [
    "project_ref",
    "retention_held"
  ],
  "properties": {
    "project_ref": {
      "type": "string",
      "description": "The subject project's stable external reference (today the ERP job number).",
      "x-demiton-requiredness": "required",
      "x-demiton-unit": "n/a"
    },
    "contract_ref": {
      "type": "string",
      "description": "The contract or trust account the retention attaches to",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "n/a"
    },
    "retention_held": {
      "type": "boolean",
      "description": "Whether money is currently withheld by the client",
      "x-demiton-requiredness": "required",
      "x-demiton-unit": "n/a"
    },
    "retention_basis": {
      "type": "string",
      "description": "How the retention was calculated (percent of each claim, accumulated, cap)",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "n/a"
    },
    "retention_amount": {
      "type": "number",
      "description": "The amount currently withheld, as recorded by the source",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "currency of the bound legal entity",
      "x-demiton-type": "decimal"
    },
    "retention_status": {
      "type": "string",
      "description": "The producer's lifecycle code: `PC`, `DLP`, `BG`, `COMPLETED`",
      "x-demiton-requiredness": "tenant-specific",
      "x-demiton-unit": "n/a"
    },
    "retention_currency": {
      "type": "currency",
      "description": "The currency the amount is denominated in",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "n/a"
    },
    "retention_amount_source": {
      "type": "string",
      "description": "Which system actually supplied `retention_amount` (today the constant `bc_job_card_unpopulated`)",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "n/a"
    }
  },
  "x-demiton-register-type": "retention_position",
  "x-demiton-contract-version": "2.0.2",
  "x-demiton-store": "tenant",
  "x-demiton-axes": [
    {
      "axis": "customer",
      "requirement": "optional",
      "role": "context"
    },
    {
      "axis": "legal_entity",
      "requirement": "optional",
      "role": "context"
    }
  ],
  "x-demiton-measures": [],
  "x-demiton-provenance": {
    "standards": [
      {
        "code": "AS 4000-1997",
        "title": "General Conditions of Contract (superseded edition, still in use)",
        "access": "paywalled_secondary",
        "region": "Australia",
        "edition": "1997",
        "checked_on": "2026-09-14"
      },
      {
        "code": "AS 4000:2025",
        "title": "General Conditions of Contract (construct only)",
        "access": "paywalled_secondary",
        "clause": "Annexure Part A (per commentary)",
        "region": "Australia",
        "edition": "2025",
        "checked_on": "2026-09-14"
      },
      {
        "code": "AS 4902-2000",
        "title": "General Conditions of Contract for Design and Construct",
        "access": "paywalled_secondary",
        "region": "Australia",
        "edition": "2000",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Corporations Act 2001 (Cth) s 286",
        "title": "Corporations Act 2001 (Cth) - financial records, 7-year retention",
        "access": "full_text_verified",
        "clause": "s 286",
        "region": "Australia",
        "edition": "current",
        "checked_on": "2026-09-14"
      },
      {
        "code": "QLD BIF Act 2017",
        "title": "Building Industry Fairness (Security of Payment) Act 2017 (Qld)",
        "access": "public_summary",
        "region": "Australia",
        "edition": "2017 as amended",
        "checked_on": "2026-09-14"
      },
      {
        "code": "VIC BCISP Act 2002",
        "title": "Building and Construction Industry Security of Payment Act 2002 (Vic), as amended from 15 Apr 2026",
        "access": "public_summary",
        "clause": "ss 17A-17H (per commentary)",
        "region": "Australia",
        "edition": "2002 as amended 15 Apr 2026",
        "checked_on": "2026-09-14"
      },
      {
        "code": "WA BCISP Act 2021",
        "title": "Building and Construction Industry (Security of Payment) Act 2021 (WA)",
        "access": "full_text_verified",
        "clause": "ss 59, 71-77",
        "region": "Australia",
        "edition": "2021",
        "checked_on": "2026-09-14"
      },
      {
        "code": "NZ CCA 2002",
        "title": "Construction Contracts Act 2002 (NZ), 2002 No 46, as amended 2015 and 2023",
        "access": "full_text_verified",
        "clause": "ss 18B, 18C, 18D, 18DA, 18FD",
        "region": "New Zealand",
        "edition": "as at 5 Oct 2023",
        "checked_on": "2026-09-14"
      },
      {
        "code": "HGCRA 1996 Part II",
        "title": "Housing Grants, Construction and Regeneration Act 1996, Part II (as amended by LDEDCA 2009)",
        "access": "full_text_verified",
        "clause": "ss 111, 113",
        "region": "United Kingdom",
        "edition": "1996 c. 53 as amended",
        "checked_on": "2026-09-14"
      },
      {
        "code": "AIA G702-1992 / G703-1992",
        "title": "Application and Certificate for Payment; Continuation Sheet",
        "access": "public_summary",
        "region": "United States",
        "edition": "1992 (current base editions)",
        "checked_on": "2026-09-14"
      }
    ]
  },
  "description": "Retention currently withheld on a job, and its status.",
  "x-demiton-contract-url": "https://docs.demiton.io/registers/retention_position/",
  "x-demiton-register-catalog": "https://docs.demiton.io/concepts/register-catalog"
}