Informatika | Tanulmányok, esszék » OEP Várólista rendszer, API dokumentáció

Országos Egészségbiztosítási Pénztár OEP Várólista rendszer API dokumentáció Verzió: 1.61 2012. 07 31 Várólista rendszer API dokumentáció Tartalomjegyzék 1 BEVEZETÉS . 3 1.1 1.2 2 A FEJLESZTÉS CÉLJA . 3 VÁLTOZÁSOK . 3 API ELÉRÉS ÉS MŰKÖDÉS . 4 2.1 WEB SZOLGÁLTATÁS AUTHENTIKÁCIÓ 4 2.11 WSS . 5 2.12 TLS . 5 2.13 PKI . 5 3 WEB SZOLGÁLTATÁSON KERESZTÜL ELÉRHETŐ FUNKCIÓK . 6 3.1 KLIENS KÉSZÍTÉSE 6 3.2 A PARAMÉTEREK TÍPUSA ÉS SORRENDJE 6 3.3 EGY VÁRÓLISTA ESETEI (VAROLISTAESETEK) 7 3.31 Kapcsolódó kérdések . 9 3.4 VÁRÓLISTA TRANZAKCIÓ (VAROLISTAKEZELES) 10 3.41 Kapcsolódó kérdések . 14 3.5 VÁRÓLISTA VIZSGÁLAT (VAROLISTAELLENORZES) 20 3.6 VÁRÓLISTA ÉS SAJÁT RENDSZER KÖZÖTTI KOMMUNIKÁCIÓS KAPCSOLAT ELLENŐRZÉSE (PING) 21 ÁLTALÁNOSAN HASZNÁLT HIBAÜZENETEK . 22 4 TESZTRENDSZER . 26 4.1 4.2 TESZT FELÜLET. 26 ÉLES FELÜLET. 30 5 AZ API JAVASOLT HASZNÁLATI MÓDJA. 34 6 FÜGGELÉK . 35 6.1 6.2

KÖTELEZŐEN VÁRÓLISTÁS ELLÁTÁSTÍPUSOK TÁBLÁZATA . 35 HASZNÁLHATÓ TRANZ KODOK ÉS ESET STÁTUSZOK TÁBLÁZATA . 36 2. oldal, összesen: 37 Várólista rendszer API dokumentáció 1 BEVEZETÉS A FEJLESZTÉS CÉLJA 1.1 A Várólista rendszer legfőbb céljai: • várólista kezelés informatikai támogatása az egészségügyi szolgáltatók számára, • várólisták publikus lekérdezési lehetőségének biztosítása a betegek számára, • azonnali, rendszeres és eseti ellenőrzési lehetőségek biztosítása az intézeti, a térségi, az országos várólista felelősök és az OEP számára, • információ biztosítása az egészségügyi kapacitások, ellátások tervezéséhez, ellátásszervezési feladatokhoz A rendszer első lépcsőben a fekvőbeteg ellátásban (az intézményi előjegyzésekre) kerül bevezetésre (képes a 2013-ban kialakítandó térségi várólisták kezelésére is), második lépcsőben pedig (kapacitás-kezeléssel

továbbfejlesztett formában) a járóbeteg ellátásban (a betegfogadási listákra) vezetendő be. A rendszer által biztosított API célja az, hogy a várólista kezelő informatikai megoldással rendelkező intézmények úgy tudjanak kapcsolódni a központi rendszerhez, hogy az ne igényeljen többletmunkát a felhasználóktól. Ehhez • a várólista esetek létrehozás előtti ellenőrzését (varolistaVizsgalat), • az esetek létrehozását és módosítását (varolistaKezeles), • valamint az esetek lekérdezését (varolistaEsetek) támogató webszolgáltatásokat (WS API) hoztunk létre. 1.2 VÁLTOZÁSOK Az alábbiakban a jobb áttekinthetőség érdekében sárga háttérrel szerepeltetjük azokat a mezőleírásokat, amelyeknél az 1.45 verzióhoz képest valamilyen változás történt 3. oldal, összesen: 37 Várólista rendszer API dokumentáció 2 API ELÉRÉS ÉS MŰKÖDÉS A várólista funkcióit az arra jogosult háttérrendszerek szabványos,

webszolgáltatás felületen keresztül a https://varolista.oephu/varolista/oepvarolistaSoapHttpPort címen érhetik el. A várólista teszt környezetének címe: http://tesztjogviszony.oephu/varolista/oepvarolistaSoapHttpPort A teszt környezethez felhasználói elérést a fabri.zz@oephu címről igényelhetnek A W3C definíciója szerint a Web szolgáltatás egy olyan szoftver rendszer, amely támogatja a gép-gép közötti, hálózaton keresztüli kommunikációt. A szolgáltatás kliens oldalról nézve gyakran csak alkalmazás programozói felület (API), amely hálózaton keresztül (például internet) érhető el, és a végrehajtás egy távoli gépen történik, amely a szolgáltatást nyújtja. A W3C által kiadott definíció több, különböző típusú rendszert magába foglal, de az általánosan elterjedt használati mód a SOAP formátumú XML üzenetekkel történő kommunikációt, a felület leírására pedig a WSDL formátumot alkalmazza. A WSDL egy XML

alapú, Web szolgáltatás leíró nyelv. Segítségével a hálózaton keresztül kiajánlott szerver oldali szolgáltatásokkal történő kommunikáció módját lehet leírni. Interneten keresztüli Web szolgáltatáshoz a WSDL, gyakran a SOAP és az XML Schema szabványokkal együtt kerül alkalmazásra A kliens program, amely egy Web szolgáltatáshoz csatlakozik, a WSDL állományokon keresztül tudhatja meg, hogy milyen funkciók érhetők el a szerveren. A szolgáltatásokhoz tartozó speciális adattípusok, a WSDL állományba ágyazhatók XML Schema formátumban. Az OJOTE szolgáltatás visszatérési értékének típusa speciális adattípus, így a WSDL állományban meg kell adni a felépítését. Az XML Schema validációs szándékkal lett létrehozva. Tartalmára nézve olyan szabályok halmaza, amelynek ha egy XML dokumentum megfelel, akkor az a dokumentum valid arra a sémára nézve. A WSDL állománynak tartalmaznia kell a szolgáltatáshoz tartozó üzenetek

formátumát. A megadott formátum meghatározza, hogy az adott üzenet milyen részeket tartalmaz, és azoknak mi a típusa. 2.1 WEB SZOLGÁLTATÁS AUTHENTIKÁCIÓ A Web szolgáltatás nyújtásakor történő authentikációt az alkalmazás szerver végzi, az OASIS WS-Security 1.0 biztonsági szabványának (WSS) megfelelően Az authentikáció kliens oldali teendőit a jól megválasztott SOAP környezet elintézi. Első körben az authentikáció a SOAP üzenet fejlécében elhelyezett felhasználói név és jelszó alapján történik, a későbbiekben X509 tanúsítvány segítségével. 4. oldal, összesen: 37 Várólista rendszer API dokumentáció 2.11 WSS A WS-Security egy kommunikációs protokoll, amely a Web szolgáltatások számára nyújt biztonsági megoldást. A protokoll specifikációkat tartalmaz arról, hogyan lehet az üzenetek integritását és titkosságát megtartani az üzenetváltás alatt (például tanúsítványok alkalmazásával) A Web

szolgáltatás üzenetek integritásának és titkosságának kényszerítése történhet biztonságos szállítási réteg (TLS) alkalmazásával is (például HTTPS protokollon keresztüli üzenetküldéssel) Ez utóbbi jelentősen csökkenti a többletterhelést A WSS a biztonsági szolgáltatásokat a SOAP üzenet fejlécén keresztül nyújtja, az alkalmazás rétegen, így biztosítja a végpontok közötti biztonságot 2.12 TLS Biztonságos szállítási réteg (Transport Layer Security - TLS) és az őse (SSL) titkosító protokollok, amelyek biztonságos adat továbbítást nyújtanak interneten keresztül. A TLS protokoll lehetőséget nyújt az alkalmazások számára, hogy a hálózaton keresztül kommunikáljanak, meghiusítva a hallgatózásokat (eavesdropping), babrálásokat (tampering) és üzenet hamisítást (message forgery). A TLS végpont authentikációt és titkosságot nyújt az interneten keresztüli kommunikáció számára titkosítás alkalmazásával.

Tipikusan csak a szerver authentikált (azonossága garantált), a kliens nem kerül azonosításra Ez azt jelenti, hogy a felhasználó (amely lehet személy, vagy egy alkalmazás, mint például egy Web böngésző) biztos lehet abban, hogy kivel kommunikál. A biztonság következő fokozata, amikor a kommunikáció mindkét fele biztos lehet a másik fél identitásában, ezt kölcsönös azonosításnak hívják. A kölcsönös azonosítás publikus kulcs infrastruktúrát (PKI) igényel, amelyet a kliensre telepíteni kell. A TLS három alap fázist tartalmaz: 1. Egyenrangú egyeztetés a támogatott algoritmusokról 2. Nyilvános kulcsú titkosítás, amely kulcs cserén és tanúsítvány alapú hitelesítésen alapszik 3. Szimmetrikus kód, amely forgalomtitkosításon alapszik A TLS az alkalmazás protokollok alatt (például HTTP, FTP), de a szállítási protokollok (például TCP, UDP) felett helyezkedik el, képes biztonságossá tenni tetszőleges protokollt,

leggyakrabban a HTTP protokollal használják (ez a HTTPS). 2.13 PKI A kriptográfiában a nyilvános kulcsú infrastruktúra (PKI) egy megbízható harmadik fél által lektorált és a felhasználó azonosságára kezességet vállaló intézményen alapszik. Lehetőséget biztosít a nyilvános kulcsok felhasználóhoz történő rendelésére. A nyilvános kulcsok általában tanúsítványokban vannak A PKI lehetőséget biztosít arra, hogy felhasználók azonosítsák egymást, és a tanúsítványban tárolt információk használatával titkosítsák, illetve dekódolják az üzeneteiket. Általánosan a PKI kliens és szerver szoftverből, valamilyen hardver elemből (például smart card) állhat. 5. oldal, összesen: 37 Várólista rendszer API dokumentáció 3 WEB SZOLGÁLTATÁSON KERESZTÜL ELÉRHETŐ FUNKCIÓK A várolista kezelés három funkciót tartalmaz, egyet az esetek lekérdezésére, egyet az eset felvételére/módosítására, egyet pedig a

duplikáció ellenőrzésére. Ezek a szolgáltatások a WSDL állományban kerültek leírásra, amely alapján kliens készíthető. 3.1 KLIENS KÉSZÍTÉSE A legtöbb programozási környezet támogatja a WSDL állomány alapján történő SOAP kliens generálást. A kliens generálása programozási környezettől függően történhet fordítási, illetve futtatási időben. A funkciókhoz tartozó WSDL állomány a mellékletben található. Mind a futtatási időben, mind pedig a fordítási időben generált kliens végpont címe eltérhet a szükségestől, ezt ellenőrizni kell, de még jobb, ha a végpont címét explicit felüldefiniáljuk a megfelelőre. A teszt rendszer esetén a megfelelő végpont cím http://tesztjogviszony.oephu/varolista/oepvarolistaSoapHttpPort, az éles rendszer esetén https://varolista.oephu/varolista/oepvarolistaSoapHttpPort 3.2 A PARAMÉTEREK TÍPUSA ÉS SORRENDJE Az egyes webszolgáltatásoik paramétereinek típusa minden

