MedicationKnowledge

Introduction

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.

StructureDefinition

Elements (Simplified)

• MedicationKnowledge [0..*]: - Definition of Medication Knowledge
• MedicationKnowledge.identifier [0..*]: Identifier Business identifier for this medication
• MedicationKnowledge.code [0..1]: CodeableConcept example:medication-codes Code that identifies this medication
• MedicationKnowledge.status [0..1]: code required:publication-status draft | active | retired | unknown
• MedicationKnowledge.author [0..1]: ContactDetail Creator or owner of the knowledge or information about the medication
• MedicationKnowledge.jurisdiction [0..*]: CodeableConcept Codes that identify the different jurisdictions for which the information of this resource was created
• MedicationKnowledge.name [0..1]: string A name associated with the medication being described
• MedicationKnowledge.relatedMedicationKnowledge [0..*]: BackboneElement Associated or related medication information
• MedicationKnowledge.relatedMedicationKnowledge.type [1..1]: CodeableConcept Category of medicationKnowledge
• MedicationKnowledge.relatedMedicationKnowledge.reference [1..*]: Reference(MedicationKnowledge) Associated documentation about the associated medication knowledge
• MedicationKnowledge.associatedMedication [0..*]: Reference(Medication) The set of medication resources that are associated with this medication
• MedicationKnowledge.productType [0..*]: CodeableConcept Category of the medication or product
• MedicationKnowledge.monograph [0..*]: BackboneElement Associated documentation about the medication
• MedicationKnowledge.monograph.type [0..1]: CodeableConcept The category of medication document
• MedicationKnowledge.monograph.source [0..1]: Reference(DocumentReference) Associated documentation about the medication
• MedicationKnowledge.preparationInstruction [0..1]: markdown The instructions for preparing the medication
• MedicationKnowledge.cost [0..*]: BackboneElement The pricing of the medication
• MedicationKnowledge.cost.effectiveDate [0..*]: Period The date range for which the cost is effective
• MedicationKnowledge.cost.type [1..1]: CodeableConcept The category of the cost information
• MedicationKnowledge.cost.source [0..1]: string The source or owner for the price information
• MedicationKnowledge.cost.cost[x] [1..1]: Money, CodeableConcept example:medication-cost-category The price or category of the cost of the medication
• MedicationKnowledge.monitoringProgram [0..*]: BackboneElement Program under which a medication is reviewed
• MedicationKnowledge.monitoringProgram.type [0..1]: CodeableConcept Type of program under which the medication is monitored
• MedicationKnowledge.monitoringProgram.name [0..1]: string Name of the reviewing program
• MedicationKnowledge.indicationGuideline [0..*]: BackboneElement Guidelines or protocols for administration of the medication for an indication
• MedicationKnowledge.indicationGuideline.indication [0..*]: CodeableReference Indication for use that applies to the specific administration guideline
• MedicationKnowledge.indicationGuideline.dosingGuideline [0..*]: BackboneElement Guidelines for dosage of the medication
• MedicationKnowledge.indicationGuideline.dosingGuideline.treatmentIntent [0..1]: CodeableConcept Intention of the treatment
• MedicationKnowledge.indicationGuideline.dosingGuideline.dosage [0..*]: BackboneElement Dosage for the medication for the specific guidelines
• MedicationKnowledge.indicationGuideline.dosingGuideline.dosage.type [1..1]: CodeableConcept Category of dosage for a medication
• MedicationKnowledge.indicationGuideline.dosingGuideline.dosage.dosage [1..*]: Dosage Dosage for the medication for the specific guidelines
• MedicationKnowledge.indicationGuideline.dosingGuideline.administrationTreatment [0..1]: CodeableConcept Type of treatment the guideline applies to
• MedicationKnowledge.indicationGuideline.dosingGuideline.patientCharacteristic [0..*]: BackboneElement Characteristics of the patient that are relevant to the administration guidelines
• MedicationKnowledge.indicationGuideline.dosingGuideline.patientCharacteristic.type [1..1]: CodeableConcept Categorization of specific characteristic that is relevant to the administration guideline
• MedicationKnowledge.indicationGuideline.dosingGuideline.patientCharacteristic.value[x] [0..1]: CodeableConcept, Quantity, Range The specific characteristic
• MedicationKnowledge.medicineClassification [0..*]: BackboneElement Categorization of the medication within a formulary or classification system
• MedicationKnowledge.medicineClassification.type [0..1]: CodeableConcept The type of category for the medication (for example, therapeutic classification, therapeutic sub-classification)
• MedicationKnowledge.medicineClassification.classification [0..*]: CodeableConcept Specific category assigned to the medication
• MedicationKnowledge.packaging [0..*]: BackboneElement Details about packaged medications
• MedicationKnowledge.packaging.cost [0..*]: - Cost of the packaged medication
• MedicationKnowledge.packaging.packagedProduct [0..1]: Reference(PackagedProductDefinition) The packaged medication that is being priced
• MedicationKnowledge.clinicalUseIssue [0..*]: Reference(ClinicalUseDefinition) Potential clinical issue with or between medication(s)
• MedicationKnowledge.storageGuideline [0..*]: BackboneElement How the medication should be stored
• MedicationKnowledge.storageGuideline.reference [0..1]: uri Reference to additional information
• MedicationKnowledge.storageGuideline.note [0..*]: Annotation Additional storage notes
• MedicationKnowledge.storageGuideline.stabilityDuration [0..1]: Duration Duration remains stable
• MedicationKnowledge.storageGuideline.environmentalSetting [0..*]: BackboneElement Setting or value of environment for adequate storage
• MedicationKnowledge.storageGuideline.environmentalSetting.type [1..1]: CodeableConcept Categorization of the setting
• MedicationKnowledge.storageGuideline.environmentalSetting.value[x] [1..1]: Quantity, Range, CodeableConcept Value of the setting
• MedicationKnowledge.regulatory [0..*]: BackboneElement Regulatory information about a medication
• MedicationKnowledge.regulatory.regulatoryAuthority [1..1]: Reference(Organization) Specifies the authority of the regulation
• MedicationKnowledge.regulatory.substitution [0..*]: BackboneElement Specifies if changes are allowed when dispensing a medication from a regulatory perspective
• MedicationKnowledge.regulatory.substitution.type [1..1]: CodeableConcept Specifies the type of substitution allowed
• MedicationKnowledge.regulatory.substitution.allowed [1..1]: boolean Specifies if regulation allows for changes in the medication when dispensing
• MedicationKnowledge.regulatory.schedule [0..*]: CodeableConcept Specifies the schedule of a medication in jurisdiction
• MedicationKnowledge.regulatory.maxDispense [0..1]: BackboneElement The maximum number of units of the medication that can be dispensed in a period
• MedicationKnowledge.regulatory.maxDispense.quantity [1..1]: Quantity(SimpleQuantity) The maximum number of units of the medication that can be dispensed
• MedicationKnowledge.regulatory.maxDispense.period [0..1]: Duration The period that applies to the maximum number of units
• MedicationKnowledge.definitional [0..1]: BackboneElement Minimal definition information about the medication
• MedicationKnowledge.definitional.definition [0..*]: Reference(MedicinalProductDefinition) Definitional resources that provide more information about this medication
• MedicationKnowledge.definitional.doseForm [0..1]: CodeableConcept example:medication-form-codes powder | tablets | capsule +
• MedicationKnowledge.definitional.intendedRoute [0..*]: CodeableConcept example:route-codes The intended or approved route of administration
• MedicationKnowledge.definitional.ingredient [0..*]: BackboneElement Active or inactive ingredient
• MedicationKnowledge.definitional.ingredient.item [1..1]: CodeableReference Substances contained in the medication
• MedicationKnowledge.definitional.ingredient.type [0..1]: CodeableConcept example:v3-RoleClassIngredientEntity A code that defines the type of ingredient, active, base, etc
• MedicationKnowledge.definitional.ingredient.strength[x] [0..1]: Ratio, CodeableConcept, Quantity example:medication-ingredientstrength Quantity of ingredient present
• MedicationKnowledge.definitional.drugCharacteristic [0..*]: BackboneElement Specifies descriptive properties of the medicine
• MedicationKnowledge.definitional.drugCharacteristic.type [0..1]: CodeableConcept example:medicationknowledge-characteristic Code specifying the type of characteristic of medication
• MedicationKnowledge.definitional.drugCharacteristic.value[x] [0..1]: CodeableConcept, string, Quantity(SimpleQuantity), base64Binary, Attachment Description of the characteristic

