International Patient Summary Implementation Guide
2.0.0-ballot - STU 2 Ballot International flag

International Patient Summary Implementation Guide, published by HL7 International / Patient Care. This guide is not an authorized publication; it is the continuous build for version 2.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/ritikarawlani/fhir-ips/ and changes regularly. See the Directory of published versions

Resource Profile: Medication (IPS)

Official URL: http://hl7.org/fhir/uv/ips/StructureDefinition/Medication-uv-ips Version: 2.0.0-ballot
Standards status: Trial-use Maturity Level: 2 Computable Name: MedicationIPS

This profile represents the constraints applied to the Medication resource by the International Patient Summary (IPS) FHIR Implementation Guide, based on FHIR R4. A medication is described in the patient summary as an instance of a Medication resource constrained by this profile.

This profile constrains the representation of a medication, in the context of the international patient summary as specified by the IPS project of HL7 International.

Usage:

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

This structure is derived from Medication

NameFlagsCard.TypeDescription & Constraintsdoco
.. Medication 0..* Medication Definition of a Medication
... code S 1..1 CodeableConceptIPS Medication that was administered or was to be administered (medication code from any code system)
Binding: Medications - IPS (preferred): SNOMED CT medications (Medicinal product) or a code for absent/unknown medication

Additional BindingsPurpose
WHO ATC - IPS candidate
... form S 0..1 CodeableConceptIPS Concept - reference to a terminology or just text
Binding: Medicine Doseform - IPS (preferred)
... ingredient S 0..* BackboneElement Active or inactive ingredient
.... item[x] S 1..1 The actual ingredient or content
Binding: Medicine Active Substances - IPS (preferred): SNOMED CT drug substances

..... itemCodeableConcept CodeableConcept(CodeableConceptIPS)
..... itemReference Reference(Substance | Medication)
.... strength S 0..1 RatioIPS A ratio of two Quantity values - a numerator and a denominator

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSetURI
Medication.codepreferredMedicationsUvIps
Additional Bindings Purpose Documentation
WHO ATC - IPS candidate

WHO ATC classification

http://hl7.org/fhir/uv/ips/ValueSet/medication-uv-ips
from this IG
Medication.formpreferredMedicineDoseFormUvIps
http://hl7.org/fhir/uv/ips/ValueSet/medicine-doseform
from this IG
Medication.ingredient.item[x]preferredMedicineActiveSubstancesUvIps
http://hl7.org/fhir/uv/ips/ValueSet/medicine-active-substances-uv-ips
from this IG
NameFlagsCard.TypeDescription & Constraintsdoco
.. Medication 0..* Medication Definition of a Medication
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... code S 1..1 CodeableConceptIPS Medication that was administered or was to be administered (medication code from any code system)
Binding: Medications - IPS (preferred): SNOMED CT medications (Medicinal product) or a code for absent/unknown medication

Additional BindingsPurpose
WHO ATC - IPS candidate
... form S 0..1 CodeableConceptIPS Concept - reference to a terminology or just text
Binding: Medicine Doseform - IPS (preferred)
... ingredient S 0..* BackboneElement Active or inactive ingredient
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... item[x] S 1..1 The actual ingredient or content
Binding: Medicine Active Substances - IPS (preferred): SNOMED CT drug substances

..... itemCodeableConcept CodeableConcept(CodeableConceptIPS)
..... itemReference Reference(Substance | Medication)
.... strength SC 0..1 RatioIPS A ratio of two Quantity values - a numerator and a denominator
rat-1: Numerator and denominator SHALL both be present, or both are absent. If both are absent, there SHALL be some extension present

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
Medication.codepreferredMedicationsUvIps
Additional Bindings Purpose Documentation
WHO ATC - IPS candidate

WHO ATC classification

http://hl7.org/fhir/uv/ips/ValueSet/medication-uv-ips
from this IG
Medication.statusrequiredMedication Status Codes
http://hl7.org/fhir/ValueSet/medication-status|4.0.1
from the FHIR Standard
Medication.formpreferredMedicineDoseFormUvIps
http://hl7.org/fhir/uv/ips/ValueSet/medicine-doseform
from this IG
Medication.ingredient.item[x]preferredMedicineActiveSubstancesUvIps
http://hl7.org/fhir/uv/ips/ValueSet/medicine-active-substances-uv-ips
from this IG

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorMedicationIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorMedicationIf the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
: contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4errorMedicationIf a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
: contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5errorMedicationIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceMedicationA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()
rat-1errorMedication.ingredient.strengthNumerator and denominator SHALL both be present, or both are absent. If both are absent, there SHALL be some extension present
: (numerator.empty() xor denominator.exists()) and (numerator.exists() or extension.exists())
NameFlagsCard.TypeDescription & Constraintsdoco
.. Medication 0..* Medication Definition of a Medication
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... text 0..1 Narrative Text summary of the resource, for human interpretation
... contained 0..* Resource Contained, inline Resources
... extension 0..* Extension Additional content defined by implementations
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier Σ 0..* Identifier Business identifier for this medication
... code S 1..1 CodeableConceptIPS Medication that was administered or was to be administered (medication code from any code system)
Binding: Medications - IPS (preferred): SNOMED CT medications (Medicinal product) or a code for absent/unknown medication

