Important: All content in this FHIR Implementation Guide is under development

DataStandardsWales-MedicationStatement

The MedicationStatement resource is a record of a medication that is being consumed by a patient..

The DataStandardsWales-MedicationStatement profile is derived from the UK Core MedicationStatement Profile. It defines additional rules for use within health and care organisations in Wales.

Formal Views of Profile Content

pharmacistVerifiedIndicatorI0..1Extension(boolean)
medicationPrescribingOrganizationTypeI0..1Extension(CodeableConcept)
medicationStatementLastIssueDateI0..1Extension(dateTime)
medicationCourseOfTherapyTypeS I0..1Extension(CodeableConcept)
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
statusS Σ ?!1..1codeBinding
statusReason0..*CodeableConcept
categoryS Σ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
dateAssertedS Σ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 | UK Core 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
pharmacistVerifiedIndicatorI0..1Extension(boolean)
medicationPrescribingOrganizationTypeI0..1Extension(CodeableConcept)
medicationStatementLastIssueDateI0..1Extension(dateTime)
medicationCourseOfTherapyTypeS I0..1Extension(CodeableConcept)
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
statusS Σ ?!1..1codeBinding
statusReason0..*CodeableConcept
categoryS Σ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
dateAssertedS Σ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 | UK Core 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
pharmacistVerifiedIndicatorI0..1Extension(boolean)
medicationPrescribingOrganizationTypeI0..1Extension(CodeableConcept)
medicationStatementLastIssueDateI0..1Extension(dateTime)
medicationCourseOfTherapyTypeS I0..1Extension(CodeableConcept)
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
statusS Σ ?!1..1codeBinding
statusReason0..*CodeableConcept
categoryS Σ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
dateAssertedS Σ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 | UK Core 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

Mandatory and Must Support Data Elements

When an element is mandatory (min=1), the data is expected to always be present. Elements marked with an S must be supported by both producing and receiving systems and SHOULD be populated if the data exists.

Each MedicationStatement must have:

  1. A status
  2. A code to indicate the medication or reference to a medication record
  3. A subject

Each MedicationStatement must support:

  1. A category
  2. A context (i.e. a reference to the encounter)
  3. The date asserted
  4. The information source
  5. Dosage information
  6. An indication of the course of therapy type (e.g. repeat or acute)

Implementation Guidance

  • The extensions listed below allow a number of the data elements listed above to be supported where not currently supported by the FHIR standard:
    • Data Standards Wales extensions:
      • The DataStandardsWales-MedicationCourseOfTherapyTypeextention is used to indicate the overall pattern of medication administration at the MedicationStatement level (e.g. repeat or acute). This provides addition context to a clinician reviewing a list of patient medications to determine the reason why a patient is taking a medication, and SHOULD be populated if this data exists within the communicating system.

  • The MedicationStatement.status field SHALL be populated with one of the following values defined by the FHIR standard:
    • active
    • completed
    • entered-in-error
    • intended
    • stopped
    • on-hold
    • unknown
    • not-taken

  • The MedicationStatement.medication field SHALL be populated. This will be populated with either a dm+d code to indicate the medication, or reference to a medication resource. If only a code is specified, then it needs to be a code for a specific product. If more information is required, then the use of the medication resource is recommended.

  • The MedicationStatement.subject field SHALL be populated.

Example MedicationStatements

The following medication statement resources are provided within this guide: Amoxicillin (infusion), Ramipril, Ibuprofen.

Mandatory Search Parameters

The following search parameters and search parameter combinations SHALL be supported:

  1. SHALL support searching for all MedicationStatements using the subject search parameter:
    GET [base]/MedicationStatement?subject={Type/}[id]
    
    Example:
    1. GET [base]/MedicationStatement?subject=Patient/23
    2. GET [base]/MedicationStatement?subject:Patient.identifier=https://fhir.nhs.uk/Id/nhs-number|9912003444
      Implementation Notes: Fetches a bundle of all MedicationStatement resources for the specified patient (how to search by reference)

Optional Search Parameters

  1. SHOULD support searching using the combination of the subject and status search parameters:

    GET [base]/MedicationStatement?subject={Type/}[id]&status={system|}[code]
    GET [base]/MedicationStatement?subject:Patient.identifier={system|}[code]&status={system|}[code]
    

    Example:

    1. GET \[base\]/MedicationStatement?subject=Patient/23&status=http://hl7.org/fhir/CodeSystem/medication-statement-status|active
    2. GET \[base\]/MedicationStatement?subject:Patient.identifier=https://fhir.nhs.uk/Id/nhs-number|9912003444&status=http://hl7.org/fhir/CodeSystem/medication-statement-status|active

      Implementation Notes: Fetches a bundle of all MedicationStatement resources for the specified subject and status code. (how to search by reference and how to search by token)