{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://docs.demiton.io/registers/variations/v1.json",
  "title": "variations contract v1",
  "type": "object",
  "required": [
    "_source_file_name",
    "_source_path",
    "acceptance_status",
    "doc_kind",
    "line_items",
    "pca_ref"
  ],
  "properties": {
    "notes": {
      "type": "string",
      "description": "Free text (register)",
      "x-demiton-requiredness": "optional"
    },
    "amount": {
      "type": "number",
      "description": "Agreed amount (register)",
      "x-demiton-requiredness": "optional"
    },
    "client": {
      "type": "string",
      "description": "Client named on the advice",
      "x-demiton-requiredness": "optional"
    },
    "status": {
      "type": "string",
      "description": "Register lifecycle state",
      "x-demiton-requiredness": "optional"
    },
    "pca_ref": {
      "type": "string",
      "description": "Variation reference on the advice form; the per-advice supersede discriminator",
      "x-demiton-requiredness": "required"
    },
    "subject": {
      "type": "string",
      "description": "Subject line of the advice",
      "x-demiton-requiredness": "optional"
    },
    "summary": {
      "type": "string",
      "description": "Engine-generated human summary folding the parsed keys",
      "x-demiton-requiredness": "optional"
    },
    "currency": {
      "type": "currency",
      "description": "the currency of every amount on this record (`amount`, `amount_ex_gst` and each line's amount), an ISO 4217 alpha-3 code as the document states it. A record with no currency has no usable amount.",
      "x-demiton-requiredness": "optional"
    },
    "doc_kind": {
      "type": "string",
      "description": "Classification of the source artefact",
      "x-demiton-requiredness": "required"
    },
    "av_number": {
      "type": "integer",
      "description": "Per-project variation number (register)",
      "x-demiton-requiredness": "optional"
    },
    "created_at": {
      "type": "string",
      "description": "Creation timestamp (register)",
      "x-demiton-requiredness": "optional",
      "format": "date-time",
      "x-demiton-type": "datetime"
    },
    "line_items": {
      "type": "array",
      "description": "The priced lines of the advice",
      "x-demiton-requiredness": "required",
      "x-demiton-unit": "— (numbers as stated)"
    },
    "updated_at": {
      "type": "string",
      "description": "Last-update timestamp (register)",
      "x-demiton-requiredness": "optional",
      "format": "date-time",
      "x-demiton-type": "datetime"
    },
    "approved_by": {
      "type": "string",
      "description": "Name of the approver (register)",
      "x-demiton-requiredness": "optional"
    },
    "contract_no": {
      "type": "string",
      "description": "Client contract number on the advice",
      "x-demiton-requiredness": "optional"
    },
    "date_agreed": {
      "type": "string",
      "description": "Date the variation was agreed (register)",
      "x-demiton-requiredness": "optional",
      "format": "date",
      "x-demiton-type": "date"
    },
    "description": {
      "type": "string",
      "description": "Free-text variation description (register)",
      "x-demiton-requiredness": "optional"
    },
    "_source_path": {
      "type": "string",
      "description": "Source document path",
      "x-demiton-requiredness": "required"
    },
    "bc_reference": {
      "type": "string",
      "description": "Reference returned when the variation is pushed to the external system",
      "x-demiton-requiredness": "optional"
    },
    "document_ref": {
      "type": "string",
      "description": "Document reference (register)",
      "x-demiton-requiredness": "optional"
    },
    "amount_ex_gst": {
      "type": "number",
      "description": "Total ex-GST amount of the variation",
      "x-demiton-requiredness": "optional"
    },
    "pricing_basis": {
      "type": "string",
      "description": "Which price option carried the amount",
      "x-demiton-requiredness": "optional"
    },
    "_source_web_url": {
      "type": "string",
      "description": "Source web URL for the interactive AI-Search path",
      "x-demiton-requiredness": "optional"
    },
    "submission_date": {
      "type": "string",
      "description": "Date the advice was submitted to the client, as printed on the form; the day its notice window runs from",
      "x-demiton-requiredness": "optional",
      "format": "date",
      "x-demiton-type": "date"
    },
    "time_impact_days": {
      "type": "number",
      "description": "Day count the variation requires",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "days"
    },
    "_source_file_name": {
      "type": "string",
      "description": "Source document filename",
      "x-demiton-requiredness": "required"
    },
    "acceptance_status": {
      "type": "string",
      "description": "Whether the client accepted the advice",
      "x-demiton-requiredness": "required"
    },
    "created_by_user_id": {
      "type": "integer",
      "description": "Identity of the creating user (register)",
      "x-demiton-requiredness": "optional"
    }
  },
  "x-demiton-register-type": "variations",
  "x-demiton-contract-version": "1.2.1",
  "x-demiton-store": "tenant",
  "x-demiton-axes": [],
  "x-demiton-measures": [],
  "x-demiton-provenance": {
    "standards": [
      {
        "code": "AS 2124-1992",
        "title": "General Conditions of Contract (superseded)",
        "access": "paywalled_secondary",
        "clause": "Annexure Part A",
        "region": "Australia",
        "edition": "1992",
        "checked_on": "2026-09-14"
      },
      {
        "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": "cl 20 (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": "AU SoP Acts",
        "title": "Australian state and territory Security of Payment Acts (NSW 1999, QLD 2017, VIC 2002, WA 2021, SA 2009, TAS 2009, ACT 2009, NT 2004)",
        "access": "public_summary",
        "region": "Australia",
        "edition": "various",
        "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": "s 4(1) (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",
        "region": "Australia",
        "edition": "2021",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Directive 2014/24/EU",
        "title": "Directive 2014/24/EU on public procurement",
        "access": "full_text_verified",
        "clause": "Art. 72",
        "region": "European Union",
        "edition": "consolidated",
        "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": "s 11",
        "region": "New Zealand",
        "edition": "as at 5 Oct 2023",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Procurement Act 2023",
        "title": "Procurement Act 2023 (c. 54) and Procurement Regulations 2024 (SI 2024/692)",
        "access": "full_text_verified",
        "clause": "ss. 74-75",
        "region": "United Kingdom",
        "edition": "in force 24 Feb 2025",
        "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"
      },
      {
        "code": "FAR subpart 4.6",
        "title": "FAR subpart 4.6 Contract Reporting (FPDS contract action reports)",
        "access": "full_text_verified",
        "clause": "4.606",
        "region": "United States",
        "edition": "FAC 2026-01 (eff. 2026-03-13)",
        "checked_on": "2026-09-14"
      }
    ]
  },
  "description": "Approved contract variations: scope change, value and approval status.",
  "x-demiton-contract-url": "https://docs.demiton.io/registers/variations/",
  "x-demiton-register-catalog": "https://docs.demiton.io/concepts/register-catalog"
}