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.6 Resource MedicationKnowledge - Content

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

Information about a medication that is used to support knowledge.

11.6.1 Scope and Usage

This resource supports use cases for creation of and querying for medication information including attributes such as medication classifications, images of medications, costs and/or coverages, etc. This resource can be used to return medication information as part of a formulary or a catalogue.

Where the Medication resource is intended for the simple identification of a medication for prescribing, dispensing, or administering, the MedicationKnowledge resource is intended to provide more detailed information about the medication. Unlike the MedicinalProductDefinition resource, the MedicationKnowledge resource is not a complete definition of the medication but provides some definitional information along with formulary/catalogue-specific information such as costs, monitoring programs, etc.

11.6.2 References to this Resource

11.6.3 Resource Content

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. MedicationKnowledge TU DomainResource Definition of Medication Knowledge

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

... code Σ 0..1 CodeableConcept Code that identifies this medication
Binding: SNOMED CT Medication Codes (Example)
... status ?!Σ 0..1 code draft | active | retired | unknown
Binding: PublicationStatus (Required)
... jurisdiction 0..* CodeableConcept Codes that identify the different jurisdictions for which the information of this resource was created

... name Σ 0..1 string A name associated with the medication being described
... relatedMedicationKnowledge 0..* BackboneElement Associated or related medication information

.... type 1..1 CodeableConcept Category of medicationKnowledge
.... reference 1..* Reference(MedicationKnowledge) Associated documentation about the associated medication knowledge

... associatedMedication 0..* Reference(Medication) The set of medication resources that are associated with this medication

... productType 0..* CodeableConcept Category of the medication or product

... monograph 0..* BackboneElement Associated documentation about the medication

.... type 0..1 CodeableConcept The category of medication document
.... source 0..1 Reference(DocumentReference) Associated documentation about the medication
... preparationInstruction 0..1 markdown The instructions for preparing the medication
... cost 0..* BackboneElement The pricing of the medication

.... effectiveDate 0..* Period The date range for which the cost is effective

.... type 1..1 CodeableConcept The category of the cost information
.... source 0..1 string The source or owner for the price information
.... cost[x] 1..1 The price or category of the cost of the medication
Binding: Medication Cost Category Codes (Example)
..... costMoney Money
..... costCodeableConcept CodeableConcept
... monitoringProgram Σ 0..* BackboneElement Program under which a medication is reviewed

.... type 0..1 CodeableConcept Type of program under which the medication is monitored
.... name 0..1 string Name of the reviewing program
... indicationGuideline 0..* BackboneElement Guidelines or protocols for administration of the medication for an indication

.... indication 0..* CodeableReference(ClinicalUseDefinition) Indication for use that applies to the specific administration guideline

.... dosingGuideline 0..* BackboneElement Guidelines for dosage of the medication

..... treatmentIntent 0..1 CodeableConcept Intention of the treatment
..... dosage 0..* BackboneElement Dosage for the medication for the specific guidelines

...... type 1..1 CodeableConcept Category of dosage for a medication
...... dosage 1..* Dosage Dosage for the medication for the specific guidelines

..... administrationTreatment 0..1 CodeableConcept Type of treatment the guideline applies to
..... patientCharacteristic 0..* BackboneElement Characteristics of the patient that are relevant to the administration guidelines

...... type 1..1 CodeableConcept Categorization of specific characteristic that is relevant to the administration guideline
...... value[x] 0..1 The specific characteristic
....... valueCodeableConcept CodeableConcept
....... valueQuantity Quantity
....... valueRange Range
... medicineClassification 0..* BackboneElement Categorization of the medication within a formulary or classification system

.... type 1..1 CodeableConcept The type of category for the medication (for example, therapeutic classification, therapeutic sub-classification)
.... source[x] 0..1 The source of the classification
..... sourceString string
..... sourceUri uri
.... classification 0..* CodeableConcept Specific category assigned to the medication

... packaging 0..* BackboneElement Details about packaged medications

.... cost 0..* see cost Cost of the packaged medication

.... packagedProduct 0..1 Reference(PackagedProductDefinition) The packaged medication that is being priced
... clinicalUseIssue 0..* Reference(ClinicalUseDefinition) Potential clinical issue with or between medication(s)

... storageGuideline 0..* BackboneElement How the medication should be stored

.... reference 0..1 uri Reference to additional information
.... note 0..* Annotation Additional storage notes

.... stabilityDuration 0..1 Duration Duration remains stable
.... environmentalSetting 0..* BackboneElement Setting or value of environment for adequate storage

..... type 1..1 CodeableConcept Categorization of the setting
..... value[x] 1..1 Value of the setting
...... valueQuantity Quantity
...... valueRange Range
...... valueCodeableConcept CodeableConcept
... regulatory 0..* BackboneElement Regulatory information about a medication

