KRA SOAP felhasználói kézikönyv

KRA SOAP felhasználói kézikönyv 5.01 VÁLTOZAT 2018. február 9.

Készítette: Nemzeti Média- és Hírközlési Hatóság Azonosítógazdálkodási Osztály KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 2/70

TARTALOMJEGYZÉK 1 BEVEZETÉS... 7 2 KOMMUNIKÁCIÓ SOAP INTERFÉSZEN... 8 2.1 SOAP interfész... 8 2.2 Autentikáció... 9 2.3 Elektronikus aláírás... 9 2.4 Elektronikus aláírás ellenőrzés nélküli üzemmód... 12 3 XML KOMMUNIKÁCIÓS ÜZENETEK... 13 4 SZÁMHORDOZÁSI TRANZAKCIÓK... 15 4.1 Hordozás bejelentés... 15 4.2 Hordozás bejelentés jóváhagyás válasz... 17 4.3 Hordozás bejelentés törlése... 18 4.4 Berendezés kód módosítás bejelentése... 20 4.5 Számhasználat megszüntetése... 21 4.6 Számhasználat megszüntetés törlése... 21 4.7 Hely szerinti hordozás bejelentése... 22 4.8 Hely szerinti hordozás bejelentés törlése... 22 4.9 Hely szerinti hordozás megszüntetése... 23 4.10 Hely szerinti hordozás megszüntetés törlése... 24 4.11 Szám visszatartás bejelentése... 24 4.12 Szám visszatartás bejelentés jóváhagyás válasz... 25 4.13 Szám visszatartás bejelentés törlése... 25 4.14 Visszahordozás és hely szerinti hordozás bejelentés... 26 4.15 Visszahordozás és hely szerinti hordozás bejelentés jóváhagyás válasz... 26 4.16 Visszahordozás és hely szerinti hordozás bejelentés törlése... 27 4.17 Irányítási adatok kérése (Query)... 27 5 LISTÁKAT VISSZAADÓ ÜZENETEK... 29 5.1 Jóváhagyás kérés üzenetek lekérdezése... 29 5.1.1 Hordozás bejelentés jóváhagyás kérés... 32 5.1.2 Szám visszatartás jóváhagyás kérés... 32 5.1.3 Visszahordozás és hely szerinti hordozás bejelentés jóváhagyás kérés... 33 5.2 A KRA üzeneteinek lekérdezése... 34 5.2.1 Hibás hordozás bejelentés... 38 5.2.2 Hibás hordozás jóváhagyás válasz... 38 5.2.3 Hordozás bejelentést a jóváhagyó elfogadta... 39 5.2.4 Hordozás bejelentést a jóváhagyó elutasította... 39 5.2.5 Hordozás bejelentés automatikus jóváhagyása... 40 5.2.6 Hibás hordozás bejelentés törlés... 40 KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 3/70

5.2.7 Hordozás bejelentés törölve... 41 5.2.8 Hibás berendezés kód módosítás... 41 5.2.9 Berendezés kód módosítva... 42 5.2.10 Hibás számhasználat megszüntetés... 42 5.2.11 Számhasználati jog elvesztése... 43 5.2.12 Számhasználati jog visszakerülése... 43 5.2.13 Hibás számhasználat megszüntetés törlés... 43 5.2.14 Számhasználat megszüntetés törölve... 44 5.2.15 Hibás hely szerinti hordozás bejelentés... 44 5.2.16 Hely szerinti hordozás regisztrálva... 45 5.2.17 Hibás hely szerinti hordozás bejelentés törlés... 45 5.2.18 Hely szerinti hordozás bejelentés törölve... 46 5.2.19 Hibás hely szerinti hordozás megszüntetés... 46 5.2.20 Hely szerinti hordozás megszüntetés regisztrálva... 46 5.2.21 Hibás hely szerinti hordozás megszüntetés törlés... 47 5.2.22 Hely szerinti hordozás megszüntetés bejelentés törölve... 47 5.2.23 Hibás szám visszatartás bejelentés... 48 5.2.24 Hibás szám visszatartás jóváhagyás válasz... 48 5.2.25 Szám visszatartás bejelentést a jóváhagyó elfogadta... 48 5.2.26 Szám visszatartás bejelentést a jóváhagyó elutasította... 49 5.2.27 Szám visszatartás bejelentés automatikus jóváhagyása... 49 5.2.28 Hibás szám visszatartás törlés... 50 5.2.29 Szám visszatartás bejelentés törölve... 50 5.2.30 Hibás visszahordozás és hely szerinti hordozás bejelentés... 51 5.2.31 Hibás visszahordozás és hely szerinti hordozás jóváhagyás válasz... 51 5.2.32 Visszahordozás és hely szerinti hordozás bejelentést a jóváhagyó elfogadta... 52 5.2.33 Visszahordozás és hely szerinti hordozás bejelentést a jóváhagyó elutasította... 52 5.2.34 Visszahordozás és hely szerinti hordozás bejelentés automatikus jóváhagyása... 53 5.2.35 Hibás visszahordozás és hely szerinti hordozás bejelentés törlés... 53 5.2.36 Visszahordozás és hely szerinti hordozás bejelentés törölve... 54 5.2.37 Irányítási adat letölthető... 54 5.2.38 Hibás irányítási adat kérés... 54 5.2.39 Új szolgáltató regisztrálva... 55 5.2.40 Szolgáltató törölve... 55 5.2.41 Számmező átadás bejelentés értesítés... 56 5.2.42 Számmező átadás módosítás értesítés... 56 5.2.43 Számmező átadás törlés értesítés... 56 5.3 Időablakok lekérdezése... 58 6 AZ IRÁNYÍTÁSI LISTÁK XML SZERKEZETÉNEK DEFINÍCIÓJA... 60 6.1 Irányítási listák tömörítése és aláírása... 60 6.1.1 Eredeti XML állapot (XML-faként ábrázolva)... 60 6.1.2 ZLIB állapot (hexadecimálisan ábrázolva)... 61 6.1.3 BASE64 kódolt (base64 encoded) állapot (karakteresen ábrázolva)... 61 6.1.4 Tömörített XML állapot (XML-faként ábrázolva)... 61 6.1.5 Aláírt tömörített XML állapot (XML-faként ábrázolva)... 61 6.2 Az irányítási listákkal a szolgáltatói oldalon elvégzendő lépések... 62 KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 4/70

7 MELLÉKLETEK... 63 M1 Paraméter táblázatok... 63 M2 Internet hivatkozások gyűjteménye... 69 8 VÁLTOZTATÁSOK ÖSSZEFOGLALÁSA... 69 KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 5/70

KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 6/70

1 BEVEZETÉS A számhordozási Központi Referencia Adatbázis (KRA) a számhordozhatóság nemzeti szintű hálózati megvalósításának eleme. Működtetője a Nemzeti Média- és Hírközlési Hatóság. Alapfeladata a hordozott számokkal kapcsolatos irányítási információk összegyűjtése a szolgáltatóktól, és a hordozott számra irányuló hívások megfelelő irányításához szükséges adatokhoz való hozzáférés biztosítása a szolgáltatók számára. A KRA nem tartalmaz előfizetői adatokat, ezért nem feladata a számhordozási eljárásban a hordozást igénylő előfizetők azonosításának és az adatok egyeztetésének támogatása, ez a számhordozásban érintett átadó és átvevő szolgáltató kétoldalú ügyfélszolgálati eljárásának a feladata. A számhordozási eljárás így két részre osztható, a hordozási igények és előfizetői adatok szolgáltatók közötti egyeztetésére és az egyeztetés alatt álló hordozások irányítási adatainak KRA-ba való bevitelére. A KRA műszaki leírását a szolgáltatók részére a számhordozást és a KRA-t bemutató ismertető és a felhasználói kézikönyvek együtt alkotják. A dokumentumok az NMHH honlap Számhordozás (KRA) oldaláról, valamint a KRA rendszer és a teszt rendszer Súgó oldaláról letölthetők. KRA Általános ismertető A dokumentum ismerteti a számhordozás fogalmát és jogszabályi előírásait, a számhordozási eljárás folyamatát és KRA eljárásait, valamint a hívások irányításának módszereit és az irányítási listák alkalmazásának módját. Bemutatja a szolgáltatók csatlakozásának folyamatát, a szolgáltatók és felhasználók adatainak regisztrációs eljárásait, a KRA ügyfélszolgálat és hibaügyelet feladatait, valamint a KRA-val való kommunikáció alapjait. KRA WEB felhasználói kézikönyv A kézikönyv a webes felületet használó személyek részére ismerteti a KRA-hoz való hozzáférés módját, a KRA-val való kommunikáció szabályait és a web felület használatát. KRA SOAP felhasználói kézikönyv A kézikönyv a szolgáltatói automata rendszerek kommunikácójának, a gép-gép kapcsolatnak a szabályait, eljárásait tartalmazza. A dokumentumban elsősorban azok az XML-kommunikációs konvenciók, formátumok kerülnek kifejtésre, melyek a KRA-rendszer Integrált szolgáltatásain keresztül történő kapcsolatkialakításhoz, a szolgáltatói oldali fejlesztéséhez szükségesek. KRA Elektronikus aláírási kézikönyv A KRA rendszer használatához a rendszer védelme és az adatbázis hitelességének megőrzése érdekében alkalmazott elektronikus hitelesítéseket tárgyalja. A kézikönyv a szolgáltatói számhordozási ügyintézők számára összefoglalja a KRA-ban használt tanúsítvány fajtákat, valamint a tanúsítványok beszerzésének és tárolásának egyes kérdéseit, majd a fejlesztők számára is részletekbe menően tárgyalja a tanúsítványok használatának szabályozását a számhordozási rendszerben. KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 7/70

2 KOMMUNIKÁCIÓ SOAP INTERFÉSZEN A számhordozási rendszert a szolgáltatói felhasználók az Interneten, az NMHH tűzfalán keresztül érhetik el, a szolgáltató által megadott fix IP címről. A felhasználónak megfelelő jogosultsággal kell rendelkezni a KRA-hoz illetve teszt rendszerhez való hozzáféréshez. A felhasználók az elektronikus adatkapcsolaton bejelenthetik a számhordozási eseményeket, lekérdezhetik az üzeneteket és más információkat, valamint letölthetik az irányítási listákat. A kommunikációban a számhordozási tranzakciókat elektronikus aláírással kell ellátni. A szolgáltatói felhasználók kétféle módon csatlakozhatnak KRA rendszerhez: Szolgáltatói webfelületen keresztül, melyről a KRA WEB felhasználói kézikönyvben olvashatók részletek Integrált szolgáltatások SOAP üzenetek közvetlen küldésével Az üzenetváltást mindig a felhasználó kezdeményezi. Ez azt jelenti, hogy a szolgáltatónak szóló üzeneteket a rendszer nem küldi el, hanem az általános és jóváhagyást kérő üzeneteket a szolgáltató felhasználójának kell lekérdeznie. Az on-line kommunikációt e-mail értesítés egészítheti ki, amelyet a KRA rendszer küld a megtekintésre váró üzenetek érkezéséről. A jogszabályokban meghatározott KRA-n kívül fejlesztési, tesztelési és a műveletek betanulásának céljára egy teszt rendszer is a felhasználók rendelkezésére áll. A két rendszeren futó szoftver az NMHH-ban folyó fejlesztési időszakoktól eltekintve alapvetően azonos, azonban két rendszer beállításai különböznek. Ezen kívül a teszt rendszeren tetszőleges tranzakciók végezhetők, ezért az ott tárolt hordozási adatok eltérőek, így a teszt rendszerből letölthető adatokat hívásirányítási célokra használni nem szabad! A teszt rendszerrel kapcsolatos információkat a dokumentációból, a teszt rendszer súgójából és a KRA ügyfélszolgálat körleveleiből lehet megtudni. 2.1 SOAP interfész A szolgáltatók automata rendszerei közvetlenül servlettel kommunikálhatnak a KRA-val HTTPS protokollon keresztül a következő URL meghívásával: KRA rendszer: Teszt rendszer: https://kra.nmhh.hu/messagedispatcher/test https://kra-test.nmhh.hu/messagedispatcher/test Az előállított XML üzenetet ezen URL-re kell feladni, erre az üzenetre automatikusan jön a válaszüzenet. A kommunikációs csatorna technikai interfészeit kliensoldalon egy alábbi konfigurációjú munkaállomás adja: operációs rendszer biztonságos tanúsítványtároló eszközrendszer (EA4+ vagy magasabb) KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 8/70

tetszőleges olyan eszköz, ami képes a platform független SOAP üzenetek előállítására, azok elküldésére és fogadására illetve képes autentikációs SSL kapcsolat felépítésére a SUN ONE Webserverrel. A SOAP interfészen XML üzenetben kérhetők a következő adatok, amelyek a WEB felületen más módon jeleníthetők meg: Időablakok lekérdezése Jóváhagyás kérés üzenetek lekérdezése Üzenetek lekérdezése 2.2 Autentikáció A kommunikációs csatornát hálózati szinten az Internet, transzport szinten a TCP/IP, alkalmazásszinten pedig a kliensoldali SOAP-alkalmazás és a szerveroldali webserver együttműködése adja HTTPS protokoll formájában. A HTTPS protokoll kliens- és szerveroldali X.509- tanúsítvány alapú autentikációval van kialakítva. A rendszer ehhez a hozzáférési mechanizmushoz társítja a szolgáltatói felhasználó által végezhető műveletek körét. Az autentikáció kliensoldali feltétele, hogy a SOAP-kliens számára rendelkezésre álljon egy, az NMHH hitelesítés szolgáltató rendszere által kiállított KRA-felhasználói hozzáférési tanúsítvány PKCS12 formában. Több SK-hoz regisztrált felhasználó a SOAP interfészen bármelyik regisztrált SK nevében beküldhet üzenetet a KRA-ba. 2.3 Elektronikus aláírás Elektronikus aláírás alkalmazása esetén minden kimenő és bejövő XML-dokumentum elektronikus aláírással van ellátva a hivatkozott W3C XML Signature szabvány szerint. A KRA-rendszerrel történő kommunikáció a KRA-rendszer által specifikált SOAP XML protokoll és az azok hitelesítéséhez szükséges XML Signature (RFC 3275, RFC 2807) protokoll együttes alkalmazása révén valósul meg. A KRA rendszerben a KRA Elektronikus aláírási kézikönyvben meghatározott tanúsítványok és algoritmusok alkalmazhatók. Az alábbi ábra egy példa KRA-XML-t mutat be ábrázolás technikai szempontból (az alábbi XML nem egy valós kommunikációs esetet ábrázol): KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 9/70

