13.3.22. session_cost¶
Types to provide the session price
SessionCostChunk:object
A chunk of the session cost. The total cost of the session is the sum of all chunks.
properties:
timestamp_from:string <required>
Absolute timestamp for the start of this chunk in RFC3339 UTC format
format:date-time
timestamp_to:string <required>
Absolute timestamp for the end of this chunk in RFC3339 UTC format
format:date-time
cost:object <required> (money-MoneyAmount)
Cost of the energy (or other things like time, base price, …) consumed during this chunk in the currency specified in the session price
There is an extended definition for this object here.
category:string <required>
Cost category. Typically this is energy or time.
enum:
- Energy
- Time
- Other
SessionStatus:string
Session status enum. Session can be running or finished. Costs of the running session are not final and can change.
enum:
- Running
- Finished
SessionCost:object
Session cost object containing the total cost of the session and a list of chunks
properties:
id_tag:object <required> (authorization-ProvidedIdToken)
The id tag assigned to this transaction
There is an extended definition for this object here.
currency:object <required> (money-Currency)
Currency of the session cost. It applies to all chunks.
There is an extended definition for this object here.
cost_chunks:array <optional>
List of cost chunks. The total cost of the session is the sum of all chunks.
array_item:object (session_cost-SessionCostChunk)
status:object <required> (session_cost-SessionStatus)
Session status. Session can be running or finished. Costs of the running session are not final and can change. Only after the session is finished, the session cost can be committed to bank and/or backend.
There is an extended definition for this object here.