4.12 4.23 Resource Medication - Content Resource Medication - Content

4.12.1 Scope and Usage 4.23.1 Scope and Usage Representing 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, 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 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? 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

Representing 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, 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 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?

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.

• Structure
• UML
• XML
• JSON
• All

Structure

The product contained A product in the package

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

<Medication xmlns="http://hl7.org/fhir"> 
 <!-- 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>

   <item[x]><!-- 1..1 CodeableConcept|Reference(Substance|Medication) The product contained --></item[x]>

   <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>

   <item[x]><!-- 1..1 CodeableConcept|Reference(Medication) The item in the package --></item[x]>

   <amount><!-- 0..1 Quantity(SimpleQuantity) Quantity present in the package --></amount>
  </content>
 </package>
</Medication>

{
  "resourceType" : "Medication",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "code" : { CodeableConcept }, // Codes that identify this medication
  "isBrand" : <boolean>, // True if a brand
  "manufacturer" : { Reference(Organization) }, // Manufacturer of the item
  "product" : { // Administrable medication details
    "form" : { CodeableConcept }, // powder | tablets | carton +
    "ingredient" : [{ // Active or inactive ingredient
      "

      // item[x]: The product contained. One of these 2:
      "itemCodeableConcept" : { CodeableConcept },
      "itemReference" : { Reference(Substance|Medication) },

      "amount" : { Ratio } // Quantity of ingredient present
    }],
    "batch" : [{ // 
      "lotNumber" : "<string>", // 
      "expirationDate" : "<dateTime>" // 
    }]
  },
  "package" : { // Details about packaged medications
    "container" : { CodeableConcept }, // E.g. box, vial, blister-pack
    "content" : [{ // What is  in the package
      "

      // item[x]: The item in the package. One of these 2:
      "itemCodeableConcept" : { CodeableConcept },
      "itemReference" : { Reference(Medication) },

      "amount" : { Quantity(SimpleQuantity) } // Quantity present in the package
    }]
  }
}

Structure

The product contained A product in the package

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

UML Diagram UML Diagram

XML Template XML Template

<Medication xmlns="http://hl7.org/fhir"> 
 <!-- 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>

   <item[x]><!-- 1..1 CodeableConcept|Reference(Substance|Medication) The product contained --></item[x]>

   <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>

   <item[x]><!-- 1..1 CodeableConcept|Reference(Medication) The item in the package --></item[x]>

   <amount><!-- 0..1 Quantity(SimpleQuantity) Quantity present in the package --></amount>
  </content>
 </package>
</Medication>

JSON Template JSON Template

{
  "resourceType" : "Medication",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "code" : { CodeableConcept }, // Codes that identify this medication
  "isBrand" : <boolean>, // True if a brand
  "manufacturer" : { Reference(Organization) }, // Manufacturer of the item
  "product" : { // Administrable medication details
    "form" : { CodeableConcept }, // powder | tablets | carton +
    "ingredient" : [{ // Active or inactive ingredient
      "

      // item[x]: The product contained. One of these 2:
      "itemCodeableConcept" : { CodeableConcept },
      "itemReference" : { Reference(Substance|Medication) },

      "amount" : { Ratio } // Quantity of ingredient present
    }],
    "batch" : [{ // 
      "lotNumber" : "<string>", // 
      "expirationDate" : "<dateTime>" // 
    }]
  },
  "package" : { // Details about packaged medications
    "container" : { CodeableConcept }, // E.g. box, vial, blister-pack
    "content" : [{ // What is  in the package
      "

      // item[x]: The item in the package. One of these 2:
      "itemCodeableConcept" : { CodeableConcept },
      "itemReference" : { Reference(Medication) },

      "amount" : { Quantity(SimpleQuantity) } // Quantity present in the package
    }]
  }
}