Additional BindingsPurpose
WHO ATC - IPS candidate
... status ?!Σ 0..1 code active | inactive | entered-in-error
Binding: Medication Status Codes (required): A coded concept defining if the medication is in active use.

... manufacturer Σ 0..1 Reference(Organization) Manufacturer of the item
... form S 0..1 CodeableConceptIPS Concept - reference to a terminology or just text
Binding: Medicine Doseform - IPS (preferred)
... amount Σ 0..1 Ratio Amount of drug in package
... ingredient S 0..* BackboneElement Active or inactive ingredient
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... item[x] S 1..1 The actual ingredient or content
Binding: Medicine Active Substances - IPS (preferred): SNOMED CT drug substances

..... itemCodeableConcept CodeableConcept(CodeableConceptIPS)
..... itemReference Reference(Substance | Medication)
.... isActive 0..1 boolean Active ingredient indicator
.... strength SC 0..1 RatioIPS A ratio of two Quantity values - a numerator and a denominator
rat-1: Numerator and denominator SHALL both be present, or both are absent. If both are absent, there SHALL be some extension present
... batch 0..1 BackboneElement Details about packaged medications
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... lotNumber 0..1 string Identifier assigned to batch
.... expirationDate 0..1 dateTime When batch will expire

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
Medication.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
http://hl7.org/fhir/ValueSet/languages
from the FHIR Standard
Medication.codepreferredMedicationsUvIps
Additional Bindings Purpose Documentation
WHO ATC - IPS candidate

WHO ATC classification

http://hl7.org/fhir/uv/ips/ValueSet/medication-uv-ips
from this IG
Medication.statusrequiredMedication Status Codes
http://hl7.org/fhir/ValueSet/medication-status|4.0.1
from the FHIR Standard
Medication.formpreferredMedicineDoseFormUvIps
http://hl7.org/fhir/uv/ips/ValueSet/medicine-doseform
from this IG
Medication.ingredient.item[x]preferredMedicineActiveSubstancesUvIps
http://hl7.org/fhir/uv/ips/ValueSet/medicine-active-substances-uv-ips
from this IG

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorMedicationIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorMedicationIf the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
: contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4errorMedicationIf a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
: contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5errorMedicationIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceMedicationA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()
rat-1errorMedication.ingredient.strengthNumerator and denominator SHALL both be present, or both are absent. If both are absent, there SHALL be some extension present
: (numerator.empty() xor denominator.exists()) and (numerator.exists() or extension.exists())

This structure is derived from Medication

Summary

Mandatory: 1 element
Must-Support: 5 elements

Structures

This structure refers to these other structures:

Maturity: 2

Differential View

This structure is derived from Medication

NameFlagsCard.TypeDescription & Constraintsdoco
.. Medication 0..* Medication Definition of a Medication
... code S 1..1 CodeableConceptIPS Medication that was administered or was to be administered (medication code from any code system)
Binding: Medications - IPS (preferred): SNOMED CT medications (Medicinal product) or a code for absent/unknown medication

Additional BindingsPurpose
WHO ATC - IPS candidate
... form S 0..1 CodeableConceptIPS Concept - reference to a terminology or just text
Binding: Medicine Doseform - IPS (preferred)
... ingredient S 0..* BackboneElement Active or inactive ingredient
.... item[x] S 1..1 The actual ingredient or content
Binding: Medicine Active Substances - IPS (preferred): SNOMED CT drug substances

..... itemCodeableConcept CodeableConcept(CodeableConceptIPS)
..... itemReference Reference(Substance | Medication)
.... strength S 0..1 RatioIPS A ratio of two Quantity values - a numerator and a denominator

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSetURI
Medication.codepreferredMedicationsUvIps
Additional Bindings Purpose Documentation
WHO ATC - IPS candidate

WHO ATC classification

http://hl7.org/fhir/uv/ips/ValueSet/medication-uv-ips
from this IG
Medication.formpreferredMedicineDoseFormUvIps
http://hl7.org/fhir/uv/ips/ValueSet/medicine-doseform
from this IG
Medication.ingredient.item[x]preferredMedicineActiveSubstancesUvIps
http://hl7.org/fhir/uv/ips/ValueSet/medicine-active-substances-uv-ips
from this IG

Key Elements View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Medication 0..* Medication Definition of a Medication
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... code S 1..1 CodeableConceptIPS Medication that was administered or was to be administered (medication code from any code system)
Binding: Medications - IPS (preferred): SNOMED CT medications (Medicinal product) or a code for absent/unknown medication