esetben szöveg, ám az egyes mezők tartalma speciális formátumú is lehet. A date (dátum) típusú mezőket ééééhhnn formátumban, a datetime (időpont) típusú mezőket ééééhhnn óó:pp formátumban várjuk, ill adjuk vissza. A szám típusú paramétereknek egész számot kell tartalmazniuk Az egyes webszolgáltatások visszatérési értékeinek sorrendje a jelen dokumentumban megadottól eltérő is lehet (a WSDL generálásakor automatikusan áll be a sorrend), ezért fogadásukhoz a névvel történő azonosításuk ajánlott. A bemenő paraméterek sorrendje viszont kötött, azokat a dokumentációnak megfelelő sorrendben kell a hívásokban szerepeltetni. 6. oldal, összesen: 37 Várólista rendszer API dokumentáció 3.3 EGY VÁRÓLISTA ESETEI (VAROLISTAESETEK) Egy várólista összes (vagy csak összes aktív) esetének lekérdezéséhez, az idegen rendszerek számára. Az intézményi várólista felelős vagy várólista kezelő jogosultságú

felhasználók nevében használható Egy várólista kezelő felhasználó kezelhet több várólistát is, a várólista kezelő felhasználók jogosultságait az országos várólista felelős vagy az intézményi OJOTE adminisztrátor állíthatja be. A várólista felelős az intézmény összes várólistáját láthatja, de nem módosíthatja (kivéve azokat, amelyekre kezelői joga is van). A kezelő a webes kezelőfelületen azokat a várólistákat választhatja ki, amelyekre joga van, a várólista felelős pedig az intézmény összes várólistája közül választhat. varolistaEsetek webszolgáltatás paraméterei Név listakod mindet mikortol esetazonosito Típus szöveg Leírás A várólista kódja Csak az aktív státuszú rekordokat kívánja lekérdezni? szöveg I:igen, N:nem A várólista eset utolsó módosításának dátumára vonatkozó minimum (nem kötelező). A várólistán a datetime legutóbbi adatszinkronizálás vagy adatellenőrzés óta történt

változások lekérdezéséhez hasznos. szöveg Egy konkrét eset azonosítója (nem kötelező). Ezzel egyetlen eset aktuális adatait kérdezhetjük le. Visszatérési értéke egy Varolista struktúrákat tartalmazó lista. a Varolista nevű adatstruktúra attribútumai Név varolista kod esetazonosito tranz kod tranz ok felvetel kelt beteg azon terv ellatas oldalisag taj nev anyjaneve szuletesi datum Típus * szöveg szöveg Leírás Várólista kódja Az eset publikus azonosítója Az eseten végrehajtott utolsó változtatás szöveg mozgásnem-kódja. szöveg Az utolsó változtatás szöveges indoklása. datetime Listára kerülés kelte A várólista eset eredeti azonosítója ezen a szöveg várólistán (az átmeneti időszakban) szám Tervezett OENO kód Oldaliság jele (páros szerven végezhető elszöveg járás esetén) (J/B/P/N) szöveg Beteg TAJ száma szöveg Beteg neve szöveg Beteg anyja neve date Beteg születési dátuma 7. oldal, összesen: 37 Várólista

rendszer API dokumentáció a Varolista nevű adatstruktúra attribútumai Név telefon nem Leírás Beteg telefonszáma Beteg neme (F/N) Beteg lakcíme „irszám település közterület szöveg cim házszám” formátumban . szöveg Beteg e-mail címe email Beutaló intézmény 4 jegyű OEP kódja bekuldo intezmeny szöveg Beutaló szervezeti egység 9 jegyű GYF bekuldo szervezet szöveg kódja. szám Beutaló orvos pecsétszáma bekuldo orvos szöveg BNO kód (betegség kód) betegseg szöveg Területi ellátási kötelezettség státusza (I/N) tek statusz Várólistára vételt kezdeményező intézmény vizsgalo intezmeny szöveg 4 jegyű OEP kódja Várólistára vételt kezdeményező szervezeti vizsgalo szervezet szöveg egység 9 jegyű GYF kódja Várólistára vételt kezdeményező orvos peszám vizsgalo orvos csétszáma Várólistára vételt kezdeményező vizsgálat szöveg v naplosorszam naplósorszáma Tervezett ellátás időpont típuskódja (F:fix, szöveg

idopont tipus V:változtatható) szöveg Sürgősség (A:azonnali, H:halasztható) surgosseg szöveg Előző eset azonosítója (ha van) elozo azon szám Minimális várakozási idő, ha van (nap) min varnap szám Maximális várakozási idő, ha van (nap) max varnap date Megjelenés várható időpontja terv megjelenes datetime Ellátás várható időpontja terv ellatas kelt date Megjelenés tényleges időpontja teny megjelenes datetime Ellátás tényleges időpontja teny ellatas kelt szöveg Tényleges OENO kód (beavatkozás kódja) teny oeno Ellátást végző intézmény 4 jegyű OEP kódszöveg ellato intezmeny ja Ellátást végző szervezeti egység 9 jegyű szöveg ellato szervezet kódja szám Ellátást végző felelős orvos pecsétszáma ellato orvos szöveg Ellátás törzsszáma vagy naplósorszáma naplosorszam szöveg Várólista eset státusza statusz szöveg Megjegyzés megjegyzes Kód 9901 9902 9903 Típus * szöveg szöveg Fontosabb hibaüzenetek Leírás A

felhasználó nem létezik vagy jogosultsága nem megfelelő. A felhasználó nem érvényes. Az intézmény nem érvényes. 8. oldal, összesen: 37 Várólista rendszer API dokumentáció 9904 9905 9999 3.31 A várólista azonosító nem érvényes. A mikortol dátum formátuma nem megfelelő. (Elvárt formátum: éééé.hhnn óó:pp) Egyéb adatbázis hiba Kapcsolódó kérdések Létezik arra valamilyen kialakított API funkció, amelynek segítségével lekérdezhető, hogy egy várólista kezelő felhasználó milyen várólistákat kezel? Nem. Az adminisztrációs felületen látja ezeket az országos várólista felelős Előfordulhat-e, hogy a válaszként visszadott adatstruktúrában olyan eset szerepel, amelynek a felvételét nem az én programom kezdeményezte? Igen. Amennyiben az Ön programjának várólista kezelője webfelületen is be tud lépni a várólista kezelő rendszerben, előfordulhat, hogy a felhasználó webfelületen vesz fel egy esetet

Előfordulhat, hogy egy eset státusza az én rendszeremtől függetlenül megváltozik? Igen, még akkor is, ha a várólista kezelője egyébként nem éri el a webfelületet. Ilyen eset lehet az, amikor a beteg átjelentkezik egy másik várólistára, és az Ön esetének státusza automatikusan DUP státuszra módosul. Kell-e szinkronizálnom a saját rendszeremet a válaszként visszadott adatstruktúrával? Az eset státuszát mindenképpen kell, a többi paraméter szinkronizálását időnként javasoljuk. Mi alapján érdemes szinkronizációt végeznem? Az utolsó módosítás dátuma alapján. A saját rendszerével való szinkronizálás során érdemes az utolsó lekérdezési dátumot (vagy az azt megelőző napot) a szolgáltatás mikortol paraméterben átadnia és használnia, hogy kisebb halmazt kapjon vissza, és valóban csak a nemrég modosult rekordok státuszát (esetleg egyéb adatait) kelljen szinkronizálnia saját környezetével. Milyen gyakran érdemes

várólista eseteket a saját környezetemmel szinkronizálni? Többnyire csak üzemzavar után. Napi egy alkalomnál gyakrabban viszont semmiképp nem ajánljuk a szinkronizációt, mert ez lelassítja az Ön programjának működését is, és a Várólista rendszert is. Megjegyzés: Ha mégis arra lenne kíváncsi, hogy egy eset felvétele sikerült-e (és a visszadott hibakód nem elég biztosíték az Ön számára), használja a varolistaEset szolgáltatást az esetazonosító megadásával. 9. oldal, összesen: 37 Várólista rendszer API dokumentáció 3.4 VÁRÓLISTA TRANZAKCIÓ (VAROLISTAKEZELES) Egy várólista-eset létrehozása vagy módosítása. Bemenő paraméterei közt megvan az eset összes adata (nem csak a változottak). Ha üres az esetazonosító, akkor új esetként kezelendők az adatok, ha pedig meg van adva, akkor az adott esetre vonatkoznak (Azonos kódú várólistán egy azonosító alatt csak egy eset fordulhat elő). A webszolgáltatás

leírásakor a Haszn. mezőben jelöltük azt, hogy egy paraméter értékét milyen műveletek esetén kell megadni Az ú betűvel jelölt paraméter értékeket felvitelkor kell használni. Az m betűseket módosításkor A jelölés után szereplő csillag (*) a kötelezőséget jelöli. Így egy ú*, m jelölésű paraméter megadása pl. felvitelkor és módosításkor is kötelező, míg m betűvel jelölt paramétert csak módosításkor lehet használni, ésmegadása sem kötelező. Az 1.44-es verziótól kezdve a Várólista rendszer az éles környezetben megköveteli, hogy a felvett vagy módosított eset BNO kódja szigorúan kapcsolódjon a tervezett OENO kódhoz. Ezek a párosítások az elfogadott-oeno-bno-parok v1 0.csv-ben találhatók, amelyeket kiküldtünk a várólista felelősöknek és a Várólista rendszer Segédletek lapján, a http://tesztjogviszony.oephu/varolista/docs/ címen fogunk frissítve tartani A 4 jegyű OEP intézménykódok és a szervezeti

egységek (ill. háziorvosok) 9 jegyű GYF kódjai közötti megfeleltetést szintén kiküldtük és a Segédletekben fogjuk frissítve tartani a varolistaKezeles webszolgáltatás paraméterei Név varolista kod Típus szöveg Leírás ú*,m Várólista kódja Az eset publikus azonosítója (ha módosítani szöveg m* esetazonosito kell az esetet, különben üres) Változtatás oka1. Csak módosításkor kell megszöveg m* tranz kod adni. A változtatás szöveges indoklása, szakvéleszöveg m* tranz ok mény. Az eset várólistára regisztrálásának időpontja az API-t hívó rendszer szerint. eredeti felvetel kelt datetime ú*,m (Akkor van jelentősége, ha a program utólagos migrációt végez, egyébként csak tárolásra kerül.2) Haszn. 1 A lehetséges mozgásnemek (tranzakciós kódok) a Függelékben találhatók. Passzív státuszú eset csak a kivezetése utáni 5 hónapban módosítható, és csak HIB (hibajavítás mozgásnemmel) Kivéve a DUP státuszú, amely

a REA (Reaktiválás) mozgásnemmel újra VAR (Várakozó) státuszba tehető, ha bizonyossá válik, hogy téves adatok alapján lett duplikáltnak minősítva (ekkor ugyanezen esetazonosítóval esetleg esen létező VAR státuszú példány kerül automatikusan DUP státuszba). 2 Utólagos migráció a rendszer üzemelése során újonnan létrehozandó várólisták kezdeti adatfeltöltéséhez szükséges, vagy pedig akkor, ha az intézmény hosszabb ideig működött internet kapcsolat nélkül és a felgyűlt nagy számú új várólista esetet és módosítást rövid idő alatt kell feladni az OEP rendszerébe. 10. oldal, összesen: 37 Várólista rendszer API dokumentáció a varolistaKezeles webszolgáltatás paraméterei Név Típus Haszn. beteg azon szöveg ú,m terv ellatas szám ú*,m oldalisag szöveg ú*,m taj nev anyjaneve szuletesi datum telefon nem szöveg szöveg szöveg date szöveg szöveg ú*,m ú*,m ú*,m ú*,m ú, m ú*,m cim szöveg

