Order Medication | Medplum

React hook: `useScriptSureOrderMedication`

Package:@medplum/scriptsure-react · GitHub Source Code

A thin wrapper around useMedicationOrder from @medplum/react-hooks that exposes two operations: drug search and order creation. The hook is vendor-neutral — the FHIR operations route to ScriptSure bots via OperationDefinition.

The patient must be synced before calling orderMedication. See Sync a Patient.

import { useState } from 'react';

import { useScriptSureOrderMedication } from '@medplum/scriptsure-react';

function OrderMedicationPanel({ patientId }: { patientId: string }) {

const { searchMedications, orderMedication } = useScriptSureOrderMedication();

const [iframeUrl, setIframeUrl] = useState<string>();

async function handleSearch() {

const medications = await searchMedications({ term: 'lisinopril', searchGeneric: true });

// medications is Medication[]

}

async function handleOrder() {

const result = await orderMedication({

patientId,

pharmacyOrganizationId: 'org-123',

diagnoses: [{ icdId: 'I10', name: 'Essential hypertension' }],

});

setIframeUrl(result.launchUrl); // render in an iframe for prescriber to review/sign

}

if (iframeUrl) {

return <iframe src={iframeUrl} width="100%" height="800px" />;

}

return (

<div>

<button onClick={handleSearch}>Search</button>

<button onClick={handleOrder}>Order</button>

</div>

);

}

`searchMedications`

Calls POST /fhir/R4/Medication/$drug-search. Returns Medication[].

Parameter	Type	Description
`term`	`string`	Free-text drug search term
`ndc`	`string`	National Drug Code
`rxNorm`	`string`	RxNorm code
`routedMedId`	`number`	Vendor routed medication id — returns the drug's formulations
`gcnSeqnos`	`number[]`	Vendor formulation keys under `routedMedId`, taken from the name-search hit. Used only when the drug has no formulations; see below
`searchOtc`	`boolean`	Include over-the-counter drugs
`searchSupply`	`boolean`	Include supplies
`searchBrand`	`boolean`	Include brand-name drugs
`searchGeneric`	`boolean`	Include generic drugs
`includeCode`	`boolean`	Include coding in returned `Medication` resources
`quantityQualifiers`	`boolean`	Return quantity qualifiers instead of `Medication[]`

Drugs with no formulations

Some products — over-the-counter, topical, and multi-strength generics — have no rows in the vendor's dose-format table, so a routedMedId search alone returns nothing even though the drug exists and is prescribable. Each of the drug's formulation keys is a strength, so passing them resolves the strengths individually:

const strengths = await searchMedications({ routedMedId: 6143, gcnSeqnos: [8346, 22528, 22530] });

A name-search Medication carries one https://scriptsure.com/gcn-seqno identifier per key, so the caller can read them straight off the search hit. Expect fewer results than keys passed — discontinued formulations resolve to nothing and are omitted. These results carry a dispensable NDC but no pre-built sig lines, so the caller supplies the quantity and directions.