Platform contractor stats

Per-contractor statistics rolled up from awarded contracts.

Part of Platform in the register catalog.

Register ID

platform_contractor_statsUse 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

PublicShared, from public sources such as procurement portals.

Version

v1Current version.

Download JSON Schema

Connectors

Connected today

Demiton keeps this register current from these systems now.

No system fills this register yet.

On the roadmap

Systems in the planned connector rollout that can fill this register. Partial means the system holds only some of its fields.

None planned yet.

Fields

21 fields: 12 required, 9 optional.

Required

Every record carries these fields.

contractor_abnText

The CONTRACTOR_ABN axis: the contractor identity the rollup is keyed and superseded on. A real ABN where the publisher supplied one, otherwise a minted demiton-c-<sha16> name key.

contractor_entity_idWhole number

The civil-pipeline spine identity the rollup belongs to; also the producer's in-memory aggregation key.

series_keyText

The semantic supersede identity, `platform_contractor_stats\.

window_startDateYYYY-MM-DD

First day of the rolling window the totals cover.

window_endDateYYYY-MM-DD

Last day of the window (= the run date, observed_at).

total_awarded_aud_3yrDecimal numberUnit: AUD

Sum, across the distinct contracts in the window, of each contract's latest observed award value.

value_basisText

What kind of money the measure is: awarded contract value, latest revision per contract — not a sum of award facts.

contract_count_3yrWhole number

Count of distinct contracts (by ocid, else fact id) with an award in the window.

last_win_dateDateYYYY-MM-DD

Date of the most recent award in the window.

source_datasetText

Producer identity, contractor_stats_aggregator.

source_idText

Source-native row identity, contractor:<identity>.

observed_atDate and timeISO 8601, with time zone

Run time at which the rollup was computed; drives freshness ordering.

Optional

Present when the source system records them.

abn_sourceTextUnit: provisional)

—.

tax_basisTextUnit: exclusive \

unstated)

top_agency_namesList

Up to 5 buyer names with the most awards in the window.

top_unspsc_codesListUnit: UNSPSC code

Up to 5 category codes with the most awards in the window.

revenue_bandTextUnit: small \

mid \.

states_activeListUnit: ISO 3166-2:AU subdivision

States the contractor's awards in the window belong to. Written to PlatformEntity.attributes today, not to the fact.

state_primaryTextUnit: ISO 3166-2:AU subdivision

The single most frequent state among the window's awards. Same entity/fact split as states_active.

contentText

Human-readable narrative label, e.g. "<name>: $X across N contracts (3yr)".

derived_from_fact_countWhole number

Number of award facts scanned to produce the row; provenance for the rollup.

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

Show the full JSON Schema

Loading the schema…