Employee hr records
Employee hr records is one of Demiton's published registers for Australian civil construction. HR record events for a worker: leave, disciplinary action, personnel file changes. 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 Workforce in the register catalog.
- Register ID
employee_hr_recordsUse 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)
- ATO tax file number declarationTax file number and withholding declarations - kept with employee records
- Fair Work Act 2009Fair Work Act 2009 - employee records and National Employment Standards
- Fair Work Act 2009Fair Work Regulations 2009 - employee record content
- Privacy Act 1988Privacy Act 1988 - Australian Privacy Principles; employee-records exemption; health information s.6FA
- Single Touch PayrollSingle Touch Payroll Phase 2 employer reporting guidelines
- GDPRGeneral Data Protection Regulation
- ISO 30414Human resource management - Requirements and recommendations for human capital reporting and disclosure
- Employment Leave Act 2026 (NZ)Employment Leave Act 2026 (2026 No 48)
- Holidays Act 2003 (NZ)Holidays Act 2003 (2003 No 129) - holiday and leave record
- Privacy Act 2020 (NZ)Privacy Act 2020 and Health Information Privacy Code 2020
- SI 1998/1833Working Time Regulations 1998
- UK GDPRUK GDPR and Data Protection Act 2018
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.
- MYOB Acumatica
- SitematePartial
- Xero Payroll AU
Fields
26 fields: 6 required, 19 optional, 1 defined by each organisation.
Required
Every record carries these fields.
- workerNumber
The employee the record is about; the required subject anchor.
Example:
5501- start_dateDate
The date the employment started; the accrual and retention start point.
Example:
2023-02-06- external_idText
Stable identity of the source record (Assignar form-result id, cast to text).
Example:
ASGN-FR-33021- family_nameText
The employee's surname as recorded on the HR record.
Example:
Patel- occurred_atDate and time
When the source record was submitted/modified; the event time and the retention clock start.
Example:
2026-06-05T08:00:00- employment_basisText
Whether the engagement is full-time, part-time or casual.
Example:
full_time
Optional
Present when the source system records them.
- reviewGroup of fields
A performance-review outcome where the record is a review rather than an onboarding form.
- job_titleText
The employee's role title.
Example:
Site Supervisor- given_namesText
The employee's given name(s), kept separate for cross-system name matching.
Example:
Aaron- bank_accountGroup of fields
The employee's pay destination.
- contact_emailText
Work or personal email for the employee.
Example:
aaron.patel@example.com- contact_phoneText
Contact phone number(s).
Example:
0400 000 101- date_of_birthDate
The employee's date of birth.
- leave_balanceGroup of fields
The running leave balance the record must show.
- engagement_typeText
Whether the engagement is permanent, temporary or otherwise.
Example:
permanent- financial_periodDate
The accounting period the record falls in, derived from
occurred_at.Example:
2026-06-01- termination_dateDate
The date employment ended, for a former employee.
- emergency_contactGroup of fields
Emergency contact name, relationship and number.
- termination_reasonText
The manner in which employment ended.
- residential_addressText
The employee's home address.
- superannuation_fundGroup of fields
The nominated superannuation fund and the member identifier.
- hours_worked_per_dayList
Hours worked each day in a pay period.
- working_time_opt_outGroup of fields
The 48-hour opt-out agreement the employer must record for a UK worker.
- tax_identifier_declarationGroup of fields
Whether the employee's tax-file-number declaration is held with the record.
- superannuation_contributionGroup of fields
Contributions made for the employee in the period.
Defined by each organisation
Their contents come from the organisation's own forms or systems, so they differ between organisations.
- attributesGroup of fields
Every remaining form answer, keyed by the tenant's own question text.
Filed against
Records are indexed along these dimensions, so they can be asked for by any of them.
- Workerwhat the record is about, from
Always set - Financial periodcontext for the record, 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.
{ "contact_email": "aaron.patel@example.com", "contact_phone": "0400 000 101", "employment_basis": "full_time", "engagement_type": "permanent", "external_id": "ASGN-FR-33021", "family_name": "Patel", "financial_period": "2026-06-01", "given_names": "Aaron", "job_title": "Site Supervisor", "occurred_at": "2026-06-05T08:00:00", "source_system": "ASSIGNAR", "start_date": "2023-02-06", "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/employee_hr_records/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.