FHIR CI-Build

This is the Continuous Integration Build of FHIR (will be incorrect/inconsistent at times).
See the Directory of published versions icon

11.5 Resource Medication - Content

Pharmacy icon Work GroupMaturity Level: 4 Trial UseSecurity Category: Business Compartments: No defined compartments

This resource is primarily used for the identification and definition of a medication, including ingredients, for the purposes of prescribing, dispensing, and administering a medication as well as for making statements about medication use.

11.5.1 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 either into a patient-related resource or to other applications. 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 and 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).

When a medication includes a package, further details about the composition can be provided. A package has a container (vacuum packed box, jar, etc.) and a list of the products or other packages that are in the package.

11.5.2 References to this Resource

11.5.3 Resource Content

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. Medication TU DomainResource Definition of a Medication

Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... identifier Σ 0..* Identifier Business identifier for this medication

... code Σ 0..1 CodeableConcept Codes that identify this medication
Binding: SNOMED CT Medication Codes (Example)
... status ?!Σ 0..1 code active | inactive | entered-in-error
Binding: Medication Status Codes (Required)
... doseForm 0..1 CodeableConcept powder | tablets | capsule +
Binding: SNOMED CT Form Codes (Example)
... totalVolume Σ 0..1 Quantity When the specified product code does not infer a package size, this is the specific amount of drug in the product
... ingredient 0..* BackboneElement Active or inactive ingredient

.... item 1..1 CodeableReference(Substance | Medication) The ingredient (substance or medication) that the ingredient.strength relates to
Binding: SNOMED CT Medication Codes (Example)
.... isActive 0..1 boolean Active ingredient indicator
.... strength[x] 0..1 Quantity of ingredient present
Binding: Medication Ingredient Strength Codes (Preferred)
..... strengthRatio Ratio
..... strengthCodeableConcept CodeableConcept
..... strengthQuantity Quantity
... batch 0..1 BackboneElement Details about packaged medications
.... lotNumber 0..1 string Identifier assigned to batch
.... expirationDate 0..1 dateTime When batch will expire
... definition 0..1 Reference(MedicationKnowledge) Knowledge about this medication

doco Documentation for this format icon

See the Extensions for this resource

 

Additional definitions: Master Definition XML + JSON, XML Schema/Schematron + JSON Schema, ShEx (for Turtle) + see the extensions, the spreadsheet version & the dependency analysis

11.5.3.1 Terminology Bindings

Path ValueSet Type Documentation
Medication.code SNOMEDCTMedicationCodes Example

This value set includes all drug or medicament substance codes and all pharmaceutical/biologic products from SNOMED CT - provided as an exemplar value set.
Medication.status MedicationStatusCodes Required

Medication Status Codes
Medication.doseForm SNOMEDCTFormCodes Example

This value set includes all dose form codes from SNOMED CT - provided as an exemplar.
Medication.ingredient.item SNOMEDCTMedicationCodes Example

This value set includes all drug or medicament substance codes and all pharmaceutical/biologic products from SNOMED CT - provided as an exemplar value set.
Medication.ingredient.strength[x] MedicationIngredientStrengthCodes Preferred

Medication Ingredient Strength Codes

11.5.4 Search Parameters

Search parameters for this resource. See also the full list of search parameters for this resource, and check the Extensions registry for search parameters on extensions related to this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.

Name Type Description Expression In Common
code token Returns medications for a specific code Medication.code 21 Resources
expiration-date date Returns medications in a batch with this expiration date Medication.batch.expirationDate
form token Returns medications for a specific dose form
identifier token Returns medications with this external identifier Medication.identifier 65 Resources
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.batch.lotNumber
marketingauthorizationholder reference Returns medications made or sold for this marketing authorization holder Medication.marketingAuthorizationHolder
(Organization)
serial-number token Returns medications in a batch with this lot number Medication.identifier
status token Returns medications for this status Medication.status