eWZC PAD-02: Home’Link Apotheek v. 2
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 |
StartDate | Simple | StartDatum | Ja |
| xs:date | YYYY-MM-DD |
EndDate | Simple | EindDatum | Ja |
| xs:date | YYYY-MM-DD |
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 |
| Nee |
|
|
|
PrescriptionId | Simple | VoorschriftId | Nee | 30 | N | Id van het voorschrift |
StartTreatment | Simple | StartPosologie | Nee | 8 | xs:date | YYYY-MM-DD |
StopTreatment | Simple | StopPosologie | Nee | 8 | xs:date | YYYY-MM-DD |
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.25 Anderhalf wordt 1.50 |
AdmDate | Simple | ToedieningsDatum | Ja | 8 | N | YYYY-MM-DD |
AdmHour | Simple | ToedieningsUur | Ja |
| xs:time | HH:MM:SS |
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
0 Comments