Search Inpatient Direct Issue Returns - hmislk/hmis GitHub Wiki
Search Inpatient Direct Issue Returns
Overview
The Search Inpatient Direct Issue Returns page lets you find pharmacy return bills created when medicines issued directly to inpatient BHTs were returned (see Direct Issue Return to Pharmacy for how those returns are created).
Path: Inward → Pharmacy → Search Inpatient Direct Issue Returns by Bill (or by Item) — also available from the Nursing Workbench's Pharmaceuticals & Consumables panel
XHTML: /inward/pharmacy_search_return_bill_bht.xhtml
Controller: searchController
Note: Despite the menu offering separate "...by Bill" and "...by Item" entries, both currently open the same bill-level search page below — there is no separate item-level search for direct issue returns. On the Nursing Workbench, the Search IP Direct Issue Returns by Item button points to a page that does not exist and will not open; use Search IP Direct Issue Returns by Bill instead.
Looking for one admission's returns only? A patient's Admission Profile has its own Issue Returns button (under Reports & History) that opens a read-only, printable/exportable list of return bills for that admission only (
/inward/reports/inpatient_pharmacy_returns_list.xhtml) — useful when you already have the patient open and don't need to search across admissions.
When to Use
Use this page when you need to:
- Find a specific return bill by its return bill number or the original sale bill number
- Locate all direct issue returns for a particular BHT or patient
- Review return history over a date range
- Audit direct issue returns linked to inpatient admissions
How to Search
- Open the page from one of the paths above
- Apply one or more of the following filters:
| Filter | Description |
|---|---|
| From / To Date | Filter by the date/time the return bill was created |
| Sale Bill No | Search by the original issue (sale) bill's number |
| Return Bill No | Search by the return bill's own number |
| BHT No | Search by the admission's BHT number |
| Patient Name | Search by the patient's name |
| MRN / PHN No | Search by the patient's MRN or PHN number |
| Net Total | Filter by the net total amount of the return bill |
- Click Search
Understanding Results
Each row in the results table represents one return bill, with:
- Sale Bill No — the original direct-issue bill the return was made against
- Return Bill No — the return bill's own number
- BHT No / Patient Name — the linked admission and patient
- Item Return At — when the return was processed (shown in red with a cancellation date/time if the return was cancelled)
- Item Return By — who processed the return (shown in red with the cancelling user if the return was cancelled)
- View Bill — opens the return bill for viewing/printing; disabled if the return has an active return-cash bill against it, or if the return itself is cancelled
Related Features
- Direct Issue Return to Pharmacy — how to create a direct issue return (the workflow behind the bills found here)
- Ward Medicine Request, Issue, and Return Workflow — the separate, pharmacy-accepted return flow for request-based issues
- Search Inpatient Direct Issue By Bill — searching for issue bills (the counterpart to this page); its results table also shows any return bills already made against each issue
- Direct Issue to BHTs from Pharmacy — issuing medicines directly to BHTs
- Inpatient — Nursing Workbench
- Inward