Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

Beschrijving interface TherapieLink

versie 1.9a

 

 

 


 

Inhoudstafel

1.     Inleiding. 3

2.     Description process en XML-layout opmaak bestelling. 5

2.1   Beschrijving proces. 5

2.2   Beschrijving layout conform de TherapieExport.v1.9.XSD.. 6

 


 

1.   Inleiding

Het doel van dit proces is om therapieschema’s van instellingen (bv. WZC’s) te versturen via eHealthBox en vervolgens te importeren in het standaard apotheekpakket. Hierdoor kan de apotheek het therapieschema gebruiken om vanuit de apotheeksoftware oa de tarificatie per eenheid te doen, klaar te zetten of het bestand aanmaken voor de verdeelkast. Het verschil met de doseerlink is dat de doseerlink enkel de multidose medicatie bevat (=medicatie die door de apotheek wordt geherfactioneerd, hetzij via een robot, hetzij manueel), terwijl de therapielink alle medicatie bevat, ook die in de instelling wordt beheerd.

We noemen dit “Therapielink”. De Therapielink maakt deel uit van het Home’Link Apotheek v2 protocol. De Home’Link omvat alle interface protocollen tussen instelling en apotheek. Het is de tweede versie van het protocol dat initieel in 2007 gelanceerd werd, waarbij naast functionele uitbreidingen ook de beveiligde communicatie van deze medische patiënten gegevens belangrijk is.  De Vlaamse overheid en alle Vlaamse beroepsfederaties hebben in het roadbook voor de informatisering van WZC het belang van beveiligde elektronische communicatie tussen zorgactoren toegelicht en de financiering van het eWZC project Pad-02 gekoppeld aan het gebruik van de eHealthbox.

De instellingen houden per apotheker bij of de schema’s elektronisch worden verstuurd en naar welke eHealthID ze verstuurd moeten worden. De naamgeving van de bestanden en het type wordt gebruikt om te herkennen welke bestanden opgehaald mogen worden.

De apotheker neemt initiatief vanuit zijn pakket om de schema’s op te halen. Dit gebeurt op basis van de herkenning op naam van de beschikbare bestanden. In de naam zit het type verwerkt via 2 karakters (TH voor therapieschema’s), identificatie rustoord en identificatie apotheker.

De therapieschema’s worden dagelijks (liefst geautomatiseerd) om een overeen te komen tijdstip verstuurd. De periode van de inhoud van het schema moet minimaal 10 dagen zijn, aangezien de tarificatie per eenheid voor een week geldt en we best enkele dagen als buffer nemen. Er wordt aangeraden om dit standaard voor 2 weken te doen.


 

2.   Description process en XML-layout opmaak bestelling

2.1        Beschrijving proces

Als bestandformaat werd gekozen voor XML met UTF-8 encoding, volgens TherapieExport.XSD.

Bestandsnaam:

De interface bestanden hebben steeds een naam volgens de volgende structuur:

bbbbbbbbbbb_zzzzzzzzzzzzzzzz_yyyymmddhhmmss_tt.xml

waarbij

bbbbbbbbbbb (11)                             = bestemmeling (apotheek 11 lang)

zzzzzzzzzzzzzzzz (11 of 16)             = afzender (als rusthuis 16, als apotheek 11[1])

yyyymmdd                                         = datum van de transactie

hhmmss                                             = tijdstip van de transactie

tt                                                         = type transactie, dus voor de therapieschema’s steeds TH.

 

Bij het versturen via eHealthBox wordt een functioneel type meegegeven. Voor de therapieschema’s is dit HL-TH (wat staat voor HomeLink THerapie).

 

 


 

2.2        Beschrijving layout conform de TherapieExport.v1.9.XSD

2.2.1     Therapie

 

Sectie noodzakelijk: Ja

Beperking: 1 per file, dit is het root element.

 

 

Fieldname

Type

Nederlands

verplicht

max. Lengte

Type

Beschrijving

SenderNr

Simple

NummerAfzender

Ja

16

A

Identificatienr. afzender. Dit is de zelfde waarde als gebruikt in de naamgeving. Links aanvullen met ‘0’. Spaties en tekens moeten hieruit gehaald worden. Is RIZIV nummer van het WZC of APBNR van Apotheek.

SenderName

Simple

NaamAfzender

Ja

35

A

