Fuel events — getting started
Select a vehicle with a fuel sensor, set start and end date-time, and generate fuel events.
Open the screen
- In the sidebar, expand Fuel Monitoring.
- Select Fuel Event.
You need view fuel detection permission (see Permissions and access).
Choose a vehicle
The left panel lists vehicles for the active group (paginated search against the server).
- Use Search by plate number to narrow the list (search is debounced).
- Select a vehicle card.
Each card indicates whether a fuel sensor is present. If no fuel sensor is installed:
- The app shows a warning in the panel.
- Start Date and End Date stay disabled until a vehicle with a sensor is selected.
If No vehicles found appears, try another search or confirm vehicles exist for the current group.
Set the time range
After a vehicle with a fuel sensor is selected:
- Start Date — pick date and time (default time suggestion: start of day).
- End Date — must be on or after the start. Dates before the start are blocked in the picker.
Changing dates clears any previous result set so you do not mix ranges.
Generate results
Select Generate Fuel Events. The app sends the vehicle id and ISO timestamps (startsAt, endsAt) to the fuel events API.
While the request runs, the right side shows loading placeholders. On success, per-sensor blocks and event tables appear (see Reading results). On failure, results clear to an empty state.
Empty state before running
Until you run a generation pass, the right panel shows No conditions are currently available to display and instructs you to select a vehicle, date range, and run the action. The primary button label in the app is Generate Fuel Events (not “Calculate”).