Datové schránky. Vytvořeno dne: Aktualizováno: Verze: 1.7 Klasifikace: Veřejný dokument 2009 Software602, a.s.

Transkript

1 Datové schránky Vytvořeno dne: Aktualizováno: Verze: 1.7 Klasifikace: Veřejný dokument 2009 Software602, a.s.

2 Obsah Popis webových služeb Seznamu datových schránek 1. Úvod Popis jednotlivých služeb GetInfo SearchSubject Chybové zprávy Tabulka typů subjektů Veřejný dokument

3 1. 2. Úvod Tento dokument obsahuje technický popis webových služeb Seznamu datových schránek. Služby jsou dostupné na adrese Popis jednotlivých objektů (soubor typu xsd) se nachází na adrese Popis jednotlivých služeb 2.1. GetInfo V následujících kapitolách jsou popsány jednotlivé webové služby. Všechny zmíněné služby jsou použitelné bez autentizace. Metoda, která na základě vstupního požadavku vyhledá fyzickou, podnikající fyzickou osobu, právnickou, OVM a vrátí informace o příslušném subjektu obsažené v Seznamu datových schránek. Vstupní parametry hledání jsou IČO subjektu nebo identifikátor datové schránky. Nelze zadat více než jeden vstupní parametr hledání. Popis datové struktury požadavku Atribut Ico DataboxId Popis Identifikační číslo subjektu. Subjekt se vyhledá podle IČ. Parametr pro vyhledání. Identifikátor datové schránky. Parametr pro vyhledání. Příklad požadavku GetInfoRequest Příklad požadavku na subjekt s určitým IČO. V příkladu je uveden subjekt Ministerstvo Vnitra. <GetInfoRequest xmlns=" <Ico> </Ico> </GetInfoRequest> Nebo lze vyhledávat podle id datové schránky. <GetInfoRequest xmlns=" <DataboxId>6bnaawp</DataboxId> </GetInfoRequest> 3 Veřejný dokument

4 Atribut Osoba Ico Popis datové struktury odpovědi NazevOsoby ISDS PDZ TypSubjektu AdresaSidla AdresaTextem ObecNazev OkresNazev CastObceNazev UliceNazev PostaKod Popis Atribut obsahující údaje o nalezeném subjektu Identifikační číslo organizace Jméno / Obchodní název subjektu Identifikátor datové schránky Datová schránka má povolený příjem poštovních datových zpráv Zkratka typu subjektu (datové schránky). Viz kapitola Tabulka typů subjektů. Atribut obsahující informace o adrese subjektu. V případě, že nalezený subjekt neuveřejnil informace o své adrese ve strukturované podobě, jsou všechny informace dostupné v tomto atributu. Název obce. Název okresu Název části obce Název ulice Poštovní směrovací číslo TypCislaDomovnihoKod Typ domovního čísla - označuje, zda jde o číslo popisné, evidenční nebo náhradní. CisloDomovni CisloOrientacni Číslo domovní Číslo orientační CisloOrientacniPismeno Písemné označení u orientačního čísla 4 Veřejný dokument

5 Příklad odpovědi GetInfoResponse <GetInfoResponse xmlns=" <Osoba> <Ico> </Ico> <NazevOsoby>Ministerstvo vnitra</nazevosoby> <ISDS>6bnaawp</ISDS> <PDZ>false</PDZ> <TypSubjektu>OVM</TypSubjektu> <AdresaSidla> <AdresaTextem>Nad štolou 936/3, Holešovice, 17000, Praha 7</AdresaTextem> <OkresNazev>Hlavní město Praha</OkresNazev> <ObecNazev>Praha 7</ObecNazev> <CastObceNazev>Holešovice</CastObceNazev> <UliceNazev>Nad štolou</ulicenazev> <PostaKod>17000</PostaKod> <CisloDomovni>936</CisloDomovni> <CisloOrientacni>3</CisloOrientacni> </AdresaSidla> </Osoba> </GetInfoResponse> 2.2. SearchSubject Metoda, která na základě vstupního požadavku vyhledá fyzickou osobu, podnikající fyzickou osobu, právnickou osobu nebo OVM a vrátí seznam nalezených subjektů. Vstupní parametry hledání jsou IČO, název, ulice nebo město. Nelze zadat více než jeden vstupní parametr hledání. Příklad požadavků SearchSubjectRequest podle vstupních parametrů <SearchSubjectRequest xmlns=" <TypSubjektu>OVM</TypSubjektu> <Ico> </Ico> </SearchSubjectRequest> <SearchSubjectRequest xmlns=" <TypSubjektu>OVM</TypSubjektu> <Nazev> Ministerstvo vnitra</nazev> </SearchSubjectRequest> A další pro ostatní parametry vyhledávání, viz následující tabulka. 5 Veřejný dokument

