Introduction
A medication scheme is a kmehrmessage that consists of
- 1 transaction MS,
- 0 or more transactions MSE and
- 0 or more transactions TS
The next paragrahs describe the kmehrmessage as used for Vitalink. Please refer to the Kmehr standard specification for the basic explanation, see External Links#kmehr_message-overview.
Kmehrmessage element <header>
Vitalink does not require more elements than the ones that are mandatory by the Kmehr standard.
When writing to Vitalink, all the elements are generated by the eHealth technical connector, based on the used properties.
Kmehrmessage element <folder>
Folder element <patient>
Element | Vitalink meaning Kmehr meaning: External Links#kmehr_patient | Kmehr | Vitalink |
---|---|---|---|
id | Mandatory | = | |
firstname | Mandatory | = | |
familyname | Mandatory | = | |
birthdate | Optional | = | |
birthlocation | Optional | = | |
deathdate | Optional | = | |
sex | Mandatory | = |
Vitalink does not require more elements than the ones that are mandatory by the Kmehr standard.
When writing to Vitalink, all the elements are generated by the eHealth technical connector, based on the patient information given by the application.
Folder element <transaction> "medicationscheme"
Folder element <transaction> "medicationschemeelement"
Kmehr transaction generic
Element | Vitalink meaning Kmehr meaning: External Links#kmehr_transaction | Kmehr | Vitalink |
---|---|---|---|
id | Mandatory | = | |
cd | Mandatory | = | |
date | Mandatory | = | |
time | Mandatory | = | |
author | Mandatory | = | |
iscomplete | Mandatory | = | |
isvalidated | Kmehr: Specifies if the transaction is validated. Vitalink: This element is not used, see Concept: Validation | Mandatory | = |
item | Optional | [1-*] |
Vitalink transaction MSE specific
Kmehr element <item>
Each Kmehr element <item> consists of the next elements:
Element | Vitalink meaning Kmehr meaning: External Links#kmehr_item | Kmehr | Vitalink |
---|---|---|---|
id | Vitalink: For Vitalink, this value has no extra meaning. | Mandatory | = |
cd | Kmehr: The type of the item. Vitalink: 1 item "medication" and 0 or more items "healthcareelement" | Mandatory | = |
Vitalink element <item> "medication"
The item medication has of the following additional elements:
Element | Description | Type | Vitalink |
---|---|---|---|
content | Mandatory | ||
temporality | Optional | ||
frequency | Optional | ||
beginmoment | Mandatory | ||
endmoment | Optional, not together with duration | ||
duration | Optional, not together with endmoment | ||
regimen | Optional, not together with posology | ||
posology | Optional, not together with regimen | ||
route | Optional | ||
instructionforpatient | Optional | ||
instructionforoverdose | Optional |
Vitalink element <item> "healthcareelement"
To include certain Vitalink specific information within the medication scheme data element, use must be made of separate item with value 'healthcareelement'.
In order to further define these healthcareelements, the list CD-ITEM-MS was created for Vitalink, with as permitted values:
healthcareelement | value of <content> |
---|---|
adaptationflag | Kmehr table CD-MS-ADAPTATION |
begincondition | Text field |
endcondition | Text field |
medicationtype | Kmehr table CD-MS-MEDICATIONTYPE |
medicationuse | Text field |
origin | Kmehr table CD-MS-ORIGIN |
Healthcareelement "adaptationflag"
Under discussion
This paragraph is under discussion and needs to be reviewed.
VIM-147 - Getting issue details... STATUSBy using a value of the table CD-MS-ADAPTATION it can be indicated where in the kmehr message modifications have been made by the end user.
Permitted values for this list are:
- nochanges
- medication
- posology
- treatmentsuspension
If changes have taken place to several parts of the kmehr message, it is possible to enter multiple values. However if the value ‘nochanges’ is used, only this value is permitted.
<item> <id SV="1.0" S="ID-KMEHR">2</id> <cd SV="1.3" S="CD-ITEM">healthcareelement</cd> <content> <cd SV="1.0" S="CD-ITEM-MS">adaptationflag</cd> <cd SV="1.0" S="CD-MS-ADAPTATION">medication</cd> <cd SV="1.0" S="CD-MS-ADAPTATION">posology</cd> </content> </item>
Healthcareelement "begincondition"
Healthcareelement "endcondition"
Healthcareelement "medicationtype"
Under discussion
This paragraph is under discussion and needs to be reviewed.
VIM-147 - Getting issue details... STATUS
The type of the medication can be indicated via CD-MS-MEDICATIONTYPE.
Permitted values for this list are:
- onprescription
- otc
- other
Healthcareelement "medicationuse"
<item> <id SV="1.0" S="ID-KMEHR">2</id> <cd SV="1.3" S="CD-ITEM">healthcareelement</cd> <content> <cd SV="1.0" S="CD-ITEM-MS">medicationuse</cd> </content> <content> <text L="nl">For stomachache</text> </content> </item>
Healthcareelement "origin"
Under discussion
This paragraph is under discussion and needs to be reviewed.
VIM-147 - Getting issue details... STATUSWith the help of the list CD-MS-ORIGIN it can be indicated via which path the medication is included in the medication scheme. Has this occurred by means of the ‘normal’ path by which the medicine is prescribed by the doctor and is delivered by the pharmacist (or in the case of OTC medication, is only delivered by the pharmacist)? This path will be indicated with the code ‘regularprocess’.
The other manner is that the patient or a care player indicates that he ingests certain medication. This medication can already be present at the patient's home; they have been obtained via friends or family or possibly purchased via the Internet or abroad. This medication can then still be included in the medication scheme and be indicated with the code ‘recorded’.
Permitted values for this list are:
- regularprocess
- recorded