FHIR Release 3 (STU) Current Build
This page is part of FHIR STU 3 (v3.0.1) in it's permanent home (it will always be available at this URL). It has been superceded by R4 . For a full list of available versions, see the Directory of published versions .

11.5 Resource Medication - Content

Pharmacy Work Group Maturity Level : 3   Trial Use Security Category : Business Compartments : Not linked to any defined compartments

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

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 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 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 cases, the ingredients of the medicine have to be specified together with the amount contained, though the medication 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), as well as 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 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).

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

This resource is referenced by ActivityDefinition , AdverseEvent , CarePlan , ChargeItem , ChargeItemDefinition , ClinicalUseIssue , Flag , Group , itself, MedicationAdministration , MedicationDispense , MedicationKnowledge , MedicationRequest , MedicationStatement MedicationUsage , Procedure , SupplyDelivery and SupplyRequest .

This resource does not implement any patterns.

Structure

itemReference Reference ( Medication ) amount 0..1 SimpleQuantity Quantity present in the package image 0..* Attachment Picture of the medication
Name Flags Card. Type Description & Constraints doco
. . 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
SNOMED CT Medication Codes ( Example )
. . . status ?! Σ 0..1 code active | inactive | entered-in-error
MedicationStatus Medication status codes ( Required )
. . isBrand Σ 0..1 boolean True if a brand isOverTheCounter Σ 0..1 boolean True if medication does not require a prescription . manufacturer Σ 0..1 Reference ( Organization ) Manufacturer of the item
. . form . doseForm 0..1 CodeableConcept powder | tablets | capsule +
SNOMED CT Form Codes ( Example )
. . . amount Σ 0..1 Ratio Amount of drug in package
... ingredient 0..* BackboneElement Active or inactive ingredient
. . . . item[x] 1..1 The product contained actual ingredient or content
. . . . . itemCodeableConcept CodeableConcept
. . . . . itemReference Reference ( Substance | Medication )
. . . . isActive 0..1 boolean Active ingredient indicator
. . . amount . strength[x] 0..1 Ratio Quantity of ingredient present package 0..1 BackboneElement Details about packaged medications container 0..1 CodeableConcept E.g. box, vial, blister-pack
MedicationContainer Medication ingredient strength codes ( Example )
. . content 0..* BackboneElement What is in the package . . . strengthRatio item[x] Ratio 1..1 The item in the package
. . . . . itemCodeableConcept strengthCodeableConcept CodeableConcept
. . . batch 0..* 0..1 BackboneElement Identifies a single production run Details about packaged medications
. . . . lotNumber 0..1 string Identifier assigned to batch
. . . . expirationDate 0..1 dateTime When batch will expire

doco Documentation for this format

UML Diagram ( Legend )

