Webové služby WS JERRS

Poskytování dat prostřednictvím webových služeb WS JERRS

Hlavním účelem poskytování dat prostřednictvím webových služeb z informačního sytému JERRS (dále jen „WS JERRS“) je zpřístupnění strojově čitelných dat ze systému JERRS externím subjektům standardizovaným a řízeným přístupem. Použití WS JERRS je vhodné především pro subjekty s vyššími nároky na počty dotazů a počty vyhledávaných údajů. Vyhledávání jednotlivých údajů je nadále umožněno také přímo v aplikaci JERRS. Pro získávání dat ze systému JERRS prostřednictvím webových služeb existují 3 webové služby a každá je určena pro získání jiných údajů. Pro všechny 3 webové služby platí stejný postup, kdy tazatel odešle XML soubor s požadovanými údaji a obdrží odpověď s požadovanými informacemi ve formátu XML. Oba soubory XML musí odpovídat požadované XSD specifikaci. Všechny webové služby jsou realizovány jako synchronní, přičemž je určena maximální velikost odpovědi.
K autentizaci uživatelů WS JERRS je využívána elektronická pečeť nebo elektronický podpis. Pro přístup k WS JERRS je možné použít kvalifikovaný nebo komerční certifikát pro elektronickou pečeť nebo kvalifikovaný nebo komerční certifikát pro elektronický podpis vydaný certifikační autoritou (eIdentity, I.CA, Postsignum).
Pro získání přístupu k webovým službám je nutné zaslat na adresu jerrsws@cnb.cz elektronicky podepsanou žádost o přístup k WS JERRS obsahující identifikační údaje osoby, která o využití WS JERRS žádá, informace o kontaktní osobě a dále sériové číslo a název vydavatele certifikátu, který bude používat pro autentizaci a autorizaci přístupu k WS JERRS. Webová služba „Informace o zástupcích daného zastoupeného“ bude zpřístupněna pouze na základě žádosti, kterou podá zastoupený.

Společná specifikace WS JERRS

Dokument Soubor Platnost od
WSDL specifikace JerrsWS (wsdl, 4 kB) 1. 7. 2019
XSD specifikace JerrsWS (xsd, 27 kB) 1. 7. 2019
Popisný dokument WS JERRS WSJERRS (pdf, 358 kB) 1. 7. 2019

 

Číselníky WS JERRS

Dokument Soubor Platnost od
Číselník rolí WSJERRS_role (xlsx, 10 kB) 1. 7. 2019
Číselník seznamů WSJERRS_seznamy (xlsx, 10 kB) 1. 7. 2019
Číselník činností pro role WSJERRS_cinnosti_role (xlsx, 216 kB) 1. 7. 2019
Číselník činností pro vazby WSJERRS_cinnosti _vazby (xlsx, 14 kB) 1. 7. 2019
Číselník chyb WSJERRS_chyby (xlsx, 27 kB) 1. 7. 2019

 

Popis webových služeb

1) Informace o konkrétním subjektu.

Tato služba slouží pro získání informací o jednom konkrétním subjektu. Odpověď na tuto službu bude obsahovat identifikační údaje požadovaného subjektu, adresu sídla, informace o datu vzniku, trvání a zániku oprávnění, informace o povolených činnostech a informace o vybraných vazbách na jiné subjekty.

2) Informace o seznamu subjektů ve vybrané roli.

Tato služba slouží pro získání seznamu subjektů daného typu. Jedná se obdobu základních seznamů (bez vazeb a hierarchií), které jsou k dispozici v prezentaci Seznamy regulovaných a registrovaných subjektů. V případě rozsáhlejších seznamů bude odpověď rozdělena do více souborů (stránek).

3) Informace o zástupcích daného zastoupeného.

Tato služba slouží pro získání seznamu zastupujících subjektů ve vazbě na daného zastoupeného. Informace je možné získat jen o subjektech ve vazbě na zastoupeného, který daný dotaz zasílá a má tedy oprávnění takové informace pomocí webové služby získat. V případě rozsáhlejších seznamů bude odpověď rozdělena do více souborů (stránek).

U této služby bude probíhat autorizace přístupu na základě zaregistrovaného certifikátu. Certifikát bude zaregistrován pouze zastoupenému, a to na základě dokladu prokazujícím oprávnění za něj jednat, který je nutný přiložit k žádosti o přístup k WS JERRS.

 Webové služby WS JERRS jsou dostupné na adrese https://aplc.cnb.cz/jerrsws/ws