Ward Pharmacy BHT Substitute Functionality - hmislk/hmis GitHub Wiki
The Ward Pharmacy BHT Issue system allows pharmacy staff to substitute requested medications with available alternatives when the original items are out of stock. This guide explains how to use the substitute functionality effectively.
Use the substitute functionality when:
- The requested medication is out of stock
- The requested medication has expired
- An equivalent medication within the same therapeutic category (VMP group) with better pricing is available
- A medication with a longer expiry date is preferred
Note: Substitutions are currently restricted to items with the same unit/pack (e.g., Amp→Amp). Pack-to-pack substitutions (e.g., Amp→Ampp) are not supported.
- Navigate to Ward → Ward Pharmacy BHT Issue
- Select the patient's BHT request
- View the list of requested items
- In the Requested Item column, find the item you want to substitute
- Click the 🔄 (refresh/substitute) button next to the item name
- A "Select a Substitute Stock" dialog will open
The dialog will show available substitute stocks with the following information:
- Item Name: Alternative medication name
- Batch No: Batch number for tracking
- Expiry Date: When the stock expires
- Available Qty: How much stock is available
- Purchase Rate: Cost price
- Retail Rate: Selling price
- Review the substitute options
- Click "Replace" button next to your chosen substitute
- The dialog will close automatically
- The main screen will update to show:
- New item name
- Updated batch number
- New rates and pricing
- Recalculated bill totals
- "Stock replaced successfully": The substitution was completed
-
"No substitute stocks available for [Item Name]": No alternatives are currently in stock
- Action: Check with pharmacy department or try a different item
-
"Insufficient stock available. Required: X, Available: Y": Not enough stock for the requested quantity
- Action: Select a different substitute or adjust the quantity
-
"Sorry, another user is currently billing this substitute stock": Another user is using the same stock
- Action: Wait a moment and try again, or select a different substitute
-
"Cannot use expired stock": The selected substitute has expired
- Action: Choose a different substitute with a valid expiry date
- Check Expiry Dates: Always verify the substitute has adequate shelf life
- Verify Quantities: Ensure sufficient stock is available for the full requirement
- Review Pricing: Compare rates to ensure cost-effectiveness
- Confirm Equivalency: Verify the substitute is medically appropriate
- Single Selection: Choose one substitute at a time
- Immediate Action: Complete the substitution promptly to avoid conflicts with other users
- Verify Updates: Confirm all details update correctly after replacement
- Review Totals: Check that bill totals have recalculated properly
- Document Changes: Note any significant changes for the requesting department
- Continue Processing: Proceed with issuing the medications to the ward
If you see "No substitute stocks available":
- Contact the pharmacy department to check if alternatives can be ordered
- Coordinate with the requesting ward about possible alternatives
- Check if the item is available in other pharmacy locations
If the Replace button doesn't work:
- Ensure you have selected a substitute stock
- Check that the stock hasn't been reserved by another user
- Verify the substitute has sufficient quantity
- Try refreshing the page and attempting again
If changes don't appear after replacement:
- Wait a few seconds for the system to update
- Check for any error messages
- Refresh the browser page if necessary
- Contact IT support if the issue persists
Administrators can configure:
- Option: "Adding new items for inpatient requests are allowed"
- Purpose: Controls whether new items can be added to requests
- Impact: When disabled, only substitutions are allowed
- Option: "Pharmacy Request Issue Bill is PosHeaderPaper"
- Purpose: Controls the format of printed bills
- Impact: Affects how issued medications are documented
- Price matrix settings determine how rates are calculated
- Different departments may have different pricing rules
- Contact your system administrator for pricing configuration
A: No, substitutes are limited to medications in the same therapeutic category (VMP group). The system only shows appropriate alternatives.
A: You can repeat the substitution process to select a different alternative. Contact your supervisor if you need to reverse a completed transaction.
A: Items may not appear if they are:
- Out of stock
- Expired
- Not in the same therapeutic category
- Reserved by another user
A: No, the system prevents conflicts. If another user is working with the same stock, you'll receive a message to try again later.
Note: This functionality requires appropriate user permissions. Contact your system administrator if you cannot access the substitute features.