Subcontract
The subcontract itself: the instrument, not the subcontractor or the claim.
Part of Contracts in the register catalog.
- Register ID
subcontractUse 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
- PlannedDefined ahead of the connector that will fill it.
- Data
- OrganisationPrivate to each organisation's own workspace.
- Version
- v1Current version.
Standards
This register holds records these standards and laws ask for. Holding them does not by itself certify compliance.
- AS 4000General conditions of contract
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
22 fields: 5 required, 17 optional.
Required
Every record carries these fields.
- external_idText
The source system's own subcontract id.
Example:
SC-3021- source_systemText
Which bound system emitted the row.
Example:
D365_BUSINESS_CENTRAL- projectText
The project the subcontract is let on.
Example:
BWG-2025-001- subcontractorText
The party the work is let to.
Example:
Central Highlands Traffic Control Pty Ltd- statusText
The subcontract's lifecycle state.
Example:
active
Optional
Present when the source system records them.
- numberText
The subcontract number.
Example:
SUB-1001- titleText
The subcontract's title.
Example:
Traffic control services- descriptionText
The scope of the subcontract.
Example:
Provision of traffic management and control for the Emera…- executedTrue or false
Whether the subcontract has been signed.
Example:
true- contract_sumMoney amount
The original subcontract sum.
Example:
186000- revised_contract_sumMoney amount
The sum after approved changes.
Example:
198500- approved_changesMoney amount
The value of approved change orders.
Example:
12500- pending_changesMoney amount
The value of change orders not yet approved.
Example:
0- total_paidMoney amount
What has been paid to date.
Example:
112000- remaining_balanceMoney amount
What remains unpaid.
Example:
86500- percentage_paidDecimal number
The share of the sum paid.
Example:
56.4- retention_percentDecimal number
The retention rate withheld from payments.
Example:
5- payment_termsText
The payment terms agreed.
Example:
30 days end of month- delivery_dateDate
When the subcontract works are due.
Example:
2026-11-30- actual_completion_dateDate
When the subcontract works were completed.
- currencyText
The currency of the amounts.
Example:
AUD- line_itemsList
The subcontract's itemised scope.
Example record
A sample from Bridgeworks Group, Demiton's demonstration company. The values are illustrative; the shape is exactly what the contract describes.
{ "approved_changes": 12500, "contract_sum": 186000, "currency": "AUD", "delivery_date": "2026-11-30", "description": "Provision of traffic management and control for the Emerald Street Rejuvenation works.", "executed": true, "external_id": "SC-3021", "number": "SUB-1001", "payment_terms": "30 days end of month", "pending_changes": 0, "percentage_paid": 56.4, "project": "BWG-2025-001", "remaining_balance": 86500, "retention_percent": 5, "revised_contract_sum": 198500, "source_system": "D365_BUSINESS_CENTRAL", "status": "active", "subcontractor": "Central Highlands Traffic Control Pty Ltd", "title": "Traffic control services", "total_paid": 112000}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/subcontract/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.