ú*,m email szöveg ú,m bekuldo intezmeny szöveg ú,m bekuldo szervezet szöveg ú*,m bekuldo orvos szám ú*,m betegseg tek statusz szöveg szöveg ú*,m ú*,m Leírás A várólista eset eredeti azonosítója ezen a várólistán (az átmeneti időszakban) Tervezett OENO kód3 Oldaliság jele (páros szerven végezhető eljárás esetén) (J/B/P/N) Beteg TAJ száma4 Beteg neve Beteg anyja neve Beteg születési dátuma Beteg telefonszáma Beteg neme (F/N) Beteg lakcíme (levelezési cím) Irányítószám település, közterület házszám formátumban. Pl.: 2316 Tököl, Fő u 3 Beteg e-mail címe Beküldő (vagy beutaló) intézmény 4 jegyű OEP kódja. Amennyiben a várólista nem beutalóköteles (pl. sebészet), az eset felvitelekor a beküldő intézmény kódjaként a saját 4 jegyű kódot kell megadni. Beküldő szervezeti egység 9 jegyű kódja. Amennyiben az eset nem beutalóköteles (pl. sebészet), az eset felvitelekor a beküldő szervezeti

egységnek a saját 9 jegyű kódot kell megadni. Beküldő orvos 5 jegyű pecsétszáma. Amenynyiben az eset nem beutalóköteles (pl sebészet), az eset felvitelekor a beküldő szervezeti egységnek a vizsgáló orvoskódját kell megadni. BNO kód5 (betegség kód) Területi ellátási kötelezettség státusza (I/N)6 3 A kötelezően várólistán vezetendő OENO kódok listáját az intézményeknek kiküldött „Összefoglaló az országos on-line/real-time várólista rendszer működéséről” című anyag tartalmazza. Az itt találhatókon kívül az intézmények önállóan is várólistára vehetnek újabb OENO kódokat, az Országos várólista felelős közreműködésével 4 9 számjegyű. A vezető 0-kat a program szükség esetén kiegészíti Teszt környezet esetén a http://jogviszony.oephu/dok címről letölthető teszt adatsorból kell TAJ számot választani 5 Az elfogadott BNO kódok listáját a http://tesztjogviszony.oephu/varolista/docs/ címről

töltheti le Egy adott OENO esetén csak bizonyos (ahhoz tartozó) BNO kódokat fogad el a rendszer, erről az intézmények kaptak listát (a kötelező OENO kódokhoz), a további OENO kódokhoz újabb BNO-OENO párosítás listákat kell kapniuk. 6 Egyelőre a várólista kezelőnek kell megállapítania a területi ellátási kötelezettséget. 11. oldal, összesen: 37 Várólista rendszer API dokumentáció a varolistaKezeles webszolgáltatás paraméterei Név Típus Haszn. vizsgalo intezmeny szöveg ú,m vizsgalo szervezet vizsgalo orvos v naplosorszam szöveg szám szöveg ú*,m ú*,m ú*,m idopont tipus szöveg ú*,m surgosseg elozo azon min varnap max varnap terv megjelenes terv ellatas kelt teny megjelenes teny ellatas kelt teny oeno ellato intezmeny ellato szervezet ellato orvos naplosorszam megjegyzes szöveg szöveg szám szám date datetime date datetime szöveg szöveg szöveg szám szöveg szöveg ú*,m ú, m ú, m ú, m ú*,m ú*,m m m m m m m m

ú, m Leírás Vizsgáló intézmény 4 jegyű OEP kódja. A vizsgáló intézmény az, aki a beteg várólistára vételét kezdeményezi. Vizsgáló szervezeti egység 9 jegyű kódja Vizsgáló orvos 5 jegyű pecsétszáma Vizsgálat naplósorszáma7 Tervezett ellátás időpont típuskódja (F:fix8, V:változtatható) Sürgősség (A:azonnali, H:halasztható) Előző eset esetazonosítója9 (ha van) Minimális várakozási idő, ha van (nap) Maximális várakozási idő, ha van (nap) Megjelenés várható időpontja10 Ellátás várható időpontja Megjelenés tényleges időpontja Ellátás tényleges időpontja Tényleges OENO kód11 (beavatkozás kód) Ellátó intézmény 4 jegyű OEP kódja Ellátó szervezeti egység 9 jegyű kódja Ellátó felelős orvos pecsétszáma Ellátás törzsszáma vagy naplósorszáma12 Megjegyzés13 Visszatérési értéke egy Eset objektum. az Eset nevű adatstruktúra attribútumai 7 Név Típus Leírás Az eset OEP várólista

rendszerbeli azonosítója esetazonosito szöveg felvetel kelt szöveg (A beteg a nyilvános felületen ezzel az azonosítóval tudja saját várólistabeli helyezését lekérdezni. De az API-knak is ezt a mezőt kell átadniuk egy eset adatainak módosítása során) Listára kerülés kelte A várólistára vételt kezdeményező vizsálatnak a teljesítményjelentésben szereplő naplósorszáma. 8 F: a műtét időpontja a beteg kérésére konkrét, nem megváltoztatható időpont (nem lehet korábbi az ugyanakkor listára vett betegek várható ellátási dátumánál). 9 Sorozatműtét esetén a megelőzően elvégzett műtéthez tartozó esetazonosító. 10 A beteg mikor feküdjön be a műtét előtt (többnyire aznap vagy az előző napon). 11 A ténylegesen elvégzett fő ellátás OENO kódja. 12 A törzsszámot alszámozottan kell bevinni, mint a teljesítményjelentésnél. 13 Bármilyen egyéb idevágó információt itt hagyhatnak egymásnak a

várólistát kezelők. 12. oldal, összesen: 37 Várólista rendszer API dokumentáció figyelmeztetes Kód 9901 9902 9903 9904 9999 9125 9126 9145 9154 9143 9137 9100 9101 9103 9104 9105 9106 9107 9108 9139 9138 9109 9158 9112 9113 9115 9156 9146 9147 9118 9119 9120 9121 9122 9123 9124 9152 9153 szöveg Azon hibakódok felsorolása, amelyek nem akadályozták meg a művelet végrehajtását (vesszővel szeparálva). Fontosabb hibaüzenetek Leírás A felhasználó nem létezik vagy jogosultsága nem megfelelő. A felhasználó nem érvényes. Az intézmény nem érvényes. A várólista azonosító nem érvényes. Egyéb adatbázis hiba Az ellátás tervezett időpontjának megadása kötelező! Az ellátás tervezett időpontja nem éééé.hhnn óó:pp formátumú! Érvénytelen a várólista azonosító, vagy a várólista a tervezett ellátás időpontjában még/már nem érvényes. Érvénytelen a várólista kezelő intézménye, vagy a várólista kezelő

intézménye az ellátás tervezett időpontjában még/már nem érvényes. A lezárt várólista esetek nem módosíthatóak! Érvénytelen várólista esetazonosító! A várólista megadása kötelező! A beküldő intézmény megadása kötelező! A területi ellátási kötelezettség státusza kötelező! A területi ellátási kötelezettség státusza csak igen vagy nem lehet! A TAJ megadása kötelező! A TAJ kizárólag 9 karakterből állhat! A név megadása kötelező! Az ellátandó anyja nevének megadása kötelező! A születési dátumnak %s és %s közé kell esnie. Érvénytelen formátumú születési dátumot adott meg. Az email cím formátuma érvénytelen! A beküldő orvos kódjának formátuma nem megfelelő. A BNO megadása kötelező! A vizsgáló intézmény megadása kötelező! A vizsgáló orvos kódjának megadása kötelező! A vizsgáló orvos kódjának formátuma nem megfelelő. A cím megadása kötelező! A nem megadása kötelező! A tervezett

ellátás OENO kódjának megadása kötelező! A tervezett ellátás típusának megadása kötelező! A tervezett ellátás típusa fix vagy változtatható lehet. A tervezett ellátás sűrgősségének megadása kötelező! Az oldaliság értéke jobb, bal, páros, vagy nem lehet! A megjelentés várható időpontjának megadása kötelező! A megjelenés várható időpontja nem éééé.hhnn formátumú! A tényleges megjelenés keltének formátuma nem megfelelő (helyes formátum: éééé.hhnn) A tényleges ellátás keltének formátuma nem megfelelő (helyes formátum: éééé.hhnn óó:pp) 13. oldal, összesen: 37 Várólista rendszer API dokumentáció Fontosabb hibaüzenetek Kód 9157 9131 9136 9132 9134 9135 9133 9150 9149 9140 Leírás Az ellátó orvos kódjának formátuma nem megfelelő. Az ellátáshoz nem kapcsolható BNO kód Érvénytelen vagy nem érvényes a vizsgáló intézmény. Nem létezik a tervezett ellátás OENO kódja. Az előző eset TAJ

száma eltérő. Az előző eset státuszának lezártnak kell lennie. Érvénytelen a várólista azonosító. Nem létezik a tényleges ellátás OENO kódja. A módosítás oka csak módosítás esetén van értelmezve. A módosítás típusa nem létezik. 9171 Az ellenőrizendő TAJ megadása kötelező. 9172 9173 Az ellenőrizendő OENO kód megadása kötelező. Érvénytelen vagy nem létező TAJ. Tájékoztatjuk, hogy a beteg ezzel az ellátás típussal szerepelt egy másik várólistán.; Név: %s; Intézmény: %s; Várólista: %s; Esetazonosító: %s; Listára kerülés időpontja: %s A beteg ezzel az ellátás típussal már szerepel ugyanezen a várólistán; Név: %s; Intézmény: %s; Várólista: %s; Esetazonosító: %s; Listára kerülés időpontja: %s A beteg ezzel az ellátás típussal már szerepel egy másik várólistán, későbbi felvételi dátummal, ezért a felvétel nem lehetséges.; Név: %s; Intézmény: %s; Várólista: %s; Esetazonosító: %s;

Listára kerülés időpontja: %s Passzív státuszú eseten csak a hibajavítás (HIB) művelet hajtható végre. DUP státuszú eseten csak hibajavítás (HIB) és reaktiválás (REA) műveleteket hajthat végre. A beteg ezzel az ellátás típussal már szerepel egy várólistán. A korábbi eset státuszát az utólagos migráció miatt DUP-ra állítottuk.; Név: %s; Intézmény: %s; Várólista: %s; Esetazonosító: %s; Listára kerülés időpontja: %s Az előző kód paraméter értéke nem alakítható számmá. A minimális várakozási nap paraméter nem alakítható számmá. A maximális várakozási nap paraméter nem alakítható számmá. A terv. OENO-hoz nem megengedett a megadott BNO kód felvétele A terv. OENO nem felel meg a várólista típusának A vizsgálat naplósorszámának megadása kötelező. A beteg ezzel az ellátással már szerepel egy másik, későbbi felvételi dátumú, aktív várólistán. A hibajavítást követoen az eset státuszát DUP-ra

