UK Core Implementation Guide 1.0.0 - STU1

StructureDefinition-UKCore-MedicationStatement

This UK Core profile is a restraint on the International FHIR resource MedicationStatement, and defines the constraints, extensions, and minimal set of data to query and retrieve medication statement information.

Profile Purpose

This profile allows exchange of a record of a medication that is being consumed by a patient. A MedicationStatement may indicate that the individual 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 individual, significant other (such as a family member or spouse), or a clinician.

Snapshot View

pharmacistVerifiedIndicatorI0..1Extension(boolean)
medicationPrescribingOrganizationTypeI0..1Extension(CodeableConcept)
medicationStatementLastIssueDateI0..1Extension(dateTime)
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ1..1uri
valueΣ1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
displayΣ0..1string
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
displayΣ0..1string
statusΣ ?!1..1codeBinding
statusReason0..*CodeableConcept
categoryΣ0..1CodeableConceptBinding
medicationCodeableConceptCodeableConcept
medicationReferenceReference(UK Core Medication)
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
displayΣ0..1string
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
displayΣ0..1string
effectiveDateTimedateTime
effectivePeriodPeriod
dateAssertedΣ0..1dateTime
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
displayΣ0..1string
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
displayΣ0..1string
reasonCode0..*CodeableConcept
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
displayΣ0..1string
authorStringstring
authorReferenceReference(UK Core Patient | UK Core Practitioner | RelatedPerson)
timeΣ0..1dateTime
textΣ1..1markdown
sequenceΣ0..1integer
textΣ0..1string
additionalInstructionΣ0..*CodeableConcept
patientInstructionΣ0..1string
timingΣ0..1Timing
asNeededBooleanboolean
asNeededCodeableConceptCodeableConcept
siteΣ0..1CodeableConceptBinding
routeΣ0..1CodeableConceptBinding
methodΣ0..1CodeableConceptBinding
typeΣ0..1CodeableConcept
doseRangeRange
doseQuantitySimpleQuantity
rateRatioRatio
rateRangeRange
rateQuantitySimpleQuantity
maxDosePerPeriodΣ I0..1Ratio
maxDosePerAdministrationΣ I0..1SimpleQuantity
maxDosePerLifetimeΣ I0..1SimpleQuantity

Differential View

pharmacistVerifiedIndicatorI0..1Extension(boolean)
medicationPrescribingOrganizationTypeI0..1Extension(CodeableConcept)
medicationStatementLastIssueDateI0..1Extension(dateTime)
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ1..1uri
valueΣ1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
displayΣ0..1string
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
displayΣ0..1string
statusΣ ?!1..1codeBinding
statusReason0..*CodeableConcept
categoryΣ0..1CodeableConceptBinding
medicationCodeableConceptCodeableConcept
medicationReferenceReference(UK Core Medication)
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
displayΣ0..1string
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
displayΣ0..1string
effectiveDateTimedateTime
effectivePeriodPeriod
dateAssertedΣ0..1dateTime
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
displayΣ0..1string
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
displayΣ0..1string
reasonCode0..*CodeableConcept
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
displayΣ0..1string
authorStringstring
authorReferenceReference(UK Core Patient | UK Core Practitioner | RelatedPerson)
timeΣ0..1dateTime
textΣ1..1markdown
sequenceΣ0..1integer
textΣ0..1string
additionalInstructionΣ0..*CodeableConcept
patientInstructionΣ0..1string
timingΣ0..1Timing
asNeededBooleanboolean
asNeededCodeableConceptCodeableConcept
siteΣ0..1CodeableConceptBinding
routeΣ0..1CodeableConceptBinding
methodΣ0..1CodeableConceptBinding
typeΣ0..1CodeableConcept
doseRangeRange
doseQuantitySimpleQuantity
rateRatioRatio
rateRangeRange
rateQuantitySimpleQuantity
maxDosePerPeriodΣ I0..1Ratio
maxDosePerAdministrationΣ I0..1SimpleQuantity
maxDosePerLifetimeΣ I0..1SimpleQuantity

Hybrid View

