DSTU2

This page is part of the FHIR Specification (v0.0.82: (v1.0.2: DSTU 1). 2). 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.8 4.12 Resource Medication - Content

Pharmacy Work Group Maturity Level : 1 Compartments : Not linked to any defined compartments

Primarily This resource is primarily used for the identification and definition of Medication, but also a medication. It covers the ingredients and packaging. the packaging for a medication.

4.8.1 4.12.1 Scope and Usage

Representing Medication medications 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 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 Medication resource allows for medications to be characterised characterized 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? However the kind element is not required because not all contexts of use are involved with prescription (medication statements, for instance). Typically, however, profiles describing the use of the medication resource in a prescribing environment will make the kind element required.

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.8.2 4.12.2 Resource Content

Structure

Name Flags Card. Type Description & Constraints doco
.. Medication DomainResource Definition of a Medication
... code Σ 0..1 CodeableConcept Codes that identify this medication
SNOMED CT Medication Codes ( Resource Example )
. The common/commercial name . . isBrand Σ 0..1 boolean True if a brand
... manufacturer Σ 0..1 Reference ( Organization ) Manufacturer of the item
... product 0..1 BackboneElement Administrable medication absent information such as strength, form, etc. E.g. Acetaminophen, Tylenol 3, etc. details
.... form 0..1 CodeableConcept powder | tablets | carton +
SNOMED CT Form Codes ( Example )
.... ingredient 0..* BackboneElement Active or inactive ingredient
..... item 1..1 Reference ( Substance | Medication ) The fully coordinated name is communicated as the display product contained
..... amount 0..1 Ratio Quantity of Medication.code name ingredient present
.... batch : 0..* BackboneElement
..... lotNumber 0..1 string
. . . . . expirationDate 0..1 dateTime
... package 0..1 BackboneElement Details about packaged medications
.... container 0..1 CodeableConcept E.g. box, vial, blister-pack
SNOMED CT Form Codes ( Example )
.... content 0..* BackboneElement What is in the package
..... item 1..1 Reference ( Medication ) A product in the package
..... amount 0..1 SimpleQuantity Quantity present in the package

doco Documentation for this format

UML Diagram