változtattuk.; Név: %s; Intézmény: %s; Várólista: %s; Esetazonosító: %s; Listára kerülés időpontja: %s Hiba: Az eset DUP állapotú módosítása nem sikerült. Megj: A beteg ezzel az ellátással már szerepel egy másik, aktív várólistán. 9174 9175 9176 9177 9178 9179 9183 9184 9185 9186 9187 9188 9199 9211 3.41 Kapcsolódó kérdések Milyen jogosultságú felhasználók használhatják ezt a funkciót? 14. oldal, összesen: 37 Várólista rendszer API dokumentáció A várólista esetek beküldésére vagy módosítására kizárólag a várólista kezelő felhasználók jogosultak. Mi a teendő akkor, ha egy létező TAJ számot adok meg, de az OEP rendszere 9173 üzenettel visszautasítja? Ez származhat elírásból, a TAJ nem megengedett státuszából (csak a zöld és piros státusz elfogadott) vagy esetleg az adatbázisbeli adathibából. A problémát az OEP ügyfélszolgálatának kell bejelenteni. Mi a teendőm akkor, ha nem tudom a beteg TAJ

számát? Enélkül nem lehet várólistára venni a beteget. Külföldön élő betegek jelentkezhetnek várólistára? Nem Mi a teendő akkor, ha 9174 vagy 9179 kódú warning üzenetet kapok vissza? Mikor kaphatok ilyen üzenetet? A 9174-es kódú üzenet akkor keletkezik, ha a beteg már máshová (más intézmény várólistájára) is jelentkezett ugyanezen típusú ellátásra. Ekkor a másik (régebbi) jelentkezése automatikusan DUP státuszba kerül és annak az intézménynek a várólista felelőse e-mailt kap erről A 9179 kódú üzenet ugyanezen okból keletkezik, de csak akkor, ha az adott várólista újonnan keletkezett vagy pedig az internet kapcsolat kimaradása után migrációs üzemmódban történik az adatfeltöltés. Mikor kaphatok vissza 9175 kódú hibaüzenetet? Egy várólistán egy adott ellátástípussal csak egy aktív példányban lehet a beteg (korábbi kivezetett ellátásai emellett még létezhetnek). Mi a teendőm akkor, ha egy email értesítés

érkezik hozzám, hogy egy adott TAJ-ú beteget egy másik várólistára felvettek? Mivel a státusza automatikusan DUP-ra állt, módosítási teendő nincs, viszont az ütemtervben megüresedett hely betöltéséről célszerű intézkedni, illetve az új státuszt a saját rendszerben is át kell vezetni. (Ha van időnkénti szinkronizáció, ez automatikusan is megtörténhet) Mi a teendőm akkor, ha észreveszem, hogy a másik várólistára felvett beteg másvalaki? (Mert más a neve, születési dátuma, stb.) Ez a TAJ szám hibás rögzítéséből származhat, erről értesíteni kell a másik intézmény várólista felelősét. (A várólisták felelőseinek elérhetőségéről az orzágos várólista felelősnél érdeklőd- 15. oldal, összesen: 37 Várólista rendszer API dokumentáció jön, vagy keresse fel a www.oephu honlapot14) Ha ő módosítja a TAJ számot, akkor automatikusan reaktiválódik (VAR státuszba kerül vissza) az eset Ha pedig nálunk hibás a

