Introduction
This Implementation Guide provides guidance on how to create medications lists using HL7 Fast Healthcare Interoperability Resources (FHIR) for different contexts of use. The guidance is intended to be used by implementers of FHIR as well as HL7 standards developers and external projects developing FHIR implementation guides related to medication lists.
Lists of medications are present in many areas of both electronic healthcare applications, mobile applications, and paper based records. These lists serve many purposes, but the context of where the list is used and to whom the list is made available is a critical part of what sources of information should be used to construct the list. Without the context, a list of medications may not provide the user (healthcare provider, patient, care giver, etc.) with the information that they need. Medication lists without context can lead to incorrect understanding of whether the patient is taking a medication, or if the source of the information is unknown or not understood, this may also lead to assuming the list of medications is accurate or complete.
The following contexts are included in this Implementation Guide:
In ePrescribing applications the lists may be used to represent the active medications that a patient has been ordered/authorized to take and is reported to be taking; in other cases the list of medications may be expanded to represent any medication the patient has ever taken. In the ePrescribing case it may also include filters to see what medications orders have been completed, or those that are on-hold, or those that have been entered-in-error. Some lists may include both medications that have been authorized by a clinician via an order/prescription, and include those medications the patient is taking that have been purchased "over the counter" without any order from any clinician.
In some systems, the list of dispensed medications provides another view of medications the patient is expected to be taking.
In medication administration records, there are two common lists, one represents the list of medications to be administered, including dose, route of administration and timing information; the second use is to represent the actual time, date, route, person who performed the administration, and other relevant medication administration information. The attributes in this paragraph are not meant to be an exhaustive list or required list but are used to provide context about some of the data that may be associated with these types of lists.
Another view of medication lists reflects the reported medications the patient has taken, is taking, or will take - we call this medication usage (formerly medication statement). A challenge that often is documented in this area is how to represent that a patient is taking or not-taking a medication. At it's most basic, the question may look like: Are you taking your medications as prescribed?
More commonly though the questions around taking medication are more nuanced, as you can see in the following examples:
Patient or other carer is asked are you taking medication xyz?
A more complex question may look like - are you taking the medication as prescribed?
Even more complexity can result in asking about future or past medication behavior e.g.
Have you ever taken this medication?
When did you stop taking this medication?
Will you take the prescribed medication starting next week ( or some future date time)?
Will you stop taking the prescribed medication at some point in time ( can be specific or general)?
With this limited set of use cases, you can see that when a medication list is either constrained or incorporates information related to taken/not taken, the use of FHIR resources can become more complex.
In general, the Pharmacy resource that should be used to capture information about usage of medication should be captured with the Medication Usage resource.
The following are examples of medication lists:
One of the challenges when creating a medication list is how to represent that a patient is taking / not-taking a medication, and if the patient is taking the medication as prescribed. Currently the mechanism has been implemented differently in the last two FHIR iterations. In one use of FHIR, the Medication Usage (formerly Statement) resource was used to indicate that the patient was taking or not taking a medication. In a more recent use of FHIR this problem resulted using Medication Request. The approaches are seen in how US Core has represented medication lists in their IGs.
Pharmacy WG and representatives from US realm have continued to discuss this issue. Note that there are differences in US Core and how this document provides guidance regarding Mediation Lists. This document's scope is larger, and is not constrained to use cases covered in US Core.
Need to pull more from other discussions into this part of guidance.
Lastly as a result of the discussions, Pharmacy has created a new attribute on MedicationUsage for R5:
takenAsOrdered This attribute has a cardinality of 0..1 with a boolean datatype and is defined: Indicates if the medication is being consumed or administered as prescribed.
With this change, you can now represent using MedicationUsage in R5 via status and/or the new boolean attribute the following information:
Attribute | Datatype Value | Display | Definition |
status | active | Active | The medication is still being taken. |
status | completed | Completed | The medication is no longer being taken. |
status | entered-in-error | Entered in Error | Some of the actions that are implied by the medication usage may have occurred. For example, the patient may have taken some of the medication. Clinical decision support systems should take this status into account. |
status | intended | Intended | The medication may be taken at some time in the future. |
status | stopped | Stopped | Actions implied by the usage have been permanently halted, before all of them occurred. This should not be used if the statement was entered in error. |
status | on-hold | On Hold | Actions implied by the usage have been temporarily halted, but are expected to continue later. May also be called 'suspended'. |
status | unknown | Unknown | The state of the medication use is not currently known. |
status | not-taken | Not Taken | The medication was not consumed by the patient |
takenAsOrdered | boolean =1 | N/A | Indicates if the medication is being consumed or administered as prescribed. |
The scope of this Implementation Guide includes the following:
The following are not in scope for this Implementation Guide:
medications that are not present in an electronic system e.g. medications purchased by the patient where there is not a record of the purchase in the pharmacy system, or illegal drugs or drugs of abuse that have been purchased but there is no record of the purchase in any electronic system
The following assumptions have been made as part of the guidance:
This Implementation Guide is based on FHIR Release 4.
The Pharmacy resources that are in scope for the guidance include:
The following resources are not in scope for this Implementation Guide, but it should be noted that there may be requirements to use a created list to get additional information about the medication via Medication resource or MedicationKnowledge resource.
The following provides a high-level overview of the pharmacy resources
Name | Description |
MedicationRequest | Represents an instruction for the administration of medication to a patient - both in the inpatient (hospital) and community setting. It can also include instructions for the dispensing, the reasons why the administration should occur and other data. It is called an 'Request' to be consistent with other FHIR resources and the workflow pattern, but a common alias for this resource is a 'Prescription' or an 'Order'. The Order itself represents the content of the instruction and is not, by itself, actionable. The workflow process around 'fulfilling' the order is part of the generic FHIR workflow (see below), with the MedicationRequest representing the contents. |
MedicationDispense | The 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 | A record of a patient actually consuming a medicine, or if it has otherwise been administered to them |
MedicationUsage (Statement) | This is a record indicating that a patient may be taking a medication now, has taken the medication in the past, or will be taking the medication in the future. The source for 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. 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. It may be used to construct a patients 'Current Medications' list. |
Medication | The medication resource represents an actual medication that can be given to a patient, and referenced by the other medication resources. In many cases, this resource is not needed and the drug is indicated by a reference to the appropriate terminology and so can be represented using a codeable concept. In other cases, however, it may be desired to indicate more details than the simple drug (such as the packaging, whether it is a generic medication or the active and inactive ingredients) and so the Medication resource can be used for this. |
MedicationKnowledge | The MedicationKnowledge resource is draft and is included for comment purposes. This resource represents information about a medication, for example, details about the medication including interactions, contraindications, cost, regulatory status, administration guidelines, etc. |
Definitions: (LEAVE UNTIL WE GET TO THE END - JUST ADD THE ITEM AND WE'LL DEFINE LATER)
For the most part, this guidance document uses the term Medication List. However, many contexts include other related information and are properly Medication Profiles. The point is that a collection of medication order/dispense/administration records is being created whether it is just a Medication List or a Medication Profile with additional information.
There may also be jurisdictional implications regarding List versus Profile. The document does not address these jurisdictional considerations
Glossary - should this be a separate section, include terms that may be used in some countries and not others (for example, aged care facilities, senior care facilities, long term care, retirement villages)
List Details
May include current and/or previously prescribed medicines. Does not indicate prescriptions have been filled, only that a prescription has been provided.
Should this include repeat prescriptions - instance orders? JH - I vote no, not sure what that use case would be for Medication List re: prescribing. However, if you wanted to create a list of medication requests ( instance orders) for the purposes of populating a MAR, then I say yes.
Provide a list of prescribed medications provided to a patient either current prescriptions or a list of historical prescriptions written.
Any setting in which a prescription may be provided to a patient.
The inclusion of a medication in the list does not imply that the patient has actually taken the medication, just that it has been supplied to him or her.
Depending on the source of the list, may include only those medications from a specific pharmacy or from an institution (hospital) or from an organization (inpatient, outpatient) or within a jurisdiction (e.g. where there is a centralized system that captures dispenses from all community pharmacies)
Use Case: Clinical review prior to dispensing
Use Case: Patient Access
Use Case: Coroner
Use Case: Drug recalls
Applicable to inpatient, outpatient and community settings.
May be applicable to patients or care-givers
The list of medications that have been dispensed to a patient.
May be created by the dispensing system, EHR, or jurisdictional centralized Drug Information System (DIS) from dispense records
May be created by a centralized system using dispense claims data as a proxy for dispenses.
A provider view Medication Dispense list may include medications that come from:
Would not contain records of dispenses that have been recorded in error.
A patient view of a medication list includes:
MedicationDispense
Optionally, MedicationUsage
Optionally, ??? claim ??
Give me all medications dispensed to patient x
Give me all medications dispensed to patient x within this time period
Show me all medications dispensed to me
Show me all medications dispensed to me within this time period
Give me the dispenses for patient x for drug y (or for list of drugs - may be generic formulations or brands)
Give me the dispenses for patient x for the drug classification z (or combination of classifications)
Blister Packing (Peter) - overlaps with prescribing context and dispensing context
Introduction/Description - Peter to work on this section. Recent work in red
Blister packets are sealed units (e.g., foil packet), provided to the patient, containing medication doses which are schedule to be taken at the same specified time or at a specified event (e.g. breakfast). There may be multiple blister packets to be taken within a day.
This is a list that is maintained by the pharmacy of "regular" medicines that are expected in future Medication Requests. This list is different from other lists as it contains information about special packing requirements.
Initially the list is generated after a clinical review of the patient by the care provider and is used in conjunction with the patient's medication profile.
Periodically (weekly/monthly) the pharmacy will create a number of pro forma Medication Request from the profile for the prescriber to approve. Once approved, the blister pack and request details are sent for robot or human packing. The blister pack list may have items that are not to be packed (creams, liquids, PRN items) but in some jurisdictions must printed on the foil header. The remaining items are dispensed and packed in accordance to he instructions in the list.
Assumptions
The medications in the list are the current medicines to be packed in blister packaging in the next packing run for that patient. It is a subset of the medicines that the patient takes on a regular basis as recorded in the patient profile
Synonyms
Foils, Dose Administration Aid, Conformance Packs, Sachet Packs/unit dose packs
Rationale
The list contains medicines to be packed or have been packed along with detailed administration timings that are printed on the foils and the location of each item in the pack.
Use Case: Clinical review prior to dispensing
Setting
Applicable to Pharmacies, Aged Care Facilities, Mental Health units and community settings.
Description
The list of medications that have been dispensed or will be dispensed to a patient in blister packaging. -These medicines will need to be authorised by the prescriber by way of medication requests before dispensing.
Where do the medications that are listed on the Blister Packing list come from?
What data elements are important?
What resources to use
What is/should the patient taking (that can be packed)
Types of queries
Give me all medications to be dispensed in a type of packaging to patient x as part of a regular cycle.
Example
Administration (John)
Medication administrations can be done by a clinician, by a patient via self-administration, by a family member e.g. mother for a baby, by a caregiver, or via the use of devices e.g. IV pumps, Insulin pumps, patient controlled analgesic (PCA) pumps. In order to administer a medication there is often some kind of list of medications that includes date and time the medication is to be administered. A common name for this type of list of medications to be administered and the corresponding record of medication administrations is Medication Administration Record (MAR).
Medication Administration Record (MAR) - a view of a patients medications that need to be administered. Typically an MAR is seen in settings where there is a requirement to document who, when, what and where information, concerning medications administered to a patient, or if self-administered, taken by a patient. The same record often has two primary functions - first it lists what medications need to be administered and what date and time the administration should be done; and second it lists what medications have been administered and the details associated with the administration.
Note: The list of attributes in this section is meant to help the reader understand the definitions. It is not meant to define what attributes an individual implementation may include in their design.
Scheduled Medication Administration information is used to inform the person who will administer the medication(s) the date/time, and medication specific information e.g. dose, route, method, special instructions for each medication a person is scheduled to take.
Medication Administration details provides a place to capture the data about the actual administration e.g. date/time or time interval of administration, dose, route, method, device, etc.
Depending on the type of application, this type of information may be presented to the user who is administering the medication in an EHR module for medication administration, in a mobile application for the patient or caregiver.
Should not matter whether the patient is in an inpatient setting or an outpatient or a community based setting
The list of medications to be administered, or that have been administered may be captured in an application on a patient's phone, tablet or computer workstation.
The lists may be created by a variety of users or systems, for example:
When a list is created the source of the information may come from a prescription, or a printed list of medications that is used by a patient or caregiver or clinician as input into a digital application.
The level of detail of the data that is captured during medication administration may differ depending of who is creating and entering the data, but the purpose for the list remains the same.
Assumption that you either have access to some data source(s0 or no source of data is available or no data in available in any of the sources.
provider view Medication Administration list may include medications that come from:
A medication administration list includes for a patient:
MedicationRequest (intent=instanceOrder) - to support the scheduled medication administrations
MedicationAdministration - to document the actual medication administration
Medication - used for Form, Batch # and/or provide details of what is in a product or compounded product
review US Core queries for a model about how to represent queries.....
What medications should be administered "today"? or this "shift"? or "now"?
Has this patient ever taken "drug xyz"? This would search past medication administrations for this patient?
Did the patient get their "cyclosporin" today?
When was the last time you took demerol?
There may be queries that need to query both MedicationAdministration and MedicationUsage.
Medication Use (John) - needs to be consolidated with other use case ??
When collecting Medication history from patients there are often a series of questions the clinician asks the patient. Another way to ask the questions may come in the form of a questionaire that lists medications and asks These questions can vary depending on the reason for asking the questions. The history can be obtained by talking to a patient, a family member e.g. mother for a baby, by a caregiver, or via queries into systems that record medication administration records (MAR).
Patient reported medication usage
Reported medication usage
Medication history
It is common when ordering some medications to understand how the patient responded to the same medication previously. This is one of the primary reasons for reviewing medication administration history. Another reason is to evaluate the dose used previously and make adjustments to a new order for the same medication.
The most common reason in acute care settings is to confirm that a specific dose of a medication was administered.
Should not matter whether the patient is in an inpatient setting or an outpatient or a community based setting
This section HAS NOT BEEN UPDATED
The list of medications to be administered, or that have been administered may be captured in an application on a patient's phone or computer.
The lists may be created by the patient him or herself or it may be created by a parent for a child or a care-giver for a patient.
The list may be created by a clinician within an EHR Medication Administration module.
The list may be created in a paper document that is used by a patient or caregiver or clinician.
The level of detail of the data that is captured during medication administration may differ depending of who is creating and entering the data, but the purpose for the list remains the same.
A provider view of Medication Administration history may include medications that come from:
In acute care settings it is common to query the MAR for medication administration history.
In settings where the patient, caretaker or family member is the source of the medication history it common to ask various questions. The answers to the questions would use FHIR Medication Usage resource to record these types of statements. The following lists some common questions, not all are relevant to Medication Administration History.
When querying for Medication Administration History it would be common to look at both Medication Administration and Medication Usage records to answer the Medication Administration History question.
A patient view of medication administration history discussion.
MedicationAdministration
MedicationUsage
Has this patient ever taken "drug xyz"? This would search past Medication Administration records for this patient? and/or search Medication Usage records.
Did the patient get their "cyclosporin" today?
Medication Reconciliation (Scott/Jean)
(working on this in a Word document)
Patient's View (Melva)
??? may not need this section
To allow a patient to answer the question "what medications am I taking". This list can then be provided to health care practitioners in different settings.
**ADD IN USE CASES**
Should not matter whether the patient is in an inpatient setting or an outpatient or a community based setting
A patient's view of a medication list includes what is in a patients' medication cabinet - may include medication the patient is currently taking, has taken in the past and may take in the future. This list of medication may be captured in an application on a patient's phone or computer.
The list may be created by the patient him or herself or it may be created by a parent for a child or a care-giver for a patient.
Lists created by someone other than the patient may include a different level of detail that if created by the patient, but the purpose for the list is the same.
To address what medications the patient has taken in the past or plans to take in the future....SEE CONTEXT.....
These lists may come in different flavours:
A patient view of a medication list includes:
may not include medications that have been prescribed but are not taking
How was the medication captured in the list?
MedicationUsage (aka MedicationStatement)
Profiles
Contributors