Skip to documentation
ReferencePatient

Patient

Active medications

Current medication content alongside the patient snapshot.

Format definition

Separate a medication definition, order, administration, infusion, and authored response.

Portable format · Suite implementation support

Parameters

resources[].medication

{ ingredient: string, formulation: string, concentration?: QuantityRatio, allowedRoutes: string[] }

Required for medication resources

Reusable product definition. QuantityRatio is numerator Quantity / denominator Quantity; positive denominator is required.

events.actions[].medicationOrder

{ resourceId: Medication ID, patientId: Patient ID, dose: Quantity, route: string, rate?: QuantityRatio }

Required for a medication-order action

Quantity is { value: positive number, unit: string }. Units are explicit; route must belong to allowedRoutes.

events.actions[].administration

{ orderActionId: Action ID, mode: bolus | infusion-start | infusion-change | infusion-stop }

Optional; omitted means unspecified

Administration is a separate observable action referencing an order, not an automatic consequence of writing it.

events.actions[].administration.rate

QuantityRatio

Required for infusion-start/change; prohibited otherwise

Explicit amount per time or volume per time. No implicit unit conversion or pump calculation.

Behavior and validation

  • Infusion-change and infusion-stop require an active infusion for the same order and patient. Runtime administration records preserve authored amount, route, time, and operator evidence separately from the scenario definition.
  • Validate dimensional compatibility of dose/concentration/rate. Reject incompatible or unrecognized units instead of guessing. Unit vocabulary and permitted conversions must be versioned before runtime adoption.
  • Effects and schedules explicitly describe the scenario's response. This format does not prescribe treatment doses or claim a validated pharmacologic model.

Shared format conventions · All format elements · Download specification