TAJ szám, akkor módosítani kell a TAJ számot és utána egy újabb módosítással reaktiválni az esetet. Mi a teendő akkor, ha nem létezik az adott OENO kód a várólista rendszerében? Újabb OENO kódokat csak az Országos várólista felelős vihet fel a rendszerbe. Mi a teendőm akkor, ha elrontok egy rekordot? Hogyan tudom módosítani? HIB (Hibajavítás) mozgásnemmel, ekkor bármelyik adatmező módosítható (a státusz kivételével). Milyen státuszú eseteket lehet módosítani? Aktív és passzív esetek is módosíthatók utólag, de a passzív státuszú eseteknél a tranz kod mező értékének kizárólag csak a HIB művelet használható. Kivétel: DUP státusz, melynél a REA státusz használata is megengedett. A passzív (kivezetett) esetek csak a kivezetésük utáni 5 hónapban módosíthatók (ez szükséges lehet akkor, ha a várólista eset adathibája miatt nem párosítható valamelyik teljesítményjelentés tétellel. Mit jelent a REA tranz kod?

Reaktiválás. Ez egyrészt a kezdeti migrációban kelhet, ha a beteg a több jelentkezése közül egy korábbi (nem a legutolsó) mellett dönt, vagy pedig ha hibás TAJ szám miatt tévesen állította DUP státuszba a Várólista rendszer automatizmusa. Elegendő csak a nap végén szinkronizálnom a hozzám várólistára felkerülő betegek adatait? Nem, a várólista jelentkezések adatait – amennyiben az Ön és a Várólista rendszer közötti kapcsolat él – azonnal a létrejöttüket vagy módosulásukat követően el kell küldenie! Milyen adatokat érdemes eltárolnom a betegről a saját rendszeremben? Minden olyan adatot, amelyre a beteggel való kapcsolattartáshoz szüksége lehet. A beteggel való kapcsolattartás törvény szerint az intézmény feladata. Mire kell odafigyelnem ennek a funkciónak a készítésekor? Arra, hogy Önnek úgy kell megírnia a saját rendszerét, hogy az 14 a felelősök listája az OEP honlapján jelenleg kialakítás alatt van.

16. oldal, összesen: 37 Várólista rendszer API dokumentáció  akkor is működjön, hogy ha nincs kapcsolat a Várólista rendszer és az Ön rendszere között,  de hibátlan kapcsolat esetén azonnal elküldje a várólista jelentkezés adatait a Várólista rendszerbe. A kapcsolati hiba időtartalma alatt Önnek egy poolban gyűjtenie kell mindazokat a várólista eseteket, melyek időközben megszületnek, majd a kapcsolat helyreállításakor – miután az országos várólista felelős visszaigazolta a kapcsolati hiba kezdetének regisztrációját – be kell be kell küldenie Várólista rendszerbe. A tárolt adatok között el kell tárolnia a várólistára kerülés dátumát is, melyet a kapcsolat helyreállításakor az eredeti felv kelte mezőben kell átadnia. Kinek kell a kapcsolati hibákat bejelenteni? Az országos várólista felelősnek. Be kell jelentenem a várólista felelősnek egy 1-2 órás kimaradást is? Nem. Mi az a kapcsolat kimaradási

idő, mely már bejelentésköteles? Önnek csak azokat a kapcsolat kimaradásokat kell bejelentenie, melyek legalább 12 órán keresztül, huzamosan fennállnak. Elkezdhetem egy bejelentésköteles kimaradt időszak utólagos migrációját anélkül, hogy jelentettem volna a kimaradást? Nem, egy bejelentésköteles kapcsolati hibát követően csak akkor kezdheti el az utólagos migrációt, ha a kapcsolat kiesésének kezdetét bejelentette az országos várólista felelősnek, és a várólista felelős a kiesés kezdődátumát az Ön részére visszaigazolta! Mivel jár, ha nem jelentem be az országos várólista felelősnél a kapcsolati hibát és enélkül kezdem el az utólagos migrációt? Ez esetben minden olyan beteg, aki amíg az Ön és a Várólista rendszer közötti kapcsolat nem élt, más várólistára jelentkezett, most tévesen visszakerül az Ön listájára15. (Ezzel sérülnek a beteg jogai.) Be kell jelentenem a bejelentés köteles kapcsolat

helyreállásának dátumát is a várólista kezelő felé? 15 A várólista rendszerben – az utólagos migráció kivételével – mindig a legutolsó várólista jelentkezés az érvényes. 17. oldal, összesen: 37 Várólista rendszer API dokumentáció Igen, az országos várólista adminisztrátor visszaigazolását azonban az utólagos migráció elindításával már nem kell megvárnia. Mi a teendőm, ha 1 nappal a kapcsolati hiba kezdő dátumának bejelentését követően sem érkezett meg a visszaigazolás az országos várólsita felelőstől? Elkezdhetem az utólagos migrációt? Nem, Önnek ilyenkor sem szabad elvégeznie az utólagos migrációt. Kérjük, vegye fel a kapcsolatot ismételten az országos várólista felelőssel, illetve párhuzamosan keresse OEP helpdesket is. Akkor is be kell jelentenem a Várólista rendszer és a saját rendszerem közötti (bejelentésköteles ideig fentálló) kapcsolati hibát, ha az szerintem a Várólista rendszer

hibájából adódik? Igen, a bejelentési kötelezettség minden kapcsolati hibára vonatkozik. Önnek tehát akkor is be kell jelentenie a kapcsolati hibát az országos várólista felelősnek, ha az Ön szerint Várólista rendszer hibájából származik. Ügyeljen rá, hogy az utólagos migrációt ilyen esetben is csak azután kezdheti el, miután az országos várólista felelős visszaigazolta a bejelentése kezdődátumát. Milyen adatokat kell tartalmaznia az országos várólista felelősnek küldött levélnek? A levélnek mindenképpen tartalmaznia kell:     a kapcsolati hibában érintett várólisták kódjait az Ön nevét egy válasz email címet az Ön telefonos elérhetőségét. Mire kell kiemelten odafigyelnem utólagos migráció esetén? Hogy az eredeti felv kelte nevű mezőt minden esetben átadja az API funkciónak. Ennek hiányában ugyanúgy sérülhetnek a beteg jogai, mintha az utólagos migrációt az országos várólista adminisztrátor

engedélye nélkül kezdte volna el Mi a teendőm akkor, ha az utólagos migráció során hibaüzenetet kapok vissza? Ez esetben javítania kell az adatokat, akár a beteg újbóli felkeresésével is. Szabad-e beküldenem azokat az eseteket, amelyek a Várólista rendszer és az én rendszerem között kommunikációs kapcsolat helyreállását követően születtek? Nem, amíg az országos várólista felelős nem igazolta vissza a bejelentésköteles kapcsolati hiba kezdődátumát. 18. oldal, összesen: 37 Várólista rendszer API dokumentáció Egy eset módosításakor kötelező minden mező értékét megadni? Igen, mert a varolistaKezeles API hívásban felülírásos módszerrel dolgozunk. A webes felület mozgásnemtől függően maszkolja a bekért adatmezők körét, és mindig a teljes módosított rekordot adja át az adatbázisnak. Mi a különbség a beküldő és a vizsgáló fogalmak között? A Beküldő a beutaló intézményt és szervezeti egységet (ill.

háziorvost) jelenti, a Vizsgáló pedig a várólistára vételt kezdeményező intézményt és szervezeti egységet Ha a beteg a jelentő intézményben jelentkezett, akkor a Beküldő, a Vizsgáló és az Ellátó is azonos intézmény lesz, csak különböző szervezeti egységekkel (pl. ambulancia, szakrendelő, műtő). Hol találhatok a várólista kódok számozásával kapcsolatos adatokat? Ezeket az adatokat jelenleg varolista fejleszt http://tesztjogviszony.oephu/docs címen publikáljuk levelező listán és a Mit tegyek, ha egy felhasználó véletlenül hibásan adta meg a változtatás okát, és emiatt passzív státuszúvá válik egy eset? Lehet az ilyen eseteket javítani? Jelenleg a passzív státuszú eseteken csak hibajavítást tud végrehajtani, és a státuszt nem változtathatja meg. A következő telepítéstől kezdve a REA (Reaktiválás) tranzakcióval újra várakozó státuszúvá minősítheti az esetet Egy új eset felvételekor van mód arra,

hogy azonnal megadjam az eset aktuális státuszát? Nem, erre még migráció esetén sincs lehetőség. Amennyiben az esetet migrálni kívánja, először vegye fel az esetet alapadatait, majd a kapott esetazonosító és a megfelelő mozgásnem segítségével hajtsa végre a kívánt változtatást az eseten. Milyen rekordokat kell a migráció során a várólista rendszerbe bemigrálnom? Kizárólag olyan eseteket, amelyek aktív státuszúak, vagyis a beteg még várakozik Mettől meddig tart az első migrációs időszak? Az első migrációs időszak 2012.0605-én kezdődik 20120611 23:59-ig tart A második migrációs időszak 2012.0629-én kezdődik és 20120706 23:59-ig tart Ekkor vihetők fel az időközben történt változások, 20120701-től az éles működéssel párhuzamosan Mi fog történni az első migrációt követően? 19. oldal, összesen: 37 Várólista rendszer API dokumentáció Az Várólista rendszer éles környezetét 2012.0612-én lekapcsoljuk,

a beküldött adatokat feldolgozzuk, és egy listát készítünk azokról a személyekről, akiknek TAJ száma több azonos jellegű várólistán is szerepel. Ezt a listát megküldjük az intézményeknek, hogy felvegyék a betegekkel a kapcsolatot, és tisztázzák velük, melyik várólistára kívánnak jelentkezni. A beteg jelzését a Várólista rendszer felé vissza kell igazolni Hogyan kell visszaigazolni a két várólistán szereplő betegek visszajelzését? Az intézményeknek táblázatokban küldjük ki a döntést igénylő esetek adatait, amelyben be kell jelölniük a beteg döntését és visszaküldeni a táblázatot. Mikor kapcsolják vissza az éles környezetet? Az éles környezet a 2012.0611-i leállást követően legközelebb 20120629-én lesz ismételten elérhető. Ekkor a 20120611 és 20120629 közötti időszak eseményeit a szolgáltatóknak a korábban, az internet üzemszünetek kapcsán már említett, ún. utólagos migrációval szintén be kell

tölteniük a Várólista rendszerbe. Különbözik az utólagos migráció az első migrációtól valamiben? Igen. Az utólagos migráció során a beteg már minden esetben az általa legutoljára megjelölt várólistára fog rákerülni. Ezért is fontos, hogy az eredeti felv kelte mezőt ilyenkor is kitöltse! 3.5 VÁRÓLISTA VIZSGÁLAT (VAROLISTAELLENORZES) Egy várólista-eset létrehozása előtt ezzel a szolgáltatással megvizsgálható, hogy szerepel-e ugyanez a beteg ugyanilyen ellátásra várva másik várólistán. Ha igen, akkor az eset létrehozása megszakítható Különben pedig (tehát ha a beteg ragaszkodik az új intézményhez), akkor elvégezhető az eset létrehozása, ekkor örökli a korábbi jelentkezése esetazonosítóját, a korábbi eset passzív (DUP) státuszba kerül és a korábbi intézmény várólista felelőse e-mailt kap az átjelentkezésről. varolistaEllenorzes webszolgáltatás paraméterei Név taj terv ellatas varolista oldalisag

Típus szöveg szöveg szöveg szöveg Leírás Beteg TAJ száma Tervezett OENO kód (elsődleges ellátásé) Várólista kód Oldaliság jele (J/B/P/N) Visszatérési értéke egy Duplikatum objektum. a Duplikatum nevű adatstruktúra attribútumai Név Típus Leírás 20. oldal, összesen: 37 Várólista rendszer API dokumentáció a Duplikatum nevű adatstruktúra attribútumai Név Típus hibakod szám hibauzenet szöveg Kód 9901 9902 9903 9904 9999 9106 9171 9172 3.6 VÁRÓLISTA Leírás Hibakód. 0:nincs duplikátum, 1:van duplikátum A korábbi eset fontosabb adatai (esetazonosító, intézmény, betegnév, listára kerülés kelte, várható ellátás kelte, státusz) Fontosabb hibaüzenetek Leírás A felhasználó nem létezik vagy jogosultsága nem megfelelő. A felhasználó nem érvényes. Az intézmény nem érvényes. A várólista azonosító nem érvényes. Egyéb adatbázis hiba A TAJ kizárólag 9 karakterből állhat! Az ellenőrizendő TAJ

megadása kötelező. Az ellenőrizendő OENO kód megadása kötelező. ÉS SAJÁT RENDSZER KÖZÖTTI KOMMUNIKÁCIÓS KAPCSOLAT ELLENŐRZÉSE (PING) Amennyiben bármilyen olyan speciális helyzet adódik, hogy szüksége lenne arra, hogy a meggyőződjön arról, hogy a Várólista rendszer és az Ön rendszere közötti internetkapcsolat megfelelően működik, kérdezze le GET metódussal a ping nevű oldalt. A ping nevű oldal címe:  teszt környezet esetén: http://tesztjogviszony.oephu/varolista/ping  éles rendszer esetén: <jelenleg kialakítás alatt> Amennyiben a fenti URL-t GET metódussal meghívva a „pong” üzenetet kapja vissza, az azt jelenti, az Ön rendszere és a Várólista rendszer közötti internetkapcsolat működőképes. Egyéb esetben értelmezze a két rendszer közötti kommunikáció nem működik megfelelően. Figyelmeztetés: Bár a ping oldal meghívása nem terheli le az Várólista rendszer webszerverét, gyakori meghívását azonban

az OEP tűzfala támadásnak veheti, ami a hívó cím ideiglenes vagy végleges kitiltásával járhat. 21. oldal, összesen: 37 Várólista rendszer API dokumentáció ÁLTALÁNOSAN HASZNÁLT HIBAÜZENETEK A hiák lehetséges típusai  F (fatal), ekkor nem jön létre az új eset, ill. nem történik meg a módosítás,  W (warning), ekkor megtörténik a tranzakció (ha nincs mellette fatális hiba is). Kód Leírás Típus 9001 Nem létező intézmény (%s) F 9090 Ismeretlen felhasználó. F 9100 A várólista megadása kötelező! F 9101 A beküldő intézmény megadása kötelező! F 9103 A területi ellátási kötelezettség státusza kötelező! F 9104 A területi ellátási kötelezettség státusza csak igen vagy nem lehet! F 9105 A TAJ megadása kötelező! F 9106 A TAJ kizárólag 9 karakterből állhat! F 9107 A név megadása kötelező! F 9108 Az ellátandó anyja nevének megadása kötelező! F 9109 Az email cím formátuma

érvénytelen! F 9110 A beküldő szervezeti egység megadása kötelező! F 9111 A beküldő orvos kódjának megadása kötelező! F 9112 A BNO kód megadása kötelező! F 9113 A vizsgáló intézmény megadása kötelező! F 9114 A vizsgáló szervezet megadása kötelező! F 9115 A vizsgáló orvos kódjának megadása kötelező! F 9116 A listára kerülés keltének megadása kötelező! F 9117 A listára kerülés kelte nem éééé.hhnn formátumú! F 9118 A tervezett ellátás OENO kódjának megadása kötelező! F 9119 A tervezett ellátás típusának megadása kötelező! F 9120 A tervezett ellátás típusa fix vagy változtatható lehet. F 9121 A tervezett ellátás sûrgősségének megadása kötelező! F 9122 Az oldaliság értéke jobb, bal, páros, vagy nem lehet! F 9123 A megjelentés várható időpontjának megadása kötelező! F 9124 A megjelenés várható időpontja nem éééé.hhnn formátumú! F 9125 Az ellátás tervezett

időpontjának megadása kötelező! F 9126 Az ellátás tervezett időpontja nem éééé.hhnn óó:pp formátumú! F 9127 Az ellátás tervezett időpontja nem hivatkozhat régebbi időpontra! F 22. oldal, összesen: 37 Várólista rendszer API dokumentáció Kód Leírás Típus 9128 A napló sorszám megadása kötelező. F 9129 Érvénytelen státusz. F 9130 Érvénytelen vagy nem létező intézmény azonosító. F 9131 Érvénytelen vagy nem létező betegség kód. F 9132 Nem létezik a tervezett ellátás OENO kódja. F 9133 A korábbi eset nem létezik. F 9134 Az előző eset TAJ száma eltérő. F 9135 Az előző eset státuszának lezártnak kell lennie. F 9136 Érvénytelen vagy nem érvényes a vizsgáló intézmény. F 9137 Érvénytelen várólista esetazonosító! F 9138 Érvénytelen formátumú születési dátumot adott meg. F 9139 A születési dátumnak %s és %s közé kell esnie. F 9140 A módosítás típusa nem létezik. F

9141 A beteg ezzel az OENO kóddal már szerepel egy várólistán. F 9142 Érvénytelen vagy nem létező TAJ. F 9143 A lezárt várólista esetek nem módosíthatóak! F 9144 Az esetek sûrgőssége azonnali vagy halasztható lehet! F 9145 Érvénytelen a várólista azonosító, vagy a várólista a tervezett ellátás idő- F pontjában még/már nem érvényes. 9146 A cím megadása kötelező! F 9147 A nem megadása kötelező! F 9148 A módosítás indoka csak módosítás esetén van értelmezve F 9149 A módosítás oka csak módosítás esetén van értelmezve. F 9150 Nem létezik a tényleges ellátás OENO kódja. F 9151 Nem létezik a tényleges ellátást végző intézmény. F 9152 A tényleges megjelenés keltének formátuma nem megfelelő (helyes formá- F tum: éééé.hhnn) 9153 A tényleges ellátás keltének formátuma nem megfelelő (helyes formátum: F éééé.hhnn óó:pp) 9154 Érvénytelen a várólista kezelő intézménye, vagy a

várólista kezelő intéz- F ménye az ellátás tervezett időpontjában még/már nem érvényes. 9155 A személy viszontazonosítása nem sikerült. Kérem, ellenőrizze le a meg- W adott név, anyja neve, születési dátum és TAJ adatokat. 9156 A vizsgáló orvos kódjának formátuma nem megfelelő. F 9157 Az ellátó orvos kódjának formátuma nem megfelelő. F 9158 A beküldő orvos kódjának formátuma nem megfelelő. F 9159 Az ellátásra vonatkozó adatokat csak módosítás során adhatja meg. F 23. oldal, összesen: 37 Várólista rendszer API dokumentáció Kód Leírás Típus 9160 A módosítás indokát módosításkor kötelező megadnia F 9161 A módosítás okát módosításkor kötelező megadnia. F 9171 Az ellenőrizendő TAJ megadása kötelező. F 9172 Az ellenőrizendő OENO kód megadása kötelező. F 9173 Érvénytelen vagy nem létező TAJ. W 9174 Tájékoztatjuk, hogy a beteg ezzel az ellátás típussal szerepelt egy másik W

várólistán.; Név: %s; Intézmény: %s; Várólista: %s; Esetazonosító: %s; Listára kerülés időpontja: %s 9175 A beteg ezzel az ellátás típussal már szerepel ugyanezen a várólistán; Név: F %s; Intézmény: %s; Várólista: %s; Esetazonosító: %s; Listára kerülés időpontja: %s 9176 A beteg ezzel az ellátás típussal már szerepel egy másik intézmény, fris- F sebb dátumú várólistáján. A felvétel nem lehetséges; Név: %s; Intézmény: %s; Várólista: %s; Esetazonosító: %s; Listára kerülés időpontja: %s 9177 Passzív státuszú eseten csak a hibajavítás (HIB) mûvelet hajtható végre. F 9178 DUP státuszú eseten csak hibajavítás (HIB) és reaktiválás (REA) F mûveleteket hajthat végre. 9179 A beteg ezzel az ellátás típussal már szerepel egy várólistán (utólagos mig- W ráció); Név: %s; Intézmény: %s; Várólista: %s; Esetazonosító: %s; Listára kerülés időpontja: %s 9180 A listára kerülés eredeti kelte nem

éééé.hhnn óó:pp formátumú! F 9181 A listára kerülés eredeti keltének az aktuális dátumnál korábbi időpontra F kell esnie! 9182 Nincs migrációs időszakban, így nem adhatja meg a listára kerülés eredeti F keltét! 9183 Az előző kód értéke nem alakítható számmá. F 9184 A minimális várakozási nap nem alakítható számmá. F 9185 A maximális várakozási nap nem alakítható számmá. F 9186 A terv. OENO-hoz nem megengedett a megadott BNO kód felvétele F 9187 A terv. OENO nem felel meg a várólista típusának F 9188 A vizsgálat naplósorszámának megadása kötelező. F 9199 A beteg ezzel az ellátással már szerepel egy másik, késobbi felvételi dátu- W mú, aktív várólistán. A hibajavítást követően az eset státuszát DUP-ra változtattuk; Név: %s; Intézmény: %s; 9200 A beküldő intézmény nem található. F 9201 A vizsgáló intézmény nem található. F 9202 Az ellátó intézmény nem található. F 9203

Szervezet nem található! F 9204 Orvos nem található! F 24. oldal, összesen: 37 Várólista rendszer API dokumentáció Kód Leírás 9205 BNO nem található! Típus F 9211 Hiba: Az eset DUP állapotú módosítása nem sikerült. Megj: A beteg ezzel F az ellátással már szerepel egy másik, aktív várólistán. 9300 Nem létező várólista. F 9901 A felhasználó nem létezik vagy jogosultsága nem megfelelő. F 9902 A felhasználó nem érvényes. F 9903 Az intézmény nem érvényes. F 9904 Nem azonosítható várólista eset a megadott várólista kóddal és esetazono- F sítóval 9905 A mikortol dátum formátuma nem megfelelő. (Elvárt formátum: F éééé.hhnn óó:pp) 9999 Egyéb adatbázis hiba F 25. oldal, összesen: 37 Várólista rendszer API dokumentáció 4 TESZTRENDSZER A várólista kezelés tesztrendszere a http://tesztjogviszony.oephu/varolista/varolistaSoapHttpPort címen érhető el A Web szolgáltatás kliensek által

használandó WSDL állomány a mellékletben található A tesztrendszeren a bejelentkezési nevet és jelszót (amelyet a regisztráció során a kapott) a SOAP üzenet fejlécébe kell helyezni, a WSSE (Web Service Security) leírásában található szöveges név és jelszó megadással. A teszteléshez szükséges tesztuser adatokat a TESZT telepítés után az OEP biztosítja a külső fejlesztők számára. Tesztelésre felhasználható még a Web alkalmazás felülete is, amely a http://tesztjogviszony.oephu/varolista/ címen érhető el 4.1 TESZT FELÜLET A http://tesztjogviszony.oephu/varolista/oepvarolistaSoapHttpPort végponthoz tartozó WSDL állomány <definitions name="oepvarolista" targetNamespace="http://oep.hu/" xmlns="http://schemas.xmlsoaporg/wsdl/" xmlns:tns="http://oep.hu/" xmlns:soap12="http://schemas.xmlsoaporg/wsdl/soap12/" xmlns:mime="http://schemas.xmlsoaporg/wsdl/mime/"

xmlns:xsd="http://www.w3org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoaporg/wsdl/soap/" > <types> <schema xmlns="http://www.w3org/2001/XMLSchema" targetNamespace="http://oephu/" elementFormDefault="qualified" xmlns:tns="http://oep.hu/" xmlns:wsdl="http://schemasxmlsoaporg/wsdl/" xmlns:xsi="http://www.w3org/2001/XMLSchema-instance" xmlns:soap11-enc="http://schemas.xmlsoaporg/soap/encoding/"> <complexType name="DataException"> <sequence> <element name="errorCode" type="string" nillable="true"/> <element name="errorMessage" type="string" nillable="true"/> </sequence> </complexType> <element name="varolistaEsetekElement"> <complexType> <sequence> <element name="listakod" type="string" nillable="true"/> <element

name="mindet" type="string" nillable="true"/> <element name="mikortol" type="string" nillable="true"/> <element name="esetazonosito" type="string" nillable="true"/> </sequence> </complexType> </element> <element name="varolistaEsetekResponseElement"> <complexType> <sequence> <element name="result" type="tns:Varolista" nillable="true" 26. oldal, összesen: 37 Várólista rendszer API dokumentáció minOccurs="0" maxOccurs="unbounded"/> </sequence> </complexType> </element> <complexType name="Varolista"> <sequence> <element name="v naplosorszam" type="string" nillable="true"/> <element name="varolista kod" type="string" nillable="true"/> <element

name="esetazonosito" type="string" nillable="true"/> <element name="bekuldo intezmeny" type="string" nillable="true"/> <element name="beteg azon" type="string" nillable="true"/> <element name="oldalisag" type="string" nillable="true"/> <element name="tek statusz" type="string" nillable="true"/> <element name="tranz ok" type="string" nillable="true"/> <element name="terv megjelenes" type="string" nillable="true"/> <element name="terv ellatas" type="string" nillable="true"/> <element name="vizsgalo intezmeny" type="string" nillable="true"/> <element name="statusz" type="string" nillable="true"/> <element name="tranz kod"

type="string" nillable="true"/> <element name="teny oeno" type="string" nillable="true"/> <element name="elozo azon" type="string" nillable="true"/> <element name="naplosorszam" type="string" nillable="true"/> <element name="ellato szervezet" type="string" nillable="true"/> <element name="felvetel kelt" type="string" nillable="true"/> <element name="betegseg" type="string" nillable="true"/> <element name="anyjaneve" type="string" nillable="true"/> <element name="nev" type="string" nillable="true"/> <element name="terv ellatas kelt" type="string" nillable="true"/> <element name="teny ellatas kelt" type="string"

nillable="true"/> <element name="vizsgalo orvos" type="string" nillable="true"/> <element name="ellato orvos" type="string" nillable="true"/> <element name="max varnap" type="string" nillable="true"/> <element name="szuletesi datum" type="string" nillable="true"/> <element name="bekuldo szervezet" type="string" nillable="true"/> <element name="vizsgalo szervezet" type="string" nillable="true"/> <element name="cim" type="string" nillable="true"/> <element name="nem" type="string" nillable="true"/> <element name="telefon" type="string" nillable="true"/> <element name="taj" type="string" nillable="true"/> <element

name="idopont tipus" type="string" nillable="true"/> <element name="ellato intezmeny id" type="string" nillable="true"/> <element name="bekuldo orvos" type="string" nillable="true"/> <element name="email" type="string" nillable="true"/> <element name="megjegyzes" type="string" nillable="true"/> <element name="teny megjelenes" type="string" nillable="true"/> <element name="min varnap" type="string" nillable="true"/> <element name="surgosseg" type="string" nillable="true"/> </sequence> </complexType> <element name="DataExceptionElement" type="tns:DataException"/> <element name="varolistaKezelesElement"> <complexType> <sequence> <element

name="varolista kod" type="string" nillable="true"/> <element name="esetazonosito" type="string" nillable="true"/> <element name="tranz kod" type="string" nillable="true"/> <element name="tranz ok" type="string" nillable="true"/> <element name="eredeti felv kelt" type="string" nillable="true"/> <element name="beteg azon" type="string" nillable="true"/> <element name="terv ellatas" type="string" nillable="true"/> <element name="oldalisag" type="string" nillable="true"/> <element name="taj" type="string" nillable="true"/> <element name="nev" type="string" nillable="true"/> <element name="anyjaneve" type="string"

nillable="true"/> <element name="szuletesi datum" type="string" nillable="true"/> <element name="telefon" type="string" nillable="true"/> <element name="nem" type="string" nillable="true"/> <element name="cim" type="string" nillable="true"/> <element name="email" type="string" nillable="true"/> <element name="bekuldo intezmeny" type="string" nillable="true"/> <element name="bekuldo szervezet" type="string" nillable="true"/> <element name="bekuldo orvos" type="string" nillable="true"/> <element name="betegseg" type="string" nillable="true"/> <element name="tek statusz" type="string" nillable="true"/> <element

name="vizsgalo intezmeny" type="string" nillable="true"/> 27. oldal, összesen: 37 Várólista rendszer API dokumentáció <element name="vizsgalo szervezet" type="string" nillable="true"/> <element name="vizsgalo orvos" type="string" nillable="true"/> <element name="v naplosorszam" type="string" nillable="true"/> <element name="idopont tipus" type="string" nillable="true"/> <element name="surgosseg" type="string" nillable="true"/> <element name="elozo azon" type="string" nillable="true"/> <element name="min varnap" type="string" nillable="true"/> <element name="max varnap" type="string" nillable="true"/> <element name="terv megjelenes"

type="string" nillable="true"/> <element name="terv ellatas kelt" type="string" nillable="true"/> <element name="teny megjelenes" type="string" nillable="true"/> <element name="teny ellatas kelt" type="string" nillable="true"/> <element name="teny oeno" type="string" nillable="true"/> <element name="ellato intezmeny" type="string" nillable="true"/> <element name="ellato szervezet" type="string" nillable="true"/> <element name="ellato orvos" type="string" nillable="true"/> <element name="naplosorszam" type="string" nillable="true"/> <element name="megjegyzes" type="string" nillable="true"/> </sequence> </complexType> </element>

<element name="varolistaKezelesResponseElement"> <complexType> <sequence> <element name="result" type="tns:Eset" nillable="true"/> </sequence> </complexType> </element> <complexType name="Eset"> <sequence> <element name="felvetel" type="string" nillable="true"/> <element name="esetazonosito" type="string" nillable="true"/> <element name="figyelmeztetes" type="string" nillable="true"/> </sequence> </complexType> <element name="varolistaVizsgalatElement"> <complexType> <sequence> <element name="taj" type="string" nillable="true"/> <element name="terv ellatas" type="string" nillable="true"/> <element name="varolista" type="string"

nillable="true"/> <element name="oldalisag" type="string" nillable="true"/> </sequence> </complexType> </element> <element name="varolistaVizsgalatResponseElement"> <complexType> <sequence> <element name="result" type="tns:Duplikatum" nillable="true"/> </sequence> </complexType> </element> <complexType name="Duplikatum"> <sequence> <element name="hibauzenet" type="string" nillable="true"/> <element name="hibakod" type="string" nillable="true"/> </sequence> </complexType> </schema> </types> <message name="Oepvarolista varolistaEsetek"> <part name="parameters" element="tns:varolistaEsetekElement"/> </message> <message name="Oepvarolista varolistaEsetekResponse">

<part name="parameters" element="tns:varolistaEsetekResponseElement"/> </message> <message name="DataException"> <part name="DataExceptionElement" element="tns:DataExceptionElement"/> </message> <message name="Oepvarolista varolistaKezeles"> <part name="parameters" element="tns:varolistaKezelesElement"/> </message> <message name="Oepvarolista varolistaKezelesResponse"> <part name="parameters" element="tns:varolistaKezelesResponseElement"/> </message> 28. oldal, összesen: 37 Várólista rendszer API dokumentáció <message name="Oepvarolista varolistaVizsgalat"> <part name="parameters" element="tns:varolistaVizsgalatElement"/> </message> <message name="Oepvarolista varolistaVizsgalatResponse"> <part name="parameters"

element="tns:varolistaVizsgalatResponseElement"/> </message> <portType name="oepvarolista"> <operation name="varolistaEsetek"> <input message="tns:Oepvarolista varolistaEsetek"/> <output message="tns:Oepvarolista varolistaEsetekResponse"/> <fault name="DataException" message="tns:DataException"/> </operation> <operation name="varolistaKezeles"> <input message="tns:Oepvarolista varolistaKezeles"/> <output message="tns:Oepvarolista varolistaKezelesResponse"/> <fault name="DataException" message="tns:DataException"/> </operation> <operation name="varolistaVizsgalat"> <input message="tns:Oepvarolista varolistaVizsgalat"/> <output message="tns:Oepvarolista varolistaVizsgalatResponse"/> <fault name="DataException"

message="tns:DataException"/> </operation> </portType> <binding name="oepvarolistaSoapHttp" type="tns:oepvarolista"> <soap:binding style="document" transport="http://schemas.xmlsoaporg/soap/http"/> <operation name="varolistaEsetek"> <soap:operation soapAction="http://oep.hu//varolistaEsetek"/> <input> <soap:body use="literal"/> </input> <output> <soap:body use="literal"/> </output> <fault name="DataException"> <soap:fault name="DataException" use="literal" encodingStyle=""/> </fault> </operation> <operation name="varolistaKezeles"> <soap:operation soapAction="http://oep.hu//varolistaKezeles"/> <input> <soap:body use="literal"/> </input> <output> <soap:body use="literal"/>

</output> <fault name="DataException"> <soap:fault name="DataException" use="literal" encodingStyle=""/> </fault> </operation> <operation name="varolistaVizsgalat"> <soap:operation soapAction="http://oep.hu//varolistaVizsgalat"/> <input> <soap:body use="literal"/> </input> <output> <soap:body use="literal"/> </output> <fault name="DataException"> <soap:fault name="DataException" use="literal" encodingStyle=""/> </fault> </operation> </binding> <service name="oepvarolista"> <port name="oepvarolistaSoapHttpPort" binding="tns:oepvarolistaSoapHttp"> <soap:address location="http://tesztjogviszony.oephu/varolista/oepvarolistaSoapHttpPort"/> </port> </service> </definitions> 29. oldal,

összesen: 37 Várólista rendszer API dokumentáció 4.2 ÉLES FELÜLET Az éles felület elérhetőségéhez még szükség lesz a varolista.oephu aldomain létrehozására, egyelőre az alábbi címen érhető el. A https://jogviszony.oephu/varolista/oepvarolistaSoapHttpPort végponthoz tartozó WSDL állomány <definitions name="oepvarolista" targetNamespace="http://oep.hu/" xmlns="http://schemas.xmlsoaporg/wsdl/" xmlns:tns="http://oep.hu/" xmlns:soap12="http://schemas.xmlsoaporg/wsdl/soap12/" xmlns:mime="http://schemas.xmlsoaporg/wsdl/mime/" xmlns:xsd="http://www.w3org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoaporg/wsdl/soap/" > <types> <schema xmlns="http://www.w3org/2001/XMLSchema" targetNamespace="http://oephu/" elementFormDefault="qualified" xmlns:tns="http://oep.hu/" xmlns:wsdl="http://schemasxmlsoaporg/wsdl/"

xmlns:xsi="http://www.w3org/2001/XMLSchema-instance" xmlns:soap11-enc="http://schemas.xmlsoaporg/soap/encoding/"> <complexType name="DataException"> <sequence> <element name="errorCode" type="string" nillable="true"/> <element name="errorMessage" type="string" nillable="true"/> </sequence> </complexType> <element name="varolistaEsetekElement"> <complexType> <sequence> <element name="listakod" type="string" nillable="true"/> <element name="mindet" type="string" nillable="true"/> <element name="mikortol" type="string" nillable="true"/> <element name="esetazonosito" type="string" nillable="true"/> </sequence> </complexType> </element> <element

name="varolistaEsetekResponseElement"> <complexType> <sequence> <element name="result" type="tns:Varolista" nillable="true" minOccurs="0" maxOccurs="unbounded"/> </sequence> </complexType> </element> <complexType name="Varolista"> <sequence> <element name="v naplosorszam" type="string" nillable="true"/> <element name="varolista kod" type="string" nillable="true"/> <element name="esetazonosito" type="string" nillable="true"/> <element name="bekuldo intezmeny" type="string" nillable="true"/> <element name="beteg azon" type="string" nillable="true"/> <element name="oldalisag" type="string" nillable="true"/> <element name="tek statusz"

type="string" nillable="true"/> <element name="tranz ok" type="string" nillable="true"/> <element name="terv megjelenes" type="string" nillable="true"/> <element name="terv ellatas" type="string" nillable="true"/> <element name="vizsgalo intezmeny" type="string" nillable="true"/> <element name="statusz" type="string" nillable="true"/> <element name="tranz kod" type="string" nillable="true"/> <element name="teny oeno" type="string" nillable="true"/> <element name="elozo azon" type="string" nillable="true"/> <element name="naplosorszam" type="string" nillable="true"/> <element name="ellato szervezet" type="string"

nillable="true"/> 30. oldal, összesen: 37 Várólista rendszer API dokumentáció <element name="felvetel kelt" type="string" nillable="true"/> <element name="betegseg" type="string" nillable="true"/> <element name="anyjaneve" type="string" nillable="true"/> <element name="nev" type="string" nillable="true"/> <element name="terv ellatas kelt" type="string" nillable="true"/> <element name="teny ellatas kelt" type="string" nillable="true"/> <element name="vizsgalo orvos" type="string" nillable="true"/> <element name="ellato orvos" type="string" nillable="true"/> <element name="max varnap" type="string" nillable="true"/> <element

name="szuletesi datum" type="string" nillable="true"/> <element name="bekuldo szervezet" type="string" nillable="true"/> <element name="vizsgalo szervezet" type="string" nillable="true"/> <element name="cim" type="string" nillable="true"/> <element name="nem" type="string" nillable="true"/> <element name="telefon" type="string" nillable="true"/> <element name="taj" type="string" nillable="true"/> <element name="idopont tipus" type="string" nillable="true"/> <element name="ellato intezmeny id" type="string" nillable="true"/> <element name="bekuldo orvos" type="string" nillable="true"/> <element name="email"

type="string" nillable="true"/> <element name="megjegyzes" type="string" nillable="true"/> <element name="teny megjelenes" type="string" nillable="true"/> <element name="min varnap" type="string" nillable="true"/> <element name="surgosseg" type="string" nillable="true"/> </sequence> </complexType> <element name="DataExceptionElement" type="tns:DataException"/> <element name="varolistaKezelesElement"> <complexType> <sequence> <element name="varolista kod" type="string" nillable="true"/> <element name="esetazonosito" type="string" nillable="true"/> <element name="tranz kod" type="string" nillable="true"/> <element name="tranz ok"

type="string" nillable="true"/> <element name="eredeti felv kelt" type="string" nillable="true"/> <element name="beteg azon" type="string" nillable="true"/> <element name="terv ellatas" type="string" nillable="true"/> <element name="oldalisag" type="string" nillable="true"/> <element name="taj" type="string" nillable="true"/> <element name="nev" type="string" nillable="true"/> <element name="anyjaneve" type="string" nillable="true"/> <element name="szuletesi datum" type="string" nillable="true"/> <element name="telefon" type="string" nillable="true"/> <element name="nem" type="string" nillable="true"/>

<element name="cim" type="string" nillable="true"/> <element name="email" type="string" nillable="true"/> <element name="bekuldo intezmeny" type="string" nillable="true"/> <element name="bekuldo szervezet" type="string" nillable="true"/> <element name="bekuldo orvos" type="string" nillable="true"/> <element name="betegseg" type="string" nillable="true"/> <element name="tek statusz" type="string" nillable="true"/> <element name="vizsgalo intezmeny" type="string" nillable="true"/> <element name="vizsgalo szervezet" type="string" nillable="true"/> <element name="vizsgalo orvos" type="string" nillable="true"/> <element name="v

naplosorszam" type="string" nillable="true"/> <element name="idopont tipus" type="string" nillable="true"/> <element name="surgosseg" type="string" nillable="true"/> <element name="elozo azon" type="string" nillable="true"/> <element name="min varnap" type="string" nillable="true"/> <element name="max varnap" type="string" nillable="true"/> <element name="terv megjelenes" type="string" nillable="true"/> <element name="terv ellatas kelt" type="string" nillable="true"/> <element name="teny megjelenes" type="string" nillable="true"/> <element name="teny ellatas kelt" type="string" nillable="true"/> <element name="teny oeno"

type="string" nillable="true"/> <element name="ellato intezmeny" type="string" nillable="true"/> <element name="ellato szervezet" type="string" nillable="true"/> <element name="ellato orvos" type="string" nillable="true"/> <element name="naplosorszam" type="string" nillable="true"/> <element name="megjegyzes" type="string" nillable="true"/> </sequence> </complexType> </element> <element name="varolistaKezelesResponseElement"> <complexType> 31. oldal, összesen: 37 Várólista rendszer API dokumentáció <sequence> <element name="result" type="tns:Eset" nillable="true"/> </sequence> </complexType> </element> <complexType name="Eset"> <sequence> <element

name="felvetel" type="string" nillable="true"/> <element name="esetazonosito" type="string" nillable="true"/> <element name="figyelmeztetes" type="string" nillable="true"/> </sequence> </complexType> <element name="varolistaVizsgalatElement"> <complexType> <sequence> <element name="taj" type="string" nillable="true"/> <element name="terv ellatas" type="string" nillable="true"/> <element name="varolista" type="string" nillable="true"/> <element name="oldalisag" type="string" nillable="true"/> </sequence> </complexType> </element> <element name="varolistaVizsgalatResponseElement"> <complexType> <sequence> <element name="result"

type="tns:Duplikatum" nillable="true"/> </sequence> </complexType> </element> <complexType name="Duplikatum"> <sequence> <element name="hibauzenet" type="string" nillable="true"/> <element name="hibakod" type="string" nillable="true"/> </sequence> </complexType> </schema> </types> <message name="Oepvarolista varolistaEsetek"> <part name="parameters" element="tns:varolistaEsetekElement"/> </message> <message name="Oepvarolista varolistaEsetekResponse"> <part name="parameters" element="tns:varolistaEsetekResponseElement"/> </message> <message name="DataException"> <part name="DataExceptionElement" element="tns:DataExceptionElement"/> </message> <message name="Oepvarolista

varolistaKezeles"> <part name="parameters" element="tns:varolistaKezelesElement"/> </message> <message name="Oepvarolista varolistaKezelesResponse"> <part name="parameters" element="tns:varolistaKezelesResponseElement"/> </message> <message name="Oepvarolista varolistaVizsgalat"> <part name="parameters" element="tns:varolistaVizsgalatElement"/> </message> <message name="Oepvarolista varolistaVizsgalatResponse"> <part name="parameters" element="tns:varolistaVizsgalatResponseElement"/> </message> <portType name="oepvarolista"> <operation name="varolistaEsetek"> <input message="tns:Oepvarolista varolistaEsetek"/> <output message="tns:Oepvarolista varolistaEsetekResponse"/> <fault name="DataException"

message="tns:DataException"/> </operation> <operation name="varolistaKezeles"> <input message="tns:Oepvarolista varolistaKezeles"/> <output message="tns:Oepvarolista varolistaKezelesResponse"/> <fault name="DataException" message="tns:DataException"/> </operation> <operation name="varolistaVizsgalat"> <input message="tns:Oepvarolista varolistaVizsgalat"/> <output message="tns:Oepvarolista varolistaVizsgalatResponse"/> <fault name="DataException" message="tns:DataException"/> </operation> </portType> 32. oldal, összesen: 37 Várólista rendszer API dokumentáció <binding name="oepvarolistaSoapHttp" type="tns:oepvarolista"> <soap:binding style="document" transport="http://schemas.xmlsoaporg/soap/http"/> <operation

name="varolistaEsetek"> <soap:operation soapAction="http://oep.hu//varolistaEsetek"/> <input> <soap:body use="literal"/> </input> <output> <soap:body use="literal"/> </output> <fault name="DataException"> <soap:fault name="DataException" use="literal" encodingStyle=""/> </fault> </operation> <operation name="varolistaKezeles"> <soap:operation soapAction="http://oep.hu//varolistaKezeles"/> <input> <soap:body use="literal"/> </input> <output> <soap:body use="literal"/> </output> <fault name="DataException"> <soap:fault name="DataException" use="literal" encodingStyle=""/> </fault> </operation> <operation name="varolistaVizsgalat"> <soap:operation

soapAction="http://oep.hu//varolistaVizsgalat"/> <input> <soap:body use="literal"/> </input> <output> <soap:body use="literal"/> </output> <fault name="DataException"> <soap:fault name="DataException" use="literal" encodingStyle=""/> </fault> </operation> </binding> <service name="oepvarolista"> <port name="oepvarolistaSoapHttpPort" binding="tns:oepvarolistaSoapHttp"> <soap:address location="https://jogviszony.oephu/varolista/oepvarolistaSoapHttpPort"/> </port> </service> </definitions> 33. oldal, összesen: 37 Várólista rendszer API dokumentáció 5 AZ API JAVASOLT HASZNÁLATI MÓDJA Az intézményben már működő várólista kezelő informatikai megoldások továbbra is használhatók, mindössze az új eseteknek és a módosításoknak a központ felé

történő automatikus feladásával szükséges ezeket bővíteni. Ehhez szükséges tárolni az egyes eseteknél, hogy megtörtént-e már a feladásuk Új esetnél vagy pedig módosulás esetén az eset feladottságának jelzőjét „Nem”-re kell állítani, ezután pedig egy gyakran (akár percenként) futó automatizmussal célszerű feladni a még nem feladott eseteket, a várólistára kerülés, illetve a módosítás sorrendjében, majd az eset sikeres feladása után „Igen”-re állítja a jelzőt. Ezzel a megoldással • rendszerinduláskor automatikusan megtörténik az adatmigráció, • folyamatosan biztosítható a helyi várólista adatok és a központi adatbázis egyezősége, • és bármilyen kapcsolatkimaradás után is automatikusan helyreáll az adategyezés. A feladáshoz egségesen a varolistaKezeles webszolgáltatás használandó. Ezen keresztül lehet a központi várólista adatbázisba feltölteni és ott módosítani a várólista eseteket.

Az eset létrehozása előtti ellenőrzési funkció a varolistaVizsgalat. Ezt célszerű használni a helyi informatikai megoldások várólista moduljában is az eset felvitelekor, mivel a TAJ szám, az OENO kód és az Oldaliság adatok alapján a webservice a visszatérési értékében megmondja, hogy van-e már az országban valahol hasonló előfordulás, ami azt jelenti, hogy a beteg máshova is jelentkezett. Ha van többszörös jelentkezés, akkor a saját rendszerben is célszerű kérni a beteg beleegyezését a várólista eset felvétele előtt, mivel az új eset létrehozása és feladása után a központi rendszer automatikusan ki fogja vezetni az előző jelentkezését (amelyről e-mailes értesítést is küld az intézmény várólista felelősének). Egy várólista egy vagy több esetének lekérdezése a varolistaEsetek webservice segítségével végezhető el. Erre akkor lehet szükség, ha valamilyen üzemzavar után össze kellene hasonlítani a központi

rendszerben és a helyi rendszerben tárolt adatokat A várólisták karbantartása teljeskörűen megtörténhet az API használata nélkül is, az OEP által biztosított webes felületen. Ha viszont egy intézmény a saját informatikai rendszerében veszi fel és módosítja a várólista eseteket, akkor az adatfeladásra az API-t célszerű használnia és a webes felületen nem szabad esetet felvinnie vagy módosítania, mert csak így biztosítható az adatok egyezősége. Ezért, ha egy intézmény áttér az API használatára, akkor azt jeleznie kell az OEP várólista felelősének, aki átállítja a jogosultságokat az API használatához. A központi rendszer a várólistára kerülés időpontjának mindig a webes felületen vagy az APIn keresztüli beérkezés időpontját tekinti. Ez általában így helyes, és ösztönzőleg hat a minél hamarabbi adatfelküldésre (különben a beteg későbbre kerülhet a várólistában). Rendszerindulás esetén viszont az

induló adatmigráció jó esetben másodpercek alatt megtörténik, így sok majdnem azonos időpont fog listára kerülési időpontként szerepelni. Ezért fogadjuk el még ilyenkor a Listára kerülés eredeti kelte adatot Ennek akkor lehet jelentősége, ha egy beteg kényszerből másik várólistára jelentkezik át és ott meg kell állapítani, hogy kik jelentkeztek nála hamarabb (mivel őket elvileg nem előzheti meg). 34. oldal, összesen: 37 Várólista rendszer API dokumentáció 6 FÜGGELÉK 6.1 KÖTELEZŐEN VÁRÓLISTÁS ELLÁTÁSTÍPUSOK TÁBLÁZATA Szakma Beavatkozás típusa (OENO csoport) Beavatkozás OENO kódja Szemészet Szürkehályog műtétei 51470-51471; 51474-51475; 51574. Fül-orrgégegyógyászat Mandula, orrmandula műtét 52810; 52820; 52850. Orrmelléküregek, proc. mastoideus II műtétei 52030; 52121. Ortopédia Térdprotézis műtét 5814E-S. Csípőprotézis műtét 58150-58159; 5815A-5815F; 5816358169. Gerincstabilizáló

műtétek, gerincdeformitás műtétei 5812B-E; 58037-39; 5810Q-Y. Gerincsérv műtétek 58033-58036. Epekövesség miatti beavatkozás feltárás 55110; 55112; 55119; 55131. Epekövesség miatti beavatkozás laparoszkópia 55118; 55137-55138. Katéteres epekőoldás 59541-59542. Hasfali-, lágyék sérvműtét implantátum beültetésével 55360. Sérvműtétek (hasfali, lágyék-, köldök-, combsérv) implantátum beültetése nélkül 55350; 55390; 55300; 55310-55311; 55319-55320; 55330-55331; 55340. Sebészet Kardiológia Urológia Diagnosztikus szívkatéterezés, elektrofiziológiai vizsgá- 12660; 12730-12731; 12740; 12750lat (külön várólistán vezetendő) 12754; 12780; 33110; 33114; 33149; 86455. Radiofrekvenciás katéterabláció 86453. PTCA; Coronaria stent beültetés 33970; 33974. Prosztata jóindulatú megnagyobbodásának műtétei I. (Prostatectomia) 56020; 56030; 56060; 56070. Prosztata jóindulatú megnagyobbodásának műtétei II.

(Transurethralis prostataműtét) 56011-56015; 5601A; 86051. Nőgyógyászat Nőgyógyászati műtétek nem malignus folyamatokban 56850; 56860; 56540; 56550; 56560; 56511; 56710; 56721; 56722. 35. oldal, összesen: 37 Várólista rendszer API dokumentáció 6.2 HASZNÁLHATÓ TRANZ KODOK ÉS ESET STÁTUSZOK TÁBLÁZATA A várólista esetek státuszait a rendszer automatikusan állítja a megadott mozgásnemek (módosítási okok) alapján. A várólista eset a létrehozásakor VAR (Várakozó) státuszba kerül. Ezután az alábbi mozgásnemekkel jellemzett módosítások a mellettük feltüntetettre változtatják az eset státuszát: MozgásÚj nem Megnevezés státusz Megnevezés Az ellátást a beteg megkapta a jelentő intézNormál módon ellátott. NOR NOR ményben normál rend szerint. (passzív státusz) Az ellátást a beteg megkapta a jelentő intézményben, de szakmai indokoltság alapján a tervezett ellátások ütemezése szerinti időELO ELO ponthoz képest

előrehozott időpontban (kivéve a sürgősséggel, azonnali ellátásban réElőrehozva ellátott. szesített betegeket). (passzív státusz) A páciens állapota akuttá vált, az ellátást Sürgősséggel ellátott. SUR SUR sürgősséggel el kellett végezni. (passzív státusz) Halasztva szakmai okokból (ideiglenes alHSZ HSZ Halasztás szakmai okokból ideiglenes alkalkalmatlanság). matlanság miatt. (aktív státusz) Halasztva kapacitáshiHKH HKH ány miatt. Halasztás kapacitáshiány miatt. (aktív státusz) Halasztva a beteg kéréHBK HBK Halasztás a beteg kérésére. sére. (aktív státusz) A tervezett időpont módosult a szolgáltató Várakozó. ATU VAR kezdeményezésére végzett átütemezés miatt. (aktív státusz) Várakozó. IDO VAR A tervezett időpont változott egyéb ok miatt. (aktív státusz) A beteg nem jelent NJM NJM A beteg nem jelent meg. meg. (aktív státusz) Elmaradt a beteg kéréEBK EBK Elmaradt a beteg kérésére. sére. (passzív státusz) A

páciens más országba ELK ELK költözött. (passzív stáA páciens más országba költözött tusz) A páciens meghalt. ELH ELH A páciens meghalt. (passzív státusz) A páciens állapota már nem igényli a tervezett NIG NIG A páciens állapota már nem igényli a tervebeavatkozást. (passzív zett beavatkozást. státusz) 36. oldal, összesen: 37 Várólista rendszer API dokumentáció DUP A páciens más szolgáltatóhoz történő átjelentkezése miatti törlés. Ez automatikusan történik, így a felhasználói felületen nem választható ki. REA DUP VAR Eset reaktiválása. Csak DUP státuszú esetnél választható ki. TEV TEO Törlés várólistáról téves felvitel miatt. Törlés egyéb ok miatt. TEO TEO Máshova jelentkezés miatt törölve. (passzív státusz) Csak DUP státuszú esetre alkalmazható, a kezdeti migrációban, ahol a beteg dönthet egy korábbi (nem a legutolsó) jelentkezése mellett, így ennek a reaktiválása mellett a legutolsót

kell DUP státuszba helyezni. (aktív státusz) Törölve egyéb ok miatt. (passzív státusz) Törölve egyéb ok miatt. (passzív státusz) Az alábbi mozgásnemek nem változtatják a státuszt: HIB MOD Hibajavítás Módosítás változás miatt 37. oldal, összesen: 37