Price simulator
What is it?
The Price Simulator is a tool that enables providers to verify their tariffs by modeling different charging scenarios. It allows administrators to input specific session parameters, such as time, energy, and token details to generate a calculated cost breakdown without performing an actual charging session.
Who is it for?
This feature is designed for Provider Admins who need to manage and verify pricing logic (feature not available to end-customers).
Key Benefits
Verification: Ensure tariffs are configured and applied as intended, particularly when multiple overlapping tariffs or restrictions apply.
Cost estimation: Estimate charging costs for specific scenarios.
Troubleshooting: Verify that specific tariffs for customer groups or Access Groups are working as expected.
Transparency: View a clear breakdown of different pricing components (e.g., energy, time, idle fees) contributing to the total cost.
How It Works
Access the Price Simulator: The simulator is accessible via the Actions menu under an individual charging station. Note that the tool is only available when a tariff or charging policy is configured for that charger.
Define Parameters: The user manually sets the session inputs, such as the start time, energy consumed, and duration.
Run Simulation: The system calculates the price based on the configured tariff elements, validity periods, and restrictions.
View Results: The output displays a detailed breakdown, including:
Total cost (excluding and including VAT).
Specific tariff elements applied (Session fee, Energy, Time, Idle fee, Surcharges).
Labels indicating which rates or restrictions were applied (e.g., "Rate from 18:00-22:00").
Configuration & Settings
The Price Simulator allows for precise inputs to test various conditions.
Input Fields
Session Start DateTime: Defaults to the current date/time. You can set this to the past or future to test validity periods (only applies to charging policies).
Energy Consumed (kWh): The total energy the user is expected to consume.
Charging duration: The specific time the vehicle is actively charging. Time-based fees will apply to this period.
Idle Duration: The total time the vehicle is connected but not charging, and suspended. The Idle fee will be applied to the period (if applicable)
Token UID (optional):
Default behavior: If left blank, the simulator assumes default pricing applies.
Testing custom pricing: By entering a Token UID, you can verify if a specific tariff for a customer group or access group is executing as configured. This tests both access permissions and the applicable price.
Example Use Cases
Verifying "Time of Use" Tariffs
Scenario: A tariff has a higher rate between 18:00 and 08:00.
Action: Set the Session Start DateTime to 19:00 and run a simulation.
Result: The breakdown should clearly show the specific rate label (e.g., "Night Tariff") applied to that period.
Testing Access Group Pricing
Scenario: Employees receive a discounted rate.
Action: Enter the Token UID of an Employee and run the simulation.
Result: The simulator calculates the cost based on the specific tariff associated with that User/Token, rather than the public rate.
Simulating Multi-Day Sessions
Scenario: A car is plugged in overnight, spanning two different days.
Action: Set a long total duration that crosses midnight.
Result: The simulator splits the session and applies the correct pricing for each portion based on the day it occurs.
Limitations & Considerations
VAT Calculation: VAT is derived from the location settings; the simulator calculates Total Cost Excl. and Incl. VAT based on this logic.
Session Timeline
What is it?
The Session Timeline provides operators with a detailed breakdown of how EV charging session costs are built up. The cost breakdown uses Session Periods. A period is a representation of a timeframe within the session where a particular, uniform price applied. It further details pricing intervals right down to each individual MeterValue received from the charger.
Key Benefits
Provides deep transparency into billing and tariff management. This is especially useful for understanding how sessions were rated when dynamic or shifting pricing applied throughout a single charge.
Example of session timeline
How It Works
Provider Admins can access the Session Timeline interface through two main pathways within the platform:
From the Sessions List: Click the three-dot action menu on any specific session row and select Timeline.
From Session Details: Open a specific session and click the Timeline button located at the top right of the page.
Understanding the Timeline Data
Once opened, the modal displays granular session data separated into specific sections:
Section | Description | Data Points |
Summary | Shows a breakdown of periods, representing timeframes where a specific price applied. | Period, Pricing (Excl. VAT), Type, Energy, Start, Time, Idle, and Total Costs. |
Energy Intervals | Shows the frequency of the kWh data (MeterValues) received from the charger. | Interval duration, Pricing, Type (representing charging states), Energy (kWh), and Cumulative/Interval Costs. |
Time Intervals | Provides a breakdown of time-based billing and activity. | Time Intervals, Pricing, Type (representing charging states), Idle, Time, and Costs. |
Example Use Cases
Tariff Breakdown: If a CPO or driver has questions on the session outcome, support can use the summary to show exactly how much of the total cost came from start costs versus hourly rates or per-kWh consumption during different periods of the charge.
Dynamic Pricing Audit: When dynamic energy pricing is in effect, an operator can review exactly which price was applied at a specific point in time by looking at the detailed MeterValue intervals.
Limitations/Considerations
Data Dependency: The granularity of the energy intervals directly depends on how frequently the specific charging station hardware sends MeterValue data.
Depending on when the MeterValue data comes it a new interval starts. This also means that a new kWh price (e.g. with dynamic pricing), will only be applied from the first MeterValue received after the price change.
Custom Invoice Note
What is it?
Custom Invoice Note allows provider admins to add a free-text note that will appear on all invoice PDFs generated under their account. The note is configured once under Provider Settings and automatically prints on every invoice type — MSP, CPO, and Reimbursement — for that provider.
Who is it for?
Private label operators who need to include brand or legal attribution text on invoices (e.g. indicating a brand is operated by or affiliated with another entity)
Example Use Case
Company operates their EV charging brand Brand under Road's billing engine. To avoid confusion for end customers receiving invoices, they need every invoice to clearly state that Brand is a brand of Company operated by Road B.V.
The note is configured under the Brand provider account.
Limitations/Considerations
1,024 character limit per language field. Each language field has a maximum length of 1,024 characters. Supported languages: EN, DE, ES, FR, IT, NL. All language fields are required.
Text format: Plain text only.
Not customer-configurable. This is a provider-level setting managed by admins. End customers and account-level users do not have access to this configuration.