Popis služeb ROS. 205 Základní Registr osob - ROS Implementace informačního systému

Projekt „Vybudování Registru osob“ je spolufinancován z prostředků Evropské unie, Evropského fondu pro regionální rozvoj.

Popis služeb ROS Součást projektu

„205 – Základní Registr osob - ROS“ Implementace informačního systému

Česká republika - Český statistický úřad Praha 10, Strašnice, Na padesátém 3268/81, PSČ 100 82 IČ: 00025593

Adastra, s.r.o. Benešovská 1926/8 101 00 Praha 10 [email protected] www.adastragrp.com


Obsah 1

Úvod ..................................................................................................................................................................... 3

2

Kontext ................................................................................................................................................................ 4

2.1 Pravidla pro zápis údajů do registru osob .............................................................................. 4 2.1.1 Obsah registru osob............................................................................................................ 4 2.1.2 Povinnost údajů, povolené kombinace ........................................................................... 4 2.1.3 Údaje vedené v registru osob............................................................................................ 7 2.1.4 Stav údaje........................................................................................................................... 10 2.1.5 Věcná pravidla .................................................................................................................. 10 2.1.6 Číselníky používané v ROS............................................................................................. 10 2.1.7 Stav IČO ............................................................................................................................. 11 2.1.8 Stav IČP .............................................................................................................................. 11 2.2 Služby ROS ................................................................................................................................ 11 2.2.1 Společná pravidla pro služby ......................................................................................... 11 2.2.2 Důvody odmítnutí zprávy ke zpracování .................................................................... 12 2.3 Editační služby pro zápis osoby a změny referenčních údajů osoby ............................... 13 2.3.1 rosPridelICO...................................................................................................................... 13 2.3.2 rosVlozOsobu .................................................................................................................... 15 2.3.3 rosZmenOsobu.................................................................................................................. 19 2.3.4 rosZapisDatovouSchranku.............................................................................................. 22 2.3.5 rosZapisPravniStav .......................................................................................................... 23 2.3.6 rosVymazOsobu ............................................................................................................... 24 2.4 Zápis a změna údajů provozoven do ROS ........................................................................... 25 2.4.1 rosPridelICP ...................................................................................................................... 25 2.4.2 rosVlozProvozovnu.......................................................................................................... 26 2.4.3 rosZmenProvozovnu ....................................................................................................... 28 2.4.4 rosVymazProvozovnu ..................................................................................................... 29 2.5 Notifikační služba registru ROS - rosCtiZmeny .................................................................. 30 2.6 Publikační služby ROS............................................................................................................. 32 2.6.1 rosCtiIco ............................................................................................................................. 33 2.6.2 rosCtiAifo .......................................................................................................................... 37 2.6.3 rosCtiPodleUdaju ............................................................................................................. 37 2.6.4 rosCtiSeznamIco ............................................................................................................... 39 2.6.5 rosCtiSeznamEditoru ....................................................................................................... 40

Popis_služeb_ROS_03.doc


Stránka 2/41


1

Úvod

Účelem tohoto dokumentu je poskytnout uživatelům registru ROS základní a ucelený přehled informací, které jsou potřebné pro implementaci úprav AIS pro přístup k ROS. Konkrétní dotazy ohledně základního registru osob lze také odesílat na emailovou adresu [email protected]. Obsah číselníků, testovací data, příklady volání služeb jsou na http://www.szrcr.cz/vyvojari v souboru Nova_testovaci_data.zip.



Stránka 3/41


2 Kontext 2.1

Pravidla pro zápis údajů do registru osob

2.1.1

Obsah registru osob

V registru ROS budou evidovány osoby, kterým bylo přiděleno IČO. Pro každou evidovanou osobu v ROS jsou vedeny údaje v rozsahu uvedeném v kapitole 2.1.3. Dále se pro osobu vedou provozní údaje o provedených změnách v referenčních údajích a vydaných informacích o osobě. Evidence adresního místa: Identifikace adresy evidované v ROS (sídlo firmy, místo podnikání, místo pobytu, sídlo provozovny) pro adresní místa na území ČR musí být realizována ve formě referenční vazby na referenční údaj o adrese v registru územní identifikace, pokud tam je adresní místo evidováno. Pokud se nepodaří přiřadit kód adresního místa RUIAN pro příslušnou adresu, pak je tato zapsána v textovém řetězci. Do řetězce budou za sebe poskládány jednotlivé adresní údaje v doporučovaném pořadí: ulice, číslo domovní (číslo popisné, číslo orientační, číslo evidenční), PSČ, název obce, ostatní údaje. Pro adresy v zahraničí by v textu měl být i název státu. Evidence fyzické osoby (obyvatele): Identifikace fyzické osoby (podnikající fyzické osoby, fyzické osoby – statutárního zástupce) musí být realizována formou referenční vazby (kódu agendového identifikátoru fyzické osoby) na referenční údaj v registru obyvatel, pokud pro ni existuje. Pokud fyzické osobě nelze přiřadit AIFO (jedná se o cizince, který není evidován v ČR, zemřelá osoba, …), bude tato osoba evidována textovým řetězcem obsahujícím jméno (jména) a příjmení. Pokud je fyzická osoba evidována pomocí AIFO, pak není uváděno místo pobytu této fyzické osoby, protože tento údaj je evidován v ROB.

2.1.2

Povinnost údajů, povolené kombinace

Obsah dat vedených k osobě je závislý na typu právní formy osoby – ROS eviduje osoby právnické a podnikající fyzické osoby. Některé povinné údaje, které nejsou agendě známy, mohou být značeny jako „nedefinovaný“ při primárním plnění registru (adresa sídla firmy, datum vzniku, datum zániku firmy pro právnickou osobu, pro fyzickou osobu adresa místa podnikání, datum počátku a konce evidence v agendě). Pro právnické osoby se evidují tyto údaje: 

IČO - povinný údaj



Obchodní firma nebo Název – povinný údaj



Stránka 4/41




Datum vzniku – povinný údaj



Datum zániku – povinný údaj, pokud právnická osoba zanikla



Právní forma – povinný údaj, je předáván ve formě kódu jako vazby na číselník právních forem



Datová schránka – povinný údaj, pokud má právnická osoba aktivovánu datovou schránku. Je evidován ve formě identifikátoru schránky a typu této schránky. Zápis tohoto údaje zajišťuje ISDS



Právní stav – nepovinný údaj, bude předáván agendami Evidence úpadců a Insolvenční rejstřík ve formě kódu jako vazba na číselník právních stavů.



Adresa sídla – povinný údaj, může být předán jedním z následujících způsobů:



o

odkaz na adresní místo v RUIAN – požadovaný způsob zápisu adresy na území ČR

o

textový řetězec – pokud není příslušné adresní místo v RUIAN

Kód agendy, kde je osoba v evidenci – povinný údaj, agenda a agendové místo se předávají kódem podle číselníku agend a orgánů veřejné moci. Tento číselník agend bude spravovat RPP.

