EnergyTrade
> ⚠️ Deprecated — EnergyTrade is superseded by `P2PTrade`. Use P2PTrade for all new energy contract implementations on the DEG network.
> Canonical IRI: `https://schema.nfh.global/EnergyTrade` > Tags: energy, p2p, trade, contract, prosumer, deg, beckn > Namespace: https://schema.nfh.global/ > Part of the DEG Schema
---
P2P energy trade contract — a subclass of `Contract` specialised for energy delivery between prosumers on a Digital Energy Grid (DEG) network. Represents the complete traded energy contract including offer terms, resource attributes, delivery tracking, and customer details.
> Migration: Replace EnergyTrade references with `P2PTrade` and `EnergyContract`. Domain-specific attributes (offer, delivery, resource, customer) remain available via the companion schemas listed below.
Related domain schemas (split from the combined energy trade specification):
| Schema | Beckn Attachment Point | Description |
|---|---|---|
| `EnergyTradeOffer` | Offer.offerAttributes | Pricing model, validity/delivery windows, and optional gift parameters |
| `EnergyGift` | EnergyTradeOffer.gift | Gift energy — lookupHash, claim verifier, expiration |
| `EnergyTradeOrder` | Order.orderAttributes | Platform and utility identifiers for the trade order |
| `EnergyTradeDelivery` | orderItemAttributes.fulfillmentAttributes | Real-time delivery tracking — status, meter readings, quantities |
| `EnergyResource` | Item.itemAttributes | Energy source characteristics (solar, wind, grid, etc.) |
| `EnergyCustomer` | Buyer.buyerAttributes, Provider.providerAttributes | Customer info: meterId, sanctionedLoad, utilityCustomerId |
| `EnergyOrderItem` | orderItemAttributes | Order item wrapper combining resource, offer, and delivery |
Versions
| Version | attributes.yaml | context.jsonld | vocab.jsonld | README | Status |
|---|---|---|---|---|---|
| v0.3 | attributes.yaml | context.jsonld | vocab.jsonld | README | ⚠️ Deprecated |
| v2.0 | attributes.yaml | context.jsonld | vocab.jsonld | README | ⚠️ Deprecated · owl:equivalentClass deg:P2PTrade |
Properties (latest: v2.0)
| Property | Type | Required | Description |
|---|---|---|---|
energyResource | EnergyResource | — | Energy source characteristics for this trade. |
delivery | EnergyTradeDelivery | — | Delivery tracking attributes for this energy trade. |
offer | EnergyTradeOffer | — | Energy trade offer attributes (pricing model, windows). |
customer | EnergyCustomer | — | Energy customer attributes (meter, utility, load). |
Inherits all properties from [`Contract`](https://schema.nfh.global/Contract/v2.0) including `id`, `displayId`, `items`, `status`, `contractValue`, `participants`, `entitlements`, and `fulfillments`.
Linked Data
| Resource | URL |
|---|---|
| Canonical IRI | https://schema.nfh.global/EnergyTrade |
| JSON Schema (latest) | https://schema.nfh.global/EnergyTrade/v2.0 |
| context.jsonld (latest) | https://schema.nfh.global/EnergyTrade/v2.0/context.jsonld |
| vocab.jsonld (latest) | https://schema.nfh.global/EnergyTrade/v2.0/vocab.jsonld |
| Root context.jsonld | https://schema.nfh.global/context.jsonld |
| Root vocab.jsonld | https://schema.nfh.global/vocab.jsonld |