pharmacistVerifiedIndicatorI0..1Extension(boolean)
medicationPrescribingOrganizationTypeI0..1Extension(CodeableConcept)
medicationStatementLastIssueDateI0..1Extension(dateTime)
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ1..1uri
valueΣ1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
displayΣ0..1string
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
displayΣ0..1string
statusΣ ?!1..1codeBinding
statusReason0..*CodeableConcept
categoryΣ0..1CodeableConceptBinding
medicationCodeableConceptCodeableConcept
medicationReferenceReference(UK Core Medication)
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
displayΣ0..1string
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
displayΣ0..1string
effectiveDateTimedateTime
effectivePeriodPeriod
dateAssertedΣ0..1dateTime
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
displayΣ0..1string
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
displayΣ0..1string
reasonCode0..*CodeableConcept
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
displayΣ0..1string
authorStringstring
authorReferenceReference(UK Core Patient | UK Core Practitioner | RelatedPerson)
timeΣ0..1dateTime
textΣ1..1markdown
sequenceΣ0..1integer
textΣ0..1string
additionalInstructionΣ0..*CodeableConcept
patientInstructionΣ0..1string
timingΣ0..1Timing
asNeededBooleanboolean
asNeededCodeableConceptCodeableConcept
siteΣ0..1CodeableConceptBinding
routeΣ0..1CodeableConceptBinding
methodΣ0..1CodeableConceptBinding
typeΣ0..1CodeableConcept
doseRangeRange
doseQuantitySimpleQuantity
rateRatioRatio
rateRangeRange
rateQuantitySimpleQuantity
maxDosePerPeriodΣ I0..1Ratio
maxDosePerAdministrationΣ I0..1SimpleQuantity
maxDosePerLifetimeΣ I0..1SimpleQuantity

Table View

MedicationStatement..
MedicationStatement.extension..
MedicationStatement.extensionExtension..
MedicationStatement.extensionExtension..
MedicationStatement.extensionExtension..
MedicationStatement.identifier..
MedicationStatement.identifier.system1..
MedicationStatement.identifier.value1..
MedicationStatement.identifier.assignerReference(UK Core Organization)..
MedicationStatement.basedOnReference(CarePlan | UK Core MedicationRequest | ServiceRequest)..
MedicationStatement.basedOn.identifier..
MedicationStatement.basedOn.identifier.assignerReference(UK Core Organization)..
MedicationStatement.partOfReference(UK Core MedicationDispense | UK Core MedicationStatement | Observation | Procedure | UK Core MedicationAdministration)..
MedicationStatement.partOf.identifier..
MedicationStatement.partOf.identifier.assignerReference(UK Core Organization)..
MedicationStatement.category..
MedicationStatement.medication[x]CodeableConcept, Reference(UK Core Medication)..
MedicationStatement.subjectReference(Group | UK Core Patient)..
MedicationStatement.subject.identifier..
MedicationStatement.subject.identifier.assignerReference(UK Core Organization)..
MedicationStatement.contextReference(EpisodeOfCare | Encounter)..
MedicationStatement.context.identifier..
MedicationStatement.context.identifier.assignerReference(UK Core Organization)..
MedicationStatement.informationSourceReference(UK Core Organization | UK Core Patient | UK Core Practitioner | RelatedPerson | UK Core PractitionerRole)..
MedicationStatement.informationSource.identifier..
MedicationStatement.informationSource.identifier.assignerReference(UK Core Organization)..
MedicationStatement.derivedFrom..
MedicationStatement.derivedFrom.identifier..
MedicationStatement.derivedFrom.identifier.assignerReference(UK Core Organization)..
MedicationStatement.reasonReferenceReference(Condition | Observation | DiagnosticReport)..
MedicationStatement.reasonReference.identifier..
MedicationStatement.reasonReference.identifier.assignerReference(UK Core Organization)..
MedicationStatement.note..
MedicationStatement.note.author[x]Reference(UK Core Patient | UK Core Practitioner | RelatedPerson), string..
MedicationStatement.dosage..
MedicationStatement.dosage.asNeeded[x]..
MedicationStatement.dosage.site..
MedicationStatement.dosage.route..
MedicationStatement.dosage.method..


XML View