Medication ( DomainResource ) A code (or set of codes) that identify specify this medication. medication, or a textual description if no code is available. Usage note: This could be a standard drug medication code such as a drug regulator code, RxNorm code, code from RxNorm, SNOMED CT code, CT, IDMP etc. It could also be a national or local formulary code, optionally with translations to the standard drug codes other code systems code : CodeableConcept 0..1 << [0..1] « A code that defines the type of a medication (Strength=Example) MedicationFormalRepresentation SNOMED CT Medication >> ?? » Set to true if the item is attributable to a specific manufacturer (even if we don't know who that is) isBrand : boolean 0..1 [0..1] Describes the details of the manufacturer manufacturer : Resource Reference ( [0..1] « Organization ) 0..1 » Product Medications are Describes the form of the item. Powder; tablets; carton form : CodeableConcept [0..1] « The form of a medication (Strength=Example) SNOMED CT Form ?? » Ingredient The actual ingredient - either a single administrable product substance (simple ingredient) or another medication item : Reference [1..1] « Substance | Medication » Specifies how many (or how much) of the items there are in this Medication. For example, 250 mg per tablet amount : Ratio [0..1] Batch The assigned lot number of a package batch of the specified product lotNumber : string [0..1] When this specific batch of product will expire expirationDate : dateTime [0..1] Package The kind of container that contains this package comes as container : CodeableConcept [0..1] « Kind of container a medication package is packaged in (Strength=Example) SNOMED CT Form ?? » Content Identifies one of the items in the package item : Reference [1..1] « Medication » The amount of the product that is in the package amount : Quantity ( SimpleQuantity ) [0..1] Identifies a particular constituent of interest in the product ingredient [0..*] Information about a group of medication produced or more packaged from one production run batch [0..*] Information that only applies to products (not packages) kind product : [0..1] A set of components that go to make up the described item content [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 Quantity of ingredient present --></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) Quantity present in the package --></amount>
  </content>
 </package>
</Medication>

Structure

Whether
Name Flags Card. Type Description & Constraints doco
.. Medication DomainResource Definition of a Medication
... code Σ 0..1 << CodeableConcept Codes that identify this medication
SNOMED CT Medication Codes ( Example )
... isBrand Σ 0..1 boolean True if a brand
... manufacturer Σ 0..1 Reference ( Organization ) Manufacturer of the item
... product 0..1 BackboneElement Administrable medication details
.... form 0..1 CodeableConcept powder | tablets | carton +
SNOMED CT Form Codes ( Example )
.... ingredient 0..* BackboneElement Active or inactive ingredient
..... item 1..1 Reference ( Substance | Medication ) The product contained
..... amount 0..1 Ratio Quantity of ingredient present
.... batch 0..* BackboneElement
..... lotNumber 0..1 string
..... expirationDate 0..1 dateTime
... package 0..1 BackboneElement Details about packaged medications
.... container 0..1 CodeableConcept E.g. box, vial, blister-pack
SNOMED CT Form Codes ( Example )
.... content 0..* BackboneElement What is a in the package
..... item 1..1 Reference ( Medication ) A product in the package
..... amount 0..1 SimpleQuantity Quantity present in the package

doco Documentation for this format

UML Diagram

Medication ( DomainResource ) A code (or set of codes) that specify this medication, or a package 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 systems MedicationKind code >> : CodeableConcept [0..1] « A code that defines the type of a medication (Strength=Example) SNOMED CT Medication ?? » Set to true if the item is attributable to a specific manufacturer isBrand : boolean [0..1] Describes the details of the manufacturer manufacturer : Reference [0..1] « Organization » Product Describes the form of the item. Powder; tables; tablets; carton form : CodeableConcept 0..1 << [0..1] « The form of a medication (Strength=Example) MedicationForm SNOMED CT Form >> ?? » Ingredient The actual ingredient - either a substance (simple ingredient) or another medication item : Resource Reference ( [1..1] « Substance | Medication ) 1..1 » Specifies how many (or how much) of the items there are in this Medication. E.g. For example, 250 mg per tablet amount : Ratio 0..1 [0..1] Batch The assigned lot number of a batch of the specified product lotNumber : string [0..1] When this specific batch of product will expire expirationDate : dateTime [0..1] Package The kind of container that this package comes as container : CodeableConcept 0..1 << [0..1] « Kind of container a medication package is packaged in (Strength=Example) MedicationContainer SNOMED CT Form >> ?? » Content Identifies one of the items in the package item : Resource Reference ( [1..1] « Medication ) 1..1 » The amount of the product that is in the package amount : Quantity 0..1 ( SimpleQuantity ) [0..1] Identifies a particular constituent of interest in the product ingredient 0..* [0..*] Information about a group of medication produced or packaged from one production run batch [0..*] Information that only applies to products (not packages) product 0..1 [0..1] A set of components that go to make up the described item content 0..* [0..*] Information that only applies to packages (not products) package 0..1 [0..1] This resource is referenced by CarePlan , Group , MedicationAdministration , MedicationDispense , MedicationPrescription , MedicationStatement and Supply

XML Template

< <!-- from --> < <</code> < <</manufacturer> < 
<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>

  <form><!-- 0..1 CodeableConcept powder | tablets | carton + --></form>

  <ingredient>  <!-- 0..* Active or inactive ingredient -->
   <</item>
   <</amount>

   <item><!-- 1..1 Reference(Substance|Medication) The product contained --></item>
   <amount><!-- 0..1 Ratio Quantity of ingredient present --></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>
  <
   <</item>
   <</amount>

  <content>  <!-- 0..* What is  in the package -->
   <item><!-- 1..1 Reference(Medication) A product in the package --></item>
   <amount><!-- 0..1 Quantity(SimpleQuantity) Quantity present in the package --></amount>

  </content>
 </package>
</Medication>

 

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

4.8.2.1 4.12.2.1 Terminology Bindings

Path Definition Type Reference
Medication.code A code that defines the type of a medication Example http://hl7.org/fhir/vs/medication-codes Medication.kind Whether the medication is a product or a package Fixed http://hl7.org/fhir/medication-kind SNOMED CT Medication Codes
Medication.product.form The form of a medication Example http://hl7.org/fhir/vs/medication-form-codes SNOMED CT Form Codes
Medication.package.container Kind of container a medication package is packaged in Example http://hl7.org/fhir/vs/medication-package-form-codes SNOMED CT Form Codes

4.8.3 4.12.3 Search Parameters

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

name string Common / Commercial name Medication.name
Name Type Description Paths
_id token The logical resource id associated with the resource (must be supported by all servers) _language token The language of the resource code token Codes that identify this medication Medication.code
container token E.g. box, vial, blister-pack Medication.package.container
content reference A product in the package Medication.package.content.item
( Medication )
form token powder | tablets | carton + Medication.product.form
ingredient reference The product contained Medication.product.ingredient.item
( Medication , Substance )
manufacturer reference Manufacturer of the item Medication.manufacturer
( Organization )
var disqus_shortname = 'fhirdstu';(function() {var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;dsq.src = '//' + disqus_shortname + '.disqus.com/embed.js';(document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq); })(); Please enable JavaScript to view the comments powered by Disqus. comments powered by Disqus var _gaq = _gaq || []; _gaq.push(['_setAccount', 'UA-676355-1']); _gaq.push(['_setDomainName', '.hl7.org']); _gaq.push(['_trackPageview']); (function()