Popis porovnání volání služeb E20 a E29

Transkript

1 Popis porovnání volání služeb E20 a E29 Název dokumentu: Autor: Účel: Popis porovnání volání služeb E20 a E29 Správa základních registrů Popis porovnání volání služeb E20 a E29 a případné změny volání Verze: Datum aktualizace: Počet stran:

2 1 Úvod Tento dokument popisuje rozdíly mezi službou E20 rosctiico a E29 rosctiseznamico s ohledem na přechod od použití služby E20 na službu E29. Služba E20 je prioritní a i když umožňuje omezení rozsahu vrácených údajů, je přednostně určena pro rychlé vracení všech evidovaných údajů k osobě (viz. popis této služby 1, bod Řízení výdeje dat). 1.1 Popis služeb E20 - rosctiico Služba na základě identifikace osoby pomocí IČO vrací referenční údaje. Primárním zdrojem informací je ROS, služba umožňuje i čtení referenčních odkazů z ROB a RUIAN. Třída služby S1. Služba je prioritní a i když umožňuje omezení rozsahu vrácených údajů, je přednostně určena pro rychlé vracení všech evidovaných údajů k osobě, tj. je primárně určena pro žadatele, kteří mají oprávnění pro čtení všech referenčních údajů ROS E29 - rosctiseznamico Podle předaného seznamu IČO registr vydá požadované údaje osob ve formě opakované struktury požadovaných údajů. Primárním zdrojem informací je ROS, služba umožňuje i čtení referenčních odkazů z ROB a RUIAN. Třída služby S Funkční porovnání služeb E20 rosctiico Primární registr ROS ROS Čtení odkazů ROB Ano Ano Čtení odkazů RUIAN Ano Ano E29 rosctiseznamico Řízení workflow Ano (čtení ROB a RUIAN) Ano (čtení ROB a RUIAN) Rozsah výstupních údajů ROS Libovolný referenční údaj ROS. Libovolný referenční údaj ROS, volitelně buď bez provozních údajů, nebo včetně provozních údajů. Stav zápisu v ROS Služba může vrátit informace k IČO, které bylo rezervováno, ale pro které ještě nebyla osoba zapsána. Služba nevrací informace k IČO, které bylo rezervováno, ale pro které ještě nebyla osoba zapsána. 1

