Package Pricing¶
Applies to: roles with Settings.View (view) and Settings.Manage (change); invoice effects concern anyone who registers students or starts courses. Last reviewed: 2026-11-18.
This page explains how a training package gets its price, the package item catalogue, the "lesson price", and how a package's price reaches the student's invoice.
1. Two ways to price a package¶
| Method | How | When the Price field is editable |
|---|---|---|
| Flat price | Type the price in the Price field and add no items. | Always. |
| Itemised price | Add one or more package items. The price is the total of the items (quantity × unit price, added up). | Never - the field becomes read-only and shows the total. |
The server applies the same rule: if a package is saved with items, its price is set to the items' total, whatever price was sent. A package cannot have items and a different price (so there is no "bundle discount" field; to discount a bundle, lower the unit prices inside that package).
No VAT on packages
All amounts are entered as plain numbers. There is no VAT or tax field on a package; the invoice raised for a package has no tax line.
2. Who can do what¶
| Action | Permission |
|---|---|
| See packages, items and prices | Settings.View |
| Manage Items (catalogue) | Settings.Manage |
| Add / edit / delete packages and their items | Settings.Manage |
| See and tick Lesson price on an item | Settings.Manage, and the school's plan must include Instructor Earnings (Enterprise) |
3. The package item catalogue¶
The catalogue is the school's list of things packages are made of - for example driving lessons, vehicle hire for the test, or the test booking. Set each item up once, then pick it into packages.
Where: Settings > Driving School > Manage Packages > Manage Items. The Package Items box opens.
Screenshot to be added
Screen: Package Items box. Should show: the "Add an item" form at the top and the list of items with price, "Used in N package(s)" and Active/Inactive chips.
3.1 Adding an item¶
-
In the Add an item panel, complete:
Field Required Meaning Rules Item name Yes What the item is called on packages and invoice lines. Up to 150 characters. Must be unique within the school. Default price No The price suggested when the item is added to a package. 0 or more. Starts at 0. Description (optional) No A note about the item. Up to 500 characters. Available for new packages (switch) - Whether the item can be picked into packages. Starts on. -
Click Add Item. You see "Item added."
3.2 Editing an item¶
- Click the pencil icon on the item. The panel heading changes to "Edit (name)".
- Change the fields and click Save Item (or Cancel edit).
- You see "Item updated. Existing packages keep their own prices."
The key rule
That message is the key rule: changing an item's default price does not change any package. Each package keeps the unit price it was saved with.
Only the next time someone picks the item into a package is the new default suggested. Renaming an item also does not rename it inside packages that already use it - a package keeps its own copy of the name until that package is next saved from the edit box.
3.3 Switching an item off¶
Edit the item and turn Available for new packages off. The item shows an Inactive chip and no longer appears in the Add an item list on packages. Packages that already include it keep it.
3.4 Deleting an item¶
- Click the red bin icon on the item.
- Confirm in the Delete Item box. If the item is used, the text is "Delete (name)? It stays in the N package(s) that already use it, but can no longer be added to packages."
- You see "Item deleted."
The item is hidden from the catalogue. Packages that use it are not changed.
3.5 Messages¶
| Message | Cause |
|---|---|
| Please enter an item name. | Add Item / Save Item clicked with no name. |
| Item name is required. | Same, from the server. |
| Item name cannot be longer than 150 characters. | Name too long. |
| Item price cannot be negative. | Default price below 0. |
| An item called '(name)' already exists. | Another item of the school has this exact name. |
| Package item was not found. | The item was deleted by someone else. |
| Unable to save the item. / Unable to delete the item. | Refused without a specific reason. |
Click Done to close the box. The Training Packages page reloads.
4. Building a package from items¶
In the Add Training Package / Edit Training Package box, under Package Items:
- In Add an item, choose an item. The list shows each active catalogue item that is not already in the package, as "name (R default price)".
- Click Add. A line appears with the item name and:
- Qty - how many units the package includes (minimum 1; starts at 1);
- Unit price - the price of one unit in this package (starts at the item's default price; can be changed);
- the line total, "= R (qty × unit price)".
- Repeat for other items. The Package price line and the Price field show the running total.
- To remove a line, click its red bin icon.
- Save the package.
Rules:
- An item can appear once per package. Use Qty for multiples.
- Quantities must be at least 1 and unit prices 0 or more.
- If no items have been set up yet, the box shows "No package items have been set up yet. Use Manage Items on the Training Packages page to add them."
- Lines are saved in the order shown and appear in that order on cards and invoice lines.
Items and the number of lessons are separate¶
Item quantity does not set the number of lessons
The quantity of a "Driving lesson" item is not linked to the Number of Lessons field. The item quantity only affects the price; the Number of Lessons field alone decides how many lessons the student may book. Set both: for example Qty 10 on the lesson item and Number of Lessons 10. If they differ, the system does not warn you.
5. The lesson price¶
The lesson price is the value of one lesson in a package. It is used for:
- the suggested fee when a lesson is billed as an extra lesson (see Package allocation);
- the price of an extra lesson requested by a student in the portal (see Student portal);
- instructor earnings, where an instructor's share is based on the lesson's value (Enterprise; see Instructor earnings).
How it is worked out:
| Situation | Lesson price |
|---|---|
| One item in the package is ticked Lesson price | That item's unit price. |
| No item is ticked, and the package has lessons | Package price ÷ Number of Lessons, rounded to 2 decimals (halves round up). |
| No item is ticked, and Number of Lessons is 0 | 0 |
Marking an item as the lesson price¶
Only visible when the school's plan includes Instructor Earnings.
- Edit the package.
- On the item line that represents one lesson, tick Lesson price (tooltip: "Use this item's unit price as the price of one lesson").
- Save.
Only one item per package can be ticked; ticking another moves the tick. Below the items the box shows, for example, "Lesson price: R 250.00 (the marked item)" or "Lesson price: R 280.00 (package price ÷ number of lessons; tick an item's Lesson price to set it)".
Why it matters: a package of 10 lessons at R 250 plus R 300 vehicle hire costs R 2 800. Without a marked item the lesson price is R 2 800 ÷ 10 = R 280, which over-values each lesson. With the lesson item marked it is R 250.
On plans without Instructor Earnings the tick box is hidden and the lesson price is always the package price divided by the number of lessons (unless an item was ticked earlier, when the plan included it; the stored tick is still honoured).
6. How the price reaches the student¶
| Event | Invoice raised | Amount | Line description | Due |
|---|---|---|---|---|
| Register Student | Yes, automatically | Full package price | Package name, followed by the items if the package has any | 15 days |
| Start New Course with a new package | Yes, automatically | Full package price | "(package code) - (package name)", followed by the items if any | 15 days |
| Start New Course with a purchased course | No (it was invoiced when purchased) | - | - | - |
| Invoice line with Add as new course from this package ticked | The invoice you are creating | As entered on the line (starts at the package price; can be changed and discounted) | The package name (editable) | As set on the invoice |
| Add Extra Lesson (paid) | Yes | The fee you enter | "Extra driving lesson - (package name)" | 7 days |
An itemised package produces one invoice line, not one line per item. The items are written into the description, for example:
Code B - 10 Lessons + Test Vehicle: 10 x Driving lesson R2,500.00, Vehicle hire for test R300.00
The invoice line itself has quantity 1 and unit price equal to the package price. All these invoices start as Pending with nothing paid. Recording payments, part-payments, credit and cancelling invoices are covered in the financial management documentation.
Price changes¶
- Changing a package's price affects future invoices only. Invoices already raised keep their amounts.
- There is no price history and no "effective from" date.
Changing a student's package¶
There is no screen to swap the package of a student's current course. The supported route is to start a new course (Student enrolment), which raises a new full-price invoice; the old course's invoice is not adjusted automatically. If the student should not pay twice, correct the invoices by hand in the invoicing pages.
Package change adjustment (for developers)
The server does contain a "package change adjustment" rule: if a student's package is changed through the student update, it raises an invoice for the price difference - Pending if the new package costs more, or a Credit if it costs less - described as "Package change adjustment: (old) → (new) (lessons a → b)". No web screen can trigger this, because the edit page does not let you change the package. It is listed here so that developers know it exists (UpdateStudentCommandHandler.cs).
7. Example¶
Catalogue: "Driving lesson" R 250; "Vehicle hire for test" R 300.
Package "Code B - 10 Lessons + Test Vehicle": Number of Lessons 10; items 10 × Driving lesson at R 250 and 1 × Vehicle hire for test at R 300. Price shows R 2 800.00. "Driving lesson" is ticked as Lesson price.
- Naledi registers on this package: she receives one Pending invoice for R 2 800.00, due in 15 days.
- Later the school raises the catalogue price of "Driving lesson" to R 270. Naledi's invoice and the package are unchanged; the package still charges R 250 per lesson until someone edits the package's own unit price.
- Naledi needs an eleventh lesson. Bill as extra lesson suggests R 250.00 (the marked item), not R 280.00.
8. Limitations and notes¶
- No tax/VAT on packages; package invoices are raised with no tax amount.
- No discounts at package level. Discounts exist on invoice lines only (see Invoicing).
- One invoice line per package, with the items in the description text.
- Item descriptions on invoice lines always use "R" as the currency symbol, whatever the school's country (
TrainingPackage.DescribeLine). - Item quantity and Number of Lessons are not linked (section 4).
- Catalogue price changes never flow into existing packages; each package must be edited.
- No instalment plans or deposits are defined on a package. A package is invoiced in full; the student may pay the invoice in parts.
- No per-branch pricing.
- The package-change adjustment invoice has no user interface (section 6).
- Lesson price tick box needs the Instructor Earnings feature to be visible.
Related articles¶
- Training packages - create and edit packages.
- Package allocation - extra lessons and lessons booked beyond the package.
- Student enrolment - the routes that raise a package invoice.
- Invoicing - invoices, payments and discounts.
- Instructor earnings - how the lesson price drives earnings.