Pay categories

Pay categories is one of Demiton's published registers for Australian civil construction. Pay category definitions, with rates and award mappings. 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 Payroll in the register catalog.

Register ID

pay_categoriesUse 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

AvailableFilled today from connected systems, uploads or public data.

Data

OrganisationPrivate to each organisation's own workspace.

Version

v1 (1.0.3)Current version.

Download JSON SchemaSee an example record

Standards

This register's contract was designed against these standards and laws. Holding these records does not by itself certify compliance.

• A New Tax System (Goods and Services Tax) Act 1999 (Cth)GST tax invoice requirements (ATO tax invoice guidance)Australia · ATO guidance updated 25 Aug 2025 · public summary
• Fair Work Act 2009Fair Work Act 2009 - employee records and National Employment StandardsAustralia · compilation 2026-07-07 · clause ss.87(1), 96(1), 535(1) · verified against full text
• Fair Work Act 2009Fair Work Regulations 2009 - employee record contentAustralia · compilation 2026-06-20 · clause regs 3.33, 3.37, 3.44 ; regs 3.45-3.46 · verified against full text
• Payday Super (ATO)Single Touch Payroll reporting under Payday SuperAustralia · from 1 Jul 2026 · public summary
• Single Touch PayrollSingle Touch Payroll Phase 2 employer reporting guidelinesAustralia · Phase 2 (mandatory from 1 Jan 2022) · public summary
• EN 16931-1:2017Electronic invoicing - semantic data model (Peppol BIS Billing 3.0 base)European Union · 2017 (withdrawn; 2026 edition published) · paywalled, from a secondary description
• ISO 30414Human resource management - Requirements and recommendations for human capital reporting and disclosureInternational · 2nd ed. 2025 (supersedes ISO 30414:2018) · paywalled, from a secondary description
• Tax Administration Act 1994 (NZ) Schedule 4Reporting of employment income information (payday filing)New Zealand · version as at 1 Jul 2026 · clause Schedule 4 Tables 1-3 · verified against full text
• HMRC Real Time Information (RTI)PAYE Real Time Information - Full Payment Submission and Employer Payment SummaryUnited Kingdom · guidance updated 6 Apr 2026 · public summary

Connectors

Connected today

Demiton keeps this register current from these systems now.

• Employment Hero Payroll

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
• MYOB Business
• Xero AccountingPartial
• Xero Payroll AU

Fields

23 fields: 2 required, 19 optional, 2 defined by each organisation.

Required

Every record carries these fields.

statutory_income_typeText

The jurisdiction's statutory income/component type this category maps to (AU: ATO income-type list)

Example: OTE

pay_category_entity_idWhole number

Demiton canonical PAY_CATEGORY spine node this fact is about.

Example: 1

Optional

Present when the source system records them.

nameText

Human name of the pay category.

Example: Award Civil - Ordinary

rate_unitText

Unit the category's rate is denominated in.

Example: Hourly

is_primaryTrue or false

Whether this is the tenant's primary/default category.

Example: true

accrues_leaveTrue or false

Whether the category accrues leave.

Example: true

external_codeText

Stable manufacturer/award code where the source supplies one.

is_tax_exemptTrue or false

Whether the category is exempt from withholding tax.

legal_entity_idWhole number

Owning legal entity where the source is multi-company.

rounding_methodText

Rounding method applied to the category.

pay_category_typeText

The category's own type (wage / allowance / deduction / superannuation / …)

Example: hourly

default_super_rateNumberUnit: percent

Default superannuation rate applied to this category.

Example: 11.5

source_external_idNumber

The raw record id in the producing system.

rate_loading_percentNumberUnit: percent

Rate loading applied to the category.

allowance_descriptionText

Description of a separately identifiable allowance.

hide_units_on_payslipTrue or false

Whether units are hidden on the payslip for this category.

is_payroll_tax_exemptTrue or false

Whether the category is exempt from state/territory payroll tax.

is_system_pay_categoryTrue or false

Whether the category is system-supplied rather than tenant-authored.

penalty_loading_percentNumberUnit: percent

Penalty-rate loading applied to the category.

number_of_decimal_placesNumber

Rounding precision for the category.

exclude_from_qualifying_earningsTrue or false

Whether the category is excluded from super-qualifying earnings.

Defined by each organisation

Their contents come from the organisation's own forms or systems, so they differ between organisations.

parent_referenceNumber

Source id of the tenant-configured parent category.

general_ledger_mapping_codeText

Tenant GL account code the category posts to.

Example record

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

pay_categories.example.json

{
  "accrues_leave": true,
  "default_super_rate": 11.5,
  "is_primary": true,
  "name": "Award Civil - Ordinary",
  "pay_category_entity_id": 1,
  "pay_category_type": "hourly",
  "rate_unit": "Hourly",
  "source_system": "KEYPAY",
  "statutory_income_type": "OTE"
}

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/pay_categories/v1.json

Show the full JSON Schema

Loading the schema…