-
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 .......................................................................................................... 6
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
tellitud 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 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
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 Kui arve number pole antud, siis on alates
või arvele viitav väli kuupäev kohustuslik.
From: Haigekassa Pärnu osakond
Sent: Thursday, 13 September 2018 14:12:00 (UTC+02:00) Helsinki, Kyiv, Riga, Sofia, Tallinn, Vilnius
Subject: [VÄLJAST] Raviarvete edastamise IT lahendused
Tere
Saadame korrigeeritud kirja uuesti. Allpool õige kiri.
Vabandused segaduse tekitamise pärast
Heade soovidega
IRENA KALBUS
Assistent
Pärnu osakond
T: 4 477 666
E:
[email protected]
Lai 14, Pärnu 80010
Meie: 13.09.2018 nr 3-22/29700
Hea partner
Kutsume Sind osalema infohommikul, kus käsitleme uue raviarvete edastamise IT lahendusega
seotud teenuseid ning lahendusega seotud küsimusi ja kommentaare. Infohommik toimub 02.
oktoobril kell 11.00 haigekassa Tallinna kontoris aadressil Lastekodu 48.
Haigekassa jätkab raviarvete edastamise IT lahenduse uuendamise projektiga. Projekti eesmärk on
2019. aasta algusest üle minna uuele raviarvete edastamise lahendusele. Täna kasutusel olevat TORU
lahendust 2019. aasta eest esitatavate raviarvete edastamiseks enam kasutada ei saa. Seetõttu on
oluline, et kõik partnerid juba aegsasti oleksid valmis uuele süsteemile üle minema.
Edastame teile veelkord ka 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.
Palume esitada esimesel võimalusel ka oma kommentaarid ja küsimused, mis antud
teenusekirjelduse dokumenti puudutavad. 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
KALJO POLDOV
Pärnu osakonna direktor
Pärnu osakond
T: + 372 4 477 667
E:
[email protected]
Rüütli 40a, Pärnu