CARBONFACTOR: Carbon Factor
A reference record for a carbon emission factor, sourced from DESNZ or equivalent. One record per material, fuel, equipment, or disposal type per effective year.
Default definition. This article describes the default
CARBONFACTOR 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 CARBONFACTOR.Entity properties
| Property | Value |
|---|---|
| Entity code | CARBONFACTOR |
| Display name | Carbon Factor |
| Plural | Carbon Factors |
| Level | 72000 |
Use cases
Admin-maintained reference data. The category field separates materials (Scope 3 embodied), plant/fuel (Scope 1 direct), energy (Scope 2 grid), and waste disposal (Scope 3). The unit and kgCO2e fields together define the conversion factor. The effectiveYear allows side-by-side storage of different annual factor sets. WEEE classification and recyclability rating support waste and circular economy reporting. Used by PJMATERIAL, PJPLANT, PJWASTE, and CARBONPROFILELINE via objectLookup.
Fields
General: Factor Details
| Field | Type | Required | Notes |
|---|---|---|---|
name | text | Yes | Name. Placeholder: e.g. Ductile iron pipe, Diesel, Grid electricity, Concrete disposal. |
description | text (multi-line) | Description. | |
category | enum | Yes | Category. Valid ids: material (Material), plant (Plant / fuel), energy (Energy), waste (Waste disposal), transport (Transport), equipment (Equipment (daily use)). |
scope | enum | Yes | Emission scope. Valid ids: 1 (Scope 1 (Direct)), 2 (Scope 2 (Energy)), 3 (Scope 3 (Indirect)). |
General: Conversion Factor
| Field | Type | Required | Notes |
|---|---|---|---|
unit | text | Yes | Unit. Placeholder: e.g. kg, m, tonne, litre, kWh, day. |
kgCO2e | number | Yes | kgCO2e per unit. |
effectiveYear | number | Yes | Effective year. Placeholder: e.g. 2025. |
source | enum | Source. Valid ids: desnz (DESNZ (UK Gov)), defra (DEFRA), ipcc (IPCC), manufacturer (Manufacturer data), custom (Custom / estimated). |
General: Waste & Recyclability
| Field | Type | Required | Notes |
|---|---|---|---|
weeeCategory | text | WEEE category. Placeholder: e.g. Cat 1 - Large household, Cat 3 - IT & telecom. | |
recyclabilityPct | number | GRI-aligned recyclability percentage by weight | |
griReference | text | GRI reference. Placeholder: e.g. GRI 306-4. |
Relationships
- No declared relationships in the default definition.
Creating a Carbon Factor via the API
POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json
{
"entity": "CARBONFACTOR",
"level": 72000,
"comboKey": "SUB:<your-sub-id>|ENT:",
"name": "Name",
"category": "material",
"scope": "1",
"description": "Description"
}Listing Carbon Factors records
GET /v1/entities/CARBONFACTOR/SUB