Variations
Variations is one of Demiton's published registers for Australian civil construction. Approved contract variations: scope change, value and approval status. Demiton keeps it current from the systems a contractor already runs and publishes the record's shape as a versioned JSON Schema, so the same question works whichever system produced the record.
Part of Contracts in the register catalog.
- Register ID
variationsUse this name to ask for the register. The API calls it a shelf ID.- Each record is
- A stateThe current value of something, replaced when it changes.
- Status
- DeclaredDefined, and fills when a source produces its first record.
- Data
- OrganisationPrivate to each organisation's own workspace.
- Version
- v1 (1.2.1)Current version.
Standards
This register's contract was designed against these standards and laws. Holding these records does not by itself certify compliance.
- AS 2124General Conditions of Contract (superseded)
- AS 4000General Conditions of Contract (superseded edition, still in use)
- AS 4000General Conditions of Contract (construct only)
- AS 4902General Conditions of Contract for Design and Construct
- Security of paymentAustralian state and territory Security of Payment Acts (NSW 1999, QLD 2017, VIC 2002, WA 2021, SA 2009, TAS 2009, ACT 2009, NT 2004)
- Security of paymentBuilding and Construction Industry Security of Payment Act 2002 (Vic), as amended from 15 Apr 2026
- Security of paymentBuilding and Construction Industry (Security of Payment) Act 2021 (WA)
- Directive 2014/24/EUDirective 2014/24/EU on public procurement
- NZ CCA 2002Construction Contracts Act 2002 (NZ), 2002 No 46, as amended 2015 and 2023
- Procurement Act 2023Procurement Act 2023 (c. 54) and Procurement Regulations 2024 (SI 2024/692)
- AIA G702/G703Application and Certificate for Payment; Continuation Sheet
- FAR subpart 4.6FAR subpart 4.6 Contract Reporting (FPDS contract action reports)
Connectors
Connected today
Demiton keeps this register current from these systems now.
No system fills this register yet.
On the roadmap
Systems in the planned connector rollout that can fill this register. Partial means the system holds only some of its fields.
- MYOB Acumatica
- Oracle Aconex
- Payapps
- Procore
Fields
28 fields: 6 required, 22 optional.
Required
Every record carries these fields.
- pca_refText
Variation reference on the advice form; the per-advice supersede discriminator.
Example:
VA-2026-014- doc_kindText
Classification of the source artefact.
Example:
variation_advice- line_itemsList
The priced lines of the advice.
- _source_pathText
Source document path.
Example:
/Projects/BWG-2025-001/Variations/BWG-2025-001-VA014.pdf- _source_file_nameText
Source document filename.
Example:
BWG-2025-001-VA014.pdf- acceptance_statusText
Whether the client accepted the advice.
Example:
accepted
Optional
Present when the source system records them.
- notesText
Free text (register)
- amountNumber
Agreed amount (register)
- clientText
Client named on the advice.
Example:
Central Highlands Regional Council- statusText
Register lifecycle state.
Example:
approved- subjectText
Subject line of the advice.
Example:
Additional stormwater pit at Ch 220- summaryText
Engine-generated human summary folding the parsed keys.
Example:
Variation VA-2026-014: additional stormwater pit, $8,400 …- currencycurrency
The currency of every amount on this record (
amount,amount_ex_gstand each line's amount), an ISO 4217 alpha-3 code as the document states it. A record with no currency has no usable amount.- av_numberWhole number
Per-project variation number (register)
Example:
14- created_atDate and time
Creation timestamp (register)
Example:
2026-07-10T02:00:00Z- updated_atDate and time
Last-update timestamp (register)
Example:
2026-07-18T04:30:00Z- approved_byText
Name of the approver (register)
Example:
T. Aldous- contract_noText
Client contract number on the advice.
Example:
RFT260051- date_agreedDate
Date the variation was agreed (register)
Example:
2026-07-18- descriptionText
Free-text variation description (register)
Example:
Install additional Class 3 stormwater pit not shown on IF…- bc_referenceText
Reference returned when the variation is pushed to the external system.
- document_refText
Document reference (register)
Example:
VA-2026-014- amount_ex_gstNumber
Total ex-GST amount of the variation.
Example:
8400- pricing_basisText
Which price option carried the amount.
Example:
schedule_of_rates- _source_web_urlText
Source web URL for the interactive AI-Search path.
- submission_dateDate
Date the advice was submitted to the client, as printed on the form; the day its notice window runs from.
- time_impact_daysNumber
Day count the variation requires.
Example:
2- created_by_user_idWhole number
Identity of the creating user (register)
Example record
A sample from Bridgeworks Group, Demiton's demonstration company. The values are illustrative; the shape is exactly what the contract describes.
{ "_source_file_name": "BWG-2025-001-VA014.pdf", "_source_path": "/Projects/BWG-2025-001/Variations/BWG-2025-001-VA014.pdf", "acceptance_status": "accepted", "amount_ex_gst": 8400, "approved_by": "T. Aldous", "av_number": 14, "client": "Central Highlands Regional Council", "contract_no": "RFT260051", "created_at": "2026-07-10T02:00:00Z", "date_agreed": "2026-07-18", "description": "Install additional Class 3 stormwater pit not shown on IFC drawings.", "doc_kind": "variation_advice", "document_ref": "VA-2026-014", "line_items": [ { "item": "Additional stormwater pit", "qty": 1, "rate": 8400, "total": 8400 } ], "pca_ref": "VA-2026-014", "pricing_basis": "schedule_of_rates", "status": "approved", "subject": "Additional stormwater pit at Ch 220", "summary": "Variation VA-2026-014: additional stormwater pit, $8,400 ex GST, 2 days, accepted.", "time_impact_days": 2, "updated_at": "2026-07-18T04:30:00Z"}Use this contract
The contract is a standard JSON Schema (draft 2020-12) document, so any JSON Schema validator can check a record against it. Keywords starting with x-demiton- add Demiton's own meaning, such as units and requiredness, and validators ignore them.
https://docs.demiton.io/registers/variations/v1.jsonShow the full JSON Schema
Loading the schema…
Talk to the team
Tell us what you run - your ERP, field, payroll and document systems - and we will show you the registers Demiton would fill from them, on your data, in a 30-minute call.