Az KRA-rendszer megvalósít egy automatikus elektronikus aláírás készítő funkciót, illetve egy automatikus elektronikus aláírás ellenőrző funkciót (online CRL-ellenőrzéssel, melynek előfeltétele, hogy az aláíró tanúsítványában szereplő CRL distribution point(ok) URL-je(i) elérhető(ek) legyen(ek) az alkalmazás számára) Az alábbi ábra egy általános sematikus képet ad az elektronikus aláírásról és annak ellenőrzéséről a KRA szempontjából. KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 10/70

A KRA az elektronikus aláírás előállításához a CryproSigno Interop API-t használja, amely a Polysys Kft. által forgalmazott tanúsított szoftver. Az aláírt dokumentum szerkezetében az aláírt adattartalom ill. az aláírással kapcsolatos metaadatok <Signature> </Signature> által vannak közrezárva. Ez az alábbi alstruktúrákat tartalmazza: 1. SignedInfo Ezen belül minden statikus, kivéve a DigestValue értékét, amely az Object tagok által közbezárt struktúra XML-kanonizált formájának SHA1 hash-értékét tartalmazza. <SignedInfo> <CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n- 20010315#WithComments" /> <SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1" /> <Reference URI="#object"> <DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" /> <DigestValue>ku6RwffhAJcih4VTWniHI4owrds=</DigestValue> </Reference> </SignedInfo> 2. SignatureValue A SignedInfo XML-kanonizált formájából képzett SHA1 hash-értékének RSA privát kulccsal elkódolt formája. 3. KeyInfo Ez a struktúra az aláíráshoz szükséges felhasználói komponenseket tartalmazza: KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 11/70

KeyValue A modulus és exponent a felhasználó tanúsítványának publikus kulcsának modulusa és exponense BASE64 (MIME) formában. X509Data A felhasználó tanúsítványának X509 formája BASE64 (MIME) formában. 2.4 Elektronikus aláírás ellenőrzés nélküli üzemmód Előfordulhat, hogy szolgáltató oldalon valamiért nem előállítható érvényes és helyesen aláírt SOAP XML állomány. Lehetőség van a KRA-t egy vészhelyzeti módba kapcsolni, amikor sem a web felületen, sem a SOAP interfészen beérkező SOAP üzeneteken nem végzi el az aláírás ellenőrzését. Ebben az esetben is meg kell felelni a beérkező üzenetnek az aláírt üzenet esetén megfogalmazott formai és tartalmi követelményeknek, de nem okoz problémát, ha az aláírás érvénytelen. A SOAP üzenetek formátuma meg kell, hogy egyezzen az aláírás nélküli állapotban a normál XML formátumával, de mivel nem szükséges aláírni az aláírást hordozó meta információk tetszőleges adattal feltölthetők. A gyakorlatban azt jelenti, hogy az XML tag-nek szerepelni kell az üzenetben az a fent (2.3 fejezet) megadott módon, de az értéke lehet tetszőleges, akár üres is. A KRA ilyen esetben is minden egyes válasz üzenetet digitálisan aláír. KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 12/70

3 XML KOMMUNIKÁCIÓS ÜZENETEK Ez a fejezet a KRA rendszer és a szolgáltatók között lehetséges üzenetek általános feltételeit tartalmazza. Az XML-kommunikáció a SOAP-XML 1.0 szabvány szerint valósul meg. Az adott SOAP servicek paraméterei a <messagebody> tag alatt kerülnek elhelyezésre. A táblázatok a kommunikáció paramétereit rögzítik, az első két üzenetnél az előállítandó XMLszerkezetet is ábrázoltuk, a többi esetre az üzenetet ennek megfelelően kell előállítani a megadott paraméterek alapján. A táblázatok az alábbi formában tartalmazzák az adatokat: Megnevezés Mezőnév Logikai típus, érték Lookup_values értéktípusa, megjegyzés A Lookup_values értéktípusok lehetséges értékeit a 7. fejezet M1 melléklete tartalmazza. A mezők értékeire vonatkozó megszorítások, illetve feltételek: A dátumokat a következő formában várja a rendszer (az Oracle dátum jelöléseivel): yyyy-mm-dd hh24:mi:ss A tranzakciókban szereplő hordozott tartomány kezdete és vége 8 vagy 9 jegyű, elválasztó karakterek nélküli számjegysorozat lehet (belföldi szám: körzetszám/shs + előfizetői szám). Egy hordozási tranzakcióban egy számra, vagy több számból álló, de összefüggő számtartományra lehet műveletet végezni. A megadott számtartomány vége nagyobb vagy egyenlő legyen, mint a kezdete. A szolgáltató által generált üzenetben az adott üzenet tranzakció azonosítója az üzenetet a szolgáltató rendszerében egyedileg azonosító karaktersorozat, azaz egy szolgáltató ugyanazt a karaktersorozatot csak egyszer adhatja meg. A tranzakció azonosító legfeljebb 23 karakterből állhat. A szolgáltató által generált tranzakció azonosító nem tartalmazza a szolgáltató kódot. A nyugtában a KRA rendszer által visszaigazolt KRA azonosító a KRA rendszerben egyedi azonosító, amely a szolgáltató kódjának és a szolgáltató által küldött tranzakció azonosítónak összefűzésével keletkezik. Ugyanezért pl. jóváhagyásnál vagy törlésnél a meghivatkozott üzenetek tranzakció azonosítójának tartalmazni kell az üzenetet generáló szolgáltató kódját is, azaz a KRA azonosítót. A szolgáltató kód három jegyű számsorozat. A szolgáltató kódok listája az NMHH honlapján megtekinthető. A berendezés kód háromjegyű számsorozat. A nem-földrajzi számokra a berendezés kód a számtípustól függő, rögzített érték lehet. Az egyes számtípusokhoz az alapértelmezett értékeket a KRA Általános ismertető tartalmazza. A felhasználó azonosító a titkosított kommunikációs csatornához használt felhasználói tanúsítvány kitüntetett neve (Distinguished Name). Pl.: CN=Operator, OU=KRA, O=NMHH, KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 13/70

C=HU A díjkategóriára vonatkozó tag-ek tartalmát figyelmen kívül hagyja a rendszer. A szolgáltatók által küldött üzenetre a KRA nyugtával válaszol. Ha a nyugtában megadott kód értéke 10-nél alacsonyabb, akkor általában hibátlan üzenetről beszélhetünk. A szolgáltatók által beküldött üzenet típusokat (message_type) a következő fejezetekben az alábbi sorrendben ismertetjük: Számhordozási tranzakciós üzenetek fejezet message_type üzenet megnevezése 4.1 1 Hordozás bejelentés 4.2 8 Hordozás bejelentés jóváhagyás válasz 4.3 2 Hordozás bejelentés törlése 4.4 45 Berendezés kód módosítás bejelentése 4.5 3 Számhasználat megszüntetése 4.6 84 Számhasználat megszüntetés törlése 4.7 35 Hely szerinti hordozás bejelentése 4.8 36 Hely szerinti hordozás bejelentés törlése 4.9 39 Hely szerinti hordozás megszüntetése 4.10 91 Hely szerinti hordozás megszüntetés törlése 4.11 70 Szám visszatartás bejelentése 4.12 71 Szám visszatartás bejelentés jóváhagyás válasz 4.13 80 Szám visszatartás bejelentés törlése 4.14 171 Visszahordozás és hely szerinti hordozás bejelentés 4.15 173 Visszahordozás és hely szerinti hordozás bejelentés jóváhagyás válasz 4.16 179 Visszahordozás és hely szerinti hordozás bejelentés törlése 4.17 14 Irányítási adatok kérése Listákat visszaadó üzenetek fejezet message_type üzenet megnevezése 5.1 7 Jóváhagyás kérés üzenetek lekérdezése 5.2 9 A KRA üzeneteinek lekérdezése 5.3 10 Időablakok lekérdezése KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 14/70

4 SZÁMHORDOZÁSI TRANZAKCIÓK 4.1 Hordozás bejelentés Üzenet típus message_type szám, 1 Átvevő szolgáltató provider_1 string, a szolg. kódja Átadó szolgáltató provider_2 string, a szolg. kódja A kezdeményező szerepe (0 átadó, 1 átvevő) provider_3 string Jelenleg használaton kívül. A jogszabályok szerint csak az átvevő szolgáltató kezdeményezheti a hordozás bejelentését A hordozott tartomány kezdete startr szám A hordozott tartomány vége stopr szám A hordozás érvényességének kezdete validd string, oracle dátum formában Tranzakció azonosító tr_id string, szolgáltató Szolgáltató kód nélkül generálja Felhasználóazonosító user_dn string A KRA weboldalán a szolgáltatói adatok / felhasználói adatok megtekintése menüpontban a címtári cím sorban található karakterlánc A hordozott számok díjkategóriája tax szám Jelenleg használaton kívül Berendezés kód equip string, Megadott számtípusoknál alapértelmezett érték Minta XML hordozás bejelentés üzenethez <soap-env:envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"> <soap-env:header/> <soap-env:body> <Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> <SignedInfo xmlns="http://www.w3.org/2000/09/xmldsig#"> <CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/> <SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/> <Reference URI="#object"> <DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/> <DigestValue>SR3QCsR+cJ+/sU/4rGg37mAbXwg=</DigestValue> </Reference> </SignedInfo> <SignatureValue> FnMV0DRcQqPyvcIOBFryhAMfxOBZsCIjjqguY8UWms3wFivKcA/ypjgZbgMe4QEH SNoFJkE1wDbOPz9v4JaEyuE1IDaq6b6ZeP/CuC4w22HCivMZh7Wrl2SflKkgndSj 6+oXkOyWrhod5jKzDaipkdM1aWlhSgpdQE9D4D+0GvY= </SignatureValue> <KeyInfo> <KeyValue> <RSAKeyValue> <Modulus>uaAyH7zLziItjcgOKc+0SX/pFITIOHAN55BQ9oO30eN4qJLK0vqO0msZeCO14415 wqxwzpriox6ak+alg5yfi1ha3m5rdk7l9eg+vfx+fys1ideigjvscm8zl1iiw+e KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 15/70

rzdjhyv6rw47me0oeheesienfqiae3lzucqe9uojfou=</modulus> <Exponent>AQAB</Exponent> </RSAKeyValue> </KeyValue> <X509Data> <X509Certificate>MIIBoTCCAQoCAQEwDQYJKoZIhvcNAQEEBQAwGzEZMBcGA1 UEAxMQU2FmcmFueW9zIElzdHZhbjAeFw0wMzA2MjYxNjAwMzRaFw0xMzA2MjMxNj AwMzRaMBcxFTATBgNVBAMTDElwbGFuZXRVc2VyMTCBnzANBgkqhkiG9w0BAQEF AAOBjQAwgYkCgYEAuaAyH7zLziItjcgOKc+0SX/pFITIOHAN55BQ9oO30eN4qJLK0vqO 0msZeCO14415wwqxWZPRiOx6AK+alG5yFi1hA3M5rdk7L9eG+vfx+FYs1iDeigjVscM8zl 1iIw+erzDjHYv6RW47Me0oeHEEsienfqIae3lzucqE9UoJfOUCAwEAATANBgkqhkiG9w0B AQQFAAOBgQCP2OyUlzorE4B+UuuLmBUuyxbe8IcEDUJawG88hYMq9Liqc7kzdkpEXIx kjdysjn9n1wgf9m+4g8gamuv3yi52vmmrjha4p6uaogotxhb+ufrpguojuyyf/gfpvz1q c8mekmwgap2tjk0hlnpqzidxtz8ueq5i3h7mmd4vjpxcca==</x509certificate> </X509Data> </KeyInfo> <Object xmlns="http://www.w3.org/2000/09/xmldsig#" Id="object-1"> <timestamp>fri Jul 25 17:15:29 2003</timestamp> <messagebody> <message_type>1</message_type> <provider_1>903</provider_1> <provider_2>902</provider_2> <provider_3>1</provider_3> <startr>52362166</startr> <stopr>52362166</stopr> <validd>2003-8-3 08:30:00</validd> <tr_id>56268475</tr_id> <user_dn>cn=iplanetuser2</user_dn> <tax>1</tax> <equip>010</equip> </messagebody> </Object> </Signature> </soap-env:body> </soap-env:envelope> Válasz az üzenetre Hibakód code szám TR_STATES-szám Hibaüzenet description string TR_STATES-string A visszaigazolt KRA azonosító tr_id string Szolgáltató kóddal <soap-env:envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"> <soap-env:header /> <soap-env:body> <Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> <SignedInfo> <CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315#WithComments" /> <SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1" /> <Reference URI="#object"> <DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" /> <DigestValue>9XWqgW64690ZtMtDqnfVDEZeGI4=</DigestValue> </Reference> </SignedInfo> <SignatureValue>XK4UN0alclZJq6WWbnbP0GZNqCmKaqZnhg/+2GDGTIGvjmMEae2hpIMbwp0Ppcjg E1d78zei/VhYz/avtC+fl3sGMLzLGZKHnDmEel853O3YVBVVyW9EOSeaIa+v09f9 qacha9smja7lf3jdks+uchvht80aptzdphogbcjrgbw=</signaturevalue> KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 16/70

