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

EN NL FR

HdBe-Medicatieafspraak

CBBConceptStatus
HdBe-MedicationAgreement

Een medicatieafspraak is het voorstel van een voorschrijver tot gebruik van medicatie door een patiënt. Ook de afspraak om het medicatiegebruik te staken is een medicatieafspraak. 

Purpose

Het doel van de medicatieafspraak is inzicht te geven in de afspraken die zijn gemaakt tussen voorschrijver en patiënt over het gebruik van medicatie.

Instructions

MedicatieafspraakAanvullendeInformatie: Bij het kiezen van een geneesmiddel kan er worden afgeweken van wat er verwacht wordt of van wat de standaard is. Bijvoorbeeld wanneer het ziekenhuis een ander formularium hanteert dan de openbare apotheek. Uit efficiencyoverwegingen is in het ziekenhuis bijvoorbeeld gekozen voor één maagzuurremmer: pantoprazol. Bij opname wordt een patiënt met omeprazol omgezet naar pantoprazol voor de duur van het verblijf. Bij ontslag gaat de patiënt weer terug naar omeprazol. Het is duidelijk dat hier nog weleens wat mis kan gaan en dat de patiënt zowel omeprazol als pantoprazol slikt als er niet ingegrepen wordt. In de medicatieafspraak van het ziekenhuis voor pantoprazol kan een opmerking worden gemaakt over de afwijking zodat duidelijk is dat pantoprazol de vervanger is van omeprazol of juist naast omeprazol moet worden gebruikt. Ander voorbeeld zijn de halve sterktes. Het ziekenhuis heeft soms de beschikking over tabletten met de halve sterkte van het normale handelspreparaat (eigen productie). Waar de patiënt het ziekenhuis ingaat met chlortalidon 25 mg, een maal daags een halve tablet krijgt hij intramuraal chlortalidon 12,5 mg, eenmaal daags één tablet. Dan hoeft de verpleging in dit geval geen tabletten te breken. Hier bestaat het risico dat de patiënt bij thuiskomst weer de 25 mg gaat gebruiken, maar dan een hele tablet per keer. Door een toelichting in de medicatieafspraak (Aanvullende informatie) van de laatste chlortalidon 25 mg kan worden aangegeven of dit een bewuste verhoging is geweest.

active

id0..1string
extensionI0..*Extension
PrescriberI0..1Reference(HdBe-HealthProfessional)
PrescriptionReasonI0..1Reference(HdBe-Problem)
AgreedMedicineI1..1Reference(HdBe-PharmaceuticalProduct)
InstructionsForUse0..1HdBe-InstructionsForUse
MedicationAgreementDateTime1..1dateTime
PeriodOfUse0..1HdBe-TimeInterval
MedicationAgreementStopType0..1CodeableConceptBinding
ReasonMedicationAgreement0..1CodeableConceptBinding
MedicationAgreementAdditionalInformation0..*CodeableConceptBinding
Comment0..1string

MedicationAgreement0..*
MedicationAgreement.PrescriberReference(HdBe-HealthProfessional)0..1
MedicationAgreement.PrescriptionReasonReference(HdBe-Problem)0..1
MedicationAgreement.AgreedMedicineReference(HdBe-PharmaceuticalProduct)1..1
MedicationAgreement.InstructionsForUseHdBe-InstructionsForUse0..1
MedicationAgreement.MedicationAgreementDateTimedateTime1..1
MedicationAgreement.PeriodOfUseHdBe-TimeInterval0..1
MedicationAgreement.MedicationAgreementStopTypeCodeableConcept0..1
MedicationAgreement.ReasonMedicationAgreementCodeableConcept0..1
MedicationAgreement.MedicationAgreementAdditionalInformationCodeableConcept0..*
MedicationAgreement.Commentstring0..1


