Difference between revisions of "Pharmacy Dispensary Module"

From OpenEMR Project Wiki
 
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
This is for in-house prescription dispensing.
==About the Pharmacy Dispensary Module==


The Pharmacy Dispensary Module manages in-house prescription dispensing and also the inventory of in-house medications and other healthcare supplies.


If the Pharmacy Dispensary Module has not been turned on yet, then follow the instructions [[Pharmacy Dispensary Module Configuration|HERE]] first.
If you have signed up for 3d party eRx solutions such as weno or NewCrop, those services may over-ride OpenEMR's native Prescription and Medication modules' activities.  For example, with NewCrop activated, if you attempt to enter a medication or allergy, NewCrop is automatically invoked. However, that can be worked around using the Charges Panel to order an inventory product for an individual patient.


==Activate Pharmacy Dispensary Module==


These instructions include some quick OpenEMR screenshots (note these were taken from version 2.8.3 with the Traditional View) to get an idea of how to administer and use the Pharmacy Dispensary Module.
The Pharmacy Dispensary Module must be activated before it can be used.


1. In left Navigation menu select: Administration/ Globals


:First, we will show how to administer the Pharmacy Dispensary.  Log into OpenEMR, and click to go to Administration menu (screenshot below, which was taken from Traditional View).
[[File:Pd-00-0-turnDispOn.png|center]]
[[File:Pharmacy-Dispensary-1.jpg|link=]]




:In the Administration menu, click 'Drugs' (screenshot below).
[[File:Pharmacy-Dispensary-2.jpg|link=]]


2. Edit Global Settings page appears; select the Features Tab.


:Click 'Add Drug' (screenshot below). This is where you will input drugs, quantity, etc.
3. Next to item "Drugs and Products" select from the dropdown menu the appropriate setting.
[[File:Pharmacy-Dispensary-3.jpg|link=]]


4. Click "Save" button at bottom of that screen.


:Secondly, we will show what changes clinicians will see with the pharmacy dispensary module.  Open up a patient record and click on 'Add Prescription' (below screenshot taken in Traditional view).
[[File:Pd-00-1-save.png|center]]
[[File:Pharmacy-Dispensary-4.jpg|link=]]




:The screenshot below circles in red the things that are part of the pharmacy dispensary.  Note that in OpenEMR 3.0.0 the 'Prescribe and Dispense' button is now 'Save and Dispense'.
[[File:Pharmacy-Dispensary-5.jpg|link=]]


:*When the Pharmacy Dispensary Module is activated, the Inventory menu item appears in left Navigation menu.


[[Category:User Guide 4.1.2]][[Category:User Guide 4.1.1]][[Category:User Guide 4.1.0]][[Category:User Guide]]
==Add Medications to Dispensary==
 
1. To display "Add Drug" screen, In left Navigation menu select: Inventory/ Management
:* Pharmacy medications and and whatever supplies have been logged in to the Dispensary are displayed here.  Click on the item "Name" to edit its entry.
 
[[File:Pd-01-addDrug.png|center]]
 
 
 
2. Click button "Add Drug" to add a new medication or Dispensary supply
 
[[File:Pd-02-1-AddNewDrugPanel.png|center]]
 
 
 
3. Enter appropriate information in "Add New Drug" panel.
:* To remove an item from the Dispensary click the "Delete" button at bottom of panel.
:* The contents of the dropdown lists "Form", "Units", "Route" and "Interval" may be edited in the Edit Lists module.  In left Navigation menu select: Administration/ Lists.
:Edit these lists:
::Drug Forms
::Drug Intervals
::Drug Routes
::Drug Units
 
:*A particular drug will not appear in the Prescription Module as a part of the In-House formulary unless the '''Templates''' section has been completed.
::'''''See page [[Using_OpenEMR_Inventory-Dispensary_Module_for_Non-_Pharmaceutical_Products|Using_OpenEMR_Inventory-Dispensary_Module_for_Non-_Pharmaceutical_Products]]' section '1. Add a product to the inventory' for how to do that.'''''
<br><br>
:*It may be helpful while adding a new medication to the Dispensary to append the item's cost to the text in the NDC field. 
 
 
 
 
[[File:PD_AddPrice-1.PNG|center]]
 
 
 