<KeyInfo xmlns="http://www.w3.org/2000/09/xmldsig#"> <X509Data> <X509Certificate>MIIC/jCCAmegAwIBAgIQWLkA1buC/mRoAUURt0073DANBgkqhkiG9w0BAQUFADBE MQswCQYDVQQGEwJIVTEMMAoGA1UEChMDSElGMREwDwYDVQQLEwhLUkEtVEVTVDEU MBIGA1UEAxMLS1JBIFRlc3QgQ0EwHhcNMDUwMjA0MTA0NTMyWhcNMDcwMzMxMjAw MzMyWjCBjDELMAkGA1UEBhMCSFUxDDAKBgNVBAoTA05ISDERMA8GA1UECxMIS1JB LVRFU1QxJzAlBgNVBAMTHktSQSBUZXN0IFJlbmRzemVyIEFsYWlybyBLdWxjczEe MBwGCSqGSIb3DQEJARYPa3JhLXVzemlAbmhoLmh1MRMwEQYKCZImiZPyLGQBARMD NDAzMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC2rUuM185KyoCQuqHRB9fe +QDb66YtDh0/FZSaEWmxbi5E6mkIUPpb30mzztFVyHpOozLa5A4itCd28dvjtIPk 6eio+yteJ2g9rfkZvCUSgUXk/D05HtAxnGxR5fNycGEz9TytaVLzdpsq/Ay8bpoQ KtlcRmzmxxfEAqSq87J6jQIDAQABo4GnMIGkMDQGA1UdHwQtMCswKaAnoCWGI2h0 dha6ly93d3cubmholmh1l2nybc9rcmf0zxn0y2euy3jsmbegcwcgsagg+eibaqqe AwIHgDAfBgNVHSMEGDAWgBQkzPDXxC/W3t51XBojdh3csv5U/jAJBgNVHRMEAjAA MA4GA1UdDwEB/wQEAwIHgDAdBgNVHQ4EFgQUsBlE7jr3Qp4dCBerNkBy+MGYe2Mw DQYJKoZIhvcNAQEFBQADgYEAr7VbsjLU3EIOZJYLa0lcm4JfCxBl+Ruo/eZLmivZ IkS78kfjv8fBLUjx7QaJvX15YQDwf9bj508OG3HwTu/gKdgxf5l+BsoLIyHt1rI4 JBpud2snPHI2ToBX5T5GnTAwEl7OX4ptCFdN0WeGu1mvXFqlB+nrLrebr8DVnpVlovM=</X509Certificate> </X509Data> <KeyValue> <RSAKeyValue> <Modulus>tq1LjNfOSsqAkLqh0QfX3vkA2+umLQ4dPxWUmhFpsW4uROppCFD6W99Js87RVch6 TqMy2uQOIrQndvHb47SD5OnoqPsrXidoPa35GbwlEoFF5Pw9OR7QMZxsUeXzcnBh M/U8rWlS83abKvwMvG6aECrZXEZs5scXxAKkqvOyeo0=</Modulus> <Exponent>AQAB</Exponent> </RSAKeyValue> </KeyValue> </KeyInfo> <Object Id="object"> <messagebody> <tr_id>90366544334</tr_id> <description>az atado szolgaltato nem regisztralt.</description> <code>13</code> </messagebody> </Object> </Signature> </soap-env:body> </soap-env:envelope> 4.2 Hordozás bejelentés jóváhagyás válasz Üzenet típus message_type szám, 8 A jóváhagyó szolgáltató azonosítója provider_id string A hordozott tartomány kezdete startr szám A hordozott tartomány vége stopr szám A hordozás érvényességének kezdete validd string Validálási célra szolgál A szolgáltató által generált számhordozás bejelentés tranzakció azonosító tr_id string Szolgáltató kóddal A jóváhagyandó bejelentés tranzakció azonosítója (nem új!) Felhasználóazonosító user_dn string A KRA weboldalán a szolgáltatói adatok/ felhasználói adatok megtekintése menüpontban a címtári cím sorban található karakterlánc Az átadó válasza reply szám REPLIES KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 17/70

Válasz az üzenetre Hibakód code szám TR_STATES-szám Hibaüzenet description string TR_STATES-string A visszaigazolt KRA azonosító tr_id string Szolgáltató kóddal 4.3 Hordozás bejelentés törlése Üzenet típus message_type szám, 2 Átvevő szolgáltató provider_1 string, a szolg. kódja Átadó szolgáltató provider_2 string, a szolg. kódja A hordozott tartomány kezdete startr szám A hordozott tartomány vége stopr szám A hordozás érvényességének kezdete validd string, oracle Ellenőrzésre szolgál Tranzakció azonosító tr_id string, Szolgáltató kód nélkül szolgáltató generálja Felhasználóazonosító user_dn string A KRA weboldalán a szolgáltatói adatok/ felhasználói adatok megtekintése menüpontban a címtári cím sorban található karakterlánc Törölni kívánt bejelentés tranzakció reference_id szám Szolgáltató kóddal KRA azonosítója A törlés indokának kódja reason szám DEL_REPLIES Minta XML hordozás bejelentés törlése üzenetre <soap-env:envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"> <soap-env:header/> <soap-env:body> <Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> <SignedInfo xmlns="http://www.w3.org/2000/09/xmldsig#"> <CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/> <SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/> <Reference URI="#object"> <DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/> <DigestValue>SR3QCsR+cJ+/sU/4rGg37mAbXwg=</DigestValue> </Reference> </SignedInfo> <SignatureValue> FnMV0DRcQqPyvcIOBFryhAMfxOBZsCIjjqguY8UWms3wFivKcA/ypjgZbgMe4QEH SNoFJkE1wDbOPz9v4JaEyuE1IDaq6b6ZeP/CuC4w22HCivMZh7Wrl2SflKkgndSj 6+oXkOyWrhod5jKzDaipkdM1aWlhSgpdQE9D4D+0GvY= </SignatureValue> <KeyInfo> <KeyValue> <RSAKeyValue> KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 18/70

<Modulus>uaAyH7zLziItjcgOKc+0SX/pFITIOHAN55BQ9oO30eN4qJLK0vqO0msZeCO14415 wqxwzpriox6ak+alg5yfi1ha3m5rdk7l9eg+vfx+fys1ideigjvscm8zl1iiw+e rzdjhyv6rw47me0oeheesienfqiae3lzucqe9uojfou=</modulus> <Exponent>AQAB</Exponent> </RSAKeyValue> </KeyValue> <X509Data> <X509Certificate>MIIBoTCCAQoCAQEwDQYJKoZIhvcNAQEEBQAwGzEZMBcGA1 UEAxMQU2FmcmFueW9zIElzdHZhbjAeFw0wMzA2MjYxNjAwMzRaFw0xMzA2MjMxNj AwMzRaMBcxFTATBgNVBAMTDElwbGFuZXRVc2VyMTCBnzANBgkqhkiG9w0BAQEF AAOBjQAwgYkCgYEAuaAyH7zLziItjcgOKc+0SX/pFITIOHAN55BQ9oO30eN4qJLK0vqO 0msZeCO14415wwqxWZPRiOx6AK+alG5yFi1hA3M5rdk7L9eG+vfx+FYs1iDeigjVscM8zl 1iIw+erzDjHYv6RW47Me0oeHEEsienfqIae3lzucqE9UoJfOUCAwEAATANBgkqhkiG9w0B AQQFAAOBgQCP2OyUlzorE4B+UuuLmBUuyxbe8IcEDUJawG88hYMq9Liqc7kzdkpEXIx kjdysjn9n1wgf9m+4g8gamuv3yi52vmmrjha4p6uaogotxhb+ufrpguojuyyf/gfpvz1q c8mekmwgap2tjk0hlnpqzidxtz8ueq5i3h7mmd4vjpxcca==</x509certificate> </X509Data> </KeyInfo> <Object xmlns="http://www.w3.org/2000/09/xmldsig#" Id="object-1"> <timestamp>fri Jul 25 17:15:29 2003</timestamp> <messagebody> <message_type>2</message_type> <provider_1>903</provider_1> <provider_2>902</provider_2> <startr>52362166</startr> <stopr>52362166</stopr> <validd>2003-8-3 08:30:00</validd> <tr_id>56268475</tr_id> <user_dn>cn=iplanetuser2</user_dn> <reference_id>1121</reference_id> <reason>0</reason> </messagebody> </Object> </Signature> </soap-env:body> </soap-env:envelope> Válasz az üzenetre Hibakód code szám TR_STATES-szám Hibaüzenet description string TR_STATES-string A visszaigazolt KRA azonosító tr_id string Szolgáltató kóddal <soap-env:envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"> <soap-env:header /> <soap-env:body> <Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> <SignedInfo> <CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315#WithComments" /> <SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1" /> <Reference URI="#object"> <DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" /> <DigestValue>+7+ubZ1RavogR2CaBAHX3mfuTKo=</DigestValue> </Reference> </SignedInfo> KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 19/70

<SignatureValue>Jzgzf41X2lrbryATWZ+zS5Rp7E2fWuErZdSwFdFSlEDAVVQljLO47OzKUuMDRELK tlkmvle7r9ux6sxludtsq/cxs/pnssl4vov1rd/blazpior7cwlozjttw7ir3tsx yantxnxhjpjasutg31jhc2kwp6dub1gelz5r2fpm1s4=</signaturevalue> <KeyInfo xmlns="http://www.w3.org/2000/09/xmldsig#"> <X509Data> <X509Certificate>MIIC/jCCAmegAwIBAgIQWLkA1buC/mRoAUURt0073DANBgkqhkiG9w0BAQUFADBE MQswCQYDVQQGEwJIVTEMMAoGA1UEChMDSElGMREwDwYDVQQLEwhLUkEtVEVTVDEU MBIGA1UEAxMLS1JBIFRlc3QgQ0EwHhcNMDUwMjA0MTA0NTMyWhcNMDcwMzMxMjAw MzMyWjCBjDELMAkGA1UEBhMCSFUxDDAKBgNVBAoTA05ISDERMA8GA1UECxMIS1JB LVRFU1QxJzAlBgNVBAMTHktSQSBUZXN0IFJlbmRzemVyIEFsYWlybyBLdWxjczEe MBwGCSqGSIb3DQEJARYPa3JhLXVzemlAbmhoLmh1MRMwEQYKCZImiZPyLGQBARMD NDAzMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC2rUuM185KyoCQuqHRB9fe +QDb66YtDh0/FZSaEWmxbi5E6mkIUPpb30mzztFVyHpOozLa5A4itCd28dvjtIPk 6eio+yteJ2g9rfkZvCUSgUXk/D05HtAxnGxR5fNycGEz9TytaVLzdpsq/Ay8bpoQ KtlcRmzmxxfEAqSq87J6jQIDAQABo4GnMIGkMDQGA1UdHwQtMCswKaAnoCWGI2h0 dha6ly93d3cubmholmh1l2nybc9rcmf0zxn0y2euy3jsmbegcwcgsagg+eibaqqe AwIHgDAfBgNVHSMEGDAWgBQkzPDXxC/W3t51XBojdh3csv5U/jAJBgNVHRMEAjAA MA4GA1UdDwEB/wQEAwIHgDAdBgNVHQ4EFgQUsBlE7jr3Qp4dCBerNkBy+MGYe2Mw DQYJKoZIhvcNAQEFBQADgYEAr7VbsjLU3EIOZJYLa0lcm4JfCxBl+Ruo/eZLmivZ IkS78kfjv8fBLUjx7QaJvX15YQDwf9bj508OG3HwTu/gKdgxf5l+BsoLIyHt1rI4 JBpud2snPHI2ToBX5T5GnTAwEl7OX4ptCFdN0WeGu1mvXFqlB+nrLrebr8DVnpVlovM=</X509Certificate> </X509Data> <KeyValue> <RSAKeyValue> <Modulus>tq1LjNfOSsqAkLqh0QfX3vkA2+umLQ4dPxWUmhFpsW4uROppCFD6W99Js87RVch6 TqMy2uQOIrQndvHb47SD5OnoqPsrXidoPa35GbwlEoFF5Pw9OR7QMZxsUeXzcnBh M/U8rWlS83abKvwMvG6aECrZXEZs5scXxAKkqvOyeo0=</Modulus> <Exponent>AQAB</Exponent> </RSAKeyValue> </KeyValue> </KeyInfo> <Object Id="object"> <messagebody> <tr_id>90366456865</tr_id> <description>a hivatkozott tranzakcio azonosito nem letezik.</description> <code>14</code> </messagebody> </Object> </Signature> </soap-env:body> </soap-env:envelope> 4.4 Berendezés kód módosítás bejelentése Üzenet típus message_type szám, 45 Átvevő szolgáltató provider_1 string, a szolg. kódja Átadó szolgáltató provider_2 string, a szolg. kódja A hordozott tartomány kezdete startr szám A hordozott tartomány vége stopr szám Az új berendezés kód equip string A hordozás érvényességének kezdete validd string, oracle Tranzakció azonosító tr_id string, a szolg. generálja Szolgáltató kód nélkül KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 20/70

