Job budget

Job budget is one of Demiton's published registers for Australian civil construction. Job budgets per project, by expense category. 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

job_budgetUse 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

v2 (2.0.1)Current 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
• MYOB BusinessPartial
• Procore
• Xero Accounting

Fields

7 fields: 5 required, 2 optional.

Required

Every record carries these fields.

currencycurrency

The currency of every amount on this record (total_budget), an ISO 4217 alpha-3 code as the source states it. A record with no currency has no usable amount.

Example: AUD

project_idText

The project the budget belongs to; the fact's subject anchor, read by Margin Watch.

Example: BWG-2025-001

total_budgetDecimal number

The budgeted amount for the project, summed over all planning lines.

Example: 2850000

legal_entity_idText

The BC company whose job planning lines the budget was read from.

Example: BWG-AU

financial_periodText

The accounting period the budget figure is the live value for.

Example: 2026-06

Optional

Present when the source system records them.

by_expense_categoryGroup of fieldsUnit: AUD per key

The same total broken down by the GL classification the planning-line accounts map to.

planning_line_countWhole numberUnit: count

Number of salary planning lines folded into the total.

Example: 14

Filed against

Records are indexed along these dimensions, so they can be asked for by any of them.

• Legal entitycontext for the record, from When known
• 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.

job_budget.example.json

{
  "by_expense_category": {
    "labour": 980000,
    "materials": 1200000,
    "plant": 670000
  },
  "currency": "AUD",
  "financial_period": "2026-06",
  "legal_entity_id": "BWG-AU",
  "planning_line_count": 14,
  "project_id": "BWG-2025-001",
  "total_budget": 2850000
}

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/job_budget/v2.json

Show the full JSON Schema

Loading the schema…