HL7 Pharmacy: Medication List Guidance, published by HL7 Pharmacy. This is not an authorized publication; it is the continuous build for version 0.1.0). This version is based on the current content of https://github.com/HL7/fhir-med-list-guidance/ and changes regularly. See the Directory of published versions
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.
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.
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).
The following are examples of medication lists:
The scope of this Implementation Guide includes the following:
The following are not in scope for this Implementation Guide:
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:
Syntax | 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. |