Felhasználóazonosító user_dn string A KRA weboldalán a szolgáltatói adatok/ felhasználói adatok megtekintése menüpontban a címtári cím sorban található karakterlánc Módosítani kívánt bejelentés tranzakció KRA azonosítója reference_id string Szolgáltató kóddal Válasz az üzenetre Hibakód code szám TR_STATES-szám Hibaüzenet description string TR_STATES-string A visszaigazolt KRA azonosító tr_id string Szolgáltató kóddal 4.5 Számhasználat megszüntetése Üzenet típus message_type szám, 3 A szolgáltató azonosítója provider_id string A megszűnő tartomány kezdete startr szám A megszűnő tartomány vége stopr szám A megszűnés időpontja validd string, oracle Tranzakció azonosító tr_id string, a szolg. Szolgáltató kód nélkül generálja Felhasználóazonosító user_dn string A KRA-adminisztrációs felületen, a Szolgáltatói felhasználók kezelése menüpontban a Címtári cím attribútumbejegyzés értéke Válasz az üzenetre Hibakód code szám TR_STATES-szám Hibaüzenet description string TR_STATES-string A visszaigazolt KRA azonosító tr_id string Szolgáltató kóddal 4.6 Számhasználat megszüntetés törlése Üzenet típus message_type szám, 84 A szolgáltató azonosítója provider_1 string, a szolg. kódja A megszűntetni kívánt tartomány startr szám kezdete A megszűntetni kívánt tartomány vége stopr szám A megszűntetés érvényességének kezdete validd string, oracle Tranzakció azonosító tr_id string, a szolg. generálja Validálási célra szolgál Szolgáltató kód nélkül KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 21/70

Felhasználóazonosító user_dn string A KRA weboldalán a szolgáltatói adatok/ felhasználói adatok megtekintése menüpontban a címtári cím sorban található karakterlánc Törölni kívánt megszűntetés tranzakció reference_id string Szolgáltató kóddal KRA azonosítója A törlés indokának kódja reason szám DEL_REPLIES Válasz az üzenetre Hibakód code szám TR_STATES-szám Hibaüzenet description string TR_STATES-string A visszaigazolt KRA azonosító tr_id string Szolgáltató kóddal 4.7 Hely szerinti hordozás bejelentése Üzenet típus message_type szám, 35 Bejelentő szolgáltató provider_1 string, a szolg. kódja A hordozott tartomány kezdete startr szám A hordozott tartomány vége stopr szám A hely szerinti hordozás érvényességének kezdete validd string, oracle Tranzakció azonosító tr_id string, a szolg. Szolgáltató kód nélkül generálja Felhasználóazonosító user_dn string A KRA weboldalán a szolgáltatói adatok/ felhasználói adatok megtekintése menüpontban a címtári cím sorban található karakterlánc Berendezés kód equip string, az új berendezés kód Válasz az üzenetre Hibakód code szám TR_STATES-szám Hibaüzenet description string TR_STATES-string A visszaigazolt KRA azonosító tr_id string Szolgáltató kóddal 4.8 Hely szerinti hordozás bejelentés törlése Üzenet típus message_type szám, 36 Bejelentő szolgáltató provider_1 string, a szolg. kódja A hordozott tartomány kezdete startr szám A hordozott tartomány vége stopr szám A hely szerinti hordozás bejelentés validd string, oracle Ellenőrzésre szolgál KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 22/70

érvényességi időpontja Tranzakció azonosító tr_id string, a szolg. Szolgáltató kód nélkül generálja Felhasználóazonosító user_dn string A KRA weboldalán a szolgáltatói adatok/ felhasználói adatok megtekintése menüpontban a címtári cím sorban található karakterlánc A törlendő tranzakció KRA azonosítója reference_id string Szolgáltató kóddal Indok reply szám, indok REPLIES azonosítója Berendezéskód equip string, a törlendő tranzakció berendezés kódja Ellenőrzésre szolgál Válasz az üzenetre Hibakód code szám TR_STATES-szám Hibaüzenet description string TR_STATES-string A visszaigazolt KRA azonosító tr_id string Szolgáltató kóddal 4.9 Hely szerinti hordozás megszüntetése Üzenet típus message_type szám, 39 Bejelentő szolgáltató provider_1 string, a szolg. kódja Az érintett tartomány kezdete startr szám Az érintett tartomány vége stopr szám Az irányítás megszűnésének kezdete validd string, oracle Tranzakció azonosító tr_id string, a szolg. Szolgáltató kód nélkül generálja Felhasználóazonosító user_dn string A KRA weboldalán a szolgáltatói adatok/ felhasználói adatok megtekintése menüpontban a címtári cím sorban található karakterlánc Berendezés kód equip string, a hordozott szám berendezés kódja Válasz az üzenetre Hibakód code szám TR_STATES-szám Hibaüzenet description string TR_STATES-string A visszaigazolt KRA azonosító tr_id string Szolgáltató kóddal KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 23/70

4.10 Hely szerinti hordozás megszüntetés törlése Üzenet típus message_type szám, 91 Átvevő szolgáltató provider_1 string, a szolg. kódja Átadó szolgáltató provider_2 string, a szolg. kódja A megszüntetni kívánt tartomány startr szám kezdete A megszüntetni kívánt tartomány vége stopr szám A megszüntetés érvényességének kezdete validd string, oracle Ellenőrzésre szolgál Tranzakció azonosító tr_id string, a szolg. Szolgáltató kód nélkül generálja Felhasználóazonosító user_dn string A KRA weboldalán a szolgáltatói adatok/ felhasználói adatok megtekintése menüpontban a címtári cím sorban található karakterlánc Törölni kívánt megszüntetés tranzakció reference_id string Szolgáltató kóddal KRA azonosítója A törlés indokának kódja reason szám DEL_REPLIES Válasz az üzenetre Hibakód code szám TR_STATES-szám Hibaüzenet description string TR_STATES-string A visszaigazolt KRA azonosító tr_id string Szolgáltató kóddal 4.11 Szám visszatartás bejelentése Üzenet típus message_type szám, 70 Kezdeményező szolgáltató provider_1 string, a szolg. kódja Jóváhagyó szolgáltató provider_2 string, a szolg. kódja A visszatartott tartomány kezdete startr szám A visszatartott tartomány vége stopr szám Tranzakció azonosító tr_id string, a szolg. Szolgáltató kód nélkül generálja Felhasználóazonosító user_dn string A KRA weboldalán a szolgáltatói adatok/ felhasználói adatok megtekintése menüpontban a címtári cím sorban található karakterlánc Berendezés kód equip string Megadott számtípusoknál alapértelmezett érték Számmező átadás bejelentés tranzakciójának KRA azonosítója, amely bejelentett számmezeje tartalmazza a visszatartandó számokat reference_id string KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 24/70

Válasz az üzenetre Hibakód code szám TR_STATES-szám Hibaüzenet description string TR_STATES-string A visszaigazolt KRA azonosító tr_id string Szolgáltató kóddal 4.12 Szám visszatartás bejelentés jóváhagyás válasz Üzenet típus message_type szám, 71 A jóváhagyó szolgáltató azonosítója provider_id string A visszatartott tartomány kezdete startr szám A visszatartott tartomány vége stopr szám A szám visszatartás bejelentés tr_id string Szolgáltató kóddal tranzakció azonosítója Felhasználóazonosító user_dn string A KRA weboldalán a szolgáltatói adatok/ felhasználói adatok megtekintése menüpontban a címtári cím sorban található karakterlánc Az átadó válasza reply szám REPLIES Válasz az üzenetre Hibakód code szám TR_STATES-szám Hibaüzenet description string TR_STATES-string A visszaigazolt KRA azonosító tr_id string Szolgáltató kóddal 4.13 Szám visszatartás bejelentés törlése Üzenet típus message_type szám, 80 Kezdeményező szolgáltató provider_1 string, a szolg. kódja Jóváhagyó szolgáltató provider_2 string, a szolg. kódja A visszatartott tartomány kezdete startr szám A visszatartott tartomány vége stopr szám Tranzakció azonosító tr_id string, a szolg. Szolgáltató kód nélkül generálja Felhasználóazonosító user_dn string A KRA weboldalán a szolgáltatói adatok/ felhasználói adatok megtekintése menüpontban a címtári cím sorban található karakterlánc Törölni kívánt bejelentés tranzakció reference_id string Szolgáltató kóddal KRA azonosítója A törlés indokának kódja reason szám DEL_REPLIES KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 25/70

Válasz az üzenetre Hibakód code szám TR_STATES-szám Hibaüzenet description string TR_STATES-string A visszaigazolt KRA azonosító tr_id string Szolgáltató kóddal 4.14 Visszahordozás és hely szerinti hordozás bejelentés Üzenet típus message_type szám, 171 Átvevő szolgáltató provider_1 string, a szolg. kódja Átadó szolgáltató provider_2 string, a szolg. kódja A hordozott tartomány kezdete startr szám A hordozott tartomány vége stopr szám A hordozás érvényességének kezdete validd string, oracle dátum formában Tranzakció azonosító tr_id string, szolgáltató Szolgáltató kód nélkül generálja Felhasználóazonosító user_dn string A KRA weboldalán a szolgáltatói adatok / felhasználói adatok megtekintése menüpontban a címtári cím sorban található karakterlánc Berendezés kód equip string, Megadott számtípusoknál alapértelmezett érték Válasz az üzenetre Hibakód code szám TR_STATES-szám Hibaüzenet description string TR_STATES-string A visszaigazolt KRA azonosító tr_id string Szolgáltató kóddal 4.15 Visszahordozás és hely szerinti hordozás bejelentés jóváhagyás válasz Üzenet típus message_type szám, 173 A jóváhagyó szolgáltató azonosítója provider_id string A hordozott tartomány kezdete startr szám A hordozott tartomány vége stopr szám A hordozás érvényességének kezdete validd string Validálási célra szolgál A szolgáltató által generált számhordozás bejelentés tranzakció azonosító tr_id string Szolgáltató kóddal A jóváhagyandó bejelentés tranzakció azonosítója (nem új!) Felhasználóazonosító user_dn string A KRA weboldalán a szolgáltatói adatok/ felhasználói adatok megtekintése menüpontban a címtári cím sorban található karakterlánc Az átadó válasza reply szám REPLIES KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 26/70

Válasz az üzenetre Hibakód code szám TR_STATES-szám Hibaüzenet description string TR_STATES-string A visszaigazolt KRA azonosító tr_id string Szolgáltató kóddal 4.16 Visszahordozás és hely szerinti hordozás bejelentés törlése Üzenet típus message_type szám, 179 Átvevő szolgáltató provider_1 string, a szolg. kódja Átadó szolgáltató provider_2 string, a szolg. kódja A hordozott tartomány kezdete startr szám A hordozott tartomány vége stopr szám A hordozás érvényességének kezdete validd string, oracle Ellenőrzésre szolgál Tranzakció azonosító tr_id string, Szolgáltató kód nélkül szolgáltató generálja Felhasználóazonosító user_dn string A KRA weboldalán a szolgáltatói adatok/ felhasználói adatok megtekintése menüpontban a címtári cím sorban található karakterlánc Törölni kívánt bejelentés tranzakció reference_id szám Szolgáltató kóddal KRA azonosítója A törlés indokának kódja reason szám DEL_REPLIES Válasz az üzenetre Hibakód code szám TR_STATES-szám Hibaüzenet description string TR_STATES-string A visszaigazolt KRA azonosító tr_id string Szolgáltató kóddal 4.17 Irányítási adatok kérése (Query) Az irányítási adatok letöltése a következő módon történik: 1. A felhasználó a megfelelő irányítási listát kéri az üzenetben (message_type=14), 2. A szolgáltató az Irányítási adat letölthető (TRANSACTION_TYPE=26) üzenetben értesül a lista letölthetőségének helyéről (URL), amint a lista rendelkezésre áll, 3. A felhasználó a megadott URL-ről letölti a kért listát. KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 27/70

Üzenet típus message_type szám, 14 Az aktuális szolgáltató azonosítója prov_code string A delta lekérdezés kezdetének időpontja from_ts string, oracle q_type=3-nál, olyan időpont megadása esetén melyhez nem tartozik a listakönyvtárban lista, a következő időablakra vonatkozó lista lesz elérhető A szolgáltató által generált tr_id string Szolgáltató kód nélkül tranzakcióazonosító A lekérdezés típusa q_type szám QUERY_TYPE Felhasználóazonosító user_dn string A KRA weboldalán a szolgáltatói adatok/ felhasználói adatok megtekintése menüpontban a címtári cím sorban található karakterlánc Válasz az üzenetre Hibakód code szám TR_STATES-szám Hibaüzenet description string TR_STATES-string A visszaigazolt KRA azonosító tr_id string Szolgáltató kóddal KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 28/70

5 LISTÁKAT VISSZAADÓ ÜZENETEK Az alábbi üzenetekre a válasz egy lista, amely a szolgáltatónak szóló üzeneteket tartalmazza. A lista formátuma alapvetően hasonlít az előző fejezetben leírtakhoz, így csak az eltérő részeket emeljük ki a példákban. 5.1 Jóváhagyás kérés üzenetek lekérdezése Üzenet típus message_type szám, 7 Szolgáltató azonosítója prov_code string Tranzakció azonosító tr_id string Szolgáltató kód nélkül User azonosítója user_dn string A KRA weboldalán a szolgáltatói adatok/ felhasználói adatok megtekintése menüpontban a címtári cím sorban található karakterlánc Válasz az üzenetre A válasz két részre bontható, az első a visszaigazolást, nyugtát tartalmazza: Hibakód code szám TR_STATES-szám Hibaüzenet description string TR_STATES-string A visszaigazolt KRA azonosító tr_id string Szolgáltató kóddal A második rész a <list_item> </list_item> közötti lehetséges adatok: A tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám TR_TYPES A felhasználó neve USER_NAME string A tárolás dátuma STORE_TS string, oracle Szolgáltató kód PROVIDER_CODE_2 string A szolgáltató neve PROVIDER_NAME_2 string Szolgáltató kód PROVIDER_CODE_3 string A szolgáltató neve PROVIDER_NAME_3 string Berendezés kód EQUIPMENT_CODE string Díjkategória BILLING_CATEGORY string Jelenleg használaton kívül. Az érvényesség kezdete VALID_FROM string, oracle KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 29/70

