EnergyTrade schema definitions (v0.3)
8 schema types · Source: deg-main
Offer attributes for P2P energy trading. Attached to Offer.offerAttributes to provide pricing models, availability windows, and delivery details. NOTE: Price (beckn:price) is specified on the parent Offer object, not here. The price.applicableQuantity specifies the max energy quantity for this delivery window.
Gift parameters for P2P energy gifting. Enables a prosumer (gifter) to make an energy offer available at 0 price on the catalog, discoverable by the SHA-256 hash of the recipient's phone number and claimable via a secret shared out-of-band from the gifter to the recipient.
Order attributes for P2P energy trading. Attached to Order.orderAttributes to identify BAP and BPP participants involved in a trade. NOTE: Utility IDs for inter-discom trading are captured in EnergyCustomer (buyerAttributes.utilityId and providerAttributes.utilityId).
Fulfillment attributes for energy trade deliveries. Attached to orderItemAttributes.fulfillmentAttributes to track physical transfer of energy including delivery status, meter readings, and energy allocation data. consumedEnergy = energy TO customer (imported), producedEnergy = energy FROM customer (exported to grid).
Item attributes for energy resources. Attached to Item.itemAttributes to provide energy-specific characteristics including source type and meter identifiers.
Customer attributes for energy flows. Used for consumers, producers, or prosumers in: - orderItemAttributes (init request): Contains meterId for delivery destination - orderItemAttributes (responses): Contains meterId for delivery destination - buyerAttributes (enrollment): Contains meterId and sanctionedLoad for customer identification
Order item attributes for P2P energy trading. Wraps customer information and optional fulfillment tracking data. Use this schema for beckn:orderItemAttributes in P2P energy trading flows.
⚠️ DEPRECATED — Use P2PTrade/v2.0 instead. This schema is preserved for backward compatibility. See deg:EnergyTrade owl:equivalentClass deg:P2PTrade and beckn:Order owl:equivalentClass beckn:Contract in the OWL vocabulary. JSON Schema for P2P energy trading contracts. EnergyTrade is a subclass of Contract that specialises the base beckn Contract for energy delivery between prosumers. An EnergyTrade brings together: - An energy resource (the item being traded — see EnergyResource) - An energy trade offer with pricing model and delivery window (see EnergyTradeOffer) - A trade delivery tracking meter readings and status (see EnergyTradeDelivery) - Customer identity for buyer and provider sides (see EnergyCustomer) - A contract item wrapper linking customer and delivery data (see EnergyOrderItem) - Optional gifting metadata (see EnergyGift) The seven domain schemas are defined in $defs and are also published independently at https://schema.beckn.io/<SchemaName>/v2.0.