Fleet Operator Integration

Fleet operators manage company EV fleets — vehicles, drivers, and charging budgets. The Agent API lets you search for chargers and book reservations with group-based token management.

Architecture

Fleet Dashboard  ──→  Your Backend  ──→  Agent API  ──→  EV Suite  ──→  CPOs
                                        (REST/JSON)     (OCPI 2.2)

Key Concepts

Fleet Groups

Organizational units for your fleet. Each group has:

• A set of vehicles and drivers
• Monthly spending limits
• Per-session spending caps
• A shared group token (for group_token strategy)

Group Tokens

A representative token shared across a fleet group. Any driver in the group can present it at the charger. This is ideal when vehicles rotate between drivers.

Spending Limits

Each group has configurable limits:

• Monthly limit — Total spending cap per calendar month
• Per-session limit — Maximum cost per individual charging session

When a limit is reached, new bookings for that group are rejected.

Driver Management

• Invite drivers via email (7-day expiry)
• Drivers accept invitations and link their accounts
• Suspend/reactivate drivers as needed
• Track per-driver usage

Token Strategies for Fleet

Strategy	When to Use
group_token	Shared fleet token — drivers may change between vehicles
driver_token	Each driver has their own token (less common for fleets)
ad_hoc	One-off bookings for temporary drivers

Getting Started

1. Group Tokens — Create and manage fleet group tokens
2. Search → Book Flow — Fleet-specific booking walkthrough
3. Billing & Reporting — Spending limits, CSV export, billing periods