# $defs.CustomerDetails.description
PII section — fullName, installationAddress, serviceConnectionDate. fullName appears ONLY here — never in customerProfile or resource entries. Defined in CustomerDetails/v1.0.

# $defs.CustomerDetails.properties.fullName.description
Full name of the customer as per ID proof.

# $defs.CustomerDetails.properties.careOf.description
Care-of (c/o) reference person used to uniquely identify / disambiguate a customer who may share the same fullName with others in a locality (e.g. a village). Pairs a name with an optional, gender-neutral relationship.

# $defs.CustomerDetails.properties.careOf.properties.name.description
Name of the care-of / reference person used to disambiguate the customer.

# $defs.CustomerDetails.properties.careOf.properties.relationship.description
Gender-neutral relationship of the reference person to the customer.

# $defs.CustomerDetails.properties.installationAddress.description
Physical location of the metered installation. geo (GeoJSON Point, coordinates [longitude, latitude]) is required; address (schema.org PostalAddress fields) is optional.

# $defs.CustomerDetails.properties.installationAddress.x-standard
GeoJSON RFC 7946; schema.org PostalAddress; CIM (IEC 61968-1 ServiceLocation)

# $defs.CustomerDetails.properties.serviceConnectionDate.description
Date and time the service connection was activated, with timezone offset (ISO 8601).

# $defs.CustomerDetails.properties.serviceConnectionDate.x-standard
CIM (IEC 61968-1 ServiceLocation activation date)

# $defs.Location.description
A place represented by GeoJSON geometry and optional address.
Source: main/schema/core/v2/attributes.yaml#Location

# $defs.GeoJSONGeometry.description
**GeoJSON geometry** per RFC 7946. Coordinates are in **EPSG:4326 (WGS-84)** and MUST follow **[longitude, latitude, (altitude?)]** order. Supported types: - Point, LineString, Polygon - MultiPoint, MultiLineString, MultiPolygon - GeometryCollection (uses `geometries` instead of `coordinates`) Notes: - For rectangles, use a Polygon with a single linear ring where the first  and last positions are identical. - Circles are **not native** to GeoJSON. For circular searches, use  `SpatialConstraint` with `op: s_dwithin` and a Point + `distanceMeters`,  or approximate the circle as a Polygon. - Optional `bbox` is `[west, south, east, north]` in degrees.

# $defs.GeoJSONGeometry.properties.bbox.description
Optional bounding box `[west, south, east, north]` in degrees.

# $defs.GeoJSONGeometry.properties.coordinates.description
Coordinates per RFC 7946 for all types **except** GeometryCollection. Order is **[lon, lat, (alt)]**. For Polygons, this is an array of linear rings; each ring is an array of positions.

# $defs.GeoJSONGeometry.properties.geometries.description
Member geometries when `type` is **GeometryCollection**.

# $defs.Address.description
**Postal address** aligned with schema.org `PostalAddress`. Use for human-readable addresses. Geometry lives in `Location.geo` as GeoJSON.

# $defs.Address.properties.addressCountry.description
Country name or ISO-3166-1 alpha-2 code.

# $defs.Address.properties.streetAddress.description
Street address (building name/number and street).

# $defs.CustomerProfile.description
Non-PII customer identity and asset list. Supports arbitrary topologies: a single customerNumber may span multiple METER entries (different premises, sub-meters, parallel meters) each with child DERs.

# $defs.CustomerProfile.properties.energyResources.description
All physical energy assets for this account. Each entry is discriminated by 'type' into one of seven composable kinds.

# $defs.CustomerProfile.properties.consumptionProfiles.description
Tariff and load characteristics per meter connection. Each entry links to a METER via meterId.

# $defs.IdRef.description
External identity reference for the customer. Defined in IdRef/v1.0.

# $defs.EnergyResource.description
Discriminated union of all seven typed EnergyResource kinds, each inheriting id, type, subResources, parentResources, and attributes from EnergyResourceCommon/v1.1. All power/capacity fields use QuantitativeValue. Defined in EnergyResource/v2.1.

# $defs.EnergyResourceMeter.description
A metering-point energy resource. Anchors all DER sub-resources behind it in the topology tree. CIM: cim:Meter (IEC 61968-9).

# $defs.EnergyResourceMeter.allOf[].properties.type.description
Asset-class discriminator. Must be "METER". CIM cim:Meter (IEC 61968-9).

