Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Introduction

A medication scheme is a kmehrmessage that consists of

  • 1 transaction MS, 
  • 0 or more transactions MSE and 
  • 0 or more transactions TS

According to the Kmehr standard, these transactions need to be put in the folder of the kmehrmessage. 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

standard

Vitalink

standard

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.

Transaction MS

Folder element <transaction>

Element

Vitalink meaning

Kmehr meaning: External Links#kmehr_transaction

Kmehr

standard

Vitalink

standard

id


Mandatory

=

cd


Mandatory

=

date


Mandatory

=

time


Mandatory

=

author


Mandatory

=

iscomplete

Kmehr: Specifies if the transaction is complete.

Vitalink: This element is not used. Since it is mandatory, Vitalink requires always the value "true".

Jira
serverimec Validation Lab
serverIdac11aa92-3976-3161-9ddb-5020cc76f1c7
keyVIM-147
Jira
serverimec Validation Lab
serverIdac11aa92-3976-3161-9ddb-5020cc76f1c7
keyVIM-149

Mandatory

=

isvalidated

Kmehr: Specifies if the transaction is validated.

Vitalink: This element is not used, see Concept: Validation

Mandatory

=

item


Optional

Mandatory

Vitalink transaction MS items

Kmehr element <item>

Each Kmehr element <item> consists of the next elements:

Element

Vitalink meaning

Kmehr meaning: External Links#kmehr_item

id

Vitalink: For Vitalink, this value has no extra meaning.

cd

Kmehr: The type of the item.

Vitalink: 1 item "medication" and 0 or more items "healthcareelement"


Item "medication"

The item medication has of the following additional elements:

Element

Description




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:

healthcareelementvalue of <content>
adaptationflagKmehr table CD-MS-ADAPTATION
begincondition

Text field

endconditionText field
medicationtypeKmehr table CD-MS-MEDICATIONTYPE
medicationuse

Text field

originKmehr table CD-MS-ORIGIN
Healthcareelement "adaptationflag"
Warning
titleUnder discussion

This paragraph is under discussion and needs to be reviewed.

Jira
serverimec Validation Lab
serverIdac11aa92-3976-3161-9ddb-5020cc76f1c7
keyVIM-147

By 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.

Code Block
languagexml
titleExample
linenumberstrue
<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"
Warning
titleUnder discussion

This paragraph is under discussion and needs to be reviewed.

Jira
serverimec Validation Lab
serverIdac11aa92-3976-3161-9ddb-5020cc76f1c7
keyVIM-147


The type of the medication can be indicated via CD-MS-MEDICATIONTYPE.

Permitted values for this list are:

  • onprescription
  • otc
  • other
Healthcareelement "medicationuse"
Code Block
languagexml
titleExample
linenumberstrue
<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"
Warning
titleUnder discussion

This paragraph is under discussion and needs to be reviewed.

Jira
serverimec Validation Lab
serverIdac11aa92-3976-3161-9ddb-5020cc76f1c7
keyVIM-147

With 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

Transaction MSE

Transaction TS