Medications
This
page
is
part
of
the
Continuous
Integration
Build
of
FHIR
Specification
(v4.0.1:
R4
-
Mixed
Normative
and
STU
)
in
it's
permanent
home
(it
will
always
(will
be
available
incorrect/inconsistent
at
this
URL).
The
current
version
which
supercedes
this
version
is
5.0.0
.
For
a
full
list
of
available
versions,
see
times).
See
the
Directory
of
published
versions
.
Page
versions:
R5
R4B
R4
R3
R2
|
Responsible
Owner:
Pharmacy
Work
Group
|
|
Security Category : Patient | Compartments : Encounter , Group , Patient , Practitioner , RelatedPerson |
A record of a medication that is being consumed by a patient. A MedicationStatement may indicate that the patient may be taking the medication now or has taken the medication in the past or will be taking the medication in the future. The source of this information can be the patient, significant other (such as a family member or spouse), or a clinician. A common scenario where this information is captured is during the history taking process during a patient visit or stay. The medication information may come from sources such as the patient's memory, from a prescription bottle, or from a list of medications the patient, clinician or other party maintains.
The
primary
difference
between
a
medication
statement
medicationstatement
and
a
medication
administration
medicationadministration
is
that
the
medication
administration
has
complete
administration
information
and
is
based
on
actual
administration
information
from
the
person
who
administered
the
medication.
A
medication
statement
medicationstatement
is
often,
if
not
always,
less
specific.
There
is
no
required
date/time
when
the
medication
was
administered,
in
fact
we
only
know
that
a
source
has
reported
the
patient
is
taking
this
medication,
where
details
such
as
time,
quantity,
or
rate
or
even
medication
product
may
be
incomplete
or
missing
or
less
precise.
As
stated
earlier,
the
medication
statement
Medication
Statement
information
may
come
from
the
patient's
memory,
from
a
prescription
bottle
or
from
a
list
of
medications
the
patient,
clinician
or
other
party
maintains.
Medication
administration
is
more
formal
and
is
not
missing
detailed
information.
Common usage includes:
A
MedicationStatement
may
SHALL
NOT
be
used
to
record
substance
abuse
or
the
use
of
other
agents
such
as
tobacco
or
alcohol.
This
would
typically
be
done
if
these
substances
are
intended
to
be
included
in
clinical
decision
support
checking
(for
example,
interaction
checking)
and
as
part
of
an
active
medication
list.
If
the
intent
is
to
populate
social
history
and/or
to
include
additional
information
(for
example,
desire
to
quit,
amount
per
day,
negative
health
effects),
then
it
is
better
to
record
alcohol
UNLESS
those
agents
have
been
prescribed,
e.g.
nicotine
patches
or
gum,
long
term
care
alcohol,
etc.
These
should
recorded
as
an
Observation
that
could
then
be
used
to
populate
Social
History.
History
Observations.
This resource does not produce a medication list, but it does produce individual medication statements that may be used in the List resource to construct various types of medication lists. Note that other medication lists can also be constructed from the other Pharmacy resources (e.g., MedicationRequest, MedicationAdministration).
A medication statement is not a part of the prescribe -> dispense -> administer sequence, but is a report by a patient, significant other or a clinician that one or more of the prescribe, dispense or administer actions has occurred, resulting is a belief that the patient is, has, or will be using a particular medication.
MedicationStatement includes an adherence element. Note that this adherence is specific to that instance of MedicationStatement. If MedicationStatement.adherence is being tracked over time, then instances of MedicationStatement would report adherence for the interval noted in effectivePeriod.
MedicationStatement is an event resource from a FHIR workflow perspective - see Workflow Event
The
MedicationStatement
resource
is
used
to
record
a
medications
or
substances
that
the
patient
reports
as
being
taken,
not
taking,
have
taken
in
the
past
or
may
take
in
the
future.
It
can
also
be
used
to
record
medication
use
that
is
derived
from
other
records
such
as
a
MedicationRequest.
The
statement
is
not
used
to
request
or
order
a
medication,
supply
or
device.
When
requesting
medication,
supplies
or
devices
when
there
is
a
patient
focus
or
instructions
regarding
their
use,
a
MedicationRequest
,
SupplyRequest
or
DeviceRequest
should
be
used
instead
The Medication domain includes a number of related resources
| MedicationRequest | An order for both supply of the medication and the instructions for administration of the medicine to a patient. |
| MedicationDispense | Provision of a supply of a medication with the intention that it is subsequently consumed by a patient (usually in response to a prescription). |
| MedicationAdministration | When a patient actually consumes a medicine, or it is otherwise administered to them |
| MedicationStatement | This is a record of a medication being taken by a patient or that a medication has been given to a patient, where the record is the result of a report from the patient or another clinician, or derived from supporting information (for example, Claim, Observation or MedicationRequest). A medication statement is not a part of the prescribe->dispense->administer sequence but is a report that such a sequence (or at least a part of it) did take place, resulting in a belief that the patient has received a particular medication. |
This resource is distinct from MedicationRequest , MedicationDispense and MedicationAdministration . Each of those resources refers to specific events - an individual order, an individual provisioning of medication or an individual dosing. MedicationStatement is a broader assertion covering a wider timespan and is independent of specific events. The existence of resource instances of any of the preceding three types may be used to infer a medication statement. However, medication statements can also be captured on the basis of other information, including an assertion by the patient or a care-giver, the results of a lab test, etc.
To indicate the link between a MedicationStatement instance and the Medication Request, Dispense, or Administration that was used to derive the MedicationStatement, the reference should be placed in the MedicationStatement.derivedFrom element.
This resourceNote to Balloters: The code system used in medication statement category isreferenced bypresented here but is expected to move to terminology.hl7.org
Structure
| Name | Flags | Card. | Type |
Description
&
Constraints
Filter:
|
|---|---|---|---|---|
MedicationStatement
|
TU | DomainResource |
Record
of
medication
being
taken
by
a
patient
Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension |
|
identifier
|
Σ | 0..* | Identifier |
External
identifier
|
partOf
|
0..* |
Reference
(
|
Part
of
referenced
event
|
|
status
|
?! Σ | 1..1 | code |
recorded
|
entered-in-error
|
|
|
category
|
Σ | 0..* | CodeableConcept |
Type
of
medication
|
|
medication
|
Σ | 1..1 | CodeableReference ( Medication ) |
What
medication
was
taken
Binding: SNOMED CT Medication Codes ( Example ) |
|
subject
|
Σ | 1..1 | Reference ( Patient | Group ) |
Who
is/was
taking
the
medication
|
|
|
Σ | 0..1 |
Reference
(
Encounter
|
Encounter
|
effective[x]
|
Σ | 0..1 |
The
date/time
or
interval
when
the
medication
is/was/will
be
taken
|
|
effectiveDateTime
|
dateTime | |||
|
effectivePeriod
|
Period | |||
effectiveTiming
| Timing | |||
|
dateAsserted
|
Σ | 0..1 | dateTime |
When
the
|
|
author
|
Σ | 0..1 | Reference ( Practitioner | PractitionerRole | Organization | Patient | RelatedPerson | Device ) |
Who/What
authored
the
statement
|
|
informationSource
| 0..* | Reference ( Device | Patient | Practitioner | PractitionerRole | RelatedPerson | Organization | Group ) |
Person
or
organization
that
provided
the
information
about
the
taking
of
this
medication
|
|
|
derivedFrom
|
0..* | Reference ( Any ) |
Link
to
information
used
to
derive
the
MedicationStatement
|
|
|
reason
|
0..* |
|
Reason
for
why
the
medication
is
being/was
taken
Binding: Condition/Problem/Diagnosis Codes ( Example ) |
|
|
note
|
0..* | Annotation |
Further
information
about
the
usage
|
|
|
relatedClinicalInformation
| 0..* |
Reference
(
|
Link
to
information
relevant
to
the
usage
of
a
medication
|
|
|
renderedDosageInstruction
|
0..1 |
|
Full
representation
of
the
|
|
|
dosage
|
0..* | Dosage |
Details
of
how
medication
is/was
taken
or
should
be
taken
|
|
adherence
| Σ | 0..1 | BackboneElement |
Indicates
whether
the
medication
is
or
is
not
being
consumed
or
administered
|
code
| Σ | 1..1 | CodeableConcept |
Type
of
adherence
Binding: MedicationStatement Adherence Codes ( Example ) |
|
reason
| 0..1 | CodeableConcept |
Details
of
the
reason
for
the
current
use
of
the
medication
Binding: SNOMED CT Drug Therapy Status codes ( Example ) | |
|
Documentation
for
this
format
|
||||
See the Extensions for this resource
UML Diagram ( Legend )
XML Template
<<a href="medicationstatement-definitions.html#MedicationStatement" title="A record of a medication that is being consumed by a patient. A MedicationStatement may indicate that the patient may be taking the medication now or has taken the medication in the past or will be taking the medication in the future. The source of this information can be the patient, significant other (such as a family member or spouse), or a clinician. A common scenario where this information is captured is during the history taking process during a patient visit or stay. The medication information may come from sources such as the patient's memory, from a prescription bottle, or from a list of medications the patient, clinician or other party maintains. The primary difference between a medication statement and a medication administration is that the medication administration has complete administration information and is based on actual administration information from the person who administered the medication. A medication statement is often, if not always, less specific. There is no required date/time when the medication was administered, in fact we only know that a source has reported the patient is taking this medication, where details such as time, quantity, or rate or even medication product may be incomplete or missing or less precise. As stated earlier, the medication statement information may come from the patient's memory, from a prescription bottle or from a list of medications the patient, clinician or other party maintains. Medication administration is more formal and is not missing detailed information." class="dict"><MedicationStatement xmlns="http://hl7.org/fhir"><!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..* Identifier External identifier --></identifier>
<</basedOn> <| </partOf> < <</statusReason> <</category> <</medication[x]> <</subject> <</context> <</effective[x]> < <| </informationSource> <</derivedFrom> <</reasonCode> <</reasonReference> <</note><partOf><!-- 0..* Reference(MedicationStatement|Procedure) Part of referenced event --></partOf> <status value="[code]"/><!-- 1..1 recorded | entered-in-error | draft --> <category><!-- 0..* CodeableConcept Type of medication statement --></category> <medication><!-- 1..1 CodeableReference(Medication) What medication was taken --></medication> <subject><!-- 1..1 Reference(Group|Patient) Who is/was taking the medication --></subject> <encounter><!-- 0..1 Reference(Encounter) Encounter associated with MedicationStatement --></encounter> <effective[x]><!-- 0..1 dateTime|Period|Timing The date/time or interval when the medication is/was/will be taken --></effective[x]> <dateAsserted value="[dateTime]"/><!-- 0..1 When the usage was asserted? --> <author><!-- 0..1 Reference(Device|Organization|Patient|Practitioner| PractitionerRole|RelatedPerson) Who/What authored the statement --></author> <informationSource><!-- 0..* Reference(Device|Group|Organization|Patient| Practitioner|PractitionerRole|RelatedPerson) Person or organization that provided the information about the taking of this medication --></informationSource> <derivedFrom><!-- 0..* Reference(Any) Link to information used to derive the MedicationStatement --></derivedFrom> <reason><!-- 0..* CodeableReference(Condition|DiagnosticReport|Observation| Procedure) Reason for why the medication is being/was taken --></reason> <note><!-- 0..* Annotation Further information about the usage --></note> <relatedClinicalInformation><!-- 0..* Reference(Condition|Observation) Link to information relevant to the usage of a medication --></relatedClinicalInformation> <renderedDosageInstruction value="[markdown]"/><!-- 0..1 Full representation of the dosage instructions --> <dosage><!-- 0..* Dosage Details of how medication is/was taken or should be taken --></dosage> <adherence> <!-- 0..1 Indicates whether the medication is or is not being consumed or administered --> <code><!-- 1..1 CodeableConcept Type of adherence --></code> <reason><!-- 0..1 CodeableConcept Details of the reason for the current use of the medication --></reason> </adherence> </MedicationStatement>
JSON Template
{
"resourceType" : "<a href="medicationstatement-definitions.html#MedicationStatement" title="A record of a medication that is being consumed by a patient. A MedicationStatement may indicate that the patient may be taking the medication now or has taken the medication in the past or will be taking the medication in the future. The source of this information can be the patient, significant other (such as a family member or spouse), or a clinician. A common scenario where this information is captured is during the history taking process during a patient visit or stay. The medication information may come from sources such as the patient's memory, from a prescription bottle, or from a list of medications the patient, clinician or other party maintains.
The primary difference between a medication statement and a medication administration is that the medication administration has complete administration information and is based on actual administration information from the person who administered the medication. A medication statement is often, if not always, less specific. There is no required date/time when the medication was administered, in fact we only know that a source has reported the patient is taking this medication, where details such as time, quantity, or rate or even medication product may be incomplete or missing or less precise. As stated earlier, the medication statement information may come from the patient's memory, from a prescription bottle or from a list of medications the patient, clinician or other party maintains. Medication administration is more formal and is not missing detailed information." class="dict">",
"resourceType" : "MedicationStatement",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"identifier" : [{ Identifier }], // External identifier
"
"|
"
"
"
" },
" },
"
"
">",
" },
"
"|
"
"
"
"
"
"partOf" : [{ Reference(MedicationStatement|Procedure) }], // Part of referenced event
"status" : "<code>", // R! recorded | entered-in-error | draft
"category" : [{ CodeableConcept }], // Type of medication statement
"medication" : { CodeableReference(Medication) }, // R! What medication was taken
"subject" : { Reference(Group|Patient) }, // R! Who is/was taking the medication
"encounter" : { Reference(Encounter) }, // Encounter associated with MedicationStatement
// effective[x]: The date/time or interval when the medication is/was/will be taken. One of these 3:
"effectiveDateTime" : "<dateTime>",
"effectivePeriod" : { Period },
"effectiveTiming" : { Timing },
"dateAsserted" : "<dateTime>", // When the usage was asserted?
"author" : { Reference(Device|Organization|Patient|Practitioner|
PractitionerRole|RelatedPerson) }, // Who/What authored the statement
"informationSource" : [{ Reference(Device|Group|Organization|Patient|
Practitioner|PractitionerRole|RelatedPerson) }], // Person or organization that provided the information about the taking of this medication
"derivedFrom" : [{ Reference(Any) }], // Link to information used to derive the MedicationStatement
"reason" : [{ CodeableReference(Condition|DiagnosticReport|Observation|
Procedure) }], // Reason for why the medication is being/was taken
"note" : [{ Annotation }], // Further information about the usage
"relatedClinicalInformation" : [{ Reference(Condition|Observation) }], // Link to information relevant to the usage of a medication
"renderedDosageInstruction" : "<markdown>", // Full representation of the dosage instructions
"dosage" : [{ Dosage }], // Details of how medication is/was taken or should be taken
"adherence" : { // Indicates whether the medication is or is not being consumed or administered
"code" : { CodeableConcept }, // R! Type of adherence
"reason" : { CodeableConcept } // Details of the reason for the current use of the medication
}
}
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> .[ a fhir:<a href="medicationstatement-definitions.html#MedicationStatement" title="A record of a medication that is being consumed by a patient. A MedicationStatement may indicate that the patient may be taking the medication now or has taken the medication in the past or will be taking the medication in the future. The source of this information can be the patient, significant other (such as a family member or spouse), or a clinician. A common scenario where this information is captured is during the history taking process during a patient visit or stay. The medication information may come from sources such as the patient's memory, from a prescription bottle, or from a list of medications the patient, clinician or other party maintains. The primary difference between a medication statement and a medication administration is that the medication administration has complete administration information and is based on actual administration information from the person who administered the medication. A medication statement is often, if not always, less specific. There is no required date/time when the medication was administered, in fact we only know that a source has reported the patient is taking this medication, where details such as time, quantity, or rate or even medication product may be incomplete or missing or less precise. As stated earlier, the medication statement information may come from the patient's memory, from a prescription bottle or from a list of medications the patient, clinician or other party maintains. Medication administration is more formal and is not missing detailed information." class="dict">;[ a fhir:MedicationStatement; fhir:nodeRole fhir:treeRoot; # if this is the parser root# from # from fhir: fhir: fhir:| fhir: fhir: fhir: # . One of these 2 fhir: ] fhir:) ] fhir: fhir: # . One of these 2 fhir: ] fhir: ] fhir: fhir: fhir: fhir: fhir: fhir: fhir:# from Resource: fhir:id, fhir:meta, fhir:implicitRules, and fhir:language # from DomainResource: fhir:text, fhir:contained, fhir:extension, and fhir:modifierExtension fhir:identifier ( [ Identifier ] ... ) ; # 0..* External identifier fhir:partOf ( [ Reference(MedicationStatement|Procedure) ] ... ) ; # 0..* Part of referenced event fhir:status [ code ] ; # 1..1 recorded | entered-in-error | draft fhir:category ( [ CodeableConcept ] ... ) ; # 0..* Type of medication statement fhir:medication [ CodeableReference(Medication) ] ; # 1..1 What medication was taken fhir:subject [ Reference(Group|Patient) ] ; # 1..1 Who is/was taking the medication fhir:encounter [ Reference(Encounter) ] ; # 0..1 Encounter associated with MedicationStatement # effective[x] : 0..1 The date/time or interval when the medication is/was/will be taken. One of these 3 fhir:effective [ a fhir:DateTime ; dateTime ] fhir:effective [ a fhir:Period ; Period ] fhir:effective [ a fhir:Timing ; Timing ] fhir:dateAsserted [ dateTime ] ; # 0..1 When the usage was asserted? fhir:author [ Reference(Device|Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) ] ; # 0..1 Who/What authored the statement fhir:informationSource ( [ Reference(Device|Group|Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) ] ... ) ; # 0..* Person or organization that provided the information about the taking of this medication fhir:derivedFrom ( [ Reference(Any) ] ... ) ; # 0..* Link to information used to derive the MedicationStatement fhir:reason ( [ CodeableReference(Condition|DiagnosticReport|Observation|Procedure) ] ... ) ; # 0..* Reason for why the medication is being/was taken fhir:note ( [ Annotation ] ... ) ; # 0..* Further information about the usage fhir:relatedClinicalInformation ( [ Reference(Condition|Observation) ] ... ) ; # 0..* Link to information relevant to the usage of a medication fhir:renderedDosageInstruction [ markdown ] ; # 0..1 Full representation of the dosage instructions fhir:dosage ( [ Dosage ] ... ) ; # 0..* Details of how medication is/was taken or should be taken fhir:adherence [ # 0..1 Indicates whether the medication is or is not being consumed or administered fhir:code [ CodeableConcept ] ; # 1..1 Type of adherence fhir:reason [ CodeableConcept ] ; # 0..1 Details of the reason for the current use of the medication ] ; ]
Changes
since
R3
from
both
R4
and
R4B
| MedicationStatement | |
|
|
|
| MedicationStatement.status |
|
| MedicationStatement.category |
|
| MedicationStatement.medication |
|
| MedicationStatement.encounter |
|
|
|
|
|
|
|
| MedicationStatement.informationSource |
|
|
|
|
| MedicationStatement.relatedClinicalInformation |
|
| MedicationStatement.renderedDosageInstruction |
|
| MedicationStatement.adherence |
|
| MedicationStatement.adherence.code |
|
| MedicationStatement.adherence.reason |
|
|
|
|
|
|
|
| MedicationStatement.reasonCode |
|
| MedicationStatement.reasonReference |
|
See the Full Difference for further information
This
analysis
is
available
for
R4
as
XML
or
JSON
.
See
R3
<-->
R4
Conversion
Maps
(status
=
7
tests
that
all
execute
ok.
3
fail
round-trip
testing
and
7
r3
resources
are
invalid
(0
errors).
)
for
R4B
as
XML
or
JSON
.
Structure
| Name | Flags | Card. | Type |
Description
&
Constraints
Filter:
|
|---|---|---|---|---|
|
MedicationStatement
|
TU | DomainResource |
Record
of
medication
being
taken
by
a
patient
Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension |
|
|
identifier
|
Σ | 0..* | Identifier |
External
identifier
|
|
partOf
|
0..* |
Reference
(
|
Part
of
referenced
event
|
|
|
status
|
?! Σ | 1..1 | code |
recorded
|
entered-in-error
|
|
|
category
|
Σ | 0..* | CodeableConcept |
Type
of
medication
|
|
medication
|
Σ | 1..1 | CodeableReference ( Medication ) |
What
medication
was
taken
Binding: SNOMED CT Medication Codes ( Example ) |
|
subject
|
Σ | 1..1 | Reference ( Patient | Group ) |
Who
is/was
taking
the
medication
|
|
|
Σ | 0..1 |
Reference
(
Encounter
|
Encounter
|
|
effective[x]
|
Σ | 0..1 |
The
date/time
or
interval
when
the
medication
is/was/will
be
taken
|
|
|
effectiveDateTime
|
dateTime | |||
|
effectivePeriod
|
Period | |||
|
effectiveTiming
| Timing | |||
|
dateAsserted
|
Σ | 0..1 | dateTime |
When
the
|
|
author
|
Σ | 0..1 | Reference ( Practitioner | PractitionerRole | Organization | Patient | RelatedPerson | Device ) |
Who/What
authored
the
statement
|
|
informationSource
| 0..* | Reference ( Device | Patient | Practitioner | PractitionerRole | RelatedPerson | Organization | Group ) |
Person
or
organization
that
provided
the
information
about
the
taking
of
this
medication
|
|
|
derivedFrom
|
0..* | Reference ( Any ) |
Link
to
information
used
to
derive
the
MedicationStatement
|
|
|
reason
|
0..* |
|
Reason
for
why
the
medication
is
being/was
taken
Binding: Condition/Problem/Diagnosis Codes ( Example ) |
|
|
note
|
0..* | Annotation |
Further
information
about
the
usage
|
|
|
relatedClinicalInformation
| 0..* |
Reference
(
|
Link
to
information
relevant
to
the
usage
of
a
medication
|
|
|
renderedDosageInstruction
|
0..1 |
|
Full
representation
of
the
|
|
|
dosage
|
0..* | Dosage |
Details
of
how
medication
is/was
taken
or
should
be
taken
|
|
|
adherence
| Σ | 0..1 | BackboneElement |
Indicates
whether
the
medication
is
or
is
not
being
consumed
or
administered
|
|
code
| Σ | 1..1 | CodeableConcept |
Type
of
adherence
Binding: MedicationStatement Adherence Codes ( Example ) |
|
reason
| 0..1 | CodeableConcept |
Details
of
the
reason
for
the
current
use
of
the
medication
Binding: SNOMED CT Drug Therapy Status codes ( Example ) | |
|
Documentation
for
this
format
|
||||
See the Extensions for this resource
XML Template
<<a href="medicationstatement-definitions.html#MedicationStatement" title="A record of a medication that is being consumed by a patient. A MedicationStatement may indicate that the patient may be taking the medication now or has taken the medication in the past or will be taking the medication in the future. The source of this information can be the patient, significant other (such as a family member or spouse), or a clinician. A common scenario where this information is captured is during the history taking process during a patient visit or stay. The medication information may come from sources such as the patient's memory, from a prescription bottle, or from a list of medications the patient, clinician or other party maintains. The primary difference between a medication statement and a medication administration is that the medication administration has complete administration information and is based on actual administration information from the person who administered the medication. A medication statement is often, if not always, less specific. There is no required date/time when the medication was administered, in fact we only know that a source has reported the patient is taking this medication, where details such as time, quantity, or rate or even medication product may be incomplete or missing or less precise. As stated earlier, the medication statement information may come from the patient's memory, from a prescription bottle or from a list of medications the patient, clinician or other party maintains. Medication administration is more formal and is not missing detailed information." class="dict"><MedicationStatement xmlns="http://hl7.org/fhir"><</basedOn> <| </partOf> < <</statusReason> <</category> <</medication[x]> <</subject> <</context> <</effective[x]> < <| </informationSource> <</derivedFrom> <</reasonCode> <</reasonReference> <</note><partOf><!-- 0..* Reference(MedicationStatement|Procedure) Part of referenced event --></partOf> <status value="[code]"/><!-- 1..1 recorded | entered-in-error | draft --> <category><!-- 0..* CodeableConcept Type of medication statement --></category> <medication><!-- 1..1 CodeableReference(Medication) What medication was taken --></medication> <subject><!-- 1..1 Reference(Group|Patient) Who is/was taking the medication --></subject> <encounter><!-- 0..1 Reference(Encounter) Encounter associated with MedicationStatement --></encounter> <effective[x]><!-- 0..1 dateTime|Period|Timing The date/time or interval when the medication is/was/will be taken --></effective[x]> <dateAsserted value="[dateTime]"/><!-- 0..1 When the usage was asserted? --> <author><!-- 0..1 Reference(Device|Organization|Patient|Practitioner| PractitionerRole|RelatedPerson) Who/What authored the statement --></author> <informationSource><!-- 0..* Reference(Device|Group|Organization|Patient| Practitioner|PractitionerRole|RelatedPerson) Person or organization that provided the information about the taking of this medication --></informationSource> <derivedFrom><!-- 0..* Reference(Any) Link to information used to derive the MedicationStatement --></derivedFrom> <reason><!-- 0..* CodeableReference(Condition|DiagnosticReport|Observation| Procedure) Reason for why the medication is being/was taken --></reason> <note><!-- 0..* Annotation Further information about the usage --></note> <relatedClinicalInformation><!-- 0..* Reference(Condition|Observation) Link to information relevant to the usage of a medication --></relatedClinicalInformation> <renderedDosageInstruction value="[markdown]"/><!-- 0..1 Full representation of the dosage instructions --> <dosage><!-- 0..* Dosage Details of how medication is/was taken or should be taken --></dosage> <adherence> <!-- 0..1 Indicates whether the medication is or is not being consumed or administered --> <code><!-- 1..1 CodeableConcept Type of adherence --></code> <reason><!-- 0..1 CodeableConcept Details of the reason for the current use of the medication --></reason> </adherence> </MedicationStatement>
JSON Template
{
"resourceType" : "<a href="medicationstatement-definitions.html#MedicationStatement" title="A record of a medication that is being consumed by a patient. A MedicationStatement may indicate that the patient may be taking the medication now or has taken the medication in the past or will be taking the medication in the future. The source of this information can be the patient, significant other (such as a family member or spouse), or a clinician. A common scenario where this information is captured is during the history taking process during a patient visit or stay. The medication information may come from sources such as the patient's memory, from a prescription bottle, or from a list of medications the patient, clinician or other party maintains.
The primary difference between a medication statement and a medication administration is that the medication administration has complete administration information and is based on actual administration information from the person who administered the medication. A medication statement is often, if not always, less specific. There is no required date/time when the medication was administered, in fact we only know that a source has reported the patient is taking this medication, where details such as time, quantity, or rate or even medication product may be incomplete or missing or less precise. As stated earlier, the medication statement information may come from the patient's memory, from a prescription bottle or from a list of medications the patient, clinician or other party maintains. Medication administration is more formal and is not missing detailed information." class="dict">",
"resourceType" : "MedicationStatement",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"identifier" : [{ Identifier }], // External identifier
"
"|
"
"
"
" },
" },
"
"
">",
" },
"
"|
"
"
"
"
"
"partOf" : [{ Reference(MedicationStatement|Procedure) }], // Part of referenced event
"status" : "<code>", // R! recorded | entered-in-error | draft
"category" : [{ CodeableConcept }], // Type of medication statement
"medication" : { CodeableReference(Medication) }, // R! What medication was taken
"subject" : { Reference(Group|Patient) }, // R! Who is/was taking the medication
"encounter" : { Reference(Encounter) }, // Encounter associated with MedicationStatement
// effective[x]: The date/time or interval when the medication is/was/will be taken. One of these 3:
"effectiveDateTime" : "<dateTime>",
"effectivePeriod" : { Period },
"effectiveTiming" : { Timing },
"dateAsserted" : "<dateTime>", // When the usage was asserted?
"author" : { Reference(Device|Organization|Patient|Practitioner|
PractitionerRole|RelatedPerson) }, // Who/What authored the statement
"informationSource" : [{ Reference(Device|Group|Organization|Patient|
Practitioner|PractitionerRole|RelatedPerson) }], // Person or organization that provided the information about the taking of this medication
"derivedFrom" : [{ Reference(Any) }], // Link to information used to derive the MedicationStatement
"reason" : [{ CodeableReference(Condition|DiagnosticReport|Observation|
Procedure) }], // Reason for why the medication is being/was taken
"note" : [{ Annotation }], // Further information about the usage
"relatedClinicalInformation" : [{ Reference(Condition|Observation) }], // Link to information relevant to the usage of a medication
"renderedDosageInstruction" : "<markdown>", // Full representation of the dosage instructions
"dosage" : [{ Dosage }], // Details of how medication is/was taken or should be taken
"adherence" : { // Indicates whether the medication is or is not being consumed or administered
"code" : { CodeableConcept }, // R! Type of adherence
"reason" : { CodeableConcept } // Details of the reason for the current use of the medication
}
}
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> .[ a fhir:<a href="medicationstatement-definitions.html#MedicationStatement" title="A record of a medication that is being consumed by a patient. A MedicationStatement may indicate that the patient may be taking the medication now or has taken the medication in the past or will be taking the medication in the future. The source of this information can be the patient, significant other (such as a family member or spouse), or a clinician. A common scenario where this information is captured is during the history taking process during a patient visit or stay. The medication information may come from sources such as the patient's memory, from a prescription bottle, or from a list of medications the patient, clinician or other party maintains. The primary difference between a medication statement and a medication administration is that the medication administration has complete administration information and is based on actual administration information from the person who administered the medication. A medication statement is often, if not always, less specific. There is no required date/time when the medication was administered, in fact we only know that a source has reported the patient is taking this medication, where details such as time, quantity, or rate or even medication product may be incomplete or missing or less precise. As stated earlier, the medication statement information may come from the patient's memory, from a prescription bottle or from a list of medications the patient, clinician or other party maintains. Medication administration is more formal and is not missing detailed information." class="dict">;[ a fhir:MedicationStatement; fhir:nodeRole fhir:treeRoot; # if this is the parser root# from # from fhir: fhir: fhir:| fhir: fhir: fhir: # . One of these 2 fhir: ] fhir:) ] fhir: fhir: # . One of these 2 fhir: ] fhir: ] fhir: fhir: fhir: fhir: fhir: fhir: fhir:# from Resource: fhir:id, fhir:meta, fhir:implicitRules, and fhir:language # from DomainResource: fhir:text, fhir:contained, fhir:extension, and fhir:modifierExtension fhir:identifier ( [ Identifier ] ... ) ; # 0..* External identifier fhir:partOf ( [ Reference(MedicationStatement|Procedure) ] ... ) ; # 0..* Part of referenced event fhir:status [ code ] ; # 1..1 recorded | entered-in-error | draft fhir:category ( [ CodeableConcept ] ... ) ; # 0..* Type of medication statement fhir:medication [ CodeableReference(Medication) ] ; # 1..1 What medication was taken fhir:subject [ Reference(Group|Patient) ] ; # 1..1 Who is/was taking the medication fhir:encounter [ Reference(Encounter) ] ; # 0..1 Encounter associated with MedicationStatement # effective[x] : 0..1 The date/time or interval when the medication is/was/will be taken. One of these 3 fhir:effective [ a fhir:DateTime ; dateTime ] fhir:effective [ a fhir:Period ; Period ] fhir:effective [ a fhir:Timing ; Timing ] fhir:dateAsserted [ dateTime ] ; # 0..1 When the usage was asserted? fhir:author [ Reference(Device|Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) ] ; # 0..1 Who/What authored the statement fhir:informationSource ( [ Reference(Device|Group|Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) ] ... ) ; # 0..* Person or organization that provided the information about the taking of this medication fhir:derivedFrom ( [ Reference(Any) ] ... ) ; # 0..* Link to information used to derive the MedicationStatement fhir:reason ( [ CodeableReference(Condition|DiagnosticReport|Observation|Procedure) ] ... ) ; # 0..* Reason for why the medication is being/was taken fhir:note ( [ Annotation ] ... ) ; # 0..* Further information about the usage fhir:relatedClinicalInformation ( [ Reference(Condition|Observation) ] ... ) ; # 0..* Link to information relevant to the usage of a medication fhir:renderedDosageInstruction [ markdown ] ; # 0..1 Full representation of the dosage instructions fhir:dosage ( [ Dosage ] ... ) ; # 0..* Details of how medication is/was taken or should be taken fhir:adherence [ # 0..1 Indicates whether the medication is or is not being consumed or administered fhir:code [ CodeableConcept ] ; # 1..1 Type of adherence fhir:reason [ CodeableConcept ] ; # 0..1 Details of the reason for the current use of the medication ] ; ]
Changes
since
Release
3
from
both
R4
and
R4B
| MedicationStatement | |
|
|
|
| MedicationStatement.status |
|
| MedicationStatement.category |
|
| MedicationStatement.medication |
|
| MedicationStatement.encounter |
|
|
|
|
|
|
|
| MedicationStatement.informationSource |
|
|
|
|
| MedicationStatement.relatedClinicalInformation |
|
| MedicationStatement.renderedDosageInstruction |
|
| MedicationStatement.adherence |
|
| MedicationStatement.adherence.code |
|
| MedicationStatement.adherence.reason |
|
|
|
|
|
|
|
| MedicationStatement.reasonCode |
|
| MedicationStatement.reasonReference |
|
See the Full Difference for further information
This
analysis
is
available
for
R4
as
XML
or
JSON
.
See
R3
<-->
R4
Conversion
Maps
(status
=
7
tests
that
all
execute
ok.
3
fail
round-trip
testing
and
7
r3
resources
are
invalid
(0
errors).
)
for
R4B
as
XML
or
JSON
.
See
the
Profiles
&
Extensions
and
the
alternate
Additional
definitions:
Master
Definition
XML
+
JSON
,
XML
Schema
/
Schematron
+
JSON
Schema
,
ShEx
(for
Turtle
)
+
see
the
extensions
,
the
spreadsheet
version
&
the
dependency
analysis
| Path |
|
Type |
|
|---|---|---|---|
| MedicationStatement.status |
|
Required |
MedicationStatement Status Codes |
| MedicationStatement.category |
|
Example |
MedicationRequest Category Codes |
| MedicationStatement.medication |
|
|
This value set includes all drug or medicament substance codes and all pharmaceutical/biologic products from SNOMED CT - provided as an exemplar value set. |
| MedicationStatement.reason |
|
Example |
Example value set for Condition/Problem/Diagnosis codes. |
| MedicationStatement.adherence.code |
|
Example |
MedicationStatement Adherence Codes |
| MedicationStatement.adherence.reason |
|
Example | This value set includes some taken and not taken reason codes from SNOMED CT - provided as an exemplar |
Search parameters for this resource. See also the full list of search parameters for this resource , and check the Extensions registry for search parameters on extensions related to this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.
| Name | Type | Description | Expression | In Common |
|
|
token |
Returns
statements
|
|
|
|
category
|
token |
|
|
|
|
|
|
|
|
19 Resources |
| effective | date | Date when patient was taking (or not taking) the medication |
|
|
|
encounter
|
|
|
( Encounter ) |
|
|
identifier
|
|
Return
statements
|
|
|
|
|
reference |
|
|
4 Resources |
| patient | reference | Returns statements for a specific patient. |
MedicationStatement.subject.where(resolve()
is
Patient)
( Patient ) |
|
| source | reference | Who or where the information in the statement came from |
MedicationStatement.informationSource
( Practitioner , Group , Organization , Device , Patient , PractitionerRole , RelatedPerson ) |
|
| status | token | Return statements that match the given status | MedicationStatement.status |
|
| subject | reference | The identity of a patient, animal or group to list statements for |
MedicationStatement.subject
( Group , Patient ) |
FHIR
®©
HL7.org
2011+.
FHIR
Release
4
(Technical
Correction
#1)
(v4.0.1)
R6
hl7.fhir.core#6.0.0-ballot3
generated
on
Fri,
Thu,
Nov
1,
2019
09:36+1100.
QA
Page
13,
2025
03:08+0000.
Links:
Search
|
Version
History
|
Table
of
Contents
|
Credits
Glossary
|
QA
|
Compare
to
R3
R4
|
Compare
to
R5
|
Compare
to
Last
Ballot
|
|
Propose
a
change