Platform overview

This section provides an overview of the key concepts and data relationships within Spirii's charging platform.

Understanding these elements may be crucial for effectively utilizing the APIs available in this Developer Hub and integrating them with your backend.

Data entities and relationships

Concept description

Below you will find a description of the key concepts shown in the above overview.

Chargers

• Locations : The container for one or more chargers at a geographical site and the core entity for connecting pricing and access management for charging on the site.
• Charge Boxes : The individual charge box that can serve electricity to one or more electrical vehicles at a time.
• EVSEs: The part of a charge box that can serve electricity to one EV at a time.
• Connectors: The socket/cable available for a single EV to use.

Authentication

• Voucher Groups: Defines the access and price conditions for specified user groups at select locations.
• Vouchers: The voucher code to be entered in Spirii Go or a branded app to grant access to the locations specified in the voucher group.
• Charge Key Groups: Optional restriction logic to only allow specified charge keys to charge a select locations.
• Charge Keys: The authentication ID that can be used to initiate a charging session, including types like RFID keys, Virtual keys, or Vehicle keys (Autocharge).
• App Users: The driver who has created an account in a branded charging app built by Spirii.
• Payment Terminal: The payment terminal that serves credit card payments for one or more chargers at a location.

Pricing

• Tariffs: Defines the gross price and conditions of charging. Supports flat and dynamic (spot price) based charging and can contain multiple conditional fees.
• Roaming tariff: Serves as the charging price sent to roaming hubs and partnerships connected to Spirii. Notice that the roaming hub and eMSP most likely will add their margin on top of this price to cover their cost and profit.

Charging sessions

• Charge Detail Records (CDRs): The immutable and billable record of a completed charging session.
• Transactions: The transaction of electricity during a charging session. Includes ongoing sessions.

Agreements

• Financial Agreements: Contains the contractual agreements for charging between Spirii and the partner, or the partner and their client.
• Service Level Agreements (SLAs): Contains the support level agreements and response times for handling issues and downtime.

Energy management

• Power Grid Zones: Defines the electricity grid zone that the location is connected to. Some countries contain just a single grid, whereas others have multiple.
• Circuits: The part of the electrical installation that contains a fuse covering one or more chargers.
• Schedules: Defines the conditions for delayed and scheduled charging to lower the costs of charging.