Important: This is a draft IG for trial use. Click here to give feedback.

EN NL FR

HdBe-MedicatieToediening2

CBBConceptStatus
HdBe-MedicationAdministration2

Medicatietoediening is de registratie van de afzonderlijke toedieningen van het geneesmiddel aan de patiënt door de toediener (zoals een verpleegkundige of patiënt zelf), in relatie tot de gemaakte afspraken.

Purpose

Het doel van medicatietoediening is inzicht te geven in de daadwerkelijk toegediende producten.

active

id0..1string
extensionI0..*Extension
AdministrationProductI1..1Reference(HdBe-PharmaceuticalProduct)
AdministeringSpeed0..1HdBe-Range
AdministrationDateTime1..1dateTime
AgreedDateTime0..1dateTime
AdministeredAmountI0..1Quantity
DeviatingAdministration0..1boolean
RouteOfAdministration1..1CodeableConceptBinding
DoubleCheckPerformed0..1boolean
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
MedicationAgreementI0..1Reference(HdBe-MedicationAgreement)
AdministrationAgreementI0..1Reference(HdBe-AdministrationAgreement)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
PatientI0..1Reference(HdBe-Patient)
HealthProfessionalI0..1Reference(HdBe-HealthProfessional)
CaregiverI0..1Reference(HdBe-ContactPerson)
MedicationAdministrationReasonForDeviation0..1CodeableConceptBinding
MedicationAdministrationStatus1..1CodeableConceptBinding
Comment0..1string

MedicationAdministration20..*
MedicationAdministration2.AdministrationProductReference(HdBe-PharmaceuticalProduct)1..1
MedicationAdministration2.AdministeringSpeedHdBe-Range0..1
MedicationAdministration2.AdministrationDateTimedateTime1..1
MedicationAdministration2.AgreedDateTimedateTime0..1
MedicationAdministration2.AdministeredAmountQuantity0..1
MedicationAdministration2.DeviatingAdministrationboolean0..1
MedicationAdministration2.RouteOfAdministrationCodeableConcept1..1
MedicationAdministration2.DoubleCheckPerformedboolean0..1
MedicationAdministration2.RelatedAgreementBackboneElement0..1
MedicationAdministration2.RelatedAgreement.MedicationAgreementReference(HdBe-MedicationAgreement)0..1
MedicationAdministration2.RelatedAgreement.AdministrationAgreementReference(HdBe-AdministrationAgreement)0..1
MedicationAdministration2.AdministratorBackboneElement0..1
MedicationAdministration2.Administrator.PatientReference(HdBe-Patient)0..1
MedicationAdministration2.Administrator.HealthProfessionalReference(HdBe-HealthProfessional)0..1
MedicationAdministration2.Administrator.CaregiverReference(HdBe-ContactPerson)0..1
MedicationAdministration2.MedicationAdministrationReasonForDeviationCodeableConcept0..1
MedicationAdministration2.MedicationAdministrationStatusCodeableConcept1..1
MedicationAdministration2.Commentstring0..1


MedicationAdministration2
DefinitionRoot concept of the MedicationAdministration2 information model. This root concept contains all data elements of the MedicationAdministration2 information model.
Cardinality0...*
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • rim: n/a
MedicationAdministration2.id
DefinitionUnique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality0...1
Typestring
Mappings
  • rim: n/a
MedicationAdministration2.extension
DefinitionMay be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Cardinality0...*
TypeExtension
Aliasextensions, user content
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

SlicingUnordered, Open, by url(Value)
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ext-1: Must have either extensions or value[x], not both
    extension.exists() != value.exists()
Mappings
  • rim: n/a
  • rim: N/A
MedicationAdministration2.AdministrationProduct
DefinitionThe product taken or administered. This is usually medication. Food, blood products, aids and bandages do not strictly fall under the category of medication, but can be reported as well. In principle, this will be the prescribed product, but the administrator may substitute it by replacing the product with an equivalent product. For example: two 50mg tablets can be administered instead of one 100mg tablet.
Cardinality1...1
TypeReference(HdBe-PharmaceuticalProduct)
Comments

