13.3.23. session_cost¶
Types to provide the session price
IdlePrice:object
Price components when idle
properties:
grace_minutes:integer <required>
Grace period in minutes before idle time is charged. Grace minutes start counting from the timestamp of the message in which state changed from “Charging” to “Idle”.
hour_price:object <required> (money-Price)
Price per hour while idle
There is an extended definition for this object here.
CostCategory:string
Cost category
enum:
- Energy
- Time
- FlatFee
- Other
ChargingPriceComponent:object
Charging price for a category
properties:
category:string <required> (session_cost-CostCategory)
Component type for this charging price
There is an extended definition for this object here.
price:object <required> (money-Price)
Price for this component
There is an extended definition for this object here.
NextPeriodPrice:object
Pricing for the next period
properties:
timestamp_from:string <required>
Time when these prices become active.
charging_price:array <required>
Price components while charging
array_item:object (session_cost-ChargingPriceComponent)
There is an extended definition for this object here.
idle_price:object <optional> (session_cost-IdlePrice)
Price components while idle. Optional if no idle fee charged.
There is an extended definition for this object here.
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
metervalue_from:integer <required>
Metervalue (energie Wh import) for the start of this chunk
metervalue_to:integer <required>
Metervalue (energie Wh import) for the end of this chunk
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> (session_cost-CostCategory)
Cost category. Typically this is energy, time or a flat fee.
There is an extended definition for this object here.
SessionStatus:string
Session status enum. Session can be running or finished. Costs of the running session are not final and can change.
enum:
- Running
- Idle
- Finished
SessionCost:object
Session cost object containing the total cost of the session and a list of chunks
properties:
id_tag:object <optional> (authorization-ProvidedIdToken)
The id tag assigned to this transaction
There is an extended definition for this object here.
session_id:string <required>
The session id
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)
idle_price:object <optional> (session_cost-IdlePrice)
Prices for when the EV is idle.
There is an extended definition for this object here.
charging_price:array <optional>
Charging prices.
array_item:object (session_cost-ChargingPriceComponent)
next_period:object <optional> (session_cost-NextPeriodPrice)
Charging prices for the next period, starting from the given date/time
There is an extended definition for this object here.
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.
message:array <optional>
Message to show to the user containing information about the price
array_item:object (display_message-MessageContent)
Message with pricing information in a specific language
There is an extended definition for this object here.
qr_code:string <optional>
QR Code with more information. For example when the charging is finished, to download the invoice from