💊 pharmacy

Drug Batches

Drug Batches is the pharmacy-facing view of the same batch/expiry tracking system used across BazaarPOS inventory — pick a medicine and manage its individual batches (batch number, quantity, cost, received/expiry dates, supplier reference), with a store-wide "expiring within 90 days" panel at the top so nothing lapses unnoticed.

📍 Menu path: Pharmacy → Drug Batches

👤 Who uses it: Add/Edit/Delete require ADMIN or MANAGER; viewing is open to all roles with the Billing feature enabled

Overview

This page does not have its own database table or API — it is a pharmacy-specific screen wrapped around the generic per-product batch endpoints also used by Inventory's batch/FEFO features.

The top panel loads every batch across all products expiring within 90 days (store-wide), independent of which medicine you have selected below.

The bottom panel only shows batches once you have picked a medicine, either by clicking one from the expiring list or by searching for it directly.

Before You Start

You must have the Billing feature enabled on your plan.
Adding, editing or deleting a batch requires the ADMIN or MANAGER role; any role can view batches and the expiring-soon list.

Step-by-Step Guide

1 Check what is expiring soon, store-wide

Open Pharmacy → Drug Batches — the "Expiring within 90 days" panel loads automatically.
Each row shows the medicine name, batch number and either "Xd left" or, for already-expired stock, "Xd ago" in red with a warning icon.
Click a row to jump straight to that medicine's full batch list below.

2 Add a batch for a specific medicine

Search for the medicine by name or composition in "Manage batches for a medicine" and select it from the results.
Click "+ Add Batch" and fill in Batch Number and Quantity (both required), plus Cost Price, Received Date, Expiry Date and Supplier Ref as available.
Click "Add Batch" to save.

3 Edit or remove a batch

With a medicine selected, click the edit icon on any batch row to adjust its quantity, dates or other details.
Click the delete icon and confirm to permanently remove a batch record.
Either action refreshes the store-wide expiring-soon panel automatically.

Every Field & Button, Explained

Field / Button	What it does
`Batch Number`	Required. The manufacturer/supplier batch or lot number printed on the strip/box.
`Quantity`	Units received in this batch; the list view shows Remaining Qty if the batch has been partially consumed by sales, otherwise the original Quantity.
`Cost Price`	Per-unit cost for this specific batch — batches of the same medicine can have different costs over time.
`Received Date / Expiry Date`	When the batch arrived and when it expires. Rows within 90 days of Expiry Date are highlighted amber; already-expired rows are highlighted red.
`Supplier Ref`	Free-text reference to the supplier or purchase invoice for this batch.

Tips & Best Practices

Check the store-wide "Expiring within 90 days" panel regularly (not just when opening a specific medicine) — it is the fastest way to catch stock about to expire across your entire catalogue.
Enter Expiry Date for every batch as it arrives — batches without one will never show up in the expiring-soon alerts, even if they are old stock.

Troubleshooting & FAQ

I don't see "+ Add Batch", or Edit/Delete are missing.

Adding, editing and deleting a batch is restricted to the ADMIN and MANAGER roles at the API level — other roles can view batches but the action buttons will fail if attempted.

A batch I know is low on stock does not appear in the expiring list.

The expiring-soon panel is date-driven (Expiry Date within 90 days or already passed), not quantity-driven — a batch with plenty of stock left but a near expiry date will show up, while a nearly-empty batch with a distant expiry date will not.