# $defs.EnergyResourceCommon.description
Structural envelope inherited by every typed EnergyResource kind via allOf. Defines top-level fields common to all kinds: id, type, topology (subResources, parentResources), and the attributes bag.

# $defs.EnergyResourceCommon.properties.id.description
Stable identifier for this resource. For METER resources the meter serial number is conventional.

# $defs.EnergyResourceCommon.properties.type.description
Asset class discriminator. Constrained to a kind-specific enum or const in each typed kind schema.

# $defs.EnergyResourceCommon.properties.subResources.description
Topology — child resources. Each item is EITHER a bare id string OR an inline EnergyResource object.

# $defs.EnergyResourceCommon.properties.parentResources.description
Upward topology — ids of parent resources.

# $defs.EnergyResourceCommon.properties.attributes.description
Attribute bag. Inherits EnergyResourceCommonAttributes via allOf plus kind-specific fields.

# $defs.EnergyResourceCommonAttributes.description
Dimensioning and provenance fields shared by all resource kinds. Inherited inside each kind's attributes bag via allOf. No field is required at this level.

# $defs.EnergyResourceCommonAttributes.properties.ratedPower.description
Manufacturer-rated peak power (nameplate value in principal direction). Kept for backward compatibility — prefer maxExport.

# $defs.EnergyResourceCommonAttributes.properties.maxExport.description
Maximum power this resource injects to the grid (generates/discharges). Always ≥0. For bidirectional resources (BESS, V2G) this is the max discharge rate. Supersedes ratedPower.

# $defs.EnergyResourceCommonAttributes.properties.maxImport.description
Maximum power this resource draws from the grid (absorbs/charges). Always ≥0. For bidirectional resources (BESS, V2G) this is the max charge rate.

# $defs.EnergyResourceCommonAttributes.properties.telemetryProvider.description
Vendor API / data source identifier for telemetry.

# $defs.EnergyResourceCommonAttributes.properties.commissioningDate.description
ISO 8601 date-time the asset was commissioned.

# $defs.EnergyResourceCommonAttributes.properties.serialNumber.description
Manufacturer-assigned device serial number from the equipment nameplate. Distinct from id (which is the network-issued DID).

# $defs.EnergyResourceCommonAttributes.properties.inspection.description
Commissioning / safety inspection record for the asset. Captured by the distribution licensee at energisation and on re-certification events.

# $defs.EnergyResourceCommonAttributes.properties.inspection.x-standard
IEEE 1547-2018 Cl. 11 (commissioning); CEA Connectivity Regs 2013 (amended 2018)

# $defs.EnergyResourceCommonAttributes.properties.inspection.properties.date.description
ISO 8601 date the inspection was performed.

# $defs.EnergyResourceCommonAttributes.properties.inspection.properties.result.description
Inspection outcome. 'conditional' indicates pass subject to remedial action.

# $defs.EnergyResourceCommonAttributes.properties.inspection.properties.inspectorId.description
Identifier of the inspector or inspecting body, as recorded by the licensee.

# $defs.EnergyResourceCommonAttributes.properties.aggregator.description
Third-party flexibility / demand-response enrolment for this asset. Present when an aggregator is authorised to dispatch or observe the resource. Controllability flag is asset-level; the asset may still be observable even when controllable is false.

# $defs.EnergyResourceCommonAttributes.properties.aggregator.properties.id.description
Aggregator identity — typically a did:web for the aggregator's domain.

# $defs.EnergyResourceCommonAttributes.properties.aggregator.properties.name.description
Human-readable aggregator name (free text).

# $defs.EnergyResourceCommonAttributes.properties.aggregator.properties.controllable.description
True if the aggregator is authorised to issue dispatch / curtailment instructions. False = observation-only.

# $defs.EnergyResourceCommonAttributes.properties.aggregator.properties.enrolledOn.description
ISO 8601 date the asset was enrolled with the aggregator.

# $defs.QVPower.description
Active-power quantity {value, unit}. unit is a QUDT power alias (W, kW, MW) expanded to a QUDT IRI via the JSON-LD context.

# $defs.EnergyResourceMeterAttributes.description
Attributes for METER resources. Common power fields (ratedPower, maxExport, maxImport, make, model, telemetryProvider, commissioningDate, location) inherited from EnergyResourceCommon/v1.1 via allOf.