Mappings

• MedicationKnowledge Mappings — 8 mapping entries

Resource Packs

list-MedicationKnowledge-packs.xml

<?xml version="1.0" encoding="UTF-8"?>

<List xmlns="http://hl7.org/fhir">
  <id value="MedicationKnowledge-packs"/>
  <status value="current"/>
  <mode value="working"/>
</List>

Search Parameters

• 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
• 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
• 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 — MedicationKnowledge.packaging.cost.cost as Money
• packaging-cost-concept — token — The cost of the packaged medication, if the cost is a CodeableConcept — MedicationKnowledge.packaging.cost.cost as 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

Full Search Parameters

Examples

• example — medicationknowledge-example — Example of medicationknowledge
• medicationknowledge-example — medicationknowledge-example
• medicationknowledge-examples-header — medicationknowledge-examples-header

Full Examples

Mapping Exceptions

medicationknowledge-fivews-mapping-exceptions.xml

Unmapped Elements

• FiveWs.what — Unknown
• FiveWs.recorded — Unknown
• FiveWs.author — Unknown
• FiveWs.cause — Unknown
• FiveWs.version — Unknown
• FiveWs.witness — Unknown
• FiveWs.where — Unknown
• FiveWs.context — Unknown
• FiveWs.init — Unknown
• FiveWs.why — Unknown
• FiveWs.identifier — Unknown
• FiveWs.source — Unknown
• FiveWs.who — Unknown
• FiveWs.grade — Unknown
• FiveWs.status — Unknown
• FiveWs.planned — Unknown
• FiveWs.done — Unknown
• FiveWs.subject — Unknown