Naam instelling

ReceiverNr

Simple

NummerBestemmeling

Ja

11

A

Identificatienummer afzender. Dit zijn de identieke 16 karakters als gebruikt in de naamgeving. Links aanvullen met ‘0’. Spaties en tekens moeten hieruit gehaald worden. Is APB nummer van de apotheek.

ReceiverName

Simple

NaamBestemmeling

Ja

35

A

Naam apotheek

CreationDateTime

Simple

CreatieDatumUur

Ja

 

xs:dateTime

YYYY-MM-DDTHH:MM:SS

Bv. 2014-10-09T12:35:55
Op basis van dit veld kan de apotheek evalueren of het bestand reeds ingelezen werd.

StartDate

Simple

StartDatum

Ja

 

xs:date

YYYY-MM-DD
Is de eerste dag waarvoor het doseerschema is opgemaakt.

EndDate

Simple

EindDatum

Ja

 

xs:date

YYYY-MM-DD
Is de laatste dag waarvoor het doseerschema is opgemaakt.

SortOrder

Simple, zie 2.2.2

Sortering

Nee

70

A

Bepaalt de sortering waarop het therapieschema moet verwerkt worden. Zie hieronder. Deze heeft voor de therapie geen belang, maar wordt wel overgenomen van de doseer’Link

Patients

Complex zie 2.2.3

 

Ja

 

 

 

 

2.2.2     Sort order

 

Deze tag wordt gebruikt wanneer de apotheeksoftware op basis van een TherapieLink-bestand een productiebestand voor de verdeelkast aanmaakt. In deze tag kan het woonzorgcentrum aangeven in welke volgorde/sortering de productie en aanlevering van zakjes moet verlopen:

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

 

De inhoud van dit veld bestaat uit max 7 komma gescheiden delen, gaande van Location1 tot Location5, plus Date en Hour:

  • In de velden Location1 tot 5 uit de sectie <Patient>
  • Date en Hour verwijzen naar <AdmDate> en <AdmHour> uit de sectie <Adm>

 

Voorbeeld 1:

Location1 = Gebouw A,

Location2 = 1e verdieping,

Location3 = Sectie 1,

Location4 = 101 (kamernummer),

Location5 = A (Bed A)

 

Voorbeeld 2: 

Stel dat de instelling volgorde als volgt wil: Verdieping, Kamer, Bed, Datum, Uur

Dan zal <SortOrder> als volgt ingevuld moeten worden: “Location2, Location4, Location5, Date, Hour”

 

Enkele opmerkingen:

  • Men is in de sortering niet verplicht om de 5 locations te gebruiken
  • Date en Hour moeten niet noodzakelijk achteraan staan
  • Als <SortOrder> niet is ingevuld of meegegeven zal de apotheeksoftware de sortering moeten bepalen.

 

 

2.2.3     Patients

 

Sectie noodzakelijk: Ja

Beperking: 1 per file

Uitleg: Hierin worden alle patiënten (residenten) geplaatst, waarvoor een doseerschema wordt doorgegeven.

Fieldname

Type

Nederlands

verplicht

max. Lengte

Type

Beschrijving

Patient

Complex, zie 2.2.4

 

Ja

 

 

 

 

 

 


 

2.2.4     Patient (Resident)

 

Sectie noodzakelijk: Ja

Beperking: elke resident komt 1x voor

 

Fieldname

Type

Nederlands

verplicht

max. Lengte

Type

Beschrijving

Id

Simple

Id

Ja

20

N

Volgnummer patiënt (interne nummering bij afzender). Possible values : NISS of the patient or INAMI of the home

Name

Simple

Naam

Ja

48

A

Naam patiënt

Firstname

Simple

Voornaam

Ja

24

A

Voornaam patiënt

HomeID

Simple

HomeId

Nee

20

A

ID die in de instelling gebruikt wordt.

Location1

Simple

Locatie1

Nee

40

A

Hoogste niveau om de locatie te bepalen (bvb Gebouw A)

Location2

Simple

Locatie2

Nee

40

A

2e niveau om de locatie te bepalen (bvb 1e verdieping)

Location3

Simple

Locatie3

Nee

40

A

3e niveau om de locatie te bepalen (bvb Sectie 1)

Location4

Simple

Locatie4

Nee

40

A

4e niveau om de locatie te bepalen (bvb Kamernummer)