Pro orgány veřejné moci se budou vést obdobné údaje jako pro právnické osoby. Pro podnikající fyzické osoby se evidují tyto údaje: 

IČO – povinný údaj



Název (ve formě jména a příjmení, popř. s dodatkem) – povinný údaj



Fyzická osoba – povinný údaj, údaje mohou být předány jedním z následujících způsobů:



o

AIFO – agenda musí zajistit, aby fyzická osoba byla jednoznačně identifikována touto referenční vazbou do registru ROB, pokud je fyzická osoba v ROB evidována

o

textem obsahujícím jméno (jména) a příjmení, adresu pobytu v ČR ve formě odkazu do RUIAN, pokud fyzická osoba není v ROB evidována

o

textem obsahujícím jméno (jména) a příjmení, textem adresy pobytu nebo bydliště v zahraničí, pokud fyzická osoba není v ROB evidována.

Datum zápisu do evidence agendy – povinný údaj



Stránka 5/41




Datum výmazu z evidence agendy – povinný údaj, pokud byla činnost osoby v agendě ukončena.



Právní forma - povinný údaj, je předáván ve formě kódu jako vazby na číselník právních forem.



Datová schránka – povinný údaj, pokud má podnikající fyzická osoba aktivovánu datovou schránku. Je evidován ve formě identifikátoru schránky a typu této schránky. Zápis tohoto údaje zajišťuje ISDS.



Právní stav – nepovinný údaj, bude předáván agendami Evidence úpadců a Insolvenční rejstřík ve formě kódu jako vazba na číselník právních stavů.



Adresa místa podnikání – povinný údaj, může být předán jedním z následujících způsobů:



o

odkaz na adresní místo v RUIAN – požadovaný způsob zápisu adresy na území ČR,

o

textový řetězec– pokud není příslušné adresní místo v RUIAN.

Kód agendy, kde je osoba v evidenci - povinný údaj, agenda a agendové místo se předávají kódem podle číselníku agend a orgánů veřejné moci.

Právnická osoba může mít definovaný statutární orgán, jehož členem může být právnická nebo fyzická osoba. Právnická osoba, která je členem statutárního orgánu, může být evidována jedním z následujících způsobů: 

IČO – pokud je tato právnická osoba zapsaná v registru ROS,



názvem a adresou sídla ve formě odkazu do RUIAN, pokud není tato osoba v registru ROS evidována,



názvem a adresou sídla v textové formě pro firmy se sídlem v zahraničí.

Fyzická osoba, která je členem statutárního orgánu, může být definovaná jedním z následujících způsobů: 

AIFO – agenda musí zajistit, aby fyzická osoba byla jednoznačně identifikována tímto ukazatelem do registru ROB, pokud je fyzická osoba v ROB evidována,



textem obsahujícím jméno (jména) a příjmení, adresu pobytu v ČR ve formě odkazu do RUIAN pro cizince s pobytem na území ČR, pokud není fyzická osoba v ROB evidována,



Stránka 6/41




textem obsahujícím jméno (jména) a příjmení, textem adresy pobytu nebo bydliště v zahraničí, pokud fyzická osoba není v ROB evidována.

K právnické i fyzické osobě mohou být evidovány provozovny. Pro provozovnu se evidují následující údaje: 

IČP – povinný údaj.



Datum zahájení provozování činnosti v provozovně – povinný údaj.



Datum ukončení provozování činnosti v provozovně – povinný údaj, byla činnost v provozovně ukončena.



Adresa místa provozovny – povinný údaj, který může být předán jedním z následujících způsobů:

2.1.3

o

odkaz na adresní místo v RUIAN – požadovaný způsob zápisu adresy,

o

textem - pokud příslušné adresní místo není v RUIAN.

Údaje vedené v registru osob

Schematické znázornění datových souvislostí v registru ROS:



Stránka 7/41


OSOBA Název

Ros – typ

Ros – popis

kód právní formy

integer (3)

Kód právní formy podle číselníku právních forem

IČO

integer(8)

Identifikační číslo osoby

AIFO

string(36)

Vazební atribut na obyvatele v ROB (agendový identifikátor fyzické osoby pro ROS)

text jména

string(256)

Nestrukturované jméno fyzické osoby

identifikátor RUIAN místa pobytu

integer(10)

Identifikátor adresního místa adresy bydliště fyzické osoby v RUIAN

text adresy místa pobytu

string(1500) Nestrukturovaná adresa bydliště fyzické osoby

právní stav osoby

integer(2)

Kód právního stavu, ve kterém se osoba nachází, podle číselníku právních stavů

Ros – typ

Ros – popis

OSOBA V AGENDĚ Název kód agendy

string(15)

Kód agendy dle RPP

kód místa

string(36)

IČO orgánu veřejné moci

identifikátor RUIAN místa podnikání nebo sídla firmy

integer(10)

Identifikátor adresního místa adresy místa podnikání FO nebo adresy sídla PO v RUIAN

text adresy místa podnikání nebo sídla firmy

string(1500) Nestrukturovaná adresa místa podnikání FO nebo nestrukturovaná adresa sídla PO

obchodní firma nebo název

string(4000) Obchodní firma nebo název osoby. V případě právnické osoby bude obsahovat obchodní firmu nebo její název, v případě fyzické osoby bude obsahovat jméno a příjmení.

datum vzniku oprávnění

date

Datum vzniku oprávnění k činnosti ve vztahu k dané agendě

datum ukončení oprávnění

date

Datum ukončení oprávnění k činnosti ve vztahu k dané agendě



Stránka 8/41


STATUTÁRNÍ ORGÁN Název

Ros – popis

Ros – typ

IČO

integer(8)

Identifikační číslo právnické nebo fyzické osoby evidované v ROS, která je statutárním orgánem

identifikátor RUIAN místa pobytu

integer(10)

Vazební atribut na strukturovanou adresu bydliště nebo sídla statutárního orgánu v RUIAN

text adresy místa pobytu nebo sídla právnické osoby statutárního orgánu

string(1500)

Nestrukturovaná adresa bydliště nebo sídla statutárního orgánu

obchodní firma nebo název

string(4000)

Obchodní firma nebo název právnické osoby statutárního orgánu

AIFO

string(36)

Vazební atribut na obyvatele v ROB (agendový identifikátor fyzické osoby pro ROS)

text jména

string(256)

Nestrukturované jméno fyzické osoby

PROVOZOVNA Ros – typ

Ros – popis

IČP

integer(10)

Identifikační číslo provozovny, prvních 9 míst je pořadové číslo provozovny a poslední číslice je kontrolní, identifikační číslo musí splňovat podmínku na addo modulo 11

identifikátor RUIAN místa provozovny

integer(10)

Vazební atribut na strukturovanou adresu místa provozovny v RUIAN

text adresy místa provozovny

string(1500)

Nestrukturovaná adresa místa provozovny

Název

datum zahájení činnosti

date

Datum zahájení činnosti v provozovně

datum ukončení činnosti

date

Datum ukončení činnosti v provozovně



Stránka 9/41


DATOVÁ SCHRÁNKA Název