Medication ( DomainResource ) Business identifier for this medication identifier : Identifier [0..*] 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 systems code : CodeableConcept [0..1] « A coded concept that defines the type of a medication medication. (Strength=Example) SNOMED CT Medication SNOMEDCTMedicationCodes ?? » A code to indicate if the medication is in active use (this element modifies the meaning of other elements) status : code [0..1] « A coded concept defining if the medication is in active use use. (Strength=Required) MedicationStatus Medication Status ! » Set to true if the item is attributable to a specific manufacturer isBrand : boolean [0..1] Set to true if the medication can be obtained without an order from a prescriber isOverTheCounter : boolean [0..1] Describes the details of the manufacturer of the medication product. This is not intended to represent the distributor of a medication product manufacturer : Reference [0..1] « Organization » Describes the form of the item. Powder; tablets; capsule form doseForm : CodeableConcept [0..1] « A coded concept defining the form of a medication medication. (Strength=Example) SNOMED CT Form SNOMEDCTFormCodes ?? » Photo(s) or graphic representation(s) Specific amount of the medication drug in the packaged product. For example, when specifying a product that has the same strength (For example, Insulin glargine 100 unit per mL solution for injection), this attribute provides additional clarification of the package amount (For example, 3 mL, 10mL, etc.) image amount : Attachment Ratio [0..*] [0..1] Ingredient The actual ingredient - either a substance (simple ingredient) or another medication of a medication item[x] : Type [1..1] « CodeableConcept | Reference ( Substance | Medication ) » Indication of whether thisingredient affectsthe this ingredient affects the therapeutic action of the drug isActive : boolean [0..1] Specifies how many (or how much) of the items there are in this Medication. For example, 250 mg per tablet. This is expressed as a ratio where the numerator is 250mg and the denominator is 1 tablet amount strength[x] : Ratio Type [0..1] Package The kind of container that this package comes as container « Ratio : | CodeableConcept [0..1] ; A coded concept concpet defining the kind strength of container a medication package is packaged in an ingredient. (Strength=Example) MedicationContainer ?? Content Identifies one of the items in the package item[x] : Type [1..1] CodeableConcept | Reference ( Medication ) The amount of the product that is in the package amount : Quantity ( SimpleQuantity Ingredient Strengt... ) [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] Identifies a particular constituent of interest in the product ingredient [0..*] A set of components that go to make up the described item content [0..*] Information about a group of medication produced or packaged from one production run batch [0..*] Information that only applies to packages (not products) package batch [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 -->
 <identifier><!-- 0..* Identifier Business identifier for this medication --></identifier>

 <code><!-- 0..1 CodeableConcept Codes that identify this medication --></code>
 <
 <
 <

 <status value="[code]"/><!-- 0..1 active | inactive | entered-in-error -->

 <manufacturer><!-- 0..1 Reference(Organization) Manufacturer of the item --></manufacturer>
 <</form>

 <doseForm><!-- 0..1 CodeableConcept powder | tablets | capsule + --></doseForm>
 <amount><!-- 0..1 Ratio Amount of drug in package --></amount>

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

  <item[x]><!-- 1..1 CodeableConcept|Reference(Medication|Substance) The actual ingredient or content --></item[x]>
  <isActive value="[boolean]"/><!-- 0..1 Active ingredient indicator -->
  <strength[x]><!-- 0..1 Ratio|CodeableConcept Quantity of ingredient present --></strength[x]>

 </ingredient>
 <
  <</container>
  <
   <</item[x]>
   <</amount>
  </content>
  <
   <
   <
  </batch>
 </package>
 <</image>

 <batch>  <!-- 0..1 Details about packaged medications -->
  <lotNumber value="[string]"/><!-- 0..1 Identifier assigned to batch -->
  <expirationDate value="[dateTime]"/><!-- 0..1 When batch will expire -->
 </batch>

</Medication>

JSON Template

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .doco
[ a fhir:;

[ a fhir:Medication;

  fhir:nodeRole fhir:treeRoot; # if this is the parser root
  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:Medication.identifier [ Identifier ], ... ; # 0..* Business identifier for this medication

  fhir:Medication.code [ CodeableConcept ]; # 0..1 Codes that identify this medication
  fhir:
  fhir:
  fhir:

  fhir:Medication.status [ code ]; # 0..1 active | inactive | entered-in-error

  fhir:Medication.manufacturer [ Reference(Organization) ]; # 0..1 Manufacturer of the item
  fhir:

  fhir:Medication.doseForm [ CodeableConcept ]; # 0..1 powder | tablets | capsule +
  fhir:Medication.amount [ Ratio ]; # 0..1 Amount of drug in package

  fhir:Medication.ingredient [ # 0..* Active or inactive ingredient
    # . One of these 2
      fhir: ]
      fhir:) ]
    fhir:
    fhir:

    # Medication.ingredient.item[x] : 1..1 The actual ingredient or content. One of these 2
      fhir:Medication.ingredient.itemCodeableConcept [ CodeableConcept ]
      fhir:Medication.ingredient.itemReference [ Reference(Medication|Substance) ]
    fhir:Medication.ingredient.isActive [ boolean ]; # 0..1 Active ingredient indicator
    # Medication.ingredient.strength[x] : 0..1 Quantity of ingredient present. One of these 2
      fhir:Medication.ingredient.strengthRatio [ Ratio ]
      fhir:Medication.ingredient.strengthCodeableConcept [ CodeableConcept ]

  ], ...;
  fhir:
    fhir:
    fhir:
      # . One of these 2
        fhir: ]
        fhir:) ]
      fhir:
    ], ...;
    fhir:
      fhir:
      fhir:
    ], ...;

  fhir:Medication.batch [ # 0..1 Details about packaged medications
    fhir:Medication.batch.lotNumber [ string ]; # 0..1 Identifier assigned to batch
    fhir:Medication.batch.expirationDate [ dateTime ]; # 0..1 When batch will expire

  ];
  fhir:

]