<StructureDefinition xmlns="http://hl7.org/fhir">
    <id value="UKCore-MedicationStatement" />
    <url value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-MedicationStatement" />
    <version value="2.3.0" />
    <name value="UKCoreMedicationStatement" />
    <title value="UK Core MedicationStatement" />
    <status value="active" />
    <date value="2022-08-26" />
    <publisher value="HL7 UK" />
    <contact>
        <name value="HL7 UK" />
        <telecom>
            <system value="email" />
            <value value="ukcore@hl7.org.uk" />
            <use value="work" />
            <rank value="1" />
        </telecom>
    </contact>
    <description value="Defines the UK Core constraints and extensions on the MedicationStatement resource for the minimal set of data to query and retrieve medication statement information." />
    <purpose value="This profile allows exchange of a record of a medication that is being consumed by a patient. A MedicationStatement may indicate that the individual 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 individual, significant other (such as a family member or spouse), or a clinician." />
    <copyright value="Copyright &#169; 2021+ HL7 UK Licensed under the Apache License, Version 2.0 (the &quot;License&quot;); you may not use this file except in compliance with the License. You may obtain a copy of the License at  http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. HL7&#174; FHIR&#174; standard Copyright &#169; 2011+ HL7 The HL7&#174; FHIR&#174; standard is used under the FHIR license. You may obtain a copy of the FHIR license at  https://www.hl7.org/fhir/license.html." />
    <fhirVersion value="4.0.1" />
    <mapping>
        <identity value="workflow" />
        <uri value="http://hl7.org/fhir/workflow" />
        <name value="Workflow Pattern" />
    </mapping>
    <mapping>
        <identity value="rim" />
        <uri value="http://hl7.org/v3" />
        <name value="RIM Mapping" />
    </mapping>
    <mapping>
        <identity value="w5" />
        <uri value="http://hl7.org/fhir/fivews" />
        <name value="FiveWs Pattern Mapping" />
    </mapping>
    <mapping>
        <identity value="v2" />
        <uri value="http://hl7.org/v2" />
        <name value="HL7 v2 Mapping" />
    </mapping>
    <kind value="resource" />
    <abstract value="false" />
    <type value="MedicationStatement" />
    <baseDefinition value="http://hl7.org/fhir/StructureDefinition/MedicationStatement" />
    <derivation value="constraint" />
    <differential>
        <element id="MedicationStatement.extension">
            <path value="MedicationStatement.extension" />
            <slicing>
                <discriminator>
                    <type value="value" />
                    <path value="url" />
                </discriminator>
                <rules value="open" />
            </slicing>
        </element>
        <element id="MedicationStatement.extension:pharmacistVerifiedIndicator">
            <path value="MedicationStatement.extension" />
            <sliceName value="pharmacistVerifiedIndicator" />
            <short value="Indicates whether a pharmacist verified a medication" />
            <type>
                <code value="Extension" />
                <profile value="https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-PharmacistVerifiedIndicator" />
            </type>
        </element>
        <element id="MedicationStatement.extension:medicationPrescribingOrganizationType">
            <path value="MedicationStatement.extension" />
            <sliceName value="medicationPrescribingOrganizationType" />
            <type>
                <code value="Extension" />
                <profile value="https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-MedicationPrescribingOrganizationType" />
            </type>
        </element>
        <element id="MedicationStatement.extension:medicationStatementLastIssueDate">
            <path value="MedicationStatement.extension" />
            <sliceName value="medicationStatementLastIssueDate" />
            <type>
                <code value="Extension" />
                <profile value="https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-MedicationStatementLastIssueDate" />
            </type>
        </element>
        <element id="MedicationStatement.identifier.system">
            <path value="MedicationStatement.identifier.system" />
            <min value="1" />
        </element>
        <element id="MedicationStatement.identifier.value">
            <path value="MedicationStatement.identifier.value" />
            <min value="1" />
        </element>
        <element id="MedicationStatement.identifier.assigner">
            <path value="MedicationStatement.identifier.assigner" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization" />
            </type>
        </element>
        <element id="MedicationStatement.basedOn">
            <path value="MedicationStatement.basedOn" />
            <type>
                <code value="Reference" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/CarePlan" />
                <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-MedicationRequest" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/ServiceRequest" />
            </type>
        </element>
        <element id="MedicationStatement.basedOn.identifier.assigner">
            <path value="MedicationStatement.basedOn.identifier.assigner" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization" />
            </type>
        </element>
        <element id="MedicationStatement.partOf">
            <path value="MedicationStatement.partOf" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-MedicationDispense" />
                <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-MedicationStatement" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/Observation" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/Procedure" />
                <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-MedicationAdministration" />
            </type>
        </element>
        <element id="MedicationStatement.partOf.identifier.assigner">
            <path value="MedicationStatement.partOf.identifier.assigner" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization" />
            </type>
        </element>
        <element id="MedicationStatement.category">
            <path value="MedicationStatement.category" />
            <binding>
                <strength value="extensible" />
                <valueSet value="https://fhir.hl7.org.uk/ValueSet/UKCore-MedicationStatementCategory" />
            </binding>
        </element>
        <element id="MedicationStatement.medication[x]">
            <path value="MedicationStatement.medication[x]" />
            <type>
                <code value="CodeableConcept" />
            </type>
            <type>
                <code value="Reference" />
                <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Medication" />
            </type>
            <binding>
                <strength value="preferred" />
                <valueSet value="https://fhir.hl7.org.uk/ValueSet/UKCore-MedicationCode" />
            </binding>
        </element>
        <element id="MedicationStatement.subject">
            <path value="MedicationStatement.subject" />
            <type>
                <code value="Reference" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/Group" />
                <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Patient" />
            </type>
        </element>
        <element id="MedicationStatement.subject.identifier.assigner">
            <path value="MedicationStatement.subject.identifier.assigner" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization" />
            </type>
        </element>
        <element id="MedicationStatement.context">
            <path value="MedicationStatement.context" />
            <type>
                <code value="Reference" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/EpisodeOfCare" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/Encounter" />
            </type>
        </element>
        <element id="MedicationStatement.context.identifier.assigner">
            <path value="MedicationStatement.context.identifier.assigner" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization" />
            </type>
        </element>
        <element id="MedicationStatement.informationSource">
            <path value="MedicationStatement.informationSource" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization" />
                <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Patient" />
                <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Practitioner" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/RelatedPerson" />
                <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-PractitionerRole" />
            </type>
        </element>
        <element id="MedicationStatement.informationSource.identifier.assigner">
            <path value="MedicationStatement.informationSource.identifier.assigner" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization" />
            </type>
        </element>
        <element id="MedicationStatement.derivedFrom.identifier.assigner">
            <path value="MedicationStatement.derivedFrom.identifier.assigner" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization" />
            </type>
        </element>
        <element id="MedicationStatement.reasonReference">
            <path value="MedicationStatement.reasonReference" />
            <type>
                <code value="Reference" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/Condition" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/Observation" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/DiagnosticReport" />
            </type>
        </element>
        <element id="MedicationStatement.reasonReference.identifier.assigner">
            <path value="MedicationStatement.reasonReference.identifier.assigner" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization" />
            </type>
        </element>
        <element id="MedicationStatement.note.author[x]">
            <path value="MedicationStatement.note.author[x]" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Patient" />
                <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Practitioner" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/RelatedPerson" />
            </type>
            <type>
                <code value="string" />
            </type>
        </element>
        <element id="MedicationStatement.dosage.asNeeded[x]">
            <path value="MedicationStatement.dosage.asNeeded[x]" />
            <binding>
                <strength value="extensible" />
                <description value="A set of codes that define a precondition for taking a medication" />
                <valueSet value="https://fhir.hl7.org.uk/ValueSet/UKCore-MedicationPrecondition" />
            </binding>
        </element>
        <element id="MedicationStatement.dosage.site">
            <path value="MedicationStatement.dosage.site" />
            <binding>
                <strength value="extensible" />
                <valueSet value="https://fhir.hl7.org.uk/ValueSet/UKCore-BodySite" />
            </binding>
        </element>
        <element id="MedicationStatement.dosage.route">
            <path value="MedicationStatement.dosage.route" />
            <binding>
                <strength value="extensible" />
                <valueSet value="https://fhir.hl7.org.uk/ValueSet/UKCore-SubstanceOrProductAdministrationRoute" />
            </binding>
        </element>
        <element id="MedicationStatement.dosage.method">
            <path value="MedicationStatement.dosage.method" />
            <binding>
                <strength value="extensible" />
                <valueSet value="https://fhir.hl7.org.uk/ValueSet/UKCore-MedicationDosageMethod" />
            </binding>
        </element>
    </differential>