References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc.). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ref-1: SHALL have a contained resource if a local reference is provided
    reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))
Mappings
  • rim: n/a
  • rim: The target of a resource reference is a RIM entry point (Act, Role, or Entity)
MedicationAdministration2.AdministeringSpeed
DefinitionThe administering speed is used in slow administration of liquid. In practice, the measuring unit is almost always ml/hour. Entering an interval (such as 0-10 ml/hour) is also a commonly used option. For example, with an administering speed of 10ml/hour: * amount = 10, * dose unit = ml * time unit = hour
Cardinality0...1
TypeHdBe-Range
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • rim: n/a
MedicationAdministration2.AdministrationDateTime
DefinitionThe date and time at which the medication was administered.
Cardinality1...1
TypedateTime
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • rim: n/a
MedicationAdministration2.AgreedDateTime
DefinitionDate and time in the medication or administration agreement to which this administration pertains. Since multiple times can be indicated in one medication/administration agreement, this can be used to identify the agreed time in the event of e.g. early administration or a late administration.
Cardinality0...1
TypedateTime
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • rim: n/a
MedicationAdministration2.AdministeredAmount
DefinitionAmount of the administered product.
Cardinality0...1
TypeQuantity
Comments

The context of use may frequently define what kind of quantity this is and therefore what kind of units can be used. The context of use may also restrict the values for the comparator.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • qty-3: If a code for the unit is present, the system SHALL also be present
    code.empty() or system.exists()
Mappings
  • rim: n/a
  • v2: SN (see also Range) or CQ
  • rim: PQ, IVL<PQ>, MO, CO, depending on the values
MedicationAdministration2.DeviatingAdministration
DefinitionIn the administration, was there a deviation from the medication or administration agreement? This can be a deviation in product, time, amount, route of administration or administering speed or foregoing administration altogether.
Cardinality0...1
Typeboolean
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • rim: n/a
MedicationAdministration2.RouteOfAdministration
DefinitionThe route through which the medication is administered (oral, nasal, intravenous,...).
Cardinality1...1
TypeCodeableConcept
Binding

RouteOfAdministration codes

RouteOfMedicationAdministration (required)
Comments

Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • rim: n/a
  • v2: CE/CNE/CWE
  • rim: CD
  • orim: fhir:CodeableConcept rdfs:subClassOf dt:CD
MedicationAdministration2.DoubleCheckPerformed
DefinitionWas a double check performed prior to the administration? This is only legally required for certain medication.
Cardinality0...1
Typeboolean
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • rim: n/a
MedicationAdministration2.RelatedAgreement
DefinitionMedication or administration agreement on which this administration is based.
Cardinality0...1
TypeBackboneElement
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • HdBe-MedicationAdministration2-1: Either medication_agreement or administration_agreement may exists.
    medication_agreement.exists() xor administration_agreement.exists()
Mappings
  • rim: n/a
MedicationAdministration2.RelatedAgreement.id
DefinitionUnique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality0...1
Typestring
Mappings
  • rim: n/a
MedicationAdministration2.RelatedAgreement.extension
DefinitionMay be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Cardinality0...*
TypeExtension
Aliasextensions, user content
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

SlicingUnordered, Open, by url(Value)
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ext-1: Must have either extensions or value[x], not both
    extension.exists() != value.exists()
Mappings
  • rim: n/a
  • rim: N/A
MedicationAdministration2.RelatedAgreement.modifierExtension
DefinitionMay be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).
Cardinality0...*
TypeExtension
ModifierTrue
SummaryTrue
Aliasextensions, user content, modifiers
Requirements

Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ext-1: Must have either extensions or value[x], not both
    extension.exists() != value.exists()
Mappings
  • rim: n/a
  • rim: N/A
MedicationAdministration2.RelatedAgreement.MedicationAgreement
DefinitionMedication agreement on which this administration is based.
Cardinality0...1
TypeReference(HdBe-MedicationAgreement)
Comments

References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc.). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ref-1: SHALL have a contained resource if a local reference is provided
    reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))