Changes since DSTU2 R3

Medication Medication.status Added Element Medication.isOverTheCounter Added Element Medication.form Added Element Medication.ingredient Added Element Medication.ingredient.item[x] Added Element Medication.ingredient.isActive Added Element Medication.ingredient.amount Added Element
Medication.package.content.item[x] Medication.status
  • Renamed Change value set from item http://hl7.org/fhir/ValueSet/medication-status|4.0.0 to item[x] Add CodeableConcept Medication.package.batch Added Element http://hl7.org/fhir/ValueSet/medication-status|4.1.0
Medication.package.batch.lotNumber Medication.doseForm
  • Added Element
Medication.package.batch.expirationDate Medication.ingredient.strength[x]
  • Added Element
Medication.image Medication.form
  • Added Element deleted
Medication.product Medication.ingredient.strength
  • deleted

See the Full Difference for further information

This analysis is available as XML or JSON .

See R2 <--> R3 <--> R4 Conversion Maps (status = 23 tests that all execute ok. 16 22 fail round-trip testing and 1 22 r3 resources are invalid (1 (0 errors). ). )

Structure

itemReference Reference ( Medication ) amount 0..1 SimpleQuantity Quantity present in the package image 0..* Attachment Picture of the medication
Name Flags Card. Type Description & Constraints doco
. . 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
SNOMED CT Medication Codes ( Example )
. . . status ?! Σ 0..1 code active | inactive | entered-in-error
MedicationStatus Medication status codes ( Required )
. . isBrand Σ 0..1 boolean True if a brand isOverTheCounter Σ 0..1 boolean True if medication does not require a prescription . manufacturer Σ 0..1 Reference ( Organization ) Manufacturer of the item
. . form . doseForm 0..1 CodeableConcept powder | tablets | capsule +
SNOMED CT Form Codes ( Example )
. . . amount Σ 0..1 Ratio Amount of drug in package
... ingredient 0..* BackboneElement Active or inactive ingredient
. . . . item[x] 1..1 The product contained actual ingredient or content
. . . . . itemCodeableConcept CodeableConcept
. . . . . itemReference Reference ( Substance | Medication )
. . . . isActive 0..1 boolean Active ingredient indicator
. . . amount . strength[x] 0..1 Ratio Quantity of ingredient present package 0..1 BackboneElement Details about packaged medications container 0..1 CodeableConcept E.g. box, vial, blister-pack
MedicationContainer Medication ingredient strength codes ( Example )
. . content 0..* BackboneElement What is in the package . . . strengthRatio item[x] Ratio 1..1 The item in the package
. . . . . itemCodeableConcept strengthCodeableConcept CodeableConcept
. . . batch 0..* 0..1 BackboneElement Identifies a single production run Details about packaged medications
. . . . lotNumber 0..1 string Identifier assigned to batch
. . . . expirationDate 0..1 dateTime When batch will expire

doco Documentation for this format

UML Diagram ( Legend )