</StructureDefinition>

XML View

{
    "resourceType": "StructureDefinition",
    "id": "UKCore-MedicationStatement",
    "url": "https://fhir.hl7.org.uk/StructureDefinition/UKCore-MedicationStatement",
    "version": "2.3.0",
    "name": "UKCoreMedicationStatement",
    "title": "UK Core MedicationStatement",
    "status": "active",
    "date": "2022-08-26",
    "publisher": "HL7 UK",
    "contact":  [
        {
            "name": "HL7 UK",
            "telecom":  [
                {
                    "system": "email",
                    "value": "ukcore@hl7.org.uk",
                    "use": "work",
                    "rank": 1
                }
            ]
        }
    ],
    "description": "Defines the UK Core constraints and extensions on the MedicationStatement resource for the minimal set of data to query and retrieve medication statement information.",
    "purpose": "This profile allows exchange of a record of a medication that is being consumed by a patient. A MedicationStatement may indicate that the individual 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 individual, significant other (such as a family member or spouse), or a clinician.",
    "copyright": "Copyright © 2021+ HL7 UK Licensed under the Apache License, Version 2.0 (the \"License\"); you may not use this file except in compliance with the License. You may obtain a copy of the License at  http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. HL7® FHIR® standard Copyright © 2011+ HL7 The HL7® FHIR® standard is used under the FHIR license. You may obtain a copy of the FHIR license at  https://www.hl7.org/fhir/license.html.",
    "fhirVersion": "4.0.1",
    "mapping":  [
        {
            "identity": "workflow",
            "uri": "http://hl7.org/fhir/workflow",
            "name": "Workflow Pattern"
        },
        {
            "identity": "rim",
            "uri": "http://hl7.org/v3",
            "name": "RIM Mapping"
        },
        {
            "identity": "w5",
            "uri": "http://hl7.org/fhir/fivews",
            "name": "FiveWs Pattern Mapping"
        },
        {
            "identity": "v2",
            "uri": "http://hl7.org/v2",
            "name": "HL7 v2 Mapping"
        }
    ],
    "kind": "resource",
    "abstract": false,
    "type": "MedicationStatement",
    "baseDefinition": "http://hl7.org/fhir/StructureDefinition/MedicationStatement",
    "derivation": "constraint",
    "differential": {
        "element":  [
            {
                "id": "MedicationStatement.extension",
                "path": "MedicationStatement.extension",
                "slicing": {
                    "discriminator":  [
                        {
                            "type": "value",
                            "path": "url"
                        }
                    ],
                    "rules": "open"
                }
            },
            {
                "id": "MedicationStatement.extension:pharmacistVerifiedIndicator",
                "path": "MedicationStatement.extension",
                "sliceName": "pharmacistVerifiedIndicator",
                "short": "Indicates whether a pharmacist verified a medication",
                "type":  [
                    {
                        "code": "Extension",
                        "profile":  [
                            "https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-PharmacistVerifiedIndicator"
                        ]
                    }
                ]
            },
            {
                "id": "MedicationStatement.extension:medicationPrescribingOrganizationType",
                "path": "MedicationStatement.extension",
                "sliceName": "medicationPrescribingOrganizationType",
                "type":  [
                    {
                        "code": "Extension",
                        "profile":  [
                            "https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-MedicationPrescribingOrganizationType"
                        ]
                    }
                ]
            },
            {
                "id": "MedicationStatement.extension:medicationStatementLastIssueDate",
                "path": "MedicationStatement.extension",
                "sliceName": "medicationStatementLastIssueDate",
                "type":  [
                    {
                        "code": "Extension",
                        "profile":  [
                            "https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-MedicationStatementLastIssueDate"
                        ]
                    }
                ]
            },
            {
                "id": "MedicationStatement.identifier.system",
                "path": "MedicationStatement.identifier.system",
                "min": 1
            },
            {
                "id": "MedicationStatement.identifier.value",
                "path": "MedicationStatement.identifier.value",
                "min": 1
            },
            {
                "id": "MedicationStatement.identifier.assigner",
                "path": "MedicationStatement.identifier.assigner",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization"
                        ]
                    }
                ]
            },
            {
                "id": "MedicationStatement.basedOn",
                "path": "MedicationStatement.basedOn",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "http://hl7.org/fhir/StructureDefinition/CarePlan",
                            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-MedicationRequest",
                            "http://hl7.org/fhir/StructureDefinition/ServiceRequest"
                        ]
                    }
                ]
            },
            {
                "id": "MedicationStatement.basedOn.identifier.assigner",
                "path": "MedicationStatement.basedOn.identifier.assigner",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization"
                        ]
                    }
                ]
            },
            {
                "id": "MedicationStatement.partOf",
                "path": "MedicationStatement.partOf",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-MedicationDispense",
                            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-MedicationStatement",
                            "http://hl7.org/fhir/StructureDefinition/Observation",
                            "http://hl7.org/fhir/StructureDefinition/Procedure",
                            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-MedicationAdministration"
                        ]
                    }
                ]
            },
            {
                "id": "MedicationStatement.partOf.identifier.assigner",
                "path": "MedicationStatement.partOf.identifier.assigner",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization"
                        ]
                    }
                ]
            },
            {
                "id": "MedicationStatement.category",
                "path": "MedicationStatement.category",
                "binding": {
                    "strength": "extensible",
                    "valueSet": "https://fhir.hl7.org.uk/ValueSet/UKCore-MedicationStatementCategory"
                }
            },
            {
                "id": "MedicationStatement.medication[x]",
                "path": "MedicationStatement.medication[x]",
                "type":  [
                    {
                        "code": "CodeableConcept"
                    },
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Medication"
                        ]
                    }
                ],
                "binding": {
                    "strength": "preferred",
                    "valueSet": "https://fhir.hl7.org.uk/ValueSet/UKCore-MedicationCode"
                }
            },
            {
                "id": "MedicationStatement.subject",
                "path": "MedicationStatement.subject",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "http://hl7.org/fhir/StructureDefinition/Group",
                            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Patient"
                        ]
                    }
                ]
            },
            {
                "id": "MedicationStatement.subject.identifier.assigner",
                "path": "MedicationStatement.subject.identifier.assigner",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization"
                        ]
                    }
                ]
            },
            {
                "id": "MedicationStatement.context",
                "path": "MedicationStatement.context",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "http://hl7.org/fhir/StructureDefinition/EpisodeOfCare",
                            "http://hl7.org/fhir/StructureDefinition/Encounter"
                        ]
                    }
                ]
            },
            {
                "id": "MedicationStatement.context.identifier.assigner",
                "path": "MedicationStatement.context.identifier.assigner",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization"
                        ]
                    }
                ]
            },
            {
                "id": "MedicationStatement.informationSource",
                "path": "MedicationStatement.informationSource",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization",
                            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Patient",
                            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Practitioner",
                            "http://hl7.org/fhir/StructureDefinition/RelatedPerson",
                            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-PractitionerRole"
                        ]
                    }
                ]
            },
            {
                "id": "MedicationStatement.informationSource.identifier.assigner",
                "path": "MedicationStatement.informationSource.identifier.assigner",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization"
                        ]
                    }
                ]
            },
            {
                "id": "MedicationStatement.derivedFrom.identifier.assigner",
                "path": "MedicationStatement.derivedFrom.identifier.assigner",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization"
                        ]
                    }
                ]
            },
            {
                "id": "MedicationStatement.reasonReference",
                "path": "MedicationStatement.reasonReference",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "http://hl7.org/fhir/StructureDefinition/Condition",
                            "http://hl7.org/fhir/StructureDefinition/Observation",
                            "http://hl7.org/fhir/StructureDefinition/DiagnosticReport"
                        ]
                    }
                ]
            },
            {
                "id": "MedicationStatement.reasonReference.identifier.assigner",
                "path": "MedicationStatement.reasonReference.identifier.assigner",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization"
                        ]
                    }
                ]
            },
            {
                "id": "MedicationStatement.note.author[x]",
                "path": "MedicationStatement.note.author[x]",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Patient",
                            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Practitioner",
                            "http://hl7.org/fhir/StructureDefinition/RelatedPerson"
                        ]
                    },
                    {
                        "code": "string"
                    }
                ]
            },
            {
                "id": "MedicationStatement.dosage.asNeeded[x]",
                "path": "MedicationStatement.dosage.asNeeded[x]",
                "binding": {
                    "strength": "extensible",
                    "description": "A set of codes that define a precondition for taking a medication",
                    "valueSet": "https://fhir.hl7.org.uk/ValueSet/UKCore-MedicationPrecondition"
                }
            },
            {
                "id": "MedicationStatement.dosage.site",
                "path": "MedicationStatement.dosage.site",
                "binding": {
                    "strength": "extensible",
                    "valueSet": "https://fhir.hl7.org.uk/ValueSet/UKCore-BodySite"
                }
            },
            {
                "id": "MedicationStatement.dosage.route",
                "path": "MedicationStatement.dosage.route",
                "binding": {
                    "strength": "extensible",
                    "valueSet": "https://fhir.hl7.org.uk/ValueSet/UKCore-SubstanceOrProductAdministrationRoute"
                }
            },
            {
                "id": "MedicationStatement.dosage.method",
                "path": "MedicationStatement.dosage.method",
                "binding": {
                    "strength": "extensible",
                    "valueSet": "https://fhir.hl7.org.uk/ValueSet/UKCore-MedicationDosageMethod"
                }
            }
        ]
    }
}

