# Manual for Paperless Software Packages

Manual reusable chapters.

# Chapter 01 : Introduction

# Chapter 02 : Object Management Pages (OMPs)

# What is an Object Management Page (OMP)?

An Object Management Page (OMP) is a key component of our software that allows users to perform various operations on specific types of objects within the system. These operations typically include creating, updating, and deleting objects.

#### Key Features of an OMP

Creation : An OMP provides a user-friendly interface for creating new objects in the system. This usually involves filling out a form with the necessary details about the object.

Updating : OMPs allow users to modify existing objects. This could involve changing the values of certain attributes, adding new information, or even changing the status of the object.

Deletion : If an object is no longer needed, OMPs provide a straightforward way for users to remove these objects from the system.

#### Common Elements of an OMP

While the specific layout and features of an OMP can vary depending on the type of object it manages, most OMPs share some common elements:

Navigation Menu: This allows users to switch between different sections of the OMP, such as the creation form, the update form, or the deletion form.

Form Fields: These are where users input the data for the object. The number and type of fields will depend on the attributes of the object.

Action Buttons: These buttons trigger actions such as “Save”, “Update”, or “Delete”.

Feedback Messages: After an action is performed, the OMP will display a message informing the user whether the action was successful or not.

In conclusion, an Object Management Page (OMP) is a crucial part of our software that enables users to manage the lifecycle of objects within the system. By understanding how to use an OMP, users can effectively interact with and manipulate the objects in the system.

# Guide to page sections for Object Management Pages (OMPs).

