Medication
Introduction
Scope and Usage
Representing medications in most healthcare settings is a matter of identifying an item from a list and then conveying a reference for the item selected. Additional information about the medication is frequently provided for human verification (e.g., the product name), but a full representation of the details of composition and efficacy of the medicine is conveyed by referring to drug dictionaries by means of the codes they define. There are some occasions where it is necessary to identify slightly more detail, such as when dispensing a package containing a particular medication requires identification both of the medicine and the package at once. There are also some occasions (e.g. custom formulations) where the composition of a medicine must be represented. In these cases, the ingredients of the medicine must be specified together with the amount contained, though the Medication resource does not provide full details.
The Medication resource allows for medications to be characterized by the form of the drug, the ingredient (or ingredients), and how it is packaged. The medication will include the ingredient(s), and their strength(s) and the package can include the amount (for example, number of tablets, volume, etc.) that is contained in a particular container (for example, 100 capsules of Amoxicillin 500mg per bottle).
The Medication resource can be used to describe a compounded (aka extemporaneous or magistral) product that is manufactured by the pharmacy at the time of dispensing. In this case there will be multiple ingredients which are typically base chemicals (for example, hydrocortisone powder) and there may be other ingredients that are manufactured products (for example, Glaxal Base).
The Medication resource can also be used to describe combination packaged products. In this case, the ingredients will refer to the component products either as codes or as references to Medication resource instances.
StructureDefinition
Elements (Simplified)
- Medication [0..*]: - Definition of a Medication
- Medication.identifier [0..*]: Identifier Business identifier for this medication
- Medication.code [0..1]: CodeableConcept example:medication-codes Codes that identify this medication
- Medication.status [0..1]: code required:medication-status active | inactive | entered-in-error
- Medication.marketingAuthorizationHolder [0..1]: Reference(Organization) Organization that has authorization to market medication
- Medication.doseForm [0..1]: CodeableConcept example:medication-form-codes powder | tablets | capsule +
- Medication.packageSize [0..1]: BackboneElement When the code does not specify the package size, this backbone element can be used to specify the overall amount of medication in the package
- Medication.packageSize.numberOfItems [0..1]: SimpleQuantity The number of items in the package that are represented by the code
- Medication.packageSize.amountPerItem [0..1]: Ratio The amount per each item
- Medication.ingredient [0..*]: BackboneElement Components of a medication. These can be ingredient substances or other medications, in the case of combination packaged medications
- Medication.ingredient.item [1..1]: CodeableReference example:medication-codes The specific substance or medication that is the ingredient
- Medication.ingredient.isActive [0..1]: boolean Active ingredient indicator
- Medication.ingredient.role [0..1]: CodeableConcept example:v3-RoleClassIngredientEntity A code that defines the type of ingredient, active, base, etc.
- Medication.ingredient.strength[x] [0..1]: Ratio, CodeableConcept, Quantity preferred:medication-ingredientstrength Quantity of ingredient present
- Medication.instance [0..1]: BackboneElement Details about packaged medications
- Medication.instance.identifier [0..*]: Identifier Identifier for the physical instance, typically a serial number
- Medication.instance.lotNumber [0..1]: string Identifier assigned to batch
- Medication.instance.expirationDate [0..1]: dateTime When instance will expire
- Medication.definition [0..1]: [Reference(MedicinalProductDefinition](/Reference(MedicinalProductDefinition), AdministrableProductDefinition, PackagedProductDefinition, ManufacturedItemDefinition)) Formal definition of the medication
Mappings
- Medication Mappings — 33 mapping entries
Implementation Guide
implementationguide-Medication-core.xml
<?xml version="1.0" encoding="UTF-8"?>
<ImplementationGuide xmlns="http://hl7.org/fhir">
<id value="Medication-core"/>
<version value="0.1"/>
<name value="MedicationHL7Extensions"/>
<title value="Medication H L7 Extensions"/>
<status value="draft"/>
<date value="2015-02-19T00:00:00.000"/>
<publisher value="Health Level Seven, Inc. - FHIR WG"/>
<description value="Defines common extensions used with or related to the Medication resource"/>
</ImplementationGuide>
Resource Packs
list-Medication-packs.xml
<?xml version="1.0" encoding="UTF-8"?>
<List xmlns="http://hl7.org/fhir">
<id value="Medication-packs"/>
<status value="current"/>
<mode value="working"/>
<entry>
<item>
<reference value="ImplementationGuide/Medication-core"/>
</item>
</entry>
</List>
Search Parameters
- code — token — Returns medications for a specific code —
Medication.code - expiration-date — date — Returns medications in a batch with this expiration date —
Medication.instance.expirationDate - form — token — Returns medications for a specific dose form —
Medication.doseForm - identifier — token — Returns medications with this external identifier —
Medication.identifier - ingredient — reference — Returns medications for this ingredient reference —
Medication.ingredient.item.reference - ingredient-code — token — Returns medications for this ingredient code —
Medication.ingredient.item.concept - lot-number — token — Returns medications in a batch with this lot number —
Medication.instance.lotNumber - marketingauthorizationholder — reference — Returns medications made or sold for this marketing authorization holder —
Medication.marketingAuthorizationHolder - status — token — Returns medications for this status —
Medication.status - serial-number — token — Returns medications in a instance with this lot number —
Medication.identifier
Examples
- med0301 — medicationexample0301 — IV injection (inpatient order) - Manufactured Product - Vancomycin
- med0302 — medicationexample0302 — IV Injection with a Rate Example - Manufactured Product - Piperacillin
- med0303 — medicationexample0303 — IV Chemotherapy Example - Manufactured Product - Alemtuzumab
- med0304 — medicationexample0304 — Oral Chemotherapy Example - Manufactured Product - Myleran
- med0305 — medicationexample0305 — Eye Drop Example - Manufactured Product - Timoptic
- med0306 — medicationexample0306 — IV Chemotherapy Example - Manufactured Product - Adcetris
- med0307 — medicationexample0307 — Subcutaneous injection Example - Manufactured Product - Novolog
- med0308 — medicationexample0308 — As needed Oral tablet - Manufactured Product - Percocet
- med0309 — medicationexample0309 — As needed dosage range - Manufactured Product - Tylenol No 1 Caplet
- med0310 — medicationexample0310 — Generic Formulation - Oxycodone
- med0311 — medicationexample0311 — Generic Formulation - Prednisone 5mg tablet
- med0312 — medicationexample0312 — Generic Formulation - Nystatin 100,000 u/ml suspension
- med0313 — medicationexample0313 — Generic Formulation - Lorazepam 2mg/ml injection
- med0314 — medicationexample0314 — Generic Formulation - Alprazolam 0.25mg tablet
- med0315 — medicationexample0315 — Generic Formulation - Mometasone Furoate 0.05mg/Actuat
- med0316 — medicationexample0316 — Generic Formulation - Fully populated example of a Medication - Chlorthalidone
- med0317 — medicationexample0317 — Compounded Preparation - KCl in D5W Admixture - includes a reference to a substance in the ingredient element
- med0318 — medicationexample0318 — Compounded Preparation - TPN Solution - includes a reference to a substance in the ingredient element
- med0319 — medicationexample0319 — Compounded Preparation - HC 1%, Salicylic Acid 5% in Glaxal Base - includes a reference to a substance in the ingredient element
- med0320 — medicationexample0320 — Generic Formulation - Azithromycin 250mg oral capsule - includes a reference to a substance in the Ingredient element
- med0321 — medicationexample0321 — Generic Formulation - Oral Chemotherapy Example - Capecitabine – includes a reference to a substance in the Ingredient element
- med0323 — medicationexample0323 — Compounded Preparation - Hand Sanitizer - includes qs Ingredient strength
- medexample015 — medicationexample15 — Oral Chemotherapy Example - Manufactured Product - Xeloda - includes a reference to a substance in ingredient element
- medication-example — medication-example
- medication-examples-header — medication-examples-header
- medicationexample1 — medicationexample1 — Name element only populated - Amoxicillin 250mg/5ml Suspension
Mapping Exceptions
medication-fivews-mapping-exceptions.xml
Unmapped Elements
- FiveWs.what — Unknown
- FiveWs.recorded — Unknown
- FiveWs.author — Unknown
- FiveWs.actor — Unknown
- FiveWs.cause — Unknown
- FiveWs.version — Unknown
- FiveWs.witness — Unknown
- FiveWs.where — Unknown
- FiveWs.context — Unknown
- FiveWs.init — Unknown
- FiveWs.why — Unknown
- FiveWs.source — Unknown
- FiveWs.who — Unknown
- FiveWs.grade — Unknown
- FiveWs.status — Unknown
- FiveWs.planned — Unknown
- FiveWs.done — Unknown
- FiveWs.subject — Unknown