# $defs.EnergyResourceMeterAttributes.allOf[].properties.meterCapability.description
Communication/automation generation. Electromechanical: induction-disc. CMRI: manual optical-port (India legacy). AMR: one-way automated read. AMI: two-way smart meter.

# $defs.EnergyResourceMeterAttributes.allOf[].properties.energyDirection.description
Energy flow direction metered at this point.

# $defs.EnergyResourceMeterAttributes.allOf[].properties.energyDirection.x-standard
CIM (FlowDirectionKind); ESPI NAESB REQ.21

# $defs.EnergyResourceMeterAttributes.allOf[].properties.feeder.description
Feeder identifier this meter is supplied from.

# $defs.EnergyResourceMeterAttributes.allOf[].properties.bus.description
Busbar identifier at the meter's connection point.

# $defs.EnergyResourceMeterAttributes.allOf[].properties.applicationProtocol.description
Application-layer protocol for meter data. DLMS_COSEM: IEC 62056, mandatory for India AMI per BIS IS 16444. ANSI_C12_18: North American. Orthogonal to communicationTechnology (physical layer).

# $defs.EnergyResourceGenerator.description
A generation DER energy resource (SOLAR_PV, WIND, HYDRO, BIOGAS, CHP, FUEL_CELL). CIM: GeneratingUnit subtypes (IEC 61970-301).

# $defs.EnergyResourceGenerator.allOf[].properties.type.description
Asset-class discriminator. SOLAR is deprecated — use SOLAR_PV.

# $defs.EnergyResourceGeneratorAttributes.description
Attributes for generation DER resources. Common fields inherited from EnergyResourceCommon/v1.1 via allOf.

# $defs.EnergyResourceGeneratorAttributes.allOf[].properties.nominalPower.description
Nominal (nameplate) power output. Use when distinct from maxExport (peak).

# $defs.EnergyResourceGeneratorAttributes.allOf[].properties.efficiency.description
Conversion efficiency as a percentage (0–100). Most relevant for FUEL_CELL and CHP resources.

# $defs.EnergyResourceGeneratorAttributes.allOf[].properties.dcArrayCapacity.description
DC-side nameplate capacity of a photovoltaic array at Standard Test Conditions (industry term: "kWp"). For PV systems this is typically larger than the AC-side maxExport because of inverter clipping and DC-to-AC ratios. Relevant for SOLAR_PV resources. The unit is the standard QUDT power alias kW — the STC/peak semantic is documented here, not encoded in the unit string.

# $defs.EnergyResourceGeneratorAttributes.allOf[].properties.dcArrayCapacity.x-standard
IS 16221 (PV module qualification); IEC 61727 (PV grid interface)

# $defs.EnergyResourceStorage.description
A stationary battery energy storage resource (BESS). CIM: BatteryUnit (IEC 61970-302).

# $defs.EnergyResourceStorage.allOf[].properties.type.description
Asset-class discriminator. BATTERY is deprecated — use BESS. CIM: BatteryUnit (IEC 61970-302).

# $defs.EnergyResourceStorageAttributes.description
Attributes for BESS resources. Common fields (make, model, ratedPower, maxExport, maxImport, telemetryProvider, commissioningDate, location) are inherited from EnergyResourceCommon/v1.1 via allOf.

# $defs.EnergyResourceStorageAttributes.allOf[].properties.storageCapacity.description
Rated stored-energy capacity. Replaces storageCapacityKwh from v1.0.

# $defs.EnergyResourceStorageAttributes.allOf[].properties.stateOfHealthPct.description
Battery state-of-health as a percentage (0–100).

# $defs.EnergyResourceStorageAttributes.allOf[].properties.roundTripEfficiencyPct.description
AC-to-AC round-trip efficiency as a percentage (0–100): the fraction of energy returned to the grid relative to energy drawn during a full charge/discharge cycle. Distinct from stateOfHealthPct (cumulative life indicator) and from inverter conversion efficiency.

# $defs.QVEnergy.description
Energy quantity {value, unit}. unit is a QUDT energy alias (kWh, MWh) expanded to a QUDT IRI via the JSON-LD context.

