1 KRA SOAP Interfész specifikáció 4.00 változat augusztus 1.2 Készítette: Nemzeti Média- Hírközlési Hatóság Azonosítógazdálkodási Osztály Nemzeti Médi...
KRA rendszer és teszt rendszer.........................................................................................................................5
Elektronikus aláírás ............................................................................................................................................8
3
XML KOMMUNIKÁCIÓS ÜZENETEK.............................................................................................. 10
Hely szerinti hordozás bejelentése...................................................................................................................19
4.8
Hely szerinti hordozás bejelentés törlése .........................................................................................................19
4.9
Hely szerinti hordozás megszüntetése.............................................................................................................20
4.10
Hely szerinti hordozás megszüntetés törlése ...................................................................................................20
4.11
Szám visszatartás bejelentése .........................................................................................................................21
4.12
Szám visszatartás bejelentés jóváhagyás válasz ............................................................................................21
4.13
Szám visszatartás bejelentés törlése ...............................................................................................................22
4.14
Visszahordozás és hely szerinti hordozás bejelentés ......................................................................................22
4.15
Visszahordozás és hely szerinti hordozás bejelentés jóváhagyás válasz .......................................................23
4.16
Visszahordozás és hely szerinti hordozás bejelentés törlése ..........................................................................23
4.17
Irányítási adatok kérése (Query) ......................................................................................................................24
Hordozás bejelentés jóváhagyás kérés................................................................................................28 Szám visszatartás jóváhagyás kérés ...................................................................................................28 Visszahordozás és hely szerinti hordozás bejelentés jóváhagyás kérés .............................................29
Hibás számhasználat megszüntetés ....................................................................................................38 Számhasználati jog elvesztése ............................................................................................................39 Számhasználati jog visszakerülése......................................................................................................39 Hibás számhasználat megszüntetés törlés ..........................................................................................39 Számhasználat megszüntetés törölve..................................................................................................40 Hibás hely szerinti hordozás bejelentés ...............................................................................................40 Hely szerinti hordozás regisztrálva.......................................................................................................41 Hibás hely szerinti hordozás bejelentés törlés .....................................................................................41 Hely szerinti hordozás bejelentés törölve .............................................................................................42 Hibás hely szerinti hordozás megszüntetés .........................................................................................42 Hely szerinti hordozás megszüntetés regisztrálva ...............................................................................43 Hibás hely szerinti hordozás megszüntetés törlés ...............................................................................43 Hely szerinti hordozás megszüntetés bejelentés törölve .....................................................................43 Hibás szám visszatartás bejelentés .....................................................................................................44 Hibás szám visszatartás jóváhagyás válasz ........................................................................................44 Szám visszatartás bejelentést a jóváhagyó elfogadta ..........................................................................45 Szám visszatartás bejelentést a jóváhagyó elutasította .......................................................................45 Szám visszatartás bejelentés automatikus jóváhagyása .....................................................................46 Hibás szám visszatartás törlés .............................................................................................................46 Szám visszatartás bejelentés törölve ...................................................................................................47 Hibás visszahordozás és hely szerinti hordozás bejelentés (ÚJ) .........................................................47 Hibás visszahordozás és hely szerinti hordozás jóváhagyás válasz ...................................................48 Visszahordozás és hely szerinti hordozás bejelentést a jóváhagyó elfogadta .....................................48 Visszahordozás és hely szerinti hordozás bejelentést a jóváhagyó elutasította ..................................49 Visszahordozás és hely szerinti hordozás bejelentés automatikus jóváhagyása ................................49 Hibás visszahordozás és hely szerinti hordozás bejelentés törlés .......................................................49 Visszahordozás és hely szerinti hordozás bejelentés törölve ..............................................................50 Irányítási adat letölthető .......................................................................................................................51 Hibás irányítási adat kérés ...................................................................................................................51 Új szolgáltató regisztrálva ....................................................................................................................51 Szolgáltató törölve ................................................................................................................................52 Számmező átadás bejelentés értesítés ...............................................................................................52 Számmező átadás módosítás értesítés ...............................................................................................53 Számmező átadás törlés értesítés .......................................................................................................53
Időablakok lekérdezése....................................................................................................................................54 AZ IRÁNYÍTÁSI LISTÁK XML SZERKEZETÉNEK DEFINÍCIÓJA ......................................................... 56
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
4/64
KRA – SOAP Interfész specifikáció v4.00
1
KRA 6. változat
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. Alapfeladata a hordozott számokkal kapcsolatos 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. Nem feladata a KRA-nak a számhordozás átadó és átvevő szolgáltató közötti eljárásainak támogatása, a KRA-ba a szolgáltatók között már egyeztetett hordozások jelenthetők be.
1.1
Jogszabályi háttér
A számhordozhatóság megvalósítására a telefonszolgáltatók és a Nemzeti Hírközlési Hatóság kötelezettségeit jogszabályok írják elő. A 2003. évi C. törvény (Eht.) 150. §-a előírja, hogy a földrajzi számoknak a szolgáltatók közötti hordozhatósága 2004. január 1-től kötelező, a nem-földrajzi számmal elérhető szolgáltatások (díjmentesen hívható SHS=80, kedvezményes díjazású SHS=40, emelt díjas, díjkorlátmentes SHS=90 és emelt díjas, díjkorlátos SHS=91 szolgáltatások) hívószámainak, valamint a mobil számoknak a szolgáltatók közötti hordozhatósága pedig az Európai Unióhoz való csatlakozástól, azaz 2004. május 1-től. A nomadikus beszédcélú szolgáltatás SHS=21 számainak hordozhatóságát 2008. január 1-jétől kell biztosítani. A 2012. szeptember 29-ig hatályos két rendeletet, azaz a számhordozhatóság szabályairól szóló 46/2004.(III. 18.) Korm. rendeletet és a számhordozási központi referencia adatbázisról szóló 55/2007 (V.31.) GKM rendeletet 2012. szeptember 30-án a számhordozás részletes szabályairól szóló 2/2012. (I. 24.) NMHH rendelet váltja fel. Az NMHH rendelet részletesen szabályozza a számhordozás feltételeit és eljárásait. Meghatározza azt is, hogy a hordozott számokra irányuló hívások és jelzések irányításáért melyik szolgáltató felelős. A rendelet szerint a Központi Referencia adatbázis (KRA) létrehozása és üzemeltetése a Nemzeti Média- és Hírközlési Hatóság feladata. A rendelettartalmazza a KRA működésének, így az adatbeviteli és letöltési eljárások, adatkezelés és hibakezelés részletes szabályait is, valamint előírja, hogy a KRA és a szolgáltatók közötti kommunikációs interfészre vonatkozó részletes műszaki leírásokat az NMHH a szolgáltatókkal történt egyeztetést követően a honlapján köteles közzétenni. A fenti rendeletek az NMHH honlapján elérhetőek (www.nmhh.hu > Azonosítógazdálkodás > Jogi háttér > Jogszabályok).
1.2
KRA rendszer és teszt rendszer
A jogszabályokban meghatározott KRA rendszeren kívül fejlesztési és tesztelési célokra egy teszt rendszer is a felhasználók rendelkezésére áll. A KRA rendszer és a teszt rendszer eléréséhez különböző tanúsítványok szükségesek, nem azonosak a szolgáltatók és felhasználók nevei sem a két rendszerben (a teszt rendszerben szolgáltató nevek végén „…-test” utótag á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. Az NMHH a KRA rendszerre előírt rendelkezésre állási értékeket a teszt rendszerre nem garantálja!
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
5/64
KRA – SOAP Interfész specifikáció v4.00
1.3
KRA 6. változat
KRA dokumentáció
A KRA műszaki specifikációját a szolgáltatók részére a következő dokumentumok együtt alkotják: KRA Általános ismertető KRA SOAP interfész specifikáció KRA WEB interfész specifikáció KRA Elektronikus aláírási szabályzat A dokumentumok az NMHH honlap KRA oldaláról, valamint a KRA rendszer és a teszt rendszer Súgó oldaláról letölthetők. Ebben 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. A 2. fejezet a kommunikáció általános szabályait Írja le. A 3. fejezet áttekinti a szolgáltatók által küldött XML üzeneteket, ezeket a 4. és 5. fejezet részletesen ismerteti. Az 5. fejezetben a KRA válaszokban lehetséges összes tranzakció típust is ismertetjük. A 6. fejezet az irányítási listák szerkezetét és a tömörített listák kibontásának módját tartalmazza. A 7. fejezet a függelék, amely a tranzakciók egyes paramétereinek szöveges értekeit tartalmazza.
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
6/64
KRA – SOAP Interfész specifikáció v4.00
KRA 6. változat
KOMMUNIKÁCIÓ SOAP INTERFÉSZEN
2
A KRA 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 az üzeneteket elektronikus aláírással kell ellátni. A felhasználók kétféle módon csatlakozhatnak KRA rendszerhez: –
a szolgáltatói webfelületen keresztül
–
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 KRA és teszt 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 letöltenie. Az on-line kommunikációt e-mail értesítés egészítheti ki, amelyet a KRA rendszer küld a letöltésre váró üzenetek érkezéséről.
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:
https://kra.nmhh.hu/MessageDispatcher/test
Teszt rendszer:
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) tetszőleges olyan eszköz, ami képes a platformfüggetlen SOAP üzenetek előállítására, azok elküldésére és fogadására illetve képes SSL 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: – –
2.2 Autentikáció A kommunikációs csatornát hálózati szinten az Internet, transzport szinten alkalmazásszinten pedig a kliensoldali SOAP-alkalmazás és a szerveroldali együttműködése adja HTTPS protokoll formájában. A HTTPS protokoll kliens- és X.509-tanúsítvány alapú autentikációval van kialakítva. A rendszer ehhez a mechanizmushoz társítja a szolgáltatói felhasználó által végezhető műveletek körét.
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
a TCP/IP, webszerver szerveroldali hozzáférési
7/64
KRA – SOAP Interfész specifikáció v4.00
KRA 6. változat
Az autentikáció kliensoldali feltétele, hogy a SOAP-kliens számára rendelkezésre álljon egy, az NMHH hitelesítésszolgáltató rendszere által kiállított KRA-felhasználói hozzáférési tanúsítvány PKCS12 formában.
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 szabályzatban 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):
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.
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
8/64
KRA – SOAP Interfész specifikáció v4.00
KRA 6. változat
A KRA az elektronikus aláírás előállításához az XSECT nevezetű API-t használja fel: http://jce.iaik.tugraz.at/products/052_XSECT/index.php. Az aláírt dokumentum szerkezetében az aláírt adattartalom ill. az aláírással kapcsolatos metaadatok <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> <SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1" /> ku6RwffhAJcih4VTWniHI4owrds=
KeyInfo Ez a struktúra az aláíráshoz szükséges felhasználói komponenseket tartalmazza: – 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.
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
9/64
KRA – SOAP Interfész specifikáció v4.00
KRA 6. változat
XML KOMMUNIKÁCIÓS ÜZENETEK
3
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 (Függelék) 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 leírás 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=NHH 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.
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
10/64
KRA – SOAP Interfész specifikáció v4.00
KRA 6. változat
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 (az új üzenetek piros színnel) üzenet megnevezése
fejezet
message_type
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 üzenet megnevezése
fejezet
message_type
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
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
11/64
KRA – SOAP Interfész specifikáció v4.00
4
KRA 6. változat
SZÁMHORDOZÁSI TRANZAKCIÓK
4.1 Hordozás bejelentés Üzenet típus Átvevő szolgáltató Átadó szolgáltató A kezdeményező szerepe (0 – átadó, 1 – átvevő)
message_type provider_1 provider_2 provider_3
szám, 1 string, a szolg. kódja string, a szolg. kódja string
A hordozott tartomány kezdete A hordozott tartomány vége A hordozás érvényességének kezdete
startr stopr validd
Tranzakció azonosító
tr_id
Felhasználóazonosító
user_dn
szám szám string, oracle dátum formában string, szolgáltató generálja string
A hordozott számok díjkategóriája Berendezés kód
tax equip
szám string,
Jelenleg használaton kívül. A jogszabályok szerint csak az átvevő szolgáltató kezdeményezheti a hordozás bejelentését
Szolgáltató kód nélkül 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 Jelenleg használaton kívül 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#"> <SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/> SR3QCsR+cJ+/sU/4rGg37mAbXwg= <SignatureValue> FnMV0DRcQqPyvcIOBFryhAMfxOBZsCIjjqguY8UWms3wFivKcA/ypjgZbgMe4QEH SNoFJkE1wDbOPz9v4JaEyuE1IDaq6b6ZeP/CuC4w22HCivMZh7Wrl2SflKkgndSj 6+oXkOyWrhod5jKzDaipkdM1aWlhSgpdQE9D4D+0GvY= <Modulus>uaAyH7zLziItjcgOKc+0SX/pFITIOHAN55BQ9oO30eN4qJLK0vqO0msZeCO14415 wqxWZPRiOx6AK+alG5yFi1hA3M5rdk7L9eG+vfx+FYs1iDeigjVscM8zl1iIw+e rzDjHYv6RW47Me0oeHEEsienfqIae3lzucqE9UoJfOU= <Exponent>AQAB Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
12/64
KRA – SOAP Interfész specifikáció v4.00
KRA 6. változat
<X509Data> <X509Certificate>MIIBoTCCAQoCAQEwDQYJKoZIhvcNAQEEBQAwGzEZMBcGA1 UEAxMQU2FmcmFueW9zIElzdHZhbjAeFw0wMzA2MjYxNjAwMzRaFw0xMzA2MjMxNj AwMzRaMBcxFTATBgNVBAMTDElwbGFuZXRVc2VyMTCBnzANBgkqhkiG9w0BAQEF AAOBjQAwgYkCgYEAuaAyH7zLziItjcgOKc+0SX/pFITIOHAN55BQ9oO30eN4qJLK0vqO 0msZeCO14415wwqxWZPRiOx6AK+alG5yFi1hA3M5rdk7L9eG+vfx+FYs1iDeigjVscM8zl 1iIw+erzDjHYv6RW47Me0oeHEEsienfqIae3lzucqE9UoJfOUCAwEAATANBgkqhkiG9w0B AQQFAAOBgQCP2OyUlzorE4B+UuuLmBUuyxbe8IcEDUJawG88hYMq9Liqc7kzdkpEXIx kJDYSjN9N1WGf9m+4g8GamUV3yI52Vmmrjha4P6UAOgoTXhb+ufrpGUojuYYf/GfpVZ1Q c8meKMWgaP2TjK0HlNPQzIDxTZ8uEq5i3H7Mmd4vjpxcCA== Válasz az üzenetre Hibakód Hibaüzenet A visszaigazolt KRA azonosító
4.2 Hordozás bejelentés jóváhagyás válasz Üzenet típus A jóváhagyó szolgáltató azonosítója A hordozott tartomány kezdete A hordozott tartomány vége A hordozás érvényességének kezdete A szolgáltató által generált számhordozás bejelentés tranzakció azonosító
Validálási célra szolgál Szolgáltató kóddal A jóváhagyandó bejelentés tranzakció azonosítója (nem új!) 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 REPLIES
Válasz az üzenetre Hibakód
code
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
szám
TR_STATES-szám 14/64
KRA – SOAP Interfész specifikáció v4.00
Hibaüzenet A visszaigazolt KRA azonosító
description tr_id
KRA 6. változat
string string
TR_STATES-string Szolgáltató kóddal
4.3 Hordozás bejelentés törlése Üzenet típus Átvevő szolgáltató
message_type provider_1
Átadó szolgáltató
provider_2
A hordozott tartomány kezdete A hordozott tartomány vége A hordozás érvényességének kezdete
startr stopr validd
Tranzakció azonosító
tr_id
Felhasználóazonosító
user_dn
szám, 2 string, a szolg. kódja string, a szolg. kódja szám szám string, oracle dátum formában string, szolgáltató generálja string
Törölni kívánt bejelentés tranzakció KRA azonosítója A törlés indokának kódja
reference_id
szám
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 Szolgáltató kóddal
reason
szám
DEL_REPLIES
Ellenőrzésre szolgál Szolgáltató kód nélkül
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#"> <SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/> SR3QCsR+cJ+/sU/4rGg37mAbXwg= <SignatureValue> FnMV0DRcQqPyvcIOBFryhAMfxOBZsCIjjqguY8UWms3wFivKcA/ypjgZbgMe4QEH SNoFJkE1wDbOPz9v4JaEyuE1IDaq6b6ZeP/CuC4w22HCivMZh7Wrl2SflKkgndSj 6+oXkOyWrhod5jKzDaipkdM1aWlhSgpdQE9D4D+0GvY= <Modulus>uaAyH7zLziItjcgOKc+0SX/pFITIOHAN55BQ9oO30eN4qJLK0vqO0msZeCO14415 wqxWZPRiOx6AK+alG5yFi1hA3M5rdk7L9eG+vfx+FYs1iDeigjVscM8zl1iIw+e rzDjHYv6RW47Me0oeHEEsienfqIae3lzucqE9UoJfOU= <Exponent>AQAB <X509Data> Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
15/64
KRA – SOAP Interfész specifikáció v4.00
KRA 6. változat
<X509Certificate>MIIBoTCCAQoCAQEwDQYJKoZIhvcNAQEEBQAwGzEZMBcGA1 UEAxMQU2FmcmFueW9zIElzdHZhbjAeFw0wMzA2MjYxNjAwMzRaFw0xMzA2MjMxNj AwMzRaMBcxFTATBgNVBAMTDElwbGFuZXRVc2VyMTCBnzANBgkqhkiG9w0BAQEF AAOBjQAwgYkCgYEAuaAyH7zLziItjcgOKc+0SX/pFITIOHAN55BQ9oO30eN4qJLK0vqO 0msZeCO14415wwqxWZPRiOx6AK+alG5yFi1hA3M5rdk7L9eG+vfx+FYs1iDeigjVscM8zl 1iIw+erzDjHYv6RW47Me0oeHEEsienfqIae3lzucqE9UoJfOUCAwEAATANBgkqhkiG9w0B AQQFAAOBgQCP2OyUlzorE4B+UuuLmBUuyxbe8IcEDUJawG88hYMq9Liqc7kzdkpEXIx kJDYSjN9N1WGf9m+4g8GamUV3yI52Vmmrjha4P6UAOgoTXhb+ufrpGUojuYYf/GfpVZ1Q c8meKMWgaP2TjK0HlNPQzIDxTZ8uEq5i3H7Mmd4vjpxcCA== Válasz az üzenetre Hibakód Hibaüzenet A visszaigazolt KRA azonosító
4.4 Berendezés kód módosítás bejelentése Üzenet típus Átvevő szolgáltató
message_type provider_1
Átadó szolgáltató
provider_2
A hordozott tartomány kezdete A hordozott tartomány vége Az új berendezés kód A hordozás érvényességének kezdete
startr stopr equip validd
Tranzakció azonosító
tr_id
Felhasználóazonosító
user_dn
szám, 45 string, a szolg. kódja string, a szolg. kódja szám szám string string, oracle dátum formában string, a szolg. generálja string
Módosítani kívánt bejelentés tranzakció KRA azonosítója
reference_id
string
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
Szolgáltató kód nélkül 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 Szolgáltató kóddal
17/64
KRA – SOAP Interfész specifikáció v4.00
KRA 6. változat
Válasz az üzenetre Hibakód Hibaüzenet A visszaigazolt KRA azonosító
4.7 Hely szerinti hordozás bejelentése Üzenet típus Bejelentő szolgáltató
message_type provider_1
A hordozott tartomány kezdete A hordozott tartomány vége A hely szerinti hordozás érvényességének kezdete Tranzakció azonosító
startr stopr validd
Felhasználóazonosító
user_dn
Berendezés kód
equip
tr_id
szám, 35 string, a szolg. kódja szám szám string, oracle dátum formában string, a szolg. generálja string
Szolgáltató kód nélkül 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
string, az új berendezés kód
Válasz az üzenetre Hibakód Hibaüzenet A visszaigazolt KRA azonosító
4.8 Hely szerinti hordozás bejelentés törlése Üzenet típus Bejelentő szolgáltató
message_type provider_1
A hordozott tartomány kezdete A hordozott tartomány vége A hely szerinti hordozás bejelentés érvényességi időpontja Tranzakció azonosító
startr stopr validd
Felhasználóazonosító
user_dn
A törlendő tranzakció KRA azonosítója Indok
reference_id reply
Berendezéskód
equip
tr_id
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
szám, 36 string, a szolg. kódja szám szám string, oracle dátum formában string, a szolg. generálja string
string szám, indok azonosítója string, a törlendő tranzakció berendezés kódja
Ellenőrzésre szolgál Szolgáltató kód nélkül 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 Szolgáltató kóddal REPLIES Ellenőrzésre szolgál
19/64
KRA – SOAP Interfész specifikáció v4.00
KRA 6. változat
Válasz az üzenetre Hibakód Hibaüzenet A visszaigazolt KRA azonosító
4.9 Hely szerinti hordozás megszüntetése Üzenet típus Bejelentő szolgáltató
message_type provider_1
Az érintett tartomány kezdete Az érintett tartomány vége Az irányítás megszűnésének kezdete
startr stopr validd
Tranzakció azonosító
tr_id
Felhasználóazonosító
user_dn
Berendezés kód
equip
szám, 39 string, a szolg. kódja szám szám string, oracle dátum formában string, a szolg. generálja string
Szolgáltató kód nélkül 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
string, a hordozott szám berendezés kódja
Válasz az üzenetre Hibakód Hibaüzenet A visszaigazolt KRA azonosító
Válasz az üzenetre Hibakód Hibaüzenet A visszaigazolt KRA azonosító
4.11 Szám visszatartás bejelentése Üzenet típus Kezdeményező szolgáltató
message_type provider_1
Jóváhagyó szolgáltató
provider_2
A visszatartott tartomány kezdete A visszatartott tartomány vége Tranzakció azonosító
startr stopr tr_id
Felhasználóazonosító
user_dn
szám, 70 string, a szolg. kódja string, a szolg. kódja szám szám string, a szolg. generálja string
Berendezés kód
equip
string
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
Szolgáltató kód nélkül 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 Megadott számtípusoknál alapértelmezett érték
Válasz az üzenetre Hibakód Hibaüzenet A visszaigazolt KRA azonosító
4.12 Szám visszatartás bejelentés jóváhagyás válasz Üzenet típus A jóváhagyó szolgáltató azonosítója A visszatartott tartomány kezdete A visszatartott tartomány vége A szám visszatartás bejelentés tranzakció azonosítója Felhasználóazonosító
message_type provider_id startr stopr tr_id
szám, 71 string szám szám string
user_dn
string
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
Szolgáltató kóddal 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ó 21/64
KRA – SOAP Interfész specifikáció v4.00
Az átadó válasza
reply
KRA 6. változat
karakterlánc REPLIES
szám
Válasz az üzenetre Hibakód Hibaüzenet A visszaigazolt KRA azonosító
Válasz az üzenetre Hibakód Hibaüzenet A visszaigazolt KRA azonosító
4.14 Visszahordozás és hely szerinti hordozás bejelentés Üzenet típus Átvevő szolgáltató Átadó szolgáltató A hordozott tartomány kezdete A hordozott tartomány vége A hordozás érvényességének kezdete
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
szám, 171 string, a szolg. kódja string, a szolg. kódja szám szám string, oracle dátum formában string, szolgáltató generálja string
Szolgáltató kód nélkül 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
22/64
KRA – SOAP Interfész specifikáció v4.00
Berendezés kód
equip
KRA 6. változat
string,
Megadott számtípusoknál alapértelmezett érték
Válasz az üzenetre Hibakód Hibaüzenet A visszaigazolt KRA azonosító
4.15 Visszahordozás és hely szerinti hordozás bejelentés jóváhagyás válasz Üzenet típus A jóváhagyó szolgáltató azonosítója A hordozott tartomány kezdete A hordozott tartomány vége A hordozás érvényességének kezdete A szolgáltató által generált számhordozás bejelentés tranzakció azonosító
Validálási célra szolgál Szolgáltató kóddal A jóváhagyandó bejelentés tranzakció azonosítója (nem új!) 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 REPLIES
Válasz az üzenetre Hibakód Hibaüzenet A visszaigazolt KRA azonosító
Válasz az üzenetre Hibakód Hibaüzenet A visszaigazolt KRA azonosító
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. Üzenet típus Az aktuális szolgáltató azonosítója A delta lekérdezés kezdetének időpontja
message_type prov_code from_ts
szám, 14 string string, oracle dátum formában
A szolgáltató által generált tranzakcióazonosító A lekérdezés típusa Felhasználóazonosító
tr_id
string
q_type user_dn
szám string
QUERY_TYPE 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
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ő Szolgáltató kód nélkül
Válasz az üzenetre Hibakód Hibaüzenet A visszaigazolt KRA azonosító
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
24/64
KRA – SOAP Interfész specifikáció v4.00
5
KRA 6. változat
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 Szolgáltató azonosítója Tranzakció azonosító User azonosítója
message_type prov_code tr_id user_dn
szám, 7 string string string
Szolgáltató kód nélkül 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 Hibaüzenet A visszaigazolt KRA azonosító
A második rész a “<list_item> ” közötti lehetséges adatok: A tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A felhasználó neve A tárolás dátuma
Szolgáltató kód, az üzenet címzettje A szolgáltató neve Szolgáltató kód A szolgáltató neve Szolgáltató kód A szolgáltató neve Berendezés kód A számtartomány kezdete A számtartomány vége Díjkategória Az érvényesség kezdete
Az üzenet állapota (kód) Állapot (szöveges magyarázat)
STATE STATE_MSG
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
string szám string string string, oracle dátum formában string, oracle dátum formában string string string string string string string szám szám string string, oracle dátum formában szám string
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: KRA üzenet megnevezése
fejezet
TRANSACTION_TYPE
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
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
27/64
KRA – SOAP Interfész specifikáció v4.00
5.1.1
KRA 6. változat
Hordozás bejelentés jóváhagyás kérés
A bejelentési tranzakció KRA azonosítója Az üzenet típusa A bejelentő felhasználó azonosítója A bejelentő felhasználó neve A tárolás dátuma
TRANSACTION_ID
string
Szolgáltató kóddal
TRANSACTION_TYPE USER_ID USER_NAME STORE_TS
TR_TYPES
Az utolsó módosítás dátuma
UPDATE_TS
A jóváhagyó szolgáltató azonosítója (az üzenet címzettje) A jóváhagyó szolgáltató neve A kezdeményező szolgáltató azonosítója A kezdeményező szolgáltató neve Az átvevő szolgáltató azonosítója Az átvevő szolgáltató neve Berendezés kód A hordozni kívánt tartomány kezdete A hordozni kívánt tartomány vége Díjkategória Az érvényesség kezdete
PROVIDER_CODE_1
szám, 2 string string string, oracle dátum formában string, oracle dátum formában string
Az üzenet állapota (kód) Az üzenet állapota (szöveg)
STATE STATE_MSG
string string string string szám szám szám string, oracle dátum formában szám string
5.1.2
Jelenleg használaton kívül.
TR_STATES-szám TR_STATES-string
Szám visszatartás jóváhagyás kérés
A szám visszatartás bejelentés tranzakció KRA azonosítója Az üzenet típusa A bejelentő felhasználó azonosítója A bejelentő felhasználó neve A tárolás dátuma
TRANSACTION_ID
string
Szolgáltató kóddal
TRANSACTION_TYPE USER_ID USER_NAME STORE_TS
TR_TYPES
Az utolsó módosítás dátuma
UPDATE_TS
A bejelentést jóváhagyó (egyben átvevő) szolgáltató azonosítója (az üzenet címzettje) A jóváhagyó szolgáltató neve A bejelentést kezdeményező (egyben átadó) szolgáltató azonosítója A kezdeményező szolgáltató neve A visszatartani kívánt tartomány kezdete A visszatartani kívánt tartomány vége
PROVIDER_CODE_1
szám, 72 string string string, oracle dátum formában string, oracle dátum formában string
PROVIDER_NAME_1 PROVIDER_CODE_2
string string
PROVIDER_NAME_2 STARTRANGE
string szám
STOPRANGE
szám
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
28/64
KRA – SOAP Interfész specifikáció v4.00
A visszatartás érvényességének kezdete Az üzenet állapota (kód) Az üzenet állapota (szöveg)
5.1.3
VALID_FROM STATE STATE_MSG
KRA 6. változat
string, oracle dátum formában szám string
TR_STATES-szám TR_STATES-string
Visszahordozás és hely szerinti hordozás bejelentés jóváhagyás kérés
A bejelentési tranzakció KRA azonosítója Az üzenet típusa A bejelentő felhasználó azonosítója A bejelentő felhasználó neve A tárolás dátuma
TRANSACTION_ID
string
Szolgáltató kóddal
TRANSACTION_TYPE USER_ID USER_NAME STORE_TS
TR_TYPES
Az utolsó módosítás dátuma
UPDATE_TS
A jóváhagyó szolgáltató azonosítója (az üzenet címzettje) A jóváhagyó szolgáltató neve A kezdeményező szolgáltató azonosítója A kezdeményező szolgáltató neve Az átvevő szolgáltató azonosítója Az átvevő szolgáltató neve Berendezés kód A hordozni kívánt tartomány kezdete A hordozni kívánt tartomány vége Az érvényesség kezdete
PROVIDER_CODE_1
szám, 172 string string string, oracle dátum formában string, oracle dátum formában string
Az üzenet állapota (kód) Az üzenet állapota (szöveg)
STATE STATE_MSG
string string string string szám szám string, oracle dátum formában szám string
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
TR_STATES-szám TR_STATES-string
29/64
KRA – SOAP Interfész specifikáció v4.00
KRA 6. változat
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 Szolgáltató azonosítója Tranzakció azonosító User azonosítója
message_type prov_code tr_id user_dn
szám, 9 string string string
Időintervallum kezdetének időpontja OPCIONÁLIS
start_date
string, oracle dátum formában
Szolgáltató kód nélkül 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 nyugtát tartalmazza: Hibakód Hibaüzenet A visszaigazolt KRA azonosító
string szám string string string, oracle dátum formában string string string string string string string string szám szám string string, oracle dátum formában szám string
Szolgáltató kóddal TR_TYPES
A második rész a “<list_item> ” közötti adatok: A tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A felhasználó neve Az utolsó módosítás időpontja
Hivatkozás Szolgáltató kód, az üzenet címzettje A szolgáltató neve Szolgáltató kód A szolgáltató neve Szolgáltató kód A szolgáltató neve Berendezés kód A számtartomány kezdete A számtartomány vége Díjkategória Az érvényesség kezdete
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
Jelenleg használaton kívül.
REPLIES-szám REPLIES-string
30/64
KRA – SOAP Interfész specifikáció v4.00
A letöltés típusa (kód) A letöltés típusa (szöveges) Állapot (kód) Állapot (szöveges magyarázat) Összes hordozás Új hordozás Továbbhordozás Visszahordozás
QUERY_TYPE QUERY_MSG STATE STATE_MSG CARRY_ALL CARRY_NEW CARRY_AWAY CARRY_BACK
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 (az új tranzakciók piros színnel):
KRA üzenet megnevezése Hibás hordozás bejelentés Hibás hordozás jóváhagyás válasz Hordozás bejelentést a jóváhagyó elfogadta Hordozás bejelentést a jóváhagyó elutasította Hordozás bejelentés automatikus jóváhagyása Hibás hordozás bejelentés törlés Hordozás bejelentés törölve Hibás berendezés kód módosítás Berendezés kód módosítva Hibás számhasználat megszüntetés Számhasználati jog elvesztése Számhasználati jog visszakerülése Hibás számhasználat megszüntetés törlés Számhasználat megszüntetés törölve Hibás hely szerinti hordozás bejelentés Hely szerinti hordozás regisztrálva Hibás hely szerinti hordozás bejelentés törlés Hely szerinti hordozás bejelentés törölve Hibás hely szerinti hordozás megszüntetés Hely szerinti hordozás megszüntetés regisztrálva Hibás hely szerinti hordozás megszüntetés törlés Hely szerinti hordozás megszüntetés bejelentés törölve Hibás szám visszatartás bejelentés Hibás szám visszatartás jóváhagyás válasz Szám visszatartás bejelentést a jóváhagyó elfogadta Szám visszatartás bejelentést a jóváhagyó elutasította Szám visszatartás bejelentés automatikus jóváhagyása Hibás szám visszatartás bejelentés törlés Szám visszatartás bejelentés törölve Hibás visszahordozás és hely szerinti hordozás bejelentés Hibás visszahordozás és hely szerinti hordozás jóváhagyás válasz Visszahordozás és hely szerinti hordozás bejelentést a jóváhagyó elfogadta Visszahordozás és hely szerinti hordozás bejelentést a jóváhagyó elutasította Visszahordozás és hely szerinti hordozás bejelentés automatikus jóváhagyása Hibás visszahordozás és hely szerinti hordozás bejelentés törlés Visszahordozás és hely szerinti hordozás bejelentés törölve Irányítási adatok letölthetők Hibás irányítási adat letöltés kérés
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
A tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
Szolgáltató kód, az üzenet címzettje A szolgáltató neve Szolgáltató kód, a jóváhagyó A szolgáltató neve Szolgáltató kód, az átvevő A szolgáltató neve Berendezés kód A számtartomány kezdete A számtartomány vége Díjkategória Az érvényesség kezdete
string szám, 29 string string, oracle dátum formában string, oracle dátum formában string string string string string string string szám szám string string, oracle dátum formában szám string
Szolgáltató kóddal TR TYPES
string szám, 4 string string, oracle dátum formában string, oracle dátum formában string string szám szám string, oracle dátum formában szám string
Szolgáltató kóddal TR_TYPES
Jelenleg használaton kívül.
TR_STATES-szám TR_STATES-string
Hibás hordozás jóváhagyás válasz
A bejelentési tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
Szolgáltató kód, az üzenet címzettje A szolgáltató neve A számtartomány kezdete A számtartomány vége Az érvényesség kezdete
A megadott válasz (kód) A megadott válasz (szöveges magyarázat)
REPLY REPLY_MSG
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
REPLIES-szám REPLIES-string
34/64
KRA – SOAP Interfész specifikáció v4.00
Állapotkód (miért nem érvényesíthető) Állapot (a kód szöveges magyarázata)
5.2.3
STATE STATE_MSG
szám string
TR_STATES-szám TR_STATES-string
string szám, 5 string string, oracle dátum formában string, oracle dátum formában string string string string szám szám string, oracle dátum formában szám string szám string szám szám szám szám
Szolgáltató kóddal TR TYPES
Hordozás bejelentést a jóváhagyó elfogadta
A tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
Szolgáltató kód, az üzenet címzettje A szolgáltató neve Szolgáltató kód, a jóváhagyó A szolgáltató neve A számtartomány kezdete A számtartomány vége Az érvényesség kezdete
Válasz (kód) Válasz (szöveges magyarázat) Állapot (kód) Állapot (szöveges magyarázat) Összes hordozás száma Új hordozások száma Továbbhordozások száma Visszahordozások száma
REPLY REPLY_MSG STATE STATE_MSG CARRY_ALL CARRY_NEW CARRY_AWAY CARRY_BACK
A tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
Szolgáltató kód, az üzenet címzettje A szolgáltató neve Szolgáltató kód, a jóváhagyó A szolgáltató neve A számtartomány kezdete A számtartomány vége Az érvényesség kezdete
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
string szám, 6 string string, oracle dátum formában string, oracle dátum formában string string string string szám szám string, oracle dátum formában szám
A tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
Szolgáltató kód, az üzenet címzettje A szolgáltató neve Szolgáltató kód, számhordozás a kezdeményező A szolgáltató neve A számtartomány kezdete A számtartomány vége Az érvényesség kezdete
PROVIDER_CODE_1 PROVIDER_NAME_1 PROVIDER_CODE_2
Állapot (kód), amely jezi, hogy jóváhagyás vagy elutasítás történt-e Állapot (szöveges magyarázat)
5.2.6
KRA 6. változat
PROVIDER_NAME_2 STARTRANGE STOPRANGE VALID_FROM
string szám, 77 string string, oracle dátum formában string, oracle dátum formában string string string
Szolgáltató kóddal TR TYPES
STATE
string szám szám string, oracle dátum formában szám
TR_STATES-szám
STATE_MSG
string
TR_STATES-string
string szám, 31 string string, oracle dátum formában string, oracle dátum formában string
Szolgáltató kóddal TR TYPES
Hibás hordozás bejelentés törlés
A törlési tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
A törölni kívánt tranzakció KRA azonosítója Szolgáltató kód, az üzenet címzettje A szolgáltató neve Szolgáltató kód, a jóváhagyó A szolgáltató neve A számtartomány kezdete A számtartomány vége Az érvényesség kezdete
REFERENCE_ID
Válasz (kód) Válasz (szöveges magyarázat) Állapotkód (miért nem szabályos)
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
string string string string szám szám string, oracle dátum formában szám string szám
REPLIES-szám REPLIES-string TR_STATES-szám 36/64
KRA – SOAP Interfész specifikáció v4.00
Állapot (szöveges magyarázat)
5.2.7
STATE_MSG
string
TR_STATES-string
string szám, 32 string string, oracle dátum formában string, oracle dátum formában string string string string
Szolgáltató kóddal TR TYPES
Hordozás bejelentés törölve
A törlési tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
A törölt tranzakció KRA azonosítója Szolgáltató kód, az üzenet címzettje A szolgáltató neve Szolgáltató kód, a bejelentés kezdeményezője A szolgáltató neve Szolgáltató kód, a bejelentés jóváhagyója A szolgáltató neve A számtartomány kezdete A számtartomány vége Az érvényesség kezdete
A módosítási tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
A módosítandó tranzakció KRA azonosítója Szolgáltató kód, az üzenet címzettje A szolgáltató neve Szolgáltató kód, az átvevő, egyben a bejelentés kezdeményezője A szolgáltató neve Szolgáltató kód, az átadó A szolgáltató neve Berendezés kód A számtartomány kezdete
REFERENCE_ID
string szám, 54 string string, oracle dátum formában string, oracle dátum formában string
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
Szolgáltató kóddal TR TYPES
37/64
KRA – SOAP Interfész specifikáció v4.00
A számtartomány vége Az érvényesség kezdete
STOPRANGE VALID_FROM
Állapot (kód) Állapot (szöveges magyarázat)
STATE STATE_MSG
5.2.9
KRA 6. változat
szám string, oracle dátum formában szám string
TR_STATES-szám TR_STATES-string
Berendezés kód módosítva
A módosítási tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
A módosított tranzakció KRA azonosítója Szolgáltató kód, az üzenet címzettje A szolgáltató neve Szolgáltató kód, az átvevő, egyben a bejelentés kezdeményezője A szolgáltató neve Szolgáltató kód, az átadó A szolgáltató neve Berendezés kód A számtartomány kezdete A számtartomány vége Az érvényesség kezdete
string szám, 46 string string, oracle dátum formában string, oracle dátum formában string string string string string string string string szám szám string, oracle dátum formában szám string szám string
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
string szám, 33 string string, oracle dátum formában string, oracle dátum formában string string szám szám string, oracle dátum formában
Szolgáltató kóddal TR TYPES
38/64
KRA – SOAP Interfész specifikáció v4.00
Állapot (kód) Állapot (szöveges magyarázat)
STATE STATE_MSG
KRA 6. változat
szám string
TR_STATES-szám TR_STATES-string
string szám, 12 string string, oracle dátum formában string, oracle dátum formában string
Szolgáltató kóddal TR TYPES
5.2.11 Számhasználati jog elvesztése A tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
Az utolsó bejelentési tranzakció KRA azonosítója Szolgáltató kód, az üzenet címzettje A szolgáltató neve A számtartomány kezdete A számtartomány vége A megszünés időpontja
string string szám szám string, oracle dátum formában szám string
TR_STATES-szám TR_STATES-string
5.2.12 Számhasználati jog visszakerülése A tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
Az utolsó bejelentési tranzakció KRA azonosítója Szolgáltató kód, az üzenet címzettje A szolgáltató neve A számtartomány kezdete A számtartomány vége A megszünés időpontja
string szám, 13 string string, oracle dátum formában string, oracle dátum formában string
Szolgáltató kóddal TR TYPES
string string szám szám string, oracle dátum formában szám string
TR_STATES-szám TR_STATES-string
string
Szolgáltató kóddal
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
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
39/64
KRA – SOAP Interfész specifikáció v4.00
Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
A törölni kívánt tranzakció KRA azonosítója Szolgáltató kód, az üzenet címzettje A szolgáltató neve A számtartomány kezdete A számtartomány vége Az érvényesség kezdete
szám, 85 string string, oracle dátum formában string, oracle dátum formában string string string szám szám string, oracle dátum formában szám string szám string
5.2.14 Számhasználat megszüntetés törölve A törlési tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
A törölt tranzakció KRA azonosítója Szolgáltató kód, az üzenet címzettje A szolgáltató neve A számtartomány kezdete A számtartomány vége Az érvényesség kezdete
string szám, 86 string string, oracle dátum formában string, oracle dátum formában string string string szám szám string, oracle dátum formában szám string szám string
Szolgáltató kóddal TR TYPES
string szám, 99 string string, oracle dátum formában string, oracle
Berendezés kód Állapot (kód) Állapot (szöveges magyarázat)
EQUIPMENT_CODE STATE STATE_MSG
string string szám szám string, oracle dátum formában string szám string
Szolgáltató kóddal 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
TR_STATES-szám TR_STATES-string
5.2.17 Hibás hely szerinti hordozás bejelentés törlés A törlési tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
A törölni kívánt tranzakció KRA azonosítója Szolgáltató kód, az üzenet címzettje A szolgáltató neve Szolgáltató kód, a jóváhagyó A szolgáltató neve A számtartomány kezdete
REFERENCE_ID
string szám, 95 string string, oracle dátum formában string, oracle dátum formában string
5.2.18 Hely szerinti hordozás bejelentés törölve A törlési tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
A törölt tranzakció azonosítója Szolgáltató kód, az üzenet címzettje A szolgáltató neve A számtartomány kezdete A számtartomány vége Az érvényesség kezdete
string szám, 41 string string, oracle dátum formában string, oracle dátum formában string string string szám szám string, oracle dátum formában szám string szám string
Szolgáltató kóddal TR TYPES
string szám, 39 string string, oracle dátum formában string, oracle dátum formában string string szám szám string, oracle dátum formában string szám string
Berendezés kód Állapot (kód) Állapot (szöveges magyarázat)
EQUIPMENT_CODE STATE STATE_MSG
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
TR_STATES-szám TR_STATES-string
42/64
KRA – SOAP Interfész specifikáció v4.00
KRA 6. változat
5.2.20 Hely szerinti hordozás megszüntetés regisztrálva A bejelentési tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
string szám, 96 string string, oracle dátum formában
Az utolsó módosítás időpontja
UPDATE_TS
string, oracle dátum formában
Szolgáltató kód, az üzenet címzettje A szolgáltató neve A számtartomány kezdete A számtartomány vége Az érvényesség kezdete
Berendezés kód Állapot (kód) Állapot (szöveges magyarázat)
EQUIPMENT_CODE STATE STATE_MSG
string string szám szám string, oracle dátum formában string szám string
Szolgáltató kóddal 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
TR_STATES-szám TR_STATES-string
5.2.21 Hibás hely szerinti hordozás megszüntetés törlés A törlési tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
A törölni kívánt tranzakció KRA azonosítója Szolgáltató kód, az üzenet címzettje A szolgáltató neve A számtartomány kezdete A számtartomány vége Az érvényesség kezdete
string szám, 92 string string, oracle dátum formában string, oracle dátum formában string string string szám szám string, oracle dátum formában szám string szám string
5.2.22 Hely szerinti hordozás megszüntetés bejelentés törölve A törlési tranzakció KRA azonosítója Az üzenet típusa
TRANSACTION_ID TRANSACTION_TYPE
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
string szám, 93
Szolgáltató kóddal TR TYPES
43/64
KRA – SOAP Interfész specifikáció v4.00
A felhasználó azonosítója A tárolás időpontja
USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
A törölt tranzakció KRA azonosítója Szolgáltató kód, az üzenet címzettje A szolgáltató neve A számtartomány kezdete A számtartomány vége Az érvényesség kezdete
string string, oracle dátum formában string, oracle dátum formában string string string szám szám string, oracle dátum formában szám string szám string
5.2.23 Hibás szám visszatartás bejelentés A bejelentési tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
Szolgáltató kód, az üzenet címzettje A szolgáltató neve Szolgáltató kód, a jóváhagyó A szolgáltató neve Szolgáltató kód, az átvevő A szolgáltató neve Berendezés kód A számtartomány kezdete A számtartomány vége Állapot (kód) Állapot (szöveges magyarázat)
string szám, 74 string string, oracle dátum formában string, oracle dátum formában string string string string string string string szám szám szám string
Szolgáltató kóddal TR TYPES
string szám, 76 string string, oracle dátum formában string, oracle dátum formában string
Szolgáltató kóddal TR_TYPES
TR_STATES-szám TR_STATES-string
5.2.24 Hibás szám visszatartás jóváhagyás válasz A bejelentési tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
Szolgáltató kód, az üzenet címzettje
PROVIDER_CODE_1
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
44/64
KRA – SOAP Interfész specifikáció v4.00
A szolgáltató neve A számtartomány kezdete A számtartomány vége A megadott válasz (kód) A megadott válasz (szöveges magyarázat) Állapotkód (miért nem érvényesíthető) Állapot (a kód szöveges magyarázata)
5.2.25 Szám visszatartás bejelentést a jóváhagyó elfogadta A bejelentési tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
Szolgáltató kód, az üzenet címzettje A szolgáltató neve Szolgáltató kód, a jóváhagyó A szolgáltató neve A számtartomány kezdete A számtartomány vége Időablak kezdete
string szám, 73 string string, oracle dátum formában string, oracle dátum formában string string string string szám szám string, oracle dátum formában szám string szám string
5.2.26 Szám visszatartás bejelentést a jóváhagyó elutasította A bejelentési tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
Szolgáltató kód, az üzenet címzettje A szolgáltató neve Szolgáltató kód, a jóváhagyó A szolgáltató neve A számtartomány kezdete A számtartomány vége Válasz (kód)
5.2.27 Szám visszatartás bejelentés automatikus jóváhagyása A tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
Szolgáltató kód, az üzenet címzettje A szolgáltató neve Szolgáltató kód, a szám visszatartás kezdeményezője A szolgáltató neve A számtartomány kezdete A számtartomány vége Az érvényesség kezdete
PROVIDER_CODE_1 PROVIDER_NAME_1 PROVIDER_CODE_2
Állapot (kód), amely jezi, hogy jóváhagyás vagy elutasítás történt-e Állapot (szöveges magyarázat)
PROVIDER_NAME_2 STARTRANGE STOPRANGE VALID_FROM
string szám, 83 string string, oracle dátum formában string, oracle dátum formában string string string
Szolgáltató kóddal TR TYPES
STATE
string szám szám string, oracle dátum formában szám
TR_STATES-szám
STATE_MSG
string
TR_STATES-string
string szám, 81 string string, oracle dátum formában string, oracle dátum formában string
Szolgáltató kóddal TR TYPES
5.2.28 Hibás szám visszatartás törlés A törlési tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
A törölni kívánt tranzakció KRA azonosítója Szolgáltató kód, az üzenet címzettje A szolgáltató neve Szolgáltató kód, a jóváhagyó A szolgáltató neve A számtartomány kezdete A számtartomány vége Az érvényesség kezdete
REFERENCE_ID
Állapotkód (miért nem szabályos) Állapot (szöveges magyarázat)
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
string string string string szám szám string, oracle dátum formában szám string
TR_STATES-szám TR_STATES-string
46/64
KRA – SOAP Interfész specifikáció v4.00
KRA 6. változat
5.2.29 Szám visszatartás bejelentés törölve A törlési tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
A törölt tranzakció KRA azonosítója Szolgáltató kód, az üzenet címzettje A szolgáltató neve Szolgáltató kód, a bejelentés kezdeményezője A szolgáltató neve Szolgáltató kód, a bejelentés jóváhagyója A szolgáltató neve A számtartomány kezdete A számtartomány vége Az érvényesség kezdete
string szám, 82 string string, oracle dátum formában string, oracle dátum formában string string string string string string string szám szám string, oracle dátum formában szám string szám string
5.2.30 Hibás visszahordozás és hely szerinti hordozás bejelentés (ÚJ) A tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
Szolgáltató kód, az üzenet címzettje A szolgáltató neve Szolgáltató kód, a jóváhagyó A szolgáltató neve Szolgáltató kód, az átvevő A szolgáltató neve Berendezés kód A számtartomány kezdete A számtartomány vége Díjkategória Az érvényesség kezdete
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
string szám, 199 string string, oracle dátum formában string, oracle dátum formában string string string string string string string szám szám string string, oracle dátum formában szám
Szolgáltató kóddal TR TYPES
Jelenleg használaton kívül.
TR_STATES-szám
47/64
KRA – SOAP Interfész specifikáció v4.00
Állapot (szöveges magyarázat)
STATE_MSG
KRA 6. változat
string
TR_STATES-string
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 Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
Szolgáltató kód, az üzenet címzettje A szolgáltató neve A számtartomány kezdete A számtartomány vége Az érvényesség kezdete
A megadott válasz (kód) A megadott válasz (szöveges magyarázat) Állapotkód (miért nem érvényesíthető) Állapot (a kód szöveges magyarázata)
REPLY REPLY_MSG STATE STATE_MSG
string szám, 174 string string, oracle dátum formában string, oracle dátum formában string string szám szám string, oracle dátum formában szám string szám string
5.2.32 Visszahordozás és hely szerinti hordozás bejelentést a jóváhagyó elfogadta A tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
Szolgáltató kód, az üzenet címzettje A szolgáltató neve Szolgáltató kód, a jóváhagyó A szolgáltató neve A számtartomány kezdete A számtartomány vége Az érvényesség kezdete
Válasz (kód) Válasz (szöveges magyarázat) Állapot (kód) Állapot (szöveges magyarázat) Összes hordozás száma Új hordozások száma Továbbhordozások száma Visszahordozások száma
REPLY REPLY_MSG STATE STATE_MSG CARRY_ALL CARRY_NEW CARRY_AWAY CARRY_BACK
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
string szám, 175 string string, oracle dátum formában string, oracle dátum formában string string string string szám szám string, oracle dátum formában szám string szám string szám szám szám 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 Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
Szolgáltató kód, az üzenet címzettje A szolgáltató neve Szolgáltató kód, a jóváhagyó A szolgáltató neve A számtartomány kezdete A számtartomány vége Az érvényesség kezdete
string szám, 176 string string, oracle dátum formában string, oracle dátum formában string string string string szám szám string, oracle dátum formában szám string szám string
5.2.34 Visszahordozás és hely szerinti hordozás bejelentés automatikus jóváhagyása A tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
Szolgáltató kód, az üzenet címzettje A szolgáltató neve Szolgáltató kód, számhordozás a kezdeményező A szolgáltató neve A számtartomány kezdete A számtartomány vége Az érvényesség kezdete
PROVIDER_CODE_1 PROVIDER_NAME_1 PROVIDER_CODE_2
Állapot (kód), amely jezi, hogy jóváhagyás vagy elutasítás történt-e Állapot (szöveges magyarázat)
PROVIDER_NAME_2 STARTRANGE STOPRANGE VALID_FROM
string szám, 177 string string, oracle dátum formában string, oracle dátum formában string string string
Szolgáltató kóddal TR TYPES
STATE
string szám szám string, oracle dátum formában szám
TR_STATES-szám
STATE_MSG
string
TR_STATES-string
5.2.35 Hibás visszahordozás és hely szerinti hordozás bejelentés törlés
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
49/64
KRA – SOAP Interfész specifikáció v4.00
A törlési tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
A törölni kívánt tranzakció KRA azonosítója Szolgáltató kód, az üzenet címzettje A szolgáltató neve Szolgáltató kód, a jóváhagyó A szolgáltató neve A számtartomány kezdete A számtartomány vége Az érvényesség kezdete
string szám, 201 string string, oracle dátum formában string, oracle dátum formában string string string string string szám szám string, oracle dátum formában szám string szám string
5.2.36 Visszahordozás és hely szerinti hordozás bejelentés törölve A törlési tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
A törölt tranzakció KRA azonosítója Szolgáltató kód, az üzenet címzettje A szolgáltató neve Szolgáltató kód, a bejelentés kezdeményezője A szolgáltató neve Szolgáltató kód, a bejelentés jóváhagyója A szolgáltató neve A számtartomány kezdete A számtartomány vége Az érvényesség kezdete
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
string szám, 202 string string, oracle dátum formában string, oracle dátum formában string string string string string string string szám szám string, oracle dátum formában szám string szám string
5.2.37 Irányítási adat letölthető A tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
A letölthető állomány URL-je
REFERENCE_ID
Szolgáltató kód, az üzenet címzettje A szolgáltató neve Az delta időszak kezdete
PROVIDER_CODE_1 PROVIDER_NAME_1 VALID_FROM
A lekérés típusa Állapot (kód) Állapot (szöveges magyarázat)
QUERY_TYPE STATE STATE_MSG
string szám, 26 string string, oracle dátum formában string, oracle dátum formában string
string string string, oracle dátum formában szám szám string
Szolgáltató kóddal TR TYPES
A 8.1 fejezet alapján előálló tömörített irányítási listákra mutató URL-t tartalmazza
QUERY TYPE TR_STATES-szám TR_STATES-string
5.2.38 Hibás irányítási adat kérés A tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
A tárolás időpontja
UPDATE_TS
Szolgáltató kód, az üzenet címzettje A szolgáltató neve Az delta időszak kezdete, vagy a régebbi időablak kezdete A lekérés típusa Állapot (kód) Állapot (szöveges magyarázat)
PROVIDER_CODE_1 PROVIDER_NAME_1 VALID_FROM QUERY_TYPE STATE STATE_MSG
string szám, 28 string string, oracle dátum formában string, oracle dátum formában string string string, oracle dátum formában szám szám string
TR TYPES
QUERY TYPE TR_STATES-szám TR_STATES-string
5.2.39 Új szolgáltató regisztrálva A tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
Az új szolgáltató neve Szolgáltató kód, az üzenet címzettje
REFERENCE_ID PROVIDER_CODE_1
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
string szám, 19 string string, oracle dátum formában string, oracle dátum formában string string
NHH-V szolgáltató kóddal TR TYPES
51/64
KRA – SOAP Interfész specifikáció v4.00
A címzett szolgáltató neve Az új szolgáltató kódja Az érvényesség kezdete
PROVIDER_NAME_1 PROVIDER_CODE_2 VALID_FROM
Állapot (kód) Állapot (szöveges magyarázat)
STATE STATE_MSG
KRA 6. változat
string string string, oracle dátum formában szám string
TR_STATES-szám TR_STATES-string
5.2.40 Szolgáltató törölve A tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
A törölt szolgáltató neve Szolgáltató kód, az üzenet címzettje A címzett szolgáltató neve A törölt szolgáltató kódja Az érvényesség vége
string szám, 18 string string, oracle dátum formában string, oracle dátum formában string string string string string, oracle dátum formában szám string
NHH-V szolgáltató kóddal TR TYPES
TR_STATES-szám TR_STATES-string
5.2.41 Számmező átadás bejelentés értesítés A tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
A számmező átadás bejelentés tranzakció KRA azonosítója Szolgáltató kód, az üzenet címzettje A szolgáltató neve A számmezőt átvevő szolgáltató kódja A számmezőt átvevő szolgáltató neve A számmezőt átadó szolgáltató kódja A számmezőt átadó szolgáltató neve A számtartomány kezdete A számtartomány vége Az érvényesség kezdete
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
string szám, 79 string string, oracle dátum formában string, oracle dátum formában string string string string string string string szám szám string, oracle dátum formában szám string
TR TYPES
TR_STATES-szám TR_STATES-string 52/64
KRA – SOAP Interfész specifikáció v4.00
KRA 6. változat
5.2.42 Számmező átadás módosítás értesítés A tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
A módosított tranzakció KRA azonosítója Szolgáltató kód, az üzenet címzettje A szolgáltató neve A számmezőt átvevő szolgáltató kódja A számmezőt átvevő szolgáltató neve A számmezőt átadó szolgáltató kódja A számmezőt átadó szolgáltató neve A számtartomány kezdete A számtartomány vége Az érvényesség kezdete, az új időpont
string szám, 89 string string, oracle dátum formában string, oracle dátum formában string string string string string string string szám szám string, oracle dátum formában szám string
TR TYPES
TR_STATES-szám TR_STATES-string
5.2.43 Számmező átadás törlés értesítés A tranzakció KRA azonosítója Az üzenet típusa A felhasználó azonosítója A tárolás időpontja
TRANSACTION_ID TRANSACTION_TYPE USER_ID STORE_TS
Az utolsó módosítás időpontja
UPDATE_TS
A törölt tranzakció KRA azonosítója Szolgáltató kód, az üzenet címzettje A szolgáltató neve A számmezőt átvevő szolgáltató kódja A számmezőt átvevő szolgáltató neve z számmezőt átadó szolgáltató kódja A számmezőt átadó szolgáltató neve A számtartomány kezdete A számtartomány vége Az érvényesség kezdete
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
string szám, 90 string string, oracle dátum formában string, oracle dátum formában string string string string string string string szám szám string, oracle dátum formában szám string
TR TYPES
TR_STATES-szám TR_STATES-string
53/64
KRA – SOAP Interfész specifikáció v4.00
KRA 6. változat
5.3 Időablakok lekérdezése Üzenet típus Az aktuális időponttól a megadott dátumig kéri az időablakok listáját Tranzakció azonosító User azonosítója
message_type Until tr_id user_dn
szám, 10 string, oracle dátum formában string string
Szolgáltató kód nélkül 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 Hibaüzenet A visszaigazolt KRA azonosító
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 XMLSignature 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)
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
57/64
KRA – SOAP Interfész specifikáció v4.00
6.1.5
KRA 6. változat
Aláírt tömörített XML állapot (XML-faként ábrázolva)
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.
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
Szöveges érték, Magyarázat Hordozás bejelentés Hordozás bejelentés törlése Számhasználat megszüntetése Hordozás bejelentés jóváhagyás válasz KRA üzeneteinek lekérdezése (Other Messages) Jóváhagyás kérés üzenetek lekérdezése (Validation Messages) Időablakok lekérdezése Irányítási adatok letöltése Hely szerinti hordozás bejelentése Hely szerinti hordozás bejelentés törlése Hely szerinti hordozás megszüntetése Berendezés kód módosítása Szám visszatartás bejelentés Szám visszatartás bejelentés jóváhagyás válasz Szám visszatartás bejelentés törlése Számhasználat megszüntetés törlése Hely szerinti hordozás megszüntetés törlése Visszahordozás és hely szerinti hordozás bejelentés Visszahordozás és hely szerinti hordozás bejelentés jóváhagyás válasz Visszahordozás és hely szerinti hordozás bejelentés törlése
Törölve, hibás kitöltés miatt Törölve, ügyfél visszalépése miatt Törölve, egyéb indok miatt Teljes Delta Időablakos Elfogadva Elutasítva, díjhátralék miatt Elutasítva, egyéb okokból Elutasitva, hibás kitöltes miatt Elutasitva, egyeztetés hiánya miatt
A tranzakció regisztrált A bejelentést a jóváhagyó elfogadta Nem érkezett válasz, automatikusan elfogadva A bejelentést a jóváhagyó elutasította A bejelentést a kezdeményező törölte A bejelentést a jóváhagyó elfogadta
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
A bejelentést a jóváhagyó elutasította A tranzakció feldolgozva Már létezik ilyen azonosítójú tranzakció A megadott szolgáltatók azonosak Az átvevő szolgáltató nem regisztrált Az átadó szolgáltató nem regisztrált A hivatkozott tranzakció azonosító nem létezik A szolgáltató nem jogosult a jóváhagyásra A tartomány nem egyezik az eredetivel Az időpont nem egyezik az eredetivel Hiányzik az elutasítás indoklása A jóváhagyó válasza nem megfelelő (nem 0 vagy 1) A megadott tartományban más szolgáltatóhoz tartozó szám is szerepel Az eredeti tranzakció állapota nem regisztrált A megadott tartomány kezdete nagyobb, mint a vége Az átadó szolgáltató nem azonos az eredetivel Az átvevő szolgáltató nem azonos az eredetivel A kérés határidőn túl érkezett Az eredeti tranzakció nem regisztrált vagy elfogadott állapotú A megadott telefonszámhoz nincs érvényes hordozás A megadott telefonszám más szolgáltatóhoz regisztrált A dátumnak 30 napnál nem régebbi múltbelinek kell lennie A megadott szolgáltató azonosító már foglalt A szolgáltatónak még van aktuális szolgáltatása Nincs megadva a Delta lekérdezéshez dátum A megadott tartománynak több számmező szolgáltatója is van Az átadó szolgáltató nem azonos a jelenlegi számmező szolgáltatóval Az átadó szolgáltató nem azonos sem a kezdeményezővel, sem a jóváhagyóval A megadott szolgáltató nincs regisztrálva a rendszerben Jövőbeli időpontot kell megadni A tartományban van olyan szám amire már kértek hordozást A tartományban van olyan szám ami más díjkategóriába tartozik A felhasználó nincs regisztrálva a rendszerben A megadott dátum nem egy érvényes időablak kezdetére esik Nincs ilyen kódú szolgáltató Nincs ilyen azonosítójú felhasználó Csak teljes lekérdezés kérhető (az utolsó lekérdezés 30 napnál régebbi) A megadott számok több tranzakcióban kerültek a szolgáltatóhoz, ezeket külön kell kezelni Általános le nem kezelt hiba lépett fel! A dátumok között átfedés van, van olyan időpont ahol kettő lenne érvényben A kötelező paraméterek közül nincs valamelyik megadva A megadott telefonszám hosszúsága nem megfelelő A megadott válaszhoz nincs jelentés társítva A megadott e-mail címre már érkezik ilyen üzenet Már jóvá lett hagyva a bejelentés A megadott telefonszámok nem egyforma hosszúságúak A megadott tartományra létezik érvényes szolgáltatók közötti hordozás A megadott tartományra létezik érvényes hálózat átrendezés A hely szerinti hordozás törlési határideje még nem járt le A megadott tartományban létezik nem hordozott szám Nem a megadott berendezéskódon található az adott telefonszám A megadott berendezéskód nem azonos az eredetivel A számra már van bejegyzett, de még nem érvénybe lépett hely szerinti hordozás, vagy azonos a berendezés kód. A kérés nem teljesíthető A tranzakció nem törölhető, a tartományban van olyan szám ami már lezárásra került! A megadott tartományban van olyan szám amire már bejegyeztek hely szerinti hordozást
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
(hálózat átrendezést) A megadott tartományban van olyan szám ami ugyanezen a berendezéskódon található Berendezéskód formátum nem megfelelő A hordozás még nem lett jóváhagyva A berendezés kód érvénytelen A tartomány kezdete vagy vége nem teljes A küldött üzenet hibás Tranzakció nem engedélyezett Nem érkezett válasz, automatikusan elutasítva A tartomány nem található a számmező nyilvántartásban A hivatkozott tranzakció már törölt A bejelentést a kezdeményező törölte Már létezik ilyen számmező Nem létezik ilyen számmező A felhasználó erre a műveletre nem jogosult Hiba SOAP kérés közben Hiba az adatbázisban Ismeretlen hiba Hiba a digitális aláírás ellenőrzés során Definiálatlan mező Számmező nem megfelelő A tartomány nincs szolgáltatóhoz rendelve Szolgáltatók nem azonosak Van a törlési határidőn már túljutott számmező átadás a megadott tartományban A kérés nem a hordozás visszavonás határidejében érkezett A visszatartandó számok nem a hivatkozott számmező átadás számmezőjébe esnek A hivatkozott tranzakció nem jóváhagyott állapotú A tartományban van olyan szám amire már jelentettek be számvisszatartást A megadott tranzakció azonosító hossza nem megfelelő A kezdeményező visszavonta A hordozásra már van olyan időpont módosítás bejelentve ami jóváhagyásra vár A megadott új időablak megegyezik az eredetivel A tartományban már van olyan szám amire bejegyeztek számmező átadást A hordozásra már jelentettek be hordozás visszavonást Hibás telefonszám (BRS kód nem szerepel a BRS listában) Berendezés kód nem egyezik a számtípus kötelező berendezés kódjával A megadott tartomány kezdete ill. vége nem azonos típusú A szám hely szerint nem hordozható A megadott tartományra létezik érvényes hordozás A megadott berendezéskód megegyezik az aktuálissal A tartományban van számhasználat megszüntetésre bejelentett szám A tartományban van olyan szám amire jelentettek be jövőbeli érvényességű törlési tranzakciót A tartományban van olyan szám amire jelentettek be jövőbeli érvényességű hordozási tranzakciót A tranzakció csak visszahordozás esetén alkalmazható A partner nem létezik (vagy nem aktív) Az irányítási lista még nem lett legenerálva
Hely szerinti hordozás megszüntetés regisztrálva Hibás hely szerinti hordozás bejelentés Visszahordozás és hely szerinti hordozás bejelentés Visszahordozás és hely szerinti hordozás jóváhagyás kérés Visszahordozás és hely szerinti hordozás bejelentés jóváhagyás válasz Hibás visszahordozás és hely szerinti hordozás jóváhagyás válasz Visszahordozás és hely szerinti hordozás bejelentést a jóváhagyó elfogadta Visszahordozás és hely szerinti hordozás bejelentést a jóváhagyó elutasította Visszahordozás és hely szerinti hordozás bejelentés automatikus jóváhagyása Visszahordozás és hely szerinti hordozás bejelentés törlése Hibás visszahordozás és hely szerinti hordozás bejelentés Hibás visszahordozás és hely szerinti hordozás bejelentés törlés Visszahordozás és hely szerinti hordozás bejelentés törölve
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.
KRA továbbfejlesztés 5. fázis módosításainak beépítése: Visszahordozás és hely szerinti hordozás új funkció, Elektronikus aláírás változás
3.01
2010. július 12.
NHH, IQSYS
A dokumentum véglegesítése
4.00
2012. augusztus 1.
NMHH
Jogszabályi háttér változása, a tranzakció határidők csökkentése, a hordozás visszavonás, időpont módosítás és hálózat átrendezés funkciók megszüntetése
T-Systems
A specifikáció készítői mindent megtesznek annak érdekében, hogy a dokumentumban található adatok a lehető legpontosabbak legyenek, de az esetleg mégis előforduló hibákból eredő következményekért felelősséget nem vállalnak. Kérjük, hogy a dokumentummal kapcsolatos észrevételeit küldje el a NMHH KRA ügyfélszolgálata részére, a [email protected] email címre! Ezzel kapcsolatos fáradozásait előre is köszönjük.
Nemzeti Média- és Hírközlési Hatóság – 2012.08.01.