> For the complete documentation index, see [llms.txt](https://spice.docs.medtroniclabs.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://spice.docs.medtroniclabs.org/user-guide/dispense.md).

# Pharmacy & Dispense

## Feature Overview

The Pharmacy feature (**Dispense** on the home screen) helps a pharmacist find a patient's prescribed medicines and record how much of each one was dispensed. It shows each medicine with its dosage, form and frequency, the prescriber's details and the date of the last refill. If a medicine is dispensed for fewer days than prescribed, the pharmacist records the reason.

It needs an internet connection.

> **Who sees Dispense:** the **Dispense** tile appears on the home screen for users whose role has the pharmacy workflow enabled by their organisation.

## Workflow

<figure><img src="https://2347658875-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7inBQ0zjo0nwpqK5625P%2Fuploads%2Fu9B7xvyLH9zym5gfzDjY%2Fdispense%20gif%20updated%20(Facebook%20Post%20(Landscape))%20(Instagram%20Post%20(Square)).gif?alt=media&amp;token=a6c14594-4642-4f9e-bee5-99193592e484" alt="Dispensing medication in the SPICE app"><figcaption><p>Dispense medication in SPICE</p></figcaption></figure>

1. Sign in and make sure the device is online.
2. On the home screen, tap **Dispense**. The **Search Patient** screen opens.
3. Enter the patient's name, ID or mobile number in **Enter Name / ID / Mobile Number** and tap the search icon. You can also tap the QR icon and scan the patient's QR code.
4. Tap the patient's card in the results. The card shows the patient's name, age and gender, national ID (when recorded) and Patient ID. The **Pharmacist** screen opens, titled with the patient's name, age and gender.
5. Check the patient's details at the top of the screen:
   * **Program ID** and **National ID**;
   * **Prescriber** and **Prescriber's Number**;
   * **Last Refill Date**. Tap the date to see the **Prescription History** from that refill, with each medicine's dosage, unit, form, frequency, prescribed days and days filled.
6. Look at the list of medicines. For each one the row shows **Medication Name**, **Dosage**, **Form**, **Freq.** and **Medication Prescribed (Days)**. This is the number of days of medicine still to be dispensed, that is, the prescribed days minus the days already dispensed.
7. Tap the arrow on a row to see more: when the medicine was prescribed, its dosage form, brand, classification and the prescriber's **Instructions**.
8. In **Days Filled**, enter the number of days you are dispensing for each medicine.
9. Tap **Done**.
   * If every medicine is dispensed in full, the dispense is recorded and a **Prescription dispensed successfully** message appears. Tap **Done** to close it.
   * If any medicine has fewer **Days Filled** than **Medication Prescribed (Days)**, the **Reason for Quantity Difference** window opens. Go to the next section.

Tap **Cancel** at the bottom of the screen at any time to leave without recording anything.

## When the days filled are fewer than prescribed

The **Reason for Quantity Difference** window lists each medicine that was dispensed for fewer days than prescribed, with its **Medication Name**, **Prescribed Days** and **Filled Days**.

1. For each medicine, open the **Reason** list and choose a reason. The reasons are set up by your organisation.
2. If you choose **Other Reason**, type the details in **Detail on Other Reason**.
3. Tap **Done**. The dispense is recorded.

You must choose a reason for every medicine listed, otherwise the app shows **Please select a reason**. Tap **Cancel** to return to the medicine list and change the days instead.

A medicine left blank under **Days Filled** counts as zero days, so it also appears in this window.

## Notes

* Search results are limited to patients who are enrolled in treatment.
* The list of medicines comes from the prescriptions written during medical reviews (see [Medical Review](https://spice.docs.medtroniclabs.org/user-guide/medical-review.md)). If the patient has no medicine to dispense, the screen shows **No Medication Prescribed**.