.... regulatoryAuthority 1..1 Reference(Organization) Specifies the authority of the regulation
.... substitution 0..* BackboneElement Specifies if changes are allowed when dispensing a medication from a regulatory perspective

..... type 1..1 CodeableConcept Specifies the type of substitution allowed
..... allowed 1..1 boolean Specifies if regulation allows for changes in the medication when dispensing
.... schedule 0..* CodeableConcept Specifies the schedule of a medication in jurisdiction

.... maxDispense 0..1 BackboneElement The maximum number of units of the medication that can be dispensed in a period
..... quantity 1..1 SimpleQuantity The maximum number of units of the medication that can be dispensed
..... period 0..1 Duration The period that applies to the maximum number of units
... definitional 0..1 BackboneElement Minimal definition information about the medication
.... definition 0..* Reference(MedicinalProductDefinition) Definitional resources that provide more information about this medication

.... doseForm 0..1 CodeableConcept powder | tablets | capsule +
Binding: SNOMED CT Form Codes (Example)
.... intendedRoute 0..* CodeableConcept The intended or approved route of administration
Binding: SNOMED CT Route Codes (Example)

.... ingredient Σ 0..* BackboneElement Active or inactive ingredient

..... item Σ 1..1 CodeableReference(Substance) Substances contained in the medication
..... type 0..1 CodeableConcept A code that defines the type of ingredient, active, base, etc
Binding: RoleClassIngredientEntity icon (Example)
..... strength[x] 0..1 Quantity of ingredient present
Binding: Medication Ingredient Strength Codes (Example)
...... strengthRatio Ratio
...... strengthCodeableConcept CodeableConcept
...... strengthQuantity Quantity
.... drugCharacteristic 0..* BackboneElement Specifies descriptive properties of the medicine

..... type 0..1 CodeableConcept Code specifying the type of characteristic of medication
Binding: medicationKnowledge Characteristic Codes (Example)
..... value[x] 0..1 Description of the characteristic
...... valueCodeableConcept CodeableConcept
...... valueString string
...... valueQuantity SimpleQuantity
...... valueBase64Binary base64Binary
...... valueAttachment Attachment

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) , the spreadsheet version & the dependency analysis

11.6.3.1 Terminology Bindings

Path ValueSet Type Documentation
MedicationKnowledge.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.
MedicationKnowledge.status PublicationStatus Required

The lifecycle status of an artifact.
MedicationKnowledge.cost.cost[x] MedicationCostCategoryCodes Example

Medication Cost Category Codes
MedicationKnowledge.definitional.doseForm SNOMEDCTFormCodes Example

This value set includes all dose form codes from SNOMED CT - provided as an exemplar.
MedicationKnowledge.definitional.intendedRoute SNOMEDCTRouteCodes Example

This value set includes all Route codes from SNOMED CT - provided as an exemplar.
MedicationKnowledge.definitional.ingredient.type RoleClassIngredientEntity icon Example

Relates a component (player) to a mixture (scoper). E.g., Glucose and Water are ingredients of D5W, latex may be an ingredient in a tracheal tube.
MedicationKnowledge.definitional.ingredient.strength[x] MedicationIngredientStrengthCodes Example

Medication Ingredient Strength Codes
MedicationKnowledge.definitional.drugCharacteristic.type MedicationKnowledgeCharacteristicCodes Example

MedicationKnowledge Characteristic Codes

11.6.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
classification token Specific category assigned to the medication MedicationKnowledge.medicineClassification.classification
classification-type token The type of category for the medication (for example, therapeutic classification, therapeutic sub-classification) MedicationKnowledge.medicineClassification.type
code token Code that identifies this medication MedicationKnowledge.code
doseform token powder | tablets | capsule + MedicationKnowledge.definitional.doseForm
identifier token Business identifier for this medication MedicationKnowledge.identifier 35 Resources
ingredient reference Reference to a resource (by instance) MedicationKnowledge.definitional.ingredient.item.reference
ingredient-code token Reference to a concept (by class) MedicationKnowledge.definitional.ingredient.item.concept
monitoring-program-name token Name of the reviewing program MedicationKnowledge.monitoringProgram.name
monitoring-program-type token Type of program under which the medication is monitored MedicationKnowledge.monitoringProgram.type
monograph reference Associated documentation about the medication MedicationKnowledge.monograph.source
(DocumentReference)
monograph-type token The category of medication document MedicationKnowledge.monograph.type
packaging-cost quantity The cost of the packaged medication, if the cost is Money
packaging-cost-concept token The cost of the packaged medication, if the cost is a CodeableConcept
product-type token Category of the medication or product MedicationKnowledge.productType
source-cost token The source or owner for the price information MedicationKnowledge.cost.source
status token active | inactive | entered-in-error MedicationKnowledge.status 35 Resources