Mappings
  • rim: n/a
  • rim: The target of a resource reference is a RIM entry point (Act, Role, or Entity)
MedicationAdministration2.RelatedAgreement.AdministrationAgreement
DefinitionAdministration agreement on which this administration is based.
Cardinality0...1
TypeReference(HdBe-AdministrationAgreement)
Comments

References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc.). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ref-1: SHALL have a contained resource if a local reference is provided
    reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))
Mappings
  • rim: n/a
  • rim: The target of a resource reference is a RIM entry point (Act, Role, or Entity)
MedicationAdministration2.Administrator
DefinitionContainer of the Administrator concept. This container contains all data elements of the Administrator concept. The concept describes the person who administered the product. This is a professional authorised administrator, the patient themselves or the caregiver, for example.
Cardinality0...1
TypeBackboneElement
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • HdBe-MedicationAdministration2-2: Either patient, health_professional or caregiver may exists.
    patient.exists() xor health_professional.exists() xor caregiver.exists()
Mappings
  • rim: n/a
MedicationAdministration2.Administrator.id
DefinitionUnique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality0...1
Typestring
Mappings
  • rim: n/a
MedicationAdministration2.Administrator.extension
DefinitionMay be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Cardinality0...*
TypeExtension
Aliasextensions, user content
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

SlicingUnordered, Open, by url(Value)
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ext-1: Must have either extensions or value[x], not both
    extension.exists() != value.exists()
Mappings
  • rim: n/a
  • rim: N/A
MedicationAdministration2.Administrator.modifierExtension
DefinitionMay be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).
Cardinality0...*
TypeExtension
ModifierTrue
SummaryTrue
Aliasextensions, user content, modifiers
Requirements

Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ext-1: Must have either extensions or value[x], not both
    extension.exists() != value.exists()
Mappings
  • rim: n/a
  • rim: N/A
MedicationAdministration2.Administrator.Patient
DefinitionIf the patient administered the medication themselves, indicate that here. If the medication is administered by a health professional or caregiver/family member/etc., the health professional is entered in the ‘Healthcare professional’ element or the caregiver/family member/etc. is entered in the ‘Caregiver’ element respectively.
Cardinality0...1
TypeReference(HdBe-Patient)
Comments

References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc.). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ref-1: SHALL have a contained resource if a local reference is provided
    reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))
Mappings
  • rim: n/a
  • rim: The target of a resource reference is a RIM entry point (Act, Role, or Entity)
MedicationAdministration2.Administrator.HealthProfessional
DefinitionThe concept describes the person who administered the product. This is a professional authorised administrator.
Cardinality0...1
TypeReference(HdBe-HealthProfessional)
Comments

References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc.). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ref-1: SHALL have a contained resource if a local reference is provided
    reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))
Mappings
  • rim: n/a
  • rim: The target of a resource reference is a RIM entry point (Act, Role, or Entity)
MedicationAdministration2.Administrator.Caregiver
DefinitionInformation on the patient’s personal relative or contact that administered the medication.
Cardinality0...1
TypeReference(HdBe-ContactPerson)
Comments

References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc.). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
  • ref-1: SHALL have a contained resource if a local reference is provided
    reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))
Mappings
  • rim: n/a
  • rim: The target of a resource reference is a RIM entry point (Act, Role, or Entity)
MedicationAdministration2.MedicationAdministrationReasonForDeviation
DefinitionReason why the medication was not taken or administered or was taken or administered differently. Here, you can choose to enter text or one of the codes.
Cardinality0...1
TypeCodeableConcept
Binding

MedicationAdministrationReasonForDeviation codes

MedicationAdministrationReasonForDeviation (required)
Comments

Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • rim: n/a
  • v2: CE/CNE/CWE
  • rim: CD
  • orim: fhir:CodeableConcept rdfs:subClassOf dt:CD