Ros – typ

Ros – popis

datová schránka id

string(7)

Identifikátor datové schránky dané osoby

datová schránka typ

integer(2)

Typ datové schránky, číselný identifikátor typu DS v číselníku typů

2.1.4

Stav údaje

Každý údaj nebo skupina údajů logicky k sobě patřících zapsaný do ZR, kromě identifikátorů – IČO a IČP, je označen stavem. Stav údaje může nabývat hodnot: 

Správný - implicitní,



Nesprávný,



Nedefinovaný – tento stav může mít pouze údaj AdresaSidla, DatumVznikuEvidence a DatumZanikuEvidence. Může se objevit jen v odpovědi publikačních službách, protože je povolen pouze u dat zapsaných do ROS během procesu primárního plnění. V editačních službách použít nelze.

2.1.5

Věcná pravidla



každá evidovaná osoba má přiděleno unikátní IČO,



každá evidovaná provozovna má přiděleno unikátní IČP a je svázaná s IČO osoby,



právnická osoba je evidována jen v agendě primárního editora,



podnikající fyzická osoba může být evidována ve více agendách editorů podle činností, které vykonává a ve více OVM podle místa vykonávání činnosti,



vybrané údaje (např. identifikátor datové schránky) zapisuje pouze tzv. sekundární editor,



je možný výmaz osoby nebo provozovny z evidence při chybném zápisu,



je možné obnovení osoby, provozovny výmazem data ukončení.

2.1.6

Číselníky používané v ROS

Číselníky jsou vyvěšeny na internetových stránkách Správy základních registrů. Popis_služeb_ROS_03.doc


Stránka 10/41




Číselník právních forem – gestorem je registr ROS



Číselník právních stavů – gestorem je registr ROS



Číselník typů datových schránek – gestorem je ISDS

2.1.7

Stav IČO

Životní cyklus jedinečného identifikátoru osoby - IČO má tyto stavy: 

nepřidělené - může být vráceno na žádost o přidělení IČO,



přidělené - bylo vráceno na žádost o přidělení, ale dosud osoba nebyla zapsána do ROS,



hromadně přidělené – tento stav mají IČO přidělené agendám před spuštěním ROS a nebyly dosud zapsány do ROS,



zapsané - osoba s tímto IČO je zapsaná v ROS,



fyzicky vymazané – osoba s tímto IČO byla vymazána z ROS.

Jednotlivé editační služby pracují jen s IČO určitého stavu. Některé služby mění stav IČO.

2.1.8

Stav IČP

Životní cyklus jedinečného identifikátoru provozovny - IČP má tyto stavy: 

přidělené - bylo vráceno na žádost o přidělení, ale dosud provozovna nebyla zapsána do ROS,



zapsané – provozovna s tímto IČP je zapsaná v ROS,



fyzicky vymazané – provozovna s tímto IČP byla vymazána z ROS.

Jednotlivé editační služby pracují jen s IČP určitého stavu. Některé služby mění stav IČP.

2.2

Služby ROS

2.2.1

Společná pravidla pro služby

Základní pravidla pro zpracování služeb (editačních i informačních) z katalogu služeb: 

každá služba vrací aplikační (AplikacniStatus) a systémový status zpracování (informace o úspěšném zpracování nebo kód chyby(VysledekKod), popis chyby (VysledekDetail)) a další údaje podle druhu služby,



editační služby (netýká se služeb pro přidělení IČO a IČP) vrací identifikátor změny a čas změny



Stránka 11/41




agenda by měla do editační služby dávat jen měněné údaje (pokud se zjistí, že zaslaný údaj je shodný se zapsaným v ROS, pak se toto neeviduje jako změna),



agenda primárního editora může pracovat (zakládat, měnit, fyzicky rušit) jen osoby jí přiřazené právní formy,



publikační služby jsou přístupné všem agendám, rozsah vrácených údajů je určen přístupovými právy jednotlivých činností agendy k referenčním údajům,



pokud je zadán identifikátor poslední změny na vstupu editační služby, pak je služba zpracována jen tehdy, když se jeho hodnota shoduje s hodnotou poslední provedené změny na osobě v ROS,



pokud datová část dotazu nebo odpovědi obsahuje AIFO, pak systémová část musí obsahovat MapaAIFO,



pokud datová část obsahuje adresní místo identifikované odkazem do RUIAN, pak systémová část musí obsahovat SeznamIdAdres.

2.2.2

Důvody odmítnutí zprávy ke zpracování

Zpráva může být odmítnuta již ISZR, pokud agenda nemá oprávnění na zpracování konkrétní služby nebo XML formát zaslané zprávy nevyhovuje XSD této služby. Dále ISZR zjišťuje existenci odkazů uvedených v systémové části (MapaAifo, SeznamIdAdres) do ostatních základních registrů. Zpráva může být odmítnuta registrem ROS z těchto důvodů: 

neúspěšné zpracovaní předchozí zřetězené zprávy při serializaci služeb (například: pokud agenda uvede, že ROS má vložit osobu daného IČO a následně vrátit údaje pro tuto osobu a zpracování zápisu osoby neproběhne (např. chyba ve vstupních parametrech), nebude realizována ani služba pro výpis údajů osoby),



chybný datový typ nebo rozsah vstupních parametrů,



položka parametru neobsahuje povolené hodnoty dle číselníku (toto se týká údajů, které jsou evidovány ve formě odkazu do číselníků),



neobsahuje všechny povinné údaje podle druhu služby,



uvedené údaje nevyhovují povoleným kombinacím vyplněných údajů,



není oprávnění agendy na editaci údajů určité právní formy nebo výdej údajů .



Stránka 12/41


Při zjištění chyby ve vstupních údajích služba vrací kód chyby a XML s označenými chybnými údaji. Při zjištění chyby při zpracování služby tato vrací kód chyby a případné další údaje podle typu služby a chyby.

2.3

Editační služby pro zápis osoby a změny referenčních údajů osoby

2.3.1

rosPridelICO

Službu použije primární editor k získání IČO pro novou osobu. Pro právnickou osobu je povinným údajem obchodní jméno (NazevOsoby), pro podnikající fyzickou osobu je povinným údajem jedna z těchto kombinací 1. AIFO podnikatele (Aifo) 2. Jméno a příjmení podnikatele a kód adresního místa pobytu podnikatele (FoTextem, OdkazRuian) 3. Jméno a příjmení podnikatele a jeho adresa pobytu textem (FoTextem, AdresaTextem) Pravidla kontroly podle druhu zadaných údajů na vstupu služby: 

Je kontrolována unikátnost obchodního názvu v systému ROS – pokud existuje zapsané nebo přidělené IČO pro stejný obchodní název, pak se vrátí příslušný kód chyby a IČO, které pro daný název bylo nalezeno v ROS.



Je kontrolována unikátnost AIFO v systému ROS – pokud existuje zapsané nebo přidělené IČO pro stejného AIFO, pak služba vrátí příslušný kód chyby a IČO, zapsané nebo přidělené podnikateli identifikovanému vstupním AIFO.



