Prescription attachments & reading from a photo

Two helpers on the prescription screen:

• Attachments — keep a photo of the paper prescription and any lab/test result scans with the prescription record.
• Read from image (AI) — photograph a prescription, lab report, or patient card and let the assistant transcribe the patient's name, the prescriber and date, and (on a prescription) the drug lines into a draft you review and edit.

Both are aids only. You must verify everything against the original script before saving or dispensing.

Before you start

• Open a saved prescription. Attachments can only be added after the prescription has been saved once (a new, unsaved prescription has nowhere to attach files to yet).
• The Read from image (AI) button appears only when your organisation has AI drafting switched on. If you don't see it, AI isn't configured — capture the lines manually with + Add drug.

Steps — attach a photo or scan

1. Open the prescription and scroll to Attachments (Rx photo & test scans).
2. Pick the kind: Prescription, Lab scan, or Other.
3. Click Upload and choose a file. Allowed: images (JPG/PNG/…) or PDF, up to 15 MB each.
4. The file appears as a tile. Click an image or Open PDF to view it full size; click the × on a tile to remove it.

Steps — read a prescription from a photo (AI)

1. Click ✨ Read from image (AI) in the Prescribed drugs header.
2. Choose a clear photo of the prescription (or a lab report / card).
3. The assistant reads what it can — the prescriber and date (shown in a green summary), and, on a prescription, an editable list of drug lines (drug name with strength, directions (Sig), quantity, and refills).
4. Check everything against the original. Fix any misread text, correct quantities, and drop lines that aren't right.
5. Click Apply to prescription. The prescriber and date prefill the header (blank fields only — your typed values are never overwritten), and the drug lines are appended to Prescribed drugs. Where a line clearly matches one drug in your catalogue it is linked automatically; otherwise the read name shows in an amber box on the row, with "map to:" suggestions — click a suggestion to link the line to that catalogue drug in one tap (a line must be mapped to a catalogue drug before it can be dispensed).
6. Review the linked drugs, complete anything left as free text, then Save.

Tips

• Straight, well-lit photos with the whole script in frame read best. Glare, handwriting, and cropped edges reduce accuracy.
• The assistant only transcribes what's written. It never diagnoses, never suggests a drug that isn't on the script, and never fills in a quantity that wasn't written — those come back blank for you to complete.
• Attachments are stored securely and are only visible to users who can open prescriptions.

Common problems

• "Attachment storage is not configured." — file storage isn't set up for your environment. Ask your administrator; attachments are unavailable until it's configured.
• The AI button is missing — AI drafting isn't enabled for your organisation. Add drugs manually with + Add drug.
• "No drug lines were read from that image." — the photo was unreadable or isn't a prescription. Retake a clearer photo, or enter the lines by hand.
• A drug shows in an amber box (not linked) — the read name didn't match exactly one catalogue item, so it's kept as free text on the row. Either leave it as-is (it saves fine as a typed name) or open the Drug picker on that row and choose the catalogue medicine.
• The drugs look empty after a scan — the read names are in the amber box under each Drug picker; they only look blank if the picker is empty. If your catalogue doesn't stock those drugs they stay as free text, which is expected.
• Can't upload on a new prescription — save the prescription first, then the Attachments card becomes available.