Az üzenet állapota (kód) STATE szám TR_STATES-szám A válaszként előálló listára egy példa: <soap-env:envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"> <soap-env:header /> <soap-env:body> <Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> <SignedInfo> <CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315#WithComments" /> <SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1" /> <Reference URI="#object"> <DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" /> <DigestValue>lkQEYqZO3qZTmO48alOTSZEm3js=</DigestValue> </Reference> </SignedInfo> <SignatureValue>MAuGvVKe3tClg12pblZXOdQMUAMe4Cna47B4Wt1v2mMgFn83GlboW4JmYP/+b8si xpnw57nxeixu/siniyxxlgs3rn5wntpysw8tshcj/aufzespm5brdfw+jvx5dpqs q4k2mcp4ywo/eyjbebimqt5xdus19g37g8mzxn8/jta=</signaturevalue> <KeyInfo xmlns="http://www.w3.org/2000/09/xmldsig#"> <X509Data> <X509Certificate> MIIC/jCCAmegAwIBAgIQWLkA1buC/mRoAUURt0073DANBgkqhkiG9w0BAQUFADBE MQswCQYDVQQGEwJIVTEMMAoGA1UEChMDSElGMREwDwYDVQQLEwhLUkEtVEVTVDEU MBIGA1UEAxMLS1JBIFRlc3QgQ0EwHhcNMDUwMjA0MTA0NTMyWhcNMDcwMzMxMjAwMzMyWjCBjDELMAkGA1UEBh MCSFUxDDAKBgNVBAoTA05ISDERMA8GA1UECxMIS1JBLVRFU1QxJzAlBgNVBAMTHktSQSBUZXN0IFJlbmRzemVyIEF sywlybybldwxjczeembwgcsqgsib3dqejarypa3jhlxvzemlabmholmh1mrmweqykczimizpylgqbarmdndazmig fma0gcsqgsib3dqebaquaa4gnadcbiqkbgqc2ruum185kyocquqhrb9fe+qdb66ytdh0/fzsaewmxbi5e6mkiuppb 30mzztFVyHpOozLa5A4itCd28dvjtIPk6eio+yteJ2g9rfkZvCUSgUXk/D05HtAxnGxR5fNycGEz9TytaVLzdpsq/Ay8bpoQKtlcRm zmxxfeaqsq87j6jqidaqabo4gnmigkmdqga1udhwqtmcswkaanocwgi2h0dha6ly93d3cubmholmh1l2nybc9rcmf0z XN0Y2EuY3JsMBEGCWCGSAGG+EIBAQQEAwIHgDAfBgNVHSMEGDAWgBQkzPDXxC/W3t51XBojdh3csv5U/jAJBgNVH RMEAjAAMA4GA1UdDwEB/wQEAwIHgDAdBgNVHQ4EFgQUsBlE7jr3Qp4dCBerNkBy+MGYe2MwDQYJKoZIhvcNAQEFB QADgYEAr7VbsjLU3EIOZJYLa0lcm4JfCxBl+Ruo/eZLmivZIkS78kfjv8fBLUjx7QaJvX15YQDwf9bj508OG3HwTu/gKdgxf5l+Bs oliyht1ri4jbpud2snphi2tobx5t5gntawel7ox4ptcfdn0wegu1mvxfqlb+nrlrebr8dvnpvlovm= </X509Certificate> </X509Data> <KeyValue> <RSAKeyValue> <Modulus>tq1LjNfOSsqAkLqh0QfX3vkA2+umLQ4dPxWUmhFpsW4uROppCFD6W99Js87RVch6 TqMy2uQOIrQndvHb47SD5OnoqPsrXidoPa35GbwlEoFF5Pw9OR7QMZxsUeXzcnBh M/U8rWlS83abKvwMvG6aECrZXEZs5scXxAKkqvOyeo0=</Modulus> <Exponent>AQAB</Exponent> </RSAKeyValue> </KeyValue> </KeyInfo> <Object Id="object"> <list> <tr_id>9030601112004</tr_id> <code>1</code> <description>a tranzakcio regisztralt.</description> <list_item> <TRANSACTION_ID>000000020060110044</TRANSACTION_ID> <TRANSACTION_TYPE>48</TRANSACTION_TYPE> <USER_ID>1317</USER_ID> <USER_NAME>Opjancsi</USER_NAME> <STORE_TS>2006-01-10 18:57:47</STORE_TS> KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 30/70

<UPDATE_TS>2006-01-10 18:57:47</UPDATE_TS> <PROVIDER_CODE_1>903</PROVIDER_CODE_1> <PROVIDER_NAME_1>BTteszt</PROVIDER_NAME_1> <PROVIDER_CODE_2>000</PROVIDER_CODE_2> <PROVIDER_NAME_2>NHH-V-teszt</PROVIDER_NAME_2> <PROVIDER_CODE_3 /> <PROVIDER_NAME_3></PROVIDER_NAME_3> <EQUIPMENT_CODE /> <STARTRANGE>12202001</STARTRANGE> <STOPRANGE>12202001</STOPRANGE> <BILLING_CATEGORY>0</BILLING_CATEGORY> <VALID_FROM>2006-01-10 21:00:00</VALID_FROM> <STATE>1</STATE> <STATE_MSG>A tranzakcio regisztralt.</state_msg> </list_item> <list_item> <TRANSACTION_ID>00020060110046</TRANSACTION_ID> <TRANSACTION_TYPE>48</TRANSACTION_TYPE> <USER_ID>1317</USER_ID> <USER_NAME>Opjancsi</USER_NAME> <STORE_TS>2006-01-10 19:01:30</STORE_TS> <UPDATE_TS>2006-01-10 19:01:30</UPDATE_TS> <PROVIDER_CODE_1>903</PROVIDER_CODE_1> <PROVIDER_NAME_1>BTteszt</PROVIDER_NAME_1> <PROVIDER_CODE_2>000</PROVIDER_CODE_2> <PROVIDER_NAME_2>NHH-V-teszt</PROVIDER_NAME_2> <PROVIDER_CODE_3 /> <PROVIDER_NAME_3></PROVIDER_NAME_3> <EQUIPMENT_CODE /> <STARTRANGE>12202002</STARTRANGE> <STOPRANGE>12202002</STOPRANGE> <BILLING_CATEGORY>0</BILLING_CATEGORY> <VALID_FROM>2006-01-10 21:00:00</VALID_FROM> <STATE>1</STATE> <STATE_MSG>A tranzakcio regisztralt.</state_msg> </list_item> </list> </Object> </Signature> </soap-env:body> </soap-env:envelope> A válaszként előálló listában az egyes mezők tartalma, jelentése a KRA üzenet típusától, azaz a TRANSACTION_TYPE mező értékétől függően más és más lehet. Az üzenetlista az alábbi KRA üzenet típusokat tartalmazhatja: fejezet TRANSAC- TION_TYPE KRA üzenet megnevezése 5.1.1 2 Hordozás bejelentés jóváhagyás kérés 5.1.2 72 Szám visszatartás jóváhagyás kérés 5.1.3 172 Visszahordozás és hely szerinti hordozás jóváhagyás kérés KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 31/70

5.1.1 Hordozás bejelentés jóváhagyás kérés A bejelentési tranzakció KRA TRANSACTION_ID string Szolgáltató kóddal azonosítója Az üzenet típusa TRANSACTION_TYPE szám, 2 TR_TYPES A bejelentő felhasználó azonosítója USER_ID string A bejelentő felhasználó neve USER_NAME string A tárolás dátuma STORE_TS string, oracle dátum formában Az utolsó módosítás dátuma UPDATE_TS string, oracle dátum formában A jóváhagyó szolgáltató azonosítója (az PROVIDER_CODE_1 string üzenet címzettje) A jóváhagyó szolgáltató neve PROVIDER_NAME_1 string A kezdeményező szolgáltató PROVIDER_CODE_2 string azonosítója A kezdeményező szolgáltató neve PROVIDER_NAME_2 string Az átvevő szolgáltató azonosítója PROVIDER_CODE_3 string Az átvevő szolgáltató neve PROVIDER_NAME_3 string Berendezés kód EQUIPMENT_CODE string A hordozni kívánt tartomány kezdete STARTRANGE szám A hordozni kívánt tartomány vége STOPRANGE szám Díjkategória BILLING_CATEGORY szám Jelenleg használaton kívül. Az érvényesség kezdete VALID_FROM string, oracle dátum formában Az üzenet állapota (kód) STATE szám TR_STATES-szám Az üzenet állapota (szöveg) STATE_MSG string TR_STATES-string 5.1.2 Szám visszatartás jóváhagyás kérés A szám visszatartás bejelentés TRANSACTION_ID string Szolgáltató kóddal tranzakció KRA azonosítója Az üzenet típusa TRANSACTION_TYPE szám, 72 TR_TYPES A bejelentő felhasználó azonosítója USER_ID string A bejelentő felhasználó neve USER_NAME string A tárolás dátuma STORE_TS string, oracle dátum formában Az utolsó módosítás dátuma UPDATE_TS string, oracle dátum formában A bejelentést jóváhagyó (egyben PROVIDER_CODE_1 string átvevő) szolgáltató azonosítója (az üzenet címzettje) A jóváhagyó szolgáltató neve PROVIDER_NAME_1 string A bejelentést kezdeményező (egyben PROVIDER_CODE_2 string átadó) szolgáltató azonosítója A kezdeményező szolgáltató neve PROVIDER_NAME_2 string A visszatartani kívánt tartomány STARTRANGE szám kezdete A visszatartani kívánt tartomány vége STOPRANGE szám A visszatartás érvényességének VALID_FROM string, oracle dátum KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 32/70

kezdete formában Az üzenet állapota (kód) STATE szám TR_STATES-szám Az üzenet állapota (szöveg) STATE_MSG string TR_STATES-string 5.1.3 Visszahordozás és hely szerinti hordozás bejelentés jóváhagyás kérés A bejelentési tranzakció KRA TRANSACTION_ID string Szolgáltató kóddal azonosítója Az üzenet típusa TRANSACTION_TYPE szám, 172 TR_TYPES A bejelentő felhasználó azonosítója USER_ID string A bejelentő felhasználó neve USER_NAME string A tárolás dátuma STORE_TS string, oracle dátum formában Az utolsó módosítás dátuma UPDATE_TS string, oracle dátum formában A jóváhagyó szolgáltató azonosítója (az PROVIDER_CODE_1 string üzenet címzettje) A jóváhagyó szolgáltató neve PROVIDER_NAME_1 string A kezdeményező szolgáltató PROVIDER_CODE_2 string azonosítója A kezdeményező szolgáltató neve PROVIDER_NAME_2 string Az átvevő szolgáltató azonosítója PROVIDER_CODE_3 string Az átvevő szolgáltató neve PROVIDER_NAME_3 string Berendezés kód EQUIPMENT_CODE string A hordozni kívánt tartomány kezdete STARTRANGE szám A hordozni kívánt tartomány vége STOPRANGE szám Az érvényesség kezdete VALID_FROM string, oracle dátum formában Az üzenet állapota (kód) STATE szám TR_STATES-szám Az üzenet állapota (szöveg) STATE_MSG string TR_STATES-string KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 33/70

5.2 A KRA üzeneteinek lekérdezése A KRA rendszer által a szolgáltatók üzenetlistája felé küldött, jóváhagyást nem igénylő üzenetek egyszerre, egy listában tölthetőek le. Ez a lista annyiféle mezőből áll, ahányféle üzenete van a szolgáltatónak a lekérdezett, legfeljebb 72 óra időintervallumban. Időpont megadása nélkül a lekérdezés előtti 72 óra üzenetei tölthetők le. Ennek kezdeményezésére az alábbi üzenet szolgál: Üzenet típus message_type szám, 9 Szolgáltató azonosítója prov_code string Tranzakció azonosító tr_id string Szolgáltató kód nélkül User azonosítója user_dn string A KRA weboldalán a szolgáltatói adatok/ felhasználói adatok megtekintése menüpontban a címtári cím sorban található karakterlánc Időintervallum kezdetének időpontja OPCIONÁLIS start_date string, oracle Válasz az üzenetre A válasz két részre bontható, az első a nyugtát tartalmazza: Hibakód code szám TR_STATES-szám Hibaüzenet description string TR_STATES-string A visszaigazolt KRA azonosító tr_id string Szolgáltató kóddal A második rész a <list_item> </list_item> közötti adatok: A tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám TR_TYPES A felhasználó neve USER_NAME string Hivatkozás REFERENCE_ID string Szolgáltató kód PROVIDER_CODE_2 string A szolgáltató neve PROVIDER_NAME_2 string Szolgáltató kód PROVIDER_CODE_3 string A szolgáltató neve PROVIDER_NAME_3 string Berendezés kód EQUIPMENT_CODE string Díjkategória BILLING_CATEGORY string Jelenleg használaton kívül. Az érvényesség kezdete VALID_FROM string, oracle KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 34/70