Je kontrolována unikátnost zadání podnikatele v rámci přidělených IČO pro varianty 2. a 3. v rámci přidělených IČO agendy, která o službu žádá.

Pokud není porušeno některé z výše uvedených pravidel, služba vrací jedno IČO ze seznamu nepřidělených. Příklad vstupních dat žádosti o přidělení IČO pro právnickou osobu: A999 00495682 KOALA LEISURE TRAVEL spol. s r.o. Popis_služeb_ROS_03.doc


Stránka 13/41


Příklad vstupních dat řádosti o přidělení IČO pro fyzickou podnikající osobu s podnikatelem identifikovaným odkazem do ROB: A999 00495682 1 Protože žádost obsahuje odkaz V systémové části musí být uvedena MapaAifo: <MapaAifo> 1 878afccf-c036-4570-b616-b1cfae27f35d A999 Pokud je žádáno o přidělení IČO pro stejné údaje osoby, jako bylo již dříve přiděleno IČO, ale dosud nebyl proveden zápis osoby do ROS, pak vrátí chybový status s popisem této skutečnosti a IČO, které již bylo přiděleno: <e16:RosOdpoved> <e16:RosPridelIcoDataResponse> <sed:AplikacniStatus> VAROVANI ICO PRIDELENO IČO bylo rezervováno, osoba zatím nezapsána. Popis_služeb_ROS_03.doc


Stránka 14/41


<sed:Ico>869694

APLIKAČNÍ CHYBOVÉ STAVY SLUŽBY:

2.3.2

Aplikační chybový status

Aplikační kód výsledku

OPAKOVANE ZPRACOVANI

VAROVANI

ICO JIZ ZAPSANO

VAROVANI

ICO PRIDELENO

VAROVANI

OBECNA CHYBA SLUZBY

CHYBA

NEVALIDNI DATA

CHYBA

NEVALIDNI ZADOST

CHYBA

CHYBA MAPA AIFO

CHYBA

CHYBA MAPA ADRES

CHYBA

ZAPSANO VICE OSOB

VAROVANI

rosVlozOsobu

Službu použije primární editor pro zápis osoby. Předané vstupní údaje služby musí vyhovovat typu osoby dle právní formy osoby. Agenda musí mít přidělené oprávnění na editaci dané právní formy (PravnickaOsoba/FyzickaOsoba), jinak služba není zpracována a vrací příslušný kód chyby. Agenda předává jako vstupní parametry službě tyto povinné údaje: 

IČO (Ico),



datum vzniku nebo zápisu do evidence (DatumVznikuOpravneni),



kód právní formy (KodPravniFormy),



adresu sídla nebo místa podnikání (AdresaSidla – OdkazRuian, AdresaTextem),



Stránka 15/41




název, obchodní firmu (NazevOsoby)



identifikaci podnikatele, pokud se jedná o zápis fyzické podnikající osoby, pokud se jedná o podnikající fyzickou osobu (Fo).

Dalšími nepovinnými vstupními parametry služby mohou být: 

statutární orgán v opakující se struktuře, pokud se jedná o právnickou osobu (StatutarniOrgany)



datum ukončení činnosti, (DatumZanikuOpravneni).

pokud

je

zapisována

osoba

s ukončenou

činností

Pravidla služby: 

IČO musí být přiděleno službou rosPridelIco nebo označeno jako hromadně přidělené (podle vydaných intervalů IČO před spuštěním ROS).



Pokud bylo IČO přiděleno službou, pak musí být shoda obsahu příslušných údajů v žádosti o přidělení IČO a při zápisu osoby (při neshodě služba vrací údaje, pro něž bylo IČO přiděleno).



Pokud bylo IČO vydáno ČSÚ již před spuštěním ROS, pak se údaje nekontrolují.



Zapisovaní členové statutárního orgánu musí být unikátně identifikovaní (unikátní seznam k danému IČO)

Při úspěšném zpracování služby služba vrací čas provedení služby a unikátní identifikátor změny v ROS. Příklad nastavení aplikačního statusu v odpovědi služby při neshodě údajů žádosti o přidělení IČO s údaji použití ve službě pro vložení IČO, součástí je i vrácení údajů použitých pro přidělení IČO:

VAROVANI NESHODA REZERVACE ICO Neshoda v údajích k přidělení a vložení IČO. Popis_služeb_ROS_03.doc


Stránka 16/41


Zasilatelství JKLM, sro. A999 Příklad volání služby pro zápis právnické osoby se členy statutárního orgánu: <edi:RosVlozOsobuData> <edi:PravnickaOsoba> 840211 Novákovy garáže, a.s. 112 2010-08-13 2012-08-13 87654 <edi:StatutarniOrgany> 830500 Armaturka - Smržov 123456 MKLN, sro.



Stránka 17/41


Praha 1, Dlouhá 52

APLIKAČNÍ CHYBOVÉ STAVY SLUŽBY: Aplikační chybový status

Aplikační kód chyby


VAROVANI

NESHODA REZERVACE ICO

VAROVANI

CHYBA MAPA AIFO

CHYBA

CHYBA MAPA ADRES

CHYBA

ICO JIZ ZAPSANO

VAROVANI

ICO NEPRIDELENO

CHYBA

ICO NEEXISTUJE

CHYBA

OBECNA CHYBA SLUZBY

CHYBA

NEVALIDNI DATA

CHYBA

NEVALIDNI ZADOST

CHYBA

ICO CHYBA MODULO

CHYBA

NEPOVOLENY KOD PRAVNI FORMY

CHYBA

OSOBA SOBE STATUTAREM

CHYBA

NEEXISTUJE OSOBA STATUTARA

CHYBA

DUPLICITA STATUTARA

CHYBA



Stránka 18/41


2.3.3

CHYBA OPRAVNENI

CHYBA

CHYBA ROZSAHU

CHYBA

rosZmenOsobu

Služba slouží ke změně evidovaných údajů osoby. Agenda primárního editora fyzické podnikající osoby prvním použitím této služby pro zápis názvu, adresy sídla a data zápisu do evidence agendy editora zapisuje existenci IČO ve své agendě. Dále může obsahovat zápis a výmaz souvisejících statutárních orgánů (údaje statutárního orgánu nelze měnit, změna se provede výmazem původního orgánu a vložením nového statutárního orgánu). Služba umožňuje zadáním data zániku nebo výmazu z evidence ukončit platnost osoby v agendě. Služba může být použita i na znovuobnovení osoby výmazem data zániku. Agenda předává jen údaje, které ona sama měnila. Služba může být použita k označení některého z referenčních údajů za „nesprávný“. Agenda může měnit referenční údaje kód právní formy a osobu podnikatele (KodPravniFormy, Fo), pokud má k tomu oprávnění, i v případě, že dosud neprovedla registraci existence osoby ve své agendě (nemusí být evidovaná osoba v agendě pro toto IČO). Referenční údaje osoby za agendu (ObchodniNazev, AdresaSidla, DatumVznikuOpraveni, DatumZanikuOpravneni) může měnit jen agenda a OVM, která údaje zapsala. Vstupní parametry služby obsahují: 