Examples

Amoxicillin - An example to illustrate a medication statement of Amoxicillin.
Example UKCore-MedicationStatement-Amoxicillin

Extension - LastIssueDate - An example to illustrate the LastIssueDate extension.
Example UKCore-MedicationStatement-Extension-LastIssueDate

Extension - PrescribingOrg - An example to illustrate the PrescribingOrg extension.
Example UKCore-MedicationStatement-Extension-PrescribingOrg

Extension - PharmacistVerifiedIndicator - An example to illustrate the PharmacistVerifiedIndicator extension.
Example UKCore-MedicationStatement-Extension-PharmacistVerifiedIndicator

Example Usage Scenarios

The following are example usage scenarios for the UK Core MedicationStatement profile:

  • Query and retrieve a patient's current medication
  • Record or update a patient's current medication.

Profile Specific Implementation Guidance:

Minimum Viable Content

A minimum viable content that all provider and consumer systems SHOULD support are the following elements.

Element Reason
identifier Allow the resource to be referenced within/by other resources
basedOn To reference to a MedicationRequest resource, where applicable
status Mandatory element
statusReason To expand on the intent of the status
medication[x] Mandatory element
subject Mandatory element
effective[x] To timestamp the statement
dateAsserted To timestamp the statement assertion
informationSource To reference other resources, where applicable
derivedFrom To reference other resources, where applicable
dosage For the dosage for the statement

