DSTU2 QA Preview

This page is part of the FHIR Specification (v1.0.0: DSTU 2 Ballot 3). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2

4.12 Resource Medication - Content

Pharmacy Work GroupMaturity Level: 0Compartments: Not linked to any defined compartments

This resource is primarily used for the identification and definition of a medication. It covers the ingredients and the packaging for a medication.

4.12.1 Scope and Usage

Representing Medication in the majority of 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 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 medicine 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 have to be specified together with the amount contained, though the medication resource does not provide full details.

The medication resource allows for medications to be characterised as either a product or a package; this classification is important because it affects the interpretation of a prescribed amount. For instance, is the prescribed amount 20 tablets, or 20 packages of 50 tablets each?

Depending on whether the medication is a product or a package, further details about the composition can be provided. A product has a form (tablet, suspension, etc.) and a list of ingredients with quantities. The ingredients may be other medications or substances. A package has a container (vacuum packed box, jar, etc.) and a list of the products or other packages that are in the package.

This resource is referenced by CarePlan, Group, MedicationAdministration, MedicationDispense, MedicationOrder, MedicationStatement, Procedure, SupplyDelivery and SupplyRequest

4.12.2 Resource Content

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. Medication DomainResourceDefinition of a Medication
... code Σ0..1CodeableConceptCodes that identify this medication
Snomed Medication Codes (Example)
... isBrand Σ0..1booleanTrue if a brand
... manufacturer Σ0..1Reference(Organization)Manufacturer of the item
... product 0..1BackboneElementAdministrable medication details
.... form 0..1CodeableConceptpowder | tablets | carton +
SNOMED CT Form Codes (Example)
.... ingredient 0..*BackboneElementActive or inactive ingredient
..... item 1..1Reference(Substance | Medication)The product contained
..... amount 0..1RatioHow much ingredient in product
.... batch 0..*BackboneElement
..... lotNumber 0..1string
..... expirationDate 0..1dateTime
... package 0..1BackboneElementDetails about packaged medications
.... container 0..1CodeableConceptE.g. box, vial, blister-pack
SNOMED CT Form Codes (Example)
.... content 0..*BackboneElementWhat is in the package?
..... item 1..1Reference(Medication)A product in the package
..... amount 0..1SimpleQuantityHow many are in the package?

doco Documentation for this format

UML Diagram

Medication (DomainResource)A code (or set of codes) that specify this medication, or a textual description if no code is available. Usage note: This could be a standard medication code such as a code from RxNorm, SNOMED CT, IDMP etc. It could also be a national or local formulary code, optionally with translations to other code systemscode : CodeableConcept [0..1] « A code that defines the type of a medication (Strength=Example)Snomed Medication ?? »Set to true if the item is attributable to a specific manufacturerisBrand : boolean [0..1]Describes the details of the manufacturermanufacturer : Reference [0..1] « Organization »ProductDescribes the form of the item. Powder; tablets; cartonform : CodeableConcept [0..1] « The form of a medication (Strength=Example)SNOMED CT Form ?? »IngredientThe actual ingredient - either a substance (simple ingredient) or another medicationitem : Reference [1..1] « Substance|Medication »Specifies how many (or how much) of the items there are in this Medication. E.g. 250 mg per tabletamount : Ratio [0..1]BatchThe assigned lot number of a batch of the specified productlotNumber : string [0..1]When this specific batch of product will expireexpirationDate : dateTime [0..1]PackageThe kind of container that this package comes ascontainer : CodeableConcept [0..1] « Kind of container a medication package is packaged in (Strength=Example)SNOMED CT Form ?? »ContentIdentifies one of the items in the packageitem : Reference [1..1] « Medication »The amount of the product that is in the packageamount : Quantity(SimpleQuantity) [0..1]Identifies a particular constituent of interest in the productingredient[0..*]Information about a group of medication produced or packaged from one production runbatch[0..*]Information that only applies to products (not packages)product[0..1]A set of components that go to make up the described itemcontent[0..*]Information that only applies to packages (not products)package[0..1]

XML Template

<Medication xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <code><!-- 0..1 CodeableConcept Codes that identify this medication --></code>
 <isBrand value="[boolean]"/><!-- 0..1 True if a brand -->
 <manufacturer><!-- 0..1 Reference(Organization) Manufacturer of the item --></manufacturer>
 <product>  <!-- 0..1 Administrable medication details -->
  <form><!-- 0..1 CodeableConcept powder | tablets | carton + --></form>
  <ingredient>  <!-- 0..* Active or inactive ingredient -->
   <item><!-- 1..1 Reference(Substance|Medication) The product contained --></item>
   <amount><!-- 0..1 Ratio How much ingredient in product --></amount>
  </ingredient>
  <batch>  <!-- 0..* -->
   <lotNumber value="[string]"/><!-- 0..1  -->
   <expirationDate value="[dateTime]"/><!-- 0..1  -->
  </batch>
 </product>
 <package>  <!-- 0..1 Details about packaged medications -->
  <container><!-- 0..1 CodeableConcept E.g. box, vial, blister-pack --></container>
  <content>  <!-- 0..* What is  in the package? -->
   <item><!-- 1..1 Reference(Medication) A product in the package --></item>
   <amount><!-- 0..1 Quantity(SimpleQuantity) How many are in the package? --></amount>
  </content>
 </package>