Additional BindingsPurpose
WHO ATC - IPS candidate
... form S 0..1 CodeableConceptIPS Concept - reference to a terminology or just text
Binding: Medicine Doseform - IPS (preferred)
... ingredient S 0..* BackboneElement Active or inactive ingredient
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... item[x] S 1..1 The actual ingredient or content
Binding: Medicine Active Substances - IPS (preferred): SNOMED CT drug substances

..... itemCodeableConcept CodeableConcept(CodeableConceptIPS)
..... itemReference Reference(Substance | Medication)
.... strength SC 0..1 RatioIPS A ratio of two Quantity values - a numerator and a denominator
rat-1: Numerator and denominator SHALL both be present, or both are absent. If both are absent, there SHALL be some extension present

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
Medication.codepreferredMedicationsUvIps
Additional Bindings Purpose Documentation
WHO ATC - IPS candidate

WHO ATC classification

http://hl7.org/fhir/uv/ips/ValueSet/medication-uv-ips
from this IG
Medication.statusrequiredMedication Status Codes
http://hl7.org/fhir/ValueSet/medication-status|4.0.1
from the FHIR Standard
Medication.formpreferredMedicineDoseFormUvIps
http://hl7.org/fhir/uv/ips/ValueSet/medicine-doseform
from this IG
Medication.ingredient.item[x]preferredMedicineActiveSubstancesUvIps
http://hl7.org/fhir/uv/ips/ValueSet/medicine-active-substances-uv-ips
from this IG

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorMedicationIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorMedicationIf the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
: contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4errorMedicationIf a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
: contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5errorMedicationIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceMedicationA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()
rat-1errorMedication.ingredient.strengthNumerator and denominator SHALL both be present, or both are absent. If both are absent, there SHALL be some extension present
: (numerator.empty() xor denominator.exists()) and (numerator.exists() or extension.exists())

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Medication 0..* Medication Definition of a Medication
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... text 0..1 Narrative Text summary of the resource, for human interpretation
... contained 0..* Resource Contained, inline Resources
... extension 0..* Extension Additional content defined by implementations
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier Σ 0..* Identifier Business identifier for this medication
... code S 1..1 CodeableConceptIPS Medication that was administered or was to be administered (medication code from any code system)
Binding: Medications - IPS (preferred): SNOMED CT medications (Medicinal product) or a code for absent/unknown medication

Additional BindingsPurpose
WHO ATC - IPS candidate
... status ?!Σ 0..1 code active | inactive | entered-in-error
Binding: Medication Status Codes (required): A coded concept defining if the medication is in active use.

... manufacturer Σ 0..1 Reference(Organization) Manufacturer of the item
... form S 0..1 CodeableConceptIPS Concept - reference to a terminology or just text
Binding: Medicine Doseform - IPS (preferred)
... amount Σ 0..1 Ratio Amount of drug in package
... ingredient S 0..* BackboneElement Active or inactive ingredient
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... item[x] S 1..1 The actual ingredient or content
Binding: Medicine Active Substances - IPS (preferred): SNOMED CT drug substances

..... itemCodeableConcept CodeableConcept(CodeableConceptIPS)
..... itemReference Reference(Substance | Medication)
.... isActive 0..1 boolean Active ingredient indicator
.... strength SC 0..1 RatioIPS A ratio of two Quantity values - a numerator and a denominator
rat-1: Numerator and denominator SHALL both be present, or both are absent. If both are absent, there SHALL be some extension present
... batch 0..1 BackboneElement Details about packaged medications
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... lotNumber 0..1 string Identifier assigned to batch
.... expirationDate 0..1 dateTime When batch will expire

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
Medication.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
http://hl7.org/fhir/ValueSet/languages
from the FHIR Standard
Medication.codepreferredMedicationsUvIps
Additional Bindings Purpose Documentation
WHO ATC - IPS candidate

WHO ATC classification

http://hl7.org/fhir/uv/ips/ValueSet/medication-uv-ips
from this IG
Medication.statusrequiredMedication Status Codes
http://hl7.org/fhir/ValueSet/medication-status|4.0.1
from the FHIR Standard
Medication.formpreferredMedicineDoseFormUvIps
http://hl7.org/fhir/uv/ips/ValueSet/medicine-doseform
from this IG
Medication.ingredient.item[x]preferredMedicineActiveSubstancesUvIps
http://hl7.org/fhir/uv/ips/ValueSet/medicine-active-substances-uv-ips
from this IG

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorMedicationIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorMedicationIf the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
: contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4errorMedicationIf a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
: contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5errorMedicationIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceMedicationA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()
rat-1errorMedication.ingredient.strengthNumerator and denominator SHALL both be present, or both are absent. If both are absent, there SHALL be some extension present
: (numerator.empty() xor denominator.exists()) and (numerator.exists() or extension.exists())

This structure is derived from Medication

Summary

Mandatory: 1 element
Must-Support: 5 elements

Structures

This structure refers to these other structures:

Maturity: 2

 

Other representations of profile: CSV, Excel, Schematron