Extensions

More information about the extensions can be found using the links below.

Extension Context Link Comment
medicationPrescribingOrganizationType MedicationStatement Extension UKCore-MedicationPrescribingOrganizationType An extension to identify if the medication was prescribed-at-gp-practice or prescribed-by-another-organisation.

This extension is likely only to be populated by GP systems.

medicationStatementLastIssueDate MedicationStatement Extension UKCore-MedicationStatementLastIssueDate An extension for the date or date/time that the medication described in the MedicationStatement was last requested/prescribed.

The presence of this data does not imply medication has been dispensed or supplied to the patient.

pharmacistVerifiedIndicator MedicationStatement Extension UKCore-PharmacistVerifiedIndicator

basedOn

A reference to any number of CarePlan, MedicationRequest, or ServiceRequest resources.

Recommendation: To reference a previous medication request use priorPrescription instead of this element.

If the clinical system has implemented the CarePlan resource, a logical link to the care plan for which the medication request is based has business benefit.


partOf

This SHOULD NOT be used as the use-case and purpose is ambiguous.


status

Status FHIR Definition Recommendation
active The medication is still being taken. It is believed the medication is active in the patient's system.
completed The medication is no longer being taken. A course of medication has been completed and the medication is not active in the patient's system.
entered-in-error Some of the actions that are implied by the medication statement may have occurred. For example, the patient may have taken some of the medication. Clinical decision support systems SHOULD take this status into account. Indicates the MedicationStatement is INVALID. It is not expected that a MedicationStatement with this status would be included in exchanges.
intended The medication may be taken at some time in the future. It is intended that the medication will be given to the patient. When this is used effective[x] SHALL indicate when it is intended that the medication is to be taken.
stopped Actions implied by the statement have been permanently halted, before all of them occurred. This SHOULD NOT be used if the statement was entered in error. Medication has been stopped before the completion of the prescribed course and there is no plan to restart it. When used the reason SHALL be indicated in statusReason.
on-hold Actions implied by the statement have been temporarily halted, but are expected to continue later. May also be called "suspended". Medication has been temporarily stopped.
When used the reason SHALL be indicated in statusReason.
Where it is known when it is intended to restart it this MAY be indicated in statusReason.
unknown The state of the medication use is not currently known. The patient may have had some encounter with this medication, but the current status is unknown. Avoid the use of this status value where possible.
not-taken The medication was not consumed by the patient Use this when there is certainty that the patient has not consumed any of the intended medication.

