Job progress

Job progress from your ERP: percent complete and percent invoiced.

Part of Projects in the register catalog.

Register ID

job_progressUse 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

v1Current version.

Download JSON SchemaSee an example record

Standards

This register holds records these standards and laws ask for. Holding them does not by itself certify compliance.

• AS 4000General conditions of contractAustralia · Clause 37.2

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
• PayappsPartial
• Xero Accounting

Fields

11 fields: 5 required, 5 optional, 1 defined by each organisation.

Required

Every record carries these fields.

project_idText

The project (BC job) the KPIs belong to; the fact's subject anchor.

Example: BWG-2025-001

job_noText

The external BC job number, kept as the reconciliation key back to the ERP.

Example: BWG-2025-001

source_systemText

Which bound ERP the KPIs were read from.

Example: D365_BUSINESS_CENTRAL

percent_completedNumberUnit: %

WIP / cost-recognition completion for the job, clamped to [0, 105], null when the BC WIP calc is invalid.

Example: 56.8

percent_invoicedNumberUnit: %

The share of the job claimed/invoiced to date, clamped [0, 105]

Example: 52

Optional

Present when the source system records them.

percent_overdue_planning_linesNumberUnit: %

Planning-line slippage signal on the job.

job_statusText

BC's own job status text, passed through verbatim.

Example: Open

job_start_dateDateYYYY-MM-DD

BC's planned job start.

job_end_dateDateYYYY-MM-DD

BC's planned job end.

suspectGroup of fields

The raw rejected value(s) and the reason, present only when a percentage fell outside [0, 105]

Defined by each organisation

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

project_managerText

The job's responsible person.

Example: Brett Hollis

Example record

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

job_progress.example.json

{
  "job_no": "BWG-2025-001",
  "job_status": "Open",
  "percent_completed": 56.8,
  "percent_invoiced": 52,
  "project_id": "BWG-2025-001",
  "project_manager": "Brett Hollis",
  "source_system": "D365_BUSINESS_CENTRAL"
}

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

Show the full JSON Schema

Loading the schema…