Table of contents

1. Introduction. 
2. Description process en XML-layout opmaak bestelling. 

      2.1   Process description. 

      2.2   Description layout in accordance with TherapieExport.v1.9.XSD.. 

1.   Introduction

The purpose of the Therapy’Link process is to send therapy schedules from care institutions (e.g. rest and care homes) via eHealtbox and thereafter to import them in the default pharmacy software. This enables the pharmacy to use the therapy schedule in his software for a.o.  tarification per unit, preparing medication doses or creating files for automated dispensing systems. The difference with the Dose’Link file is that the former only contains the multidose medication (= medication dispensed by the pharmacy, either by a robot or manually), whereas Therapy’Link contains all medication, including medication managed by the care institution.

Therapy’Link is part of the Home’Link Pharmacy v2 protocol. Home’Link consists of all interface protocols between care homes and pharmacies. It’s the second version of the protocol which was initially launched in 2007. In the second version, both functional enhancements and secure communication of patient data were important. In the roadbook for the digitization of elderly care homes, the Flemish government and all Flemish professional federations addressed the importance of secure electronic communication between care providers and linked the financing of the eWZC project Pad-02 with the use of eHealthbox.

Care homes register per pharmacy whether they use electronic therapy schedules and to which ehealthID the schedules should be sent. The name of the files and the functional type is used to determine which files can be imported.

The pharmacy imports the files in its software. The file name contains elements that allow the software to determine what to do with the available files. It contains two characters (TH for therapy schedules) referring to the file type, as well as the identification of the elderly care home and the identification of the pharmacy.

The care institution sends the therapy schedules on a daily basis (preferably automated) at an agreed time. The time period covered in the schedule should be at least 10 days, because the tarification per unit is valid for a days, and it is best to have a couple of extra days as a buffer. It is recommended to use send therapy schedules for two weeks as a default.

2.   Description process en XML-layout opmaak bestelling

2.1        Process description

The file format chosen is XML with UTF-8 encoding, according to TherapieExport.XSD

File name:

The name of the interface files always needs to be built according to the following structure:

bbbbbbbbbbbbbbbb_zzzzzzzzzzzzzzzz_yyyymmddhhmmss_tt.xml

where

bbbbbbbbbbbbbbbb (11 or 16)          = receiver (16 for care homes, 11 for pharmacies [1])

zzzzzzzzzzzzzzzz (11 or 16)             = sender (16 for care homes, 11 for pharmacies[2])

yyyymmdd                                         = transaction date

hhmmss                                             = transaction time

tt                                                         = transaction type: for a therapy schedule this is always ‘TH’

When the file is sent via eHealtbox, a functional type will be provided. For therapy schedules, this is HL-TH (which refers to HomeLink Therapy).

2.2        Description layout in accordance with TherapieExport.v1.9.XSD

2.2.1. Therapie

Section necessary: Yes

Restriction: 1 per file; this is the root element.

 2.2.2. Sort order

This tag is used when the pharmacy software creates a production file for an automated dispensing system based on a Therapy’Link file. It is used by the care home for determining the production and delivery order of the medication bags.

<SortOrder>Location2, Date, Hour, Location4, Location5</SortOrder>

The contents of this field consist of maximum 7 parts separated by commas, starting from Location1 to Location5, plus Date and Hour:

• Location 1 to 5 from the section <Patient>
• Date and hour refer to <AdmDate> and <AdmHour> from the section <Adm>

Example 1:

Location1 = Building A,

Location2 = 1st floor,

Location3 = Section 1,

Location4 = 101 (room number),

Location5 = A (Bed A)

Example 2: 

Suppose the institution wants the following order: Floor, Room, Bed, Date, Hour

The field <SortOrder> will need to be filled as follows: “Location2, Location4, Location5, Date, Hour”

Rermarks:

• It is not mandatory to use all 5 location for the sorting
• Date and hour don’t necessary need to follow each other
• If <SortOrder> is left empty or hasn’t been provided, the pharmacy software will need to determine the sorting.

 2.2.3. Patients

Section necessary: Yes

Restriction: 1 per file

Explanation: This section contains all patients (residents) for whom a therapy schedule is being provided.

 2.2.4 Patient (Resident)

Sectie necessary: Yes

Restriction: 1 per resident

 2.2.5. Products

Section necessary: Yes

Explanation: 1 per resident

 2.2.6. Product (medication)

Sectie necessary: Yes

Explanation: This section will be repeated for each medication in the dosage schedule.

 2.2.7. AdmUnit

Section necessary: No

Restrictions: None; this section can be repeated

This section will be repeated for each language

 2.2.8. Adms (administrations)

Sectie necessary: Yes

Restriction: 1 per product

Explanation: List of administration moments for medication to be dispensed, or indication ‘adhoc’ for medication that needs to be administered if needed.  

or

The section will contain either

<Adms>

<Adm>…</Adm>

<Adm>…</Adm>

<Adm>…</Adm>

</Adms>

or

<Adms>

<Adhoc>1</Adhoc>

</Adms>

A combination of both is NOT allowed.

 2.2.9. Adm

Sectie necessary: Yes

Restriction: none; this section can be repeated.

This section will be repeated for each administration moment, and this for the entire period for which the file has been created.

E.g. If the file has been created for 7 days, and the medication needs to be taken 3 times per day, this will result in 21 lines.

[1] The RIZIV-number is used for care homes. The length of this number is variable, depending on the type of home, and needs to be completed with leading zeroes up to 16 positions.

The APB-number is used for pharmacies. The length of this number is 6 characters. It needs to be completed with leading zeroes up to 11 positions.

[2] The RIZIV-number is used for care homes. The length of this number is variable, depending on the type of home, and needs to be completed with leading zeroes up to 16 positions.

The APB-number is used for pharmacies. The length of this number is 6 characters. It needs to be completed with leading zeroes up to 11 positions.