A MedicationStatement represents a snapshot in time of a patient medication - and if the status is not available in the source system, then the following business rule MAY apply to compute the state.

Status How it can be determined
active A completed MedicationRequest (if known) where the current date is between the dispenseRequest.validityPeriod element. The MedicationStatement.effectivePeriod element SHOULD reflect this information.
or
Where the current date is between the MedicationStatement.effectivePeriod
completed Where the current date is after the MedicationStatement.effectivePeriod
or
A completed MedicationRequest (if known) where the dispenseRequest element is either not defined, or the current date is greater than the dispenseRequest.validityPeriod.

statusReason

Used to expand on the intent for the status of the MedicationStatement.

An example use-case for this could be if an organisation sets a medication status to on-hold with the intent to restart the medication at some point (move back to active).


category

The ValueSet UKCore-MedicationStatementCategory has been extended with leave and discharge to align with the equivalent value set used by MedicationRequest.


medication[x]

Medication WITH dm+d code

Where a dm+d code exists it SHALL be used either as MedicationStatement.medicationCodeableConcept.coding or as MedicationStatement.medicationReference:Medication.code.

Where CodeableConcept is used, MedicationStatement.medicationCodeableConcept.coding is the dm+d code and MedicationStatement.medicationCodeableConcept.text is dm+d concept name/description.