IČO,



nepovinný identifikátor poslední změny (IdZmeny),



měněné hodnoty referenčních údajů.

Dále mohou vstupní parametry obsahovat: 

údaje pro zápis nových statutárních orgánů (UdajeStatutarnihoOrganuVlozeni),



údaje pro výmaz statutárních orgánů (UdajeStatutarnihoOrganuVymaz).


Nelze změnit podnikatele definovaného odkazem do ROB na takového, který je v ROS zapsán u jiného IČO, nebo mu bylo IČO přiděleno.



Nelze změnit název právnické osoby na shodný s jinou právnickou osobou, která je zapsána v ROS, nebo jí pro tento název bylo přiděleno IČO.



Změna právní formy může být provedena pouze v případě, že provádějící agenda má oprávnění editace na zapsanou právní formu i na novou právní formu.



Stránka 19/41




Identifikace člena statutárního orgánu pro výmaz musí být shodná s údaji evidovanými v ROS k tomuto statutárovi, pro nenalezení v evidovaných statutárech jsou tito vypsáni (NenalezeneStatutarniOrgany).

Příklad volání služby pro změnu adresy sídla firmy a členů statutárního orgánu: <ns24:Zadost>

<ns11:RosZmenOsobuData xmlns:ns11="urn:cz:isvs:iszr:schemas:IszrRosZmenOsobu:v1" xmlns="urn:cz:isvs:ros:schemas:RosTypy:v2" xmlns:ns10="urn:cz:isvs:org:schemas:OrgTypy:v1" xmlns:ns2="urn:cz:isvs:ros:schemas:RosEditaceData:v2" xmlns:ns3="urn:cz:isvs:ros:schemas:RosEditaceTypy:v1" xmlns:ns4="urn:cz:isvs:ros:schemas:RosDotazyData:v2" xmlns:ns6="urn:cz:isvs:rob:schemas:RobDotazyData:v1" xmlns:ns7="urn:cz:isvs:rob:schemas:RobTypy:v1" xmlns:ns8="urn:cz:isvs:reg:schemas:RegTypy:v1" xmlns:ns9="urn:cz:isvs:org:schemas:OrgRozhrani:v1"> <ns2:IdZmeny>267 <ns2:Ico>871141 <ns2:AdresaSidla> 20559232 <ns2:StatutarniOrgany> <ns3:StatutarniOrgan> <ns3:UdajeStatutarnihoOrganuVymaz> Wasilij Kutikoly 20559224 <ns3:StatutarniOrgan>



Stránka 20/41


<ns3:UdajeStatutarnihoOrganuVlozeni stav="spravny"> Jaga Ždoreckij Pelnem 456, Ukrajina Touto službou je možné změnit i fyzickou osobu podnikatele. Pokud je tento podnikatel identifikován odkazem do ROB, pak zapisované AIFO podnikatele nesmí mít zapsánu osobu v ROS a nesmí mu být přiděleno IČO. Pokud je porušeno toto pravidlo, služba vrací aplikační chybový status „NEPOVOLENA ZMENA AIFO“. Nelze také zapsat jako člena statutárního orgánu IČO osoby, status „OSOBA SOBE STATUTAREM“.

služba vrací aplikační chybový




VAROVANI

CHYBA MAPA AIFO

CHYBA

CHYBA MAPA ADRES

CHYBA

OBECNA CHYBA SLUZBY

CHYBA

NEVALIDNI DATA

CHYBA



Stránka 21/41




NESHODA ID ZMENY

CHYBA

NEVALIDNI ZADOST

CHYBA

ICO NEEXISTUJE

CHYBA

ICO JIZ ZAPSANO

CHYBA

ICO PRIDELENO

CHYBA

NEPOVOLENA ZMENA PRAVNI FORMY

CHYBA


CHYBA

NEPOVOLENA ZMENA AIFO

CHYBA

CHYBA STATUTARA

CHYBA

OSOBA SOBE STATUTAREM

CHYBA

DUPLICITA STATUTARA

CHYBA

NEEXISTUJE OSOBA STATUTARA

CHYBA

NEIDENTIFIKOVANA ZADNA ZMĚNA

VAROVANI

NEREGISTROVANO NA OVM

CHYBA

CHYBA OPRAVNENI

CHYBA

CHYBA ROZSAHU

CHYBA

2.3.4

rosZapisDatovouSchranku

Jedná se o editační službu sekundárního editoru ROS, kterým je ISDS. Editor zapisuje a vymazává datové schránky osoby. ROS eviduje pouze aktivní datové schránky. Vstupní parametry služby obsahují: 

IČO,



nepovinný identifikátor poslední změny,



seznam typů a identifikátorů (UdajeDatoveSchrankyVlozeni),

datových

schránek

pro

zapisované



Stránka 22/41

DS




seznam typů a identifikátorů (UdajeDatoveSchrankyVymaz).

datových

schránek

pro

vymazávané

DS


Seznam dvojic typ DS a identifikátor DS musí být pro IČO unikátní.



Údaje datové schránky pro výmaz musí být shodné s evidovanými údaji, při neshodě je tato vypsána (NenalezenaDS) s typem zjištěné chyby (VysledekDetail).


2.3.5



NEVALIDNI DATA

CHYBA

NESHODA ID ZMENY

CHYBA

NEVALIDNI ZADOST

CHYBA

OBECNA CHYBA SLUZBY

CHYBA


VAROVANI

ICO NEEXISTUJE

CHYBA

NEIDENTIFIKOVANA ZADNA ZMENA

VAROVANI

DUPLICITNI DS

CHYBA

NEEXISTUJICI DS

CHYBA

NEPOVOLENY TYP DS

CHYBA

rosZapisPravniStav

Jedná se o editační službu sekundárního editora ROS, mohou ji použít jen agendy Centrální evidence úpadců a Insolvenční rejstřík. Službu lze použít k zápis i výmazu právního stavu. Existence některého z právních stavů indikuje existenci aktivního řízení s osobou v příslušném rejstříku. Vstupní parametry služby obsahují: 

IČO,



Nepovinný identifikátor poslední změny,



Stránka 23/41




číslo právního stavu nebo výmaz právního stavu.


2.3.6




VAROVANI

NEVALIDNI DATA

CHYBA

NESHODA ID ZMENY

CHYBA

NEVALIDNI ZADOST

CHYBA

OBECNA CHYBA SLUZBY

CHYBA

ICO NEEXISTUJE

CHYBA

NEPOVOLENY KOD PRAVNIHO STAVU

CHYBA

NEIDENTIFIKOVANA ZADNA ZMENA

VAROVANI


VAROVANI

rosVymazOsobu