# $defs.EnergyResourceEVCharger.description
An EV charging station (EVSE) energy resource. EV_V2G adds bidirectional Vehicle-to-Grid capability per ISO 15118-20 / OCPP 2.1 BPT. CIM: ElectricVehicleChargingStation (CIM17+).

# $defs.EnergyResourceEVCharger.allOf[].properties.type.description
Asset-class discriminator. EV_CHARGER: EVSE hardware. EV_V2G: Vehicle-to-Grid capable EVSE with ISO 15118-20 / OCPP 2.1 BPT.

# $defs.EnergyResourceEVChargerAttributes.description
Attributes for EV_CHARGER and EV_V2G resources. Common fields (make, model, ratedPower, maxExport, maxImport, telemetryProvider, commissioningDate, location) are inherited from EnergyResourceCommon/v1.1 via allOf.

# $defs.EnergyResourceEVChargerAttributes.allOf[].properties.connectorType.description
Physical connector standard. Type1: IEC 62196-2 Type 1 (J1772). Type2: IEC 62196-2 Type 2 (Mennekes). CCS1/CCS2: Combined Charging System DC fast charge. CHAdeMO: CHAdeMO DC fast charge. GB_T: GB/T 20234. NACS: SAE J3400.

# $defs.EnergyResourceEVChargerAttributes.allOf[].properties.controlProtocol.description
EVSE control and smart-charging protocol.

# $defs.EnergyResourceEVChargerAttributes.allOf[].properties.v2xProtocol.description
Vehicle-to-Grid / V2X protocol. Present only for EV_V2G resources.

# $defs.EnergyResourceInverter.description
A grid-connected power-electronics inverter energy resource. Captures IEEE 1547-2018 ride-through categories, operating mode, and reactive / frequency-support capabilities. CIM: PowerElectronicsConnection (IEC 61970-302).

# $defs.EnergyResourceInverter.allOf[].properties.type.description
Asset-class discriminator. Must be "INVERTER". CIM: PowerElectronicsConnection (IEC 61970-302).

# $defs.EnergyResourceInverterAttributes.description
Attributes for INVERTER resources. Common fields (make, model, ratedPower, maxExport, maxImport, telemetryProvider, commissioningDate, location) are inherited from EnergyResourceCommon/v1.1 via allOf.

# $defs.EnergyResourceInverterAttributes.allOf[].properties.ratedApparentPower.description
Rated apparent power. Replaces ratedApparentPowerKva from v1.0.

# $defs.EnergyResourceInverterAttributes.allOf[].properties.ratedApparentPower.x-standard
SunSpec DER Model 702 (maxVA); CIM (IEC 61970-302 PowerElectronicsConnection.ratedS)

# $defs.EnergyResourceInverterAttributes.allOf[].properties.maxReactivePower.description
Maximum reactive power injection (leading / over-excited). Replaces maxReactivePowerKvar from v1.0.

# $defs.EnergyResourceInverterAttributes.allOf[].properties.maxReactivePower.x-standard
SunSpec DER Model 702 (maxVar); CIM (IEC 61970-302 PowerElectronicsConnection.maxQ)

# $defs.EnergyResourceInverterAttributes.allOf[].properties.minReactivePower.description
Maximum reactive power absorption (lagging / under-excited). Value is typically negative. Replaces minReactivePowerKvar from v1.0.

# $defs.EnergyResourceInverterAttributes.allOf[].properties.minReactivePower.x-standard
SunSpec DER Model 702 (maxVarNeg); CIM (IEC 61970-302 PowerElectronicsConnection.minQ)

# $defs.EnergyResourceInverterAttributes.allOf[].properties.rideThroughCategory.description
Abnormal operating performance category. CategoryI: basic. CategoryII: enhanced for distribution-connected DER. CategoryIII: advanced for large/transmission-connected DER.

# $defs.EnergyResourceInverterAttributes.allOf[].properties.operatingMode.description
Inverter grid-interaction mode. GridFollowing: PLL-based sync. GridForming: own V/f reference (microgrid islanding, black-start). Standby: energised but not injecting.

# $defs.EnergyResourceInverterAttributes.allOf[].properties.voltVarEnabled.x-standard
IEEE 2030.5 (opModVoltVar); SunSpec DER Model 705

# $defs.EnergyResourceInverterAttributes.allOf[].properties.enterServiceRampTimeSec.description
Seconds to ramp from 0 to rated power after reconnection.

