Skip to content

EntiHub Documentation

ESG Emission Factors & Metrics

ESG — Emission Factor & ESG Metric Definition Registry

ESG reports and copilots must cite approved factors and metric definitions—not blog averages from the internet.

Why this is needed

Methodologies drift without a governed factor set.
Auditors ask which factor version was used.
AI assistants otherwise invent ESG numbers.

Proposed entities in EntiHub

Governance settings

Setting	Recommended value	Why
`approvalRequired`	`true`	Factor/methodology changes need Sustainability approval.
`historyEnabled`	`true`	History of methodology versions.
`allowSameAuthorApproval`	`false`	Maker/checker separation for sensitive changes.
`deletedRetentionDays`	`90` (or higher)	Soft-delete retention for auditability.

Entity definition (YAML sketch)

name: emission_factor
displayName: Emission factor
domain: ESG
description: Emission factor
version: "1.0.0"
approvalRequired: true
historyEnabled: true
deletedRetentionDays: 90
displayRefColumn: factor_code
uniqueConstraints:
  - name: uq_emission_factor_0
    columns: [factor_code, version]
columns:
  - name: factor_code
    dataType: string
    nullable: false
    maxLength: 64
  - name: activity
    dataType: string
    nullable: false
    maxLength: 128
  - name: unit
    dataType: string
    nullable: false
    maxLength: 32
  - name: factor_value
    dataType: decimal
    nullable: false
  - name: methodology
    dataType: string
    nullable: false
    maxLength: 128
  - name: version
    dataType: string
    nullable: false
    maxLength: 32
  - name: status
    dataType: string
    nullable: false
    maxLength: 16

YAML sketches

Sketches highlight the important fields and governance flags. Trim or extend columns to match your domain. See Setup Entity for the full YAML reference.

Sample data

factor_code	activity	unit	factor_value	methodology	version	status
EF-ELEC-SK	electricity SK grid	kgCO2e/kWh	0.15	company-approved 2026	2026.1	approved

Benefits for the company

Auditable ESG factors.
AI cites approved methodology.
Clear ownership in Sustainability.