Službu lze použít pro korekci chybného záznamu do registru. Pokud je osoba evidována ve více agendách, pak je fyzicky vymazána informace o existenci osoby v příslušné agendě a OVM. Pokud je vymazána poslední evidence osoby, pak je teprve IČO převedeno do stavu „fyzicky vymazáno“ a IČO již nebude možné použít pro jinou osobu. Vstupním parametrem služby je IČO, nepovinným parametrem je identifikátor poslední změny. Nelze fyzicky vymazat osobu, která je členem statutárního orgánu jiné osoby, služba vrací aplikační chybový status „OSOBA JE STATUTAR“.



ICO NEEXISTUJE

CHYBA


VAROVANI



Stránka 24/41


2.4



OBECNA CHYBA SLUZBY

CHYBA

NEVALIDNI DATA

CHYBA

NESHODA ID ZMENY

CHYBA

NEVALIDNI ZADOST

CHYBA

OSOBA JE STATUTAR

CHYBA

NEREGISTROVANO NA OVM

CHYBA

CHYBA OPRAVNENI

CHYBA

Zápis a změna údajů provozoven do ROS

Služby pro zápis údajů může použít pouze agenda RŽP.

2.4.1

rosPridelICP

Služba vrací IČP pro novou provozovnu. Vstupními parametry služba je identifikace osoby (IČO pro zapsanou osobu, údaje žádosti pro přidělení IČO pro žádost o přidělení IČP pro osobu s přiděleným IČO, ale dosud nezapsanou v ROS), adresa provozovny (AdresaProvozovny) a datum zahájení činnosti v provozovně (DatumZahajeniCinnosti). Pokud je IČO žádosti zapsané v ROS, nebo pokud pro údaje bylo IČO přiděleno, pak služba vrací IČP a identifikátor změny. APLIKAČNÍ CHYBOVÉ STATUSY SLUŽBY: Aplikační chybový status



VAROVANI

OBECNA CHYBA SLUZBY

CHYBA

NEVALIDNI DATA

CHYBA

NEVALIDNI ZADOST

CHYBA

CHYBA MAPA AIFO

CHYBA



Stránka 25/41


2.4.2



CHYBA MAPA ADRES

CHYBA

ICO NEEXISTUJE

CHYBA

rosVlozProvozovnu

Služba provádí zápis provozovny (více provozoven) k jednomu IČO. Vstupními parametry služby jsou: 

IČO (Ico)



Nepovinný identifikátor poslední změny (IdZmeny)



opakovaná struktura provozovny (Provozovna) o

IČP (Icp),

o

adresa provozovny (AdresaProvozovny),

o

datum zahájení činnosti (DatumZahajeniCinnosti)

o

nepovinný datum ukončení činnosti (DatumUkonceniCinnosti).

Příklad datové části služby pro zápis provozoven:

RosEditaceData.xsd"

871192 1000771881 1990-01-13 1990-08-13 Popis_služeb_ROS_03.doc


Stránka 26/41


19348843 1000773981 1990-08-14 Drachkov l - u Autobazaru, okr. Strakonice Pravidla služby: 

Osoba s IČO musí být zapsaná v ROS.



Údaje provozovny musí být shodné s údaji v žádosti o přidělení čísla provozovny.



Jedna provozovna může patřit pouze jedné osobě. Nelze ji zapsat k jiné osobě ani po ukončení činnosti.




VAROVANI

NESHODA REZERVACE ICP

VAROVANI

OBECNA CHYBA SLUZBY

CHYBA

NEVALIDNI DATA

CHYBA



Stránka 27/41


2.4.3



NESHODA ID ZMENY

CHYBA

NEVALIDNI ZADOST

CHYBA

ICO NEEXISTUJE

CHYBA

CHYBA VAZBY ICO ICP

CHYBA

ICP JIZ ZAPSANO

VAROVANI

ICP NEEXISTUJE

CHYBA

CHYBA MAPA ADRES

CHYBA

DUPLICITA ICP

CHYBA

ICP CHYBA MODULO

CHYBA

CHYBA ROZSAHU

CHYBA

rosZmenProvozovnu

Služba provádí změnu údajů provozovny (provozoven). Službu lze použít pro zápis data ukončení činnosti provozovny. Služba může být použita i na znovuotevření provozovny výmazem data ukončení činnosti. Agenda předává jen měněné údaje. Vstupními parametry služby jsou: 

IČO



Nepovinný identifikátor poslední změny



opakovaná struktura o

IČP,

o

měněné údaje provozovny.


Nelze měnit vazbu IČO-IČP (přesunout provozovnu k jiné osobě).



Stránka 28/41



2.4.4




VAROVANI

OBECNA CHYBA SLUZBY

CHYBA

NEVALIDNI DATA

CHYBA

NESHODA ID ZMENY

CHYBA

NEVALIDNI ZADOST

CHYBA

ICO NEEXISTUJE

CHYBA

CHYBA VAZBY ICO ICP

CHYBA

ICP NEEXISTUJE

CHYBA

ICP PRIDELENO

CHYBA

CHYBA MAPA ADRES

CHYBA

ICP CHYBA MODULO

CHYBA

NEIDENTIFIKOVANA ZADNA ZMĚNA

VAROVANI

CHYBA ROZSAHU

CHYBA

rosVymazProvozovnu

Službu lze použít pro korekci chybného záznamu do registru. IČP již nebude možné použít pro jinou provozovnu. Vstupními parametry služby jsou pouze IČO, IČP a nepovinně identifikátor poslední změny. APLIKAČNÍ CHYBOVÉ STAVY SLUŽBY: Aplikační chybový status



VAROVANI

NEVALIDNI DATA

CHYBA

NESHODA ID ZMENY

CHYBA



Stránka 29/41


2.5



NEVALIDNI ZADOST

CHYBA

OBECNA CHYBA SLUZBY

CHYBA

ICO NEEXISTUJE

CHYBA

ICP NEEXISTUJE

CHYBA

ICP PRIDELENO

CHYBA

CHYBA VAZBY ICO ICP

CHYBA

ICP CHYBA MODULO

CHYBA

Notifikační služba registru ROS - rosCtiZmeny

Služba notifikace změn dat ROS slouží AIS pro informování o změnách referenčních dat, které v ROS proběhly během určitého období. Vstupními parametry služby jsou: 

Počáteční identifikátor změny (IdZmeny) nebo počáteční časový okamžik změny (CasZmenyOd)



Typ změny (TypZmeny: I – vložené osoby, U – osoby se změnou, D – fyzicky vymazané osoby, V – všechny změny)



konečný okamžik změny (CasZmenyDo) – nepovinný údaj, možný pouze v kombinaci s uvedením časového okamžiku počátku,



Maximální počet záznamů (MaximalniPocet) – nepovinný údaj, maximální počet záznamů v odpovědi.

Výstupem je seznam (Zmeny) - opakovaná struktura (Zmena) setříděná vzestupně podle identifikátoru změny: 

IČO (Ico),



Typ změny(TypZmeny),



Čas zmeny (CasZmeny),



Identifikátor změny (IdZmeny).

Příklad volání služby pro získání osob se změněnými údaji pro časový interval : Popis_služeb_ROS_03.doc


Stránka 30/41