Medication ( DomainResource ) Business identifier for this medication identifier : Identifier [0..*] 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 systems code : CodeableConcept [0..1] « A coded concept that defines the type of a medication medication. (Strength=Example) SNOMED CT Medication SNOMEDCTMedicationCodes ?? » A code to indicate if the medication is in active use (this element modifies the meaning of other elements) status : code [0..1] « A coded concept defining if the medication is in active use use. (Strength=Required) MedicationStatus Medication Status ! » Set to true if the item is attributable to a specific manufacturer isBrand : boolean [0..1] Set to true if the medication can be obtained without an order from a prescriber isOverTheCounter : boolean [0..1] Describes the details of the manufacturer of the medication product. This is not intended to represent the distributor of a medication product manufacturer : Reference [0..1] « Organization » Describes the form of the item. Powder; tablets; capsule form doseForm : CodeableConcept [0..1] « A coded concept defining the form of a medication medication. (Strength=Example) SNOMED CT Form SNOMEDCTFormCodes ?? » Photo(s) or graphic representation(s) Specific amount of the medication drug in the packaged product. For example, when specifying a product that has the same strength (For example, Insulin glargine 100 unit per mL solution for injection), this attribute provides additional clarification of the package amount (For example, 3 mL, 10mL, etc.) image amount : Attachment Ratio [0..*] [0..1] Ingredient The actual ingredient - either a substance (simple ingredient) or another medication of a medication item[x] : Type [1..1] « CodeableConcept | Reference ( Substance | Medication ) » Indication of whether thisingredient affectsthe this ingredient affects the therapeutic action of the drug isActive : boolean [0..1] Specifies how many (or how much) of the items there are in this Medication. For example, 250 mg per tablet. This is expressed as a ratio where the numerator is 250mg and the denominator is 1 tablet amount strength[x] : Ratio Type [0..1] Package The kind of container that this package comes as container « Ratio : | CodeableConcept [0..1] ; A coded concept concpet defining the kind strength of container a medication package is packaged in an ingredient. (Strength=Example) MedicationContainer ?? Content Identifies one of the items in the package item[x] : Type [1..1] CodeableConcept | Reference ( Medication ) The amount of the product that is in the package amount : Quantity ( SimpleQuantity Ingredient Strengt... ) [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] Identifies a particular constituent of interest in the product ingredient [0..*] A set of components that go to make up the described item content [0..*] Information about a group of medication produced or packaged from one production run batch [0..*] Information that only applies to packages (not products) package batch [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 -->
 <identifier><!-- 0..* Identifier Business identifier for this medication --></identifier>

 <code><!-- 0..1 CodeableConcept Codes that identify this medication --></code>
 <
 <
 <

 <status value="[code]"/><!-- 0..1 active | inactive | entered-in-error -->

 <manufacturer><!-- 0..1 Reference(Organization) Manufacturer of the item --></manufacturer>
 <</form>

 <doseForm><!-- 0..1 CodeableConcept powder | tablets | capsule + --></doseForm>
 <amount><!-- 0..1 Ratio Amount of drug in package --></amount>

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

  <item[x]><!-- 1..1 CodeableConcept|Reference(Medication|Substance) The actual ingredient or content --></item[x]>
  <isActive value="[boolean]"/><!-- 0..1 Active ingredient indicator -->
  <strength[x]><!-- 0..1 Ratio|CodeableConcept Quantity of ingredient present --></strength[x]>

 </ingredient>
 <
  <</container>
  <
   <</item[x]>
   <</amount>
  </content>
  <
   <
   <
  </batch>
 </package>
 <</image>

 <batch>  <!-- 0..1 Details about packaged medications -->
  <lotNumber value="[string]"/><!-- 0..1 Identifier assigned to batch -->
  <expirationDate value="[dateTime]"/><!-- 0..1 When batch will expire -->
 </batch>

</Medication>

JSON Template

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .doco
[ a fhir:;

[ a fhir:Medication;

  fhir:nodeRole fhir:treeRoot; # if this is the parser root
  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:Medication.identifier [ Identifier ], ... ; # 0..* Business identifier for this medication

  fhir:Medication.code [ CodeableConcept ]; # 0..1 Codes that identify this medication
  fhir:
  fhir:
  fhir:

  fhir:Medication.status [ code ]; # 0..1 active | inactive | entered-in-error

  fhir:Medication.manufacturer [ Reference(Organization) ]; # 0..1 Manufacturer of the item
  fhir:

  fhir:Medication.doseForm [ CodeableConcept ]; # 0..1 powder | tablets | capsule +
  fhir:Medication.amount [ Ratio ]; # 0..1 Amount of drug in package

  fhir:Medication.ingredient [ # 0..* Active or inactive ingredient
    # . One of these 2
      fhir: ]
      fhir:) ]
    fhir:
    fhir:

    # Medication.ingredient.item[x] : 1..1 The actual ingredient or content. One of these 2
      fhir:Medication.ingredient.itemCodeableConcept [ CodeableConcept ]
      fhir:Medication.ingredient.itemReference [ Reference(Medication|Substance) ]
    fhir:Medication.ingredient.isActive [ boolean ]; # 0..1 Active ingredient indicator
    # Medication.ingredient.strength[x] : 0..1 Quantity of ingredient present. One of these 2
      fhir:Medication.ingredient.strengthRatio [ Ratio ]
      fhir:Medication.ingredient.strengthCodeableConcept [ CodeableConcept ]

  ], ...;
  fhir:
    fhir:
    fhir:
      # . One of these 2
        fhir: ]
        fhir:) ]
      fhir:
    ], ...;
    fhir:
      fhir:
      fhir:
    ], ...;

  fhir:Medication.batch [ # 0..1 Details about packaged medications
    fhir:Medication.batch.lotNumber [ string ]; # 0..1 Identifier assigned to batch
    fhir:Medication.batch.expirationDate [ dateTime ]; # 0..1 When batch will expire

  ];
  fhir:

]

