Skip to content

Student Enrolment

Applies to: roles with Students.Create (registration), Students.Edit (starting a course) and Invoices.Create (selling a package on an invoice). Last reviewed: 2026-11-18.

"Enrolment" in DriveFlow means putting a student on a training package, which creates a course. This page describes the three ways it happens and what each one creates.


1. The three routes

Route Use it when Course status created Invoice
A. Register Student The person is new to the school. Active Created automatically, full package price
B. Start New Course (new package) An existing student takes another package now. Active Created automatically, full package price
C. Sell a package on an invoice, start it later An existing student pays for a package in advance, to start later. Purchased, then Active when started The invoice you create; none when it is started
flowchart TD
    N[New person] --> A[A. Register Student] --> AA[Active course + invoice]
    E1[Existing student] --> B["B. Start New Course (choose package)"] --> BB[Active course + invoice]
    E2[Existing student] --> C["C. Invoice line 'Add as new course from this package'"] --> CP[Purchased course]
    CP --> CS["Start New Course (pick the purchased course)"] --> CC["Active course (no new invoice)"]

There is no separate "enrolment" screen, no enrolment form to print, and no waiting list.


2. Route A - Register Student

Covered in full in Student registration. In summary, choosing a Training Package in the Training Information panel and clicking Register Student creates:

  • the student,
  • an Active course on that package (start date today),
  • a Pending invoice for the package price, due in 15 days, emailed to the student,
  • the welcome notification.

A student cannot be registered without a package.


3. Route B - Start New Course with a new package

Who: users with Students.Edit.

Where: the student's three-dot actions menu > Start New Course (in the Student Directory or the profile's bottom bar). The item is hidden for Licensed and Inactive students.

Steps

  1. Click Start New Course. The box opens - "Start a new training course for this student."
  2. If the student already has an active course, an Active Course panel shows it, with the text "This student already has an active course. A student can only have one active course at a time." Tick Complete the current course ("Mark (course) as completed today and activate the new course."). Without this tick the new course cannot be started.
  3. Under New Course, choose:

    Field Required Notes
    Licence Code Yes Only codes your school offers. Message: "Please select a licence code."
    Training Package Yes Greyed out until a licence code is chosen ("Select a licence code first to see the available training packages."). Lists that licence code's packages with their prices, plus all Assessment packages. Message: "Please select a training package."
  4. A Course Preview appears - "This course will become the student's active course." - showing Licence, Package, Price and Status: Active.

  5. If you ticked Complete the current course, a Course transition note confirms: "The current course will be completed and the selected course will become active."
  6. Click Start Course.
  7. You see "New course started successfully."

Screenshot to be added

Screen: Start New Course box. Should show: Active Course panel with "Complete the current course" ticked, Licence Code and Training Package chosen, and the Course Preview.

The box reminds you: "Starting a new course does not create a new student. The student's previous courses, lessons, tests, invoices and payments remain available in their history."

What is created and changed

Item Result
Previous active course (if ticked) Status Completed, completion date today.
New course Status Active, start date today, at the student's branch, with the chosen package and licence code.
Invoice Pending, for the full package price, invoice date today, due in 15 days, one line described "(package code) - (package name)" followed by the package items if it has any, linked to the new course.
Student record Package and licence code are replaced by the new ones.
Student status Becomes In Training, whatever it was.
Training completed Cleared: normal lesson booking is open again.
Lesson allowance Restarts from the new package. See Package allocation.

Send the invoice yourself

Unlike registration, this invoice is not emailed automatically and no notification is sent. Send the invoice to the student from the invoicing pages.

Things that are not done:

  • Unused lessons of the old course are not carried over or credited.
  • Lessons already booked on the old course are not cancelled or moved. They stay on the old course.
  • The old course's invoice is not adjusted.

4. Route C - Sell a package now, start it later

This is for a student who buys their next package before finishing the current one, or who pays for a package they will start at a later date.

Step 1 - Put the package on an invoice

Who: users with Invoices.Create. The full invoice screen is documented in Invoicing; only the enrolment part is described here.

  1. Create an invoice for the student.
  2. On an invoice line, choose a training package. The line's description, unit price (the package price) and quantity (1) are filled in.
  3. Tick Add as new course from this package, which appears under the line once a package is chosen.
  4. Save the invoice.

Result: the invoice is created, and a course is created for the student with the status Purchased, linked to that invoice line. The purchased course takes its licence code from the package. It does not affect the student's current course, allowance or status.

The amount is whatever is on the invoice line, so a discount can be given here.

Step 2 - Start the purchased course