Location5

Simple

Locatie5

Nee

40

A

5e niveau om de locatie te bepalen (bvb Bed A)

Birthdate

Simple

Geboortedat.

Nee

 

xs:date

YYYY-MM-DD

DoctorName

Simple

NaamDokter

Nee

40

A

Naam behandelende dokter van de resident

DoctorMedRegNr

Simple

RizivNrDokter

Nee

11

N

Riziv nummer van de behandelende dokter (verplicht als NaamDoktor is meegegeven)

PatientUnidose

Simple

PatientUnidose

Nee

1

N

0 of 1 (1= voor deze resident wordt er een multidosebeheer toegelaten, 0 is geen MD)

PatientUnidosePacket

Simple

PatientUnidosePacket

Nee

1

N

0= voor de maaltijd

1= tijdens de maaltijd

2= na de maaltijd

Is voor alle medicamenten van deze patient

 

 


 

2.2.5     Patient (Resident)

 

Sectie noodzakelijk: Ja

Uitleg: komt 1x per patiënt voor

 

Fieldname

Type

Nederlands

verplicht

max. Lengte

Type

Beschrijving

Product

Complex

Zie 2.2.6

 

Ja

 

 

 

 

 

2.2.6     Product (medicament)

 

Sectie noodzakelijk: Ja

Uitleg: Dit zal voor elk medicament dat in het doseerschema voorkomt herhaald worden.

 

 

Fieldname

Type

Nederlands

verplicht

max. Lengte

Type

Beschrijving

ProductId

Simple

CNK

Ja

20

N

CNK van het medicament of apotheek eigen CNK toegekend aan magistrale bereiding.

ProductIdHome

Simple

IdMedicament

Ja

20

A

Id medicament gebruikt in software instelling

PreparationId

Simple

IdBereiding

Nee

20

A

Nummer van de bereiding

Speciality

Simple

Specialiteit

Ja

1

N

0= magistrale bereiding

1= product met CNK

Dsc

Simple

Omschrijving

Ja

120

N

Omschrijving medicament

Formula

Simple

Formule

Nee

 

A

Formule medicament voor magistrale bereidingen

TabletUnidose

Simple

TabletUnidose

Nee

1

N

0 of 1 (1= dit product is MD, 0 is Niet-MD)

TabletUnidosePacket

Simple

TabletUnidosePacket

Nee

1

N

0= voor, 1= tijdens,

2= na de maaltijd

Is voor dit medicament

AdmUnit

Complex
Zie 2.2.7

 

Nee

 

 

 

PrescriptionId

Simple

VoorschriftId

Nee

30

N

Id van het voorschrift

StartTreatment

Simple

StartPosologie

Nee

8

xs:date

YYYY-MM-DD
Startdatum van de huidige posologie /behandeling van dit medicament

StopTreatment

Simple

StopPosologie

Nee

8

xs:date

YYYY-MM-DD
Stopdatum van de huidige posologie / behandeling van dit medicament. Indien niet meegegeven is dit onbepaald.

Adms

Complex

Zie 2.2.8

 

Ja

 

 

 

ProductRemark

Simple

ProductOpmerking

Nee

 

A

Opmerkingen op product niveau

 

2.2.7     AdmUnit

 

Sectie noodzakelijk: Nee

Beperking: geen, kan dus meerdere keren voorkomen.

Deze sectie zal voor elke taal herhaald worden.

 

Fieldname

Type

Nederlands

verplicht

max. Lengte

Type

Beschrijving

DscLg

Simple

Taal

Ja

2

A

Moet NL voor Nederlands, FR voor Frans zijn. Er moet minstens 1 taal aanwezig zijn.

Dsc

Simple

Omschrijving

Ja

 

A

De omschrijving van de toedieningseenheid.

 

 

2.2.8     Adms (toedieningen)

 

Sectie noodzakelijk: ja

Beperking: komt 1x voor per product

Uitleg: Lijst van de toedieningsmomenten voor de te verpakken medicatie OF AdHoc aanduiding (indien nodig).

 

Fieldname

Type

Nederlands

verplicht

max. Lengte

Type

Beschrijving

Adm

Complex

Zie 2.2.8

 

Ja

 

 

 

 

of

 

Fieldname

Type

Nederlands

verplicht

max. Lengte

Type