6 Atribut Popis datové struktury požadavku Popis TypSubjektu Typ subjektu (datové schránky). Nepovinný atribut Na základě výběru položky se určuje požadovaný typ subjektu. Jednotlivé typy se uvádí za sebou oddělené mezerou. Ico Nazev <TypSubjektu> OVM OVM_REQ</TypSubjektu> Viz kapitola Tabulka typů subjektů. Není-li uvedený typ subjektu TypSubjektu, vyhledají se všechny typy subjektů. Parametr pro vyhledávání. Identifikační číslo subjektu. Nepovinný atribut. Subjekt se vyhledá podle IČ. Vždy bude vyplněný pouze jeden parametr. Parametr pro vyhledávání. Název nebo jméno. Nepovinný atribut. Subjekty se vyhledají podle libovolného textového řetězce. Parametr pro vyhledání. Vždy bude vyplněný pouze jeden parametr. Ulice, Mesto Parametr pro vyhledávání. Nepovinný atribut. Obsahuje textový řetězec. Poznámka: Do datové struktury požadavku se vkládá vždy jen jeden parametr pro vyhledávání. Lze tedy uvést kombinaci: <SearchSubjectRequest xmlns=" <TypSubjektu>OVM</TypSubjektu> <Nazev> Ministerstvo vnitra</nazev> </SearchSubjectRequest> Příklad odpovědi SearchSubjectResponse <SearchSubjectResponse xmlns=" <ResultList> <Osoba> <Ico> </Ico> <NazevOsoby>Ministerstvo vnitra</nazevosoby> <ISDS>6bnaawp</ISDS> <PDZ>false</PDZ> </Osoba> <Osoba> <Ico> </Ico> <NazevOsoby>Zdravotní pojišťovna ministerstva vnitra České republiky</nazevosoby> <ISDS>9swaix3</ISDS> <PDZ>false</PDZ> </Osoba> </ResultList> </SearchSubjectResponse> 6 Veřejný dokument

7 Popis datové struktury odpovědi Atribut Popis ResultList Seznam obsahující nalezené subjekty Osoba Atribut obsahující údaje o nalezeném subjektu Ico Identifikační číslo organizace NazevOsoby Jméno / Obchodní název subjektu ISDS Identifikátor datové schránky PDZ Datová schránka má povolený příjem poštovních datových zpráv 3. Chybové zprávy Pokud dojde při zpracování požadavku k chybě, vrátí se odpověď obsahující informaci o chybě. Příklad chybové odpovědi ErrorResponse <?xml version= 1.0 encoding= UTF-8?> <ErrorResponse xmlns=" <Message>Invalid request format according to descriptor.</message> </ErrorResponse> Atribut Message Popis Informace o chybě během zpracování požadavku. 4. Tabulka typů subjektů Hodnota OVM DS běžného OVM vzniklá ze zákona vzniká a edituje se pouze z externího podnětu z evidence Seznam OVM - 6 odst. 1 resp. Z Rejstříku OVM. PO DS právnické osoby zřízené zákonem ale ne v OR (hlášená z ROS) - 5 odst. 1. PFO DS podnikající fyzické osoby vzniklá na žádost - 4 odst. 1. FO DS fyzické osoby, vzniklá na žádost - 3 odst. 1 OVM_PO OVM_PFO OVM_FO Vzniká změnou typu poté, co byl subjekt odpovídající existující schránce typu PO nebo PO_REQ zapsán do Rejstříku OVM. PO případném výmazu z Rejstříku OVM se opět typ změní na původní PO nebo PO_REQ (odpovídá tzv. povyšování schránek před novelou zákona o ISDS). Vzniká poté, co subjekt PFO byl zapsán do Rejstříku OVM Vzniká poté, co je fyzická osoba (tj. bez IČO) zapsána do Rejstříku OVM. 7 Veřejný dokument

8 OVM_REQ PFO_AUDITOR Další DS jiné OVM, vzniklá na žádost ( 6 a 7) vzniká pouze z externího podnětu z evidence Seznam OVM. DS konkrétního auditora. PO_REQ DS právnické osoby vzniklá na žádost - 5 odst. 2. PFO_ADVOK PFO_DANPOR PFO_INSSPR DS konkrétního advokáta, ne společnosti (hlášená z ROS). DS konkrétního daňového poradce (hlášená z ROS). DS insolvenčního správce (hlášená z ROS). 8 Veřejný dokument