Tervise ja Heaolu Infosüsteemide Keskus
[email protected] mai 2018 nr 1.8-3/17592
Retseptiarenduste teostamine digilugu.ee portaalis
Käesolevaga edastame digilugu.ee patsiendiportaalis realiseeritavate digiretsepti arenduste -
e-ravimilehe, täiendava ravimihüvitise ja annustamisskeemiga seotud muudatuste kirjeldused.
E-ravimileht
E-ravimileht on koondülevaade patsiendi raviskeemist, mis on mõeldud kasutamiseks
arstidele, apteekritele ja patsientidele. Arstide ja apteekrite vaated luuakse otse kasutajate
infosüsteemidesse ning eraldi portaalivariante neile ei looda, samuti ei tehta e-ravimilehe arsti-
ja apteekrivaateid MISP2 portaali, kuna selle kasutamine on vähene. Patsientidele mõeldud
ülevaatlik kasutatavate ravimite skeem ehk ravimileht tuleb luua patsiendiportaali.
Arendamisel on abiks kasutajaliidese kujundamise juhend, andmed patsiendi raviskeemi
kuvamiseks saadakse kasutatavast teenusest rets.retseptideVaatamine.
Täiendav ravimihüvitis
2018. a alguses jõustus digiretsepti süsteemis automaatne täiendava ravimihüvitise
arvestamine. Täiendav ravimihüvitis on hüvitis, mida makstakse kindlustatud isikule, kelle
soodusravimite kulutused aastas ületavad 100 eurot. Automaatse soodustuse saamiseks
müügihetkel arvestab retseptikeskus lähtuvalt isiku kalendriaasta ostudele täiendava
ravimihüvitise alussumma ja leiab selle järgi automaatse täiendava ravimihüvitise suuruse,
mille võrra tehakse patsiendile koheselt suurem soodustus. Seega ei ole alates 2018.a algusest
vaja isikutel esitada haigekassale avaldusi hüvitise saamiseks ning kogu hüvitise summa võrra
tehakse kindlustatule suuremat soodustust kalendriaasta jooksul. Seoses kirjeldatud
muudatusega muutub paljudel soodusretseptidel tavapärane ravimi soodustuse summa (mida
kuvatakse ka patsiendiportaali) suuremaks. Täiendava ravimihüvitise soodustuse, summaarse
soodustuse ja täiendava ravimihüvitise soodustuse jäägi summad on lisatud teenusesse
rets.retseptideVaatamine ning nendega tuleks täiendada patsiendiportaali retseptivaadet.
Annustamisskeemi täiendused
2018. a märtsis tehti tervishoiutöötajatele võimalikuks täiendatud annustamisskeemiga
retseptide koostamine. Võrreldes 2016.a juurutatud kohustusliku annustamisskeemiga on
teenuses tehtud järgmised muudatused:
1. Loendisse ravikuuri tüüp on lisandunud uus väärtus „Vajadusel“.
2. Lisati täiendavate annustamise ridade saatmise võimalus, et arstidel oleks võimalik märkida
ajas muutuvaid ja keerukaid annustamisskeeme. Selleks täiendati sõnumite struktuuri ja
lubatakse piiramatult kasutada andmeblokki <annustamine>.
3. Loodi uued väljad manustamisaja täpsustamiseks - „hommik“, „lõuna“, „õhtu“, „öö“.
4. Loodi uus element perioodi_pikkus.
Annustamisskeem tuleb tarkvarades juurutada aasta jooksul – 2019. a märtsiks.
Loodame, et patsiendiportaalis on võimalik teha kirjeldatud muudatused 2018. a jooksul.
Lisaks võiks käesolevate arendustega teha retsepti detailvaate juures kättesaadavaks müüdud
ravimi patsiendiinfolehe, mis asub Ravimiameti hallatavas Ravimiregistris.
Ootame tagasisidet, kas kirjeldatud muudatused on võimalik teostada 2018.a jooksul. Hea
meelega osaleme patsiendiportaali vaadete väljatöötamisel ja testimisel.
Lugupidamisega
(allkirjastatud digitaalselt)
Rain Laane
Juhatuse esimees
Lisad:
1) Teenuse rets.retseptideVaatamine kirjeldus
2) Juhendmaterjal ja näited e-ravimilehe vaadete kujundamiseks digilugu.ee portaalis
Liis Kruus 6208 312
[email protected]
Juhend materjal e-ravimilehe kujundamiseks digilugu.ee portaalis 1. Sissejuhatus Dokument on mõeldud patsiendiportaali haldajatele ning on juhendiks vajalike vaadete väljatöötamisel. Arstide ja apteekide tarkvarade kujundamiseks loodud juhendiga on võimalik tutvuda Haigekassa kodulehel: https://www.haigekassa.ee/sites/default/files/IT_juhised/juhend_ravimilehe_kuvamiseks_IS.pdf E-ravimilehe väljatöötamisel on kaasatud partnerina Trinidad Wisemani , kes on kasutajaliideste ja kasutajakogemuse disaini, äri- ja süsteemianalüüsi pakkuv ettevõte. Disainlahendusele eelnesid intervjuud kasutajatega ning arstide ja apteekrite üksmeelne arvamus oli, et e-ravimilehest on enim kasu juhul, kui see on kõikides kasutusel olevates tarkvarades ja patsiendiportaalis maksimaalselt sarnane. Seetõttu on oluline võtta kasutajaliideste disainil aluseks antud juhendit ning kujundada lahendus vastavalt eelnevalt läbi testitud ja kasutajate tagasisidest lähtuvalt kohandatud prototüübile. 2. E-ravimilehe patsiendi vaade digilugu.ee portaalis Patsientidele on kirjeldatud kolme erinevat vaadet: Välja ostetud ravimite skeem (joonis 1) Välja ostetud ja ostmata ravimite skeem (joonis 2) Retseptide loetelu (joonis 3) Välja ostetud ravimite skeem , joonis 1 : Patsiendi isikukoodiga teostatakse retseptide päring, retsepti staatuseks 10. Analüüsitakse retseptile märgitud raviskeeme – ravikuuri tüübi ja pikkuse järgi leitakse, kui kaua ja milliseid ravimeid patsient sellel või järgmisel nädalal tarvitab. Algoritm ravimi kasutuskestuse arvutamiseks: müügi_kp+kordsus * ravikuuri_pikkus *1,2 . Ravikuuri pikkus leitakse retseptile märgitud ravikuuri tüübi järgi – „fikseeritud“, „vajadusel“ ja „pidevalt“. Esimesel juhul on retseptil ravikuuri pikkuseks konkreetne päevade arv , teistel juhtudel on kuuri pikku s vaikimisi määratud (90 päeva) , aga arst võib selle olla täitnud ka muu numbriga . Kordse retsept i korral tuleb arvesse võtta seda, kas välja on ostetud 1, 2 või kolm retsepti ja pikkust kohandada. Valemisse arvestatakse juurde 20% nö optimaalset varu aega, sest isegi juhul , kui inimene ravimi apteegi st kätte saab, ei pruugi ta ostmise hetkel seda võtma hakata- nt otsustab, et vaatab veel 3 päeva ja ha kkab seejärel võtma . Retsepti annustamise plokist leitakse annustamise info – kui retsept on koostatud uue annustamisskeemi järgi ja lisatud on ajaühik (nt öö), millal täpselt ravimit võtta tuleb, kuvatakse see skeemile. Kui retsept on koostatud vana annustamisskeemi järgi või ei ole ajaühikut märgitud, kuvatakse selle päeva annustamine üle hommik/lõuna/õhtu/öö väljade. Välja ostetud ja ostmata ravimite skeem , joonis 2 : Lisaks eelnevalt kirjeldatule võetakse juurde ka kõik staatuses 00 retseptid ja kuvatakse need skeemile. Mõlema skeemi päises on kirjas missuguse skeemiga täpselt tegemist on (välja ostetud (või väljaostetud) ja ostmata). Patsiendi raviskeem on kuvatud nädala kaupa kuupäevade järgi. Päises on kuvatud kuupäevade vahemik ja patsiendi nimi. Sobiva nädala saab valida liikudes nuppude jooksev nädal järgmine nädal vahel. Esimeses veerus on toodud nädalapäevad kuupäeva täpsusega ning hommik-lõuna-õhtu-öö jaotusega. Horisontaalselt on kuvatud ravimi info (toimeaine, müüdud pakendi nimetus, toimeaine tugevus ja kogus), kasutamise eesmärk (kuna sellist klassifikaatorit hetkel ei ole ning arst ei märgi kasutamise eesmärki retseptile, siis saab selle ära jätta või asendada nt diagnoosikoodiga, mis viitab patsiendi haigusseisundile) ja lisainfo, mille arst märgib vabatekstiliselt retseptile. -575945 0 0 0 Joonis 1. Välja ostetud ravimite skeem ehk need ravimid, mis on patsiendil tõenäoliselt kasutada. -626110 0 0 0 Joonis 2. Välja ostmata retseptid toodud viimastena ja eraldatud teistest retseptidest selgelt eristuva punase pideva joonega. Retseptide loetelu Prototüübi testimisel selgus, et mõnede patsientide jaoks on lihtsam aru saada loetelu kujul esitatud mitte skemaatiliselt koos kuupäevadega kujutatud raviskeemist. Retseptide loetelu vaadet on esitatud joonisel 7. Sellise vaate võib valitava alternatiivina luua lisaks eelmis t ele. -699770 208915 0 0 Joonis 3. Retseptide loetelu Patsient saab raviskeemi prinditud kujul kaasa arsti või apteekri juurest, lisaks on võimalus raviskeemi vaadata digilugu.ee portaalist. Apteegist antakse patsiendile kaasa eelkõige välja ostetud ravimite skeem, arsti juures välja ostetud ja kirjutatud ravimite skeem, kuna ravimeid, mida visiidi jooksul patsiendile välja kirjutati, ei ole veel realiseeritud.. Prototüübi välja töötamisega tegelnud töörühm arvas, et d igiloo portaali s peaks patsient nägema ainult välja ostetud ehk hetkel kasutatavate ravimite skeemi, välja ostmata ja tõenäoliselt hetkel mitte kasutatavaid ravimeid skeemil ei kuvata. Teine variant on luua portaali mõlemad skeemid – nii välja kirjutatud kui välja ostetud ravimite skeem. Ravimileht ei asenda retseptide loetelu ja detailvaadet, kust on võimalik otsida ja vaadata ka välja kirjutatud retsepte ja retseptide ajalugu. Portaalis kuvatakse välja ostetud ravi mite skeem sarnaselt joonisele 1 või soovi korral loetelu vaade sarnaselt joonisele 3 . Patsient saab soovi korral liikuda järgmise nädala skeemile. Skeemi päises on kuvatud perioodi kuupäev, patsiendi nimi, arsti nimi ja lisainfo „Küsimuste korral pöörduge arsti poole“. Kuidas jõuab patsient ravimite võtmise skeemini? Logib portaali sisse, näeb, mis retseptid on hetkel kehtivad (nö retseptide loetelu ja soovi korral detailvaate vaatamine) vaata ravimite võtmise skeemi prindib skeemi välja saadab skeemi e-mailile liigub skeemilt retsepti detailvaatesse Liigub soovi korral edasi pakendi infolehele 3. Patsiendi ravimiskeemi arendamine Ravimileht kuvatakse juba olemasoleva ja patsiendiportaalis kasutatava teenuse retseptide_vaatami n e abil. Teenust on 2018.a kevadel täiendatud annustamisskeemi lisaridade ja täiendava ravimihüvitise infoga. Ravimilehe vaadete disainimisel on abiks prototüübi failid ja stiililehed, mis on kättesaadavad haigekassa kodulehel: https://www.haigekassa.ee/partnerile/it-juhendid/digiretsept .
Eesti Haigekassa
Retseptikeskus
Retsepti muudatuste pärimise teenused
rets.muutunudRetseptideLoetelu ja rets.retseptideVaatamine
v4 (Final)
0. Dokumendi muudatused .............................................................................................................. 3
1. Dokumendist ................................................................................................................................ 4
1.1. Eesmärk ................................................................................................................................. 4
1.2. Dokumendi lugemiseks ......................................................................................................... 4
1.3. Kasutatud nimeruumid .......................................................................................................... 4
2. Liidese kirjeldus ........................................................................................................................... 5
2.1. Viited kasutatud loenditele .................................................................................................... 5
2.2. Teenus rets.muutunudRetseptideLoetelu............................................................................... 6
2.2.1. Sisend ............................................................................................................................. 6
2.2.2. Väljund ........................................................................................................................... 6
2.2.3. Reeglid ........................................................................................................................... 6
2.3. Teenus rets.retseptideVaatamine ........................................................................................... 7
2.3.1. Sisend ............................................................................................................................. 7
2.3.2. Väljund ........................................................................................................................... 7
2.3.3. Reeglid ......................................................................................................................... 13
2.4. Teated .................................................................................................................................. 13
3. Näited ......................................................................................................................................... 14
Tabelid
Tabel 1: Dokumendi muudatused......................................................................................................... 3
Tabel 2: Kasutatud nimeruumid ........................................................................................................... 4
Tabel 3: Väljastatavad teated ............................................................................................................. 13
-2/14-
0. Dokumendi muudatused
Tabel 1: Dokumendi muudatused
Aeg Koostaja Muudatused
15.05.2012 H.Vainsalu Esialgne dokument
03.09.2012 H.Vainsalu Oluliselt täiendatud dokument
1.12.2012 S.Vilba Täpsustused esmatestimiselt
18.3.2013 S.Vilba Veateadete realisatsiooniga vastavusse viimine.
19.03.2013 H.Vainsalu Väiksemad täpsustused
12.04.2013 S.Vilba Retsepti detailandmete kuvamise teenuse täiendused –
äriregistrikoodi lisamine raviasutusele ja apteegile,
med.seadme segmendi väljastamine ainult med.seadme
retseptile, patsiendi riik mittekohustuslik.
27.02.2014 S.Vilba retseptideVaatamine teenuse täienduste kirjeldamine
15.07.2016 D.Andrijevski retseptideVaatamine teenuse muudatuste kirjeldamine,
dokumendi korrastamine ja kujundamine
26.03.2018 L.Kruus, D. Andrijevski retseptideVaatamine vastuses täiendatud annustamis–
skeemi, lisatud soodustuse komponendid sh TRH
-3/14-
1. Dokumendist
1.1. Eesmärk
Kirjeldada X-tee teenuseid, mille kaudu on õigustatud osapoolel võimalik Retseptikeskust oluliselt
mõjutamata saada informatsiooni kõigi retseptide kohta. Retseptide kohta esitatakse infot läbi ajas
muutunud retseptide pärimise ning alates dokumendi versioonist 2 ka läbi retseptideVaatamine
teenuse täiendatud sisendite.
1.2. Dokumendi lugemiseks
Esimese peatükis on kirjeldatud dokumendi lugemisega seotud abiinfo.
Teine peatükk kirjeldab teenuseid. Esmalt on välja toodud teenuste põhimõtted, seejärel viited
kasutatavatele loenditele ja seejärel lahti kirjutatud üksikud teenused.
Teenuse kirjeldamisel on lahti kirjutad teenuses sisend, väljund ja reeglid. Sisendi ja väljundi puhul
ei ole eesmärk edasi anda teenuse kogu täpset struktuuri, vaid päringu või vastuse olulist osa (vastuses
peegeldatavat päringut ei ole kirjeldatud).
Sõnumite struktuur on kirjeldatud hierarhiliselt numereerimata loeteluga. Iga taane tähendab XML
kontekstis alamelementi. Elemendi kirjeldusel on kasutatud järgmist malli:
elemendiNimetus [nimeruumiPrefiks':'andmetüübiNimetus] [ '[' kordsuseAlumineRada
'...' kordsuseÜlemineRada ']' ] [ 'default' vaikeväärtus ] ['-' kirjeldus]
Andmetüüpi ei ole esitatud kui see ei ole teada, või kui tegu on mitmetasemeliselt kirjeldatud
kompleksandmetüübiga.
Kordsust ei ole esitatud, kui see on rangelt üks.
Kirjeldus on lisatud, kui elemendis nimest või ülemelementidest ei ole võimalik elemendi tähendust
ja konteksti välja selgitada.
1.3. Kasutatud nimeruumid
Tabel 2: Kasutatud nimeruumid
Tähis Nimeruum
rts http://producers.rets.xtee.riik.ee/producer/rets
xsd http://www.w3.org/2001/XMLSchema
xsi http://www.w3.org/2001/XMLSchema-instance
xtee http://x-tee.riik.ee/xsd/xtee.xsd
-4/14-
2. Liidese kirjeldus
Liidesed on realiseeritud X-tee'l rets andmekogus sünkroonsete teenustena.
Liidese idee on võimaldada leida esmalt muutunud dokumendi numbrite pärimise teel dokumentide
koguhulk tarbijat huvitavas ajavahemikus, ning seejärel tarbija ja pakkuja aspektist efektiivseimal
(vajadusel ka mitterelevantseid dokumente kõrvale jättes) ja töökindlamal moel laadida andmed
tarbija infosüsteemi.
Iga retsepti muudatusega salvestatakse retsepti dokumendile muudatuse kuupäev, mille järgi antud
päring töötab. Muudatuste kuupäevadest ajalugu ei peeta – andmed ei ole kujul, mis võimaldaks saada
ühte retsepti muudatuse päringusse rohkem kui ühel kuupäeval.
Alates versioonist 2 on võimalik pärida dokumentide andmeid ka ilma muudatuse teenust kasutamata
otse retseptideVaatamine teenuse isikupõhiste sisendväljade abil.
2.1. Viited kasutatud loenditele
1. Veateated – antud dokumendis ptk 2.4.
2. Veateadete tüübid - http://pub.e-tervis.ee/classifications/ER_Veat%C3%BC%C3%BCbid
3. Retsepti liik - http://pub.e-tervis.ee/classifications/ER_Retsepti%20liik
4. Retsepti staatus - http://pub.e-tervis.ee/classifications/ER_Retsepti%20staatused
5. Volituse liik - http://pub.e-tervis.ee/classifications/ER_Volituse%20liik
6. Riikide ja territooriumite loend - http://pub.e-tervis.ee/classifications/RTK
7. RHK-10 - http://pub.e-tervis.ee/classifications/RHK-10
8. ATC - http://pub.e-tervis.ee/classifications/ATC
9. Ravimiameti koodikeskuse hallatav toimeainete loend, teenus koodikeskus.toimeained.
http://koodikeskus.ravimiamet.ee/Docs/X-tee_liidestusjuhend.pdf
10. Ühikud - http://pub.e-tervis.ee/classifications/ER_%C3%9Chikud
11. Ravimiameti Koodikeskuses hallatav ravimvormide loend, teenus koodikeskus.ravimvorm.
http://koodikeskus.ravimiamet.ee/Docs/X-tee_liidestusjuhend.pdf
12. Soodusmäärad
http://pub.e-tervis.ee/classifications/ER_Soodustuse%20m%C3%A4%C3%A4r
13. Retsepti kordsus http://pub.e-tervis.ee/classifications/ER_Retsepti%20kordsus
14. Retsepti annulleerimise põhjuse koodid
http://pub.e-tervis.ee/classifications/ER_Annulleerimise%20põhjendused
15. Preparaadipõhise retsepti asendamatuse põhjuse koodid
http://pub.e-tervis.ee/classifications/ER_Asendamatuse%20põhjus
16. Müügiloata ravimi müügitaotluse põhjuse kood
http://pub.e-tervis.ee/classifications/ER_Müügiloata%20taotluse%20põhjendus
17. Müügiloata ravimi müügitaotluse menetlemise otsus
http://pub.e-tervis.ee/classifications/ER_Müügiloata%20otsus
18. Müügiloata ravimi taotluse negatiivse otsuse põhjendus
http://pub.e-tervis.ee/classifications/ER_Negatiivse%20otsuse%20põhjendus
-5/14-
19. Ravikuuri tüüp http://pub.e-tervis.ee/classifications/ER_Ravikuuritüüp
20. Annustamise ühik http://pub.e-tervis.ee/classifications/ER_Ühikud%20annustamine
21. Annustamise ajaühik http://pub.e-tervis.ee/classifications/ER_Ühikud_aja
2.2. Teenus rets.muutunudRetseptideLoetelu
Teenus mingil kuupäeval muutunud dokumentide identifikaatorite leidmiseks.
2.2.1.Sisend
xtee:asutus – X-tee päise väli
xtee:isikukood – X-tee päise väli
xtee:allasutus [0..1] – X-tee päise väli
muudatuseAeg xsd:date – kuupäev, millal toimunud muudatusi küsitakse
leheNumber xsd:int, default 1 – mitmendat lehekülge kogu andmete hulgast päritakse
2.2.2.Väljund
teated [0..1]
teade [0..unbounded]
tyyp xsd:string – vaata ptk 2.1 element 2
klass xsd:string – vaata ptk 2.4 veerg klass.
number xsd:string – vaata ptk 2.4 veerg kood.
tekst xsd:string – vaata ptk 2.4 veerg kood.
leheInfo – tagastatava lehekülje info
leheNumber xsd:int – tagastatava lehekülje number.
lehtedeArv xsd:int – kogu vastuse näitamise vajalik lehekülgede arv.
leheSuurus xsd:int – ühel lehel näidatavate ridade arv.
retseptideNumbrid [0..1]
retseptiNumber xsd:string[1..unbounded] – retsepti number
2.2.3.Reeglid
Mittefunktsionaalsed reeglid:
• Teenuse on piiranguteta avatud väljaspool tööaega (19:00 – 07:00), muul ajal teenust kasutada
ei tohi ning teenuse pakkuja jätab endale õiguse kokkulepet kuritarvitava osapoole õigused
teenusele tühistada.
Funktsionaalsed reeglid:
• Kui mõni päringus nõutud sisendväljadest on puudu, siis teatakse asjakohane teade ZDR-101.
• Pärimisel leitakse antud kuupäeval muudetud retseptide hulk (ravimiretseptid ja
meditsiiniseadme retseptid), jaotatakse lehtedeks (lehe suurus on süsteemis seadistatud, et
tagada teenuse parim jõudlus. Teenuse kasutajale tagastatakse küsitud lehel asuvate retseptide
numbrid alati samas järjekorras.
• Kui lehekülje numbrit ei ole määratud, siis tagastatakse esimene lehekülg.
-6/14-
• Kui lehekülje number on suurem kui antud kuupäeva kohta kogu lehtede arv, siis tagastatakse
asjakohane teade ZDR-102.
• Kui väljas muudatuseAeg on väärtus, mis on suurem eilsest (päringu töötlemise hetkel)
kuupäevast, siis tagastatakse viga ZDR-103.
2.3. Teenus rets.retseptideVaatamine
Teenus, mille abil on õigustatud osapoolele võimalik pärida hulga retseptide detailandmed retseptide
numbrite abil või isikukoodi, retseptid väljastamise kuupäevade ja staatuste sisendite abil isikukohase
retseptide detailandmetena.
2.3.1.Sisend
xtee:asutus – X-tee päise väli
xtee:isikukood – X-tee päise väli
xtee:allasutus [0..1] – X-tee päise väli
retseptideNumbrid[0..1]
dokumendiNumber rts:retseptinumberType[0..unbounded]
isikukood rts:isikukoodType[0..1]
valjakirjutamiseAeg rts:ajavahemikType[0..1]
alates xsd:date
kuni xsd:date[0..1]
staatused[0..1]
staatus rts:staatusType[0..unbounded]
2.3.2.Väljund
teated [0..1]
teade [0..unbounded]
tyyp xsd:string – vaata ptk 2.1 element 2
klass xsd:string – vaata ptk 2.4 veerg klass.
number xsd:string – vaata ptk 2.4 veerg kood.
tekst xsd:string – vaata ptk 2.4 veerg kood.
retseptid [0..1]
retsept [0..unbounded]
yldine – retsepti üldandmed
retseptiNumber xsd:string – retsepti unikaalne identifikaator.
paberRetseptiNumber rts:retseptinumberType[0..1] – apteegis digitaliseeritud
retsepti puhul
retseptiLiik rts:retseptiLiikType – vaata ptk 2.1 element 3
koostamiseAeg xsd:dateTime – retsepti loomise aeg / kehtivuse algus.
sisestamiseAeg xsd:dateTime – retsepti sisestamise aeg, oluline digitaliseeritud
paberretsepti puhul.
-7/14-
kehtivKuni xsd:date – retsepti kehtivuse lõpp.
staatus rts:staatusType – vaata ptk 2.1 element 4
volitatus rts:volitusLiikType – vaata ptk 2.1 element 5
annulleerimisePohusKood annulleerimisePohjusKoodType[0..1] – annulleeritud
retseptile märgitud arsti poolne põhjendus koodina, vaata ptk 2.1 element 14
annulleerimiseAeg xsd:date[0..1] –retsepti annulleerimise kuupäev
kordsus rts:retseptiKordsusType[0..1] – vaata ptk 2.1 element 13
müügiluba rts:myygilubaType[0..1] – müügiloata ravimi müügi taotlemise info
taotluse_pohjus_kood rts:mlTaotlusePohjusKoodType – vt ptk 2.1 element 16
otsuse_pohjus_kood rts:mlOtsusePohjusKoodType[0..1] – vt. ptk 2.1 element
18
otsuse_kood rts:mlOtsusOtsusKoodType[0..1] - vt. ptk 2.1 element 17
otsuse_number xsd:string[0..1]
otsuse_kuupaev xsd:date[0..1]
isikud
patsient
riik rts:riikType[0..1] – isikukoodiga seotud riik alpha-3 formaadis. Vt ptk 2.1
element 6
isikukood rts:isikukoodType – patsiendi identifikaator ilma riigi koodita.
eesnimed xsd:string[0..1]
perenimi xsd:string[0..1]
synniaeg xsd:date[0..1]
aadress xsd:string
kindlustatus – patsiendi ravikindlustuse info
kindlustatud xsd:boolean – eesti ravikindlustus
eu_kindlustatud xsd:boolean – ravikindlustus EU riigist
toovoimetus xsd:boolean – kindlustatud töövõimetuna
vanaduspension xsd:boolean – kindlustatud vanaduspensionärina
koostaja
juriidilineIsik – tervishoiuteenuse osutaja või perearsti praksis
ariregistriKood rts:jurIsikuKoodType – tervishoiuteenuse osutaja
äriregistrikood või perearsti registreerimise number
nimi rts:jurIsikuNimiTyp[0..1] - tervishoiuteenuse osutaja nimi
tegevusloaNumber rts:ttoKoodType[0..1] – Terviseameti poolt väljastatud
tegevusloa number või arsti registreerimise number kui koostajaks on perearst ja retsept on koostatud
enne perearstidele tegevuslubade väljastamist.
fyysilineIsik – retsepti koostanud arst
tervishoiutootajaRegNumber rts:arstiRegNumType
-8/14-
erialaKood rts:arstiErialaType[0..1] – retsepti koostamisel kasutatud
eriala tunnus
kontakt xsd:string[0..1] – arsti kontakttelefon
nimi xsd:string[0..1] – arsti nimi
email rts:emailType[0..1]– arsti e-mail aadress
valjastaja [0..1]
juriidilineIsik - apteek
ariregistriKood rts:jurIsikuKoodType – apteegi äriregistrikood
tegevusloaNumber xsd:string[0..1] – tegevusloa number
tegevuskohaNumber rts:apteekTegevuskohaKoodType – tegevuskoha number,
kus ravim väljastati
tegevuskohaNimi xsd:string[0..1] – tegevuskoha nimetus
fyysilineIsik – proviisor või farmatseut
apteeker rts:proviisorKoodType – proviisori või farmatseudi registreeringu
number
apteekriNimi xsd:string[0..1] – proviisori või farmatseudi nimi
ostja [0..1] – retsepti ostnud isiku info
riik rts:riikType[0..1] – ostja isikukoodi väljastanud riik
isikukood rts:isikukoodType – ostja isikukood
maaratudRavi
diagnoos rts:diagnoosiKoodType – vaata ptk 2.1 element 7
toimeained – määratud toimeained
toimeaine [1..unbounded]
jarjekorraNumber xsd:nonNegativeInteger
toimeaineKood rts:toimeaineKoodType - vaata ptk 2.1 element 9
toimeaineNimi rts:toimeaineNimiType[0..1] – toimeaine koodile vastav
nimetus
sisaldus
arv rts:toimeaineSisaldusType – toimeaine ühikute arv
yhik rts:toimeaineYhikType - vaata ptk 2.1 element 10
konsentratsioon – vedelate (ravimvorm on siis lahus, kreem, emulsioon, geel
jne) puhul
arv rts:toimeaineSisaldusType - toimeaine mahu sisaldus ehk nt 10
mg X ml
yhik rts:toimeaineYhikType - vaata ptk 2.1 element 10
atcKood rts:ATCKoodType[0..1] - vaata ptk 2.1 element 8
atcNimi rts:ATCNimetusType[0..1] – ATC koodile vastav nimetus
ravimvorm rts:ravimvormKoodType[0..1] - vaata ptk 2.1 element 11,
-9/14-
meditsiiniseadme retsepti puhul meditsiiniseadme rühm
ravimvormiNimetus rts:ravimvormNimetusType[0..1] – koodile vastav ravimvormi
nimetus
preparaadiInfo [0..1]
preparaadiKood rts:preparaatKoodType – Koodikeskuse poolt väljastatav
pakendi kood
preparaatNimetus rts:preparaatNimetusType[0..1] – koodile vastav
preparaadi nimetus
kogus rts:ravimikogusType - pakendi kohta, mitu pakendit (nt „arv:5, yhik:tk“):
arv rts:yhikute_kogusType
yhik rts:yhikType - vaata ptk 2.1 element 10
asendamatusePohjusKood rts:asendamatusePohjusKoodType – arsti poolt
lisatud põhjendus pakendi asendmatuse kohta, vt. ptk 2.1 element 15
yhikuKogus – pakendipõhise ravimi korral ühe pakendi sisalduse kirjeldus (nt 40 tabletti
pakendis on „arv: 40, yhik: tk“), toimeainepõhise retsepti korral määratud kogu ravimi hulk (nt kui
toimeaine sisaldus on 200mg, siis kümnekordse annuse jaoks „arv: 2000, yhik: mg“):
arv rts:yhikute_kogusType
yhik rts:yhikType - vaata ptk 2.1 element 10
yhikute_maht [0..1] – taara suurus vedela (ravimvorm on siis lahus, kreem, emulsioon,
geel jne) ravimi puhul:
arv rts:yhikute_kogusType
yhik rts:yhikType - vaata ptk 2.1 element 10
ekstemporaalseRavimiKirjeldus rts:selgitusType[0..1] – ekstemporaalse ravimi
kirjeldus
selgitused rts:selgitusType [0..1] – koostaja poolt sisestatud täiendavad selgitused
meditsiiniseadmeKaart [0..1] - MS retsepti puhul MS kaardi info
msKaartNumber xsd:string
limKoguseTyyp xsd:string – limiitkoguse tüüp (1, 6 või 12)
limKogus xsd:integer – limiitkoguse maksimum määr
jaak xsd:integer – kasutamata jääk antud limiidi kogusest
limAlgus xsd:date – aeg millest alates antud limiidi kogust arvestatakse
limLopp xsd:date – aeg milleni antud limiidi kogust arvestatakse
msKaartAlgus xsd:date – aeg millest alates kaart kehtib
msKaartLopp xsd:date – aeg milleni kaart kehtib
hyvitamisTingimus xsd:string – MS hüvitamise tingimuse kood
annustamine [0..1] – ravimi annustamise juhend. Näiteks „2 tabletti 3 korda päevas 2
nädala jooksul“ vastab väljade mustrile: „{tykke} {tykke_yhik} {kordi} korda {ajayhik}
{ravikuuri_pikkus} päeva jooksul“.
ravikuuri_tyyp xsd:string[0..1] – vt Error! Reference source not found.;
-10/14-
ravikuuri_pikkus xsd:integer[0..1] – ravikuuri pikkus päevades;
tykke xsd:decimal[0..1] – ravimi kogus mida tuleb kasutada ühe kasutus-
korra ajal;
tykke_yhik xsd:string[0..1] - vt Error! Reference source not found.;
kordi xsd:integer[0..1] – mitu korda intervallis tuleb ravimit kasutada;
ajayhik xsd:string[0..1] – vt Error! Reference source not found.;
hommik xsd:boolean[0..1] – manustada hommikul;
louna xsd:boolean[0..1] – manustada lõuna ajal;
ohtu xsd:boolean[0..1] – manustada õhtul;
oo xsd:boolean[0..1] – manustada öösel;
periood xsd:integer[0..1] – annustamisskeemi perioodi pikkus, kui
skeem on ajaliselt piiratud;
lisaread [0..1] – keerulise annustamisskeemi puhul lisaread;
item [0..unbounded] – annustamisskeemi lisarida;
jrk_number xsd:integer – lisarea järjekorranumber;
tykke xsd:decimal[0..1] – ravimi kogus mida tuleb kasutada ühe
kasutuskorra ajal;
tykke_yhik xsd:string[0..1] - vt Error! Reference source not
found.;
kordi xsd:integer[0..1] – mitu korda intervallis tuleb ravimit ka-
sutada;
ajayhik xsd:string[0..1] – vt Error! Reference source not
found.;
hommik xsd:boolean[0..1] – manustada hommikul;
louna xsd:boolean[0..1] – manustada lõuna ajal;
ohtu xsd:boolean[0..1] – manustada õhtul;
oo xsd:boolean[0..1] – manustada öösel;
periood xsd:integer[0..1] – annustamisskeemi perioodi pikkus,
kui skeem on ajaliselt piiratud;
soodusmaar rts:soodusmaarType[0..1] – ravi määramisel leitud suurim lubatud
soodusmäära väärtus
meditsiinilisedTingimused xsd:string[0..1] – kõrgema soodusmäära jaoks vajalikud
rakenduvad meditsiinilised tingimused
valjastatud [0..1] – apteegis väljastatud ravimi info
atcKood rts:ATCKoodType[0..1] - vaata ptk 2.1 element 8
atcNimi rts:ATCNimetusType[0..1] – ATC koodile vastav nimetus
ravimvorm rts:ravimvormKoodType[0..1] - vaata ptk 2.1 element 11,
meditsiiniseadme retsepti puhul meditsiiniseadme rühm
ravimvormiNimetus rts:ravimvormNimetusType[0..1] – koodile vastav ravimvormi
-11/14-
nimetus
preparaadid
valjastatudPreparaadid [1..unbounded]
preparaadiKood rts:preparaatKoodType[0..1] – Koodikeskuse poolt
väljastatav pakendi kood
preparaatNimetus rts:preparaatNimetusType[0..1] – koodile vastav
preparaadi nimetus
preparaatideArv xsd:decimal – väljastatud preparaatide arv
yhikuKogus – ravimi kogus
arv rts:yhikute_kogusType
yhik rts:yhikType
yhikuteMaht [0..1] – taara suurus
arv rts:yhikute_kogusType
yhik rts:yhikType
ekstemporaalseRavimiKirjeldus xsd:string[0..1]
soodusmaar rts:soodusmaarType - vaata ptk 2.1 element 12
meditsiinilisedTingimused xsd:string[0..1]
originaaliHind [0..1] – ühe preparaadi/pakendi hind.
hind rts:hindType
valuuta rts:valuutaType – WSDLis defineeritud loetelu
soodustatudSumma [0..1]– patsiendile soodustatud summa
hind rts:hindType
valuuta rts:valuutaType
piirhind [0..1] – müügil rakendatud ühe pakendi piirhind
hind rts:hindType
valuuta rts:valuutaType
hinnakokkuleppeHind [0..1] – müügil rakendatud preparaadi
hinnakokkuleppehind
hind rts:hindType
valuuta rts:valuutaType
soodustused [0..1] – retsepti müügil rakendatud soodustuse komponendid
sood_pohi xsd:decimal – põhisoodustuse summa soodusmäära alusel
sood_trh xsd:decimal[0..1] – TRH lisasoodustuse summa
sood_trh_jaak xsd:decimal[0..1] – kasutatud TRH jäägi osa
sood_kokku xsd:decimal – kõigi soodustuste summa
sood_valuuta rts:valuutaType – soodustussummade valuuta
valjastamiseAeg xsd:date – ravimi realiseerimise ja väljastamise kuupäev.
-12/14-
2.3.3.Reeglid
Funktsionaalsed reeglid:
• Retseptid, mille kohta infot tagastatakse, antakse informatsiooni päringu tegemise hetkel
kehtiva sisuga.
• Väljastatakse ainult oluline osa – kõiki klassifikaatoritele ja koodidele vastavaid
informatiivseid tekste/silte, mis tuginevad mingitele avalikel loenditele, ei väljastata antud
teenuses. Teenuses ei garanteerita siltide ajakohasust või vastavust väliselt hallatavatele ja
muutunud loenditele.
• Sisendparameetritest on kohustuslik kas küsitavate retseptide nimekiri või isikukood, kelle
retsepte päritakse. Kui on antud isikukood, saab lisaks sellele filtreerida ka alguse ja lõpu
kuupäevade ja/või staatuse järgi.
• Retsepti jälgimise logisse lisatakse kirje, kus märgitakse ära päring sooritaja andmed.
• Kui päringut ei jõuta tervenisti teenindada, siis mitte tagastatud retseptide kohta tagastatakse
asjakohane veateade ZDR-104.
2.4. Teated
Tabel 3: Väljastatavad teated
Klass Kood Sõnum Selgitus
ZDR 101 Päring ei ole korrektne. Puudub väärtus väljas %.
ZDR 102 Küsitud lehekülge % ei eksisteeri.
ZDR 103 Küsitud kuupäeva kohta muudatuste infot ei väljastata.
ZDR 104 Retseptist &1 alates andmeid ei tagastata. Vastuse
koostamine aeganõudev.
ZDR 105 Retsepti &1 sisu ei tagastata. Palun pärige Teade rakendub Digiretsepti
hiljem uuesti. süsteemisiseste vigade
tekkimisel.
-13/14-
3. Näited
Näited on esitatud lihtsustatud moel. Nimeruumide deklaratsioonid on välja jäetud ja kasutatud on
peatükis 1.3. esitatud nimeruumi prefikseid.
Teenuse muutunudRetseptideLoetelu kasutamine:
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<xtee:asutus xsi:type="xsd:string">74000091</xtee:asutus>
<xtee:andmekogu xsi:type="xsd:string">rets</xtee:andmekogu>
<xtee:isikukood xsi:type="xsd:string">EE45602116578</xtee:isikukood>
<xtee:id xsi:type="xsd:string">8bca19b87fe972afaafa72106491073a</xtee:id>
<xtee:nimi xsi:type="xsd:string">rets.muutunudRetseptideLoetelu.v1</xtee:nimi>
<xtee:autentija xsi:type="xsd:string">M-ID</xtee:autentija>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<rets:muutunudRetseptideLoetelu>
<keha xsi:type="rets:muutunudRetseptideLoeteluRequestType">
<muudatuseAeg xsi:type="xsd:date">2016-06-01</muudatuseAeg>
<leheNumber xsi:type="xsd:int">3</leheNumber>
</keha>
</rets:muutunudRetseptideLoetelu>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Teenuse retseptideVaatamine kasutamine:
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<xtee:asutus xsi:type="xsd:string">74000091</xtee:asutus>
<xtee:andmekogu xsi:type="xsd:string">rets</xtee:andmekogu>
<xtee:isikukood xsi:type="xsd:string">EE45602116578</xtee:isikukood>
<xtee:id xsi:type="xsd:string">8bca19b87fe972afaafa72106491073a</xtee:id>
<xtee:nimi xsi:type="xsd:string">rets.retseptideVaatamine.v1</xtee:nimi>
<xtee:autentija xsi:type="xsd:string">M-ID</xtee:autentija>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<rets:retseptideVaatamine>
<keha xsi:type="rets:muutunudRetseptideLoeteluRequestType">
<retseptideNumbrid>
<dokumendiNumber>3020925898</dokumendiNumber>
<dokumendiNumber>3020927305</dokumendiNumber>
<dokumendiNumber>3021401879</dokumendiNumber>
</retseptideNumbrid>
</keha>
</rets:retseptideVaatamine>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
-14/14-