Repeat Medication Refills

The Repeat Medication flow facilitates refills for patients with stable chronic conditions. It allows doctors to approve prescription renewals asynchronously and enables receptionists or pharmacists to complete dispensing and billing without active queue tickets.

Detailed Step-by-Step Walkthrough

Step 1: Asynchronous Refill Approval (Physician Inbox)

When a patient requests a repeat prescription (e.g., via the patient portal or front desk request), it is processed asynchronously:

1. Navigate to the Messages Inbox (/messages) and select the Refill Requests tab (base-inbox-message.vue).
2. The inbox displays pending renewal requests alongside the patient's EMR history, current medications, last consultation date, and refill justification.
3. Review the request details: verify dosage safety, batch constraints, and clinical review flags.
4. Approve Request: Click Approve.
   • System Automation: The system executes a GraphQL mutation to sign the prescription asynchronously. This action transitions the workflow state and routes the request directly to the pharmacy.
   • Queue Bypass: No active QMS ticket is generated, keeping the live doctor queues clear.
5. Modify or Decline: Click Modify to adjust quantities or strengths, or click Decline with notes.

Step 2: Fulfilling Refills (Pharmacy Smart Dispense)

Once authorized, the pharmacy team dispenses the medications:

1. Navigate to Pharmacy Orders (/pharmacy) and open the Refill Orders list using the pharmacy order table (pharmacy-order-table.vue).
2. Select the patient's order to open the Pharmacy Order Detail panel (pharmacy-order-object-layout.vue).
3. Click Start Dispense to launch the Dispense Stepper (dispense-stepper.vue).
4. Open the Smart Dispense interface (smart-dispense/inventory.vue):
   • Batch Allocation: Select the appropriate drug batch from active inventory (smart-dispense/inventory-card.vue / batch-slideover.vue). The system displays batch numbers, expiry dates, and real-time stock levels.
   • Label Printing: Confirm the quantities and click Print Labels (smart-dispense/label-management.vue) to generate dosage labels.
5. Confirm the dispense step to advance the order status.

Step 3: Checkout & Allocation

1. Navigate to Invoices (/billing/invoices/[invoiceId] using invoice-object-layout.vue).
2. Confirm the total invoice balance (including co-pays and insurance plans).
3. Click Collect Payment and process the transaction (Cash, Card, or Stripe payment link).
4. Click Complete Checkout. The system records the payment, deducts the items from the active stock register, and updates the invoice status to paid.