Skip to content

Vehicle assignment

Applies to: Owner, Administrator (setting branch, ownership and current instructor); anyone who schedules lessons. Last reviewed: 2026-11-18.

A vehicle is "assigned" in four ways in DriveFlow. This page explains each and how they work together.

Assignment Set where Kind of rule
To a branch Vehicle form > Branch / Available to all branches Hard: decides where the vehicle can be booked
To licence codes Vehicle form > Licence Codes Hard: decides which lessons it can be used for
To an owner Vehicle form > Vehicle Ownership / Vehicle Owner Hard: only the owner may teach in an instructor-owned vehicle
To a current instructor Vehicle form > Current Instructor Soft: a default and a convenience
To a lesson or driving test When the lesson or test is booked The booking itself

All of the first four are edited from OPERATIONS > Vehicles > row menu > Edit (needs Vehicles.Edit), or on the Add Vehicle form.

Branch

Every vehicle has a home branch.

  • By default the vehicle can only be booked for lessons at its home branch.
  • Switch on Available to all branches to let every branch of the school book it. The home branch is then still used for the vehicle number and for reports.

Effects:

  • Vehicle pickers on the Schedule Lesson form list the vehicles of the lesson's branch plus the shared ones. If no branch is known, no vehicles are offered.
  • Editing a lesson onto a vehicle from another branch fails with "This vehicle is not available at the lesson's branch." (A lesson keeps a vehicle it already has.)
  • A vehicle's current instructor must work at the vehicle's branch unless the vehicle is shared.
  • Branch-filtered reports include the branch's own vehicles and the shared ones.

Licence codes

Tick every licence code the vehicle may be used for. When a lesson is scheduled, only vehicles that have the lesson's licence code are offered.

A vehicle with no licence codes would be treated by the scheduling engine as usable for any code, but the Add and Edit forms require at least one, so in practice every vehicle has its codes listed.

Ownership

Vehicle Ownership is either:

  • School Owned: any qualified, Active instructor at the branch may teach in it.
  • Instructor Owned: choose the Vehicle Owner. Only the owner may teach lessons in this vehicle.

How the owner rule is enforced:

Situation Result
Lesson scheduled with the owned vehicle, no instructor chosen The owner becomes the instructor.
Lesson scheduled with the owned vehicle and another instructor Refused: "This vehicle belongs to another instructor; only its owner can use it."
Vehicle chosen automatically Another instructor's vehicle is never picked. The instructor's own vehicle is picked first.
Existing lesson edited so that vehicle and instructor no longer match Refused with the same message.

Ownership is available on every plan. On Enterprise it also drives money:

  • Instructor Earnings: a lesson in the instructor's own vehicle uses their own-vehicle share; see Instructor earnings.
  • Fleet Management: on an instructor-owned vehicle the instructor's share is taken off the lesson income, and insurance, services, repairs and tyres are treated as paid by the instructor; see Fleet management.

Note

An instructor can own more than one vehicle. An owner is not automatically the vehicle's current instructor; set both if both apply.

Current instructor

Current Instructor is "the instructor currently using this vehicle". One instructor per vehicle and one vehicle per instructor; choosing an instructor moves them off any vehicle they had.

It is used to:

  • narrow the instructor list when a lesson is scheduled with that vehicle (only if the assigned instructor is free; otherwise all free instructors are listed);
  • pre-fill the Driver when kilometres are logged in Fleet Management;
  • decide which vehicle an instructor without Fleet.View may log kilometres and expenses for;
  • show Assigned Vehicle on the instructor's profile.

It does not stop other instructors using a school-owned vehicle.

Step-by-step instructions and error messages are in Instructor assignments.

Assigning a vehicle to a lesson

The vehicle for a lesson is chosen when the lesson is scheduled. Scheduling is documented in Lesson management; the vehicle-related behaviour is:

  1. On the Schedule Lesson form the Vehicle field lists the vehicles that are Active, usable at the lesson's branch, and have the lesson's licence code. Each is shown by its registration number.
  2. If the branch's scheduling settings have automatic vehicle assignment switched on, the field is labelled Vehicle (optional) with the hint "Leave empty to assign a free vehicle automatically." and the placeholder "-- Assign automatically --". Otherwise a vehicle must be chosen ("-- Select Vehicle --").
  3. When you save, the scheduling engine checks the vehicle is free (see Vehicle availability).

Automatic choice

With no vehicle chosen and automatic assignment on, the engine picks, among suitable free vehicles:

  1. a vehicle owned by the lesson's instructor, if there is one;
  2. otherwise the vehicle with the fewest lessons that day;
  3. then by name (make, model, registration), so the choice is repeatable.

Vehicles owned by other instructors are skipped.

Messages

Message Meaning
A vehicle must be selected for this lesson. No vehicle chosen and automatic assignment is off.
The selected vehicle is not suitable for this lesson. The vehicle is not Active, not usable at this branch, or lacks the licence code.
The vehicle is already assigned to another lesson at that time. It is busy (including the buffer).
No suitable vehicle is available at that time. Automatic assignment found none.
This vehicle belongs to another instructor; only its owner can use it. Owner rule.

Changing the vehicle of a booked lesson

Edit the lesson and choose another vehicle. The new vehicle must exist, be Active, be usable at the lesson's branch, obey the owner rule and be free: "Vehicle not found.", "Vehicle is not active.", "This vehicle is not available at the lesson's branch.", "Vehicle is already assigned to another lesson at that time."

Driving tests also record a vehicle; they appear on the vehicle's calendar. See the driving test documentation.

Worked example

A school has two branches, Durban and Pinetown.

  • ND 111-222 (school owned, Durban, Code 08). Current Instructor: Sipho. Any Durban Code 08 instructor may be booked in it; picking the car on the Schedule Lesson form offers Sipho first if he is free.
  • ND 333-444 (instructor owned, owner Ayesha, Pinetown, Code 08). Only Ayesha can be booked in it. If reception picks this car and then tries to choose Sipho, the booking is refused.
  • ND 555-666 (school owned, home branch Durban, Available to all branches, Code 10). Both branches can book it; it is numbered and reported under Durban.

Limitations and notes

  • Vehicle Details does not show the owner or the current instructor; open Edit.
  • No assignment history is kept, and assignments have no start or end date.
  • Transmission is not matched. Nothing stops a student learning on an automatic being booked in a manual vehicle; use separate licence codes or check by hand.
  • The owner rule is not applied to driving tests in the code reviewed here; it is enforced for lessons (scheduling engine and lesson edit).
  • An owner who is not Active leaves their vehicle unusable for new lessons, because only the owner may use it and only Active instructors can be booked.
  • The lists of instructors on the vehicle form include every status and at most 100 instructors.