MedicationAgreement
DefinitionRoot concept of the MedicationAgreement information model. This root concept contains all data elements of the MedicationAgreement 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
MedicationAgreement.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
MedicationAgreement.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
MedicationAgreement.Prescriber
DefinitionThe health professional that entered the medication agreement with the patient.
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)
MedicationAgreement.PrescriptionReason
DefinitionThe medical reason for the prescription or for use of the medication. This can be used to enter a medical indication which was the direct cause for prescription or for use of the medication in question. It can concern every type of problem (or condition) of the patient, almost all diagnoses, complaints or symptoms.
Cardinality0...1
TypeReference(HdBe-Problem)
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)
MedicationAgreement.AgreedMedicine
DefinitionThe medicine agreed upon to be used.
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)
MedicationAgreement.InstructionsForUse
DefinitionInstructions for the use of the medication, e.g. dose and route of administration.
Cardinality0...1
TypeHdBe-InstructionsForUse
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • rim: n/a
MedicationAgreement.MedicationAgreementDateTime
DefinitionThe time at which the agreement was made. Appointment date + time are required (order of the appointments must be clear in cases with multiple appointments on one day)
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
MedicationAgreement.PeriodOfUse
DefinitionStart date: This is the time at which the agreement was to take effect (or took effect or will take effect). This is the time at which the instructions for use in this agreement start. In the case of an agreement to discontinue use, this is the start date of the original medication agreement. The end date indicates from when the medication is to be discontinued. **Duration:** The intended duration of use. E.g. 5 days or 8 weeks. It is not allowed to indicate the duration in months, because different months have a variable duration in days. **End date:** The time at which the period of use ends (or ended or will end). In the case of an agreement to discontinue use, this is the time at which the medication is to be discontinued. To avoid confusion between 'to' and 'up to', the submission of time is always mandatory for the end date. With medication for an indefinite period only a start date is indicated.
Cardinality0...1
TypeHdBe-TimeInterval
Invariants
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Mappings
  • rim: n/a
MedicationAgreement.MedicationAgreementStopType
DefinitionStop type, the manner in which this medication is discontinued (temporary or definitive).
Cardinality0...1
TypeCodeableConcept
Binding

MedicationAgreementStopType codes

MedicationStopType (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
MedicationAgreement.ReasonMedicationAgreement
DefinitionReason for this agreement. This can be the reason to start, change or stop the medication treatment.
Cardinality0...1
TypeCodeableConcept
Binding

ReasonMedicationAgreement codes

MedicationReason (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
MedicationAgreement.MedicationAgreementAdditionalInformation
DefinitionAdditional information includes details on the structure of the agreement made that are relevant for pharmacovigilance and fulfillment by the pharmacist. This can be used e.g. to indicate that there was a conscious decision to deviate from the norm or that the agreement is to be structured in a certain way. See also the Instructions section for more information about use of the element.
Cardinality0...*
TypeCodeableConcept
Binding

MedicationAgreementAdditionalInformation codes

MedicationAgreementAdditionalInformation (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
MedicationAgreement.Comment
DefinitionComments regarding to the medication agreement. For example: in consultation with the medical specialist.
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

MedicationAgreement
Prescriber Reference to HealthProfessional (E. Penninx)
PrescriptionReason Reference to Problem (Listeriosis)
AgreedMedicine Reference to PharmaceuticalProduct (Acetaminophen 500 mg)
InstructionsForUse Reference to InstructionsForUse (Vanaf 6 maart 2016 1x per week op maandag in de middag 500 mg)
MedicationAgreementDateTime 2016-03-04 15:52:30
PeriodOfUse Reference to TimeInterval (start: 2016-03-06 )
MedicationAgreementStopType
ReasonMedicationAgreement 266709005 - Medication commenced (code by SNOMED CT)
MedicationAgreementAdditionalInformation
Comment

zib MedicationAgreement-v1.2 difference

Concept Category Description
PrescriberReason textual Removed context regarding the Dutch G-standard.
MedicationAgreementStopType terminology Renamed ValueSet from MedicationAgreementStopType to MedicationStopType, to be able to reuse it at MedicationUse and AdministrationAgreement. Also replaced Dutch SNOMED-CT codes with international codes in ValueSet MedicationStopType.
ReasonMedicationAgreement terminology Renamed ValueSet from MedicationAgreementReason to MedicationReason, to be able to reuse it at MedicationUse2. Replaced several values in ValueSet. 1. Added SNOMED-CT code for Unknown and Other. 2. Added CodeSystem MedicationReason which replaces all Dutch SNOMED-CT codes. 3. Removed all Dutch SNOMED-CT codes from valueset.
MedicationAgreementAdditionalInformation terminology Replaced several values in MedicationAgreementAdditionalInformation valueSet. 1. Replaced OTH with SNOMED-CT code for Other. 2. Added SNOMED-CT code for Unknown. 3. Added CodeSystem MedicationAgreementAdditionalInformation which replaces all Dutch SNOMED-CT codes. 4. Removed all Dutch SNOMED-CT codes from valueset.
description.Instructions textual Replaced 'a intended increase' with 'an intended increase'.



Terminology Bindings

PathNameStrengthURL
MedicationAgreementStopTypeMedicationStopTyperequiredhttps://fhir.healthdata.be/ValueSet/MedicationStopType
ReasonMedicationAgreementMedicationReasonrequiredhttps://fhir.healthdata.be/ValueSet/MedicationReason
MedicationAgreementAdditionalInformationMedicationAgreementAdditionalInformationrequiredhttps://fhir.healthdata.be/ValueSet/MedicationAgreementAdditionalInformation