</Medication>

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. Medication DomainResourceDefinition of a Medication
... code Σ0..1CodeableConceptCodes that identify this medication
Snomed Medication Codes (Example)
... isBrand Σ0..1booleanTrue if a brand
... manufacturer Σ0..1Reference(Organization)Manufacturer of the item
... product 0..1BackboneElementAdministrable medication details
.... form 0..1CodeableConceptpowder | tablets | carton +
SNOMED CT Form Codes (Example)
.... ingredient 0..*BackboneElementActive or inactive ingredient
..... item 1..1Reference(Substance | Medication)The product contained
..... amount 0..1RatioHow much ingredient in product
.... batch 0..*BackboneElement
..... lotNumber 0..1string
..... expirationDate 0..1dateTime
... package 0..1BackboneElementDetails about packaged medications
.... container 0..1CodeableConceptE.g. box, vial, blister-pack
SNOMED CT Form Codes (Example)
.... content 0..*BackboneElementWhat is in the package?
..... item 1..1Reference(Medication)A product in the package
..... amount 0..1SimpleQuantityHow many are in the package?

doco Documentation for this format

UML Diagram

Medication (DomainResource)A code (or set of codes) that specify this medication, or a textual description if no code is available. Usage note: This could be a standard medication code such as a code from RxNorm, SNOMED CT, IDMP etc. It could also be a national or local formulary code, optionally with translations to other code systemscode : CodeableConcept [0..1] « A code that defines the type of a medication (Strength=Example)Snomed Medication ?? »Set to true if the item is attributable to a specific manufacturerisBrand : boolean [0..1]Describes the details of the manufacturermanufacturer : Reference [0..1] « Organization »ProductDescribes the form of the item. Powder; tablets; cartonform : CodeableConcept [0..1] « The form of a medication (Strength=Example)SNOMED CT Form ?? »IngredientThe actual ingredient - either a substance (simple ingredient) or another medicationitem : Reference [1..1] « Substance|Medication »Specifies how many (or how much) of the items there are in this Medication. E.g. 250 mg per tabletamount : Ratio [0..1]BatchThe assigned lot number of a batch of the specified productlotNumber : string [0..1]When this specific batch of product will expireexpirationDate : dateTime [0..1]PackageThe kind of container that this package comes ascontainer : CodeableConcept [0..1] « Kind of container a medication package is packaged in (Strength=Example)SNOMED CT Form ?? »ContentIdentifies one of the items in the packageitem : Reference [1..1] « Medication »The amount of the product that is in the packageamount : Quantity(SimpleQuantity) [0..1]Identifies a particular constituent of interest in the productingredient[0..*]Information about a group of medication produced or packaged from one production runbatch[0..*]Information that only applies to products (not packages)product[0..1]A set of components that go to make up the described itemcontent[0..*]Information that only applies to packages (not products)package[0..1]

XML Template

<Medication xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <code><!-- 0..1 CodeableConcept Codes that identify this medication --></code>
 <isBrand value="[boolean]"/><!-- 0..1 True if a brand -->
 <manufacturer><!-- 0..1 Reference(Organization) Manufacturer of the item --></manufacturer>
 <product>  <!-- 0..1 Administrable medication details -->
  <form><!-- 0..1 CodeableConcept powder | tablets | carton + --></form>
  <ingredient>  <!-- 0..* Active or inactive ingredient -->
   <item><!-- 1..1 Reference(Substance|Medication) The product contained --></item>
   <amount><!-- 0..1 Ratio How much ingredient in product --></amount>
  </ingredient>
  <batch>  <!-- 0..* -->
   <lotNumber value="[string]"/><!-- 0..1  -->
   <expirationDate value="[dateTime]"/><!-- 0..1  -->
  </batch>
 </product>
 <package>  <!-- 0..1 Details about packaged medications -->
  <container><!-- 0..1 CodeableConcept E.g. box, vial, blister-pack --></container>
  <content>  <!-- 0..* What is  in the package? -->
   <item><!-- 1..1 Reference(Medication) A product in the package --></item>
   <amount><!-- 0..1 Quantity(SimpleQuantity) How many are in the package? --></amount>
  </content>
 </package>
</Medication>

 

Alternate definitions: Schema/Schematron, Resource Profile (XML, JSON), Questionnaire

4.12.2.1 Terminology Bindings

PathDefinitionTypeReference
Medication.code A code that defines the type of a medicationExampleSnomed Medication Codes
Medication.product.form The form of a medicationExampleSNOMED CT Form Codes
Medication.package.container Kind of container a medication package is packaged inExampleSNOMED CT Form Codes

4.12.3 Search Parameters

Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.

NameTypeDescriptionPaths
codetokenCodes that identify this medicationMedication.code
containertokenE.g. box, vial, blister-packMedication.package.container
contentreferenceA product in the packageMedication.package.content.item
(Medication)
formtokenpowder | tablets | carton +Medication.product.form
ingredientreferenceThe product containedMedication.product.ingredient.item
(Medication, Substance)
manufacturerreferenceManufacturer of the itemMedication.manufacturer
(Organization)