::When the medication is being prescribed during an encounter, that information will be displayed for reference.
::'''The database requires the total NDC text length to be less than 20 characters''' including spaces.
 
 
[[File:PD_AddPrice-2.PNG|center]]
 
 
 
 
 
 
 
 
 
4. Click in "Relate To" text area to activate the "Code Finder" panel.
:* In this panel the dispensary supply can be associated ("related") to a specific entry in any of the coding systems imported into this instance of OpenEMR.
 
[[File:Pd-02-2-AddNewDrg-relateTo.png|center]]
 
 
 
5. Click "Save" button on "Add New Drug" panel to display page 2:
 
[[File:Pd-02-3-addnewdrgPg2.png|center]]
:* Edit Lot Number, Manufacturer and Expiration.
:* Edit one of the following: Vendor, Warehouse or Transaction.
:* To keep a running inventory of remaining stock, edit On Hand.  After a unit of the drug has been dispensed, this number will decrease automatically. 
 
 
6. When finished entering drug data, click all "Save" buttons and exit "Add New Drug" panel
 
==Add Prescription To Encounter form==
 
1. In a patient encounter, locate Prescriptions at bottom of right column in Summary screen
 
2. Click "Edit" button to display Add/ Edit panel
 
[[File:Pd-04-Prescrips-edit.png|center]]
 
 
 
:* Circled items are not present on this panel unless the Pharmacy Dispensary module is activated.
 
[[File:Pd-06-add-edit-wpd.png|center]]
 
 
 
3. Search and select medications or supplies from Dispensary stock
:* Text "(Click here to search)" is a link
:* "Add" button in left Prescription column displays Add/Edit panel
 
[[File:Pd-10-ordAggrenox.png|center]]
 
 
 
:* "List" button displays panel with all of this patient's medications, offering multiple methods of printing the list
 
[[File:Pd-11-listmeds.png|center]]
 
 
4. Click "Save" button and close panel with black X at top near top heading
:* New prescription is displayed in encounter summary
 
[[File:Pd-12-showRxInEnc.png|center]]
 
 
5. After clicking the Save and Dispense button in the Dispensary module, a dialog for a prescription label should appear.
 
:* This indicates a successful dispensation.
 
:*If the dialog for the label does not appear, check the browser setting and enable popups.
 
:* If On Hand, in configuration of the Dispensary module, is left as zero; when the Save and Dispense button is clicked, a dialog will appear, warning the user that there is no inventory; therefore this function cannot be completed.
 
:*'''N.B.''':  On hand number will not decrease without the generation of the prescription label.
 
[[File:Pl.png|center]]
 
* '''NOTE:''' The data pertaining to the entries in this module are contained in the following database tables:
::drugs
::drug_inventory
::drug_sales
::drug_templates
 
==Adjunct To Charges Panel==
The Dispensary Module can be used in [[Charges_Panel|Charges Panel]] to streamline workflow.  The Dispensary will appear in the central panel of the triptych.
[[File:Nemo5.PNG]]
 
 
 
[[Category:User Guide 4.2.0]][[Category:User Guide 4.1.2]][[Category:User Guide 4.1.1]][[Category:User Guide 4.1.0]][[Category:User Guide]][[Category:Configuration Guide]]

Latest revision as of 21:46, 19 February 2024

About the Pharmacy Dispensary Module

The Pharmacy Dispensary Module manages in-house prescription dispensing and also the inventory of in-house medications and other healthcare supplies.

If you have signed up for 3d party eRx solutions such as weno or NewCrop, those services may over-ride OpenEMR's native Prescription and Medication modules' activities. For example, with NewCrop activated, if you attempt to enter a medication or allergy, NewCrop is automatically invoked. However, that can be worked around using the Charges Panel to order an inventory product for an individual patient.

Activate Pharmacy Dispensary Module

The Pharmacy Dispensary Module must be activated before it can be used.

