schema.beckn.ioSearch schemas…

EnergyCustomer

Canonical term page (persistent IRI). Versioned resource URLs are listed below for easy copy/paste.

Canonical IRI

https://schema.beckn.io/EnergyCustomer

Developer URLs

EnergyCustomer

Customer attributes for energy flows — meter ID, sanctioned load, and utility account information for consumers, producers, and prosumers.

**Canonical IRI:** https://schema.beckn.io/EnergyCustomer/v2.0

**Namespace prefix:** deg:https://schema.beckn.io/deg/EnergyCustomer/v2.0/

**Tags:** energy-trade · p2p-trading · energy-enrollment · customer

---

Versions

VersionStatusNotes
v2.0CurrentInitial JSON Schema release, split from combined EnergyTrade schema
v0.3DeprecatedOriginal definition as a component in EnergyTrade/v0.3/attributes.yaml

---

Properties

PropertyTypeRequiredDescription
meterIdstringMeter ID in DER address format (der://meter/{id})
sanctionedLoadnumber (kW)Approved electrical load capacity
utilityCustomerIdstringCustomer's account number with their utility
utilityIdstringUtility/DISCOM identifier (e.g., TPDDL-DL) for inter-utility trading

---

Linked Data

TermIRI
EnergyCustomerdeg:EnergyCustomer
meterIddeg:meterId
sanctionedLoaddeg:sanctionedLoad
utilityCustomerIddeg:utilityCustomerId
utilityIddeg:utilityId

---

Usage

EnergyCustomer is used in multiple contexts:

  • **P2P Trading:** orderItemAttributes for delivery destination (init/confirm/on_status)
  • **Enrollment:** Buyer.buyerAttributes with meterId and sanctionedLoad for customer identification

For inter-utility (inter-DISCOM) P2P trades, utilityId identifies the utility serving each party.