🧩 Overview
The Medication module includes built-in safety checks to prevent medication errors and protect students.
These checks may appear when staff:
administer medication
adjust inventory
create prescriptions
edit administration records
When a rule is triggered, Orah may display a warning or prevent an action. The sections below explain the most common scenarios and how to resolve them.
❓ Why can’t I administer medication?
Medication administration may be blocked for a few reasons.
Possible causes
The most common causes are:
The student is not assigned to a house
The medication is out of stock
The entered dose exceeds available stock
How to resolve
If the student is not assigned to a house
Assign the student to a house
Retry the administration
If stock is unavailable
Add stock to the medication inventory
Or select a house where stock is available
❓ Why do I see an “Insufficient stock” error?
When entering a dose, the system checks the amount against available inventory.
If the entered dose exceeds available stock, an error appears.
Example:
Insufficient stock (X available)
How to resolve
You can either:
reduce the dose entered, or
add additional stock to inventory before recording the administration
❓ What does the dose restriction warning mean?
Dose restrictions are safety limits configured in the Medication Catalog.
When recording an administration, Orah checks whether the dose exceeds these limits.
Example warning
The dose exceeds the maximum allowed of [n] units per administration.
Important
Dose restriction warnings are informational only.
Staff can review the warning and still proceed with the administration if appropriate.
❓ Why can’t I delete a medication?
A medication cannot be deleted if it is currently associated with:
an Active prescription
a Paused prescription
This prevents medications currently in use from being removed accidentally.
How to resolve
Deactivate or remove the related prescriptions first, then attempt deletion again.
❓ Why does inventory show “–” instead of a stock number?
A dash ( – ) appears when stock tracking has not yet been enabled for that house.
Inventory records are created only when stock is first adjusted.
How to resolve
Add stock for that medication in the relevant house to begin tracking.
Once stock is added, the inventory value will appear.
❓ Why can’t stock go negative?
Orah prevents inventory levels from dropping below zero.
If an action would result in negative stock, the system blocks the change.
How to resolve
Add stock before recording the administration or stock adjustment.
❓ Why can’t I save an edited administration record?
When an administration record is changed to Not Administered, you must specify whether stock should be returned to inventory.
If this step is skipped, the system displays an error.
Example:
Please select an option for adding stock
How to resolve
Choose one of the following options:
Yes — return stock to inventory
No — do not return stock
❓ Why can’t administration history be edited?
Administration history is part of the system’s audit trail.
These records cannot be modified or deleted.
If a correction is needed, the system creates a new correcting entry instead of editing the original record.
This ensures medication records remain compliant and traceable.
🛟 When to contact Orah Support
If the Medication module behaves unexpectedly, collect the following information before contacting support:
school name
student name
medication name
screenshots of the issue
steps taken before the issue occurred
Providing these details helps the support team investigate the issue faster.