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

« Previous Version 2 Next »


 


Analysedocument

Beschrijving interface elektronisch schema “Therapie’Link” versie 1.9


 

Inhoudstafel

1.         Inleiding. 3

2.         Description proces en XML-layout opmaak bestelling. 4

2.1   Beschrijving proces. 4

2.2   Beschrijving Lay-out conform de TherapieExport.V1.9.XSD.. 5

2.2.1 Therapie. 5

2.2.2 Sort order 7

2.2.3 Patients. 8

2.2.4 Patient (Resident) 8

2.2.5 Products. 10

2.2.6 Product (medicament) 10

2.2.7 AdmUnit 12

2.2.8 Adms (Toedieningen) 12

2.2.9 Adm.. 13

 

 

1.        Inleiding


Het doel van dit protocol is om therapieschema’s van woonzorgcentra (en aanverwanten) te delen met de apotheker. Hierdoor kan de apotheek het therapieschema extra evalueren naar contra-indicatie, interferentie en als basis gebruiken voor de tarificatie per eenheid.

We noemen deze method “Therapie’Link”. De Therapie’Link maakt deel uit van het Home’Link Apotheek v2 protocol. De Home’Link omvat alle interface protocollen tussen rusthuis 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.

Home’Link Apotheek v2 zal daarom enkel mogen aangewend worden indien de communicatie via de beveiligde eHealthbox verloopt.

Het WZC zal de actuele Therapieschema’s ter beschikking stellen via de eHealthbox van de apotheker.

De apotheker neemt initiatief vanuit zijn pakket om de therapieschema’s op te halen. De TherapieLink bestanden. 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), en de identificatie van WZC en identificatie van apotheker. Het beschikbaar bestand wordt direct verwerkt. Er wordt geen confirmatie teruggestuurd.  Het eHealthbox communicatiekanaal voorziet op zich al functies om er zeker van te zijn dat de bestanden bij de juiste bestemmeling worden afgeleverd.

 

 

2.           Description proces en XML-layout opmaak bestelling


2.1        Beschrijving proces

Als bestandformaat werd gekozen voor XML met UTF-8 encoding omwille van de flexibiliteit naar de toekomst toe.

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*)

yyyymmdd                                         = datum van de transactie

hhmmss                                             = tijdstip van de transactie

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

 

* Voor een rusthuis wordt bij voorkeur het RIZIV nr gebruikt. Indien niet mogelijk kan in samenspraak een andere alfanumerieke waarde gebruikt worden. Het veld moet met voorloopnullen opgevuld worden tot 16 posities.

Voor een apotheek wordt het APB nr gebruikt. De lengte is 6 lang en wordt met 5 voorloopnullen opgevuld tot 11 posities.

**De care toepassing maakt Therapie’Link bestanden aan op basis van geparametreerd aantal vaste dagen of weken. In het kader van de tarificatie per eenheid moet dit minimaal 10 dagen zijn, maar de werkgroep stelt voor om hier 2 weken te nemen. Het aanmaken en doorsturen volgens 2 scenario’s verlopen, namelijk dagelijks geautomatiseerd of manueel:

  • Geautomatiseerd: zodat apotheek dagelijks over een up-to-date medicatieschema beschikt. In de care sofware wordt een afgesproken uur ingesteld.
  • Manueel: zodat WZC de recentste wijzigingen nogmaals kan doorsturen (aanvullend)

 

Alle communicatie verloopt over de beveiligde eHealthbox.

 

*** De Therapie’Link is inhoudelijk en structureel zeer gelijkend op de Doseer’Link. De Doseer’Link beperkt zich tot de medicatie die door de apotheek via de robot of in een manueel systeem wordt klaargezet en dit voor de productieperiode. De Therapie’Link bevat alle medicatie en voor een langere periode. We raden dan ook aan om de vanuit de Care toepassing enkel de Therapie’Link nog te gebruiken en vanuit de apotheeksoftware een Doseerfile te genereren.

2.2        Beschrijving Lay-out 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

Lengte

Type

Beschrijving

Id

Simple

Id

Ja

20

N

Volgnr 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

PatientRemark

Simple

PatientRemark

Nee

 

A

Opmerking op niveau van de patiënt

Shortstay

Simple

Kortverblijf

Nee

 

A

Is de resident opgenomen in kortverblijf

0=geen kortverblijf

1=kortverblijf

SubstitutionAllowed

Simple

SubstitutionAllowed

Nee

1

N

Substitutie mag

0 = niet

1 = wel

Pulverize

Simple

Pletten

Nee

1

N

Moet medicatie geplet worden

0 = neen

1 = ja

Products

Complex

zie 2.2.5.

 

Ja

 

 

 


 

2.2.5     Products

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 toedieningsmoment, 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.

 



  • No labels