Allocation
Allocation is one of Demiton's published registers for Australian civil construction. Who and what is rostered on which job, and when. 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 Assets in the register catalog.
- Register ID
allocationUse 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
- AvailableFilled today from connected systems, uploads or public data.
- Data
- OrganisationPrivate to each organisation's own workspace.
- Version
- v1 (1.0.3)Current version.
Standards
This register's contract was designed against these standards and laws. Holding these records does not by itself certify compliance.
- ISO 45001Occupational health and safety management systems - Requirements with guidance for use (AU/NZ adoption)
- Fair Work Act 2009Fair Work Act 2009 - employee records and National Employment Standards
- Fair Work Act 2009Fair Work Regulations 2009 - employee record content
- ISO 30414Human resource management - Requirements and recommendations for human capital reporting and disclosure
- Holidays Act 2003 (NZ)Holidays Act 2003 (2003 No 129) - holiday and leave record
- SI 1998/1833Working Time Regulations 1998
Connectors
On the roadmap
Systems in the planned connector rollout that can fill this register. Partial means the system holds only some of its fields.
- GeotabPartial
- HammerTechPartial
- MapTrackPartial
- MYOB Acumatica
- Procore
Fields
14 fields: 5 required, 8 optional, 1 defined by each organisation.
Required
Every record carries these fields.
- hoursDecimal number
Hours allocated (the shelf's only measure)
Example:
9.5- projectText
The project/job the worker or asset is allocated to.
Example:
BWG-2025-001- external_idText
The source row's own identifier (
id)Example:
ASGN-ALLOC-771201- occurred_atDate
The resource date the allocation is for.
Example:
2026-06-15- financial_periodText
The period the allocation is attributed to.
Example:
2026-06
Optional
Present when the source system records them.
- assetText
The plant/equipment the allocation places.
Example:
9301- statusGroup of fields
The allocation's state.
- workerText
The person the allocation places.
Example:
5501- ends_atDate and time
Planned end of the assignment.
Example:
2026-06-15T16:00:00+10:00- cost_codeText
Cost code / work activity the hours are coded to.
Example:
EARTHWORKS- starts_atDate and time
Planned start of the assignment.
Example:
2026-06-15T06:30:00+10:00- checked_in_atDate and time
Actual check-in on the allocated shift.
Example:
2026-06-15T06:28:00+10:00- checked_out_atDate and time
Actual check-out from the allocated shift.
Example:
2026-06-15T16:05:00+10:00
Defined by each organisation
Their contents come from the organisation's own forms or systems, so they differ between organisations.
- legal_entityText
The employing/owning legal entity.
Example:
Bridgeworks Group Pty Ltd
Filed against
Records are indexed along these dimensions, so they can be asked for by any of them.
- Cost codecontext for the record, from
When known - Workerwhat the record is about, from
When known - Projectwhat the record is about, from
Always set - Legal entitycontext for the record, from
When known - Financial periodcontext for the record, from
Always set - Assetwhat the record is about, from
When known
Example record
A sample from Bridgeworks Group, Demiton's demonstration company. The values are illustrative; the shape is exactly what the contract describes.
{ "asset": "9301", "checked_in_at": "2026-06-15T06:28:00+10:00", "checked_out_at": "2026-06-15T16:05:00+10:00", "cost_code": "EARTHWORKS", "ends_at": "2026-06-15T16:00:00+10:00", "external_id": "ASGN-ALLOC-771201", "financial_period": "2026-06", "hours": 9.5, "legal_entity": "Bridgeworks Group Pty Ltd", "occurred_at": "2026-06-15", "project": "BWG-2025-001", "source_system": "ASSIGNAR", "starts_at": "2026-06-15T06:30:00+10:00", "worker": "5501"}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/allocation/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.