{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://docs.demiton.io/registers/plant_fuel_usage/v2.json",
  "title": "plant_fuel_usage contract v2",
  "type": "object",
  "required": [
    "claim_amount",
    "currency",
    "external_id",
    "item",
    "litres",
    "occurred_at",
    "project"
  ],
  "properties": {
    "item": {
      "type": "string",
      "description": "`heavy_vehicle`)",
      "x-demiton-requiredness": "required",
      "x-demiton-unit": "`light_vehicle` \\"
    },
    "rego": {
      "type": "string",
      "description": "vehicle registration for LV/HV rows",
      "x-demiton-requiredness": "optional"
    },
    "asset": {
      "type": "string",
      "description": "the plant/vehicle the fuel belongs to",
      "x-demiton-requiredness": "optional",
      "x-demiton-reference": true
    },
    "hours": {
      "type": "number",
      "description": "machine hours the fuel is attributed to",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "hours",
      "x-demiton-type": "decimal"
    },
    "litres": {
      "type": "number",
      "description": "fuel volume consumed/purchased",
      "x-demiton-requiredness": "required",
      "x-demiton-unit": "litres",
      "x-demiton-type": "decimal"
    },
    "project": {
      "type": "string",
      "description": "the project the fuel was consumed on",
      "x-demiton-requiredness": "required",
      "x-demiton-reference": true
    },
    "currency": {
      "type": "currency",
      "description": "the currency of every amount on this record (`claim_amount`), an ISO 4217 alpha-3 code as the source states it. A record with no currency has no usable amount.",
      "x-demiton-requiredness": "required"
    },
    "tax_basis": {
      "type": "string",
      "description": "Whether `claim_amount` includes GST or VAT. Without it a fuel price cannot be compared with a published terminal gate price, which states its own basis.",
      "enum": [
        "excl_gst",
        "incl_gst"
      ],
      "x-demiton-requiredness": "optional"
    },
    "alloc_days": {
      "type": "number",
      "description": "allocation days attributed to a light-vehicle row",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "days"
    },
    "asset_label": {
      "type": "string",
      "description": "the Assignar display label for a plant asset (or its split sub-label)",
      "x-demiton-requiredness": "optional"
    },
    "driver_name": {
      "type": "string",
      "description": "the person who purchased the fuel on an LV/HV row",
      "x-demiton-requiredness": "optional"
    },
    "external_id": {
      "type": "string",
      "description": "deterministic per-row identity the producer builds from project + item + key + period",
      "x-demiton-requiredness": "required"
    },
    "occurred_at": {
      "type": "string",
      "description": "the usage date (month start for plant, transaction date for LV/HV)",
      "x-demiton-requiredness": "required",
      "x-demiton-unit": "day",
      "format": "date",
      "x-demiton-type": "date"
    },
    "claim_amount": {
      "type": "number",
      "description": "the final computed claim figure = litres × the claim month's price variance, never re-derived downstream",
      "x-demiton-requiredness": "required",
      "x-demiton-type": "decimal"
    },
    "hours_source": {
      "type": "string",
      "description": "empty)",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "`inferred` \\"
    },
    "burn_rate_lph": {
      "type": "number",
      "description": "derived litres per machine hour",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "L/h",
      "x-demiton-type": "decimal"
    },
    "km_from_project": {
      "type": "number",
      "description": "distance from the project for a heavy-vehicle transaction, from Navman GPS",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "km"
    },
    "financial_period": {
      "type": "string",
      "description": "the claim month (`YYYY-MM`) the usage is attributed to",
      "x-demiton-requiredness": "optional",
      "x-demiton-reference": true
    },
    "attribution_method": {
      "type": "string",
      "description": "`navman_gps`)",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "`allocation_name` \\"
    }
  },
  "x-demiton-register-type": "plant_fuel_usage",
  "x-demiton-contract-version": "2.1.0",
  "x-demiton-store": "tenant",
  "x-demiton-axes": [
    {
      "axis": "asset",
      "requirement": "optional",
      "role": "subject"
    },
    {
      "axis": "project",
      "requirement": "required",
      "role": "subject"
    },
    {
      "axis": "financial_period",
      "requirement": "optional",
      "role": "context"
    }
  ],
  "x-demiton-measures": [
    {
      "key": "burn_rate_lph",
      "accumulation": "instantaneous",
      "dtype": "float",
      "unit": "L/h"
    },
    {
      "key": "claim_amount_aud",
      "accumulation": "additive",
      "dtype": "decimal",
      "unit": "AUD"
    },
    {
      "key": "hours",
      "accumulation": "additive",
      "dtype": "decimal",
      "unit": "hours"
    },
    {
      "key": "litres",
      "accumulation": "additive",
      "dtype": "float",
      "unit": "litres"
    }
  ],
  "x-demiton-provenance": {
    "standards": [
      {
        "code": "ATO business record-keeping rules",
        "title": "ATO record-keeping for business (general 5-year retention; longer for depreciating assets)",
        "access": "public_summary",
        "region": "Australia",
        "edition": "page updated 2025-08-01",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Corporations Act 2001 (Cth) s 286",
        "title": "Corporations Act 2001 - obligation to keep financial records (7 years)",
        "access": "full_text_verified",
        "clause": "s 286(2)",
        "region": "Australia",
        "edition": "current",
        "checked_on": "2026-09-14"
      },
      {
        "code": "ISO 55001",
        "title": "Asset management - Asset management system - Requirements",
        "access": "paywalled_secondary",
        "region": "International",
        "edition": "2024 (AS ISO 55001:2024 identical AU adoption)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "ISO/TS 15143-3",
        "title": "Earth-moving machinery and mobile road construction machinery - Worksite data exchange - Telematics data (AEMP 2.0)",
        "access": "paywalled_secondary",
        "region": "International",
        "edition": "2020 (SA TS ISO 15143.3:2021 AU and PD ISO/TS 15143-3:2020 UK identical adoptions)",
        "checked_on": "2026-09-14"
      }
    ]
  },
  "description": "Plant and vehicle fuel usage per project, for fuel tax credit claims.",
  "x-demiton-contract-url": "https://docs.demiton.io/registers/plant_fuel_usage/",
  "x-demiton-register-catalog": "https://docs.demiton.io/concepts/register-catalog"
}