Válasz (kód) REPLY szám REPLIES-szám Válasz (szöveges magyarázat) REPLY_MSG string REPLIES-string A letöltés típusa (kód) QUERY_TYPE szám QUERY_TYPE A letöltés típusa (szöveges) QUERY_MSG string Állapot (kód) STATE szám TR_STATES-szám Összes hordozás CARRY_ALL szám Új hordozás CARRY_NEW szám Továbbhordozás CARRY_AWAY szám Visszahordozás CARRY_BACK szám <soap-env:envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"> <soap-env:header /> <soap-env:body> <Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> <SignedInfo> <CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315#WithComments" /> <SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1" /> <Reference URI="#object"> <DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" /> <DigestValue>gSMnqc9Zdf4rXIqjFB4cLj4PFxs=</DigestValue> </Reference> </SignedInfo> <SignatureValue>ekpUvLzSneP1e+0nfP+FfU1bPmdM//jfl66r/gkLLKzpaKBkDN23GC7XO8K4L9IV QqsWIzxH/VSPOm3cQWI3hvLl7rqm+GXhA5HMusL4IBrnnvviu4ZoOyZ3mP/eLsPb YgSRpAESNTyXmX/OxCEuuM/vjV+kOiziTY96CgP59NE=</SignatureValue> <KeyInfo xmlns="http://www.w3.org/2000/09/xmldsig#"> <X509Data> <X509Certificate> MIIC/jCCAmegAwIBAgIQWLkA1buC/mRoAUURt0073DANBgkqhkiG9w0BAQUFADBEMQswCQYDVQQGEwJIVTEMM AoGA1UEChMDSElGMREwDwYDVQQLEwhLUkEtVEVTVDEUMBIGA1UEAxMLS1JBIFRlc3QgQ0EwHhcNMDUwMjA0MT A0NTMyWhcNMDcwMzMxMjAwMzMyWjCBjDELMAkGA1UEBhMCSFUxDDAKBgNVBAoTA05ISDERMA8GA1UECxMIS1J BLVRFU1QxJzAlBgNVBAMTHktSQSBUZXN0IFJlbmRzemVyIEFsYWlybyBLdWxjczEeMBwGCSqGSIb3DQEJARYPa3JhLX VzemlAbmhoLmh1MRMwEQYKCZImiZPyLGQBARMDNDAzMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC2rUu M185KyoCQuqHRB9fe+QDb66YtDh0/FZSaEWmxbi5E6mkIUPpb30mzztFVyHpOozLa5A4itCd28dvjtIPk6eio+yteJ2g9rfkZvC USgUXk/D05HtAxnGxR5fNycGEz9TytaVLzdpsq/Ay8bpoQKtlcRmzmxxfEAqSq87J6jQIDAQABo4GnMIGkMDQGA1UdHwQt MCswKaAnoCWGI2h0dHA6Ly93d3cubmhoLmh1L2NybC9rcmF0ZXN0Y2EuY3JsMBEGCWCGSAGG+EIBAQQEAwIHgDAf BgNVHSMEGDAWgBQkzPDXxC/W3t51XBojdh3csv5U/jAJBgNVHRMEAjAAMA4GA1UdDwEB/wQEAwIHgDAdBgNVHQ4E FgQUsBlE7jr3Qp4dCBerNkBy+MGYe2MwDQYJKoZIhvcNAQEFBQADgYEAr7VbsjLU3EIOZJYLa0lcm4JfCxBl+Ruo/eZLmiv ZIkS78kfjv8fBLUjx7QaJvX15YQDwf9bj508OG3HwTu/gKdgxf5l+BsoLIyHt1rI4JBpud2snPHI2ToBX5T5GnTAwEl7OX4ptCFd N0WeGu1mvXFqlB+nrLrebr8DVnpVlovM= </X509Certificate> </X509Data> <KeyValue> <RSAKeyValue> <Modulus>tq1LjNfOSsqAkLqh0QfX3vkA2+umLQ4dPxWUmhFpsW4uROppCFD6W99Js87RVch6 TqMy2uQOIrQndvHb47SD5OnoqPsrXidoPa35GbwlEoFF5Pw9OR7QMZxsUeXzcnBh M/U8rWlS83abKvwMvG6aECrZXEZs5scXxAKkqvOyeo0=</Modulus> <Exponent>AQAB</Exponent> </RSAKeyValue> </KeyValue> </KeyInfo> <Object Id="object"> <list> <tr_id>9030601112003</tr_id> KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 35/70

<code>1</code> <description>a tranzakcio regisztralt.</description> <list_item> <TRANSACTION_ID>9030601111003</TRANSACTION_ID> <TRANSACTION_TYPE>5</TRANSACTION_TYPE> <USER_ID>1317</USER_ID> <USER_NAME>Opjancsi</USER_NAME> <STORE_TS>2006-01-11 11:44:35</STORE_TS> <UPDATE_TS>2006-01-11 11:44:35</UPDATE_TS> <REFERENCE_ID /> <PROVIDER_CODE_1>903</PROVIDER_CODE_1> <PROVIDER_NAME_1>BTteszt</PROVIDER_NAME_1> <PROVIDER_CODE_2>000</PROVIDER_CODE_2> <PROVIDER_NAME_2>NHH-V-teszt</PROVIDER_NAME_2> <PROVIDER_CODE_3 /> <PROVIDER_NAME_3 /> <EQUIPMENT_CODE>010</EQUIPMENT_CODE> <STARTRANGE>12200006</STARTRANGE> <STOPRANGE>12200006</STOPRANGE> <BILLING_CATEGORY>0</BILLING_CATEGORY> <VALID_FROM>2006-01-11 13:00:00</VALID_FROM> <REPLY>0</REPLY> <REPLY_MSG>Elfogadva</REPLY_MSG> <QUERY_TYPE>0</QUERY_TYPE> <QUERY_MSG /> <STATE>2</STATE> <STATE_MSG>Az atado elfogadta.</state_msg> <CARRY_ALL>1</CARRY_ALL> <CARRY_NEW>0</CARRY_NEW> <CARRY_AWAY>0</CARRY_AWAY> <CARRY_BACK>1</CARRY_BACK> </list_item> <list_item> <TRANSACTION_ID>0005244</TRANSACTION_ID> <TRANSACTION_TYPE>18</TRANSACTION_TYPE> <USER_ID>1317</USER_ID> <USER_NAME>Opjancsi</USER_NAME> <STORE_TS>2006-01-10 17:36:32</STORE_TS> <UPDATE_TS>2006-01-10 17:36:32</UPDATE_TS> <REFERENCE_ID>Marciszoft8</REFERENCE_ID> <PROVIDER_CODE_1>903</PROVIDER_CODE_1> <PROVIDER_NAME_1>BTteszt</PROVIDER_NAME_1> <PROVIDER_CODE_2>448</PROVIDER_CODE_2> <PROVIDER_NAME_2>Marciszoft8</PROVIDER_NAME_2> <PROVIDER_CODE_3 /> <PROVIDER_NAME_3 /> <EQUIPMENT_CODE /> <STARTRANGE>0</STARTRANGE> <STOPRANGE>0</STOPRANGE> <BILLING_CATEGORY>0</BILLING_CATEGORY> <VALID_FROM>2006-01-10 17:36:32</VALID_FROM> <REPLY>0</REPLY> <REPLY_MSG /> <QUERY_TYPE>0</QUERY_TYPE> <QUERY_MSG /> <STATE>1</STATE> <STATE_MSG>A tranzakcio regisztralt.</state_msg> <CARRY_ALL>0</CARRY_ALL> <CARRY_NEW>0</CARRY_NEW> <CARRY_AWAY>0</CARRY_AWAY> KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 36/70

<CARRY_BACK>0</CARRY_BACK> </list_item> </list> </Object> </Signature> </soap-env:body> </soap-env:envelope> A válaszként előálló listában az egyes mezők tartalma, jelentése az KRA üzenet típusától, azaz a TRANSACTION_TYPE mező értékétől függően más és más lehet. Az üzenet lista az alábbi KRA üzenet típusokat tartalmazhatja: fejezet TRANSAC- TION_TYPE KRA üzenet megnevezése 5.2.1 29 Hibás hordozás bejelentés 5.2.2 4 Hibás hordozás jóváhagyás válasz 5.2.3 5 Hordozás bejelentést a jóváhagyó elfogadta 5.2.4 6 Hordozás bejelentést a jóváhagyó elutasította 5.2.5 77 Hordozás bejelentés automatikus jóváhagyása 5.2.6 31 Hibás hordozás bejelentés törlés 5.2.7 32 Hordozás bejelentés törölve 5.2.8 54 Hibás berendezés kód módosítás 5.2.9 46 Berendezés kód módosítva 5.2.10 33 Hibás számhasználat megszüntetés 5.2.11 12 Számhasználati jog elvesztése 5.2.12 13 Számhasználati jog visszakerülése 5.2.13 85 Hibás számhasználat megszüntetés törlés 5.2.14 86 Számhasználat megszüntetés törölve 5.2.15 99 Hibás hely szerinti hordozás bejelentés 5.2.16 38 Hely szerinti hordozás regisztrálva 5.2.17 95 Hibás hely szerinti hordozás bejelentés törlés 5.2.18 41 Hely szerinti hordozás bejelentés törölve 5.2.19 39 Hibás hely szerinti hordozás megszüntetés 5.2.20 96 Hely szerinti hordozás megszüntetés regisztrálva 5.2.21 92 Hibás hely szerinti hordozás megszüntetés törlés 5.2.22 93 Hely szerinti hordozás megszüntetés bejelentés törölve 5.2.23 74 Hibás szám visszatartás bejelentés 5.2.24 76 Hibás szám visszatartás jóváhagyás válasz 5.2.25 73 Szám visszatartás bejelentést a jóváhagyó elfogadta 5.2.26 75 Szám visszatartás bejelentést a jóváhagyó elutasította 5.2.27 83 Szám visszatartás bejelentés automatikus jóváhagyása 5.2.28 81 Hibás szám visszatartás bejelentés törlés 5.2.29 82 Szám visszatartás bejelentés törölve 5.2.30 199 Hibás visszahordozás és hely szerinti hordozás bejelentés 5.2.31 174 Hibás visszahordozás és hely szerinti hordozás jóváhagyás válasz 5.2.32 175 Visszahordozás és hely szerinti hordozás bejelentést a jóváhagyó elfogadta 5.2.33 176 Visszahordozás és hely szerinti hordozás bejelentést a jóváhagyó KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 37/70

elutasította 5.2.34 177 Visszahordozás és hely szerinti hordozás bejelentés automatikus jóváhagyása 5.2.35 201 Hibás visszahordozás és hely szerinti hordozás bejelentés törlés 5.2.36 202 Visszahordozás és hely szerinti hordozás bejelentés törölve 5.2.37 26 Irányítási adatok letölthetők 5.2.38 28 Hibás irányítási adat letöltés kérés 5.2.39 19 Új szolgáltató regisztrálva 5.2.40 18 Szolgáltató törölve 5.2.41 79 Számmező átadás bejelentés értesítés 5.2.42 89 Számmező átadás módosítás értesítés 5.2.43 90 Számmező átadás törlés értesítés 5.2.1 Hibás hordozás bejelentés A tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 29 TR TYPES Szolgáltató kód, a jóváhagyó PROVIDER_CODE_2 string A szolgáltató neve PROVIDER_NAME_2 string Szolgáltató kód, az átvevő PROVIDER_CODE_3 string A szolgáltató neve PROVIDER_NAME_3 string Berendezés kód EQUIPMENT_CODE string Díjkategória BILLING_CATEGORY string Jelenleg használaton kívül. Az érvényesség kezdete VALID_FROM string, oracle Állapot (kód) STATE szám TR_STATES-szám 5.2.2 Hibás hordozás jóváhagyás válasz A bejelentési tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 4 TR_TYPES KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 38/70

Az érvényesség kezdete VALID_FROM string, oracle A megadott válasz (kód) REPLY szám REPLIES-szám A megadott válasz (szöveges magyarázat) REPLY_MSG string REPLIES-string Állapotkód (miért nem érvényesíthető) STATE szám TR_STATES-szám Állapot (a kód szöveges magyarázata) STATE_MSG string TR_STATES-string 5.2.3 Hordozás bejelentést a jóváhagyó elfogadta A tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 5 TR TYPES Szolgáltató kód, a jóváhagyó PROVIDER_CODE_2 string A szolgáltató neve PROVIDER_NAME_2 string Az érvényesség kezdete VALID_FROM string, oracle Válasz (kód) REPLY szám REPLIES-szám Válasz (szöveges magyarázat) REPLY_MSG string REPLIES-string Állapot (kód) STATE szám TR_STATES-szám Összes hordozás száma CARRY_ALL szám Új hordozások száma CARRY_NEW szám Továbbhordozások száma CARRY_AWAY szám Visszahordozások száma CARRY_BACK szám 5.2.4 Hordozás bejelentést a jóváhagyó elutasította A tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 6 TR TYPES Szolgáltató kód, a jóváhagyó PROVIDER_CODE_2 string A szolgáltató neve PROVIDER_NAME_2 string KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 39/70

Az érvényesség kezdete VALID_FROM string, oracle Válasz (kód) REPLY szám REPLIES-szám Válasz (szöveges magyarázat) REPLY_MSG string REPLIES-string Állapot (kód) STATE szám TR_STATES-szám 5.2.5 Hordozás bejelentés automatikus jóváhagyása A tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 77 TR TYPES Szolgáltató kód, számhordozás a PROVIDER_CODE_2 string kezdeményező A szolgáltató neve PROVIDER_NAME_2 string Az érvényesség kezdete VALID_FROM string, oracle Állapot (kód), amely jezi, hogy jóváhagyás STATE szám TR_STATES-szám vagy elutasítás történt-e 5.2.6 Hibás hordozás bejelentés törlés A törlési tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 31 TR TYPES A törölni kívánt tranzakció KRA REFERENCE_ID string azonosítója Szolgáltató kód, a jóváhagyó PROVIDER_CODE_2 string A szolgáltató neve PROVIDER_NAME_2 string Az érvényesség kezdete VALID_FROM string, oracle Válasz (kód) REPLY szám REPLIES-szám Válasz (szöveges magyarázat) REPLY_MSG string REPLIES-string KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 40/70

