Patients

View and Manage Patients

Patients can be added and their information edited from this page.

Patients

To use patients, ensure that your store is set to Dispensary mode (see the virtual stores documentation for how to do this).

Open the Patient Menu

Click on Dispensary > Patients in the navigation panel.

Dispensary navigation menu showing the Patients option

You will be presented with a list of patients visible to your store.

Patient List

Patient list view showing columns for Patient ID, NUIC, Created date, First name, Last name, Gender, Date of Birth, and Deceased status

  1. The list of patients is divided into 8 columns:
ColumnDescription
Patient IDThe ID of the patient
NUICNational unique identifier code
CreatedThe date the patient was created
First nameFirst name
Last nameLast name
GenderGender
Date of BirthThe patient's date of birth
DeceasedWhether the patient is deceased
  1. The list can display a fixed number of patients per page. On the bottom left corner, you can see how many patients are currently displayed on your screen.

Indicator showing the number of patients currently displayed on the page

  1. If you have more patients than the current limit, you can navigate to the other pages by tapping on the page number or using the right of left arrows (bottom right corner).

Page navigation controls with page numbers and arrows

  1. You can also select a different number of rows to show per page using the option at the bottom right of the page.

Rows per page selector dropdown at the bottom right of the list

Filter Patients

You can filter the list of patients by using the search bar at the top of the page. This can be useful if you are looking for a specific patient. By default, the search bar will contain the filters for: First name, Last name, and Patient ID.

Patient filter search bar with fields for First name, Last name, and Patient ID

For example, to filter by gender, click on the Filters, select Gender, and then select which gender you would like to filter by.

Exporting Patients

The list of Patients can be exported to a comma separated file (csv). Simply click the export button (on the right, at the top of the page), and the file will be downloaded. The export function will download all Patients, not just the current page.

Creating a New Patient

Click on the New Patient button in the top right corner.

A new window will appear for you to enter the patient's details. You must enter the patient's first name and last name to enable the Search button. If you do not wish to enter the patient's real name, you can use a pseudonym.

New Patient dialog with fields for first name and last name

If you have a patient or patients matching the name you have entered, you will be prompted to select the patient in the new window.

Patient search results showing matching patients to select from

Clicking on the matching patient will re-direct you to the patient's details page.

If no matching patients are found, or if you want to create a new patient using similar details to an existing one, click the Create new patient button to continue to the patient details page and complete the setup. Then, click the Save button at the bottom of the page to create the patient.

New patient creation form with fields for entering patient details

Lookup a Patient

If you have followed the process above, you may see a different icon to the right of a patient's details on the patient search results screen:

Download icon indicating a patient record available from another site

Sometimes the record for the patient you are searching for has already been created at another site. This 'download' icon indicates that a patient matches your current search criteria, and you can download all their existing patient data to your site.

To use this patient record, you must first fetch the patient details. Click the patient row (which has a tooltip message as shown below):

Patient row with tooltip indicating click to fetch patient data from another site

You'll then be prompted to confirm the action:

Confirmation dialog asking to confirm fetching the patient record

and if successful, you'll then get a further message:

Success message after fetching patient data with a View patient button

Clicking the View patient button here will take you to the screen which displays the patient details. The patient is now available for prescribing to, enrolling in a program and for creating encounters. You can update the patient details and have them synchronise back to the store which originally created the patient record.

Edit a Patient

To edit a patient, click on the patient's name in the list of patients.

If there is more data in your Patient view, it's likely due to Patient Programs being configured. You can find out more in the Patient Programs documentation.

Insurance

Insurance policies can be added to a patient. You can edit the insurance information and use it for payments.

The Insurance tab is only available if you've setup Insurance Providers in mSupply

Insurance List

Select any patient and click on the Insurance tab. Here you can see the list of insurance policies available to a patient.

Insurance tab showing the list of insurance policies for a patient

Adding Insurance to a Patient

  1. Click the Add Insurance button in the top right corner.

    Add Insurance button in the top right corner of the Insurance tab

  2. A new window will appear for you to enter the insurance details for a patient. Fill out all the fields in the form to enable the save button.

    Empty insurance details modal with form fields to fill in

Policies will be considered expired from the start of the day specified in the Expiry date field
  1. After filling out the form, click the Save button. Your newly created insurance will show in the list, and a confirmation message will appear.

    Success confirmation message after adding insurance policy

  2. If you forget to fill out a section of the form, the system will alert you and the details won't be saved.

    Error alert shown when insurance form is submitted with missing required fields

Editing Insurance Information

  1. To edit an existing insurance, ensure that you are on the insurance tab of a patient. Click on one of the available insurances.

    Clicking an insurance row in the patient insurance list to open it for editing

  2. A familiar window will appear, allowing you to edit the insurance details of a patient.

    Insurance details modal pre-filled with existing policy information

  3. Update the insurance information as needed.

    Insurance edit modal showing updated fields ready to be saved

  4. Once done with the updates, click the Save button. When successful, a confirmation message will appear, and your changes will be reflected immediately.

    Success confirmation message after saving updated insurance information