eWZC PAD-02: Home’Link Apotheek v. 2
|
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 |
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 | 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 |
| 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 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.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. |
Add Comment