1 Kórházi, házi- és gyermekorvosi rendszerekből adatkérés 1 Újszülöttek kórházi jelentése, orvosi rendszerek oltási jelentése és oltási értesítő inter...
Kórházi, házi- és gyermekorvosi rendszerekből adatkérés
1 Újszülöttek kórházi jelentése, orvosi orvosi rendszerek oltási jelentése és oltási értesítő interfész (OLTASJELENTES_WS) – JVF995 JVF995 Az interfész célja, Beadott oltások egyedi jelentése működési módja Adatkapcsolat gyakorisága
Leírás Interfész struktúra verziószáma A küldő adat egyedi tranzakció azonosító, ha egy hibás tételt küld újra, akkor újat kell kiosztania Jelentés típusa: 1 = „jelentés” 2 = „értesítő” 3 = „induló”. A TAJ azonosító típusa: 0=„a személyazonosító jel nincs kitöltve” 1=„TAJ szám” 2=„6 hónapnál fiatalabb gyermek TAJ száma” 3=„útlevélszám” 5=„menedékes kérelmező, befogadó igazolvány száma” Az előző mező által meghatározott azonosító Az oltott nevének titulusa, ÁNTSZ által meghatározott szótár, T_TITULUS Az oltott vezetékneve Az oltott keresztneve Az oltott neve (amennyiben nem oldható meg,
K I I
Típus xs:string xs:string
I
xs:string
I
xs:string
I N
xs:string xs:string
F1 F1 F1
xs:string xs:string xs:string 1
hogy az oltott nevét titulusra, vezetéknévre és keresztnévre szétbontva küldjék, akkor kötelezően ki kell tölteni ezt a mezőt) oltottSzuletesiDatum Az oltott születési dátuma, formátuma: éééé.hh.nn oltottNem Az oltott neme, ÁNTSZ által meghatározott szótár, T_NEM oltottAnyjaNeveTitulus Az oltott anyja születési nevének titulusa, ÁNTSZ által meghatározott szótár, T_TITULUS oltottAnyjaNeveVezetek Az oltott anyja születési vezetékneve oltottAnyjaNeveKereszt Az oltott anyja születési keresztneve oltottAnyjaNeve Az oltott anyja születési neve (amennyiben nem oldható meg, hogy az oltott anyja születési nevét titulusra, vezetéknévre és keresztnévre szétbontva küldjék, akkor kötelezően ki kell tölteni ezt a mezőt) oltottCimOrszag Oltott lakcíme: ország (ÁNTSZ által meghatározott szótár, T_ORSZAG_ ALLAMPOLGARSAG) oltottCimIrsz Oltott lakcíme: irányítószám, T_IRSZ oltottCimTelep Oltott lakcíme: település oltottCimUtcanev Oltott lakcíme: utcanév oltottCimUtcajel Oltott lakcíme: utca jellege (közterület jellege, ÁNTSZ által meghatározott szótár, T_KOZTERULET) oltottCimHazszam Oltott lakcíme: házszám oltottCimEmelet Oltott lakcíme: emelet oltottCimAjto Oltott lakcíme: ajtó oltottCimHrsz Oltott lakcíme: helyrajzi szám oltottCimUtcatol Az oltott lakcíme (amennyiben nem oldható meg, hogy az oltott lakcímét az utcanévtől kezdve szétbontva küldjék, akkor kötelezően ki kell tölteni ezt a mezőt) haziorvosAzon Az oltott háziorvosának 5 jegyű pecsétszáma vedonoKorzetAzon Az oltott körzetének azonosítója, ÁNTSZ által meghatározott szótár oltasAzon Az oltás azonosítója, ÁNTSZ által meghatározott szótár oltasDatum Az oltás dátuma, formátuma: éééé.hh.nn oltoanyagAzon Az oltóanyag azonosítója, ÁNTSZ által meghatározott szótár, J_T_OLTOANYAG oltoanyagGyariSzam Az oltóanyag gyári száma oltoanyagMennyiseg Az eloltott oltóanyag mennyisége, értéke 0 vagy 1 indikacioAzon Az oltási indikáció azonosítója, ÁNTSZ által meghatározott szótár, JV_OLTAS_INDIKACIO oltasbeadasHelye Az oltás beadásának helye, ÁNTSZ által meghatározott szótár, JT_OLTAS_HELYE oltasbeadasModja Az oltás beadásának módja, ÁNTSZ által meghatározott szótár, JT_OLTAS_MODJA oltoEuSzolgAzon Az oltóorvos egészségügyi szolgáltatójának 9 jegyű OEP azonosítója oltoorvosAzon Az oltóorvos 5 jegyű pecsétszáma
I I
xs:string xs:string
N
xs:string
F2 F2 F2
xs:string xs:string xs:string
I
xs:string
I I N N
xs:string xs:string xs:string xs:string
N N N N N
xs:string xs:string xs:string xs:string xs:string
N I
xs:string xs:string
I
xs:string
I N
xs:string xs:string
N I N
xs:string xs:integer xs:string
I
xs:string
I
xs:string
I
xs:string
I
xs:string
F1: betegNevVezetek és betegNevKereszt vagy betegNev közül valamelyik kitöltése kötelező. F2: oltottAnyjaNeveVezetek és oltottAnyjaNeveKereszt vagy oltottAnyjaNeve közül valamelyik kitöltése kötelező.
2
A webszolgáltatás visszatérési értékei Megnevezés sikeresMuvelet tranzakcioID hibaUzenet
Leírás A sikeres vagy sikertelen művelet tényét jelzi. A küldő által küldött tranzakcioID Sikertelen művelet esetén a hibaüzenet szövege.
K I I N
Típus xs:boolean xs:integer(tömb) xs:string(tömb)
3
2 Védőoltás tartós kontraindikáció jelentő interfész (OLTASJELENTES_WS) – JVF996 Az interfész célja, Tartós kontraindikációk egyedi jelentése működési módja Adatkapcsolat gyakorisága
Leírás Interfész struktúra verziószáma A küldő adat egyedi tranzakció azonosító, ha egy hibás tételt küld újra, akkor újat kell kiosztania A TAJ azonosító típusa: 0=„a személyazonosító jel nincs kitöltve” 1=„TAJ szám” 2=„6 hónapnál fiatalabb gyermek TAJ száma” 3=„útlevélszám” 5=„menedékes kérelmező, befogadó igazolvány száma” Az előző mező által meghatározott azonosító Az oltott nevének titulusa, ÁNTSZ által meghatározott szótár, T_TITULUS Az oltott vezetékneve Az oltott keresztneve Az oltott neve (amennyiben nem oldható meg, hogy az oltott nevét titulusra, vezetéknévre és keresztnévre szétbontva küldjék, akkor kötelezően ki kell tölteni ezt a mezőt) Az oltott születési dátuma, formátuma: éééé.hh.nn Az oltott neme, ÁNTSZ által meghatározott szótár, T_NEM Az oltott anyja születési nevének titulusa, ÁNTSZ
K I I
Típus xs:string xs:string
I
xs:string
I N
xs:string xs:string
F1 F1 F1
xs:string xs:string xs:string
I I
xs:string xs:string
N
xs:string 4
által meghatározott szótár, T_TITULUS oltottAnyjaNeveVezetek Az oltott anyja születési vezetékneve oltottAnyjaNeveKereszt Az oltott anyja születési keresztneve oltottAnyjaNeve Az oltott anyja születési neve (amennyiben nem oldható meg, hogy az oltott anyja születési nevét titulusra, vezetéknévre és keresztnévre szétbontva küldjék, akkor kötelezően ki kell tölteni ezt a mezőt) oltottCimOrszag Oltott lakcíme: ország (ÁNTSZ által meghatározott szótár, T_ORSZAG_ ALLAMPOLGARSAG) oltottCimIrsz Oltott lakcíme: irányítószám, T_IRSZ oltottCimTelep Oltott lakcíme: település oltottCimUtcanev Oltott lakcíme: utcanév oltottCimUtcajel Oltott lakcíme: utca jellege (közterület jellege, ÁNTSZ által meghatározott szótár, T_KOZTERULET) oltottCimHazszam Oltott lakcíme: házszám oltottCimEmelet Oltott lakcíme: emelet oltottCimAjto Oltott lakcíme: ajtó oltottCimHrsz Oltott lakcíme: helyrajzi szám oltottCimUtcatol Az oltott lakcíme (amennyiben nem oldható meg, hogy az oltott lakcímét az utcanévtől kezdve szétbontva küldjék, akkor kötelezően ki kell tölteni ezt a mezőt) haziorvosAzon Az oltott háziorvosának 5 jegyű pecsétszáma vedonoKorzetAzon Az oltott körzetének azonosítója, ÁNTSZ által meghatározott szótár oltasAzon Az oltás azonosítója, ÁNTSZ által meghatározott szótár kontraindikacioDatum A kontraindikáció megállapításának dátuma, formátuma: éééé.hh.nn kontraindikacioAzon A kontraindikáció azonosítója, ÁNTSZ által meghatározott szótár, JV_KONTRAINDIKACIO oltoEuSzolgAzon Az oltóorvos egészségügyi szolgáltatójának 9 jegyű OEP azonosítója oltoorvosAzon Az oltóorvos 5 jegyű pecsétszáma
F2 F2 F2
xs:string xs:string xs:string
I
xs:string
I I N N
xs:string xs:string xs:string xs:string
N N N N N
xs:string xs:string xs:string xs:string xs:string
N I
xs:string xs:string
I
xs:string
I
xs:string
I
xs:string
I
xs:string
I
xs:string
F1: betegNevVezetek és betegNevKereszt vagy betegNev közül valamelyik kitöltése kötelező. F2: oltottAnyjaNeveVezetek és oltottAnyjaNeveKereszt vagy oltottAnyjaNeve közül valamelyik kitöltése kötelező.
A webszolgáltatás visszatérési értékei Megnevezés sikeresMuvelet tranzakcioID hibaUzenet
Leírás A sikeres vagy sikertelen művelet tényét jelzi. A küldő által küldött tranzakcioID Sikertelen művelet esetén a hibaüzenet szövege.
K I I N
Típus xs:boolean xs:integer(tömb) xs:string(tömb)
5
3 Fertőzőbeteg bejelentés, kijelentés (FERTOZO_JELENTES_WS) – JVF99 JVF994 994 Az interfész célja, Kötelezően jelentendő fertőző betegségek be-, és kijelentőlapjainak elektronikus fogadása működési módja Adatkapcsolat gyakorisága
Interfész iránya az Adatfogadás OSZIR szempontjából Adatkör
Fertőzőbetegségek be-, és kijelentőlapjának adattartalma. Az adattartalom a jogszabály változtatási kérésnek megfelelően került meghatározásra.
A webszolgáltatás bemeneti paraméterei A táblázatban a KB oszlop jelentése: Bejelentőlap esetén kötelező-e, míg a KK oszlop jelentése: Ki Bejelentőlap esetén kötelező-e az adott mező.
Megnevezés verzioSzam tranzakcioID
jelentesTipusAzon
betegTajAzon
betegTaj betegNevTitulus
betegNevVezetek betegNevKereszt betegNev
Leírás Interfész struktúra verziószáma A küldő adat egyedi tranzakció azonosító, ha egy hibás tételt küld újra, akkor újat kell kiosztania Jelentés típusa: 1 = „bejelentés” 2 = „kijelentés”. A TAJ azonosító típusa: 0=„a személyazonosító jel nincs kitöltve” 1=„TAJ szám” 2=„6 hónapnál fiatalabb gyermek TAJ száma” 3=„útlevélszám” 5=„menedékes kérelmező, befogadó igazolvány száma” Az előző mező által meghatározott azonosító A beteg nevének titulusa, ÁNTSZ által meghatározott szótár, T_TITULUS A beteg vezetékneve A beteg keresztneve A beteg neve (amennyiben nem oldható meg, hogy a beteg nevét
Leírás titulusra, vezetéknévre és keresztnévre szétbontva küldjék, akkor kötelezően ki kell tölteni ezt a mezőt) A beteg születési dátuma, formátuma: éééé.hh.nn A beteg neme, ÁNTSZ által meghatározott szótár, T_NEM Megbetegedés helye: irányítószám, T_IRSZ Megbetegedés helye település Megbetegedés helye: utcanév Megbetegedés helye: utca jellege (közterület jellege, ÁNTSZ által meghatározott szótár, T_KOZTERULET) Megbetegedés helye: házszám Megbetegedés helye: emelet Megbetegedés helye: ajtó Megbetegedés helye: helyrajzi szám Megbetegedés helye (amennyiben nem oldható meg, hogy a megbetegedés helyét az utcanévtől kezdve szétbontva küldjék, akkor kötelezően ki kell tölteni ezt a mezőt) Bejelentendő betegség BNO kódja, T_BNO A beteg születési helye (ÁNTSZ által meghatározott szótár, JF_FERT_MAGYAR; Magyar/Külföldi) A beteg országa (ÁNTSZ által meghatározott szótár T_ORSZAG_ ALLAMPOLGARSAG). Ha a beteg születési helyének külföldit adtak meg, akkor itt az országot kell megadni. Ha a beteg születési helyének magyart adtak meg, akkor ebben a mezőben csak Magyarországnak megfelelő kód lehet. A beteg foglalkozásának FEOR kódja, T_FEOR A beteg foglalkozása (ha nem biztosítható az ÁNTSZ által meghatározott szótárból kiválasztva, akkor ebben a mezőben kell szövegesen megadnia beteg foglalkozását) Munkahely, kollektíva neve
Leírás Munkahely, kollektíva címe: irányítószám, T_IRSZ Munkahely, kollektíva címe település Munkahely, kollektíva címe: utcanév Munkahely, kollektíva címe: utca jellege (közterület jellege, ÁNTSZ által meghatározott szótár, T_KOZTERULET) Munkahely, kollektíva címe: házszám Munkahely, kollektíva címe: emelet Munkahely, kollektíva címe: ajtó Munkahely, kollektíva címe: helyrajzi szám Munkahely, kollektíva címe (amennyiben nem oldható meg, hogy a Munkahely, kollektíva címét az utcanévtől kezdve szétbontva küldjék, akkor kell tölteni ezt a mezőt) Megbetegedés kezdete, formátuma: éééé.hh.nn Ápolás helye (ÁNTSZ által meghatározott szótár, JF_APOLAS_HELYE) Kórházi felvétel dátuma, formátuma: éééé.hh.nn Kórház 9 jegyű OEP azonosítója Kórházi elbocsátás dátuma, formátuma: éééé.hh.nn Megbetegedés kimenetele (ÁNTSZ által meghatározott szótár, JF_BETEGSEG_KIMENETEL) Megbetegedés kimenetelének dátuma, formátuma: éééé.hh.nn A szövődmény /elváltozás vagy elhalálozás diagnózisa - BNO kódja, T_BNO A bejelentő orvos 5 jegyű pecsétszáma A bejelentő egészségügyi szolgáltató 9 jegyű OEP azonosítója
KB N
KK
Típus xs:string
N
xs:string
N
xs:string
N
xs:string
N
xs:string
N
xs:string
N N
xs:string xs:string
N
xs:string
I
xs:string
I
xs:string
F3
N
xs:string
F3
N N
xs:string xs:string
I
xs:string
F4
xs:string
F4
xs:string
I
I
xs:string
N
N
xs:string
F1: betegNevVezetek és betegNevKereszt vagy betegNev közül valamelyik kitöltése kötelező. F2: megbetegedesHelyUtcanev és megbetegedesHelyUtcajel vagy megbetegedesHelyUtcatol közül valamelyik kitöltése kötelező. F3: ha az apolasHelye mezőben a ’kórházban’-nak megfelelő kódérték van megadva, akkor kötelező kitölteni a korhazAzon és a korhaziFelvetelDatuma mezőt is.
8
F4: ha megbetegedesKimenetele mezőben halál / szövődmény / tartós szervi elváltozás került megadásra, akkor kötelező kitölteni a megbetegedesKimenetelDatum és a megbetegedesKimenetelDiagnozis mezőket
A webszolgáltatás visszatérési értékei Megnevezés sikeresMuvelet tranzakcioID
Leírás A sikeres vagy sikertelen művelet tényét jelzi. A küldő által küldött tranzakcioID
hibaUzenet
Sikertelen művelet esetén a hibaüzenet szövege.
K Típus I xs:boolean I xs:string (tömb) N xs:string (tömb)
Kódnév A bőr és nyálkahártya lésióival járó egyéb, meghatározott vírusfertőzések A bőr újszülöttkori fertőzése A bőr és a bőralatti szövetek helyi fertőzései k.m.n. A bőr és a bőralatti szövetek egyéb, meghatározott helyi fertőzései A csont echinococcus granulosus fertőzése A csigolyaközti porckorong (gennyes) fertőzése A csont-izomrendszer kankós fertőzése A fülkagyló nem-fertőzéses eredetű betegségei A garat chlamydiás fertőzése A genitális traktus egyéb fertőzése szülés után A genitourinaris traktus egyéb fertőzései szülés után A hashártya egyéb rendellenességei máshol osztályozott fertőzéses betegségekben A húgyivarrendszer alsó szakaszának kankós fertőzése, a húgycsőkörüli vagy a járulékos mirigyek tályogja nélkül 14
…
…
T_ORSZAG_ALLAMPOLGARSAG Kód HU CG CO X1 CR CU CY CZ DO …
Ország Magyarország Kongó Kolumbia Burma Costa Rica Kuba Ciprus Cseh Köztársaság Dominikai Köztársaság …
Állampolgárság magyar kongói kolumbiai burmai costa ricai kubai ciprusi cseh dominikai …
Kódnév Fizioterápiás asszisztens, masszőr Fogtechnikus Ortopédiai eszközkészítő Szigetelő Burkoló Festő és mázoló Gumitermékgyártó gép kezelője Üveget és üvegterméket gyártó gép kezelője Matematikus Optometrista Növényorvos (növényvédelmi szakértő) Fegyveres szervek középfokú képesítést nem igénylő foglalkozásai Közjegyző …
JF_APOLAS_HELYE Kód 1 2
Kódnév kórházban otthon
15
JF_BETEGSEG_KIMENETEL Kód 1 2 3 4
Kódnév halál szövődmény tartós szervi elváltozás gyógyult
JF_FERT_MAGYAR Kód 0 1
Kódnév Magyar Külföldi
JV_KONTRAINDIKACIO Kód 1 2 3 4 5
Kódnév Lázas betegség Immunológiai károsodás Súlyos oltási szövődmény korábbi előfordulása Terhesség A vakcina bármely összetevőjével szembeni súlyos túlérzékenység, anafilaxiás reakciók
4.2 Technikai segédlet – authentikáció 4.2.1 Web Service proxy Az OTH próbaüzem rendszerén (teszt rendszeren) az alábbi webservice-ek érhetőek el proxy url-en keresztül HTTPS-en: Fertőzőbeteg bejelentés, kijelentés Web https://testauth.antsz.hu:8443/AntszAuth/proxy?url=http://192.168.1.27:8086/oszirjarvany/webservice/FertozoJelentesService?wsdl
Service:
Újszülöttek kórházi jelentése, orvosi rendszerek oltási jelentése, oltási értesítő, védőoltás tartós kontraindikáció Web Service: https://testauth.antsz.hu:8443/AntszAuth/proxy?url=http://192.168.1.27:8086/oszirjarvany/webservice/OltasJelentesService?wsdl Oltóanyag készlet kezelő Web https://testauth.antsz.hu:8443/AntszAuth/proxy?url=http://192.168.1.27:8086/oszirjarvany/webservice/DistributorService?wsdl
Service:
16
Anonimizálás webservice (ez az interfész csupán azért van megadva, mert a fejezet végén található mellékelt fájl mintaként ezt a webservice-t tartalmazza): https://testauth.antsz.hu:8443/AntszAuth/proxy?url=http://192.168.1.27:8086/oszirkt/AnonimizalasWebService?wsdl
4.2.2 Kliens paraméterezése általánosan A webservice-ek hívásához a kliensnek szüksége van a szerver tanúsítványára (továbbiakban SERVER_CERT) és egy kliens tanúsítványra (továbbiakban CLIENT_CERT). A szerver tanúsítványát el kell helyezni a kliens alkalmazás megbízható tanúsítványai közé. A kliens tanúsítványt a webservice hívásakor kell megadni paraméterként. A tanúsítványokat az OTH Informatika fogja adni, a kliens tanúsítványhoz tartozó jelszóval együtt (CLIENT_PASSWORD). A testauth.antsz.hu domain nem létezik se külső se belső hálózaton, de a szerver tanúsítvány erre van kiállítva, ezért a hosts fájlban be kell állítani a hívó oldalon: 84.206.43.29 testauth.antsz.hu A hosts fájl helye operációs rendszerenként eltér, részletes leírás itt található.
4.2.3 Java kliens paraméterezése Ha a kliens egy Java alkalmazás, akkor a szerver tanúsítványát el kell helyezni az alkalmazás TrustStore-jában (továbbiakban TRUST_STORE). Ha már létezik a TrustStore, akkor ezt meg lehet tenni a JDK-ban található keytool program segítségével, például az alábbi utasítással: keytool -import -file /<SERVER_CERT> -keystore / A következő utasítással ellenőrizhetjük a TrustStore tartalmát: keytool -list -v -keystore / Ha a TrustStore még nem létezik, akkor az alábbi paranccsal létre lehet hozni: keytool -genkey -alias foo -keystore /
-alias
antsz_ca
Java kliens alkalmazás számára VM argumentumként lehet megadni, hogy a HTTPS kapcsolatokhoz az adott TrustStore-t és a kliens tanúsítványt használja. Az átadandó argumentumokra minta az alábbi: -Djavax.net.ssl.keyStore=/ -Djavax.net.ssl.keyStorePassword= -Djavax.net.ssl.keyStoreType=pkcs12 -Djavax.net.ssl.trustStore=/ -Djavax.net.ssl.trustStorePassword= A mellékelt anonim-client.zip-ben van egy Java kliens program az anonimizálás webservice-hez, forráskóddal együtt. Kicsomagolás után a kliens az alábbi paranccsal futtatható: java -Djavax.net.ssl.keyStore=/ -Djavax.net.ssl.keyStorePassword= -Djavax.net.ssl.keyStoreType=pkcs12 -Djavax.net.ssl.trustStore=/
17
-Djavax.net.ssl.trustStorePassword= -jar /anonim-client.jar Sikeres futás esetén a program kimenete: anonimKod=mnFJpad4a7No4G0Ixdd3dOtDpJ4=