MedicationAdministration2.MedicationAdministrationStatus
DefinitionThe status of the administration, as a description of the stage within the administering process. Only the status codes ‘completed’ and ‘canceled’ apply to indivisible products (such as tablets or suppositories). For divisible products (such as infusions), doses can also be ‘suspended’ or ‘aborted’. When documenting this, the following interpretations are used: * Active: The product is administered. * Suspended: Use has (temporarily) been interrupted, because of a side effect, for example. Later, the patient and/or doctor can decide whether or not to resume or discontinue use. * Aborted: Administration has stopped. * Completed: Administration has been completed. * Canceled: The product was never administered.
Cardinality1...1
TypeCodeableConcept
Binding

MedicationAdministrationStatus codes

MedicationAdministrationStatus (required)
Comments

Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination.

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • rim: n/a
  • v2: CE/CNE/CWE
  • rim: CD
  • orim: fhir:CodeableConcept rdfs:subClassOf dt:CD
MedicationAdministration2.Comment
DefinitionComments on administering the medication.
Cardinality0...1
Typestring
Comments

Note that FHIR strings SHALL NOT exceed 1MB in size

Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • rim: n/a

Example instances

MedicationAdministration2
AdministrationProduct Reference to PharmaceuticalProduct (Acetaminophen 500 mg oral tablet)
AdministeringSpeed
AdministrationDateTime 2022-06-03 16:19:07
AgreedDateTime
AdministeredAmount 1 tablet
DeviatingAdministration false
RouteOfAdministration 26643006 - Oral route (code by SNOMED CT)
DoubleCheckPerformed false
RelatedAgreement --
RelatedAgreement.MedicationAgreement
RelatedAgreement.AdministrationAgreement
Administrator --
Administrator.Patient Reference to Patient (Belle Ulijn)
Administrator.HealthProfessional
Administrator.Caregiver
`MedicationAdministrationReasonForDeviation
MedicationAdministrationStatus MS0002 - Completed (code by Healthdate.Be (Sciensano))
Comment

zib MedicationAdministration2-v1.1.1 difference

Concept Category Description
MedicationAdministration2 (root) naming Renamed the root concept name MedicationAdministration to MedicationAdministration2 to align with the sdf-8 constraint. (zib ticket #1875)
AdministeringSpeed type Replaced type BackboneElement with Range type and added HdBe-Range partial CBB.
AdministeringSpeed element Removed elements minimumValue, maximumValue and nominalValue as they are defined within the CBB HdBe-Range.
AdministeringSpeed textual Removed context regarding the Dutch NHG table.
RouteOfAdministration terminology Replaced Gstandaard codes with SNOMED hierarchy containing descendents of 284009009 (Route of administration value) (zib ticket #1781) and renamed it to RouteOfMedicationAdministration to reuse the ValueSet both here and in InstructionsForUse.
MedicationAdministrationReasonForDeviation terminology Replaced NL-CM-CS or ActReason codes with SNOMED codes as found in the 2022 CodeList. Also added SNOMED codes for Unknown and Other. SNOMED NL codes are replaced with custom codes as defined in the CodeSystem MedicationAdministrationReasonForDeviation.
MedicationAdministrationStatus terminology Replaced ActStatus codes of the MedicationAdministrationStatus ValueSet with SNOMED codes where applicable and added custom codes for codes not found in SNOMED, such as: Aborted and Completed.
MedicationAdministrationStatus textual Aligned description of the values with the used valueSet.
RelatedAgreement constraint Added an invariant (id = HdBe-MedicationAdministration2-1 ) to indicate only one relatedAgreement is expected.
Administrator constraint Added an invariant (HdBe-MedicationAdministration2-2) to indicate only one administrator is expected.



Terminology Bindings

PathNameStrengthURL
RouteOfAdministrationRouteOfMedicationAdministrationrequiredhttps://fhir.healthdata.be/ValueSet/RouteOfMedicationAdministration
MedicationAdministrationReasonForDeviationMedicationAdministrationReasonForDeviationrequiredhttps://fhir.healthdata.be/ValueSet/MedicationAdministrationReasonForDeviation
MedicationAdministrationStatusMedicationAdministrationStatusrequiredhttps://fhir.healthdata.be/ValueSet/MedicationAdministrationStatus