1. In left Navigation menu select: Administration/ Globals

Pd-00-0-turnDispOn.png


2. Edit Global Settings page appears; select the Features Tab.

3. Next to item "Drugs and Products" select from the dropdown menu the appropriate setting.

4. Click "Save" button at bottom of that screen.

Pd-00-1-save.png


  • When the Pharmacy Dispensary Module is activated, the Inventory menu item appears in left Navigation menu.

Add Medications to Dispensary

1. To display "Add Drug" screen, In left Navigation menu select: Inventory/ Management

  • Pharmacy medications and and whatever supplies have been logged in to the Dispensary are displayed here. Click on the item "Name" to edit its entry.
Pd-01-addDrug.png


2. Click button "Add Drug" to add a new medication or Dispensary supply

Pd-02-1-AddNewDrugPanel.png


3. Enter appropriate information in "Add New Drug" panel.

  • To remove an item from the Dispensary click the "Delete" button at bottom of panel.
  • The contents of the dropdown lists "Form", "Units", "Route" and "Interval" may be edited in the Edit Lists module. In left Navigation menu select: Administration/ Lists.
Edit these lists:
Drug Forms
Drug Intervals
Drug Routes
Drug Units
  • A particular drug will not appear in the Prescription Module as a part of the In-House formulary unless the Templates section has been completed.
See page Using_OpenEMR_Inventory-Dispensary_Module_for_Non-_Pharmaceutical_Products' section '1. Add a product to the inventory' for how to do that.



  • It may be helpful while adding a new medication to the Dispensary to append the item's cost to the text in the NDC field.



PD AddPrice-1.PNG


When the medication is being prescribed during an encounter, that information will be displayed for reference.
The database requires the total NDC text length to be less than 20 characters including spaces.


PD AddPrice-2.PNG





4. Click in "Relate To" text area to activate the "Code Finder" panel.

  • In this panel the dispensary supply can be associated ("related") to a specific entry in any of the coding systems imported into this instance of OpenEMR.
Pd-02-2-AddNewDrg-relateTo.png



5. Click "Save" button on "Add New Drug" panel to display page 2:

Pd-02-3-addnewdrgPg2.png
  • Edit Lot Number, Manufacturer and Expiration.
  • Edit one of the following: Vendor, Warehouse or Transaction.
  • To keep a running inventory of remaining stock, edit On Hand. After a unit of the drug has been dispensed, this number will decrease automatically.


6. When finished entering drug data, click all "Save" buttons and exit "Add New Drug" panel

Add Prescription To Encounter form

1. In a patient encounter, locate Prescriptions at bottom of right column in Summary screen

2. Click "Edit" button to display Add/ Edit panel

Pd-04-Prescrips-edit.png


  • Circled items are not present on this panel unless the Pharmacy Dispensary module is activated.
Pd-06-add-edit-wpd.png


3. Search and select medications or supplies from Dispensary stock

  • Text "(Click here to search)" is a link
  • "Add" button in left Prescription column displays Add/Edit panel
Pd-10-ordAggrenox.png


  • "List" button displays panel with all of this patient's medications, offering multiple methods of printing the list
Pd-11-listmeds.png


4. Click "Save" button and close panel with black X at top near top heading

  • New prescription is displayed in encounter summary
Pd-12-showRxInEnc.png


5. After clicking the Save and Dispense button in the Dispensary module, a dialog for a prescription label should appear.

  • This indicates a successful dispensation.
  • If the dialog for the label does not appear, check the browser setting and enable popups.
  • If On Hand, in configuration of the Dispensary module, is left as zero; when the Save and Dispense button is clicked, a dialog will appear, warning the user that there is no inventory; therefore this function cannot be completed.
  • N.B.: On hand number will not decrease without the generation of the prescription label.
Pl.png


  • NOTE: The data pertaining to the entries in this module are contained in the following database tables:
drugs
drug_inventory
drug_sales
drug_templates

Adjunct To Charges Panel

The Dispensary Module can be used in Charges Panel to streamline workflow. The Dispensary will appear in the central panel of the triptych. Nemo5.PNG