Registering a vehicle¶
Applies to: Owner, Administrator (any role with the Vehicles.Create permission). Last reviewed: 2026-11-18.
Every lesson and driving test in DriveFlow is booked in a vehicle. This page explains how to add a vehicle and what each field on the form means.
Who can do this¶
| Action | Permission | Default roles |
|---|---|---|
| Open the Vehicles page | Vehicles.View |
Owner, Administrator, Manager, Instructor, Receptionist, Finance, Viewer |
| Add a vehicle | Vehicles.Create |
Owner, Administrator |
Important
The Add Vehicle button is drawn only for users with Vehicles.Create. Your plan must include Vehicle Management, and it sets how many vehicles you may have (see Plan limit).
Before you start¶
- At least one branch must exist.
- At least one licence code must be set up for your school.
- If the vehicle belongs to an instructor, that instructor must be registered first (Registering an instructor).
Steps¶
- In the left menu under OPERATIONS, click Vehicles. If your plan has Fleet Management the menu is a group: click Vehicles, then Vehicles.
- Click Add Vehicle (top right of the table).
- Fill in the form sections described below.
- Click Save Vehicle.
You see "Vehicle added successfully.", the dialog closes, and the table and summary cards refresh.
Screenshot to be added
Screen: Add Vehicle dialog. Should show: Vehicle Information section filled in.
Screenshot to be added
Screen: Add Vehicle dialog. Should show: Ownership & Assignment, Documents & Expiry and Licence Codes sections.
The form, field by field¶
Vehicle Information¶
| Field | Required | What it means |
|---|---|---|
| Registration Number | Yes | The number plate, for example "ABC 123 GP". Up to 20 characters. Must be unique among your school's vehicles. This is what staff see in vehicle pickers when scheduling. |
| VIN | No | Vehicle identification (chassis) number. Up to 30 characters. |
| Engine Number | No | Up to 30 characters. |
| Make | Yes | For example "Toyota". Up to 50 characters. |
| Model | Yes | For example "Corolla". Up to 50 characters. |
| Year | Yes in practice | Year of manufacture. Must be between 1950 and next year. The field starts at 0, so you must enter it. |
| Colour | No | Up to 30 characters. |
| Transmission | Yes | Manual (default) or Automatic. Shown on the list and in reports. It is information only: scheduling does not match transmission to the student. |
| Fuel Type | Yes | Petrol (default), Diesel, Hybrid or Electric. |
| Branch | Yes | The vehicle's home branch. It decides the vehicle number, which branch's reports include the vehicle, and where it can be booked. When "Available to all branches" is on, the label changes to Home Branch. |
| Available to all branches | No | Switch on to let every branch of your school book this vehicle. The form then notes: "Can be booked at every branch. The home branch is used for the vehicle number and reports." |
| Current Mileage | No (defaults to 0) | The odometer reading in km today. Must not be negative. It is compared with the next service mileage, and Fleet Management moves it forward as kilometres are logged. |
| Status | Shown, but ignored when adding | A new vehicle is always saved as Active whatever is chosen here. Change the status afterwards with Edit; see Vehicle information. |
Ownership & Assignment¶
| Field | Required | What it means |
|---|---|---|
| Vehicle Ownership | Yes | School Owned ("Vehicle belongs to the driving school", default) or Instructor Owned ("Vehicle belongs to an instructor"). Click one of the two cards. |
| Vehicle Owner | Yes when Instructor Owned | The instructor who owns the vehicle. Appears only when Instructor Owned is selected. Only this instructor may teach lessons in the vehicle. |
| Current Instructor | No | The instructor who normally uses the vehicle. Helper text: "The instructor currently using this vehicle. Replaces any vehicle they were assigned before." |
These two instructor fields do different things; see Vehicle assignment.
Purchase Information¶
| Field | Required | What it means |
|---|---|---|
| Purchase Date | No | When the vehicle was bought. |
| Purchase Price | No | In rand; must not be negative. Recorded for reference only; it is not used in any calculation, including fleet profit. |
Documents & Expiry¶
| Field | Required | What it means |
|---|---|---|
| Insurance Expiry | No | The day the insurance cover ends. |
| Roadworthy Expiry | No | The day the roadworthy certificate ends. |
| Licence Disc Expiry | No | The day the licence disc expires. |
| Next Service Date | No | "Optional - you'll be notified when it's due". |
| Next Service Mileage | No | In km. "Optional - compared with the current mileage". |
All five are optional, and each one you fill in switches on a reminder in the notification bell. See Vehicle maintenance.
Notes¶
Free text, up to 1,000 characters ("Additional vehicle information...").
Licence Codes¶
"Select all licence codes this vehicle can be used for." Click the circle in the Use column for each code; a selected code shows a green tick. At least one is required.
A lesson for a licence code can only be booked in a vehicle that has that code.
What happens when you save¶
- The vehicle gets a vehicle number built from the home branch's code, the letters
VEHand the next number in that branch's sequence (for exampleJHB-VEH-0003). - Its status is Active.
- If a Current Instructor was chosen, that instructor's assigned vehicle becomes this one (and they are removed from any vehicle they had).
- The vehicle and the instructor assignment are saved together: if the assignment is not allowed, nothing is saved.
Plan limit¶
Before saving, DriveFlow counts your vehicles whose status is not Sold (deleted vehicles do not count). At the limit, nothing is saved and you see:
Your {plan name} plan allows up to {limit} vehicles. Upgrade your plan to add more.
The limits seeded with the product are 2 on the Free Trial, 5 on Starter, 15 on Professional, 30 on Enterprise, 70 on Enterprise Plus and unlimited on Enterprise Custom. See Subscriptions and billing.
Common errors¶
| Message | Why | What to do |
|---|---|---|
| Registration number is required. / Make is required. / Model is required. | Required field empty. | Fill it in. |
| Please select a branch. | No branch chosen. | Choose a branch. |
| Please select at least one licence code. | No licence code ticked. | Tick at least one. |
| Please select the vehicle owner. / Please select the instructor who owns this vehicle. | Instructor Owned without an owner. | Choose the Vehicle Owner. |
| Registration Number already exists. | Another vehicle of your school (not deleted) has this registration. | Check the number; edit the existing vehicle instead. |
| Branch not found. | The branch was removed or is outside your access. | Reopen the form. |
| Licence Code '…' not found. | A ticked code was removed meanwhile. | Reopen the form. |
| Assigned instructor not found. | The chosen Current Instructor was deleted. | Reopen the form. |
| The instructor works at a different branch from this vehicle. Assign an instructor from the vehicle's branch, or make the vehicle available to all branches. | Current Instructor is at another branch. | Choose another instructor or switch on Available to all branches. |
| Your … plan allows up to … vehicles. Upgrade your plan to add more. | Plan limit. | Mark an old vehicle as Sold, or upgrade. |
| Unable to add vehicle. / Unable to register vehicle. | The server rejected the request without a specific message, most often a Year outside 1950 to next year. | Check the Year and the field lengths. |
| Unable to load vehicle options: … | The branch, licence code or instructor lists could not be loaded. | Close and reopen the dialog. |
Example¶
The school buys a white 2024 Suzuki Swift for the Pretoria branch, to be used for Code 08 lessons by instructor Naledi.
- Open OPERATIONS > Vehicles > Add Vehicle.
- Registration Number JK 45 LM GP; Make Suzuki; Model Swift; Year 2024; Colour White; Transmission Manual; Fuel Type Petrol.
- Branch Pretoria; Current Mileage 12 500.
- Vehicle Ownership School Owned; Current Instructor Naledi Khumalo.
- Insurance Expiry 31 Oct 2027; Roadworthy Expiry 15 Mar 2027; Licence Disc Expiry 30 Apr 2027; Next Service Mileage 25 000.
- Tick the Code 08 licence code and click Save Vehicle.
The vehicle appears as Active with the next Pretoria vehicle number, and can be chosen when scheduling Code 08 lessons at Pretoria.
Limitations and notes¶
- The Status field on the Add form has no effect; the vehicle is always created Active.
- Year must be typed. It starts at 0 and the server rejects values outside 1950 to next year; the form's own upper limit of 2100 is looser than the server's.
- No document uploads. You can record expiry dates but cannot attach the licence disc, roadworthy certificate or insurance schedule. (Fuel and expense receipts can be attached in Fleet management.)
- No vehicle photo, seat count, tracker or dual-control fields.
- Registration uniqueness is exact text. "ABC123GP" and "ABC 123 GP" are treated as different, so agree on one way of writing plates.
- Licence category of the vehicle is expressed only through the licence codes ticked; there is no separate vehicle class field.
- The Vehicle Owner and Current Instructor lists include instructors of every status and show at most 100 instructors.
Tip
Agree on one way of writing number plates (for example always with spaces), because registration uniqueness is checked on the exact text.
Related articles¶
- Vehicle information - the list, viewing, editing, statuses and deleting.
- Vehicle assignment - branches, ownership, current instructor and lessons.
- Vehicle availability - when a vehicle can be booked.
- Vehicle maintenance - maintenance and expiry alerts.
- Fleet management - kilometres, expenses and profit (Enterprise).
- Registering an instructor - needed before adding an instructor-owned vehicle.