Can be either a dm+d code as a CodeableConcept or reference to Profile UKCore-Medication resource. Using a CodeableConcept is preferred unless additional data if required that would be contained within a Profile UKCore-Medication resource.

The elements MedicationStatement.medicationCodeableConcept.coding and MedicationStatement.medicationReference:Medication.code are both bound to ValueSet UKCore-MedicationCode

Examples where a reference to a Profile UKCore-Medication would be applicable include:

  • Record a VTM with a specific form
  • Record manufacturer with a concept as described in ValueSet UKCore-MedicationCode
  • Record batch number
  • Record ingredients (for example with a magisterial prescription or an excipient).

Medication WITHOUT dm+d code

Medication not published within the dm+d may be requested in the Acute care setting.

In this scenario it is recommended to use the CodeableConcept variant for this element.

If the prescribing system has both a locally assigned code and description for the medication then;

  • The MedicationStatement.medicationCodeableConcept.text SHOULD be the description for the medication.
  • The MedicationStatement.medicationCodeableConcept.coding.code SHOULD be the code for the medication.
  • The MedicationStatement.medicationCodeableConcept.coding.display SHOULD be the description for the medication, i.e. the same value as MedicationStatement.medicationCodeableConcept.text.

If the prescribing system only has a description for the medication then;

  • The MedicationStatement.medicationCodeableConcept.text SHOULD be the locally assigned description for the medication.

subject

A reference to the patient.

Within a FHIR Messaging or FHIR Document implementation, include a Profile UKCore-Patient resource within the Bundle with at least the minimum dataset populated as defined within the UK Core standard. The reference points to the resource in the Bundle.

Within a RESTful implementation a reference and/or identifier SHALL be provided that allows the consumer system to query another API if they need to access the complete Profile UKCore-Patient resource.

For implementations within England and Wales, the identifier could be the patient's NHS Number, allowing a consumer system to use the NHS Digital Personal Demographics Service FHIR API to return a Patient resource.

For implementations within Scotland, the identifier could be the patient's CHI Number.


informationSource

Referencing an organisation is likely to be more useful than a person. Individual work patterns and/or employer may change while the care setting organisation is likely to be more static and relevant within historic instances of this resource.

When referencing an organisation - the following SHALL be provided:

  • Organization.contact.name
  • Organization.contact.telecom
  • Organization.identifier.odsOrganisationCode or Organization.identifier.odsSiteCode

Where the organisation is an Acute Trust, an ODS Site Code MAY be more useful than the parent Trust-wide ODS organisation code.


derivedFrom

This should be used only to reference information that can not be referenced by MedicationStatement.basedOn.


reasonReference

Further details of why the medication is being taken by reference to UK Core Condition or Observation.


note

If present, notes must be displayed by consuming systems.

Where author is known and to be shared, the use of authorReference is preferred over using a free-text version authorString.


dosage

Consider aligning to the Implementation Guide for Digital Medicines, but as a minimum, dosage.text.


back to top