Skip to content

Vehicle availability

Applies to: everyone with Vehicles.View (calendar); anyone who schedules lessons; Owner, Administrator (status changes). Last reviewed: 2026-11-18.

This page explains when DriveFlow considers a vehicle free for a lesson, how to see a vehicle's bookings, and what to do when a vehicle cannot be used.

When is a vehicle available?

A vehicle can be booked for a lesson when all of these are true:

# Condition Set where
1 Its status is Active. Vehicle information
2 It is usable at the lesson's branch (home branch, or "Available to all branches"). Vehicle assignment
3 It has the lesson's licence code. Vehicle form > Licence Codes
4 If it is instructor owned, the lesson's instructor is its owner. Vehicle assignment
5 It has no other lesson overlapping the time. Cancelled lessons do not block. The branch's buffer minutes are added before and after each existing lesson. Settings > Scheduling
6 It has no pending lesson request (a student's online booking awaiting approval) overlapping the time. Lessons > Lesson requests
flowchart TD
    A["Lesson wanted: branch + licence code + date/time (+ instructor)"] --> B{Vehicle Active?}
    B -- No --> N[Not offered]
    B -- Yes --> C{Usable at this branch,<br/>has the code?}
    C -- No --> N
    C -- Yes --> D{Owned by another instructor?}
    D -- Yes --> M1["This vehicle belongs to another instructor; only its owner can use it."]
    D -- No --> E{Lesson or pending request<br/>overlapping, with buffer?}
    E -- Yes --> M2["The vehicle is already assigned to another lesson at that time."]
    E -- No --> F[Available]

The buffer. If the branch buffer is 15 minutes and the vehicle has a lesson from 10:00 to 11:00, it is blocked from 09:45 to 11:15. A new lesson may start at 11:15 at the earliest.

What the picker shows. The Vehicle list on the Schedule Lesson form applies conditions 1 to 3 only. A vehicle can therefore be listed and still be refused when you save, because it is busy at that time. The message tells you why.

Expiry dates do not block bookings

Expired licence disc, roadworthy or insurance dates, and an overdue service, do not make a vehicle unavailable. They raise reminders only (Vehicle maintenance). To keep an unroadworthy vehicle from being booked you must change its status.

Vehicle calendar

To see what a vehicle is booked for:

  1. Open OPERATIONS > Vehicles.
  2. Open the row menu and click Calendar (address /vehicles/{id}/calendar).

The Vehicle Calendar page ("Lessons and driving tests scheduled for this vehicle.") shows a Week or Day view in 30-minute rows from 06:00 to 21:00.

  • Use the arrows, Today, and the Week / Day selector to move around.
  • Each booking shows its time, "Lesson" or "Driving test" with the licence code, the student, the instructor and the status.
  • Driving tests are shown with an orange edge; completed, cancelled and no-show lessons have their own colours.
  • Click a booking to open the lesson or driving test details.
  • Back to Vehicles returns to the list.

If there is nothing in the period: "No lessons or driving tests for this vehicle in this period."

Screenshot to be added

Screen: Vehicle Calendar page. Should show: week view with lessons and one driving test.

The calendar is view-only: you cannot create or move bookings from it. A driving test is drawn as one hour from its test time.

Handling an unavailable vehicle

Use this when a vehicle breaks down, goes in for a service, or is otherwise off the road.

1. Stop new bookings

  • For a short or long absence: Vehicles > row menu > Set Out of Service (one click), or Edit > Status > Maintenance if you want it shown as in the workshop.
  • Both statuses stop the vehicle being offered or accepted for new lessons. In Fleet Management both appear under Maintenance alerts as "not available for lessons".

2. Deal with lessons already booked

Important

Changing the status does not touch existing bookings. You must move them.

  1. Open Vehicles > row menu > Calendar and step through the days the vehicle will be away. Note each lesson and driving test.
  2. For each lesson, open it and edit it to another vehicle (or reschedule or cancel it); see Lesson management.

    While the vehicle is not Active, saving an edit that keeps the same vehicle is refused with "Vehicle is not active.", so choose the replacement vehicle in the same edit.

  3. The replacement must be Active, usable at the lesson's branch, free at that time, and not owned by a different instructor.

If the unavailable vehicle is instructor owned, its owner can be booked in a school vehicle instead; those lessons then earn the instructor's school-vehicle share rather than the own-vehicle share.

3. Bring the vehicle back

Click Vehicles > row menu > Activate. It is immediately bookable again. If a service was done, record it (Vehicle maintenance).

If the vehicle is gone for good

Set Edit > Status > Sold. It stops counting towards the plan limit, stops raising reminders and disappears from pickers. Move any future lessons first.

Example

On Tuesday morning the Pretoria Swift will not start. It has four lessons today.

  1. Reception clicks Set Out of Service on the Swift. Nobody can book it from now on.
  2. Reception opens the Swift's Calendar, sees the four lessons, and edits each one to the branch's spare Polo. One lesson overlaps a Polo booking ("Vehicle is already assigned to another lesson at that time."), so that lesson is rescheduled to Wednesday.
  3. On Thursday the Swift is back: Activate.

Limitations and notes

  • No blocked periods for vehicles. You cannot enter "in the workshop from the 3rd to the 5th". Availability is controlled only by the status, which is on or off and has no dates; DriveFlow does not switch it back automatically.
  • No automatic re-assignment or warning. Setting a vehicle Out of Service does not list or flag the lessons affected. Use the vehicle calendar.
  • Expiry dates never block booking.
  • Driving tests are not part of the lesson overlap check in the scheduling engine reviewed here: the engine looks at lessons and pending lesson requests. A driving test and a lesson could be booked in the same vehicle at the same time; check the vehicle calendar when booking tests. (Whether the driving-test form does its own check belongs to the driving test documentation.)
  • The vehicle calendar only covers 06:00 to 21:00; a booking outside those hours is not drawn.
  • Per-vehicle availability figures (for example percentage of time booked) are not calculated; the Vehicle Details view shows lessons, tests and hours for the last 12 months only.

Driving tests and lessons can overlap in the same vehicle

The lesson overlap check does not look at driving tests. Check the vehicle calendar when booking tests.