# $defs.QVApparentPower.description
Apparent-power quantity {value, unit}. unit is a QUDT apparent-power alias (kVA, MVA) expanded to a QUDT IRI via the JSON-LD context.

# $defs.QVReactivePower.description
Reactive-power quantity {value, unit}. unit is a QUDT reactive-power alias (kVAR, MVAR) expanded to a QUDT IRI via the JSON-LD context. value may be negative (absorption).

# $defs.EnergyResourceLoad.description
A controllable load energy resource (smart HVAC, smart water heater, or generic controllable load). CIM: EnergyConsumer / ConformLoad (IEC 61970-301).

# $defs.EnergyResourceLoad.allOf[].properties.type.description
Asset-class discriminator. CIM: EnergyConsumer / ConformLoad (IEC 61970-301).

# $defs.EnergyResourceLoadAttributes.description
Attributes for controllable load resources. Common fields (make, model, ratedPower, maxExport, maxImport, telemetryProvider, commissioningDate, location) are inherited from EnergyResourceCommon/v1.1 via allOf.

# $defs.EnergyResourceLoadAttributes.allOf[].properties.controlProtocol.description
Demand-response / control protocol supported by this load device.

# $defs.EnergyResourceLoadAttributes.allOf[].properties.loadCategory.x-standard
CIM (IEC 61970-301 ConformLoad classification)

# $defs.EnergyResourceNetwork.description
A grid-network infrastructure energy resource (distribution transformer, busbar, feeder, or microgrid). Topology containers that anchor metering points and DER resources. CIM: PowerTransformer, BusbarSection, Feeder, Substation (IEC 61970-301).

# $defs.EnergyResourceNetwork.allOf[].properties.type.description
Asset-class discriminator. DT → PowerTransformer, BUS → BusbarSection, FEEDER → Feeder (EquipmentContainer), MICROGRID → Substation / microgrid container (IEC 61970-301).

# $defs.EnergyResourceNetworkAttributes.description
Attributes for grid-network infrastructure resources. Common fields (make, model, ratedPower, maxExport, maxImport, telemetryProvider, commissioningDate, location) are inherited from EnergyResourceCommon/v1.1 via allOf.

# $defs.EnergyResourceNetworkAttributes.allOf[].properties.nominalVoltage.description
Nominal operating voltage. Replaces nominalVoltageKv from v1.0.

# $defs.EnergyResourceNetworkAttributes.allOf[].properties.zone.description
Operating zone or region identifier used by the utility.

# $defs.EnergyResourceNetworkAttributes.allOf[].properties.substationId.description
Parent substation identifier per utility records.

# $defs.EnergyResourceNetworkAttributes.allOf[].properties.feederCode.description
Feeder code per utility records. Relevant for FEEDER and DT resources.

# $defs.QVVoltage.description
Voltage quantity {value, unit}. unit is a QUDT voltage alias (V, kV) expanded to a QUDT IRI via the JSON-LD context.

# $defs.ConsumptionProfile.description
Tariff and regulatory load profile for one meter connection. meterId links to a METER entry in customerProfile.energyResources[]. Uses MeterServiceProfile/v1.1 (sanctionedLoad, contractMaxDemand as QuantitativeValue).

# $defs.ConsumptionProfile.properties.meterId.description
Matches the id of a METER entry in customerProfile.energyResources[].

# $defs.ConsumptionProfile.properties.billingCycleDay.description
Day of month on which the billing cycle resets.

# $defs.ConsumptionProfile.properties.contractMaxDemand.description
Maximum demand contracted with the utility for this connection.

# $defs.ConsumptionProfile.properties.tariffCategoryCode.description
Billing/tariff category code assigned by the utility.

# $defs.ConsumptionProfile.properties.paymentMode.description
Billing/payment modality. POSTPAID: consume now, pay later. PREPAID: pay-before-use.

# $defs.ConsumptionProfile.properties.paymentMode.x-standard
CIM (IEC 61968-9 AmiBillingReadyKind, ESPI)

# $defs.ConsumptionProfile.properties.serviceStatus.description
Lifecycle state of the service connection (the UsagePoint), not of the meter device itself. 'active' = currently energised and billable; 'suspended' = temporarily disconnected (non-payment, inspection, fault) with the contract still on record; 'closed' = permanently terminated. Distinct from the meter device's operational state.