Cost element (v1)

You are viewing version 1

This contract has been superseded. See the current version (v2).

Cost element is one of Demiton's published registers for Australian civil construction. Posted job cost lines from your ERP job ledger. 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 Financials in the register catalog.

Register ID

cost_elementUse 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.1)Superseded by v2.

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.

• ATO record-keeping rulesATO business record-keeping rules (ITAA 1936 s 262A; TAA 1953 Sch 1 s 382-5)Australia · ATO page updated 2025-08-01 · public summary
• Commonwealth Procurement RulesCommonwealth Procurement Rules (AU)Australia · effective 17 Nov 2025 · clause construction threshold defined GST-inclusive · public summary
• Corporations Act 2001 (Cth) s 286Corporations Act 2001 (Cth) - obligation to keep financial recordsAustralia · current · clause s 286(1), 286(2) (7 years) · verified against full text
• Security of paymentBuilding and Construction Industry Security of Payment Act 2009 (SA)Australia · current · clause claimed amount must state GST treatment · public summary
• OCDSOpen Contracting Data StandardInternational · 1.1 schema, docs 1.1.5 · verified against full text
• Peppol BIS Billing 3.0Peppol BIS Billing 3.0International · 3.0.21 · verified against full text
• Construction Contracts Act 2002 (NZ)Construction Contracts Act 2002 (NZ), 2002 No 46New Zealand · as at 5 Oct 2023 (incl. Retention Money Amendment Act 2023) · clause ss 20(2)(d), 21(2)(c) · verified against full text
• HGCRA 1996 Part IIHousing Grants, Construction and Regeneration Act 1996 (UK), Part IIUnited Kingdom · current · clause s 110A · verified against full text
• AIA G702/G703AIA G702-1992 Application and Certificate for Payment / G703-1992 Continuation SheetUnited States · 1992 base editions · public summary

Connectors

Connected today

Demiton keeps this register current from these systems now.

• Business Central

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
• Oracle Aconex
• Procore

Fields

17 fields: 6 required, 11 optional.

Required

Every record carries these fields.

amountDecimal numberUnit: by coordinate (currency)

Posted cost for the line (Total_Cost_LCY)

Example: 24580.55

projectText

The job/project the cost was posted against.

Example: BWG-2025-001

currencyCurrency codeISO 4217, e.g. AUD

Denomination of every amount on the row.

Example: AUD

entry_noNumber

The source's own row identity, used for episodic dedup and supersession.

Example: 458213

occurred_atDateYYYY-MM-DD

Posting date of the ledger entry.

Example: 2026-07-14

financial_periodText

The month the posting belongs to.

Example: 2026-07

Optional

Present when the source system records them.

vendorText

Supplier, where the source carries one.

Example: Statewide Concrete Supplies

quantityDecimal number

Posted quantity (Quantity_Base)

Example: 120

cost_codeText

The job task the cost was coded to (Job_Task_No)

Example: T20

cost_typeText

The raw posting-group discriminator behind the cost classification (Gen_Prod_Posting_Group)

Example: MATERIALS

unit_costDecimal numberUnit: by coordinate

Posted unit cost (Unit_Cost_LCY)

Example: 204.84

document_noText

The source document reference.

Example: PINV-100234

source_codeText

Distinguishes cost postings from SALES/claim postings on the same ledger.

Example: PURCH

legal_entityText

The BC company the posting belongs to.

Example: Bridgeworks Group Pty Ltd

price_amountDecimal numberUnit: by coordinate

The price/revenue side of a claim line (Total_Price_LCY), which the cost measure drops.

work_activityText

Level-1 canonical work activity.

Example: Structural Concrete

dimension_set_idNumber

Key into the BC dimension set that resolves EQUIPMENT for plant rate.

Example record

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

cost_element.example.json

{
  "amount": 24580.55,
  "cost_code": "T20",
  "cost_type": "MATERIALS",
  "currency": "AUD",
  "document_no": "PINV-100234",
  "entry_no": 458213,
  "financial_period": "2026-07",
  "legal_entity": "Bridgeworks Group Pty Ltd",
  "occurred_at": "2026-07-14",
  "project": "BWG-2025-001",
  "quantity": 120,
  "source_code": "PURCH",
  "unit_cost": 204.84,
  "vendor": "Statewide Concrete Supplies",
  "work_activity": "Structural Concrete"
}

Version history

• v2 (current)
• v1

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

Show the full JSON Schema

Loading the schema…