Who: users with Students.Edit.

  1. Open the student's actions menu > Start New Course.
  2. Because the student has at least one purchased course, the box shows Purchased Courses - "Select a purchased course that has not yet been started." - instead of the Licence Code and Training Package fields. Each purchased course is listed as "(licence code) - (package name)" with "Purchased course" and its package price.
  3. Click the course to select it. If there is only one, it is already selected. A green Ready to start line confirms your choice.
  4. If the student has an active course, tick Complete the current course.
  5. Click Start Course. You see "New course started successfully."

What happens:

Item Result
Previous active course (if ticked) Completed, dated today.
The purchased course Status Active; its start date is set to today.
Invoice None. It was invoiced when purchased.
Student record Package and licence code are replaced by the purchased course's.
Student status Becomes In Training only if the student was Training Completed, Ready For Test, Test Booked, Test Failed, Test Passed or Licensed. Otherwise it stays as it is (for example Registered) and moves to In Training when the first lesson is booked.
Training completed Cleared.

Purchased courses come first

While a student has any purchased course waiting, Start New Course only offers the purchased courses. You cannot pick a different, new package in the box until the purchased ones have been started.


5. Rules and messages for Start New Course

Message Cause What to do
Please select a purchased course. The student has purchased courses and none is selected. Click one.
Please select a licence code and training package. One of the two is missing. Choose both.
Please complete the active course first, or select the option to complete it and start the new course. The student has an active course and Complete the current course is not ticked. Tick it, or complete the course first.
The student already has an active course. Please complete the active course before starting a new one. Same rule, from the server. As above.
Purchased course not found. The purchased course does not exist or belongs to another student. Reopen the box.
Only a purchased course can be started. The selected course is no longer Purchased (someone already started it). Reopen the box.
Training package not found. / Licence code not found. The package or code was removed. Choose another.
Student not found. The student was deleted. -
Unable to start the course. Refused without a specific reason. Retry.

Rules worth knowing:

  • One active course at a time.
  • A licence code is always required in this box, even for an Assessment package. (At registration an Assessment package needs no licence code.) The new course records the licence code you chose here.
  • The course is always created at the student's own branch.
  • The start date is always today. A course cannot be back-dated or scheduled to start in the future.
  • The price is always the package's current price. To charge a different amount, use Route C, or adjust the invoice afterwards.
  • Inactive packages are still listed (see Training packages).

6. Changing a student's package

There is no "change package" function for a course that is under way. The options are:

Need What to do
The student wants more lessons on the same course Add extra lessons one at a time. See Package allocation.
The student wants a different package Start New Course and tick Complete the current course. A new full-price invoice is raised; adjust or cancel the old invoice by hand if the student should not pay for both (see Invoicing). Remember unused lessons are not carried over and booked lessons stay on the old course.
The student was put on the wrong package at registration and nothing has happened yet Same as above. The first course will show as Completed in the history.

7. Example

Zanele is half-way through "Code B - 10 Driving Lessons" and decides to also do Code EB afterwards. She pays today to lock in the price.

  1. Finance creates an invoice for Zanele, adds a line, chooses the package "Code EB - 8 Lessons", gives a 10% discount on the line and ticks Add as new course from this package. The invoice is saved; Zanele now has a Purchased course in her Course History.
  2. Six weeks later she passes her Code B test. Reception opens Start New Course. The box lists the purchased "EB - Code EB - 8 Lessons". It is the only one, so it is pre-selected.
  3. Reception ticks Complete the current course and clicks Start Course.

Result: the Code B course is Completed; the Code EB course is Active from today; no new invoice is raised; Zanele's status goes from Test Passed to In Training; her allowance is 8 lessons.


8. Limitations and notes

  • No invoice email or notification on Start New Course (Route B), unlike registration (StartCourseCommand.cs).
  • Purchased courses block the new-package option in the Start New Course box until they are started (StartCourseDialog.razor).
  • No future or back-dated start date.
  • No transfer of unused lessons, bookings or balances between courses.
  • The server does not check the student's status when starting a course; the menu simply hides the item for Licensed and Inactive students.
  • Starting a new course always sets In Training, even for a student who has no learner's licence yet (they would otherwise be Registered or Learners Pending). The learner's licence rule for booking lessons still applies.
  • A Purchased course cannot be cancelled or removed on the web. Cancelling its invoice does not remove the course.
  • Quotes can also contain training packages; how a quote becomes an invoice, and whether a course is created at that point, is documented in Quotes.
  • Students cannot enrol themselves. The student portal lets a student request lessons, not buy a package.
  • The course endpoints are POST api/courses/start and GET api/courses/purchased?studentId=... (Students.Edit / Students.View).