Info edastamine

From: Haigekassa Pärnu osakond Sent: Thursday, 14 June 2018 10:08:45 (UTC+02:00) Helsinki, Kyiv, Riga, Sofia, Tallinn, Vilnius Subject: [VÄLJAST] INFO:Raviarvete teenuse uuendatud dokumentatsioon Meie: 14.06.2018 nr 3-22/20960 Hea partner Haigekassa jätkab projektiga, mille käigus uuendatakse raviarvete edastamise IT lahendust. Edastame teile värskendatud dokumendi teenusekirjelduse osas (teenus on kirjeldatud KIRST andmekogu WSDL-is arendus ja testkeskkonnas). Lahendus on loodud teenuspõhisena ehk nii raviarvete saatmine kui ka tühistamine on võimalik integreerida Teie poolt kasutatavasse tarkvarasse ning seeläbi luua võimalus andmete automaatseks edastamiseks haigekassa infosüsteemi, kokkulepitud ärireeglite alusel. Uued teenused on kättesaadavad X-tee v6 arendus- ja testkeskkonnas ning teenused avame soovijatele sooviavalduse alusel. Värskendatud dokumentatsiooni edastame ka arenduspartneritele. 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). Meeldivat koostööd soovides KALJO POLDOV Pärnu osakonna direktor Pärnu osakond T: + 372 4 477 667 E: [email protected] Rüütli 40a, Pärnu - Eesti Haigekassa Kindlustatud Isikute Register Raviarve saatmise teenus Teenuste „kirst.rta_saatmine.v1“, „kirst.rta_tyhistus.v1“, "kirst.RTA_detail.v1"ja "RTA_koondarve_info.v1" kirjeldused Sisukord Dokumendi versioonid ........................................................................................................... 3 1 Dokumendist ....................................................................................................................... 4 1.1 Eesmärk ....................................................................................................................... 4 1.2 Kasutatud nimeruumid ................................................................................................ 4 1.3 Kasutatud lühendid ...................................................................................................... 4 1.4 Viited ........................................................................................................................... 4 1.5 Loendid ........................................................................................................................ 4 1.5.1 Rahastamise allikas .................................................................................................. 4 1.5.2 Lepingu eriala .......................................................................................................... 4 1.5.3 Patsiendi sugu .......................................................................................................... 7 1.5.4 Väljastanud arsti eriala ............................................................................................. 7 1.5.5 Teenuse tüüp ............................................................................................................ 7 1.5.6 Saabumise liik .......................................................................................................... 7 1.5.7 Diagnoosi liigid ........................................................................................................ 8 1.5.8 Diagnoos .................................................................................................................. 8 1.5.9 Välispõhjus .............................................................................................................. 8 1.5.10 Teenuse tüüp ............................................................................................................ 8 1.5.11 DRG erand ............................................................................................................... 8 1.5.12 Arve lõpetamise põhjus ............................................................................................ 8 1.5.13 Raskusaste ................................................................................................................ 9 1.5.14 Riigi kood................................................................................................................. 9 1.5.15 Isikuttõendava dokumendi liigid.............................................................................. 9 1.5.16 Hamabavalem .......................................................................................................... 9 1.5.17 DMFT indeks ......................................................................................................... 10 1.5.18 Raviarve olek ......................................................................................................... 10 1.5.19 Lepingu koefitsiendi liik ........................................................................................ 10 1.5.20 Raviarve tühistamise põhjus .................................................................................. 10 1.5.21 Vead ....................................................................................................................... 10 2 Üldprotsess ........................................................................................................................ 11 3 Teenuse kirst.rta_saatmine kirjeldus ................................................................................. 13 3.1 Sisend......................................................................................................................... 13 3.1 Väljund ...................................................................................................................... 15 3.2 Reeglid ....................................................................................................................... 16 4 Teenuse kirst.rta_tyhistus kirjeldus .................................................................................. 18 4.1 Sisend......................................................................................................................... 18 4.2 Väljund ...................................................................................................................... 18 4.3 Reeglid ....................................................................................................................... 18 4.4 Teated ........................................................................................................................ 18 5 Teenuse kirst. "RTA_detail.v1" kirjeldus ......................................................................... 19 5.1 Sisend......................................................................................................................... 19 5.2 Väljund ...................................................................................................................... 19 5.3 Teated ........................................................................................................................ 22 6 Teenuse kirst. RTA_koondarve_info.v1 kirjeldus ............................................................ 23 6.1 Sisend......................................................................................................................... 23 6.2 Väljund ...................................................................................................................... 23 6.3 Reeglid ....................................................................................................................... 24 6.4 Teated ........................................................................................................................ 24 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 Tabel 1 Dokumendi versioonid 1 Dokumendist 1.1 Eesmärk Antud dokument kirjeldab EHK Kindlustatud Isikute Registri (edaspidi: Registri) raviarvete saatmise ja tühistamise X-tee liideseid “kirst.rta_saatmine“ ja “kirst.rta_tyhistus“. 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 1.4 Viited • X-tee juhendid https://www.ria.ee/x-tee-juhendid/ • 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 Rahastamise allikas Kood Selgitus RA Kindlustatud isiku eriarstiabi raviarve, RRL 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 71100101 Noorte reproduktiivtervise arendamine 71100102 Rinnavähi varajane avastamine 71100103 Emakakaelavähi varajane avastamine 71100112 Soolevähi varajane avastamine 71200008 Perearstide uuringufond 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 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 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 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 Teenuse 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 31 hambaproteeside rahaline hüvitis 33 hambaravi vähemalt 19-aastastele 34 meditsiinilisel näidustusel üldanesteesias hambaravi 1.5.6 Saabumise liik NB! Tehtud ettepanek kasutada loendit http://pub.e- tervis.ee/classifications/Patsiendi%20p%C3%B6%C3%B6rdumise%20viis/2 Kood Selgitus T0001 Kiirabi T0002 Tuli ise T0003 Tagasikutse T0004 Politsei T0005 Eriarsti ambulatoorselt ravilt T0007 Üldhaiglast statsionaarselt või päevaravilt T0008 Keskhaiglast statsionaarselt või päevaravilt T0009 Piirkondlikust haiglast statsionaarselt või päevaravilt T0010 Muu tervishoiuteenuse osutaja statsionaarselt või päevaravilt T0011 Perearst T0012 Muu saabumine T0013 E-konsultatsioonilt ravi ülevõtmisega 1.5.7 Diagnoosi liigid Kood Selgitus 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 DRG DRG kood 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 NB! Tehtud ettepanek kasutada loendit: http://pub.e- tervis.ee/classifications/Patsiendi%20seisund%20haiglast%20v%C3%A4ljakirjutamisel/3 Kood Selgitus 1 Suunatud sama tervishoiuteenuse osutaja teise eriarsti ambulatoorsele vastuvõtule 2 Suunatud sama tervishoiuteenuse osutaja statsionaarsele ravile 3 Suunatud teise tervishoiuteenuse osutaja eriarsti ambulatoorsele vastuvõtule 5 Suunatud teise tervishoiuteenuse osutaja (üldhaigla) statsionaarsele ravile 6 Suunatud teise tervishoiuteenuse osutaja (keskhaigla) statsionaarsele ravile 7 Suunatud teise tervishoiuteenuse osutaja (piirkondlik haigla) statsionaarsele ravile Suunatud teise tervishoiuteenuse osutaja statsionaarsele ravile (v.a üldhaigla, keskhaigla, 8 piirkondlik haigla) 9 Lahkunud omavastutusel arsti soovitusi arvestamata 10 Surnud 11 Muud põhjused 12 Suunatud sama tervishoiuteenuse osutaja päevaravile 13 Suunatud teise tervishoiuteenuse osutaja päevaravile Kutsutud tagasi sama eriarsti ambulatoorsele vastuvõtule (sama tervishoiuteenuse 14 osutaja) 15 Paranemine või tervistumine 16 Suunatud perearsti vastuvõtule ja jälgimisele 1.5.13 Raskusaste Täna kokku lepitud kasutamine diagnooside I10-I15 (kohustuslik) ja C00-D48 (võimalik) korral. Kood Selgitus Määramata 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 Isikuttõ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 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 Vead Kood Selgitus E Error/Viga W Warning/Hoiatus I Info/teadmiseks 2 Üldprotsess 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 koos DRG kodeerimise ja maksumuse arvutamise tulemustega. Vigade tekkimisel esitatakse raviarve andmed koos vigadega. Ü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 ühekaupa. 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 tee rahalise lisa vastu kontrolli, ei salvesta test-raviarveid ja ei arvesta neid lepingu rahalise lisa täitmises. 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 (hkID) 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 hkID 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 esitab perioodiliselt (nt kord päevas) Haigekassale raviarvete andmete päringu ja alles arve kohale jõudmise kinnitamisel märgib TTO infosüsteem arve edukalt edastatuks. 1.2.5. Haigekassa koostab perioodiliselt (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. 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 hkID, mis on unikaalne üle kõigi TTO-de ja üle kogu ajaloo. 3. Haigekassa väljastab partnerile hkID raviarve vastuses. Edasises andmevahetuses (näiteks koondarves raviarvele viitamiseks) kasutatakse hkID-d. Seega TTO peab enda süsteemis säilitama raviarve vastuses saadud hkID. 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. Tagasilükatud raviarve sisu kaotab tähtsuse ja seda Haigekassa süsteemis ei säilitata. 4. TTO võib esitada tagasilükatud raviarve peale täiendamist uuesti. 5. 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 hkID koos tühistamise põhjusega. 2. Haigekassa kontrollib tühistamise võimalikkust (kas tühistatav raviarve on olemas, kas vastav kuluperiood pole suletud ja kas raviarve esitamisest möödunud päevade arv ei ületa seadistuses määratavat aega) 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 haigekassas arve kohta kreeditkanne. 3 Teenuse kirst.rta_saatmine kirjeldus Teenus „kirst.rta_saatmine“ on mõeldud raviarve esitamiseks EHK-sse. Teenus toimib sünkroonselt. 3.1 Sisend • testimine [0..1] (xsd:boolean) – Tunnus mis näitab kas raviarve läheb testimisele või on tegemist arve edastamisega. • 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:integer[0..1]) – antud raviarve kulu kandja Näiteks: 74000091 (Eesti Haigekassa), 70006292 (Tervise Arengu Instituut) jne. Vaikimisi loetakse väärtuseks Eesti Haigekassa. 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 saabumiseLiik (xsd:string), loend – Ravile saabumise liigi kood vastavalt Sotsiaalministri kehtestatud määrusele. Formaat täht pluss 4 numbri, vt 1.5.6 o lopetamisePohjus (xsd:string), loend – Raviarve lõpetamise põhjuse kood vastavalt Sotsiaalministri määrusele. vt 1.5.10 o arstiKood (xsd:string) – Arve esitanud tervishoiutöötaja kood. Näiteks: D02364, koode väljastabTerviseamet (loend) o arstiEriala (xsd:string) – arsti eriala, vt 1.5.4 o suunanudArstiKood (xsd:string[0..1]) – Ravile suunanud tervishoiutöötaja kood. Näiteks: D02364, koode väljastab Terviseamet (loend) o jargarve (xsd:integer[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 o tvlJuhtum (xsd:string[0..1]) – raviarvega seotud TVL juhtumi esmase lehe haigekassa poolne number 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.2(M/N) ▪ elukohaRiik (xsd:string) – 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 • teenusKogus (xsd:decimal) – osutatud teenuse kogus (kuni 3 komakoha täpsusega). Statsionaarses ravis on voodipäevade korral voodipäevade arv. • emo (xsd:boolean[0..1]) – erakorralise meditsiini osakonnas osutatud teenuse korral väärtus true • teenusKoefVaartus (xsd:decimal) – väärtus, 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 ▪ elDokumendiNumber (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, arveid töödeldakse järjekorra numbri alusel. ▪ arveNumber (xsd:string) – raviarve asutusepoolne number ▪ loodudKp (xsd:date[0..1]) – esitatud raviarve esitamise 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 • drg[0..1] – DRG andmed o drgTeenus (xsd:string) – raviarvele omistatud DRG kood o drgErand (xsd:string) – raviarvele omistatud DRG erandi tunnus, vt 1.5.11 o drgPiirhind (xsd:decimal) – DRG piirhind o drgMaksumus (xsd:decimal) – DRG maksumus o drgOsakaal (xsd:decimal) – DRG osakaal • 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 • arveTeenused – raviarve teenuste vastuste massiiv o item [1..n] – raviarve teenuse vastus ▪ teenusKood (xsd:string) – teenuse TTL kood ▪ teenusPiirhind (xsd:decimal) – teenuse piirhind ▪ teenusKogus (xsd:decimal) – osutatud tervishoiuteenuse kogus ▪ 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 – 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 massiv • item [0..n] – raviarve teade o tyyp (xsd:string), loend – teate tüüp, vt 1.5.21 o kood (xsd:string) – teate kood o teade (xsd:string) – teate kirjeldus 3.2 Reeglid • Arvel on märgitud üks lepingu eriala(konto) nt üldarstiabi teenused, mis jaotuvad nt erinevate fondide vahel saadetakse eraldi isikukohaste arvena. • 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 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 ja järgarve puhul juhtumi esimese arvega ning saadetud dokumendi viiteid kontrollitakse haigekassa andmete vastu, kui viidatud dokumente pole olemas siis antakse saatjale viga. • 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 (vt allpool) • Sisuliste kontrollide loend publitseeritakse eraldi. 4 Teenuse kirst.rta_tyhistus kirjeldus Teenus „kirst.rta_tyhistus“ on mõeldud raviarve esitamiseks EHK-sse. Teenus toimib sünkroonselt. 4.1 Sisend • raviarveTyhistused – raviarve tühistuste massiiv o item [1..n] – raviarve tühistus ▪ arveHkId (xsd:string) – tühistatava raviarve haigekassa poolne number ▪ pohjendus (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 massiv • item [0..n] – raviarve teade o tyyp (xsd:string), loend – teate tüüp (I,W,E), vt 1.5.21 o kood (xsd:string) – teate kood o teade (xsd:string) – teate kirjeldus 4.3 Reeglid • Koodiga hkId 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 Soovitakse tühistada juba tühistatud juba tühistatud või ebasobivas raviarvet staatuses 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 5 Teenuse kirst. "RTA_detail.v1" kirjeldus Teenus „kirst.rta_detail“ on mõeldud raviarve detailandmete vaatamiseks. Teenus toimib sünkroonselt. 5.1 Sisend • xtee:allasutus / xtee:asutus (xsd:string) – andmeid esitava asutuse kood, päringu X- tee päise väli; • arveHkId (xsd:string) – Alusdokumendi EHK ID. 5.2 Väljund • raviarve – arve detailinfo; o arveHkId (xsd:string) – Alusdokumendi EHK ID; o arveNumber (xsd:string) – Alusdokumendi asutusepoolne number; o kaDeebetNumber(xsd:string[0..1]) – Deebet-koondarve number; o kaKreeditNumber (xsd:string[0..1]) – Kreedit-koondarve number; o teenusKoht (xsd:string[0..1]) – Teenuse osutamise koht; o rahastamiseAllikas (xsd:string) – Rahastamise allikas, vt 1.5.1; o arveTeenusTyyp (xsd:string) – Teenuse tüüp, vt 1.5.5; o arveStaatus (xsd:string) – Raviteenuse arve olek, vt 1.5.18; o algKp (xsd:date) – Alguse aeg; o loppKp (xsd:date) – Lõpu aeg; o loodudKp (xsd:date) – Dokumendi loomise kuupäev; o tyhistatudKp (xsd:date[0..1]) – Dokumendi tühistamise kuupäev; o kaDeebetKp (xsd:date[0..1]) – Deebet-koondarve kuupäev; o kaKreeditKp (xsd:date[0..1]) – Kreedit-koondarve kuupäev; o pohjendus (xsd:string[0..1]) – Põhjendus, vt 1.5.20; o haldur [0..1] (xsd:string) – Haldur; o arveSummad – RTA summad: ▪ kokkuSumma (xsd:decimal) – teenustepõhine summa koos koefitsientidega; ▪ arveSumma (xsd:decimal) – teenustepõhine summa; ▪ valuuta (xsd:string) – Valuuta; o lepinguKoefitsiendid – 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 jargarve (xsd:string[0..1]) – Järgarve; 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, vt 1.5.10; o arstiKood (xsd:string) – Arsti kood; o arstiNimi (xsd:string) – Arsti nimi; o arstiEriala (xsd:string) – Arsti eriala, vt 1.5.4; o suunanudArstiKood (xsd:string[0..1]) – Suunanud arsti kood; 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 ▪ isikukood (xsd:string) – Patsiendi isikukood; ▪ eesnimi (xsd:string) – Patsiendi eesnimi; ▪ perekonnanimi (xsd:string) – Patsiendi perekonnanimi; ▪ patsiendiSynniKp (xsd:date) – Patsiendi sünnikuupäev; ▪ patsiendiSugu (xsd:string) – Patsiendi sugu, vt 1.5.3; ▪ patsiendiElukohaRiik (xsd:string) – Patsiendi elukohariik, vt 1.5.14; o elDokAndmed [0..1] - Teise EL riigi kindlustatu andmed: ▪ dokumendiLiik (xsd:string) - Dokumendi liik, vt 1.5.15; ▪ elDokumendiNumber (xsd:string) – Dokumendi number; ▪ valjastatudKp [0..1] (xsd:date) – Väljastatud kuupäev; ▪ kehtibAlatesKp [0..1] (xsd:date) – Kehtib alates kuupäev; ▪ kehtibKuniKp (xsd:date) – Kehtib kuni kuupäev; ▪ padevaAsutuseKood [0..1] (xsd:string) – Pädeva asutuse kood; o drgErand (xsd:string[0..1]) – DRG erand, vt 1.5.11; 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 arveTeenused – Raviarve teenused: ▪ item ([1..unbounded]) – 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; • teenusKogus (xsd:decimal) – Teenuse kogus; • piirhind (xsd:decimal) – Piirhind; • teenusKoefVaartus (xsd:decimal) – väärtus, murdarv kuni kolme komakoha täpsusega– (täna väli „koefitsient1“) • maksumus (xsd:decimal) – Maksumus; • valuuta (xsd:string) – Valuuta; • osakaal (xsd:decimal) – Osakaal; • emo (xsd:boolean) – erakorralise meditsiini osakonnas osutatud teenuse korral väärtus true • nullRida (xsd:boolean) – 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..unbounded]) – kirje töötlemise teated; ▪ tyyp (xsd:string) – teate tüüp, vt 1.5.21; ▪ kood (xsd:string) – teate kood; ▪ teade (xsd:string) – teate tekst. 5.3 Teated Tabel 4 Teenuse poolt tagastatavad teated Kood Teade Selgitus 005 Vasteid ei leitud Päringule vasteid ei leitud 6 Teenuse kirst. RTA_koondarve_info.v1 kirjeldus Teenus „kirst. RTA_koondarve_info.v1“ on mõeldud raviarve esitamiseks EHK-sse. Teenus toimib sünkroonselt. 6.1 Sisend • xtee:allasutus / xtee:asutus (xsd:string) – andmeid esitava asutuse kood, päringu X- tee päise väli; • kaAlates (xsd:date[0..1]) – koondarved koostatud alates kuupäevast; • kaKuni (xsd:date[0..1]) – koondarved 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]) – koondarve id. 6.2 Väljund • raviarved – lähtearvete massiiv; o item ([0..unbounded]) – alusdokumendi rida; ▪ arveHkId (xsd:string) – alusdokumendi EHK ID; ▪ arveNumber (xsd:string) – alusdokumendi number; ▪ loodudKp (xsd:date) – alusdokumendi kuupäev; ▪ hyvSumma (xsd:decimal[0..1]) – alusdokumendi summa; ▪ hyvSummaValuuta (ehk:valuutaType[0..1]) – alusdokumendi summa valuuta (alati EUR). ▪ kaNumber (xsd:string[0..1]) – koondarve number, juhul kui arve on koondarveldatud; ▪ kaKp (xsd:date) – koondarve koostamise kp; ▪ kaKuluperiood (xsd:string) – koondarve kuluperiood; ▪ arveTyhistatud (xsd:boolean[0..1]) – true kui arve on tühistatud EHK süsteemis. • vead – dokumendiga seotud teated, hoiatused ja vead; o item ([0..unbounded]) – kirje töötlemise teated; ▪ tyyp (xsd:string) – teate tüüp, vt 1.5.21; ▪ kood (xsd:string) – teate kood;  ▪ teade (xsd:string) – teate tekst. 6.3 Reeglid • Kui teenuse sisendis on antud arve_number, siis ei ole alates ja kuni kuupäevade saatmine soovitatav, kuna sellisel juhul tagastataks vaid koondarveldatud arveid. • Kui arve_number pole antud, siis on alates kuupäev kohustuslik. Kuni kuupäev võib olla tühi, sel juhul võetakse ajavahemiku lõpuks tänane kuupäev. Kuupäeva sisendi olemasolul tagastatakse vaid need arved, mis on lisatud antud ajavahemikus koostatud koondarvetesse. • Arve_tyhistatud on true, kui arve on EHK-s tühistatud. Arve tühistatakse arve saatja palvel. Tühistatud arve võib olla ka koondarves, sel juhul koostab haigekassa kreeditarve. 6.4 Teated Tabel 5 Teenuse koond_arve_info teated Kood Teade Selgitus 005 Vasteid ei leitud Päringule ei leitud vasteid 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 või Kui arve number pole antud, siis on alates arvele viitav väli kuupäev kohustuslik.