1000 2011-10-01T08:34:00.000 2012-01-01T08:34:00.000 U Příklad volání služby pro získání veškerých změn provedených v ROS od zadané změny: 1000 23022 V Příklad odpovědi na službu: 12345678 U 2001-12-17T09:30:47Z 21477 234567 I 2001-12-17T09:30:47Z 21478 Pravidla pro službu: 

Pokud není uveden maximální počet záznamů nebo je uveden vyšší než počet změn definovaný správcem ROS, pak odpověď obsahuje maximálně tento počet záznamů změn. Uživatel služby tedy může pouze snížit počet vrácených záznamů.



Stránka 31/41




Pokud není uveden konečný okamžik změny, pak se vrací změny až do aktuálního okamžiku nebo do dosažení maximálního počtu vracených záznamů.



Pokud od sledovaného okamžiku bylo na osobě provedeno více změn, pak se vrazí záznam pro každou provedenou změnu (neprovádí se kumulace za IČO),



Pokud počet provedených změn přesahuje počet změn v odpovědi, pak odpověď obsahuje příslušný aplikační status. Pro získání následujících změn AIS volá službu znovu, s novými vstupními parametry (nastavenými podle hodnot údajů v poslední změně předchozího volání služby).

Poznámka: Změna na IČO je označena jako fyzický výmaz pouze při výmazu poslední evidence osoby v agendě. Pokud je službou rosVymazOsobu pouze smazána jedna z více registrací osoby v agendě, pak se jedná o změnu na osobě. APLIKAČNÍ CHYBOVÉ STAVY SLUŽBY:

2.6

Aplikační status chyby


NEVALIDNI DATA

CHYBA

NEVALIDNI ZADOST

CHYBA

OBECNA CHYBA SLUZBY

CHYBA

PREKROCEN POČET

VAROVANI

PRAZDNY SEZNAM

VAROVANI

CHYBA ROZSAHU

CHYBA

Publikační služby ROS

Aby dostal uživatel kompletní údaje o osobě, ISZR dotahuje do odpovědi údaje z ROB pro obyvatele uvedené v systémové části v MapaAifo a z RUIAN pro adresní místa uvedená v SeznamIdAdres. Niže je popsán výstup interních publikačních služeb ROS. Rozsah vrácených dat z ROS je dán povolením přístupu k údajům. Tyto jsou uvedeny v RosUdajType: 

ICO - IČO



FyzickaOsoba – osoba podnikatele



ObchodniNazev – název osoby



Stránka 32/41




AdresaSidla – adresa sídla/místa podnikání osoby



DatumVznikuOpravneni – datum vzniku osoby nebo zápisu do evidence



DatumZanikuOpravneni – datum zániku osoby nebo zrušení v evidenci



PravniForma – právní formy osoby



PravniStav – právní stav osoby



StatutarniOrgan – členové statutárního orgánu



DatovaSchranka – seznam datových schránek (pro každou dvojice typ a identifikátor)



Provozovny – seznam provozoven (IČP, adresa provozovny, datum zahájení a ukončení činnosti)

Z těchto údajů také může uživatel vybírat v případě možnosti variabilního výstupu. Protože údaje o obyvateli a adresním místě jsou vedeny v ROS odkazem do ROB a RUIAN, pak pro kompletní výpis je potřeba mít povolený přístup k vybraným údajům těchto registrů.

2.6.1

rosCtiIco

Tato služba čte údaje vedené v ROS pro zadané IČO. Vždy vrací všechny údaje k osobě vedené. Může ji použít tedy jen činnost agendy, která má oprávnění čtení všech údajů ROS. Služba vrací údaje pouze pro IČO ve stavu „zapsané“. Podle typu právní osoby jsou vrácena data ve struktuře právnické osoby (PravnickaOsoba) nebo fyzické podnikající osoby (FyzickaOsoba). Součástí odpovědi je i identifikátor poslední změny provedené na osobě. Pokud je služba volaná pro IČO ve stavu „přidělené“, pak vrací údaje, kterými bylo žádáno o přidělení IČO (UdajeZadosti). Pokud je IČO ve stavu „hromadně přidělené, pak vrací kód agendy, které ČSÚ IČO v minulosti vydalo (KodAgendy). Pokud ČSÚ není schopno určit agendu (vydávalo intervaly pro organizace, které vedou více agend), pak je jako kód agendy vrácen „ROS“. Pokud IČO je „nepřiděleno“ nebo „fyzicky vymazané“, pak se vrací příslušný chybový status. APLIKAČNÍ CHYBOVÉ STAVY SLUŽBY: Aplikační status chyby


OBECNA CHYBA SLUZBY

CHYBA

NEVALIDNI DATA

CHYBA

NEVALIDNI ZADOST

CHYBA



Stránka 33/41


Aplikační status chyby


ICO NEEXISTUJE

CHYBA

ICO NEPRIDELENO

VAROVANI

ICO PRIDELENO

VAROVANI

ICO HROMADNE PRIDELENO

VAROVANI

Příklad datové části odpovědi pro fyzickou podnikající osobu s podnikatelem identifikovaným odkazem do ROB, s evidencí ve 3 agendách, s provozovnami:
xmlns:rdd="urn:cz:isvs:ros:schemas:RosDotazyData:v2" xmlns="urn:cz:isvs:reg:schemas:RegTypy:v1" xmlns:dot="urn:cz:isvs:ros:schemas:RosDotazyTypy:v1" xmlns:edi="urn:cz:isvs:ros:schemas:RosEditaceTypy:v1" xmlns:ns7="http://www.w3.org/2004/08/xop/include" xmlns:red="urn:cz:isvs:ros:schemas:RosEditaceData:v2" xmlns:ros="urn:cz:isvs:ros:schemas:RosTypy:v2"> OK <dot:Ico>828963 <dot:IdZmeny>2 <dot:PravniForma> <dot:KodPravniFormy>100 <dot:NazevPravniFormy> Podnikající fyzická osoba (EU) <dot:Provozovny> <edi:Provozovna> <edi:Icp>1000762416 <edi:DatumZahajeniCinnosti> 1967-08-01 Popis_služeb_ROS_03.doc


Stránka 34/41


<edi:AdresaProvozovny> 21756686 <edi:Provozovna> <edi:Icp>1000768821 <edi:DatumZahajeniCinnosti> 1967-08-03 <edi:AdresaProvozovny> 19348843 <dot:OsobyAgendy> <dot:OsobaAgendy> <dot:KodAgendy>A998 <dot:KodOvm>01234567 <dot:NazevOsoby>Zlata Jahodová <dot:DatumVznikuOpravneni> 1983-07-11 <dot:AdresaSidla> 22575561 <dot:OsobaAgendy> <dot:KodAgendy>A999 <dot:KodOvm>12343212 <dot:NazevOsoby>Zlata Jahodová <dot:DatumVznikuOpravneni>



Stránka 35/41


