Medication Statement Profile

Canonical	../StructureDefinition/nexus-emr-core-medicationstatement
Status	draft (experimental) · 1.26.0
Base	MedicationStatement (constraint)
Source	FSH · JSON

Nexus EMR profile for MedicationStatement -- patient-reported medication use, distinct from prescriptions. First pass: status, text-first medication concept, effective timing, free-text dosage. Closed to SMART apps pending an exposure decision.

Salient fields

The profile's synthesized-accessor contract: fields TypedFhir surfaces as first-class typed properties, each computed from the instance by a restricted FHIRPath expression. See Salient Fields for what they are, how they shape LLM contexts, and how to declare them.

Key	Type	Expression	Rendered as	Description
medication	string	medicationCodeableConcept.text \| medicationCodeableConcept.coding.first().display		Plain text representation of the concept i
status	code	status		active | completed | entered-in-error | intended | stopped | on-hold | unknown | not-taken i
dosage	string	dosage.first().text		Free-text dosage ('81 mg daily') -- the first-pass dosage surface i
effective	dateTime	effectiveDateTime \| effectivePeriod.start		When the use applies (dateTime or period) i
asserted	dateTime	dateAsserted		When the statement was captured
reason_code	coded	reasonCode		Reason for why the medication is being/was taken i

medication

Short	Plain text representation of the concept
Definition	A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.
Comments	Text first, then the first coding's display. medication[x] is constrained to CodeableConcept on this profile, so there is no reference arm to fall back to.
Expression	medicationCodeableConcept.text | medicationCodeableConcept.coding.first().display
Type	string
Prose inherited from	MedicationStatement.medication[x].text

status

Short	active | completed | entered-in-error | intended | stopped | on-hold | unknown | not-taken
Definition	A code representing the patient or other source's judgment about the state of the medication used that this statement is about. Generally, this will be active or completed.
Comments	This is a modifier element; not-taken inverts the meaning of the whole statement and consumers must read it.
Expression	status
Type	code
Prose inherited from	MedicationStatement.status

dosage

Short	Free-text dosage ('81 mg daily') -- the first-pass dosage surface
Definition	Free text dosage instructions e.g. SIG.
Comments	The FIRST dosage's free text. dosage is 0..*; a statement carrying more than one regimen surfaces only the first here, and the rest stay reachable through the typed collection.
Expression	dosage.first().text
Type	string
Prose inherited from	MedicationStatement.dosage.text

effective

Short	When the use applies (dateTime or period)
Definition	The interval of time during which it is being asserted that the patient is/was/will be taking the medication (or was not taking, when the MedicationStatement.taken element is No).
Comments	When the reported use APPLIES -- the dateTime, or the start of the period. This is not when the statement was captured; that is asserted.
Expression	effectiveDateTime | effectivePeriod.start
Type	dateTime
Prose inherited from	MedicationStatement.effective[x]

asserted

Short	When the statement was captured
Definition	The date when the medication statement was asserted by the information source.
Expression	dateAsserted
Type	dateTime
Prose inherited from	MedicationStatement.dateAsserted

reason_code

Short	Reason for why the medication is being/was taken
Definition	A reason for why the medication is being/was taken.
Comments	This could be a diagnosis code. If a full condition record exists or additional detail is needed, use reasonForUseReference.
Expression	reasonCode
Type	coded
Prose inherited from	MedicationStatement.reasonCode