Állapotkód (miért nem szabályos) STATE szám TR_STATES-szám 5.2.7 Hordozás bejelentés törölve A törlési tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 32 TR TYPES A törölt tranzakció KRA azonosítója REFERENCE_ID string Szolgáltató kód, a bejelentés kezdeményezője PROVIDER_CODE_2 string A szolgáltató neve PROVIDER_NAME_2 string Szolgáltató kód, a bejelentés jóváhagyója PROVIDER_CODE_3 string A szolgáltató neve PROVIDER_NAME_3 string Az érvényesség kezdete VALID_FROM string, oracle Válasz (kód) REPLY szám REPLIES-szám Válasz (szöveges magyarázat) REPLY_MSG string REPLIES-string Állapot (kód) STATE szám TR_STATES-szám 5.2.8 Hibás berendezés kód módosítás A módosítási tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 54 TR TYPES A módosítandó tranzakció KRA REFERENCE_ID string azonosítója Szolgáltató kód, az átvevő, egyben a PROVIDER_CODE_2 string bejelentés kezdeményezője A szolgáltató neve PROVIDER_NAME_2 string Szolgáltató kód, az átadó PROVIDER_CODE_3 string KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 41/70

A szolgáltató neve PROVIDER_NAME_3 string Berendezés kód EQUIPMENT_CODE string Az érvényesség kezdete VALID_FROM string, oracle Állapot (kód) STATE szám TR_STATES-szám 5.2.9 Berendezés kód módosítva A módosítási tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 46 TR TYPES A módosított tranzakció KRA azonosítója REFERENCE_ID string Szolgáltató kód, az átvevő, egyben a PROVIDER_CODE_2 string bejelentés kezdeményezője A szolgáltató neve PROVIDER_NAME_2 string Szolgáltató kód, az átadó PROVIDER_CODE_3 string A szolgáltató neve PROVIDER_NAME_3 string Berendezés kód EQUIPMENT_CODE string Az érvényesség kezdete VALID_FROM string, oracle Válasz (kód) REPLY szám REPLIES-szám Válasz (szöveges magyarázat) REPLY_MSG string REPLIES-string Állapot (kód) STATE szám TR_STATES-szám 5.2.10 Hibás számhasználat megszüntetés A tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 33 TR TYPES A megszüntetés időpontja VALID_FROM string, oracle KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 42/70

Állapot (kód) STATE szám TR_STATES-szám 5.2.11 Számhasználati jog elvesztése A tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 12 TR TYPES Az utolsó bejelentési tranzakció KRA REFERENCE_ID string azonosítója A megszünés időpontja VALID_FROM string, oracle Állapot (kód) STATE szám TR_STATES-szám 5.2.12 Számhasználati jog visszakerülése A tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 13 TR TYPES Az utolsó bejelentési tranzakció KRA REFERENCE_ID string azonosítója A megszünés időpontja VALID_FROM string, oracle Állapot (kód) STATE szám TR_STATES-szám 5.2.13 Hibás számhasználat megszüntetés törlés A törlési tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 85 TR TYPES KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 43/70

A törölni kívánt tranzakció KRA REFERENCE_ID string azonosítója Az érvényesség kezdete VALID_FROM string, oracle Válasz (kód) REPLY szám REPLIES-szám Válasz (szöveges magyarázat) REPLY_MSG string REPLIES-string Állapotkód (miért nem szabályos) STATE szám TR_STATES-szám 5.2.14 Számhasználat megszüntetés törölve A törlési tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 86 TR TYPES A törölt tranzakció KRA azonosítója REFERENCE_ID string Az érvényesség kezdete VALID_FROM string, oracle Válasz (kód) REPLY szám REPLIES-szám Válasz (szöveges magyarázat) REPLY_MSG string REPLIES-string Állapot (kód) STATE szám TR_STATES-szám 5.2.15 Hibás hely szerinti hordozás bejelentés A tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 99 TR TYPES Berendezés kód EQUIPMENT_CODE string KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 44/70

Az érvényesség kezdete VALID_FROM string, oracle Állapot (kód) STATE szám TR_STATES-szám 5.2.16 Hely szerinti hordozás regisztrálva A bejelentési tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 38 TR TYPES A tárolás és az utolsó módosítás időpontja megegyezik A tárolás és az utolsó módosítás időpontja megegyezik Az érvényesség kezdete VALID_FROM string, oracle Berendezés kód EQUIPMENT_CODE string Állapot (kód) STATE szám TR_STATES-szám 5.2.17 Hibás hely szerinti hordozás bejelentés törlés A törlési tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 95 TR TYPES A törölni kívánt tranzakció KRA REFERENCE_ID string azonosítója Szolgáltató kód, a jóváhagyó PROVIDER_CODE_2 string A szolgáltató neve PROVIDER_NAME_2 string Az érvényesség kezdete VALID_FROM string, oracle Válasz (kód) REPLY szám REPLIES-szám Válasz (szöveges magyarázat) REPLY_MSG string REPLIES-string Állapotkód (miért nem szabályos) STATE szám TR_STATES-szám KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 45/70

5.2.18 Hely szerinti hordozás bejelentés törölve A törlési tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 41 TR TYPES A törölt tranzakció azonosítója REFERENCE_ID string Az érvényesség kezdete VALID_FROM string, oracle Válasz (kód) REPLY szám REPLIES-szám Válasz (szöveges magyarázat) REPLY_MSG string REPLIES-string Állapot (kód) STATE szám TR_STATES-szám 5.2.19 Hibás hely szerinti hordozás megszüntetés A törlési tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 39 TR TYPES Az érvényesség kezdete VALID_FROM string, oracle Berendezés kód EQUIPMENT_CODE string Állapot (kód) STATE szám TR_STATES-szám 5.2.20 Hely szerinti hordozás megszüntetés regisztrálva A bejelentési tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 96 TR TYPES A tárolás és az utolsó módosítás időpontja megegyezik KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 46/70

A tárolás és az utolsó módosítás időpontja megegyezik Az érvényesség kezdete VALID_FROM string, oracle Berendezés kód EQUIPMENT_CODE string Állapot (kód) STATE szám TR_STATES-szám 5.2.21 Hibás hely szerinti hordozás megszüntetés törlés A törlési tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 92 TR TYPES A törölni kívánt tranzakció KRA REFERENCE_ID string azonosítója Az érvényesség kezdete VALID_FROM string, oracle Válasz (kód) REPLY szám REPLIES-szám Válasz (szöveges magyarázat) REPLY_MSG string REPLIES-string Állapotkód (miért nem szabályos) STATE szám TR_STATES-szám 5.2.22 Hely szerinti hordozás megszüntetés bejelentés törölve A törlési tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 93 TR TYPES A törölt tranzakció KRA azonosítója REFERENCE_ID string Az érvényesség kezdete VALID_FROM string, oracle KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 47/70

Válasz (kód) REPLY szám REPLIES-szám Válasz (szöveges magyarázat) REPLY_MSG string REPLIES-string Állapot (kód) STATE szám TR_STATES-szám 5.2.23 Hibás szám visszatartás bejelentés A bejelentési tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 74 TR TYPES Szolgáltató kód, a jóváhagyó PROVIDER_CODE_2 string A szolgáltató neve PROVIDER_NAME_2 string Szolgáltató kód, az átvevő PROVIDER_CODE_3 string A szolgáltató neve PROVIDER_NAME_3 string Berendezés kód EQUIPMENT_CODE string Állapot (kód) STATE szám TR_STATES-szám 5.2.24 Hibás szám visszatartás jóváhagyás válasz A bejelentési tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 76 TR_TYPES A megadott válasz (kód) REPLY szám REPLIES-szám A megadott válasz (szöveges REPLY_MSG string REPLIES-string magyarázat) Állapotkód (miért nem érvényesíthető) STATE szám TR_STATES-szám Állapot (a kód szöveges magyarázata) STATE_MSG string TR_STATES-string 5.2.25 Szám visszatartás bejelentést a jóváhagyó elfogadta A bejelentési tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 48/70

Az üzenet típusa TRANSACTION_TYPE szám, 73 TR TYPES Szolgáltató kód, a jóváhagyó PROVIDER_CODE_2 string A szolgáltató neve PROVIDER_NAME_2 string Időablak kezdete VALID_FROM string, oracle Válasz (kód) REPLY szám REPLIES-szám Válasz (szöveges magyarázat) REPLY_MSG string REPLIES-string Állapot (kód) STATE szám TR_STATES-szám 5.2.26 Szám visszatartás bejelentést a jóváhagyó elutasította A bejelentési tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 75 TR TYPES Szolgáltató kód, a jóváhagyó PROVIDER_CODE_2 string A szolgáltató neve PROVIDER_NAME_2 string Válasz (kód) REPLY szám REPLIES-szám Válasz (szöveges magyarázat) REPLY_MSG string REPLIES-string Állapot (kód) STATE szám TR_STATES-szám 5.2.27 Szám visszatartás bejelentés automatikus jóváhagyása A tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 83 TR TYPES KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 49/70

Szolgáltató kód, a szám visszatartás PROVIDER_CODE_2 string kezdeményezője A szolgáltató neve PROVIDER_NAME_2 string Az érvényesség kezdete VALID_FROM string, oracle Állapot (kód), amely jezi, hogy jóváhagyás STATE szám TR_STATES-szám vagy elutasítás történt-e 5.2.28 Hibás szám visszatartás törlés A törlési tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 81 TR TYPES A törölni kívánt tranzakció KRA REFERENCE_ID string azonosítója Szolgáltató kód, a jóváhagyó PROVIDER_CODE_2 string A szolgáltató neve PROVIDER_NAME_2 string Az érvényesség kezdete VALID_FROM string, oracle Állapotkód (miért nem szabályos) STATE szám TR_STATES-szám 5.2.29 Szám visszatartás bejelentés törölve A törlési tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 82 TR TYPES A törölt tranzakció KRA azonosítója REFERENCE_ID string Szolgáltató kód, a bejelentés PROVIDER_CODE_2 string kezdeményezője A szolgáltató neve PROVIDER_NAME_2 string Szolgáltató kód, a bejelentés jóváhagyója PROVIDER_CODE_3 string A szolgáltató neve PROVIDER_NAME_3 string KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 50/70

Az érvényesség kezdete VALID_FROM string, oracle Válasz (kód) REPLY szám REPLIES-szám Válasz (szöveges magyarázat) REPLY_MSG string REPLIES-string Állapot (kód) STATE szám TR_STATES-szám 5.2.30 Hibás visszahordozás és hely szerinti hordozás bejelentés A tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 199 TR TYPES Szolgáltató kód, a jóváhagyó PROVIDER_CODE_2 string A szolgáltató neve PROVIDER_NAME_2 string Szolgáltató kód, az átvevő PROVIDER_CODE_3 string A szolgáltató neve PROVIDER_NAME_3 string Berendezés kód EQUIPMENT_CODE string Díjkategória BILLING_CATEGORY string Jelenleg használaton kívül. Az érvényesség kezdete VALID_FROM string, oracle Állapot (kód) STATE szám TR_STATES-szám 5.2.31 Hibás visszahordozás és hely szerinti hordozás jóváhagyás válasz A bejelentési tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 174 TR_TYPES Az érvényesség kezdete VALID_FROM string, oracle A megadott válasz (kód) REPLY szám REPLIES-szám A megadott válasz (szöveges magyarázat) REPLY_MSG string REPLIES-string KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 51/70

Állapotkód (miért nem érvényesíthető) STATE szám TR_STATES-szám Állapot (a kód szöveges magyarázata) STATE_MSG string TR_STATES-string 5.2.32 Visszahordozás és hely szerinti hordozás bejelentést a jóváhagyó elfogadta A tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 175 TR TYPES Szolgáltató kód, a jóváhagyó PROVIDER_CODE_2 string A szolgáltató neve PROVIDER_NAME_2 string Az érvényesség kezdete VALID_FROM string, oracle Válasz (kód) REPLY szám REPLIES-szám Válasz (szöveges magyarázat) REPLY_MSG string REPLIES-string Állapot (kód) STATE szám TR_STATES-szám Összes hordozás száma CARRY_ALL szám Új hordozások száma CARRY_NEW szám Továbbhordozások száma CARRY_AWAY szám Visszahordozások száma CARRY_BACK szám 5.2.33 Visszahordozás és hely szerinti hordozás bejelentést a jóváhagyó elutasította A tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 176 TR TYPES Szolgáltató kód, a jóváhagyó PROVIDER_CODE_2 string A szolgáltató neve PROVIDER_NAME_2 string Az érvényesség kezdete VALID_FROM string, oracle Válasz (kód) REPLY szám REPLIES-szám Válasz (szöveges magyarázat) REPLY_MSG string REPLIES-string Állapot (kód) STATE szám TR_STATES-szám KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 52/70

5.2.34 Visszahordozás és hely szerinti hordozás bejelentés automatikus jóváhagyása A tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 177 TR TYPES Szolgáltató kód, számhordozás a PROVIDER_CODE_2 string kezdeményező A szolgáltató neve PROVIDER_NAME_2 string Az érvényesség kezdete VALID_FROM string, oracle Állapot (kód), amely jezi, hogy jóváhagyás STATE szám TR_STATES-szám vagy elutasítás történt-e 5.2.35 Hibás visszahordozás és hely szerinti hordozás bejelentés törlés A törlési tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 201 TR TYPES A törölni kívánt tranzakció KRA REFERENCE_ID string azonosítója Szolgáltató kód, a jóváhagyó PROVIDER_CODE_2 string A szolgáltató neve PROVIDER_NAME_2 string Az érvényesség kezdete VALID_FROM string, oracle Válasz (kód) REPLY szám REPLIES-szám Válasz (szöveges magyarázat) REPLY_MSG string REPLIES-string Állapotkód (miért nem szabályos) STATE szám TR_STATES-szám KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 53/70

