Info edastamine

.09.2019 nr 3-23/30491 Hea partner, Vastavalt ravi rahastamise lepingu üldtingimustele teavitame raviarvete edastamise tehnilise lahenduse muutmisest. Alates 2020. aasta jaanuarist ei ole võimalik kasutada raviarvete edastamiseks vana nn TORU lahendust. Kasutusele tuleb uus raviarvete edastamise lahendus. Kõik 2019. aasta eest esitatavad arved tuleb 2020. aasta alguses edastada meile veel vana TORU lahenduse kaudu ning 2020. aasta arved juba uut lahendust kasutades. Haigekassa alustas uue raviarvete edastamise lahenduse kasutamise piloteerimist koostöös Tartu Ülikooli Kliinikumiga septembris. Kliinikum on meile edastanud kõik 2019. II poolaasta arved uue lahenduse kaudu ning uue süsteemi kasutamine on olnud edukas. Võrreldes TORU süsteemiga oleme uues süsteemis teinud mõned muutused. Uues lahenduses ei saadeta koondarveid vaid raviarveid ning koondarved moodustatakse haigekassa poolt. Oleme mõningal määral muutnud raviarve formaati ning ühildanud raviarve väljade formaate tervise infosüsteemi loenditega. Raviarvete edastamisel toimub automaatne lepingu kontroll. Muudatuste kohta saab täpsemalt lugeda teenusekirjeldusest, mis on kirjale lisatud eraldi dokumendina (teenused on kirjeldatud KIRST andmekogu WSDL-is arendus ja testkeskkonnas). Oleme infosüsteemi muudatuste info edastanud ka arendajatele, nad on uuenduse vajalikkusest ning tähtajast teadlikud. Julgustame kõiki testima, et tagada sujuv üleminek uue aasta algusest. Testkeskkonnale ligipääsuks palun edastage info, mis asutusega hakatakse testima (teenuse osutaja või arendaja). Selle info põhjal lisame testsüsteemi lepingute andmed, et tagada ladus testimine. Palume seda infot mõnepäevase etteteatamisega enne testimise alustamist töö sujuvaks toimimiseks. Eesti Haigekassa poolt on projekti kontaktisikuks Riho Peek, kelle poole võite pöörduda kõigis projekti puudutavates küsimustes (kontaktid on - [email protected] , telefon 6 208 347/ 50 43 938). Lugupidamisega (allkirjastatud digitaalselt) Pille Banhard Juhatuse liige  - Eesti Haigekassa Kindlustatud Isikute Register Raviarvete ja lepingute andmevahetusteenused Teenuste „kirst.rta_saatmine.v1“, „kirst.rta_tyhistus.v1“, "kirst.rta_detail.v1", "kirst.rta_koond_arve_info.v1","kirst.leping.v1", "kirst.leping_rahaline_lisa.v1" „kirst.leping_ettepanek_vaatamine.v1“, „kirst.leping_ettepanek_saatmine.v1“, "kirst.leping_ettepanek_logi.v1" kirjeldused Sisukord Dokumendi versioonid ........................................................................................................... 4 1 Dokumendist ....................................................................................................................... 6 1.1 Eesmärk ....................................................................................................................... 6 1.2 Kasutatud nimeruumid ................................................................................................ 6 1.3 Kasutatud lühendid ...................................................................................................... 6 1.4 Viited ........................................................................................................................... 6 1.5 Loendid ........................................................................................................................ 6 1.5.1 Rahastamise allikas .................................................................................................. 6 1.5.2 Lepingu eriala .......................................................................................................... 7 1.5.3 Patsiendi sugu .......................................................................................................... 9 1.5.4 Väljastanud arsti eriala ............................................................................................. 9 1.5.5 Tervishoiuteenuse tüüp ............................................................................................ 9 1.5.6 Saabumise liik .......................................................................................................... 9 1.5.7 Diagnoosi liigid ........................................................................................................ 9 1.5.8 Diagnoos ................................................................................................................ 10 1.5.9 Välispõhjus ............................................................................................................ 10 1.5.10 Teenuse tunnus ....................................................................................................... 10 1.5.11 DRG erand ............................................................................................................. 10 1.5.12 Arve lõpetamise põhjus .......................................................................................... 10 1.5.13 Raskusaste .............................................................................................................. 10 1.5.14 Riigi kood............................................................................................................... 11 1.5.15 Isikut tõendava dokumendi liigid........................................................................... 11 1.5.16 Hamabavalem ........................................................................................................ 11 1.5.17 DMFT indeks ......................................................................................................... 11 1.5.18 Raviarve olek ......................................................................................................... 11 1.5.19 Lepingu koefitsiendi liik ........................................................................................ 12 1.5.20 Raviarve tühistamise põhjus .................................................................................. 12 1.5.21 Lepingu versioon ................................................................................................... 12 1.5.22 Lepingu liik ............................................................................................................ 12 1.5.23 Poolaasta ................................................................................................................ 12 1.5.24 Arveldusdokumendi tüüp ....................................................................................... 13 1.5.25 Teate tüüp............................................................................................................... 13 1.5.26 Lepingu rahalise lisa teenuste grupp ...................................................................... 13 1.5.27 Rahalise lisa ettepaneku põhjus ............................................................................. 13 1.5.28 Rahalise lisa ettepaneku otsus ................................................................................ 13 1.5.29 Rahalise lisa ettepaneku staatus ............................................................................. 14 2 Üldprotsess ........................................................................................................................ 15 2.1 Raviarvete andmevahetus .......................................................................................... 15 2.2 Lepingu haldus .......................................................................................................... 16 3 Teenuse kirst.rta_saatmine kirjeldus ................................................................................. 17 3.1 Sisend......................................................................................................................... 17 3.1 Väljund ...................................................................................................................... 19 3.2 Reeglid ....................................................................................................................... 20 4 Teenuse kirst.rta_tyhistus kirjeldus .................................................................................. 22 4.1 Sisend......................................................................................................................... 22 4.2 Väljund ...................................................................................................................... 22 4.3 Reeglid ....................................................................................................................... 22 2/40  4.4 Teated ........................................................................................................................ 22 5 Teenuse kirst.rta_detail kirjeldus ...................................................................................... 23 5.1 Sisend......................................................................................................................... 23 5.2 Väljund ...................................................................................................................... 23 5.3 Reeglid ....................................................................................................................... 26 5.4 Teated ........................................................................................................................ 26 6 Teenuse kirst.rta_koond_arve_info kirjeldus .................................................................... 27 6.1 Sisend......................................................................................................................... 27 6.2 Väljund ...................................................................................................................... 27 6.3 Reeglid ....................................................................................................................... 28 6.4 Teated ........................................................................................................................ 28 7 Lepinguandmete päring kirst.leping ................................................................................. 30 7.1 Sisend......................................................................................................................... 30 7.2 Väljund ...................................................................................................................... 30 7.3 Reeglid ....................................................................................................................... 30 7.4 Vead ........................................................................................................................... 31 8 Rahalise lisa andmete päring kirst.leping_rahaline_lisa ................................................... 32 8.1 Sisend......................................................................................................................... 32 8.2 Väljund ...................................................................................................................... 32 8.3 Reeglid ....................................................................................................................... 33 8.4 Vead ........................................................................................................................... 33 9 Rahalise ettepanekute päring kirst.leping_ettepanek_vaatamine...................................... 34 9.1 Sisend......................................................................................................................... 34 9.2 Väljund ...................................................................................................................... 34 9.3 Reeglid ....................................................................................................................... 35 9.4 Vead ........................................................................................................................... 36 10 Rahalise ettepanekute saatmine kirst.leping_ettepanek_saatmine ................................ 37 10.1 Sisend ..................................................................................................................... 37 10.2 Väljund ................................................................................................................... 37 10.3 Reeglid ................................................................................................................... 37 10.4 Teated ..................................................................................................................... 38 11 Rahalise ettepanekute logi kuvamine kirst.leping_ettepanek_logi ............................... 39 11.1 Sisend ..................................................................................................................... 39 11.2 Väljund ................................................................................................................... 39 11.3 Reeglid ................................................................................................................... 40 11.4 Vead ....................................................................................................................... 40 3/40 Dokumendi versioonid Versioon Aeg Koostaja Olulised muudatused 1.0 06.09.2017 Mario Maisto Esialgne dokument 1.1 08.09.2017 Mario Maisto Lisatud väli ’välispõhjus’ 1.2 11.09.2017 Mario Maisto Eemaldatud xsd:choice (teenus/tühistus) 1.3 09.10.2017 Mario Maisto Muudetud päringu ning vastuse struktuur, lahutatud teenus kaheks erinevaks teenuseks. 1.4 10.10.2017 Mario Maisto Muudetud vastuste päise väljad: raviarveDokumentVastus, raviarveTyhistusVastus. Uuendatud wsdl failid. 1.5 01.12.2017 Mario Maisto Täiendatud struktuuri – lisatud massiivid, täpsustatud andmetüüpe ja nimetusi 1.6 04.12.2017 Mario Maisto Emo kood kui ainult märge, eemaldatud väli akronyym 1.7 05.03.2018 Seidi Vilba Täiendused väljade seletuste osas, lisatud ptk loendid, arvele lisatud lepinguPartner 2 04.05.2018 Seidi Vilba Lisatud uued teenused koondarve ja detailvaate jaoks. 2.1 24.05.2018 Mario Maisto Lisatud veateated raviarve tühistamise päringule 3 27.07.2018 Seidi Vilba Lisatud lepingu ja lepingu rahalise lisa teenused 3.1 01.10.2018 Seidi Vilba Uuendatud teenuste sisendeid ja teenuste väljundites arveldusdokumentide info kuvamist. 3.2 15.11.2018 Mario Maisto Lepingu teenuste kirjeldustele lisatud veablokid. Rahaliste lisade teenuse vastusesse lisatud täitmise väljad. 3.3 20.11.2018 Mario Maisto Raviarve saatmise sisendisse lisatud kaks uut välja – saabusHaiglast ja liikusHaiglasse. Samad väljad + lepingupartner koos nimeliste vastetega lisatud ka raviarve detailandmete väljundisse. Koondarve info väljundisse lisatud lepingupartneri väljad. 3.4 29.11.2018 Riho Peek, Seidi Täiendatud lepingu erialade loendit, Vilba leping_rahaline_lisa teenusele lisatud täiendavad selgitused teenuse kasutamise osas. 3.5 17.04.2019 Seidi Vilba Loend poolaasta täiendatud väärtusega Y, andmetüüp String, Loendit lepingu rahaliste teenuste grupp täiendatud väärtusega G. Lisatud Rahalise lisa ettepanekute loendid ja teenused. 3.6 23.05.2019 Mario Maisto Täpsustatud teenuse kirst.rta_koond_arve_info kirjeldust ja reegleid 3.7 28.05.2019 Mario Maisto Teenuses kirst.leping_ettepanek_vaatamine – lisatud pakkumuses väli rjProtsent1Pa 3.8 19.06.2019 Seidi Vilba Täiendatud üldprotsessi ja rta saatmise reegleid. Tehtud muudatused teenuses kirst.leping_ettepanek_saatmine: 4/40  3.9 14-23.08.2019 Seidi Vilba Teenust koond_arve_info täiendatud väljaga perioodiarved, lisatud teenusele täiendavad ärireeglite selgitused. Element raviteenuseTyyp nimetus muudetud lepTeenuseGrupp, täiendatud Tervishoiuteenuse tüüpide loendit ja lepingu rahalise lisa teenuse gruppide loendit ja lisatud vastavused tervishoiuteenuse tüüpide loendiga. Perioodiarvete pärimise täpsustamine teenuses koond_arve_info 03.10.2019 Seidi Vilba Lepingu erialade tabel täiendatud, lisatud perioodiarvetes esinevate lep. erialade tunnus ning lisatud arveldusdokumendi tüüpide loendisse PX. Tabel 1 Dokumendi versioonid 5/40 1 Dokumendist 1.1 Eesmärk Antud dokument kirjeldab EHK Kindlustatud Isikute Registri (edaspidi: Registri) raviarvete ja lepinguandmete haldamise X-tee liideseid. 1.2 Kasutatud nimeruumid Tabel 2 Kasutatud nimeruumid Tähis Nimeruum ehk http://producers.kirst.xtee.riik.ee/producer/kirst SOAP-ENC http://schemas.xmlsoap.org/soap/encoding/ SOAP-ENV http://schemas.xmlsoap.org/soap/envelope/ xsd http://www.w3.org/2001/XMLSchema xrd http://x-road.ee/xsd/x-road.xsd 1.3 Kasutatud lühendid EHK – Eesti Haigekassa TTO – Tervishoiuteenuse osutaja, raviasutus EHAK - Eesti haldus- ja asustusjaotuse klassifikaator RTA – raviarve RRL – Ravi rahastamise leping ÜRL – Üldarstiabi rahastamise leping DRG – Diagnose Related Grouping, https://www.haigekassa.ee/partnerile/raviasutusele/tervishoiuteenuste-loetelu/drg NCSP - NOMESCO kirurgiliste protseduuride klassifikatsioon DMFT - decayed, missing, and filled teeth – hammaste üldseisundit iseloomustav tunnus hambaravis 1.4 Viited • X-tee juhendid https://moodle.ria.ee/course/view.php?id=20 • Tervishoiutöötajate erialade loendina kasutatakse E-Tervise SA Publitseerimiskeskuses avaldatud tervishoiutöötajate erialade loetelu http://pub.e- tervis.ee/classifications/Erialad. Eriala tuleb edastada formaadis Ennn (näiteks: E300). • Ettevõtja ja tema kontaktisikute andmetega seotud teenused on kirjeldatud eraldi dokumendis. 1.5 Loendid 1.5.1 Rahastamise allikas Kood Selgitus RA Kindlustatud isiku eriarstiabi raviarve, RRL 6/40 MK Mittekindlustatud isiku raviarve (mittekindlustatute vältimatu abi) Eriarstiabi ja perearstiabi välismaalase raviarve (teises EL liikmesriigis VA kindlustatule vajaminev abi), RRL ja ÜRL OR Eriarstiabi ja perearstiabi 0-summaga raviarve, RRL ja ÜRL PA Kindlustatud isikud perearstiabi raviarve, ÜRL 1.5.2 Lepingu eriala Kood Selgitus Perioodiarve 71100001 Koolitervishoid X 71100004 Erivajadustega õpilaste koolitervishoid X 71100101 Noorte reproduktiivtervise arendamine 71100102 Rinnavähi varajane avastamine 71100103 Emakakaelavähi varajane avastamine 71100112 Soolevähi varajane avastamine 71200004 Lisatasu praksise paiknemisel 20-40 km kaugusel 71200005 Lisatasu praksise paiknemisel kaugemal kui 40 km 71200007 Baasraha X 71200008 Perearstide uuringufond 71200012 Perearsti tulemustasu 71200013 Tulemustasu 3.osa 71200014 Pearaha alla 3a kindlustatud isiku kohta X 71200015 Pearaha 3 kuni 7a kindlustatud isiku kohta X 71200016 Pearaha 7 kuni 50-a kindlustatud isiku kohta X 71200017 Pearaha 50 kuni 70-a kindlustatud isiku kohta X 71200018 Pearaha 70a ja vanema kindlustatud isiku kohta X 71200019 Lisatasu teise pereõe eest 71200020 Arsti ületunni tasu 71200021 Õe ületunni tasu 71200022 2. pereõe tulemustasu 71200023 Tegevuste fond 71200024 Perearsti teraapia fond 71300101 Üldkirurgia 71300102 Lastekirurgia 71300103 Neurokirurgia 71300104 Rindkerekirurgia 71300105 Kardiokirurgia 71300106 Uroloogia 71300107 Näo- ja lõualuukirurgia 71300109 Veresoontekirurgia 71300112 Organsiirdamised 71300201 Otorinolarüngoloogia 71300301 Neuroloogia 7/40 71300401 Oftalmoloogia 71300402 Katarakti operatsioonid 71300501 Ortopeedia 71300504 Endoproteesimised 71300601 Onkoloogia 71300703 Günekoloogia 71300705 Sünnitused 71300706 Viljatusravi 71300801 Pulmonoloogia 71300901 Dermatoveneroloogia 71301001 Pediaatria 71301101 Psühhiaatria 71301201 Infektsioonhaigused 71301301 Sisehaigused 71301302 Kardioloogia 71301303 Gastroenteroloogia 71301304 Endokrinoloogia 71301305 Hematoloogia 71301306 Nefroloogia 71301307 Kutsehaigused 71301308 Reumatoloogia 71301309 Hemodialüüs 71301401 Esmane järelravi 71301801 Ülikallis ravi 71301904 Valmisolekutasu X 71301905 Eriarstiabi kuutasu X 71400001 Taastusravi 71500001 Luuüdi transplantatsioon 71500003 Peritoneaaldialüüs 71500009 Noorsportlaste tervisekontroll 71500014 Kuulmisimplantatsioonid 71600002 Statsionaarne õendusabi 71600011 Koduõendus 71700001 Laste hambahaiguste ennetus ja ravi 71700003 Ortodontia 71700006 Täiskasvanute vältimatu hambaravi 71700009 Täiskasvanute plaaniline hambaravi 71700010 Valmisolekutasu (hambaravi) X 71700012 Elupuhune hambaravi 8/40 1.5.3 Patsiendi sugu Kood Selgitus M Mees N Naine 1.5.4 Väljastanud arsti eriala Tervishoiutöötajate erialade loendina kasutatakse E-Tervise SA Publitseerimiskeskuses avaldatud tervishoiutöötajate erialade loetelu http://pub.e-tervis.ee/classifications/Erialad. Eriala tuleb edastada formaadis Ennn (näiteks: E300). 1.5.5 Tervishoiuteenuse tüüp Kood Selgitus 1 ambulatoorne (v.a päevaravi ja päevakirurgia) 2 Statsionaarne 3 vältimatu hambaravi üle 19-aastastele 4 hambaravi alla 19-aastastele 10 hambaproteesimine alla 19-aastastele 11 ortodontia alla 19-aastastele 13 Koolitervishoid 14 ennetus (v.a koolitervishoid) 15 statsionaarne taastusravi 16 ambulatoorne taastusravi 17 perearsti ja pereõe teenused 18 iseseisev statsionaarne õendusabi 19 päevaravi ja päevakirurgia 20 Koduõendus 33 hambaravi vähemalt 19-aastastele 34 meditsiinilisel näidustusel üldanesteesias hambaravi 35 Elupuhune hambaravi 1.5.6 Saabumise liik http://pub.e-tervis.ee/classifications/Patsiendi%20p%C3%B6%C3%B6rdumise%20viis/2 Kood Selgitus 1 kiirabiga 2 tuli ise 3 tuli saatekirjaga 4 politseiga ja võrdsustatud asutuse poolt 9 muul viisil 1.5.7 Diagnoosi liigid Kood Selgitus 9/40 P Peamine ehk suurimat ravikulu kandev diagnoos K Täiendavad diagnoosid, mis ei ole välispõhjus või peamine diagnoos V Välispõhjus 1.5.8 Diagnoos Diagnooside esitamisel kasutatakse rahvusvahelist RHK-10 klassifikatsiooni. Klassifikaatori leiab E-tervise publitseerimiskeskusest: http://pub.e-tervis.ee/classifications/RHK-10/ 1.5.9 Välispõhjus Välispõhjuste esitamisel kasutatakse rahvusvahelist RHK-10 klassifikatsiooni. Klassifikaatori leiab E-tervise publitseerimiskeskusest: http://pub.e-tervis.ee/classifications/RHK-10/. Välispõhjusteks loetakse RHK-10 gruppe V, W, X, Y. 1.5.10 Teenuse tunnus Kood Selgitus NCSP NCSP kood TEEN Teenuse kood (TTL, statistiline vm EHK kehtestatud kood) 1.5.11 DRG erand Kood Selgitus HN DRG erand – hind JA DRG erand – järgarve KD DRG erand – DRG kood PD DRG erand – põhidiagnoos PE DRG erand – põhieriala SN DRG erand – suunamine TL DRG erand - TTL 1.5.12 Arve lõpetamise põhjus http://pub.etervis.ee/classifications/Haiglast%20lahkumine/1 Kood Selgitus 1 väljakirjutatud 2 üleviidud teise haiglasse 3 surnud 31 surmatõendi väljastatud 32 lahangule suunatud 1.5.13 Raskusaste Täna kokku lepitud kasutamine diagnooside I10-I15 (kohustuslik) ja C00-D48 (võimalik) korral. Kood Selgitus Määramata 10/40  1 Madal 2 Mõõdukas 3 Kõrge 4 Väga kõrge 1.5.14 Riigi kood EL kodaniku andmete juures saadetakse arvel kasutatud isikutõendava dokumendi alusel tuvastatud elukoha-/kindlustajariigi kood ISO kahetähelise riigikoodina(ISO 3166 Alpha-2): https://www.iso.org/iso-3166-country-codes.html 1.5.15 Isikut tõendava dokumendi liigid Kood selgitus DA1 Vorm DA1 E112 Vorm E112 E123 Vorm E123 EHIC Euroopa ravikindlustuskaart REPL Ravikindlustuskaardi asendussertifikaat S2 Vorm S2 1.5.16 Hamabavalem Standardite ja klassifikaatorite publitseerimiskeskuse alusel valemid jäävhammaste, piimahammaste ning lisahammaste osas: http://pub.e-tervis.ee/classifications/Hambavalem HR. Kasutusel on jäävhammaste (11-18; 21-28; 31-38; 41-48), piimahammaste (51-55; 61-65; 71-75; 81-85) tähistused, võimalike lisahammaste (L11-L18; L21-L28; L31-L38; L41-L48; L51-L55; L61-L65; L71-L75; L81-L85) tähistused. 1.5.17 DMFT indeks DMFT indeksiga määratakse jäävhammaste kaarioosset seisundit. D-Kahjustatud hammas (Decayed crown); F – Täidisega hambakroon (Filled crown); M – Eemaldatud hammas (Missing tooth); http://pub.e- tervis.ee/manuals/DMFT%20ja%20CPI%20indeksite%20m%C3%A4%C3%A4ramise%20ju hend/1/Juhend%20DMFT%20ja%20CPI%20indeksite%20m%C3%A4%C3%A4ramine%20h ambaravis.pdf. Indeksi väärtus jääb vahemikku 0 kuni 32. 1.5.18 Raviarve olek Kood Selgitus 00 Esitatud 99 Tühistatud 11/40 1.5.19 Lepingu koefitsiendi liik Kood Selgitus ZYLT Ületöö ZLKF Lepingus määratud erikoefitsient 1.5.20 Raviarve tühistamise põhjus Kood Selgitus TP001 Vale teenus TP002 Vale NCSP TP003 Vale koefitsient TP004 Vale teenuse hulk TP005 Vale teenuse tüüp TP006 Vale isik TP007 Vale diagnoos TP008 Vale teenuse osutamise kuupäev TP009 Vale lepingu eriala TP010 Vale rahastamise allikas 1.5.21 Lepingu versioon Kood Selgitus L01 Allkirjastatud leping L04 Lepingu pakkumus L09 Lepingu tööversioon 1.5.22 Lepingu liik Kood Selgitus 2 Üldarstiabi 3 Eriarstiabi 4 Ennetus 5 Hambaravi 6 Õendusabi 13 Koolitervishoid 1.5.23 Poolaasta Kood Selgitus 1 I poolaasta 2 II poolaasta Y aasta 12/40 1.5.24 Arveldusdokumendi tüüp Kood Selgitus RE Koondarve RK Kreeditarve NA Nõue NX Nõude tühistamine PA Perioodiarve PX Perioodiarve tühistamine 1.5.25 Teate tüüp Kood Selgitus E Error/Viga W Warning/Hoiatus I Info/teadmiseks 1.5.26 Lepingu rahalise lisa teenuste grupp Kood Selgitus Tervishoiuteenuse tüüp L Hooldus 18, 20 A Ambulatoorne 1 (kui rahastamise allikas pole PA), 16 S Statsionaarne 15, 2 E Päevaravi 19 H Hambaravi 10, 11, 3, 33, 34, 35, 4 P Perearstid 1 – ainult rahastamise allikas PA, 14, 17 G Koolitervishoid 13 Z Haiguste ennetamine (va 14 koolitervishoid) 1.5.27 Rahalise lisa ettepaneku põhjus Kood Selgitus 1 RJKM muutus 2 Spetsialisti lisandumine 3 Kättesaadavuse parandamiseks 4 Muu põhjus 1.5.28 Rahalise lisa ettepaneku otsus Kood Selgitus 1 Aktsepteeritud 2 Osaliselt aktsepteeritud 3 Tagasilükatud 13/40 1.5.29 Rahalise lisa ettepaneku staatus Kood Selgitus 1 Partner esitab ettepanekud 2 Ettepanekud esitatud 3 Haldur koostab otsuseid 4 Haldur on otsused andnud 5 Pakkumine on kinnitatud 14/40 2 Üldprotsess 2.1 Raviarvete andmevahetus Haigekassa võtab partnerilt vastu raviarve või –arved ja teeb esmased formaadikontrollid enne sisukontrolle. Vajadusel tagastatakse veateated. Kui süsteem jõuab sõnumis olnud raviarve töödelda ja ei avasta vigu, siis väljastatakse vastuses selle raviarve haigekassa süsteemi ID (arveHkId) koos DRG kodeerimise ja maksumuse arvutamise tulemustega. Vigade tekkimisel esitatakse veakood ja veateade. Ühes vastuvõetavas XML sõnumis võib sisalduda mitu raviarvet. Maksimaalne korraga esitatavate raviarvete arv määratakse jõudlustestimise tulemusena. Eelistatud on arvete saatmine jooksvalt tööprotsessis, kui aga arved kinnitatakse TTO juures suuremas mahus korraga, siis saavutatakse parem käideldavus mitme arve koondamisel ühte sõnumisse. Esmane formaadikontroll rakendatakse kogu sõnumile korraga. Selle kontrolli läbimisel eraldab süsteem sõnumis olnud üksikud raviarved ja suunab need edasisse töötlusse ühekaupa. Test-raviarved: Partner saab raviarvet esitada ka testimiseks. Süsteem teostab test-raviarvete korral andmete kontrolli, DRG kodeerimise ja maksumuse arvutamise. Süsteem ei omista test-raviarvetele unikaalseid identifikaatoreid, ei salvesta test-raviarveid ja ei arvesta neid lepingu rahalise lisa täitmises. NB! Kui raviarve saab vea üldisemate arvekontrollide käigus, siis sisulisi lisakontrolle tegema ei minda ja arve saadetakse veaga tagasi. Raviarvete andmevahetuse stsenaarium: 1. TTO edastab Haigekassale raviarve. 1.1. Haigekassas iga sõnumis oleva raviarve kohta: 1.1.1. läbitakse sisu ehk mitterahalised kontrollid 1.1.2. suunab raviarve DRG kodeerimisele ja arvutab maksumuse 1.1.3. kontrollib raviarve vastavast lepingu rahalistele lisadele 1.1.4. kui kontrollid läbiti vigadeta, siis: 1.1.4.1. omistab igale raviarvele Haigekassa identifikaatori (arveHkId) 1.1.4.2. kinnitab raviarve 1.1.5. kui kontrollid leidsid vähemalt ühe vea, siis lükkab raviarve tagasi 1.2. väljastab TTO-le vastuse 1.2.1. kui formaadi kontroll andis vea, siis pole igale raviarve kohta eraldi vastust 1.2.2. kui raviarve kinnitati, siis on vastuses maksumuse arvutamise tulemused ja arveHkId 1.2.3. kui raviarve lükati tagasi, siis on vastuses veateade või -teated 1.2.4. kui TTO ei ole saanud raviarve töötlemise tulemust (st vastuseks ei saada süsteemile arusaadavat sisulist veateadet), siis TTO infosüsteem püüab saata raviarvet uuesti. Alles arve kohale jõudmise kinnitamisel (sisukas vastus arve saatmisel või arve olemasolu rta_detail teenuse vastuses) märgib TTO infosüsteem arve edukalt edastatuks. 1.2.5. Haigekassa koostab kokkulepitud sagedusega (nt kord ööpäevas, kord nädalas vms) koondarved. 1.2.6. TTO infosüsteem saab pärida arve vm kriteeriumite alusel dokumentide andmeid et kontrollida arvete koondarveldamist või tühistamist. 15/40  Raviarvete identifitseerimine: 1. TTO peab igale raviarvele omistama numbri (enda (raamatupidamis)süsteemis unikaalset tuvastamist tagava numbri). Haigekassa numbrit ei kontrolli. Raviarvele omistatud number on vajalik TTO-le endale, et TTO saaks kokku viia edastatud raviarve ja sellele saadud vastuse. 2. Haigekassa omistab igale kinnitatud raviarvele unikaalse arveHkId, mis on unikaalne üle kõigi TTO-de ja üle kogu ajaloo. Ka varasema süsteemi kaudu edastatud raviarved on registreeritud süsteemis ja neil on samuti olemas arveHkId. 3. Haigekassa väljastab partnerile arveHkId raviarve vastuses. Edasises andmevahetuses (näiteks koondarves raviarvele viitamiseks) kasutatakse arveHkId. Seega TTO peab enda süsteemis säilitama raviarve vastuses saadud arveHkId. Raviarvete vigade käsitlus: 1. Mitterahaliste kontrollide käigus vea avastamise korral Haigekassa süsteem viib lõpule kõik mitterahalised kontrollid, et tuvastada kõik raviarve mitterahalised vead. 2. Kontrollide käigus vea avastamise korral või arve lepingu rahalisse lisasse mitte mahtumise korral lükatakse raviarve tagasi. 3. TTO võib esitada tagasilükatud raviarve peale täiendamist uuesti. 4. Haigekassa töötleb uuesti esitatud raviarvet sõltumatult varem esitatud raviarvest. Raviarvete tühistamise stsenaarium: 1. TTO saab raviarve tühistada esitades tühistamise teenuses tühistatava arve arveHkId koos tühistamise põhjusega. 2. Haigekassa kontrollib tühistamise võimalikkust (kas tühistatav raviarve on olemas, kas vastav rahalise lisa periood on avatud jms) ja kui võimalik, siis tühistab raviarve. 3. Tühistatud raviarvele omistatakse vastav olek. Tühistatud raviarve sisu kaotab tähtsuse ja lepingu rahalise lisa maht taastatakse kasutatud mahu võrra. 4. Kui tühistatud raviarvet pole veel pandud koondarvesse, siis jäetakse tühistatud raviarve koondarvest välja. 5. Kui tühistud raviarve on juba pandud koondarvesse, siis tehakse raviarve kohta kreeditarve. 2.2 Lepingu haldus Lepingu jälgimise põhimõtted lepitakse haigekassa ja partneri vahel kokku ravi rahastamise lepinguga ning lähtuvalt kokkulepitud põhimõtetest toimub lepingu jälgimine lepingu perioodi, eriala, teenuse osutamise koha, teenuse tüübi ning rahastamise allika alusel. Haigekassa pakub partnerile teenuseid sõlmitud rahalise lisa planeeritud ja täitmise mahtude jälgimiseks, et tagada parem ülevaade lepingu täitmisest. Teenused annavad võimaluse: • Pärida rahaliste lisade loetelu • Pärida rahalise lisa kokkulepitud (planeeritud) andmeid ning pärimise hetke seisuga täitmise andmeid • Teha teenuste vahendusel ettepanekuid kehtiva või uue perioodi pakutava rahalise lisa andmetes • Kuvada tehtud muudatusettepanekute vastuseid ja nende ajalugu 16/40 3 Teenuse kirst.rta_saatmine kirjeldus Teenus „kirst.rta_saatmine.v1“ on mõeldud raviarvete esitamiseks EHK-sse. 3.1 Sisend • testimine (xsd:boolean[0..1]) – Tunnus mis näitab kas raviarved lähevad testimisele (true) või on tegemist reaalse edastamisega (false). • raviarved – raviarvete massiiv o item [1..n] – raviarve o arveJrk (xsd:integer) – raviarve järjekorra number sõnumis, arveid töödeldakse järjekorra numbri alusel. o arveNumber (xsd:string) – partneri poolt raviarvele omistatud number Näiteks: AS7381300. o lepingupartner (xsd:string[0..1]) – antud raviarve kulu kandja Näiteks: 74000091 (Eesti Haigekassa), 70006292 (Tervise Arengu Instituut) jne. Vaikimisi loetakse väärtuseks Eesti Haigekassa. o saabusHaiglast (xsd:string[0..1]) – Haigla äriregistrikood märgitakse juhul kui patsient suunatakse statsionaarselt või päevaravilt vahetult edasi statsionaarsele ravile (v.a iseseisvale statsionaarsele õendusabile või statsionaarsele taastusravile). o liikusHaiglasse (xsd:string[0..1]) – Haigla äriregistrikood märgitakse juhul kui statsionaarsel või päevaravil viibinud patsient suunatakse vahetult edasi statsionaarsele ravile (v.a iseseisvale statsionaarsele õendusabile või statsionaarsele taastusravile). o rahastamiseAllikas (xsd:string), loend – tervishoiuteenuse rahastamise allika kood (varem saadetise tüüp), vt 1.5.1. o arveTeenusTyyp (xsd:string), loend –teenuse tüüp vastavalt Sotsiaalministri kehtestatud määruse “Kindlustatud isikult tasu maksmise kohustuse Eesti Haigekassa poolt ülevõtmise kord ja tervishoiuteenuse osutajatele makstava tasu arvutamise metoodika” paragrahvile 54. vt 1.5.5. o eriala (xsd:string) – lepingu eriala kood st haigekassaga sõlmitud rahastuslepingus näidatud kulurea kood, vt 1.5.2. o teenusKoht (xsd:string) – Tervishoiuteenuse osutamise koht vastavalt „Eesti haldus- ja asustusjaotuse klassifikaatorile (EHAK-i kood), linna või valla tasemel, Tallinnas linnaosa tasemel. o algKp (xsd:date) – raviarve alguse kuupäev. o loppKp (xsd:date) – raviarve lõpu kuupäev. o yletoo (xsd:boolean[0..1]) – Ületööna saadetava arve korral väärtus true. o saabumiseLiik (xsd:string), loend – Ravile saabumise liigi kood vastavalt Tervise Infosüsteemi loendile, vt ptk 1.5.6. o lopetamisePohjus (xsd:string), loend – Raviarve lõpetamise põhjuse kood vastavalt Tervise Infosüsteemi loendile. Vt ptk 1.5.102. 17/40 o arst – raviarvega seotud arstide ja nende erialade andmed: ▪ arstiKood (xsd:string) – Arve esitanud tervishoiutöötaja kood. Näiteks: D02364, koode väljastab Terviseamet. ▪ arstiEriala (xsd:string) – arsti eriala, vt 1.5.4. ▪ suunanudArstiKood (xsd:string[0..1]) – Ravile suunanud tervishoiutöötaja kood. Näiteks: D02364, koode väljastab Terviseamet. o esmaseArveHkId (xsd:string[0..1]) – juhtumit/episoodi alustanud raviarve haigekassa poolne number. o valtimatuAbi (xsd:boolean[0..1]) – vältimatu abiga seotud arve puhul väärtus true. o saatekirjaNr (xsd:string[0..1]) – Digiloo saatekirja number+OID (välja kohustuslikkus lepitakse kokku lepingus). o tvlJuhtum (xsd:string[0..1]) – raviarvega/-juhuga seotult väljastatud (esimene) TVL haigekassa poolne number. Näidata saab ühe TVL numbri iga raviarve dokumendi kohta. o patsient – raviarvele märgitud patsiendi andmed: ▪ isikukood (xsd:string[0..1]) – patsiendi isikukood. Kui raviarves on Eesti isikukood, siis muid patsiendi andmeid peale isikukoodi ei esitata. ▪ eesnimi (xsd:string[0..1]) – patsiendi eesnimi. ▪ perekonnanimi (xsd:string[0..1]) – patsiendi perenimi. ▪ synniKp (xsd:date[0..1]) – patsiendi sünniaeg. ▪ sugu (xsd:string[0..1]) – patsiendi sugu vt 1.5.3. ▪ elukohaRiik (xsd:string[0..1]) – EL kodaniku elukohariik loend, vt 1.5.14. o arveDiagnoosid – raviarve diagnooside massiiv: ▪ item [1..n] – raviarve diagnoos (diagnooside järjekord ei ole DRG arvutamisel oluline) • liikDiagnoos (xsd:string), loend vt1.5.7. • diagnoos (xsd:string), loend – Diagnoos RHK-10 loetelu alusel, vt 1.5.7. • raskusaste (xsd:string[0..1]), loend – Haiguse kliinilise raskusastme, staadiumi või muu erialaseltsi(de)ga kokkulepitud tunnus. Vt 1.5.13. o arveTeenused – raviarve teenuste massiiv: ▪ item [1..n] – raviarve teenus • teenusKood (xsd:string) – tervisehoiuteenus Tervishoiuteenuste loetelu või ÜRL lisa8, KT lisa, NCSP loendi alusel nt kood 3102. • teenusKp (xsd:date) – teenuse osutamise kuupäev. • teenusKellaaeg (xsd:time[0..1]) – teenuse osutamise kellaaeg (kui teenuse osutamise kellaaja edastamine on kokku lepitud). 18/40  • teenusKogus (xsd:decimal) – osutatud teenuse kogus (kuni 3 komakoha täpsusega). Statsionaarses ravis voodipäevade korral voodipäevade arv. • emo (xsd:boolean[0..1]) – erakorralise meditsiini osakonnas tellitud teenuse korral väärtus true. • teenusKoefVaartus (xsd:decimal) – murdarv kuni kolme komakoha täpsusega– (täna väli „koefitsient1“). • hambaravi [0..1] – hambaraviga seotud lisaväärtused ▪ hambavalemAlates(xsd:string[0..1]) – osutatud teenusega seotud hambavalem või vahemiku alguse kood nt 13, vt 1.5.16. ▪ hambavalemKuni(xsd:string[0..1]) – osutatud teenusega seotud hambavalemi vahemiku lõpu kood nt 15, vt 1.5.16. ▪ dmfKood(xsd:integer[0..1]) – DMFT indeks, vt 1.5.17. o elDokAndmed [0..1]– teise EL riigi kindlustatu andmed (analoogne digiretseptiga): ▪ dokumendiLiik (xsd:string) – dokumendi liik, vt 1.5.15. ▪ dokumendiNumber (xsd:string) – dokumendi number. ▪ valjastatudKp (xsd:date[0..1]) – väljastatud kuupäev. ▪ kehtibAlatesKp (xsd:date[0..1]) – kehtib alates kuupäev. ▪ kehtibKuniKp (xsd:date) –kehtib kuni kuupäev. ▪ padevaAsutuseKood (xsd:string[0..1]) – pädeva asutuse kood. 3.1 Väljund • raviarved – töödeldud raviarvete massiiv: o item [1..n] – raviarve ▪ arveJrk (xsd:integer) – raviarve järjekorra number sõnumis. ▪ arveNumber (xsd:string) – raviarve asutusepoolne number. ▪ loodudKp (xsd:date[0..1]) – esitatud raviarve haigekassale esitamise/laekumise kuupäev. ▪ arveHkId (xsd:string[0..1]) – raviarve haigekassa poolne universaalne number. ▪ arveStaatus (xsd:string[0..1]), loend – raviarve olek vastuse väljastamise ajal, vt 1.5.18. ▪ raviarveVastus [0..1] raviarve andmed eduka saatmise või testimise puhul. • drg[0..1] – DRG andmed: o drgKood (xsd:string) – raviarvele omistatud DRG kood. o drgErand (xsd:string) – raviarvele omistatud DRG erandi tunnus, vt 1.5.11. 19/40  o drgPiirhind (xsd:decimal) – DRG piirhind, ujukomaarv kuni kahe komakohaga. o drgMaksumus (xsd:decimal) – DRG maksumus, ujukomaarv kuni kahe komakohaga. o drgOsakaal (xsd:decimal) – DRG osakaal nt 0,30. • arveSummad – raviarvega seotud summad: o kokkuSumma (xsd:decimal)– raviarve teenuste maksumus kogusummast st ∑(teenusPiirhind*teenusKogus*teenusKoefVaartus*(1- drgOsakaal))+drgMaksumus. o arveSumma (xsd:decimal)– partnerile välja makstav summa; summa saadakse kokkuSumma-le lepingulise ja / või ületöö koefitsiendi rakendamisega. o valuuta (xsd:string) – arve valuuta. o ylikallis (xsd:boolean[0..1]) – Ülikalli arve tunnus. • arveTeenused – raviarve teenuste vastuste massiiv: o item [1..n] – raviarve teenuse vastus ▪ teenusKood (xsd:string) – teenuse TTL kood. ▪ teenusPiirhind (xsd:decimal) – teenuse piirhind, ujukomaarv kuni kahe komakohaga. ▪ teenusKogus (xsd:decimal) – osutatud tervishoiuteenuse kogus, ujukomaarv kuni kolme komakohaga. ▪ teenusKoefVaartus (xsd:decimal) – väärtus, murdarv kuni kolme komakoha täpsusega– (täna väli „koefitsient1“). ▪ teenusMaksumus (xsd:decimal) – teenuse maksumus piirhind*kogus*ttkoefVaartus*(1-drgOsakaal). • lepinguKoefitsiendid [0..1]– lepingu koefitsientide massiiv: o item [1..n] – Ravirahastamise lepinguga seotud koefitsiendid ▪ koefitsiendiLiik (xsd:string) – koefitsiendi liik, vt 1.5.19. ▪ koefitsiendiVaartus (xsd:decimal) – väärtus. ▪ vead – raviarve teadete massiiv: • item [0..n] – raviarve teade o tyyp (xsd:string), loend – teate tüüp, vt 1.5.25. o kood (xsd:string) – teate kood, täisarv. o teade (xsd:string) – teate kirjeldus/sisu. 3.2 Reeglid • Arvel on märgitud üks lepingu eriala. Üldarstiabi arvete korral saadetakse ostutatud teenuste info kas lepingu eriala kaupa grupeerituna eraldi dokumentidena(iga lepingu eriala 20/40  kohta üks dokument) või saadetakse kõik teenused ühel arvel nii et lepingu eriala ei täpsustata ja selle leiab haigekassa (kehtib ainult rahastamise allikas PA korral). • Üldarstiabi arvete korral võib rahastamise allikas PA korral saata sama tunnusega ka nn nullarveid – nende rahastamise allikaks muudab OR haigekassa. • Arve kuluperiood leitakse arve lõpetamise kuupäeva ja arve esitamise kuupäeva alusel st jooksval kuul lõppenud ja esitatud arved arvestatakse jooksva kuu kuluperioodi, eelmisel kuul ja varem lõppenud arved, mis laekuvad jooksva kuu esimese 7(kokkulepitud tähtpäev) päeva jooksul arvestatakse eelmise kuu kuluperioodi ning peale kuluperioodi sulgemist jooksva kuu kuluperioodi. • Raviarvel on tervishoiuteenuste loetelust(TTL) tingitud teenuse koefitsiendid ning eraldi lepingulised koefitsiendid. Raviasutus edastab TTL koefitsiendid ja haigekassa esitab arve vastuses arvega seotud lepingu koefitsiendid. • Raviarvel näidatakse seos töövõimetuse juhtumiga(esimene raviarvel näidatud ravijuhi raames väljastatud TVL id) ja järgarve puhul juhtumi esimese arvega ning saadetud dokumendi viiteid kontrollitakse haigekassa andmete vastu. Kui viidatud dokumente pole olemas, siis antakse saatjale viga. • Kui arve saadetakse rahastamise allikaga OR, siis loetakse arve kogusumma nulliks ja iga rida saab tunnuse nullRida (nähtav arve detailandmete teenuses). • Sisend: Kui raviarves on Eesti isikukood, siis muid patsiendi andmeid peale isikukoodi ei esitata. o Kui on mitte kindlustatud isikule vältimatu abi osutamine ja pole teada Eesti isikukoodi, siis tuleb esitada vähemalt sünniaeg ja sugu. o Kui on muu EL riigi kindlustatud isik, siis tuleb esitada kõik patsiendi andmed ja kindlustust tõendava dokumendi andmed elemendis elDokAndmed. • Sisuliste kontrollide loend publitseeritakse eraldi. 21/40 4 Teenuse kirst.rta_tyhistus kirjeldus Teenus „kirst.rta_tyhistus.v1“ on mõeldud esitatud raviarvete tühistamiseks EHK süsteemis. 4.1 Sisend • raviarveTyhistused – raviarve tühistuste massiiv: o item [1..n] – raviarve tühistus ▪ arveHkId (xsd:string) – tühistatava raviarve haigekassa poolne number. ▪ tyhistatudPohjus(xsd:string), loend – raviarve tühistamise põhjuse kood, vt 1.5.20. 4.2 Väljund • raviarveTyhistused – raviarve tühistuste massiiv: o item [1..n] – raviarve tühistuse vastus ▪ arveHkId (xsd:string) – raviarve haigekassa poolne universaalne number. ▪ arveStaatus (xsd:string[0..1]) – raviarve olek vastuse väljastamise ajal, vt 1.5.18. ▪ arveNumber (xsd:string[0..1]) – raviarve asutusepoolne number. ▪ vead – raviarve teadete massiiv: • item [0..n] – raviarve teade o tyyp (xsd:string), loend – teate tüüp (I,W,E), vt 1.5.25. o kood (xsd:string) – teate kood, täisarv. o teade (xsd:string) – teate kirjeldus/sisu. 4.3 Reeglid • Koodiga arveHkId viidatud raviarve peab süsteemis olemas olema ja ei tohi olla tühistatud. • Põhjendus peab olema reaalne ja kui sellega on seotud täiendavad ärikontrollid siis peavad nende nõuded täidetud olema. 4.4 Teated Tabel 3 Teenuse poolt tagastatavad teated Kood Teade Selgitus 90 Asutus reg.koodiga ’ttoRegKood’ ei Tühistada saab ainult sama saa arvet ’arveHkId’ tühistada registrikoodiga arveid 91 Tühistatav raviarve ’arveHkId’ on juba Soovitakse tühistada juba tühistatud tühistatud või ebasobivas staatuses raviarvet 92 Tühistatavat raviarvet ’arveHkId’ ei Puuduv või vale raviarve number eksisteeri 93 Raviarve tühistamise põhjust Puuduv või mitte-eksisteeriv ’pohjendus’ ei eksisteeri tühistamise põhjus 22/40 5 Teenuse kirst.rta_detail kirjeldus Teenus „kirst.rta_detail.v1“ on mõeldud raviarve detailandmete vaatamiseks. Sisendis peab olema antud kas raviarve EHK ID või asutusepoolne raviarve number. 5.1 Sisend • xtee:allasutus / xtee:asutus (xsd:string) – andmeid esitava asutuse kood, päringu X- tee päise väli; • arveHkId (xsd:string[0..1]) – Alusdokumendi EHK ID või • arveNumber (xsd:string[0..1]) – lähtedokumendi asutuse poolne number. 5.2 Väljund • raviarve [0..1] – arve detailinfo; o arveHkId (xsd:string) – Alusdokumendi EHK ID; o arveNumber (xsd:string) – Alusdokumendi asutusepoolne number; o arveldus [0..1] – raviarvega seotud arveldusdokumendid: ▪ item[0..n] - arveldusdokument • kaTyyp (xsd:string) – arveldusdokumendi tüüp 1.5.24; • kaNumber (xsd:string) – arveldusdokumendi number; • kaKp (xsd:date) – arveldusdokumendi kuupäev; • kaKuluperiood (xsd:string) – arveldusdokumendi kuluperiood (yyyy.mm) o lepingupartner (xsd:string) – antud raviarve kulu kandja Näiteks: 74000091 (Eesti Haigekassa), 70006292 (Tervise Arengu Instituut) jne. Vaikimisi loetakse väärtuseks Eesti Haigekassa; o saabusHaiglast (xsd:string[0..1]) – haigla äriregistrikood milles statsionaarne ravi algas; o saabusHaiglastNimi (xsd:string[0..1]) – haigla nimi milles statsionaarne ravi algas; o liikusHaiglasse (xsd:string[0..1]) – haigla äriregistrikood kuhu patsient statsionaarsele ravile liikus; o liikusHaiglasseNimi (xsd:string[0..1]) – haigla nimi kuhu patsient statsionaarsele ravile liikus; o teenusKoht (xsd:string[0..1]) – Teenuse osutamise koht; o rahastamiseAllikas (xsd:string) – Rahastamise allikas, vt 1.5.1; o arveTeenusTyyp (xsd:string) – Tervishoiuteenuse tüüp, vt 1.5.5; o arveStaatus (xsd:string) – Raviarve olek, vt 1.5.18; o algKp (xsd:date) – Alguse aeg; o loppKp (xsd:date) – Lõpu aeg; 23/40 o loodudKp (xsd:date) – raviarve haigekassale esitamise/laekumise kuupäev; o tyhistatudKp (xsd:date[0..1]) – Dokumendi tühistamise kuupäev; o tyhistatudPohjus (xsd:string[0..1]) – Raviarve tühistamise põhjus, vt 1.5.20; o arveSummad – RTA summad: ▪ kokkuSumma (xsd:decimal) – teenustepõhine summa koos koefitsientidega; ▪ arveSumma (xsd:decimal) – partnerile välja makstav summa; summa saadakse kokkuSumma -le lepingulise ja / või ületöö koefitsiendi rakendamisega; ▪ valuuta (xsd:string) – Valuuta; ▪ ylikallis (xsd:boolean[0..1]) – Ülikalli arve tunnus; o lepinguKoefitsiendid [0..1] – RTA koefitsiendid (sh. ka ületöö): ▪ item [1..n] – Koefitsiendi rida • koefitsiendiLiik (xsd:string) – Koefitsiendi liik, vt 1.5.19; • koefitsiendiVaartus (xsd:decimal) – Koefitsiendi väärtus; o esmaseArveHkId (xsd:string[0..1]) – juhtumit/episoodi alustanud raviarve haigekassa poolne number; o ttoRegKood (xsd:string) – TTO äriregistrikood; o ttoNimi (xsd:string) – TTO nimi; o eriala (xsd:string) – Lepingu eriala kood, vt 1.5.2; o erialaNimi (xsd:string) – Lepingu eriala nimi; o saabumiseLiik (xsd:string) – Saabumise liik, vt 1.5.6; o lopetamisePohjus (xsd:string[0..1]) – Lõpetamise põhjus, vt1.5.12; o arst – raviarvega seotud arstide ja nende erialade andmed ▪ arstiKood (xsd:string) – Arsti kood; ▪ arstiNimi (xsd:string) – Arsti nimi; ▪ arstiEriala (xsd:string) – Arsti eriala, vt 1.5.4; ▪ arstiErialaNimi(xsd:string) – Arsti eriala nimetus; ▪ suunanudArstiKood (xsd:string[0..1]) – Suunanud arsti kood; ▪ suunanudArstiNimi(xsd:string[0..1]) – Suunanud arsti nimi; o valtimatuAbi (xsd:boolean[0..1]) – Vältimatu abi; o saatekirjaNr (xsd:string[0..1]) – Digiloo saatekirja OID+number; o tvlJuhtum (xsd:string[0..1]) – TVL juhtumi esmase lehe haigekassa poolne number; o patsient - raviarvele märgitud patsiendi andmed: 24/40  ▪ isikukood (xsd:string[0..1]) – Patsiendi isikukood; ▪ eesnimi (xsd:string[0..1]) – Patsiendi eesnimi; ▪ perekonnanimi (xsd:string[0..1]) – Patsiendi perekonnanimi; ▪ synniKp (xsd:date[0..1]) – Patsiendi sünnikuupäev; ▪ sugu (xsd:string[0..1]) – Patsiendi sugu, vt 1.5.3; ▪ elukohaRiik (xsd:string[0..1]) – Patsiendi elukohariik, vt 1.5.14; o elDokAndmed [0..1] - Teise EL riigi kindlustatu andmed: ▪ dokumendiLiik (xsd:string) - Dokumendi liik, vt 1.5.15; ▪ dokumendiNumber (xsd:string) – Dokumendi number; ▪ valjastatudKp (xsd:date[0..1]) – Väljastatud kuupäev; ▪ kehtibAlatesKp (xsd:date[0..1]) – Kehtib alates kuupäev; ▪ kehtibKuniKp (xsd:date) – Kehtib kuni kuupäev; ▪ padevaAsutuseKood (xsd:string[0..1]) – Pädeva asutuse kood; o arveDiagnoosid – Raviarve diagnoosid: ▪ item [1..n] – raviarve diagnoos • liikDiagnoos (xsd:string) – Diagnoosi liik, vt 1.5.7; • diagnoos (xsd:string) – Diagnoos, vt 1.5.8; • diagnoosNimi (xsd:string) – Diagnoosi nimetus; • raskusaste (xsd:string[0..1]) – Raskusaste, vt 1.5.13; o drg[0..1] – DRG andmed: ▪ drgKood (xsd:string) – raviarvele omistatud DRG kood; ▪ drgKoodNimi (xsd:string[0..1]) – DRG nimetus/tekst; ▪ drgErand (xsd:string) – raviarvele omistatud DRG erandi tunnus, vt 1.5.11; ▪ drgPiirhind (xsd:decimal) – DRG piirhind; ▪ drgMaksumus (xsd:decimal) – DRG maksumus; ▪ drgOsakaal (xsd:decimal) – DRG osakaal; o arveTeenused – Raviarve teenused: ▪ item ([1..n]) – Raviarve teenus • teenusTunnus (xsd:string) – Teenuse tunnus, vt 1.5.10; • teenusKp (xsd:date) – Teenuse osutamise kuupäev; • teenusKellaaeg (xsd:time[0..1]) – Teenuse osutamise kellaaeg; • teenusKood (xsd:string) – Teenuse kood; • teenusKoodNimi (xsd:string) – Tervisehoiuteenuse nimetus; 25/40  • teenusKogus (xsd:decimal) – Teenuse kogus; • teenusPiirhind (xsd:decimal) – Piirhind; • teenusKoefVaartus (xsd:decimal) – väärtus, murdarv kuni kolme komakoha täpsusega– (täna väli „koefitsient1“); • teenusMaksumus (xsd:decimal) – Maksumus; • osakaal (xsd:decimal) – Osakaal (DRG-d sisaldaval arvel 1-drg osakaal); • emo (xsd:boolean) – erakorralise meditsiini osakonnas osutatud teenuse korral väärtus true; • nullRida (xsd:boolean[0..1]) – tegemist on null-reaga, mille summat ei arvestata; • hambaravi [0..1] – hambaraviga seotud lisaväärtused: o hambavalemAlates (xsd:string[0..1]) – osutatud teenusega seotud hambavalem või vahemiku alguse kood nt 13, vt 1.5.16; o hambavalemKuni (xsd:string[0..1]) – osutatud teenusega seotud hambavalemi vahemiku lõpu kood nt 15, vt 1.5.16; o dmfKood xsd:integer[0..1]) – DMFT indeks, vt 1.5.17; • vead – dokumendiga seotud teated, hoiatused ja vead; o item ([0..n]) – kirje töötlemise teated; ▪ tyyp (xsd:string) – teate tüüp, vt 1.5.25; ▪ kood (xsd:string) – teate kood; ▪ teade (xsd:string) – teate tekst. 5.3 Reeglid Üldarstiabi arvetel millel on mitme lepingu eriala teenused tagastatakse üks (suvaline) lepingu eriala, ei tagastata kõiki. Täpset lepingu rahalise lisa täitmist saab jälgida lepingu teenuste abil. 5.4 Teated Tabel 4 Teenuse poolt tagastatavad teated Kood Teade Selgitus 005 Vasteid ei leitud Päringule vasteid ei leitud 26/40 6 Teenuse kirst.rta_koond_arve_info kirjeldus Teenus „kirst.rta_koond_arve_info.v1“ on mõeldud raviarvete ja perioodiarvete arveldusinfo pärimiseks EHK süsteemist. 6.1 Sisend • xtee:allasutus / xtee:asutus (xsd:string) – andmeid esitava asutuse kood, päringu X- tee päise väli; • kaTyyp(xsd:string[0..1]) – arveldusdokumendi tüüp 1.5.24, perioodiarve pärimiseks on täitmine kohustuslik; • kaAlates (xsd:date[0..1]) – arveldusdokument koostatud alates kuupäevast; • kaKuni (xsd:date[0..1]) – arveldusdokument koostatud kuni kuupäevani; • arveAlates (xsd:date[0..1]) – arved esitatud alates kuupäevast; • arveKuni (xsd:date[0..1]) – arved esitatud kuni kuupäevani; • arveNumber (xsd:string[0..1]) – lähtedokumendi asutuse poolne number, kui soovitakse infot vaid ühe dokumendi kohta; • arveHkId (xsd:string[0..1]) – lähtedokumendi EHK ID, kui soovitakse infot vaid ühe dokumendi kohta; • kaNumber (xsd:string[0..1]) – arveldusdokumendi EHK number. 6.2 Väljund • raviarved – lähtearvete massiiv; o item ([0..n]) – alusdokumendi rida; ▪ arveHkId (xsd:string) – alusdokumendi EHK ID, perioodiarvete korral esmase arveldusdokumendi number (kaNumber); ▪ arveNumber (xsd:string) – alusdokumendi number; ▪ lepingupartner (xsd:string) – antud raviarve kulu kandja Näiteks: 74000091 (Eesti Haigekassa), 70006292 (Tervise Arengu Instituut) jne.; ▪ loodudKp (xsd:date) – raviarve haigekassale esitamise/laekumise kuupäev; ▪ eriala (xsd:string[0..1]) – perioodiarvete puhul lepingu eriala, raviarvete korral puudub; ▪ arveSumma (xsd:decimal) – partnerile välja makstav summa; summa saadakse kokkuSumma -le lepingulise ja / või ületöö koefitsiendi rakendamisega; ▪ valuuta (xsd:string) – alusdokumendi summa valuuta (alati EUR); ▪ arveldus [0..1] – raviarvega seotud arveldusdokumendid: • item[0..n] - arveldusdokument o kaTyyp (xsd:string) – arveldusdokumendi tüüp 1.5.24; 27/40  o kaNumber (xsd:string) – arveldusdokumendi EHK ID; o kaKp (xsd:date) – arveldusdokumendi kuupäev; o kaKuluperiood (xsd:string) – arveldusdokumendi kuluperiood (yyyy.mm); o kaSelgitus (xsd:string[0..1]) – arveldusdokumendil olev selgitustekst; • vead – dokumendiga seotud teated, hoiatused ja vead; o item ([0..n]) – kirje töötlemise teated; ▪ tyyp (xsd:string) – teate tüüp, vt 1.5.25; ▪ kood (xsd:string) – teate kood; ▪ teade (xsd:string) – teate tekst. 6.3 Reeglid • Kui teenuse sisendis on antud arveNumber või arveHkId, siis ei ole kaTyyp, kaAlates ja kaKuni väljade saatmine soovitatav, kuna sellisel juhul tagastataks vaid koondarveldatud arveid. • Kui arveNumber pole antud, siis on arveAlates kuupäev kohustuslik. arveKuni kuupäev võib olla tühi, sel juhul võetakse ajavahemiku lõpuks tänane kuupäev. • Kui kaTyyp ja kaAlates/kaKuni puuduvad, siis tagastakse kõik arved, nii arveldatud kui arveldamata. Kui kaTyyp puudub, kuid on täidetud kaAlates/kaKuni, siis tagastatakse ainult sel perioodil koondarveldatud arved (kõik koondarve tüübid). Kui kaTyyp on täidetud, siis tagastatakse ainult antud koondarvetüübiga arveldatud arved. • Perioodiarvete pärimisel peab olema täidetud väli kaTyyp. • Perioodiarvete korral puudub TTO poolne alusdokument ja arveHkId väljas näidatakse esimese maksedokumendi numbrit et tagada arveHkId unikaalsus. • Perioodiarvete korral ei saa kasutada raviarvega seotud sisendvälju arveNumber, arveHkId, arveAlates, arveKuni. • Koondarveid koostatakse kokkulepitud sagedusega (ööpäevas, nädalas, kuus). • Arve kuluperiood leitakse arve lõpetamise kuupäeva ja arve esitamise kuupäeva alusel st jooksval kuul lõppenud ja esitatud arved arvestatakse jooksva kuu kuluperioodi, eelmisel kuul ja varem lõppenud arved, mis laekuvad jooksva kuu esimese 7(kokkulepitud tähtpäev) päeva jooksul arvestatakse eelmise kuu kuluperioodi ning peale kuluperioodi sulgemist jooksva kuu kuluperioodi. 6.4 Teated Tabel 5 Teenuse koond_arve_info teated Kood Teade Selgitus 005 Vasteid ei leitud Päringule ei leitud vasteid 28/40 006 Kuupäeva vormingu viga väljas &1 Päringus esitatud kuupäeva-vorming viidatud väljas on vale 007 Raviarvet &1 ei leitud Süsteemis ei esine antud asutusepoolse numbriga arvet 008 EHK identifikaatoriga raviarvet &1 ei leitud Süsteemis ei esine antud Haigekassa identifikaatoriga arvet 009 Koondarvet &1 ei leitud Süsteemis ei esine antud Haigekassa identifikaatoriga koondarvet 010 Partneri registrikood on tühi Partneri registrikood on tühi 011 Palun täitke vähemalt üks alguskuupäeva Kui arve number pole antud, siis on alates või arvele viitav väli kuupäev kohustuslik. 29/40 7 Lepinguandmete päring kirst.leping 7.1 Sisend • xtee:allasutus / xtee:asutus (xsd:string) – andmeid esitava asutuse kood, päringu X- tee päise väli; • aasta (xsd:integer[0..1]) – Aasta, mille rahaliste lisade nimistu kuvada (vaikimisi laetakse nimistu kogu lepingu kehtivusperioodi mahus); • lepinguNr (xsd:string[0..1]) – Lepingunumber (nt 6048914); • versioon (xsd:string[0..1]) – Lepingu versioon (vaikimisi „L01“), vt ptk 1.5.21. 7.2 Väljund • lepingud – Asutuse lepingud: o item [0..n] – Leping ▪ lepinguNr (xsd:string) – Lepingu nr; ▪ kehtibAlatesKp (xsd:date) – Leping kehtiv alates; ▪ kehtibKuniKp (xsd:date) – Leping kehtiv kuni; ▪ rahalisedLisad • item [0..n] - Rahalised lisad o lepinguLiik (xsd:string) – Rahalise lisa lepingu liik, vt ptk 1.5.22; o aasta (xsd:integer) – Rahalise lisa aasta; o poolaasta (xsd:string) – Rahalise lisa poolaasta, vt ptk 1.5.23; o nimi (xsd:string) – Rahalise lisa tekst. • vead – dokumendiga seotud teated, hoiatused ja vead; o item ([0..unbounded]) – kirje töötlemise teated; ▪ tyyp (xsd:string) – teate tüüp, vt 1.5.25; ▪ kood (xsd:string) – teate kood; ▪ teade (xsd:string) – teate tekst. 7.3 Reeglid • Teenuse kõik sisendväljad (peale asutuse/allasutuse) on vabatahtlikud. Teenuse vastus on konkreetsem ja kiirem kui kasutatakse mõnda pakutud valikulistest sisenditest. • Kui aasta jäetakse tühjaks, siis laetakse rahalised lisad kogu lepingu kehtivuse mahus. Kui sisendis on täidetud ka väli ’aasta’, siis laetakse rahalise lisa loetelu vaid vastavale aastale. • Teenuse väljundis toodud väärtused on mõeldud leping_rahaline_lisa teenuse sisendis kasutamiseks et saada täpsem konkreetse rahalise lisa koosseis. 30/40 7.4 Vead Kood Teade Selgitus 001 Ebapiisavad sisendid Sisendina antud andmed ebapiisavad 002 Vasteid ei leitud Päringule vasteid ei leitud 31/40 8 Rahalise lisa andmete päring kirst.leping_rahaline_lisa 8.1 Sisend • xtee:allasutus / xtee:asutus (xsd:string) – andmeid esitava asutuse kood, päringu X- tee päise väli; • lepinguLiik (xsd:string) – Rahalise lisa lepingu liik, vt ptk 1.5.22; • aasta (xsd:integer) – Rahalise lisa aasta; • poolaasta (xsd:string) – Rahalise lisa poolaasta, vt ptk 1.5.23; • versioon (xsd:string[0..1]) – Lepingu versioon (vaikimisi „L01“), vt ptk 1.5.21. 8.2 Väljund • rahalineLisaDetail – Rahalise lisa read: o item [0..n] – Rahalise lisa rida ▪ reaId (xsd:string) – Rea identifikaator (kõrgeim tase 1, sellele järgnevad vastavalt loendile vt ptk 1.5.26); ▪ ylemineId (xsd:string) – Rea ülemise taseme identifikaator; ▪ eriala – Rahalise lisa eriala • kood (xsd:string) – Eriala kood, vt ptk 1.5.2; • nimi (xsd:string) – Eriala nimi (eriala koodi puudumisel ptk 1.5.26 loendi elemendi nimetus); ▪ asukoht– Ravijuhu asukoht/asukohad(kui eriala on planeeritud mitmes eri asukohas siis kõrgemal tasemel näidatakse eriala koguinfot ja kõiki asukohti nt TARTU,ELVA) ; • kood (xsd:string) – Asukoha/asukohtade EHAK kood; • nimi (xsd:string) – Asukoha/asukohtade nimi; ▪ rjArv (xsd:integer) – Plaanitud ravijuhtude arv; ▪ summa (xsd:decimal) – Plaanitud rea summa; ▪ rjArvTaitmine (xsd:integer) – Plaanitud ravijuhtude arvu täitmine lepinguperioodis; ▪ summaTaitmine(xsd:decimal) – Täitmise summa erialareal; ▪ valuuta (xsd:string) – rea summa valuuta; ▪ rjkm (xsd:decimal) – Ühe ravijuhu planeeritud keskmine maksumus; ▪ rjkmTaitmine(xsd:decimal) – Ühe ravijuhu keskmine maksumus lepingu täitmisel. • vead – dokumendiga seotud teated, hoiatused ja vead: o item ([0..unbounded]) ▪ tyyp (xsd:string) – teate tüüp, vt 1.5.25; 32/40  ▪ kood (xsd:string) – teate kood; ▪ teade (xsd:string) – teate tekst. 8.3 Reeglid • Teenuse kõik sisendväljad (peale versiooni) on kohustuslikud. • Versiooni täitmata jätmisel koostatakse päring vaikimisi versioonile ’L01’. • Teenuse vastuses tagastatakse rahalise sisu hierarhiana mille tasemeid kirjeldavad reaID ja ylemineId väljad, hierarhias on maksimaalselt 3 taset. Hierarhia kõrgeim tase on küsitud rahalise lisa summaarne info (plaan ja täitmine) kus reaId = 1, elemendis Eriala/nimi on tekst KOKKU. Iga järgnev rida viitab endale eelnevale tasemele (väli ylemineId). Rahaline lisa on jaotatud osadeks ptk 1.5.26 tunnuste kaupa. st järgmine element(item) on nt: <reaId>A</reaId> <ylemineId>1</ylemineId> <eriala> <kood/> <nimi>Ambulatoorne</nimi> </eriala> st element viitab kokku reale ning on ise summarne rida A ehk Ambulatoorse ravi andmetele. kõik A (ambuilatoorse) rea alamelemendid viitavad ylemineId viitega talle jne Nt: A (Ambulatoorne) alamelement ja tema alamad: A00000001 (eriala = '71300501' tekst = 'Ortopeedia' asukoht->kood = '0793,0171') A00000001-1 (eriala = '71300501' tekst = 'Ortopeedia' asukoht->kood = '0793') A00000001-2 (eriala = '71300501' tekst = 'Ortopeedia' asukoht->kood = '0171') 8.4 Vead Kood Teade Selgitus 001 Ebapiisavad sisendid Sisendina antud andmed ebapiisavad 002 Vasteid ei leitud Päringule vasteid ei leitud 33/40 9 Rahalise ettepanekute päring kirst.leping_ettepanek_vaatamine Teenus kuvab rahalise lisa struktuuri koos partneri ettepaneku ning halduri otsuse väljadega. 9.1 Sisend • xtee:allasutus / xtee:asutus (xsd:string) – andmeid esitava asutuse kood, päringu X- tee päise väli; • lepinguLiik (xsd:string) – Rahalise lisa lepingu liik, vt ptk 1.5.22; • aasta (xsd:integer) – Rahalise lisa aasta nt 2019; • poolaasta (xsd:string) – Rahalise lisa poolaasta, vt ptk 1.5.23; • versioon (xsd:string) – Lepingu versioon vt ptk 1.5.21. 9.2 Väljund • ettepanekuDetail – Rahalise lisa read: o item [0..n] ▪ reaId (xsd:string) – Rea identifikaator (kõrgeim tase 1, sellele järgnevad vastavalt loendile vt ptk 1.5.26); ▪ ylemineId (xsd:string) – Rea ülemise taseme identifikaator; ▪ eriala – Rahalise lisa eriala • kood (xsd:string) – Eriala kood, vt ptk 1.5.2; • nimi (xsd:string) – Eriala nimi (eriala koodi puudumisel ptk 1.5.26 loendi elemendi nimetus); ▪ teenusKoht – Ravijuhu asukoht/asukohad(kui eriala on planeeritud mitmes eri asukohas siis kõrgemal tasemel näidatakse eriala koguinfot ja kõiki asukohti nt TARTU,ELVA) ; • kood (xsd:string) – Asukoha/asukohtade EHAK kood; • nimi (xsd:string) – Asukoha/asukohtade nimi; ▪ rjArv (xsd:integer) – Plaanitud ravijuhtude arv; ▪ summa (xsd:decimal) – Plaanitud rea summa; ▪ valuuta (xsd:string) – Rea summa valuuta; ▪ rjkm (xsd:decimal) – Ühe ravijuhu planeeritud keskmine maksumus; ▪ rjProtsent1Pa (xsd:decimal[0..1]) – Ravijuhtude protsent esimeses poolaastas (alates 2019 aastast); ▪ ettepanek – Rahalise lisa ettepanek • pohjus (xsd:string) – Ettepaneku põhjus 1.5.27; • kommentaar (xsd:string[0..1]) – Ettepaneku kommentaar; • rjArv (xsd:integer) – Ravijuhtude arv; 34/40  • summa (xsd:decimal) – Rea summa; • rjkm (xsd:decimal) – Ühe ravijuhu keskmine maksumus; • rjProtsent1Pa (xsd:decimal[0..1]) – Ravijuhtude protsent esimeses poolaastas (alates 2019 aastast); • sisestaja (xsd:string) – Ettepaneku sisestaja; • aeg (xsd:date) – Ettepaneku sisestamise kuupäev; ▪ otsus [0..1] – Rahalise lisa ettepaneku otsus (halduri): • otsus (xsd:string) – Esitatud ettepaneku otsus 1.5.28; • kommentaar (xsd:string[0..1]) – Otsuse kommentaar; • rjArv (xsd:integer) – Ravijuhtude arv; • summa (xsd:decimal) – Rea summa; • rjkm (xsd:decimal) – Ühe ravijuhu keskmine maksumus; • rjProtsent1Pa (xsd:decimal[0..1]) – Ravijuhtude protsent esimeses poolaastas (alates 2019 aastast); • sisestaja (xsd:string) – Otsuse sisestaja; • aeg (xsd:date) – Otsuse sisestamise kuupäev; • ettepanekuStaatus (xsd:string[0..1]) – Ettepaneku staatus 1.5.29; • vead – dokumendiga seotud teated, hoiatused ja vead: o item ([0..unbounded]) ▪ tyyp (xsd:string) – teate tüüp, vt 1.5.25; ▪ kood (xsd:string) – teate kood; ▪ teade (xsd:string) – teate tekst. 9.3 Reeglid • Teenuse kõik sisendväljad on kohustuslikud. • Teenuse vastuses tagastatakse rahalise sisu hierarhiana mille tasemeid kireldavad reaID ja ylemineId väljad, hierarhias on maksimaalselt 3 taset. Hierarhia kõrgeim tase on küsitud rahalise lisa summaarne info (plaan ja täitmine) kus reaId = 1, elemendis Eriala/nimi on tekst KOKKU. Iga järgnev rida viitab endale eelnevale tasemele (väli ylemineId). Rahaline lisa on jaotatud osadeks ptk 1.5.26 tunnuste kaupa. st järgmine element(item) on nt: <reaId>A</reaId> <ylemineId>1</ylemineId> <eriala> <kood/> <nimi>Ambulatoorne</nimi> </eriala> 35/40  st element viitab kokku reale ning on ise summarne rida A ehk Ambulatoorse ravi andmetele. kõik A (ambuilatoorse) rea alamelemendid viitavad ylemineId viitega talle jne Nt: A (Ambulatoorne) alamelement ja tema alamad: A00000001 (eriala = '71300501' tekst = 'Ortopeedia' asukoht->kood = '0793,0171') A00000001-1 (eriala = '71300501' tekst = 'Ortopeedia' asukoht->kood = '0793') A00000001-2 (eriala = '71300501' tekst = 'Ortopeedia' asukoht->kood = '0171') 9.4 Vead Kood Teade Selgitus 001 Ebapiisavad sisendid Sisendina antud andmed ebapiisavad 002 Vasteid ei leitud Päringule vasteid ei leitud 36/40 10 Rahalise ettepanekute saatmine kirst.leping_ettepanek_saatmine Teenus võimaldab saata ettepanekuid erialadele antud lepinguliigi ja perioodi lõikes. 10.1 Sisend • xtee:allasutus / xtee:asutus (xsd:string) – andmeid esitava asutuse kood, päringu X- tee päise väli; • lepinguLiik (xsd:string) – Rahalise lisa lepingu liik, vt ptk 1.5.22; • aasta (xsd:integer) – Rahalise lisa aasta; • poolaasta (xsd:string) – Rahalise lisa poolaasta, vt ptk 1.5.23; • versioon (xsd:string) – Lepingu versioon vt ptk 1.5.21; • esita (xsd:boolean) – Esita ettepanek; • kinnita (xsd:boolean) – Kinnita esitatud andmed ilma muudatusi tegemata; • ettepanekud[0..1] – Rahalise lisa ettepanekud: o item [1..n] ▪ erialaKood (xsd:string) – Eriala kood; ▪ lepTeenusGrupp (xsd:string) – Lepingu rahalise lisa teenuste grupp 1.5.26; ▪ teenusKoht (xsd:string) – Tervishoiuteenuse osutamise koht vastavalt „Eesti haldus- ja asustusjaotuse klassifikaatorile (EHAK-i kood), linna või valla tasemel, Tallinnas linnaosa tasemel; ▪ rjArv (xsd:integer) – Ravijuhtude arv; ▪ summa (xsd:decimal) – Rea summa; ▪ rjProtsent1Pa (xsd:decimal]) – Ravijuhtude protsent esimeses poolaastas; ▪ rjkm (xsd:decimal) – Ühe ravijuhu keskmine maksumus; ▪ pohjus (xsd:string) – Ettepaneku põhjus 1.5.27; ▪ kommentaar (xsd:string[0..1]) – Ettepaneku kommentaar. 10.2 Väljund • vead – dokumendiga seotud teated, hoiatused ja vead: o item ([0..unbounded]) ▪ tyyp (xsd:string) – teate tüüp, vt 1.5.25; ▪ kood (xsd:string) – teate kood; ▪ teade (xsd:string) – teate tekst. 10.3 Reeglid • Saadetakse vaid erialad, millele soovitakse ettepanekut saata 37/40  • Täites välja ’esita’, saadetakse andmed haldurile ning muudatuste tegemine enne halduri otsuste saabumist ei ole võimalik. 10.4 Teated Kood Teade Selgitus Partner saab teha veel täiendavaid 003 Andmed edukalt salvestatud muudatusi Andmed edastatud haldurile, 006 Andmed edukalt edastatud muudatusi enne otsuste tegemist teha ei saa 001 Ebapiisavad sisendid Sisendina antud andmed ebapiisavad 002 Vasteid ei leitud Päringule ei leitud vasteid 005 Vorm juba esitatud Ettepanek on juba haldurile edastatud Ettepaneku saatmiseks täida Ühel või mitmel ettepaneku real on 008 rea kohustuslikud väljad puudu kirjeldatud kohustuslikud (põhjus, RJ, RJKM)! väärtused 38/40 11 Rahalise ettepanekute logi kuvamine kirst.leping_ettepanek_logi Teenus kuvab rahalise lisa erialaga saadetuid ettepanekuid. 11.1 Sisend • xtee:allasutus / xtee:asutus (xsd:string) – andmeid esitava asutuse kood, päringu X- tee päise väli; • lepinguLiik (xsd:string) – Rahalise lisa lepingu liik, vt ptk 1.5.22; • aasta (xsd:integer) – Rahalise lisa aasta; • poolaasta (xsd:string) – Rahalise lisa poolaasta, vt ptk 1.5.23; • versioon (xsd:string) – Lepingu versioon vt ptk 1.5.21; • lepTeenusGrupp (xsd:string) – Lepingu rahalise lisa teenuste grupp, 1.5.26; • erialaKood (xsd:string) – Eriala kood; • teenusKoht (xsd:string[0..1]) – Tervishoiuteenuse osutamise koht vastavalt „Eesti haldus- ja asustusjaotuse klassifikaatorile (EHAK-i kood), linna või valla tasemel, Tallinnas linnaosa tasemel. 11.2 Väljund • ettepanekLogi – Rahalise lisa read: o item [0..n] – Rahalise lisa rida ▪ eriala – Lepingu eriala • kood (xsd:string) – Eriala kood, vt ptk 1.5.2; • nimi (xsd:string) – Eriala nimi (eriala koodi puudumisel ptk 1.5.26 loendi elemendi nimetus); ▪ teenusKoht– Ravijuhu asukoht/asukohad(kui eriala on planeeritud mitmes eri asukohas siis kõrgemal tasemel näidatakse eriala koguinfot ja kõiki asukohti nt TARTU,ELVA) ; • kood (xsd:string) – Asukoha/asukohtade EHAK kood; • nimi (xsd:string) – Asukoha/asukohtade nimi; ▪ ettepanek [0..1] – Rahalise lisa ettepanek: • pohjus (xsd:string) – Ettepaneku põhjus 1.5.27; • kommentaar (xsd:string[0..1]) – Ettepaneku kommentaar; • rjArv (xsd:integer) – Ravijuhtude arv; • summa (xsd:decimal) – Rea summa; • rjkm (xsd:decimal) – Ühe ravijuhu keskmine maksumus; • rjProtsent1Pa (xsd:decimal[0..1]) – Ravijuhtude protsent esimeses poolaastas (alates 2019 aastast); 39/40  • sisestaja (xsd:string) – Ettepaneku sisestaja; • aeg (xsd:date) – Ettepaneku sisestamise kuupäev; ▪ otsus [0..1] – Rahalise lisa ettepaneku otsus (halduri): • otsus (xsd:string) – Esitatud ettepaneku otsus 1.5.28; • kommentaar (xsd:string[0..1]) – Otsuse kommentaar; • rjArv (xsd:integer) – Ravijuhtude arv; • summa (xsd:decimal) – Rea summa; • rjkm (xsd:decimal) – Ühe ravijuhu keskmine maksumus; • rjProtsent1Pa (xsd:decimal[0..1]) – Ravijuhtude protsent esimeses poolaastas (alates 2019 aastast); • sisestaja (xsd:string) – Otsuse sisestaja; • aeg (xsd:date) – Otsuse sisestamise kuupäev; • ettepanekuStaatus (xsd:string[0..1]) – Ettepaneku staatus 1.5.29; • vead – dokumendiga seotud teated, hoiatused ja vead; o item ([0..unbounded]) – kirje töötlemise teated; ▪ tyyp (xsd:string) – teate tüüp, vt 1.5.25; ▪ kood (xsd:string) – teate kood; ▪ teade (xsd:string) – teate tekst. 11.3 Reeglid • Teenuse kõik sisendväljad (v.a. teenuse osutamise koht) on kohustuslikud. 11.4 Vead Kood Teade Selgitus 002 Vasteid ei leitud Päringule ei leitud vasteid 40/40  Eesti Haigekassa Kindlustatud Isikute Register Ettevõtja andmete ja kontaktisikute andmevahetusteenused Teenuste „kirst.ettevotja_andmed.v1“, „kirst.muuda_kontot.v1“, "kirst. ettevotja_kontaktisikud.v1" kirjeldused Sisukord Ettevõtja andmete ja kontaktisikute andmevahetusteenused ..................................................... 1 Teenuste „kirst.ettevotja_andmed.v1“, „kirst.muuda_kontot.v1“, "kirst. ettevotja_kontaktisikud.v1" kirjeldused ................................................................................. 1 1.1 Eesmärk ....................................................................................................................... 3 1.2 Kasutatud nimeruumid ................................................................................................ 3 1.3 Kasutatud lühendid ...................................................................................................... 3 1.4 Viited ........................................................................................................................... 3 1.5 Loendid ........................................................................................................................ 3 1.5.1 Riigi kood................................................................................................................. 3 1.5.2 Kontaktisiku roll ...................................................................................................... 3 1.5.3 Toiming .................................................................................................................... 3 1.5.4 Vead ......................................................................................................................... 4 2 Ettevõtja andmete päring kirst.ettevotja_andmed ............................................................... 5 2.1 Sisend........................................................................................................................... 5 2.2 Väljund ........................................................................................................................ 5 2.3 Vead ............................................................................................................................. 6 3 Ettevõtja arvelduskonto muutmine kirst.muuda_kontot ..................................................... 7 3.1 Sisend........................................................................................................................... 7 3.2 Väljund ........................................................................................................................ 7 3.3 Teated .......................................................................................................................... 7 4 Ettevõtja kontaktisikud kirst.ettevotja_kontaktisikud ......................................................... 8 4.1 Sisend........................................................................................................................... 8 4.2 Väljund ........................................................................................................................ 8 4.3 Vead ............................................................................................................................. 9 1.1 Eesmärk Antud dokument kirjeldab EHK Kindlustatud Isikute Registri (edaspidi: Registri) ettevõtja andmete ja kontaktide haldamise X-tee liideseid. 1.2 Kasutatud nimeruumid Tabel 1 Kasutatud nimeruumid Tähis Nimeruum ehk http://producers.kirst.xtee.riik.ee/producer/kirst SOAP-ENC http://schemas.xmlsoap.org/soap/encoding/ SOAP-ENV http://schemas.xmlsoap.org/soap/envelope/ xsd http://www.w3.org/2001/XMLSchema xrd http://x-road.ee/xsd/x-road.xsd 1.3 Kasutatud lühendid EHK – Eesti Haigekassa TTO – Tervishoiuteenuse osutaja, raviasutus EHAK - Eesti haldus- ja asustusjaotuse klassifikaator RRL – Ravi rahastamise leping 1.4 Viited • X-tee juhendid https://moodle.ria.ee/course/view.php?id=20 • Tervishoiutöötajate erialade loendina kasutatakse E-Tervise SA Publitseerimiskeskuses avaldatud tervishoiutöötajate erialade loetelu http://pub.e- tervis.ee/classifications/Erialad. Eriala tuleb edastada formaadis Ennn (näiteks: E300). 1.5 Loendid 1.5.1 Riigi kood EL kodaniku andmete juures saadetakse arvel kasutatud isikutõendava dokumendi alusel tuvastatud elukoha-/kindlustajariigi kood ISO kahetähelise riigikoodina(ISO 3166 Alpha-2): https://www.iso.org/iso-3166-country-codes.html 1.5.2 Kontaktisiku roll Kood Selgitus 0001 Raviarvete menetlus 0002 Ravikvaliteet 1.5.3 Toiming Kood Selgitus C Lisa R Vaata U Muuda 1.5.4 Vead Kood Selgitus E Error/Viga W Warning/Hoiatus I Info/teadmiseks 2 Ettevõtja andmete päring kirst.ettevotja_andmed Teenus „kirst.ettevotja_andmed.v1“ on mõeldud ettevõtte kontaktandmete lugemiseks ja muutmiseks ettevõtte enda poolt. 2.1 Sisend • xtee:allasutus / xtee:asutus (xsd:string) – andmeid esitava asutuse kood, päringu X- tee päise väli; • kontaktandmed [0..1] – Ettevõtja kontaktandmed: o telefon (xsd:string[0..1]) – Telefon (5-11 kohaline number); o email (xsd:string[0..1]) – E-mail aadress; o kodulehtUrl (xsd:string[0..1]) – Kodulehe aadress; • muuda (xsd:integer) – 0- kuva andmed, 1-muuda andmeid (vaikimisi 0); 2.2 Väljund • asutus [0..1] – Ettevõtja üldandmed: o kood (xsd:string) – Ettevõtja registrikood; o nimi (xsd:string[0..1]) – Ettevõtja nimi; • kontaktandmed [0..1] – Ettevõtja kontaktandmed: o telefon (xsd:string[0..1]) – Telefon (5-11 kohaline number); o email (xsd:string[0..1]) – E-mail aadress; o aadress [0..1] – Aadressi struktuur; ▪ riik (xsd:string) – Riik, loend, vt 1.5.1; ▪ riikTekst (xsd:string[0..1]) – Riigi nimetus; ▪ ehak (xsd:string[0..1]) - Haldusüksus; ▪ maakond (xsd:string[0..1]) – Maakond (välisaadressi korral); ▪ linn (xsd:string[0..1]) – Linn (välisaadressi korral); ▪ tanav (xsd:string[0..1]) - Tänav; ▪ maja (xsd:string[0..1]) - Maja nr või talu nimi; ▪ korter (xsd:string[0..1]) - Korteri number; ▪ indeks (xsd:string) - Sihtnumber; o kodulehtUrl (xsd:string[0..1]) – Kodulehe aadress; • arveldusarve [0..1] – Ettevõtja arveldusarve info: o arve (xsd:string) – Arveldusarve number IBAN formaadis; o omanik (xsd:string[0..1]) - Arve omanik (kui esitaja ei ole arveldusarve omanik);  • lepingukontaktid – Lepingukontaktid: o item [0..n] – lepingukontakt: ▪ isikuandmed – Isiku andmed: • isikukood (xsd:string[0..1]) – Isikukood; • perenimi (xsd:string[0..1]) - Perenimi; • eesnimi (xsd:string[0..1]) - Eesnimi; ▪ sidevahendid – kontaktisiku sidevahendid: • telefon (xsd:string[0..1]) – Telefon (5-11 kohaline number); • email (xsd:string[0..1]) – E-mail (peab sisaldama @ märki); ▪ roll (xsd:string[0..1]) – Roll, loend, vt 1.5.2; ▪ markus (xsd:string[0..1]) – Märkused (kuni 40 tähemärki); ▪ kehtibAlatesKp (xsd:date[0..1]) – Kontaktisik alates; ▪ kehtibKuniKp (xsd:date[0..1]) – Kontaktisik kuni; • vead – töötlemisega seotud teated, hoiatused ja vead; o item ([0..n]) – kirje töötlemise teated; ▪ tyyp (xsd:string) – teate tüüp, vt 1.5.4; ▪ kood (xsd:string) – teate kood; ▪ teade (xsd:string) – teate tekst. 2.3 Vead Kood Teade Selgitus Isikut (Type=, Number=) ei leitud, uue isiku 324 Ettevõtja andmeid ei leitud (BP) loomine keelatud. 003 Ebakorrektne e-mail Lubatud märgid +0123456789 004 Ebakorrektne telefoninumber pikkusega 5 - 11 Kontaktandmete (telefon, e-mail, 002 Andmete sisestamisel tekkisid vead kodulehe aadress) salvestamisel tekkis viga 3 Ettevõtja arvelduskonto muutmine kirst.muuda_kontot Teenus „kirst.muuda_kontot.v1“ on mõeldud ettevõtte arvelduskonto info muutmiseks ettevõtte enda poolt. 3.1 Sisend • xtee:allasutus / xtee:asutus (xsd:string) – andmeid esitava asutuse kood, päringu X- tee päise väli; • arveldusarve – Ettevõtja arveldusarve info: o arve (xsd:string) – Arveldusarve number IBAN formaadis; o omanik (xsd:string[0..1]) - Arve omanik (kui esitaja ei ole arveldusarve omanik). o muudetav (xsd:string[0..1]) – Ei ole kasutusel o tyyp (xsd:string[0..1]) – Ei ole kasutusel 3.2 Väljund • kood (xsd:string) – Teate kood; • teade (xsd:string) – teate tekst; 3.3 Teated Kood Teade Selgitus 355 Kontrolli arve numbri IBAN formaati Arvelduskonto numbris on viga 100 Pangakonto muutmine õnnestus Muutmisel tekkis viga Tundmatu kood asutuse/allasutuse 326 Uue isiku loomine ebaõnnestus. väljas 4 Ettevõtja kontaktisikud kirst.ettevotja_kontaktisikud Teenus „kirst.ettevotja_kontaktisikud.v1“ on mõeldud ettevõttega seotud kontaktisikute info haldamiseks ettevõtte enda poolt. 4.1 Sisend • xtee:allasutus / xtee:asutus (xsd:string) – andmeid esitava asutuse kood, päringu X- tee päise väli; • kontaktisik [0..1] – kontaktisiku struktuur: o isikuandmed [0..1] – Isiku andmed: ▪ isikukood (xsd:string) – Isikukood; o sidevahendid [0..1] – kontaktisiku sidevahendid: ▪ telefon (xsd:string[0..1]) – Telefon (5-11 kohaline number); ▪ email (xsd:string[0..1]) – E-mail aadress; o roll (xsd:string[0..1]) – Roll, loend, vt 1.5.2; o markus (xsd:string[0..1]) – Märkused (kuni 40 tähemärki); o kehtibAlatesKp (xsd:date[0..1]) – Kuupäev millest alates on isik ettevõtte kontaktisik märgitud rollis; o kehtibKuniKp (xsd:date[0..1]) – Kontaktisiku seose/volituse lõpp; • toiming (xsd:string[0..1]) – Lisa/Vaata/Muuda (Vaikimisi ’R’ – Vaata), loend, vt 1.5.3; 4.2 Väljund • kontaktisikud – Kontaktisikud: o item [0..n] – Kontaktisik: ▪ isikuandmed – Isiku andmed: • isikukood (xsd:string[0..1]) – Isikukood; • perenimi (xsd:string[0..1]) - Perenimi; • eesnimi (xsd:string[0..1]) - Eesnimi; ▪ sidevahendid – kontaktisiku sidevahendid: • telefon (xsd:string[0..1]) – Telefon (5-11 kohaline number); • email (xsd:string[0..1]) – E-mail (peab sisaldama @ märki); ▪ roll (xsd:string[0..1]) – Roll, loend, vt 1.5.2; ▪ markus (xsd:string[0..1]) – Märkused (kuni 40 tähemärki); ▪ kehtibAlatesKp (xsd:date[0..1]) – Kontaktisik alates; ▪ kehtibKuniKp (xsd:date[0..1]) – Kontaktisik kuni;  • vead – dokumendiga seotud teated, hoiatused ja vead; o item ([0..n]) – kirje töötlemise teated; ▪ tyyp (xsd:string) – teate tüüp, vt 1.5.4; ▪ kood (xsd:string) – teate kood; ▪ teade (xsd:string) – teate tekst. 4.3 Vead Kood Teade Selgitus 001 Lubamatu toiming Saadeti lubamatu toimingu tüüp 002 Andmete sisestamisel tekkisid vead Andmete sisestamisel tekkisid vead 003 Ebakorrektne e-mail Lubatud märgid +0123456789 004 Ebakorrektne telefoninumber pikkusega 5 - 11 Isik ei kuulu ettevõtte kontaktisikute Muudetava isikukoodiga isik ei kuulu 005 nimistusse ettevõtte kontaktisikute nimistusse 006 Ebapiisavad sisendid Ebapiisavad sisendid Antud isikukoodiga isik juba eksisteerib Lisatava isikukoodiga isik kuulub juba 007 ettevõtte kontaktisikuna ettevõtte kontaktisikute nimistusse Sisestatud roll ei kuulu lubatud rollide 008 Ebakorrektne roll loendisse Antud sisenditele vastavaid väljundeid 009 Andmeid ei leitud ei leitud