Beschrijving

AdHoc

Simple

IndienNodig

Ja

1

N

Geen vast toedienings-moment, enkel innemen indien nodig ?

0 = neen

1 = ja

 

Dus voor alle duidelijkheid:

<Adms>

<Adm>…</Adm>

<Adm>…</Adm>

<Adm>…</Adm>

</Adms>

 

of

 

<Adms>

<Adhoc>1</Adhoc>

</Adms>

Een combinatie van beide is NIET toegestaan.

 

 

2.2.9     Adm

 

Sectie noodzakelijk: Ja

Beperking: geen, kan dus meerdere keren voorkomen.

 

Deze sectie zal voor elk toedieningsmoment herhaald worden en dit voor de ganse periode waarvoor het bestand is aangemaakt.

bv. Als bestand is opgemaakt voor 7 dagen en het moet 3x daags genomen worden, dan geeft 21 lijnen.

 

Fieldname

Type

Nederlands

verplicht

max. Lengte

Type

Beschrijving

Qty

Simple

Aantal

Ja

8

N

Aantal eenheden dat moeten toegediend worden. Mag met 2 decimalen.
Een ½ tablet wordt 0.50

Een ¼ tablet wordt 0.25

Anderhalf wordt 1.50
In de rustoordsoftware dient ingesteld te worden of decimalen mogen opgenomen worden.

AdmDate

Simple

ToedieningsDatum

Ja

8

N

YYYY-MM-DD

AdmHour

Simple

ToedieningsUur

Ja

 

xs:time

HH:MM:SS
Is het startuur van het toedieninsgmoment.

AdmCode

Simple

Code Toedieningswijze

Nee

 

A

Zie onderstaande tabel. Kolom Code is enumeration uit XSD.

 

 

 

Code

Description (nl)

Description (fr)

Patiënt vertaling

Prioriteit

00001

5ml

5ml

koffielepel (5ml)

1

00002

amp.

amp.

ampule

1

00003

applic.

applic.

aanbrengen

1

00004

caps.

caps.

capsule

1

00005

compr.

compr.

tablet

1

00006

dosis

dose

dosis

1

00007

druppels

gouttes

druppel(s)

1

00008

flac.

flac.

flesje

2

00009

implant

implant.

implantaat

2

00010

infuus

perf.

infuus

2

00011

inhal.

inhal.

inhalatie

1

00012

insert

insert

inbrengen

2

00013

kauwgom

gommes

kauwgom

2

00014

compres(sen)

compres(ses)

compres(sen)

2

00015

lav.

lav.

lavement

2

00016

ml

ml

ml

1

00017

ov.

ov.

ovule

2

00018

parel(s)

perle(s)

parel

2

00019

past.

past.

pastille

1

00020

patch

patch

pleister

1

00021

patr.

cart.

patroon

2

00022

pen

stylo

pen

2

00023

puff(s)

puff(s)

puff(s)

1

00024

spons

éponge

spons

2

00025

stylo

stylo

 

0

00026

suppo

suppo

zetpil

1

00027

tube

tube

tube

2

00028

wiek

mèche

wiek

2

00029

zak

sac

zak

2

00030

zakje(s)

sachet(s)

zakje

1

cm

centimeter

centimetre

centimeter

 

dropsperminute

druppels per minuut

 

druppels per minuut

 

gm

gram

gram

gram

 

internationalunits

internationale eenheden

 

internationale eenheden

 

mck/h

microgram per uur

microgram par heure

microgram per uur

 

mck/kg/minute

microgram per kilogram per uur

 

microgram per kilogram per uur

 

measure

maat

 

maat

 

mg/h

milligram per uur

milligram par heure

milligram per uur

 

ml/h

mililiter per uur

mililitre par heure

mililiter per uur

 

tbl

eetlepel

 

eetlepel

 

tsp

koffielepel

 

koffielepel

 

unt/h

eenheden per uur

 

eenheden per uur

 

 



[1] Voor een rusthuis wordt het RIZIV-nummer gebruikt. De lengte is variabel (afhankelijk van het type) en moet met voorloopnullen opgevuld worden tot 16 posities.  Voor een apotheek wordt het APB-nummer gebruikt. De lengte is 6 lang en wordt met 5 voorloopnullen opgevuld tot 11 posities

  • No labels

0 Comments

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account.