Cost element

Posted job cost lines from your ERP job ledger.

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

v1Current version.

Download JSON SchemaSee an example record

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.

projectText

The job/project the cost was posted against.

Example: BWG-2025-001

financial_periodText

The month the posting belongs to.

Example: 2026-07

currencyCurrency codeISO 4217, e.g. AUD

Denomination of every amount on the row.

Example: AUD

occurred_atDateYYYY-MM-DD

Posting date of the ledger entry.

Example: 2026-07-14

entry_noNumber

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

Example: 458213

amountDecimal numberUnit: by coordinate (currency)

Posted cost for the line (Total_Cost_LCY)

Example: 24580.55

Optional

Present when the source system records them.

cost_codeText

The job task the cost was coded to (Job_Task_No)

Example: T20

work_activityText

Level-1 canonical work activity.

Example: Structural Concrete

legal_entityText

The BC company the posting belongs to.

Example: Bridgeworks Group Pty Ltd

cost_typeText

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

Example: MATERIALS

source_codeText

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

Example: PURCH

quantityDecimal number

Posted quantity (Quantity_Base)

Example: 120

unit_costDecimal numberUnit: by coordinate

Posted unit cost (Unit_Cost_LCY)

Example: 204.84

price_amountDecimal numberUnit: by coordinate

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

dimension_set_idNumber

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

document_noText

The source document reference.

Example: PINV-100234

vendorText

Supplier, where the source carries one.

Example: Statewide Concrete Supplies

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"
}

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…