Change event
The early warning of a potential change, before it is priced as a variation.
Part of Contracts in the register catalog.
- Register ID
change_eventUse this name to ask for the register. The API calls it a shelf ID.- Each record is
- An eventSomething that happened at a point in time.
- Status
- PlannedDefined ahead of the connector that will fill it.
- Data
- OrganisationPrivate to each organisation's own workspace.
- Version
- v1Current version.
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.
None planned yet.
Fields
21 fields: 5 required, 16 optional.
Required
Every record carries these fields.
- external_idText
The source system's own change event id.
Example:
var-2026-0022- source_systemText
Which bound system emitted the row.
Example:
D365_BUSINESS_CENTRAL- projectText
The project the change event is on.
Example:
BWG-2025-002- titleText
What the potential change is.
Example:
Extend rock armour toe beyond original alignment- statusText
Where the event is in its lifecycle.
Example:
pending
Optional
Present when the source system records them.
- numberText
The change event number.
Example:
VAR-002- descriptionText
What happened.
Example:
Extend rock armour placement 40m further north than the t…- scopeText
Whether the change is in or out of the contract scope.
Example:
Moore Park Beach Coastal Protection - rock armour toe ext…- change_typeText
The kind of change.
Example:
variation- change_reasonText
Why the change arose.
Example:
Erosion beyond original survey extent identified during e…- originText
What raised the event, e.g. an RFI or an instruction.
Example:
site_instruction- raised_atDate and time
When the event was raised.
Example:
2026-07-09T09:15:00+10:00- raised_byText
Who raised the event.
Example:
Mia Okafor- cost_impactMoney amount
The estimated effect on cost.
Example:
28000- budget_impactMoney amount
The estimated effect on budget.
Example:
28000- revenue_impactMoney amount
The estimated effect on revenue.
Example:
28000- requested_daysWhole number
The programme extension sought.
Example:
4- accepted_daysWhole number
The programme extension accepted.
Example:
0- currencyText
The currency of the impact amounts.
Example:
AUD- prime_contractText
The head contract the event is estimated against.
Example:
TEN/2963- change_itemsList
The event's itemised cost, budget and revenue lines.
Example record
A sample from Bridgeworks Group, Demiton's demonstration company. The values are illustrative; the shape is exactly what the contract describes.
{ "accepted_days": 0, "budget_impact": 28000, "change_items": [ "Rock armour supply", "Additional cartage" ], "change_reason": "Erosion beyond original survey extent identified during earthworks", "change_type": "variation", "cost_impact": 28000, "currency": "AUD", "description": "Extend rock armour placement 40m further north than the tendered alignment to protect the exposed dune toe.", "external_id": "var-2026-0022", "number": "VAR-002", "origin": "site_instruction", "prime_contract": "TEN/2963", "project": "BWG-2025-002", "raised_at": "2026-07-09T09:15:00+10:00", "raised_by": "Mia Okafor", "requested_days": 4, "revenue_impact": 28000, "scope": "Moore Park Beach Coastal Protection - rock armour toe extension", "source_system": "D365_BUSINESS_CENTRAL", "status": "pending", "title": "Extend rock armour toe beyond original alignment"}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/change_event/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 keep current from them, on your data, in a 30-minute call.