Versions Compared

Key

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

...

Element

Vitalink meaning

Kmehr meaning: External Links#kmehr_transaction

Kmehr

Vitalink

id

For the use in storage and consultation, see M. Storage and Consultation.

Mandatory

=

cd

-

Mandatory

=

date

For the use in storage and consultation, see M. Storage and Consultation.

Mandatory

=

time

For the use in storage and consultation, see M. Storage and Consultation.

Mandatory

=

author

For the use in storage and consultation, see M. Storage and Consultation.

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. Since it is mandatory, Vitalink requires always the value "true". See M. Concept: User transaction validationUsage of <isvalidated> for further details.

Mandatory

=

item

Vitalink: No item is defined within the transaction medicationscheme.

Optional

0

...

Element

Vitalink meaning

Kmehr meaning: External Links#kmehr_transaction

Kmehr

Vitalink

id

For the use in storage and consultation, see M. Storage and Consultation.

Mandatory

=

cd

-

Mandatory

=

date

For the use in storage and consultation, see M. Storage and Consultation.

Mandatory

=

time

For the use in storage and consultation, see M. Storage and Consultation.

Mandatory

=

author

For the use in storage and consultation, see M. Storage and Consultation.

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
showSummaryfalse
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. Since it is mandatory, Vitalink requires always the value "true". See M. Concept: User transaction validationUsage of <isvalidated> for further details.

Mandatory

=

item

-

Optional

[1-*]

...

Element

TypeVitalink

group of elements for

medication information

Refer to corresponding paragraph.Mandatory
temporalityCD-TEMPORALITYOptional
frequency

CD-PERIODICITY

Optional
beginmoment<date>Mandatory
endmoment<date>Optional, not together with duration
durationRefer to corresponding paragraph.Optional, not together with endmoment
regimenRefer to corresponding paragraph.Optional, not together with posology
posology<text>Optional, not together with regimen
routeCD-DRUG-ROUTEOptional
instructionforpatienttextOptionalinstructionforoverdose

instructionforoverdosing

(deprecated)

textOptional
Medication elements for medication information 

...

Note
titleAdvise

Although it should be used when reading a medication, it is advised not to use the 'delivered' functionality when writing medication. When delivering another product instead of the intended one, it is better to replace the orginal original <intendedcd> and <intendedname> by a new <intendedcd> and <intendedname>.

...

Note
titleAdvise

Although it should be used when reading a medication, it is advised not to use the delivered functionality when writing medication. When delivering a product based on the intended substance, it is better to replace the orginal original <substanceproduct> by a new <medicinalproduct>.

...

Code Block
languagexml
titleExample
linenumberstrue
...
<item>
	<id S="ID-KMEHR" SV="1.0">2</id>
	<cd S="CD-ITEM" SV="1.11">medication</cd>
	<content>
		<substanceproduct>
			<intendedcd S="CD-INNCLUSTER" SV="20102018-0708">30189<>01569</intendedcd>
			<intendedname>rosuvastatine 40 mg (or.)<<intendedname>rosuvastatine</intendedname>
		</substanceproduct>
	</content>
	<beginmoment>
		<date>2025-01-15</date>
	</beginmoment>
	...

...

Code Block
languagexml
titleExample with deliveredcd
linenumberstrue
...
<item>
	<id S="ID-KMEHR" SV="1.0">2</id>
	<cd S="CD-ITEM" SV="1.11">medication</cd>
	<content>
		<substanceproduct>
			<intendedcd S="CD-INNCLUSTER" SV="20102018-0708">30189<>01569</intendedcd>
			<intendedname>rosuvastatine 40 mg (or.)<<intendedname>rosuvastatine</intendedname>
			<deliveredcd S="CD-DRUG-CNK" SV="20102018-0708">3641081</deliveredcd>
			<deliveredname>Rosuvastatine Mylan filmomh. tabl. 98 x 40 mg</deliveredname>
		</substanceproduct>
	</content>
	<beginmoment>
		<date>2025-01-15</date>
	</beginmoment>
	...