<span id="bkmrk_omp_page_sections_01">
<p>An Object Management Page (OMP) has 4 main sections : </p>
  <ul>
  <li>{{@40#bkmrk_page_section_toolbar}}</li>
  <li>{{@40#bkmrk_page_section_blue_ribbon_omp}}</li>
  <li>{{@40#bkmrk_page_section_table_omp}}</li>
  <li>{{@40#bkmrk_page_section_form_omp}}</li>
</ul>

# Pathways to pages: How to open the most frequently used OMPs.

The homepage features a menu bar positioned at the top. This menu bar provides access to various Object Management Pages (OMPs). To navigate to an OMP, click on the relevant top-level menu item. This action will reveal a dropdown menu, where most OMPs are listed as second-level menu items.

Below is a table with three columns for easy navigation:

- **Column 1**: Displays the label of the top-level menu item visible on the menu.
- **Column 2**: Shows the label of the second-level menu item that opens an OMP. Please note that this column does not list every item in the dropdown, but only those that lead to OMPs.
- **Column 3**: Lists common reasons for opening the corresponding OMP. Please note that the basic operations such as creating and deleting objects for the OMP will not be listed for any row as these are the most fundamental and obvious uses of an OMP.

This table serves as a quick reference guide to the most frequently used OMPs and their access points from the menu.

<table border="1" id="bkmrk-%C2%A0-currencies-and-ban" style="border-collapse: collapse; width: 100%; height: 724.828px;"><colgroup><col style="width: 21.3349%;"></col><col style="width: 19.6683%;"></col><col style="width: 58.9968%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Top-level menu labels**</td><td style="height: 29.7969px;">**Second-level**</td><td style="height: 29.7969px;">**Most common reasons for opening the OMP**</td></tr><tr style="height: 35.3906px;"><td style="height: 35.3906px;">Currencies and banking</td><td style="height: 35.3906px;">Currencies</td><td style="height: 35.3906px;">Updating the exchange rate for a currency.

</td></tr><tr style="height: 57.7812px;"><td style="height: 57.7812px;">  
</td><td style="height: 57.7812px;">Banking details</td><td style="height: 57.7812px;">Enabling or disabling a set of banking details so as to include or exclude them from a document (i.e. quotation, invoice).

</td></tr><tr style="height: 57.7812px;"><td style="height: 57.7812px;">Employees</td><td style="height: 57.7812px;">Employees</td><td style="height: 57.7812px;">Updating the password for a user/employee who may have forgotten their login credentials.

</td></tr><tr style="height: 35.3906px;"><td style="height: 35.3906px;">Form settings</td><td style="height: 35.3906px;">Forms</td><td style="height: 35.3906px;"></td></tr><tr style="height: 11.3906px;"><td style="height: 11.3906px;">  
</td><td style="height: 11.3906px;">Form inputs</td><td style="height: 11.3906px;">Enabling or disabling an input from a form.

</td></tr><tr style="height: 35.3906px;"><td style="height: 35.3906px;">  
</td><td style="height: 35.3906px;">Form input elements</td><td style="height: 35.3906px;"></td></tr><tr style="height: 35.3906px;"><td style="height: 35.3906px;">Inventory</td><td style="height: 35.3906px;">Inventory items</td><td style="height: 35.3906px;">Updating the sales price for any inventory item.

</td></tr><tr style="height: 35.3906px;"><td style="height: 35.3906px;">  
</td><td style="height: 35.3906px;">Inv. item categories</td><td style="height: 35.3906px;"></td></tr><tr style="height: 35.3906px;"><td style="height: 35.3906px;">Services</td><td style="height: 35.3906px;">Services</td><td style="height: 35.3906px;">Updating the sales prices for any service.

</td></tr><tr style="height: 35.3906px;"><td style="height: 35.3906px;">  
</td><td style="height: 35.3906px;">Serv. categories</td><td style="height: 35.3906px;"></td></tr><tr style="height: 35.3906px;"><td style="height: 35.3906px;">Partners</td><td style="height: 35.3906px;">Corporates</td><td style="height: 35.3906px;">To view the statement for a particular corporate.

</td></tr><tr style="height: 35.3906px;"><td style="height: 35.3906px;">  
</td><td style="height: 35.3906px;">Referrers</td><td style="height: 35.3906px;"></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">Suppliers</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 35.3906px;"><td style="height: 35.3906px;">Accounts</td><td style="height: 35.3906px;">GL accounts list</td><td style="height: 35.3906px;"></td></tr><tr style="height: 35.3906px;"><td style="height: 35.3906px;">Medical aid</td><td style="height: 35.3906px;">Claims</td><td style="height: 35.3906px;">To submit a batch of claims online.

</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">Claim invoices</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">Society claim amounts</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">Society shortfalls</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">Society claim limits</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">  
</td><td style="height: 29.7969px;">Medical disciplines</td><td style="height: 29.7969px;">  
</td></tr></tbody></table>

# Pathways to pages: How to open the technical support OMPs.

There exists a unique set of Object Management Pages (OMPs) that are exclusively accessible to members of the technical support team. These pages can be accessed via the menu bar. To navigate to these pages, click on the **Preferences** item in the top-level menu. This action will reveal a dropdown menu, which includes an option labeled **Tech Support Tools**. Upon selecting Tech Support Tools, another dropdown will appear, from which you need to select **Tech Support Tables**. This final step will display a list of the technical support OMPs.

The table below provides a guide to these special OMPs. It consists of two columns:

- **Column 1**: Displays the label of the technical support OMP listed in the dropdown that appears after clicking *Preferences*, then *Tech Support Tools*, and finally *Tech Support Tables*.
- **Column 2**: Lists common reasons for opening the corresponding OMP. Please note that the basic operations such as creating and deleting objects for the OMP will not be listed for any row as these are the most fundamental and obvious uses of an OMP.

This table serves as a quick reference guide for technical support staff to navigate to their exclusive OMPs. Remember, the pathway to these OMPs is: **Preferences &gt; Tech Support Tools &gt; Tech Support Tables**.

<table border="1" id="bkmrk-%C2%A0-currencies-and-ban" style="border-collapse: collapse; width: 100%; height: 688.579px;"><colgroup><col style="width: 26.5793%;"></col><col style="width: 73.4207%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Technical support OMPs**</td><td style="height: 29.7969px;">**Common reasons for opening the OMP**</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Consultation forms</td><td style="height: 29.7969px;"> </td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Consumable tariff groups

</td><td style="height: 29.7969px;"> </td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Medical aid societies

</td><td style="height: 29.7969px;"> </td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Med aid society groups

</td><td style="height: 29.7969px;"> </td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Patients page settings</td><td style="height: 29.7969px;"> </td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Payment buttons</td><td style="height: 29.7969px;"> </td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Scheduled X items</td><td style="height: 29.7969px;"> </td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Stamps</td><td style="height: 29.7969px;"> </td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Standard vitals</td><td style="height: 29.7969px;"> </td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Storerooms</td><td style="height: 29.7969px;"> </td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Terminal settings</td><td style="height: 29.7969px;"> </td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Wards</td><td style="height: 29.7969px;"> </td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">X Item templates</td><td style="height: 29.7969px;"> </td></tr></tbody></table>

# Adding a new object (Add toolbar button).

{{@4#bkmrk\_omp\_before\_proceeding\_01}}

{{@4#bkmrk\_omp\_toolbar\_01}}

Instructions :

- {{@4#bkmrk\_omp\_page\_open\_01}}
- {{@4#bkmrk\_omp\_add\_click\_01}} Add toolbar button. {{@4#bkmrk\_omp\_toolbar\_level3}}
- {{@4#bkmrk\_omp\_inputs\_navigation\_01}}
- {{@4#bkmrk\_omp\_inputs\_navigation\_02}}

# Search to selection: How to find and choose an object within an OMP.

{{@4#bkmrk\_omp\_before\_proceeding\_01}}

Instructions :

1. {{@4#bkmrk\_omp\_page\_open\_01}}
2. {{@4#bkmrk\_omp\_object\_search\_01}}
3. {{@4#bkmrk\_omp\_object\_search\_02}}

# Updating/editing an object (Edit toolbar button).

{{@4#bkmrk\_omp\_before\_proceeding\_01}}

{{@4#bkmrk\_omp\_toolbar\_01}}

Instructions :

- {{@4#bkmrk\_omp\_page\_open\_01}}
- {{@4#bkmrk\_omp\_find\_and\_select}}
- {{@4#bkmrk\_omp\_once\_focused}} click the Edit toolbar button. {{@4#bkmrk\_omp\_toolbar\_level3}}
- {{@4#bkmrk\_omp\_inputs\_navigation\_01}}
- {{@4#bkmrk\_omp\_inputs\_navigation\_02}}

# Deleting an object (Delete toolbar button).

{{@4#bkmrk\_omp\_before\_proceeding\_01}}

{{@4#bkmrk\_omp\_toolbar\_01}}

Instructions :

- {{@4#bkmrk\_omp\_page\_open\_01}}
- {{@4#bkmrk\_omp\_find\_and\_select}}
- {{@4#bkmrk\_omp\_once\_focused}} click the Delete toolbar button.
- {{@4#bkmrk\_omp\_prompt\_01}} delete the object. {{@4#bkmrk\_omp\_prompt\_02}} {{@4#bkmrk\_omp\_toolbar\_level1}}
- Once an object is deleted, you have the option to get in touch with technical support for its recovery, if needed.

# Restoring a deleted object (Show toolbar button).

{{@4#bkmrk\_omp\_before\_proceeding\_01}}

{{@4#bkmrk\_omp\_toolbar\_01}}

Instructions :

- {{@4#bkmrk\_omp\_page\_open\_01}}
- {{@4#bkmrk\_omp\_find\_and\_select}}
- {{@4#bkmrk\_omp\_once\_focused}} click the Show toolbar button.
- {{@4#bkmrk\_omp\_prompt\_01}} restore the object. {{@4#bkmrk\_omp\_prompt\_02}} {{@4#bkmrk\_omp\_toolbar\_level1}}

# Chapter 03 : Patients page

Chapter 01 : Patients page.

# How to open the Patients page.

Instructions :

1. {{@5#bkmrk\_open\_homepage}}
2. From the homepage, click the Patients toolbar button.

# Adding a new patient to the system.

If a patient is not already saved in the system, follow the following steps in this page to add them to the system.

{{@4#bkmrk\_omp\_before\_proceeding\_01}}

Instructions :

1. {{@3#bkmrk\_patient\_page\_open}}
2. {{@4#bkmrk\_omp\_add\_click\_02}} New Patient toolbar button {{@4#bkmrk\_omp\_add\_click\_03}}
3. {{@4#bkmrk\_omp\_inputs\_navigation\_01}}
4. {{@4#bkmrk\_omp\_inputs\_navigation\_02}}

# Search to selection: How to find and choose a patient.

Many patient functions rely on first selecting a particular patient on which an action is to be applied.

{{@4#bkmrk\_omp\_before\_proceeding\_01}}

Instructions :

1. {{@3#bkmrk\_patient\_page\_open}}
2. {{@3#bkmrk\_patient\_search\_01}}
3. {{@4#bkmrk\_omp\_object\_search\_02}}

# Update patient information.

This page is all about updating patient information.

{{@4#bkmrk\_omp\_before\_proceeding\_01}}

Instructions :

1. {{@3#bkmrk\_patient\_find\_and\_select}}
2. {{@3#bkmrk\_patient\_once\_focused}} click the Edit toolbar button. {{@4#bkmrk\_omp\_toolbar\_level3}}
3. {{@4#bkmrk\_omp\_inputs\_navigation\_01}}
4. {{@4#bkmrk\_omp\_inputs\_navigation\_02}}

# How to create a consultation (or an admission).

{{@18#bkmrk\_consultations\_and\_admissions\_02}}

{{@4#bkmrk\_omp\_before\_proceeding\_01}}

Instructions :

1. {{@3#bkmrk\_patient\_find\_and\_select}}
2. {{@3#bkmrk\_patient\_once\_focused}} click the Consultation toolbar button to create a consultation (or the Admission toolbar button to create an admission). These buttons are only visible after you have found and selected a particular patient.
3. {{@3#bkmrk\_patient\_option\_buttons\_01}}
4. {{@5#bkmrk\_multiple\_practices\_selector}}
5. **Payment page :** {{@12#bkmrk\_payment\_setting\_01}} {{@12#bkmrk\_payment\_intro}} {{@12#bkmrk\_payment\_summary\_01}}{{@12#bkmrk\_payment\_more\_info}}

# Capturing billable items (from the Patients page).

{{@11#bkmrk\_xitems\_bitems\_descr}}

{{@4#bkmrk\_omp\_before\_proceeding\_01}}

<p class="callout warning">If the patient has an active consultation/admission it is best to capture the billable items from within their consultation.  
The only reason to capture billable items from the Patients page would be if that particular patient does not have an ongoing consultation e.g. When patients buy birth control pills without having to consult a doctor.</p>

1. {{@3#bkmrk\_patient\_find\_and\_select}}
2. {{@3#bkmrk\_patient\_once\_focused}} click the Billable Items toolbar button to open the Billable Items page.
3. {{@5#bkmrk\_multiple\_practices\_selector}}
4. {{@11#bkmrk\_xitems\_inputs\_01}}
5. {{@11#bkmrk\_xitems\_inputs\_02}}
6. {{@11#bkmrk\_xitems\_btn\_add\_01}}
7. {{@11#bkmrk\_xitems\_btn\_list\_01}}
8. {{@11#bkmrk\_xitems\_btn\_save\_01}}
9. {{@11#bkmrk\_xitems\_btn\_process\_01}}

# How to create an appointment (from the Patients page).

<p id="bkmrk_appointment_creation_intro">An appointment can be created from the Patients page, or from within the Consultation page.</p>
<p>{{@4#bkmrk_omp_before_proceeding_01}}</p>
<p>Instructions :</p>
<ol>
<li>{{@3#bkmrk_patient_find_and_select}}</li>
<li>{{@3#bkmrk_patient_more_01}}</li>
<span id="bkmrk_appointment_creation_instructions">
<li>Open the Appointment page by clicking the Appointment toolbar button.</li>
<li>Enter the patient’s name in the first input field.</li>
<li>Select a doctor from the second input field, the doctor selector.</li>
<li>Set the appointment’s start time using the date and time input, which is the last input field in the Appointment page.</li>
<li>Click the Save toolbar button to save the appointment.</li>
<li>To view the list of scheduled appointments, go to the homepage and do one of the following :
<ul>
<li>Click the Calendar button on the toolbar.</li>
<li>Or, use the compact table at the bottom of the homepage to scroll through upcoming appointments. The appointments are listed in chronological order, with the one starting next at the top.</li>
</span>
</ul>
</li>
</ol>
<p></p>
<p></p>
<p></p>

# Attaching files/documents (e.g. lab results, pdfs, images).

The system supports saving files in the following formats: PDF, PNG, JPG.

Instructions :

1. {{@3#bkmrk\_patient\_find\_and\_select}}
2. {{@3#bkmrk\_patient\_more\_01}}
3. Click the Attachment toolbar button to open the Attachments page.
4. Click on the file selector input (first input) in the Attachments page. This will open a file explorer window where you can choose one or more files. After making your selection, click ‘Done’ to close the file explorer and return to the Attachments page.
5. Next, on the Attachments page, use the date-time input to set the posting time for the attachments.
6. Click the Next toolbar button to save the attachment(s).

# How to view the timeline of a patient.

The timeline of a patient shows consultations, attached files and completed forms in chronological order. To view the timeline do the following :

1. {{@3#bkmrk\_patient\_find\_and\_select}}
2. {{@3#bkmrk\_patient\_once\_focused}} click the More toolbar button.
3. After the toolbar level moves to level 3, click the Timeline toolbar button.
4. Click any event to view it in detail.

# View a patient's statement (from the Patients page).

Paperless allows for the assigning of credit to patients. To view a patient's statement follow the following instructions :

1. {{@3#bkmrk\_patient\_find\_and\_select}}
2. {{@3#bkmrk\_patient\_once\_focused}} click the More toolbar button.
3. After the toolbar level moves to level 3, click the Statement toolbar button.
4.

# Chapter 04 : Consultation page

Consultation page.

# How to open a consultation.

{{@18#bkmrk\_consultations\_and\_admissions\_02}}

Instructions :

1. {{@18#bkmrk\_consultation\_page\_open}}
2. When you click on a consultation from the **completed** or **discharged** tables, it will open in the Previous Consultation page instead of the usual Consultation page. To switch to the standard Consultation page view, scroll down to the bottom of the Previous Consultation page and hit the **Edit button**. The presence of the Edit button at the bottom signifies that the consultation was either completed or discharged in the past 48 hours.

# Guide to consultation statuses.

{{@18#bkmrk\_consultations\_and\_admissions\_01}}

A consultation can have one of the following statuses at any given time :

{{@18#bkmrk\_consultation\_status\_01}}

# How to navigate the Consultation page.

{{@18#bkmrk_consultations_and_admissions_01}}
<span id="bkmrk_consultation_page_sections_01">
<p>The Consulation page has 3 main sections : </p>
<ul>
  <li>{{@40#bkmrk_page_section_toolbar}}</li>
  <li>{{@40#bkmrk_page_section_blue_ribbon_consultation}}</li>
  <li>{{@40#bkmrk_page_section_interactive_space_consultation}}</li>
</ul>

<p>The consultation page offers the flexibility to capture consultation data via keyboard typing or through a writing pad for handwritten entries. The system features a setting that can either activate or deactivate the writing pad, depending on the user’s preference. It’s important to note that not all computers possess the required hardware to support input through a writing pad. For additional details on how to enable or disable the writing pad input for the Interactive Space views, please click here.</p>
<p>Many doctors favor the use of writing pads over keyboards for data capture, finding it more intuitive and convenient. This method also facilitates maintaining eye contact with patients, enhancing the personal touch during consultations. The <strong>Interactive space</strong> is designed to capture various types of consultation data, either through keyboard typing or using hand written notes via a writing pad. The types of consultation data captured using these methods include:</p>
<ul>
<li><strong>Comments</strong> which consist of non-confidential information accessible to a broad range of hospital/clinic staff, such as nurses and nurse aides, and may include details like treatment instructions.</li>
<li><strong>Notes,</strong> on the other hand, contain sensitive information exclusively available to doctors. Any staff member not designated as a doctor in their employee role cannot access these notes.</li>
<li><strong>Prescriptions</strong> pertain to medication-related information and can be printed on official documents bearing the medical practice’s letterhead.</li>
</ul>

<p>In the consultation page, the <strong>Interactive space</strong> features four distinct views, with navigation between them being facilitated by buttons located in the Blue ribbon section. At any given time, only one view is visible in the Interactive space. By clicking a button in the Blue ribbon, users can switch between different views within the Interactive space.</p>

<p>Here is a list of <strong>Blue ribbon buttons,</strong> and the views which they activate when they are clicked.</p>

<ul>
<li><strong>Dashboard :</strong> This is the view displayed by default on opening a consultation page. It displays patient information, a summary of the captured vitals (e.g. temperature, blood pressure), and the five most recent timeline events (i.e. How to view a patient's historic data (i.e. previous consultations, previous admissions, attachments and forms).). The comments keyboard input is also part of the dashboard view.</li>
<li><strong>Timeline :</strong> This view is dedicated to displaying both historical and recently saved patient consultation data, divided into two main sections: recent data and historical events. <span id="bkmrk_consultation_timeline_01">The <strong>recent data</strong> section of the timeline view appears at the top and enumerates data gathered during that particular consultation, including comments, notes, and prescriptions, whether hand written or typed. Each piece of data is accompanied by a timestamp, indicating the employee who recorded the data and the time it was saved.</span> <span id="bkmrk_consultation_timeline_02">The <strong>historical data</strong> section, located at the bottom of the same view, catalogs all events for that particular patient who is being consulted. This includes past consultations, admissions, attachments, and forms, providing a comprehensive historical record.</span></li>
<li><strong>Keyboard inputs :</strong> This view contains the three (3) separate inputs for capturing comments, notes and prescriptions via keyboard typing. This blue ribbon button (and the corresponding view) is not visible when a consultation is in <strong>pending</strong> status.</li>
<li><strong>Writting pads (3 buttons) :</strong> Located on the extreme right of the Blue ribbon, you will find three (3) distinct buttons, each dedicated to a writing pad. These writing pad buttons are labeled according to their corresponding consultation data types: comments, notes, and prescriptions. Clicking on any of these three (3) buttons opens the respective writing pad, allowing for the capture of handwritten notes. For additional guidance on navigating the writing pad and utilizing its various tools, please click here.  These blue ribbon buttons (and their corresponding views) are not visible when a consultation is in <strong>pending</strong> status.</li>
</ul>
</span>

# How to cancel a consultation.

{{@18#bkmrk\_consultation\_before\_proceeding\_01}}

Consultations exist in the following statuses :

{{@18#bkmrk\_consultation\_status\_01}}

Only **pending** consultations can be cancelled.

Instructions :

1. {{@18#bkmrk\_consultation\_page\_open}}
2. Click the Cancel cons. toolbar button.
3. {{@18#bkmrk\_consultation\_prompt\_03}} cancel the consultation. {{@18#bkmrk\_consultation\_prompt\_04}}

# How to capture consultation vitals.

Instructions :

1. {{@18#bkmrk\_consultation\_page\_open}}
2. Click the Vitals toolbar button to open the Vitals page.
3. Once the Vitals page is open, fill in any relevant vitals information.
4. Click the Save footer button in the Vitals page to complete the process.

# Capturing billable items (within the Consultation page).

{{@18#bkmrk\_consultations\_and\_admissions\_01}}

{{@11#bkmrk\_xitems\_bitems\_descr}}

1. {{@18#bkmrk\_consultation\_page\_open}}
2. Click the Billable Items toolbar button to open the Billable Items page.
3. {{@5#bkmrk\_multiple\_practices\_selector}}
4. {{@11#bkmrk\_xitems\_inputs\_01}}
5. {{@11#bkmrk\_xitems\_inputs\_02}}
6. {{@11#bkmrk\_xitems\_btn\_add\_01}}
7. {{@11#bkmrk\_xitems\_btn\_list\_01}}
8. {{@11#bkmrk\_xitems\_btn\_save\_01}}
9. {{@11#bkmrk\_xitems\_btn\_process\_01}}

# How to view historic data (i.e. consultations, admissions, attachments and forms).

{{@18#bkmrk\_consultation\_before\_proceeding\_01}}

Doctors find it beneficial to review a patient’s history as it guides the optimal treatment plan. The most efficient method to retrieve this historical data within a consultation page is through the **timeline view**. This view presents all recorded events for a specific patient, organized by year, providing a comprehensive record. Alternatively, the **dashboard view** offers a snapshot of the patient’s history, displaying only the five most recent events.

To open the **timeline view** do the following :

1. {{@18#bkmrk\_consultation\_page\_open}}
2. Click the timeline blue ribbon button.
3. {{@28#bkmrk\_consultation\_timeline\_01}}
4. {{@28#bkmrk\_consultation\_timeline\_02}}

To view the patient history via the **dashboard view** do the following :

1. {{@18#bkmrk\_consultation\_page\_open}}
2. The **dashboard view** is the default display in the Interactive space. If it is not currently visible, you can bring it into focus by clicking on the **dashboard button** in the Blue ribbon.
3. On the far right side of the dashboard view, there’s a table which provides a brief look at the patient’s past by showing the five latest events.

# How to start a consultation.

{{@18#bkmrk\_consultation\_before\_proceeding\_01}}

Consultations exist in the following statuses :

{{@18#bkmrk\_consultation\_status\_01}}

Instructions :

1. {{@18#bkmrk\_consultation\_page\_open}}
2. Click the Start toolbar button. This opens the Verify consultation Page.
3. Type any of the following variables to confirm the consultation: 
    - Consultation number
    - Patient number
    - Patient national ID
4. Click the Next footer button, or click the Enter keyboard button to submit the confirmation variable.
5. If the correct information is entered, then the consultation is updated from being in the **pending** status, to the **ongoing** status.

# Using writing pads to take capture consultation data (i.e. comments, notes and prescriptions).

<p>{{@18#bkmrk_consultation_before_proceeding_01}}</p>
<p>{{@18#bkmrk_consultation_before_proceeding_02}}</p>
{{@18#bkmrk_consultations_and_admissions_01}}
<p>Instructions :</p>

<ol>
<li>{{@18#bkmrk_consultation_page_open}}</li>
<li>The next steps of the instructions require that the consultation be either in <strong>ongoing, completed or admitted</strong> statuses.</li>
<li>Click one of the writing pad blue ribbon buttons (i.e. comments, notes, or prescription) to open the appropriate writing pad.</li>
<li>Once the writing pad is open, write or draw on the blank canvas just as you would on paper.</li>
<li id="bkmrk_writing_pad_btns_01"><strong>Clear canvas button :</strong> The icon for this button is a trash can. When clicked, it erases all drawings or writings on the current page. If the current page is empty and there are multiple pages in the writing pad, clicking this button will remove the current page.</li>
<li id="bkmrk_writing_pad_btns_02"><strong>Ink colour selector button :</strong> This button is represented by an icon of three crayons. Upon clicking it, three color options (black, red, and blue) appear at the top center of the screen. You can select an ink color by clicking on one of these options. Once a color is chosen, the top section of the writing pad view reverts to its original state. The default ink colour is black.</li>
<li id="bkmrk_writing_pad_btns_03"><strong>Line thickness selector button :</strong> This button features an icon of a pen sketching a line. When you click it, three options for line thickness (size 1, 2, and 3) will appear at the top center of the screen. You can choose a line thickness by selecting one of these options. After a thickness is selected, the top section of the writing pad view returns to its default state. The standard line thickness is set to size 1.</li>
<li id="bkmrk_writing_pad_btns_04"><strong>Writing pad forms button :</strong> This button, represented by an icon of several sheets, reveals writing pad form options at the top center of the screen when clicked. You can choose a writing pad form from the available pre-configured forms. If there are no pre-configured forms, please reach out to technical support to have suitable forms configured in the system.</li>
<li id="bkmrk_writing_pad_btns_05"><strong>Eraser button :</strong> This button, symbolized by an eraser icon, transforms the pen tip into an eraser when clicked. To switch back to the pen tip, simply click the eraser button again.</li>
<li id="bkmrk_writing_pad_btns_06"><strong>Page navigation arrow buttons :</strong> On the bottom left of a writing pad, there is a left arrow button, and on the bottom right, a right arrow button. These buttons are for moving through the pages of the writing pad. To add a new page to the writing pad click the right arrow button while on the last writing pad page.</li>
<li id="bkmrk_writing_pad_btns_07"><strong>Save button :</strong>This button is represented by a floppy disk. After you have entered sufficient data into the writing pad, click the save button located at the upper right corner of the writing pad. This action will <strong>temporarily store</strong> your hand written data and close the writing pad, returning you to the last view you were on before opening the writing pad (such as the dashboard, timeline, or keyboard inputs views). To <strong>permanently store</strong> the data from the writing pad, you will need to <strong>click either the Save or Complete toolbar button</strong> found on the toolbar of the consultation page.</li>
<li id="bkmrk_writing_pad_btns_08"><strong>Cancel button :</strong> Located at the upper right corner of the writing pad, this button, when pressed, will erase any data previously written and close the pad, taking you back to the view you were on before you opened the writing pad.</li>
<li>{{@18#bkmrk_consultation_btn_save_or_complete}}</li>
</ol>

# Using the keyboard to take capture consultation data (i.e. comments, notes and prescriptions).

<p>{{@18#bkmrk_consultation_before_proceeding_01}}</p>
<p>{{@18#bkmrk_consultation_before_proceeding_02}}</p>
{{@18#bkmrk_consultations_and_admissions_01}}
<p>Instructions :</p>
<ol>
<li>{{@18#bkmrk_consultation_page_open}}</li>
<li>The next steps of the instructions require that the consultation be either in <strong>ongoing, completed or admitted</strong> statuses.</li>
<li>Click the <strong>keyboard inputs</strong> button in the blue ribbon, which opens the keyboard inputs view.</li>
<li>Each keyboard input (i.e. <strong>comments, notes and prescription</strong>) is labelled, allowing for the capturing of any relevant information.</li>
<li>{{@18#bkmrk_consultation_btn_save_or_complete}}</li>
</ol>

# Adding a diagnosis.

To add a diagnosis do the following :

1. {{@18#bkmrk\_consultation\_page\_open}}
2. {{@18#bkmrk\_consultation\_btn\_more}}
3. Click the Diagnosis toolbar button to open the Diagnosis page.
4. {{@5#bkmrk\_diagnosis\_page\_input\_01}}
5. {{@5#bkmrk\_diagnosis\_page\_input\_02}}
6. {{@5#bkmrk\_diagnosis\_page\_input\_03}}
7. {{@5#bkmrk\_diagnosis\_page\_btn\_add}}
8. {{@5#bkmrk\_diagnosis\_page\_btn\_next}}

# How to complete a consultation.

{{@18#bkmrk\_consultation\_before\_proceeding\_02}}

Completing a consultation changes its status from **ongoing** to **completed**.

Instructions :

1. {{@18#bkmrk\_consultation\_page\_open}}
2. Click the Complete toolbar button. Only **ongoing** or **completed** consultations can be completed. Completing an already complete consultation just saves any updates that would have been made to said consultation.
3. {{@18#bkmrk\_consultation\_prompt\_03}} complete the consultation. {{@18#bkmrk\_consultation\_prompt\_04}}

# How to discharge an admitted patient.

{{@18#bkmrk\_consultation\_before\_proceeding\_02}}

Discharging a consultation changes its status from **admitted** to **discharged**.

Instructions :

1. {{@18#bkmrk\_consultation\_page\_open}}
2. Click the Discharge toolbar button. Only **admitted** patients can be discharged. Discharging an already discharged patient just saves any updates that would have been made to the admission.
3. {{@18#bkmrk\_consultation\_prompt\_03}} discharge the patient. {{@18#bkmrk\_consultation\_prompt\_04}}

# How to create an appointment (from within the consultation page).

{{@13#bkmrk_appointment_creation_intro}}
<p>Instructions :</p>
<ol>
<li>{{@18#bkmrk_consultation_page_open}}</li>
<li>{{@18#bkmrk_consultation_btn_more}}</li>
{{@13#bkmrk_appointment_creation_instructions}}
</ol>
<p></p>
<p></p>

# Creating a referral letter.

Instructions :

1. {{@18#bkmrk\_consultation\_page\_open}}
2. {{@18#bkmrk\_consultation\_btn\_more}}
3. Click the Referral Letter toolbar button to open the Referral Letter page.
4. Enter the content of the referral letter into the provided text box located within the Referral Letter window. Please note that certain information will be automatically incorporated into the referral letter. This information will appear automatically just above the content you input into the text box : 
    - Patient full name.
    - Medical aid society (for medical aid patients)
    - Medical aid number (for medical aid patients)
    - Medical aid suffix (for medical aid patients)
    - Medical practice name and number
    - Birthdate (if specified on patient record creation)
    - Age (if the birthdate is available)
5. Click the Print toolbar button in the Referral Letter page to print and save the referral letter.
6. {{@18#bkmrk\_consultation\_prompt\_01}} saving of the referral letter. {{@18#bkmrk\_consultation\_prompt\_02}}
7. To view the referral letter, navigate to the timeline view of the refreshed consultation. This can be done by clicking the blue ribbon button labeled timeline. Once in the timeline view, you will find the referral letter at the top, as it represents the most recent event or attachment associated with the patient.
    
    <div class="main" id="bkmrk-" role="application"><div class="message"><div aria-description="" aria-label="Sent by Copilot: To view the referral letter you've created, navigate to the timeline view of the consultation. This can be done by selecting the blue ribbon button labeled 'Timeline'. Once in the timeline view, you'll find the referral letter at the top, as it represents the most recent event or attachment associated with the patient." class="content" tabindex="0"><div class="ac-container ac-adaptiveCard"><div class="ac-textBlock">  
    </div></div></div></div><div class="content footer has-bot-actions">  
    </div></div><button aria-label="Show learn more suggestions" class="rai-button" type="button"><svg viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M12 2C17.5228 2 22 6.47715 22 12C22 17.5228 17.5228 22 12 22C10.3817 22 8.81782 21.6146 7.41286 20.888L3.58704 21.9553C2.92212 22.141 2.23258 21.7525 2.04691 21.0876C1.98546 20.8676 1.98549 20.6349 2.04695 20.4151L3.11461 16.5922C2.38637 15.186 2 13.6203 2 12C2 6.47715 6.47715 2 12 2ZM12 3.5C7.30558 3.5 3.5 7.30558 3.5 12C3.5 13.4696 3.87277 14.8834 4.57303 16.1375L4.72368 16.4072L3.61096 20.3914L7.59755 19.2792L7.86709 19.4295C9.12006 20.1281 10.5322 20.5 12 20.5C16.6944 20.5 20.5 16.6944 20.5 12C20.5 7.30558 16.6944 3.5 12 3.5ZM12 15.5C12.5523 15.5 13 15.9477 13 16.5C13 17.0523 12.5523 17.5 12 17.5C11.4477 17.5 11 17.0523 11 16.5C11 15.9477 11.4477 15.5 12 15.5ZM12 6.75C13.5188 6.75 14.75 7.98122 14.75 9.5C14.75 10.5108 14.4525 11.074 13.6989 11.8586L13.5303 12.0303C12.9084 12.6522 12.75 12.9163 12.75 13.5C12.75 13.9142 12.4142 14.25 12 14.25C11.5858 14.25 11.25 13.9142 11.25 13.5C11.25 12.4892 11.5475 11.926 12.3011 11.1414L12.4697 10.9697C13.0916 10.3478 13.25 10.0837 13.25 9.5C13.25 8.80964 12.6904 8.25 12 8.25C11.3528 8.25 10.8205 8.74187 10.7565 9.37219L10.75 9.5C10.75 9.91421 10.4142 10.25 10 10.25C9.58579 10.25 9.25 9.91421 9.25 9.5C9.25 7.98122 10.4812 6.75 12 6.75Z"></path></svg></button>

# Transitioning an outpatient to an inpatient status.

{{@18#bkmrk\_consultations\_and\_admissions\_02}}

Instructions :

1. {{@18#bkmrk\_consultation\_page\_open}}
2. {{@18#bkmrk\_consultation\_btn\_more}}
3. Click the Admission toolbar button to expose the admission option buttons.
4. {{@3#bkmrk\_patient\_option\_buttons\_01}}
5. {{@5#bkmrk\_multiple\_practices\_selector}}
6. **Payment page :** {{@12#bkmrk\_payment\_setting\_01}} {{@12#bkmrk\_payment\_intro}} {{@12#bkmrk\_payment\_summary\_01}}{{@12#bkmrk\_payment\_more\_info}}

# Transferring an admitted patient from one ward to another.

{{@18#bkmrk\_consultations\_and\_admissions\_02}}

Instructions :

1. {{@18#bkmrk\_consultation\_page\_open}}
2. {{@18#bkmrk\_consultation\_btn\_more}}
3. Click the Ward Transfer toolbar button to open the Ward Selector page.
4. Search and select a ward using the input on the Ward Selector page.
5. To complete the ward transfer, click the Next toolbar button.
6. {{@18#bkmrk\_consultation\_prompt\_01}} ward transfer. {{@18#bkmrk\_consultation\_prompt\_02}}

# Chapter 05 : Claims page

# How to open the Claims page.

Instructions :

1. 1. {{@5#bkmrk\_open\_homepage}}
    2. {{@5#bkmrk\_menu\_01}} **Medical Aid** {{@5#bkmrk\_menu\_02}} **Claims**. Upon selecting the **Claim** option, the Claims page opens.

# Search to selection: How to find and choose a claim.

Many claim functions rely on first selecting a particular claim on which the action is to be applied.

{{@4#bkmrk\_omp\_before\_proceeding\_01}}

Instructions :

1. Open the Claims page. Click [here](https://docs.paperless.co.zw/link/64) for instructions on how to do that.
2. Locate a claim in the table section using the filters which are located in the Blue ribbon. You can use any of the following filters : 
    - Medical aid society group
    - Patient name
    - Practice number
    - Claim status
    - Time range  
        Following any change or modification to the filters mentioned above, the table section undergoes an update wherein claims that do not align with the search parameters are filtered out.
3. {{@4#bkmrk\_omp\_object\_search\_02}}

# Update claim information.

This page is all about updating claim information.

{{@4#bkmrk\_omp\_before\_proceeding\_01}}

Instructions :

1. Find and select a claim. Click [here](https://docs.paperless.co.zw/link/65) to find out how to do this.
2. Once focused on a particular claim, click the Edit toolbar button. {{@4#bkmrk\_omp\_toolbar\_level3}}
3. {{@4#bkmrk\_omp\_inputs\_navigation\_01}}
4. {{@4#bkmrk\_omp\_inputs\_navigation\_02}}

# Chapter 06 : Document page

# What is the Document page?

The Document Page effectively shows how well a unified design works. Despite the wide range of documents it supports, from quotations and invoices to purchase orders and stock adjustments, the creation process remains consistent. This consistency is the cornerstone of the Document Page, making it a universal tool for document creation.

Each document type, while serving a unique purpose, follows a shared creation process. This process is a three-step journey that begins with the selection of the document type. Whether you’re creating an invoice, a receipt, or a stock transfer order, the first step is always to specify the type of document you’re creating.

The next step involves selecting a party for the document. This could be a patient, a corporate, a supplier or a storeroom. This step ensures that the document is correctly associated with the right party, providing clarity and avoiding confusion.

The final step is the selection of inventory items or services to be listed in the document. This is where the specifics of the document come into play. Whether it is the products for a purchase order, the items for a stock transfer, or the services for an invoice, this step allows you to customize the document to fit your needs.

The uniformity of this process across all document types is its key attribute. Once proficiency in creating one type of document is achieved, it essentially provides the understanding to create all other types. This not only makes the user experience more straightforward but also significantly lessens the learning curve.

The Document page has the following sections.

### **The toolbar section**

The toolbar offers rapid access to frequently used operations. All toolbar buttons have an icon and a label. The icon graphically signifies the button’s function, simplifying the user’s understanding of the action triggered by clicking the button. When the page is minimised, the button label is concealed, but icons remain visible at all times.

For the document page the toolbar includes the following buttons:

#### **Print toolbar button**

By default this button is grey, which shows that it is inactive. Once one or more objects have been added to the table section of the document page, this button turns green. If it is green, and one or more required fields are blank, then one of the blank required fields is focused on. If it is green, and clicked and there are no blank required fields then the document is saved and printed. The printed document is automatically opened just after it is saved, and a copy of this pdf is saved In the correct folder in the windows explorer. To know the location of the correct folder in the windows explorer, click here.

#### **New item toolbar button or New serv. Toolbar button**

It sometimes occurs that as you are creating a document, and selecting inventory items or services for adding them to the table, a user realises that an item or service they wish to add to the document is currently not created in the database. In such instances it is useful to add that missing inventory item or service on the go.

To add a new inventory item on the go, click the New item toolbar button. To add a new service on the go, click the New serv. Toolbar button.

#### **Reprint receipt toolbar button**

Press this button to generate an A4-sized printout of a transaction receipt, which could be from a Paperless Retail or Paperless Pharmacy transaction. Upon pressing the button, a dialog box will appear, allowing you to enter the Journal Entry Number of the transaction for which you want to reprint the receipt.

#### **Refresh toolbar button**

Click this button to clear all inputs in the Document page and reset the table.

### **The blue ribbon section**

This section has several inputs which are used to define the specific characteristics of the document. It has 2 select inputs which define the document that is to be created, and the currency toggle button.

#### **<u>Blue ribbon section elements</u><u> :</u>**

#### **The document type selector**

This dropdown selector enumerates the various document types that can be generated using the document interface, which include: {{@55#bkmrk\_doc\_list\_of\_types}}

#### **The party type selector**

All documents have to have an intended external party which is defined in the document. Before selecting the specific party, first the party type has to be selected. This selector has the following options in its dropdown list: patient, corporate, supplier and storerooms.

Some combinations of document types and party types are not feasible. For example once you select the purchase order as the document type, then the only party type which can be selected is the Supplier since purchase orders are documents meant for communication between the system user and an external supplier. All other party types are greyed out in the party type selector because only the Supplier party type is applicable for a purchase order.

The party type selector selects the type in general, while the specific party object for the document (i.e. the specific supplier that is to receive a purchase order), is selected in the document variables section, specifically the "specific party selector".

#### **The currency toggling button**

This button is only visible when the selected document type (within the blue ribbon) is either an invoice or a quotation. On first opening of the document page the document currency is set to the default currency. When clicked, the currency toggling button changes the currency for the document to the next enabled currency. After a currency change, document prices (i.e. sales prices, unit costs etc.). are updated based on the particular exchange rates which are configured in the system. Continuing to click the currency toggling button cycles through the enabled currencies, even returning back to the currency that was defined by default.

### **The document variables section.**

This section is located just below the blue ribbon section. By default it is hidden. This section is only displayed when the party type selector is not blank.

#### **<u>The document variables section elements :</u>**

#### **The document number input**

Each document has a unique identifier. This identifier does not have to be a number, but it can also be a combination of letters and numbers. By default this value is not user defined, rather it is system generated. For more information on the setting which defines whether the document number is manually typed or system generated, click here.

For system generated documents different document types typically have different prefixes within the document number. Here are the prefixes according to the different document types : {{@55#bkmrk\_doc\_list\_of\_prefixes}}

#### **The specific party selector**

Much like the other document variables section elements, this selector is only visible if the party type selector in the blue ribbon is not blank. This selector is a hybrid input. For more information on how a hybrid input works, click here.

The label for the specific party selector depends on the selected party type in the blue ribbon section. This is a required input, therefore each document must have a specific party object selected.

#### **The caption input**

This input is optional. If not left blank, then the value of this input is printed as a paragraph just above the table. The purpose of this text is to highlight or describe any notable information regarding the document or transaction. For example for an invoice the tax number or the vat number for the customer may be typed as the caption.

#### **The footer input**

Much like the caption, the footer is an optional input. The text typed in the footer appears in the the document just below the table. Many users use the footer input to specify other information regarding the document. For example, within a goods received note the footer input can be used to describe any breakages or other notable occurances which occurred during the delivery.

### **The table section**

The table is used to select and list the items and services which the document is about. The table and various other buttons in close proximity to the table can be called the table section.

#### **<u>The table section elements :</u>**

#### **Table rows**

Each row in the table within the table section represents a different inventory item or service. No item or service can be selected in more than one row (i.e. there cannot be any repetition of the same item within a document). Each table row is subdivided into several columns, with each column having one input. Most column inputs are regular text inputs. The code and description columns are special and have inputs which are classified as hybrid inputs. For more information on how hybrid inputs work, click here.

Typing in the code or description hybrid inputs filters the available options (items and services) within the dropdown. Sometimes it is desirable to exclude some items or services from the options available for selection in documents. This ability to select specific inventory items or services is done by means of using categories.

There is a setting which specifies the categories of inventory items which are available for selection within a document. There is a separate setting which specifies the service categories which are available for selection within a document. For both settings if the setting is left blank, then all database inventory items or services can be selected from in composing the table section rows.

#### **Add row button**

This button is located just below the table. On clicking it, a blank row is added at the bottom of the table.

#### **Delete row button**

Located just below the table. To delete one or more table rows, first check the checkboxes to the far left of all the rows you wish to delete. After that click the delete rows buttons.

#### **Table total amount display**

Located just below the table. It is visible for most document types excluding the following : purchase order, stock transfer order and the stock transfer form. When the document currency is toggled by use of the currency toggle button in the blue ribbon, the total display is also updated to display the total in the updated document currency.

# How to open the Document page.

Instructions :

1. {{@5#bkmrk\_open\_homepage}}
2. {{@5#bkmrk\_menu\_01}} **Documents** {{@5#bkmrk\_menu\_02}} **Create**. Upon selecting the **Create** option, the Document Page opens.

# Inventory management documents (i.e. GRN, CN & ADJ).

The Goods Received Note (GRN), Credit Note (CN), and Stock Adjustment (ADJ) are all essential tools for inventory management. They each play a pivotal role in maintaining accurate stock quantities in the system. All three documents are designed to interact with the inventory and adjust quantities based on different scenarios. They provide a structured way to manage inventory, ensuring that stock levels are always up-to-date and accurate.

Within the scope of these documents, a storeroom is defined as a specific area where stock quantities are localized. Irrespective of the type of document being created, quantities are invariably adjusted in relation to a storeroom within the system. In the event that only one storeroom is defined within the system, this singular storeroom is automatically designated as the document storeroom within the document variables section. Consequently, the storeroom selector is disabled under such circumstances.

#### Goods Received Note (GRN)

The Goods Receive Note is used when new stock arrives. When a GRN is created, the quantities specified in the document are added to the existing quantities in the system. For example, if the current stock level is -10 and a GRN is created with a quantity of 8, the new stock level becomes -2. This is useful when receiving new shipments or restocking inventory.

#### Credit Note (CN)

A Credit Note, while similar to a GRN, goes a step further by generating journal ledger entries in addition to managing stock movements. The resultant journal ledger entries enable the production of a creditors age analysis report, which is instrumental in monitoring creditor aging and facilitates decision-making for payments.

#### Stock Adjustment (ADJ)

The Stock Adjustment document is used to correct or update stock levels based on physical stock counts. Instead of adding to the existing quantities like the GRN, the Stock Adjustment document replaces the existing quantities with its own figures. For instance, if the current stock level is -10 and a Stock Adjustment is made with a quantity of 8, the new stock level becomes 8. This is particularly useful for correcting stock levels or updating inventory records based on physical stock counts.

Each of these documents serves a unique purpose and understanding their differences is key to effective inventory management. They provide a comprehensive toolset for managing inventory, ensuring accuracy, and maintaining financial records.

# How to create a new document.

{{@55#bkmrk\_doc\_before\_proceeding\_01}}

The instructions that follow are applicable to the creation of **any** of the listed document types. : {{@55#bkmrk\_doc\_list\_of\_types}}

It is crucial to note that documents, once created, are **immutable**, meaning they cannot be altered or changed. However, Paperless provides a feature to **amend** a document. Amending does not imply editing the original document, but rather, it involves recalling the information from the original document and creating a new version of it. This new version, although based on the original document, is a separate entity and is assigned a unique document number, distinct from the original document’s number. Thus, the integrity of each document is preserved, ensuring accurate record-keeping.

Instructions for creating a **new document** :

1. {{@55#bkmrk\_doc\_page\_open}}
2. <span style="text-decoration: underline;">Blue ribbon section</span> : Select the desired **document type**.
3. <span style="text-decoration: underline;">Blue ribbon section</span> : Select a valid **party type** (i.e. **patient, corporate, supplier** or **storerooms**).
4. <span style="text-decoration: underline;">Document variables section</span> : If the system setting allows for manual entry of the **document number**, specify it accordingly. If the setting is configured for system-generated document numbers (as is the case by default), leave the document number input as is.
5. <span style="text-decoration: underline;">Document variables section</span> : Choose a **specific party** for the new document you are generating using the given hybrid input. The dropdown of this hybrid input only displays entities of the type determined by the party type selector in the blue ribbon section. If there is solely one entity of the chosen party type in the database, that entity will be automatically assigned as the specific party for the document, and the specific party selector will be deactivated.
6. <span style="text-decoration: underline;">Document variables section</span> : If desired, you may provide a **caption** for the document. This step is optional, and any caption specified will be displayed at the top of the document.
7. <span style="text-decoration: underline;">Document variables section</span> : If you wish, you can designate a **footer** for the document. This is not mandatory, and any footer that is designated will appear at the lower end of the document.
8. <span style="text-decoration: underline;">Table section</span> : Add one or more rows (i.e. **inventory items** or **services**) to the **table**. Depending on the type of document being created, some columns may have fields that must not be left blank. If you attempt to print a document with a blank required field, the document will not print. Instead, the system will highlight the empty field and prompt you to provide the necessary input.
9. <span style="text-decoration: underline;">Toolbar section</span> : Click the New Item toolbar button to create a new inventory item previously not in the database.
10. <span style="text-decoration: underline;">Toolbar section</span> : Click the New Serv. toolbar button to create a new service previously not in the database.
11. <span style="text-decoration: underline;">Toolbar section</span> : Click the Print toolbar button to **print the document**. If successful this action creates a new document, and this action cannot be reversed.

# How to reprint a document.

Instructions :

1. {{@5#bkmrk\_open\_homepage}}
2. {{@5#bkmrk\_menu\_01}} **Documents** {{@5#bkmrk\_menu\_02}} **Reprint**. Upon selecting the **Reprint** option the document search page opens.
3. Enter the complete document number into the search input located in the Blue Ribbon (for example, GRN-561, Q-23, INV-12, etc.).
4. To locate a document using the entered document number, select the Print Toolbar Button situated at the base of the document search page. This button will illuminate in green once a document number has been input into the search field in the Blue Ribbon.
5. When the document in question is located, it undergoes a reprinting process. By default, every instance of a document’s printing is accompanied by a timestamp reflecting the most recent printing of the document. For additional details on a system setting that governs the enabling or disabling of the timestamp on a printed document click here.

# Chapter 07 : Inventory reports

# Chapter 08 : Hospital Sales Reports

# Introduction to Hospital Sales Reports.

Sales reports are an integral component of Paperless Hospital, offering invaluable insights into the financial performance of a medical practice. These reports provide a comprehensive overview of sales activities within the hospital, including revenue generated from various services and transactions. For competent managers, sales reports serve as indispensable tools for informed decision-making and strategic planning. By analysing sales data, managers can identify trends, assess the effectiveness of marketing initiatives, and optimise resource allocation to maximise profitability and efficiency.

In addition to managers, cashiers also benefit significantly from sales reports as they fulfill their responsibilities within the hospital's retail environment. These reports enable cashiers to track daily transactions, reconcile cash registers, and identify any discrepancies or irregularities in sales activities. By leveraging their own sales reports, cashiers can ensure accuracy in financial transactions and uphold accountability in their roles.

##### **Exploring Sales Report types**

<table border="1" id="bkmrk-detailed-summarised-" style="border-collapse: collapse; width: 100.357%; height: 284px;"><colgroup><col style="width: 17.0441%;"></col><col style="width: 39.8093%;"></col><col style="width: 43.1466%;"></col></colgroup><tbody><tr><td>  
</td><td>**Detailed**</td><td>**Summarised**</td></tr><tr><td>**Comprehensive**</td><td>Provides comprehensive data for all system transactions within a specified time frame.</td><td>Summarised system wide transactions within a specified time frame.</td></tr><tr><td>**By practice number**</td><td>Allows for the analysis of transactions processed within or for a specific medical practice within a specified time frame.</td><td>Summarised data of transactions corresponding to a particular medical practice within a specified time frame.</td></tr><tr><td>**By cashier**</td><td>Gives performance insights on individual cashiers within a specified time frame.</td><td>Summary data for each cashier within a specified time frame.</td></tr><tr><td>**By attending doctor**</td><td>Provides patient utilisation patterns and the impact that a particular doctor has on revenue within a specified time frame.</td><td>Summary data for each doctor within a specified time frame.</td></tr></tbody></table>

To fully illustrate the breadth of sales reporting capabilities within the software, a grid serves as an ideal representation. This grid delineates the two main types of sales reports: detailed and summarised. Within each type, various reporting options are available, ranging from comprehensive analyses of all system transactions to isolated reports based on specific criteria such as practice number, cashier, or attending doctor. Each report can be further refined by selecting a time range, allowing users to analyse sales data within specific temporal parameters.

Sales reports focusing on transactions associated with a particular practice number, cashier, or attending doctor offer tailored insights into the performance of these entities within the hospital. By generating reports specific to a practice number, administrators can evaluate the financial contributions of individual departments or clinics, enabling targeted interventions for optimisation. Similarly, cashier-specific reports facilitate monitoring of individual performance and adherence to financial protocols. Reports segmented by attending doctor provide valuable feedback on patient utilisation patterns, enabling physicians to assess their impact on hospital revenue and patient engagement. Each of these reports can be customised to reflect transactions within a defined time frame, facilitating meaningful analysis and decision-making.

##### **Interpreting Reports for Informed Decision-Making**

Understanding how to interpret the reports generated by Paperless is paramount for effective utilisation. Notably, sales reports do not include any graphs, pie charts or other visualisations. Users are encouraged to familiarise themselves with the structure of each report, discerning the significance of every column and entry. By investing time in understanding the nuances of the reports, users can harness the full potential of the software, making informed decisions to drive operational excellence and financial success.

##### **Revenue, Assets and General Ledger Accounts**

Despite the software's robust accounting module, advanced knowledge of accounting is not required to understand sales reports. However, familiarity with key terms such as assets and general ledger accounts is beneficial. In accounting, an asset refers to anything of value owned by a person or business, while a general ledger account is a record used to sort and store a company's transactions. Notably, when sales transactions are processed, assets increase, which is reflected in the Revenue Summary Table at the top of each report. For a detailed explanation of the Revenue Summary Table, please refer to this [page.](https://docs.paperless.co.zw/link/59)

# Sections in a Hospital Sales Report.

This page details the sections of a Hospital sales report provides an in-depth examination of the report's components. Each section serves a crucial role in presenting essential information for effective financial analysis and decision-making within Paperless Hospital.


{{@61#bkmrk\_sales\_rep\_header\_section}}

{{@61#bkmrk\_sales\_rep\_title\_section}}

##### **Revenue Summary Table**

{{@61#bkmrk\_sales\_rep\_revenue\_summary\_section}}

{{@61#bkmrk\_sales\_rep\_revenue\_summary\_section\_medical\_aid}}

##### **Detailed Sales Overview Table** (exclusive to detailed sales reports)

It provides a comprehensive breakdown of every service or inventory item sold within the hospital management software. This table has several columns, each offering valuable insights into the transactions. Here is a list of the columns in the order they appear from left to right :

- **date**
- **time**
- **journal entry number** : Useful for identifying and potentially reversing specific transactions.
- **line description**
- **patient full name**
- **quantity sold**
- **sales price** : This column displays the price at which each item was sold. It is listed in the default currency of the system, which is typically USD.
- **extended sales price** : Calculated by multiplying the sales price by the quantity sold, this column represents the total revenue generated for each item. Also listed in the default system currency, which is typically USD.

Notably, sales prices are consistently listed in the default currency of the system, typically USD, ensuring uniformity across all reports regardless of the currency used in transactions.

{{@61#bkmrk\_sales\_rep\_sales\_insight\_table\_01}}

##### **Summarised Sales Overview Table** (exclusive to summarised sales reports)

It consolidates multiple instances of the sale of a specific service or item. This aggregation process condenses individual transactions into a single row, displaying the total quantity sold during the report period. As a result, transaction-specific details such as time and journal entry number are not included in this table. Instead, it features the following columns :

- **line description**
- **quantity**
- **max paid** : Particularly useful for differentiating sales prices within separate transactions for the same item, as it lists the highest sales price among these transactions in each respective row. This amount is listed in the default currency of the system, which is typically USD.
- **sales** : Provides a comprehensive overview of the total monetary value generated from the collective sales of individual items during the reporting period. Also listed in the default system currency, which is typically USD.

{{@61#bkmrk\_sales\_rep\_sales\_insight\_table\_01}}

##### <span style="text-decoration: underline;">**Comparing the total from a Sales Overview Table and Revenue Summary Data**</span>

Both Sales Overview Tables provide valuable insights into sales data. The **total** shown at the bottom of these tables represents the overall sales values recorded during the report period, all **in terms of the default currency**.

When comparing the total in a Sales Overview Table with the information in the Revenue Summary Table, it's important to consider currency conversion. While the total in a Sales Overview Table is always in the default currency, the Revenue Summary Table breaks down sales revenue by different transaction currencies. To make a fair comparison, currency values in the Revenue Summary Table need to be converted into their default currency equivalents **using the exchange rates at the time of transaction processing**.

In essence, Sales Overview Tables and the Revenue Summary Table work together to provide a comprehensive understanding of sales revenue. By combining and analyzing data from both sources, users can identify trends, make informed decisions, and improve operational efficiency and financial success.

# Accessing Hospital Sales Reports via the Menu

{{@61#bkmrk\_sales\_rep\_authorised\_empl}}

Opening sales reports via the menu grants access to all available types of sales reports in the system. For details on the types of reports, click [here](https://docs.paperless.co.zw/link/60). Alternatively, accessing sales reports via the toolbar is the quickest method, especially suitable for cashiers. However, this method only provides access to the Comprehensive sales reports. For instructions on accessing a sales report via the toolbar, click here.

{{@61#bkmrk\_sales\_rep\_pdf\_printout}}

Instructions for opening sales reports via the menu :

1. {{@5#bkmrk\_menu\_01}} **Sales Reports** item in the top-level menu. This action will reveal a dropdown menu, which lists the different types of sales report types available in the system. For details on the types of sales reports, click [here](https://docs.paperless.co.zw/link/60#bkmrk-exploring-sales-repo).
2. Select the relevant sales report type from the dropdown menu. This action will reveal another dropdown menu with two options: **Detailed** or **Summarised**. After selecting either the detailed or summarised option, the Report Parameter Selection Page will open.
3. Fill in relevant inputs on the Report Parameter Selection Page. Depending on the report type selected, additional inputs such as practice or cashier selectors may be present. Specify a time range for the sales report.
4. Once all inputs are completed, the Print Toolbar Button will become active. Click the Print Toolbar Button to generate the sales report.
5. The Report Parameter Selection Page will close, and the desired report will open for viewing. {{@61#bkmrk\_sales\_rep\_understand\_sections}}
6. If the chosen report type is comprehensive, upon opening the Sales Report, additional related reports are automatically opened. For the Comprehensive Detailed Sales Report, the following reports are opened : 1) <span style="text-decoration: underline;">Detailed Statement of Cash Flows</span>. For the Comprehensive Summarized Report, the following reports are opened : 1) <span style="text-decoration: underline;">Summarized Statement of Cash Flows</span>, 2) <span style="text-decoration: underline;">Statement of Changes</span>.

# Accessing Hospital Sales Reports via the Toolbar

{{@61#bkmrk\_sales\_rep\_authorised\_empl}}

Accessing sales reports through the toolbar offers the fastest route, particularly convenient for cashiers. However, it's worth noting that this method exclusively grants access to the Comprehensive sales reports. An alternative approach is accessing sales reports via the menu, which offers access to all available types of sales reports. For detailed instructions on accessing sales reports via the menu, click [here](https://docs.paperless.co.zw/link/62).

{{@61#bkmrk\_sales\_rep\_pdf\_printout}}

Instructions for opening sales reports via the toolbar :

1. Start from the homepage and click on the Report Toolbar Button. This action will open the Quick Time Range Selector.
2. **Using the Quick Time Range Selector** : The Quick Time Range Selector is a tool designed for swiftly choosing a specific time range. It provides a list of pre-set time ranges and an option for selecting a custom time range. By default, the only pre-set time range is 'Today', which covers the entire day from 00:00hrs to 23:59hrs. If you wish to select a custom time range, click on 'Custom', which will lead you to the Time Range Selection page. If you have a specific time range that you frequently use and would like it to be included in this list, please inform our technical support team.
3. **Selecting a Custom Time Range** : Skip this instruction if you selected a pre-set time range in the Quick Time Range Selector. The Time Range Selection page allows you to specify a unique time range for the report. This involves selecting a start time (referred to as 'From Time') and an end time (referred to as 'To Time'). To select the 'From Time', click on the corresponding input field and a date-time selector will appear. Choose the desired date and time. Repeat the process for the 'To Time'. After both times have been selected, click the Next Toolbar Button at the bottom of the page.
4. **Choosing the Report Type** : Once a time range has been specified, the next step is to select the type of report you wish to generate. Two options are available: 'Comprehensive Detailed Report' and 'Comprehensive Summarised Report'. These options will be presented in a prompt window from which you can make your selection.
5. **Viewing the Report** : After the report type has been selected, the report will be generated and displayed for your review.
6. Upon opening of the report, additional related reports are automatically opened. For the Comprehensive Detailed Sales Report, the following reports are opened : 1) <span style="text-decoration: underline;">Detailed Statement of Cash Flows</span>. For the Comprehensive Summarized Report, the following reports are opened : 1) <span style="text-decoration: underline;">Summarized Statement of Cash Flows</span>, 2) <span style="text-decoration: underline;">Statement of Changes</span>.

# Chapter 09 : Settings

# Business

##### Business name

{{@73#bkmrk\_settings\_license\_inputs}}

##### Business address

{{@73#bkmrk\_settings\_license\_inputs}}

##### BP number

##### Phone number 1

##### Phone number 2

##### Default prac. number

##### Member lookup prac. number

##### Member verification prac. numbers

# General

##### Autofill document numbers

##### OMP table search trigger

# Inventory

##### Sales storeroom ({{@73#bkmrk\_settings\_xItemsLabel}})

##### Sales storeroom (Retail page)

##### Documents default storeroom

##### Inv. items displayed categories ({{@73#bkmrk\_settings\_xItemsLabel}})

##### Inv. items displayed categories (Retail page)

##### Inv. items displayed categories (Document page)

##### Inv. items default markup percentage

##### New inventory item form

##### Sell into negative

##### Sell expired inventory items

##### Expiry/batch info. (default)

##### Expiry/batch info. \[Inventory items page\] (visibility)

##### Inventory claim type input \[Inventory items page\] (visibility)

##### Price list setting (default)

##### Price list setting input \[Inventory items page\] (visibility)

##### Inv. items default tax status

##### Inv. items tax status input (visibility)

##### Inv. items pack size input (visibility)

##### Inv. items tax percentage

# Services

##### Services displayed categories ({{@73#bkmrk\_settings\_xItemsLabel}})


##### Services displayed categories (Document page)

##### Services default tax status

##### Services tax status input (visibility)

##### Services tax percentage

# Billable items page or Scripts page

##### Sales price input (editability)

##### Notes input (visibility)

##### Outstanding repeats input (visibility)

##### Supply days input (visibility)

##### Create claim checkbox

##### Create claim checkbox default val.

##### Claim processing sequence (Delayed or Preprocess or Postprocess)

# Claim settings

##### Retrieve saved claim amount

##### Update saved claim amount

##### Retrieve tariff codes

##### Update tariff codes

##### Submit inventory item claims as: (Services or Consumables or Consumables (grouped))

##### Services default section type

##### Auto submit button

##### Web submit button

##### Web submission society groups

##### Web submit portal status

##### Merge claims (unbilled &amp; authorised claims)

##### Claim amounts multiplied by quantities

##### Claim amounts equivalent to sales prices

# Claim inputs

##### Referrer input (visibility)

##### Referrer input

##### Tariff code input (visibility)

##### Tariff code input (editability)

##### Authorisation num. input

##### Authorisation date. input

##### Lab request num. input

##### Dental lab inputs

##### Tooth dental inputs

##### Section type input

# Network

##### Network configuration

##### Server finder (automated)

##### Server IP address

##### Port

# Sales

##### Is a point of sale

##### Multi-currency transactions

##### Credit payments

##### Fiscal tax invoice submission

##### Transaction notes textarea

# Printing

##### Report file types

##### Receipt printer

##### Drug label printer

##### Claim invoice printer

##### Raw printer driver

##### Report time stamp

##### Claim invoices banking details (BDs)

##### Document header

##### Doc. header image

##### Receipt header

##### Receipt header image

##### Receipt font A columns

##### Receipt font B columns

##### Drug label font A columns

##### Drug label font B columns

##### Drug label row 4 (Employee info.)

##### Drug label row 5 (Batch info.)

##### Drug label row 6 (Pharmacy name)

##### Drug label row 7 (Pharmacy addr.)

##### Drug label row 8

# Patients

##### Med. aid membership checks

##### Biometric verification

##### Patients page view

##### New patient form

##### Pat. number input (editability)

##### Pat. number suggestions

##### Pat. referrer is required

##### Pat. cred. status default

##### Pat. cred. limit default

##### Default referring Practice

# Pharmacy

##### Select a prescr. before creating a script

##### Dispensing fee checkbox (visibility)

##### Dispensing fee checkbox default status

##### Inv. item categories without disp. fees ({{@73#bkmrk\_settings\_xItemsLabel}})  


##### Dispensing fee

##### Inv. item categories without drug labels ({{@73#bkmrk\_settings\_xItemsLabel}})

##### Default diagnosis

# Consultations

##### Auto-start consultations

##### Consultation flag

##### Writing pad

##### Diagnoses required for cons.

# Communication

##### WhatsApp Access token

##### WhatsApp Phone number ID

##### Emails API key