PJPLANT: Plant & Machinery
The PJPLANT entity represents plant or machinery usage on a project. Records equipment type, days on site, fuel consumption, and calculates Scope 1 direct emissions.
Default definition. This article describes the default
PJPLANT definition shipped with DemandFlow. Administrators can add, remove, rename, or re-type fields, change which ones are required, and alter the layout from the Definitions screen in Settings. Your tenant's current schema may differ from what is shown here. To read the current definition at any time, GET the DEFINITION object whose id matches PJPLANT.Entity properties
| Property | Value |
|---|---|
| Entity code | PJPLANT |
| Display name | Plant & Machinery |
| Plural | Plant & Machinery |
| Level | 72020 |
Use cases
Child entity of PJ via SUB|PJ comboKey. Covers excavators, HGVs, cranes, generators, and other site plant. Carbon factor links to CARBONFACTOR for the kgCO2e per day or per litre rate. HGV movements tracked separately for transport reporting.
Fields
General
| Field | Type | Required | Notes |
|---|---|---|---|
name | text | Yes | Equipment description. |
carbonFactor | reference → CARBONFACTOR | Yes | Carbon factor. |
plantType | enum | Plant type. Valid ids: excavator (Excavator), hgv (HGV / lorry), crane (Crane), generator (Generator), pump (Pump), compressor (Compressor), lgv (LGV / van), welfare (Welfare unit), other (Other). | |
fuelType | enum | Fuel type. Valid ids: diesel (Diesel), petrol (Petrol), hvo (HVO), electric (Electric), lpg (LPG). | |
daysOnSite | number | Days on site. | |
fuelLitres | number | If known. more accurate than days-based estimate. | |
hgvMovements | number | Number of vehicle trips for transport reporting. | |
hoursRun | number | Hours run. | |
carbonFactorRate | relatedProperty | Factor rate (kgCO2e/unit). | |
kgCO2e | number | Calculated from usage x carbon factor rate. Read-only. | |
scope | enum | Scope. Valid ids: 1 (Scope 1), 2 (Scope 2). |
Relationships
- Lookups:
carbonFactorpoints atCARBONFACTORrecord.
Creating a Plant & Machinery via the API
POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json
{
"entity": "PJPLANT",
"level": 72020,
"comboKey": "SUB:<your-sub-id>|ENT:",
"name": "Example",
"carbonFactor": "",
"plantType": "excavator",
"fuelType": "diesel"
} Listing PJPLANT records
# All plant & machinery in your tenant
GET /v1/entities/PJPLANT/SUB