...

Medication element <temporality>
Medication element <frequency>
Medication element <beginmoment>

This element specifies the chronicity of the treatment. Please refer to M. Concept: Temporality "Ad hoc" for details of usage.

Medication element <frequency>

This element specifies the frequency of the treatment. Please refer to M. Combined use of frequency and day and M. Concept: Hourly frequency and posology for details of usage.

Medication element <beginmoment>

This is the This is the date from when the medication can at the earliest taken.

...

Medication element <route>

...

This element specifies the administration route.

Medication element

...

<instructionforpatient>

This is the usage instruction for the patient.

Medication element <instructionforoverdosing> (deprecated)

This is the medical justification when the product is overdosed. 

Transaction Transaction element <item> "healthcareelement"

...

This healthcareelement is not be used by Vitalink. The orginal original intention was to indicate the changes compared to the previous version of the transaction.

...

Healthcareelement "begincondition"

This is an element containing a textual description with the condition when the treatment should be started.

Healthcareelement "endcondition"

This is an element containing a textual description with the condition when the treatment should be ended.

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.11" 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

Folder element <transaction> "treatmentsuspension" TS

The Vitalink transaction TS can be used to express a suspension of the ingestion of the medicationtreatment. A medication scheme can contain 0 or more suspensions.

...

Element

Vitalink meaning

Kmehr meaning: External Links#kmehr_transaction

Kmehr

Vitalink

id

For the use in storage and consultation, see M. Storage and Consultation.

Mandatory

=

cd

-

Mandatory

=

date

For the use in storage and consultation, see M. Storage and Consultation.

Mandatory

=

time

For the use in storage and consultation, see M. Storage and Consultation.

Mandatory

=

author

For the use in storage and consultation, see M. Storage and Consultation.

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. Since it is mandatory, Vitalink requires always the value "true". See M. Concept: User transaction validationUsage of <isvalidated> for further details.

Mandatory

=

item

-

Optional

[1-*]

...

This is the date from when the medication treatment should be suspended.

In the next example, the medication should not be taken anymore, until further notice, starting from the 1th of august 2030: 

...

This is the date until which the medication treatment should be suspended.

In the next example, the medication can be taken again earliest starting from the 1th of july 2030: 

...

Medication element <duration>

...

An implicit endmoment can be expressed by defining a duration. This duration defines the period, starting from the beginmoment, during which the medication can not be taken.

In the next example, the medication can be taken again earliest starting from the 1th of december 2030: 

Code Block
languagexml
titleExample
linenumberstrue
...
<transaction>
	<id S="ID-KMEHR" SV="1.0">46</id>
	...
	<cd S="CD-TRANSACTION" SV="1.11">medicationschemeelement</cd>
	...
</transaction>
...
<transaction>
	<id S="ID-KMEHR" SV="1.0">49</id>
	...
	<cd S="CD-TRANSACTION" SV="1.11">treatmentsuspension</cd>
	...
	<item>
		...
		<beginmoment>
        	<date>2030-11-01</date>
        </beginmoment>
		<duration>
			<decimal>30</decimal>
			<unit>
				<cd S="CD-TIMEUNIT" SV="2.1">d</cd>
			</unit>
		</duration>
		...
		<lnk TYPE="isplannedfor" URL="//kmehr:transaction[id[@S='ID-KMEHR']='46']"/>
	</item>
	...
</transaction>
...
Medication element <lifecycle>

This element specifies if the suspension is temporary ("suspended") or definite ("stopped"). This lifecycle is only indicative, i.e. an application should not use this to interpret or express that a treatment should be stopped permanently. In the latter case, the application should remove the treatment.

Medication element <lnk>

This element contains a link to the transaction MSE that is suspended. The content is an XPath link identifying the corresponding MSE by its ID-KMEHR id.

...