1990-08-13 <dot:AdresaSidla> 22575561 <dot:OsobaAgendy> <dot:KodAgendy>A001 <dot:KodOvm>54326547 <dot:NazevOsoby> Zlata Jahodová, pekařství <dot:DatumVznikuOpravneni> 1967-08-13 <dot:AdresaSidla> 22575561 <dot:Fo> 1 Protože datová část obsahuje odkazy do RUIAN, musí systémová část zprávy obsahovat SeznamIdAdres s těmito odkazy na adresní místa do RUIAN: <ns2:SeznamIdAdres> <ns3:AdresniMisto>22575561 <ns3:AdresniMisto>22575561 <ns3:AdresniMisto>22575561 <ns3:AdresniMisto>21756686 Popis_služeb_ROS_03.doc


Stránka 36/41


<ns3:AdresniMisto>19348843

2.6.2

rosCtiAifo

Tato služba čte údaje fyzické podnikající osoby, kde podnikatel je identifikován odkazem do ROBu předaným jako vstupní parametr služby. Vždy vrací všechny údaje k osobě vedené. Může ji použít tedy jen činnost agendy, která má oprávnění čtení všech údajů ROS. Pro IČO ve stavu „zapsané“ vrací data ve struktuře FyzickaOsoba. Pro IČO ve stavu „přidělené“ vrací údaje žádosti. Pokud v ROS nebyla zapsána k podnikateli žádná osoba, ani mu nebylo přiděleno IČO, pak vrátí služba příslušný chybový status. Služba umožňuje vypsat pro jedno AIFO podnikatele více osob. Tyto osoby mohly být zapsány pouze procesem primárního plnění na žádost správce ROS. APLIKAČNÍ CHYBOVÉ STAVY SLUŽBY:

2.6.3

Aplikační status služby

Aplikační kód služby

OBECNA CHYBA SLUZBY

CHYBA

NEVALIDNI DATA

CHYBA

NEVALIDNI ZADOST

CHYBA

ICO NEEXISTUJE

CHYBA

ICO PRIDELENO

VAROVANI

CHYBA MAPA AIFO

CHYBA

ZAPSANO VICE OSOB

VAROVANI

rosCtiPodleUdaju

Tato služba vrací seznam osob, které vyhovují podmínkám zadaným jako vstupní parametry služby. Ke každé osobě jsou vraceny údaje, které uživatel požaduje (naplnění AutorizaceInfo výběrem z RosUdajType). IČO musí být vždy v seznamu požadovaných údajů, jinak je služba odmítnuta a vypsán chybový aplikační status a popis chyby. Příklad chybného nastavení požadovaných údajů (chybí povinné IČO): Popis_služeb_ROS_03.doc


Stránka 37/41


ObchodniNazev PravniForma PravniStav FyzickaOsoba AdresaSidla Provozovny StatutarniOrgany DatumVznikuOpravneni DatumZanikuOpravneni Tato chyba je signalizována v odpovědi vrácením chybového kódu v aplikačním statusu služby: NENI OPRAVNENI Agenda nemá oprávnění na akci podle PF nebo údaje. Nepovinným vstupním parametrem je maximální počet záznamů osob v odpovědi. ROS má definovaný interní parametr tohoto počtu, ten však může AIS snížit zadáním tohoto parametru. Podle kódu právní formy osoby se k osobě vypíší údaje ve struktuře právnické nebo fyzické podnikající osoby. Výstup je setříděn podle IČO. Příklad výběru požadovaných údajů: ICO ObchodniNazev PravniForma PravniStav FyzickaOsoba AdresaSidla DatumVznikuOpravneni DatumZanikuOpravneni APLIKAČNÍ CHYBOVÉ STAVY SLUŽBY: Aplikační status služby


NEVALIDNI DATA

CHYBA

NEVALIDNI ZADOST

CHYBA



Stránka 38/41


2.6.4

Aplikační status služby


OBECNA CHYBA SLUZBY

CHYBA

PREKROCEN POČET

CHYBA

NEVYHOVUJE ZAZNAM OSOBY

VAROVANI

CHYBA MAPA AIFO

CHYBA

CHYBA MAPA ADRES

CHYBA

CHYBA ROZSAHU

VAROVANI

CHYBA OPRAVNENI

CHYBA


CHYBA

NEPOVOLENY KOD PRAVNIHO STAVU

CHYBA

NEPOVOLENY KOD AGENDY

CHYBA

NEPOVOLENY KOD OVM

CHYBA

rosCtiSeznamIco

Služba vrací požadované údaje dané výběrem ze seznamu možných údajů (naplnění AutorizaceInfo výběrem z RosUdajType) pro předaný seznam IČO. Počet IČO na seznamu je omezen interním parametrem ROS. IČO musí být vždy v seznamu požadovaných údajů (SeznamUdaju). Při násobném uvedení ICO ve vstupním seznamu bude služba odmítnuta s aplikačním statusem vracejícím kód chyby a popis chyby: NEVALIDNI DATA V žádosti nejsou uvedeny všechny potřebné údaje nebo některé přebývají. Vstupním parametrem indikace požadavku výpisu provozních informací (NacistProvozniUdaje) lze zajistit vrácení provozních údajů k jednotlivým údajům osoby nebo ke skupině logicky svázaných údajů osoby. Popis_služeb_ROS_03.doc


Stránka 39/41


Údaje jsou vráceny k IČO z předaného seznamu (NalezeneOsoby) setříděné podle IČO. Pokud k některému IČO ze vstupního seznamu není zapsána osoba v ROS, pak tyto IČO jsou vypsána (NenalezenaIco). Provozními údaji je datum zápisu osoby do ROS, identifikátor poslední změny a čas této změny za osobu, dále identifikátor poslední změny, čas poslední změny, agenda a OVM, které tuto změnu provedlo pro každý údaj vedený k osobě. APLIKAČNÍ CHYBOVÉ STAVY SLUŽBY:

2.6.5



NEVALIDNI DATA

CHYBA

NEVALIDNI ZADOST

CHYBA

OBECNA CHYBA SLUZBY

CHYBA

CHYBA SEZNAMU

VAROVANI

PREKROCEN INTERNI PARAMETR

CHYBA

rosCtiSeznamEditoru

Služba slouží k zjištění editora konkrétního údaje osoby pro účely reklamace správnosti údaje editorovi tohoto údaje. Vstupními parametry služby jsou: 

IČO



Název údaje (výběr z RosUdajType).

Odpověď obsahuje kód agendy a kód OVM údaje, případně seznam dvojic těchto údajů v případě, že údaj je k osobě veden násobně a každý editoval jiný editor. Pokud je údaj prázdný a není označen stavem „nedefinovaný“, pak se vrátí aplikační status NEEXISTUJE EDITOR. APLIKAČNÍ CHYBOVÉ STAVY SLUŽBY: Aplikační chybový status


NEVALIDNI DATA

CHYBA

NEVALIDNI ZADOST

CHYBA



Stránka 40/41




OBECNA CHYBA SLUZBY

CHYBA

ICO NEEXISTUJE

CHYBA

NEEXISTUJE EDITOR

CHYBA



Stránka 41/41

Popis služeb ROS. 205 Základní Registr osob - ROS Implementace informačního systému

Recommend Documents