3 Nutná oprávnění pro čtení ROS Rozsah výstupních údajů ROB Žadatel musí mít oprávnění minimálně pro čtení IČO, obchodního názvu, fyzické osoby a právní formy. Volitelný, maximálně jméno, příjmení, adresa pobytu (případně atribut adresa úřadu) Žadatel musí mít oprávnění minimálně pro čtení IČO. Volitelný, maximálně jméno, příjmení, adresa pobytu (případně atribut adresa úřadu) Počet načítaných IČO 1 N (omezeno parametrem registru ROS) Zásadní věcný rozdíl mezi službami je především v tom, že ve službě E29 rosctiseznamico lze žadatelem přesně specifikovat požadované údaje z ROS a tedy čerpat pouze ty údaje, které jsou pro úkon v agendě nezbytné a navíc nemusí mít žadatel oprávnění na některou z položek obchodní název, fyzická osoba nebo právní forma. Detailní principy a podmínky najdete v kapitole Řízení výdeje dat v popisu této služby 2. ( 2 Tedy například pro PFO lze zjistit, zda má IČO zapsaného insolvenčního správce (pokud na to má žadatel oprávnění) bez čtení informací o fyzické osobě (a tedy není oprávnění na fyzickou osobu nutné). 1.3 Žádost o službu Informace o žadateli (element ZadostInfo) se u obou služeb naplňuje totožně. Požadované údaje a řízení workflow (element AutorizaceInfo/SeznamUdaju) se u obou služeb naplňuje totožně. Požadované IČO (nebo seznam IČO) se naplňuje do elementu Zadost následovně: E20 rosctiico Element RosCtiIcoData / element Ico E29 rosctiseznamico Element RosCtiSeznamIcoData / elementy Ico Příklady volání služby E20 rosctiico <s:envelope xmlns:s=" <s:header> <Action s:mustunderstand="1" xmlns=" co</action> </s:header> <s:body xmlns:xsi=" xmlns:xsd=" <RosCtiIco xmlns="urn:cz:isvs:iszr:schemas:iszrrosctiico:v1"> <ZadostInfo xmlns="urn:cz:isvs:iszr:schemas:iszrabstract:v1"> <CasZadosti xmlns="urn:cz:isvs:reg:schemas:regtypy:v1"> T01:00:00</CasZadosti> <Agenda xmlns="urn:cz:isvs:reg:schemas:regtypy:v1">axxx</agenda> <AgendovaRole xmlns="urn:cz:isvs:reg:schemas:regtypy:v1">crxxx</agendovarole> <Ovm xmlns="urn:cz:isvs:reg:schemas:regtypy:v1">ovm</ovm>

4 <Ais xmlns="urn:cz:isvs:reg:schemas:regtypy:v1">ais</ais> <Subjekt xmlns="urn:cz:isvs:reg:schemas:regtypy:v1">subjekt</subjekt> <Uzivatel xmlns="urn:cz:isvs:reg:schemas:regtypy:v1">uzivatel</uzivatel> <DuvodUcel xmlns="urn:cz:isvs:reg:schemas:regtypy:v1">duvod</duvoducel> <AgendaZadostId xmlns="urn:cz:isvs:reg:schemas:regtypy:v1">d7cd2913-caae-4abc-ac8dc8fb4a1908e3</agendazadostid> </ZadostInfo> <AutorizaceInfo xmlns="urn:cz:isvs:iszr:schemas:iszrabstract:v1"> <SeznamUdaju> DatovaSchrankaROS ObchodniNazev PravniForma PravniStav FyzickaOsoba AdresaSidla Provozovny StatutarniOrgany DatumVznikuOpravneni DatumZanikuOpravneni Ico Jmeno Prijmeni AdresaPobytu AdresaUradu ROBCti ROSCti RUIANCti</SeznamUdaju> </AutorizaceInfo> <Zadost> <RosCtiIcoData> <Ico xmlns="urn:cz:isvs:ros:schemas:rosdotazydata:v2">828963</ico> </RosCtiIcoData> </Zadost> </RosCtiIco> </s:body> </s:envelope E29 rosctiseznamico <soapenv:envelope xmlns:soapenv=" xmlns:urn="urn:cz:isvs:iszr:schemas:iszrrosctiseznamico:v1" xmlns:urn1="urn:cz:isvs:iszr:schemas:iszrabstract:v1" xmlns:urn2="urn:cz:isvs:reg:schemas:regtypy:v1" xmlns:urn3="urn:cz:isvs:ros:schemas:rosdotazydata:v2"> <soapenv:header/> <soapenv:body> <urn:rosctiseznamico> <urn1:zadostinfo> <urn2:caszadosti> T00:00: :00</urn2:CasZadosti> <urn2:agenda>axxx</urn2:agenda> <urn2:agendovarole>crxxx</urn2:agendovarole> <urn2:ovm>ovm</urn2:ovm> <urn2:ais>ais</urn2:ais> <urn2:subjekt>subjekt</urn2:subjekt> <urn2:uzivatel>uzivatel</urn2:uzivatel> <urn2:duvoducel>duvod</urn2:duvoducel> <urn2:agendazadostid> e bc24- f0640cd30b7c</urn2:agendazadostid> </urn1:zadostinfo> <urn1:autorizaceinfo>

5 <SeznamUdaju> DatovaSchrankaROS ObchodniNazev PravniForma PravniStav FyzickaOsoba AdresaSidla Provozovny StatutarniOrgany DatumVznikuOpravneni DatumZanikuOpravneni Ico Jmeno Prijmeni AdresaPobytu AdresaUradu ROBCti ROSCti RUIANCti</SeznamUdaju> </urn1:autorizaceinfo> <urn:zadost> <urn:rosctiseznamicodata> <urn3:nacistprovozniudaje>true</urn3:nacistprovozniudaje> <urn3:ico>828963</urn3:ico> <urn3:ico>870455</urn3:ico> <urn3:ico>871141</urn3:ico> </urn:rosctiseznamicodata> </urn:zadost> </urn:rosctiseznamico> </soapenv:body> </soapenv:envelope>

6 1.4 Odpověď Služby vrací informace ROS v obdobné struktuře. Srovnání je znázorněno na následujícím obrázku. - Ve výstupu obou služeb existuje odpovídající element AplikacniStatus. - Ve výstupu si podle požadavku na čtení provozních údajů odpovídají elementy PravnickaOsoba, respektive elementu PravnickaOsoba odpovídá element PravnickaOsobaProvozniUdaje, obdobně to platí i pro FO. - Ve službě rosctiseznamico nelze získat informace o dosud nezapsané osobě. - Služba rosctiseznamico vrací nenalezená IČO se vstupního seznamu v elementu NenalezenaIco. Na následujícím obrázku je znázorněno srovnání struktury elementů PravnickaOsoba, respektive PravnickaOsobaProvozniUdaje. - Výstup služby E29 pro PO obsahuje vždy navíc CasZmeny. - Výstup služby E29 pro PO obsahuje elementy PravniForma a OsobaAgendy volitelně. - Výstup služby E29 pro PO v případě požadavku na čtení provozních dat obsahuje DatumZapisuRos. Obdobný vztah jako u elementu PravnickaOsoba je i u elementu FyzickaOsoba.

7 - Výstup služby E29 pro PFO obsahuje vždy navíc CasZmeny. - Výstup služby E29 pro PFO obsahuje elementy PravniForma, OsobyAgendy a Fo volitelně. - Výstup služby E29 pro PFO v případě požadavku na čtení provozních dat obsahuje DatumZapisuRos. V případě čtení provozních údajů obsahují vydávané elementy s referenčními údaji i provozní informace, viz následující obrázek, příklad u elementu DatoveSchranky. Data, která jsou případně vrácena na základě specifikace žadatele z ROB (element RobOdpoved) a RUIAN (RuianOdpoved) mají u obou služeb totožnou strukturu Příklady odpovědí E20 Níže je uveden příklad odpovědi na volání služby E20 rosctiico bez požadavku na čtení ROB a RUIAN. <soapenv:envelope xmlns:soapenv=" xmlns:autocont1="urn:cz:isvs:iszr:services:iszrprobe:v1" xmlns:abs="urn:cz:isvs:iszr:schemas:iszrabstract:v1" xmlns:e20="urn:cz:isvs:iszr:schemas:iszrrosctiico:v1" xmlns:reg="urn:cz:isvs:reg:schemas:regtypy:v1" xmlns:xlinl=" xmlns:sdo="urn:cz:isvs:ros:schemas:rosdotazydata:v2" xmlns:ros="urn:cz:isvs:ros:schemas:rostypy:v2" xmlns:dot="urn:cz:isvs:ros:schemas:rosdotazytypy:v1" xmlns:autocont2="urn:cz:isvs:ruian:schemas:ctiprorob:v1" xmlns:autocont3="urn:cz:isvs:ruian:schemas:ctiadresa:v1"> <soapenv:header />

8 <soapenv:body> <e20:rosctiicoresponse> <abs:odpovedinfo> <reg:casodpovedi> T20:46: :00</reg:CasOdpovedi> <reg:status> <reg:vysledekkod>ok</reg:vysledekkod> </reg:status> <reg:agendazadostid>b15ed f-4145-ba48- cdc3e2fb97a1</reg:agendazadostid> <reg:iszrzadostid>19b5713c-9c4e-13ae dbe232001</reg:iszrzadostid> </abs:odpovedinfo> <abs:mapaaifo lokalniaifood="2"> <reg:prevodaifo> <reg:lokalniaifo>1</reg:lokalniaifo> <reg:globalniaifo>zaxpzyyv6pxz2v60xn1/n0s=</reg:globalniaifo> </reg:prevodaifo> </abs:mapaaifo> <abs:seznamidadres> <reg:adresnimisto stavovereniprvku="existuje"> </reg:adresnimisto> </abs:seznamidadres> <e20:rosodpoved> <e20:rosctiicodataresponse> <sdo:aplikacnistatus> <ros:vysledekkod>ok</ros:vysledekkod> </sdo:aplikacnistatus> <sdo:fyzickaosoba> <dot:ico>870731</dot:ico> <dot:idzmeny>223</dot:idzmeny> <dot:pravniforma> <dot:kodpravniformy>100</dot:kodpravniformy> <dot:nazevpravniformy>podnikající fyzická osoba tuzemská</dot:nazevpravniformy> </dot:pravniforma> <dot:osobyagendy> <dot:osobaagendy> <dot:kodagendy>a481</dot:kodagendy> <dot:kodovm> </dot:kodovm> <dot:nazevosoby>o3 Test E19</dot:NazevOsoby> <dot:datumvznikuopravneni> :00</dot:DatumVznikuOpravneni> <dot:adresasidla> <ros:odkazruian> </ros:odkazruian> </dot:adresasidla> </dot:osobaagendy> </dot:osobyagendy> <dot:fo> <ros:aifo>1</ros:aifo> </dot:fo> </sdo:fyzickaosoba>

9 </e20:rosctiicodataresponse> </e20:rosodpoved> </e20:rosctiicoresponse> </soapenv:body> </soapenv:envelope> V odpovědi služby E20 jsou zvýrazněny povinné elementy odpovědi, tedy elementy, které se z ROS vrátí vždy (a tedy žadatel musí mít pro využití služby E20 na tyto údaje oprávnění) E29 Níže je uveden příklad odpovědi na volání služby E29 rosctiseznamico včetně provozních údajů bez požadavku na čtení ROB a RUIAN. Žadatel specifikoval v SeznamUdaju čtení Ico DatovaSchrankaROS PravniStav AdresaSidla DatumVznikuOpravneni. <soapenv:envelope xmlns:soapenv=" xmlns:autocont1="urn:cz:isvs:iszr:services:iszrrosctizmeny:v1" xmlns:abs="urn:cz:isvs:iszr:schemas:iszrabstract:v1" xmlns:e29="urn:cz:isvs:iszr:schemas:iszrrosctiseznamico:v1" xmlns:reg="urn:cz:isvs:reg:schemas:regtypy:v1" xmlns:xlinl=" xmlns:sdo="urn:cz:isvs:ros:schemas:rosdotazydata:v2" xmlns:ros="urn:cz:isvs:ros:schemas:rostypy:v2" xmlns:dot="urn:cz:isvs:ros:schemas:rosdotazytypy:v1"> <soapenv:header/> <soapenv:body> <e29:rosctiseznamicoresponse> <abs:odpovedinfo> <reg:casodpovedi> T10:14: :00</reg:CasOdpovedi> <reg:status> <reg:vysledekkod>ok</reg:vysledekkod> </reg:status> <reg:agendazadostid>9866cb82-cc a dd2</reg:agendazadostid> <reg:iszrzadostid>4aa31318-ea04-13bd ee281b000</reg:iszrzadostid> </abs:odpovedinfo> <abs:seznamidadres> <reg:adresnimisto> </reg:adresnimisto> <reg:adresnimisto> </reg:adresnimisto> <reg:adresnimisto> </reg:adresnimisto> </abs:seznamidadres> <e29:rosodpoved> <e29:rosctiseznamicodataresponse> <sdo:aplikacnistatus> <ros:vysledekkod>varovani</ros:vysledekkod> <ros:vysledekdetail> <ros:vysledeksubkod>chyba SEZNAMU</ros:VysledekSubKod> <ros:vysledekpopis>některá IČO ze seznamu neexistují.</ros:vysledekpopis> </ros:vysledekdetail> </sdo:aplikacnistatus> <sdo:nalezeneosoby>

10 <sdo:fyzickaosobaprovozniudaje> <dot:ico>871109</dot:ico> <dot:caszmeny> T09:36: :00</dot:CasZmeny> <dot:idzmeny>329</dot:idzmeny> <dot:datoveschranky> <dot:datovaschranka> <dot:datovaschrankaudaj typ="40">fo</dot:datovaschrankaudaj> 20T09:35: :00</ros:CasZmeny> <ros:idzmeny>323</ros:idzmeny> </dot:datovaschranka> </dot:datoveschranky> <dot:pravnistav> <dot:kodpravnihostavu>1</dot:kodpravnihostavu> <dot:nazevpravnihostavu>v řízení podle zákona č. 328/1991</dot:NazevPravnihoStavu> 20T09:35: :00</ros:CasZmeny> <ros:idzmeny>324</ros:idzmeny> </dot:pravnistav> <dot:datumzapisuros> :00</dot:DatumZapisuRos> <dot:osobyagendy> <dot:osobaagendy> <dot:kodagendy>x999</dot:kodagendy> <dot:kodovm> </dot:kodovm> <dot:nazevosoby> <dot:nazevosobyudaj>josef Novák 134</dot:NazevOsobyUdaj> 20T09:35: :00</ros:CasZmeny> <ros:idzmeny>319</ros:idzmeny> </dot:nazevosoby> <dot:datumvznikuopravneni> <dot:datumvznikuopravneniudaj> :00</dot:DatumVznikuOpravneniUdaj>

11 20T09:36: :00</ros:CasZmeny> <ros:idzmeny>326</ros:idzmeny> </dot:datumvznikuopravneni> <dot:adresasidla> <dot:adresasidlaudaj> <ros:odkazruian> </ros:odkazruian> </dot:adresasidlaudaj> 20T09:35: :00</ros:CasZmeny> <ros:idzmeny>319</ros:idzmeny> </dot:adresasidla> </dot:osobaagendy> </dot:osobyagendy> </sdo:fyzickaosobaprovozniudaje> <sdo:fyzickaosobaprovozniudaje> <dot:ico>871141</dot:ico> <dot:caszmeny> T09:37: :00</dot:CasZmeny> <dot:idzmeny>330</dot:idzmeny> <dot:datumzapisuros> :00</dot:DatumZapisuRos> <dot:osobyagendy> <dot:osobaagendy> <dot:kodagendy>x999</dot:kodagendy> <dot:kodovm> </dot:kodovm> <dot:nazevosoby> <dot:nazevosobyudaj>pepa2</dot:nazevosobyudaj> 20T09:37: :00</ros:CasZmeny> <ros:idzmeny>330</ros:idzmeny> </dot:nazevosoby> <dot:datumvznikuopravneni> <dot:datumvznikuopravneniudaj> :00</dot:DatumVznikuOpravneniUdaj> 20T09:37: :00</ros:CasZmeny> <ros:idzmeny>330</ros:idzmeny>

12 </dot:datumvznikuopravneni> <dot:adresasidla> <dot:adresasidlaudaj> <ros:odkazruian> </ros:odkazruian> </dot:adresasidlaudaj> 20T09:35: :00</ros:CasZmeny> <ros:idzmeny>321</ros:idzmeny> </dot:adresasidla> </dot:osobaagendy> </dot:osobyagendy> </sdo:fyzickaosobaprovozniudaje> </sdo:nalezeneosoby> <sdo:nenalezenaico> <sdo:nenalezeneico> <ros:ico>870455</ros:ico> <ros:vysledekdetail> <ros:vysledeksubkod>ico HROMADNE PRIDELENO</ros:VysledekSubKod> <ros:vysledekpopis>ičo bylo hromadně přiděleno pro agendu před spuštěním ZR, osoba zatím nezapsána.</ros:vysledekpopis> </ros:vysledekdetail> </sdo:nenalezeneico> </sdo:nenalezenaico> </e29:rosctiseznamicodataresponse> </e29:rosodpoved> </e29:rosctiseznamicoresponse> </soapenv:body> </soapenv:envelope>