5.2.36 Visszahordozás és hely szerinti hordozás bejelentés törölve A törlési tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 202 TR TYPES A törölt tranzakció KRA azonosítója REFERENCE_ID string Szolgáltató kód, a bejelentés PROVIDER_CODE_2 string kezdeményezője A szolgáltató neve PROVIDER_NAME_2 string Szolgáltató kód, a bejelentés jóváhagyója PROVIDER_CODE_3 string A szolgáltató neve PROVIDER_NAME_3 string Az érvényesség kezdete VALID_FROM string, oracle Válasz (kód) REPLY szám REPLIES-szám Válasz (szöveges magyarázat) REPLY_MSG string REPLIES-string Állapot (kód) STATE szám TR_STATES-szám 5.2.37 Irányítási adat letölthető A tranzakció KRA azonosítója TRANSACTION_ID string Szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 26 TR TYPES A letölthető állomány URL-je REFERENCE_ID string A 8.1 fejezet alapján előálló tömörített irányítási listákra mutató URL-t tartalmazza Az delta időszak kezdete VALID_FROM string, oracle A lekérés típusa QUERY_TYPE szám QUERY TYPE Állapot (kód) STATE szám TR_STATES-szám 5.2.38 Hibás irányítási adat kérés A tranzakció KRA azonosítója TRANSACTION_ID string Az üzenet típusa TRANSACTION_TYPE szám, 28 TR TYPES KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 54/70

A tárolás időpontja UPDATE_TS string, oracle Az delta időszak kezdete, vagy a régebbi időablak kezdete VALID_FROM string, oracle A lekérés típusa QUERY_TYPE szám QUERY TYPE Állapot (kód) STATE szám TR_STATES-szám 5.2.39 Új szolgáltató regisztrálva A tranzakció KRA azonosítója TRANSACTION_ID string NHH-V szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 19 TR TYPES Az új szolgáltató neve REFERENCE_ID string A címzett szolgáltató neve PROVIDER_NAME_1 string Az új szolgáltató kódja PROVIDER_CODE_2 string Az érvényesség kezdete VALID_FROM string, oracle Állapot (kód) STATE szám TR_STATES-szám 5.2.40 Szolgáltató törölve A tranzakció KRA azonosítója TRANSACTION_ID string NHH-V szolgáltató kóddal Az üzenet típusa TRANSACTION_TYPE szám, 18 TR TYPES A törölt szolgáltató neve REFERENCE_ID string A címzett szolgáltató neve PROVIDER_NAME_1 string A törölt szolgáltató kódja PROVIDER_CODE_2 string Az érvényesség vége VALID_FROM string, oracle Állapot (kód) STATE szám TR_STATES-szám KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 55/70

5.2.41 Számmező átadás bejelentés értesítés A tranzakció KRA azonosítója TRANSACTION_ID string Az üzenet típusa TRANSACTION_TYPE szám, 79 TR TYPES A számmező átadás bejelentés tranzakció REFERENCE_ID string KRA azonosítója A számmezőt átvevő szolgáltató kódja PROVIDER_CODE_2 string A számmezőt átvevő szolgáltató neve PROVIDER_NAME_2 string A számmezőt átadó szolgáltató kódja PROVIDER_CODE_3 string A számmezőt átadó szolgáltató neve PROVIDER_NAME_3 string Az érvényesség kezdete VALID_FROM string, oracle Állapot (kód) STATE szám TR_STATES-szám 5.2.42 Számmező átadás módosítás értesítés A tranzakció KRA azonosítója TRANSACTION_ID string Az üzenet típusa TRANSACTION_TYPE szám, 89 TR TYPES A módosított tranzakció KRA azonosítója REFERENCE_ID string A számmezőt átvevő szolgáltató kódja PROVIDER_CODE_2 string A számmezőt átvevő szolgáltató neve PROVIDER_NAME_2 string A számmezőt átadó szolgáltató kódja PROVIDER_CODE_3 string A számmezőt átadó szolgáltató neve PROVIDER_NAME_3 string Az érvényesség kezdete, az új időpont VALID_FROM string, oracle Állapot (kód) STATE szám TR_STATES-szám 5.2.43 Számmező átadás törlés értesítés A tranzakció KRA azonosítója TRANSACTION_ID string KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 56/70

Az üzenet típusa TRANSACTION_TYPE szám, 90 TR TYPES A törölt tranzakció KRA azonosítója REFERENCE_ID string A számmezőt átvevő szolgáltató kódja PROVIDER_CODE_2 string A számmezőt átvevő szolgáltató neve PROVIDER_NAME_2 string z számmezőt átadó szolgáltató kódja PROVIDER_CODE_3 string A számmezőt átadó szolgáltató neve PROVIDER_NAME_3 string Az érvényesség kezdete VALID_FROM string, oracle Állapot (kód) STATE szám TR_STATES-szám KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 57/70

5.3 Időablakok lekérdezése Üzenet típus message_type szám, 10 Az aktuális időponttól a megadott dátumig kéri az időablakok listáját Until string, oracle Tranzakció azonosító tr_id string Szolgáltató kód nélkül User azonosítója user_dn string A KRA weboldalán a szolgáltatói adatok/ felhasználói adatok megtekintése menüpontban a címtári cím sorban található karakterlánc Válasz az üzenetre A válasz két részre bontható, az első a visszaigazolást tartalmazza: Hibakód code szám TR_STATES-szám Hibaüzenet description string TR_STATES-string A visszaigazolt KRA azonosító tr_id string Szolgáltató kóddal A második rész a <list_item> </list_item> közötti adatok: Időablak kezdete WINDOW_START string, oracle Időablak vége WINDOW_END string, oracle A válaszként előálló listára egy példa: <soap-env:envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"> <soap-env:header /> <soap-env:body> <Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> <SignedInfo> <CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315#WithComments" /> <SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1" /> <Reference URI="#object"> <DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" /> <DigestValue>ku6RwffhAJcih4VTWniHI4owrds=</DigestValue> </Reference> </SignedInfo> <SignatureValue>T8Rx/raiTAVXmZoX6qIR5ci4O4KjXWkMFxTaxnd7sBG+Ht0ppnA5inm9p/2hRPr4 DDHouNxSpgKxaEIXcgBCdzcnpmSi6JGwUWC39SPDm802XJpkT9lX18Da0mjUZ5oz UMwyYeSXtoTTUsyFLppxgSghqMEEP2LCgN0IrNlcCrg=</SignatureValue> <KeyInfo xmlns="http://www.w3.org/2000/09/xmldsig#"> <X509Data> <X509Certificate>MIIC/jCCAmegAwIBAgIQWLkA1buC/mRoAUURt0073DANBgkqhkiG9w0BAQUFADBE MQswCQYDVQQGEwJIVTEMMAoGA1UEChMDSElGMREwDwYDVQQLEwhLUkEtVEVTVDEU MBIGA1UEAxMLS1JBIFRlc3QgQ0EwHhcNMDUwMjA0MTA0NTMyWhcNMDcwMzMxMjAw MzMyWjCBjDELMAkGA1UEBhMCSFUxDDAKBgNVBAoTA05ISDERMA8GA1UECxMIS1JB LVRFU1QxJzAlBgNVBAMTHktSQSBUZXN0IFJlbmRzemVyIEFsYWlybyBLdWxjczEe KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 58/70

MBwGCSqGSIb3DQEJARYPa3JhLXVzemlAbmhoLmh1MRMwEQYKCZImiZPyLGQBARMD NDAzMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC2rUuM185KyoCQuqHRB9fe +QDb66YtDh0/FZSaEWmxbi5E6mkIUPpb30mzztFVyHpOozLa5A4itCd28dvjtIPk 6eio+yteJ2g9rfkZvCUSgUXk/D05HtAxnGxR5fNycGEz9TytaVLzdpsq/Ay8bpoQ KtlcRmzmxxfEAqSq87J6jQIDAQABo4GnMIGkMDQGA1UdHwQtMCswKaAnoCWGI2h0 dha6ly93d3cubmholmh1l2nybc9rcmf0zxn0y2euy3jsmbegcwcgsagg+eibaqqe AwIHgDAfBgNVHSMEGDAWgBQkzPDXxC/W3t51XBojdh3csv5U/jAJBgNVHRMEAjAA MA4GA1UdDwEB/wQEAwIHgDAdBgNVHQ4EFgQUsBlE7jr3Qp4dCBerNkBy+MGYe2Mw DQYJKoZIhvcNAQEFBQADgYEAr7VbsjLU3EIOZJYLa0lcm4JfCxBl+Ruo/eZLmivZ IkS78kfjv8fBLUjx7QaJvX15YQDwf9bj508OG3HwTu/gKdgxf5l+BsoLIyHt1rI4 JBpud2snPHI2ToBX5T5GnTAwEl7OX4ptCFdN0WeGu1mvXFqlB+nrLrebr8DVnpVlovM=</X509Certificate> </X509Data> <KeyValue> <RSAKeyValue> <Modulus>tq1LjNfOSsqAkLqh0QfX3vkA2+umLQ4dPxWUmhFpsW4uROppCFD6W99Js87RVch6 TqMy2uQOIrQndvHb47SD5OnoqPsrXidoPa35GbwlEoFF5Pw9OR7QMZxsUeXzcnBh M/U8rWlS83abKvwMvG6aECrZXEZs5scXxAKkqvOyeo0=</Modulus> <Exponent>AQAB</Exponent> </RSAKeyValue> </KeyValue> </KeyInfo> <Object Id="object"> <list> <tr_id>31256</tr_id> <code>1</code> <description>a tranzakcio regisztralt</description> <list_item> <WINDOW_START>2012-10-15 20:00:00</WINDOW_START> <WINDOW_END>2012-10-15 23:59:00</WINDOW_END> </list_item> <list_item> <WINDOW_START>2012-10-16 20:00:00</WINDOW_START> <WINDOW_END>2012-10-16 23:59:00</WINDOW_END> </list_item> <list_item> <WINDOW_START>2012-10-17 20:00:00</WINDOW_START> <WINDOW_END>2012-10-17 23:59:00</WINDOW_END> </list_item> <list_item> <WINDOW_START>2012-10-18 20:00:00</WINDOW_START> <WINDOW_END>2012-10-18 23:59:00</WINDOW_END> </list_item> <list_item> <WINDOW_START>2012-10-19 20:00:00</WINDOW_START> <WINDOW_END>2012-10-19 23:59:00</WINDOW_END> </list_item> </list> </Object> </Signature> </soap-env:body> </soap-env:envelope> KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 59/70

6 AZ IRÁNYÍTÁSI LISTÁK XML SZERKEZETÉNEK DEFINÍCIÓJA A KRA-rendszer az irányítási adatokat állományformában állítja elő, az alábbi struktúra szerint: <list> </list> <list_item> <phone_number>x*</phone_number> <equipment>x*</equipment> <valid_from>x*</valid_from> <valid_until>x*</valid_until> <actual_provider>x*</actual_provider> <previous_provider>x*</ previous_provider> <update_ts>x*</update_ts> </list_item> ahol x* = szám vagy string 6.1 Irányítási listák tömörítése és aláírása A KRA rendszer hálózati és hash-képzési teljesítmény megfontolásokból az irányítási listákat (teljes lista, a következő időablaktól érvényes hordozások listája, delta lista) tömörítve állítja elő. A tömörítési eljárás lényege, hogy a nagyméretű XML-lista ne XML-ként, hanem bináris adatfolyamként értelmezve essen át az aláírási (ill. ellenőrzési) procedúrán, betartva az XML-Signature szabvány kereteit. Mindez úgy valósul meg, hogy az XML-lista ZLIB (Rfc 1950) tömörítésen esik át, majd az így kapott bináris adattartalom base64-algoritmus révén (base64 encode) szövegesen reprezentálható formába kerül, amely egy formális XML-taggal ellátva már áteshet az eredeti aláíráson. Az alábbi lépések szemléltetik az irányítási listák állapotváltozásait. (A példa 2-jegyű szolgáltató kódokat és berendezés kódokat tartalmaz, de az eljárás 3-jegyű kódokra is érvényes.) 6.1.1 Eredeti XML állapot (XML-faként ábrázolva) KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 60/70

6.1.2 ZLIB állapot (hexadecimálisan ábrázolva) 6.1.3 BASE64 kódolt (base64 encoded) állapot (karakteresen ábrázolva) 6.1.4 Tömörített XML állapot (XML-faként ábrázolva) 6.1.5 Aláírt tömörített XML állapot (XML-faként ábrázolva) KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 61/70

6.2 Az irányítási listákkal a szolgáltatói oldalon elvégzendő lépések A KRA rendszertől fogadott irányítási listákon az alábbi műveleteket kell elvégezni a szolgáltatói oldalon, annak érdekében, hogy az eredeti, egyes számokra vonatkozó rekordokból álló listastruktúrát visszanyerjük: A szolgáltatói oldalon először az Elektronikus aláírást kell ellenőrizni. Ezt követi az irányítási lista base64 dekódolása (base64 decode), majd az így kapott bináris adat kitömörítése a fent hivatkozott ZLIB algoritmus szerint. KRA SOAP felhasználói kézikönyv v5.01 2018.02.09 62/70