Changes since DSTU2 Release 3

Medication Medication.status Added Element Medication.isOverTheCounter Added Element Medication.form Added Element Medication.ingredient Added Element Medication.ingredient.item[x] Added Element Medication.ingredient.isActive Added Element Medication.ingredient.amount Added Element
Medication.package.content.item[x] Medication.status
  • Renamed Change value set from item http://hl7.org/fhir/ValueSet/medication-status|4.0.0 to item[x] Add CodeableConcept Medication.package.batch Added Element http://hl7.org/fhir/ValueSet/medication-status|4.1.0
Medication.package.batch.lotNumber Medication.doseForm
  • Added Element
Medication.package.batch.expirationDate Medication.ingredient.strength[x]
  • Added Element
Medication.image Medication.form
  • Added Element deleted
Medication.product Medication.ingredient.strength
  • deleted

See the Full Difference for further information

This analysis is available as XML or JSON .

See R2 <--> R3 <--> R4 Conversion Maps (status = 23 tests that all execute ok. 16 22 fail round-trip testing and 1 22 r3 resources are invalid (1 (0 errors). ). )

 

Alternate See the Profiles & Extensions and the alternate definitions: Master Definition ( XML , + JSON ), , XML Schema / Schematron (for ) + JSON Schema , ShEx (for Turtle ) + see the extensions , the spreadsheet version & the dependency analysis a

Medication.package.container
Path Definition Type Reference
Medication.code A coded concept that defines the type of a medication medication. Example SNOMED CT Medication Codes SNOMEDCTMedicationCodes
Medication.status A coded concept defining if the medication is in active use use. Required MedicationStatus Medication Status Codes
Medication.form Medication.doseForm A coded concept defining the form of a medication medication. Example SNOMED CT Form Codes SNOMEDCTFormCodes
Medication.ingredient.strength[x] A coded concept concpet defining the kind strength of container a medication package is packaged in an ingredient. Example MedicationContainer Medication Ingredient Strength Codes

Medication does not have a status. If Medication was used to support a formulary use case, then an extension can be used to convey formulary statuses, such as active (e.g. the medication can be ordered) or inactive (e.g. the medication can be documented, but not ordered). Pharmacy is evaluating formulary use cases. Feedback is encouraged to the Pharmacy working group committee. group.

Search parameters for 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 Codes that identify this medication Returns medications for a specific code Medication.code 4 13 Resources
container expiration-date token date E.g. box, vial, blister-pack Returns medications in a batch with this expiration date Medication.package.container Medication.batch.expirationDate
form token powder | tablets | capsule + Medication.form Returns medications for a specific dose form ingredient reference The product contained Medication.ingredient.item.as(Reference) ( Medication , Substance )
ingredient-code identifier token The product contained Returns medications with this external identifier Medication.ingredient.item.as(CodeableConcept) Medication.identifier
manufacturer ingredient reference Manufacturer of the item Returns medications for this ingredient reference Medication.manufacturer (Medication.ingredient.item as Reference)
( Organization Medication , Substance )
over-the-counter ingredient-code token True if medication does not require a prescription Returns medications for this ingredient code Medication.isOverTheCounter (Medication.ingredient.item as CodeableConcept)
package-item lot-number reference token The item Returns medications in the package a batch with this lot number Medication.package.content.item.as(Reference) ( Medication ) Medication.batch.lotNumber
package-item-code manufacturer token reference The item in the package Returns medications made or sold for this manufacturer Medication.package.content.item.as(CodeableConcept) Medication.manufacturer
( Organization )
status token active | inactive | entered-in-error Returns medications for this status Medication.status