Variations

Approved contract variations: scope change, value and approval status.

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

v1Current version.

Download JSON SchemaSee an example record

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

26 fields: 6 required, 20 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

acceptance_statusText

Whether the client accepted the advice.

Example: accepted

line_itemsListUnit: — (numbers as stated)

The priced lines of the advice.

_source_file_nameText

Source document filename.

Example: BWG-2025-001-VA014.pdf

_source_pathText

Source document path.

Example: /Projects/BWG-2025-001/Variations/BWG-2025-001-VA014.pdf

Optional

Present when the source system records them.

amount_ex_gstNumberUnit: AUD

Total ex-GST amount of the variation.

Example: 8400

pricing_basisText

Which price option carried the amount.

Example: schedule_of_rates

subjectText

Subject line of the advice.

Example: Additional stormwater pit at Ch 220

contract_noText

Client contract number on the advice.

Example: RFT260051

clientText

Client named on the advice.

Example: Central Highlands Regional Council

time_impact_daysNumberUnit: days

Day count the variation requires.

Example: 2

summaryText

Engine-generated human summary folding the parsed keys.

Example: Variation VA-2026-014: additional stormwater pit, $8,400 …

_source_web_urlText

Source web URL for the interactive AI-Search path.

av_numberWhole number

Per-project variation number (register)

Example: 14

descriptionText

Free-text variation description (register)

Example: Install additional Class 3 stormwater pit not shown on IF…

amountNumberUnit: currency not declared

Agreed amount (register)

date_agreedDateYYYY-MM-DD

Date the variation was agreed (register)

Example: 2026-07-18

approved_byText

Name of the approver (register)

Example: T. Aldous

statusText

Register lifecycle state.

Example: approved

document_refText

Document reference (register)

Example: VA-2026-014

notesText

Free text (register)

bc_referenceText

Reference returned when the variation is pushed to the external system.

created_by_user_idWhole number

Identity of the creating user (register)

created_atDate and timeISO 8601, with time zone

Creation timestamp (register)

Example: 2026-07-10T02:00:00Z

updated_atDate and timeISO 8601, with time zone

Last-update timestamp (register)

Example: 2026-07-18T04:30:00Z

Example record

A sample from Bridgeworks Group, Demiton's demonstration company. The values are illustrative; the shape is exactly what the contract describes.

variations.example.json

{
  "_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.

Schema URL

https://docs.demiton.io/registers/variations/v1.json

Show the full JSON Schema

Loading the schema…