Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR

GFŘ - informační systém CEDR III Vypracováno pro oddělení 171 PRO INTERNÍ POTŘEBU Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR vypracovala společnost ASD Software, s.r.o. dokument ze dne 20.09.2012, verze 2.02

Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR Počet stran v dokumentu celkem : 36 Rozdělovník : Číslo Počet výtisků Předáno Převzal 1. 1 x GFŘ, vedoucí oddělení 171 Ing. Marie Frantová 2. 1 x GFŘ, vedoucí referátu 1711 Mgr. Vladimír Dlouhý, DiS. Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012

Obsah Obsah 2 1. Úvod 5 2. Use-case studie 6 2.1 Požadavek na vygenerování číselníků a odpověď 6 3. Technické řešení 7 3.1 Přenosový formát 7 3.2 Validace a popis XML dokumentů 7 3.2.1 XML Schema 7 3.2.2 Doplňková validace XSLT šablonami 7 3.2.3 Jmenné prostory 7 3.2.4 RDDL 7 3.3 Transportní protokoly 7 3.3.1 Základní transportní protokol 7 3.3.2 Adresa služby 7 3.3.3 SOAP protokol 8 3.3.4 Použití protokolu BizTalk 8 3.4 Model přenosu zpráv 8 3.5 Popis služby ve formátu WSDL 8 3.6 Řešení bezpečnosti 8 3.6.1 Integrita přenosu dat 9 3.6.2 Požadavek o zaslání číselníků 9 3.7 Přístupová oprávnění ke službě 9 3.8 Logování přístupu ke službě 9 3.9 Dostupnost služby 9 3.10 Pojmenovávací konvence 9 3.11 Zpracování chyb 10 3.11.1 Chyby na úrovni přenosového protokolu SMTP 10 3.11.2 Chyby při načtení zprávy SOAP 10 3.11.3 Chyby vzniklé exspirací zprávy 10 3.11.4 Chyba neoprávněného přístupu 10 3.11.5 Chyby na úrovni ověření digitálního podpisu 10 3.11.6 Chyby na úrovni validace pomocí XML Schema 10 3.11.7 Chyby na úrovni validace XSLT šablonou 11 3.11.8 Chyby na aplikační úrovni 11 4. Popis předávaných dat 12 4.1 Ustanovení pro definici platnosti elementů 12 4.2 Služba na vygenerování číselníků 12 4.2.1 Požadavek na vygenerování číselníků 12 4.2.1.1 Datové typy 12 4.2.1.2 Popis schémat 12 Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012 2

4.2.1.3 Zpráva s požadavkem na generování číselníků z IS CEDR III 12 4.2.1.4 Obsah Požadavku na generování číselníků 13 4.2.1.5 Validace 13 4.2.1.5.1 Kontroly XSLT 13 4.2.1.5.2 Kontroly aplikační 13 4.2.2 Odpověď na požadavek o vygenerování číselníků 14 4.2.2.1 Datové typy 14 4.2.2.2 Popis schémat 14 4.2.2.3 Zpráva s číselníky z IS CEDR III 14 4.2.2.4 Dávka dat s číselníky 14 4.2.2.4.1 Struktura číselniku právních forem 16 4.2.2.4.2 Struktura číselníku kapitol SR 16 4.2.2.4.3 Struktura číselníku ukazatelů SR 16 4.2.2.4.4 Struktura číselníku paragrafů rozpočtové skladby 17 4.2.2.4.5 Struktura číselníku položek rozpočtové skladby 17 4.2.2.4.6 Struktura číselníku dotačních titulů 17 4.2.2.4.7 Struktura číselníku zemí 19 4.2.2.4.8 Struktura číselníku bank 19 4.2.2.4.9 Struktura číselníku zdrojů finančních prostředků. 20 4.2.2.4.10 Struktura číselníku agentur 20 4.2.2.4.11 Struktura číselníku poskytovatelů 21 4.2.2.4.12 Struktura číselníku členění finančních prostředků 21 4.2.2.4.13 Struktura číselníku vybraných měrných jednotek 21 4.2.2.4.14 Struktura číselníku grantových schémat 22 4.2.2.4.15 Struktura číselníku operačních programů 22 4.2.2.4.16 Struktura číselníku účelových znaků 22 5. Podrobný popis životního cyklu zprávy 23 6. Seznam změn v dokumentu od poslední verze 27 7. Přílohy 28 7.1 Adresa služby 28 7.1.1 Verze 2.0.1 28 7.2 WSDL 28 7.2.1 Verze 2.0.1 28 7.2.1.1 Umístění 28 7.3 Schémata 28 7.3.1 ciselnikypozadavek.xsd 28 7.3.1.1 Verze 2.0.1 28 7.3.1.1.1 Umístění 28 7.3.2 ciselniky.xsd 28 7.3.2.1 Verze 2.0.1 28 7.3.2.1.1 Umístění 28 7.3.3 ciselnikydatatypes.xsd 28 7.3.3.1 Verze 2.0.1 28 7.3.3.1.1 Umístění 28 7.3.4 error_list.xsd 28 7.3.4.1 Verze 1.0.0 28 7.3.4.1.1 Umístění 28 7.4 XSLT validační šablony 29 7.4.1 xsltvalidationciselnikypozadavek.xsl 29 7.4.1.1 Verze 2.0.1 29 7.4.1.1.1 Umístění 29 Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012 3

7.5 Dokumentace ke službě (RDDL) 29 7.5.1 Verze 201 29 7.6 Příklady zpráv 29 7.6.1 Požadavek na vygenerování číselníků 29 7.6.2 Odpověď na požadavek 31 8. Reference 34 9. Seznam použitých zkratek a pojmů 35 Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012 4

1. Úvod Tento materiál popisuje automatickou SMTP službu, která na základě předaných požadavků vrací zpět uživateli požadované informace, v našem případě obsah žádaných číselníků. Služba je poskytována zdrojům dat informačního systému CEDR III a slouží k aktualizaci číselníků informačních systémů poskytovatelů dat do IS CEDR III Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012 5

2. Use-case studie Proces žádosti o vygenerování číselníků a vytvoření odpovědi na žádost je popsán v následující kapitole. 2.1 Požadavek na vygenerování číselníků a odpověď Oprávněné osoby si mohou zažádat o zaslání číselníků z IS CEDR III tak, jak je uvedeno na Obr. 1: Zpracování požadavku IS CEDR III Osoba žádající o číselníky Požadavek na číselníky Osoby v seznamu o doručení požadavku Zpráva o doručení Osoby v seznamu požadující číselnkíky Zpráva o zpracování Obr. 1 Proces žádosti a odpovědi na vygenerování číselníků. Uvedené schéma lze slovně popsat následujícím způsobem: 1. Na straně klienta je vygenerována žádost o potřebné číselníky, která je opatřena náležitostmi popsanými v tomto dokumentu. 2. Požadavek je zaslán do IS CEDR III, kde je vygenerována zpráva o doručení požadavku o číselníky. Tato zpráva je zaslána osobám uvedeným v hlavičce zprávy dle kap. 3.3.4 3. Požadavek je zařazen do fronty požadavků, které jsou odbavovány metodou FIFO. Může dojít ke zpoždění odpovědi. 4. Po zpracování požadavku o číselníky je vygenerována odpověď, která je zaslána osobám uvedeným v hlavičce zprávy dle kap. 3.3.4 Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012 6

3. Technické řešení Pokud není explicitně uvedeno jinak, specifikace této služby přebírá zásady technického řešení, uváděné v dokumentu [3]. 3.1 Přenosový formát Jako formát pro přenos dat bude použit standard XML 1.0, Second Edition [4]. Přenášené XML dokumenty musejí splňovat všechny požadavky standardu. 3.2 Validace a popis XML dokumentů 3.2.1 XML Schema Veškeré přenášené XML dokumenty budou mít pro účely validace vytvořen popis formátu dokumentu dle standardu XML Schema [5]. Validace XML dokumentů bude prováděna vždy při převzetí zprávy službou. Také veškeré odchozí zprávy služby musejí být před odesláním validovány. Všechny předávané zprávy XML musejí mít v kořenovém elementu dokumentu deklarován jmenný prostor schématu daného dokumentu. Pomocí atributu xsi:schemalocation musí být také uvedena fyzická lokalizace schématu. Chybějící jmenný prostor nebo lokalizace schématu ve zprávě je důvodem k odmítnutí zprávy, i když bude jinak vyhovovat schématu. Všechna schémata budou obsahovat dokumentaci schématu. Formát RDF dokumentace bude odpovídat dle [3], kap. 4.1.6. Všechna schémata budou verzována v souladu se zásadami, uvedenými v [3], kap. 5.1.1.1. Cílové jmenné prostory všech schémat budou podporovat specifikaci RDDL dle [3], kap. 4.4.1. a 5.1.3.2. 3.2.2 Doplňková validace XSLT šablonami Bude-li pro daný typ XML dokumentu nutná procesní validace (viz [3], kapitola 5.2.), bude prováděna pomocí XSLT validačních šablon v souladu s metodou, uvedenou v [3], kap. 5.2. Informace o lokalizaci validační šablony je nesena (opět dle [3], kap. 5.2) v atributu validation_xslt kořenového elementu příslušného dokumentu. Výstupní XML dokument XSLT šablony musí být ve formátu odpovídajícím schématu viz kapitola 7.3.4. Validační XSLT šablony musejí odpovídat standardu XSLT v. 1.1. [6]. 3.2.3 Jmenné prostory Všechny jmenné prostory schémat, popisujících přenášené XML dokumenty popisované služby, budou ve formátu URN. 3.2.4 RDDL RDDL slouží ke snadnému přístupu ke zdrojům, spojeným se službou. RDDL soubory budou splňovat požadavky dokumentu [3], kap. 4.4.1. a 5.1.3.2. 3.3 Transportní protokoly 3.3.1 Základní transportní protokol Základním transportním protokolem pro popisovanou službu bude protokol SMTP. Komunikace při přenosu zpráv mezi klientem a bude asynchronní. 3.3.2 Adresa služby Adresa služby je dána od používané verze služby a schémat. Výčet adres je uveden v kapitole 7.1 Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012 7

3.3.3 SOAP protokol Nad protokolem SMTP bude použit rozšiřující XML protokol SOAP ve verzi 1.1 [2]. Protokol SOAP bude mít implementováno jak záhlaví SOAP (element <Header>), tak tělo SOAP (element <Body>). V záhlaví SOAP budou v BizTalk elementech neseny administrativní informace (bližší viz 23.3.4). Při výskytu chyby zpracování zprávy bude generován element <Fault> těla SOAP. Element <Fault> bude obsahovat: Povinný kód chyby v elementu <Faultcode> s typem v souladu s deklarací seznamu chybových kódů ve schématu viz kapitola 7.3.4.. Povinný textový popis chyby v elementu <Faultstring> Volitelný element <Detail>. V tomto elementu budou neseny chybové XML dokumenty (jako výsledek validace přenášených XML dokumentů) ve formátu odpovídajícím schématu viz kapitola 7.3.4.. Všechny elementy SOAP budou mít nastaven atribut MustUnderstand na hodnotu 1. 3.3.4 Použití protokolu BizTalk Pro administraci zpráv bude použito elementů specifikace BizTalk [1]. Zprávy přenášející data (žádosti i odpovědi) budou povinně obsahovat elementy: <endpoints> s indikací odesílatele a adresáta zprávy <properties> popisující vlastní přenášený dokument v souladu s pravidly dle [3], kap. 4.2.5.1. <commitmentdeliveryrequest> definuje, že strana zasílající požadavek bude vyžadovat zprávu o doručení v souladu s pravidly dle [3], kap. 4.2.5.1. <commitmentreceiptrequest> že strana zasílající požadavek bude vyžadovat potvrzení o zpracování. v souladu s pravidly dle [3], kap. 4.2.5.1. Element <expiresat> bude ignorován. Elementy <address> specifikace BizTalk budou používat prosté řetězce emailových adres osob, které mají obdržet zprávu o doručení nebo o zpracování. V případě více emailových adres budou adresy odděleny středníky. Elementy <topic> budou uvádět jmenný prostor schématu, odpovídajícího přenášené zprávě. Pro jednoznačnou identifikaci dokumentu slouží subelement <identity> elementu <properties>. Platí následující pravidlo : Naplnění elementu <identity> zajistí odesílající strana. Doporučeno je použití takového identifikátoru, které bude dokument jednoznačně identifikovat (generování UUID některým z vhodných nástrojů). V případě duplicity hodnoty elementu identity bude zpráva odmítnuta jako celek. Všechny elementy BizTalk, které mohou nést atribut MustUnderstand, musejí mít pro účely této služby tento atribut přítomen a nastaven na hodnotu 1. 3.4 Model přenosu zpráv Jako model pro přenos zpráv bude použit model message-passing dle [3], kap. 5.5.1.2 3.5 Popis služby ve formátu WSDL Tato služba, pro žádost o číselníky, bude popsána ve formátu WSDL v souladu s [3], kap. 4.2.7. Soubor WSDL bude umístěn na adrese uvedené v kapitole 7.2. Soubor WSDL bude obsahovat dokumentaci, kdy formát RDF dokumentace bude odpovídat [3], kap. 5.1.3.1. 3.6 Řešení bezpečnosti Služba ve verzi, odpovídající tomuto dokumentu, bude mít implementovány následující bezpečnostní funkce (viz též [3], kap. 5.7.1). Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012 8

3.6.1 Integrita přenosu dat Integritou dat se rozumí zabezpečení citlivých dat před jejich změnou během transportu. K zabezpečení integrity přenosu dat (viz [3], kap. 5.3.6) bude v této službě použito XML Signature). Podepisovat se budou BizTalk elementy <endpoints>, <properties> a <commitmentreceipt> a celý element <Body>. Pro podpis bude použito předem dohodnutých certifikátů, které budou samostatně předány mezi jednotlivými účastníky komunikace pro jejich zaevidování v informačních systémech. Element <Signature> bude mít atribut Id s hodnotou Signature 3.6.2 Požadavek o zaslání číselníků Tento typ přenosu (viz též 2.1) bude mít implementovány bezpečnostní funkce v závíslostní na typu zprávy. Pro zprávy s požadavkem na zaslání číselníků to budou následující: Autentizace a autorizace žadatele Integrita přenosu dat Zprávy s vygenerovanými číselníky budou zabezpečeny funkcemi: Integrita přenosu dat 3.7 Přístupová oprávnění ke službě Popisovaná služba je neveřejná a přístup ke službě je omezen pouze oprávněným uživatelům. Oprávnění uživatelé jsou registrováni v systému pro přístup ke službám CEDR III. Každému oprávněnému uživateli je správcem systému CEDR III vystaven certifikát, který je dále použit při zabezpečení zprávy dle kap. 3.6 Další podrobnější přístupová oprávnění na úrovni operací se záznamy nejsou službou řešena. 3.8 Logování přístupu ke službě V rámci přístupu ke službě se budou uchovávat následující informace: datum přístupu klienta adresa odesílatele požadavku na službu výsledek zpracování požadavku datum a čas odeslání výsledku zpracování požadavku příchozí a odchozí zprávy Logování se provádí automaticky a logovací údaje jsou ukládány do databáze, příchozí a odchozí zprávy se ukládají do adresářové struktury na zabezpečeném serveru. K údajům v rámci logování mají přístup oprávnění uživatelé (správce úlohy). Doba uchovávání těchto informací není omezena. 3.9 Dostupnost služby Služba je přístupná 24 denně. 3.10 Pojmenovávací konvence RDDL soubory, umístěné na URL viz kapitola 7.5 a budou mít příponu.html. Všechny soubory, dostupné pomocí RDDL, budou mít názvy souborů vytvořené pouze malými písmeny. Tyto pravidla nemají vliv na uživatelské pojmenovávání souborů služeb, vztahují se pouze na soubory RDDL zdrojů a slouží pouze pro informaci. Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012 9

3.11 Zpracování chyb Zpracování chyb bude ošetřeno v souladu se zásadami uvedenými v [3], kap. 5.10.1. Seznam chybových kódů bude odpovídat schématu viz kapitola 7.3.4. Client.Validity.Schema (chyba validace pomocí XML Schema) Client.Validity.XSLT (chyba validace pomocí XSLT šablony) Pokud to bude vyžadovat povaha chyby, může administrace služby kontaktovat uživatele klientské aplikace na adrese, uvedené v atributu <from> elementu <endpoints> dotazu. 3.11.1 Chyby na úrovni přenosového protokolu SMTP Chyby na úrovni přenosového protokolu SMTP budou řešeny standardními mechanismy protokolu a sítí. Služba se nebude pokoušet zpracovat žádnou zprávu, u níž došlo k selhání přenosu na úrovni základního protokolu, ani nebude generovat zvláštní chybové zprávy. Služba také nebude zaznamenávat žádnou takovouto zprávu do logu příchozích zpráv. Pokud klient neobdží odpověď ze služby do doby expirace zprávy. Považuje se zpráva za nedoručenou a klient se pokusí zprávu opětovně odeslat. 3.11.2 Chyby při načtení zprávy SOAP Do této třídy chyb patří chyby, vzniklé při načítání SOAP dokumentu. Mohou to být chyby způsobené špatným formátováním dokumentu nebo neodpovídajícím jmenným prostorem SOAP 1.1. ErrorText Dokument neobsahuje SOAP obálku požadované verze. Dokument neobsahuje SOAP element Header. Dokument neobsahuje SOAP element Body. Tyto zprávy již budou logovány. Na klienta bude odeslána pouze chybová zpráva ve formátu SOAP. Chybový kód je v tomto případě VersionMismatch (chybný jmenný prostor SOAP) nebo Client.WellFormedness (chyby správné struktury dokumentu). 3.11.3 Chyby vzniklé exspirací zprávy Tento typ chyb bude ignorován. 3.11.4 Chyba neoprávněného přístupu Tyto chyby klient obdrží v případě, že zpráva je podepsána jiným certifikátem, než je požadováno. V případě chyby klient obdrží zprávu ve formátu SOAP. Chybový kód je v tomto případě Client.AccesDeny 3.11.5 Chyby na úrovni ověření digitálního podpisu Pokud dojde k chybě při ověření digitálního podpisu, je zpráva odmítnuta jako celek. Chybová zpráva ve formátu SOAP je odeslána klientovi. Chybový kód je v tomto případě Client.Signature. ErrorText Podpis nebyl overen. Přiložený certifikát není v úložišti certifikátů. Požadovaný element není podepsán. Požadovaný element pro test na podpis nebyl nalezen. Příchozí dokument neobsahuje element SignedInfo. 3.11.6 Chyby na úrovni validace pomocí XML Schema Při výskytu chyby na úrovni validace pomocí XML Schema je zpráva odmítnuta jako celek. Je odeslána chybová zpráva ve formátu SOAP; chybový kód je v tomto případě Client.Validity.Schema. Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012 10

ErrorText Dokument není validní. 3.11.7 Chyby na úrovni validace XSLT šablonou Při výskytu chyby na úrovni validace pomocí XSLT šablony je zpráva odmítnuta jako celek. Je odeslána chybová zpráva ve formátu SOAP; chybový kód je v tomto případě Client.Validity.XSLT. 3.11.8 Chyby na aplikační úrovni Tyto chyby se týkají např. selhání aplikační databáze CEDR III. Chybová zpráva ve formátu SOAP je odeslána zpět klientovi. Obecný chybový kód je v tomto případě Client.Validity.Application. Tento chybový kód bude extendován podle zásad, uvedených v [3], kap. 5.10.1. Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012 11

4. Popis předávaných dat 4.1 Ustanovení pro definici platnosti elementů Zkratka I P N Význam Nebere se v úvahu (ignore) Povinné Nepovinné Označení povinnosti předávání jednotlivých elementů a v nich předávaných dat je uvedeno v následující tabulce. První znak v použité zkratce udává povinnost elementu, druhý udává platnost dat nebo-li hodnotu elementu. Zkratka Význam Podrobný popis PP Povinný Element Povinná Data Element i data jsou povinná NP Nepovinný Element Povinná Data Element je volitelný ale pokud je uveden jsou povinná i data. NN Nepovinný Element Nepovinná Data Pokud je element uveden není nutné uvádět data. To je vhodné např. pro UPDATE kdy je zapotřebí hodnotu přepsat. Nejsou-li data u elementu uvedena je nutné nastavit atribut null na hodnotu true. NI Nepovinný Element Ignorují se Data Element je nepovinný, ale pokud bude uveden data budou ignorována. Např. při operaci DELETE je nutný pouze primární klíč a ostatní hodnoty jsou ignorovány. 4.2 Služba na vygenerování číselníků Tato část specifikuje požadavky kladené službou CEDR na osoby žádající o vygenerování číselníků. 4.2.1 Požadavek na vygenerování číselníků 4.2.1.1 Datové typy Pro požadavek na generování číselníků z IS CEDR III není definován žádný samostatný soubor s datovými typy. Všechny potřebné datové typy jsou definovány ve schématu s požadavkem na číselníky viz kapitola 7.3.1 4.2.1.2 Popis schémat Struktura a formát požadavku žádosti o číselníky na IS CEDR III je specifikována ve schématech viz kapitola 7.3.1. 4.2.1.3 Zpráva s požadavkem na generování číselníků z IS CEDR III Zpráva s požadavkem na generování číselníky z IS CEDR III bude obsahovat následující : Seznam požadovaných číselníků. Struktura požadavku obsahuje dodatečné informace v podobě atributů elementu. Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012 12

Poznámky Poř.č. Jméno položky Typ Platnost 1 Datum vytvoření dávky DateTime PP 2 Odkaz na XSLT validační šablonu URL NP 3 Vazba - identifikátor požadavku souvisejících Boolean NP číselníků 1 Datum a čas vytvoření dávky. 2 Umístění dodatečné XSLT validační šablony. 3 Používá se pro dávku dat s číselníky, jedná se o nepovinnou položku. Nabývá hodnoty TRUE nebo FALSE. V případě TRUE se k požadovanému číselníku automaticky generují i případné související číselníky (např. k číselníku dotačních titulu se automaticky připojí i číselník ukazatelů SR). Hodnota FALSE znamená negenerovat související číselníky, nevyplněná hodnota má tejný účinek jako hodnota TRUE 4.2.1.4 Obsah Požadavku na generování číselníků Vlastní požadavek obsahuje pouze elementy JmenoCiselniku, kde hodnota musí odpovídat výčtovém typu ze schematu viz kapitola 7.3.1 a má následující obsah: Jméno číselníku Ukazatele Kapitoly Banky PravniFormy Paragrafy Polozky Staty DotacniTituly FinancniZdroje Agentury Poskytovatele CleneniFinancnichProstredku MerneJednotky GrantovaSchemata OperacniProgramy Pokud je v hlavičce dokumentu nastaven atribut vazby na hodnotu false jsou generovány pouze požadované číselníky bez vazeb na číselníky nadřízené. V ostatních případech se generují i případné číselníky navazující. 4.2.1.5 Validace K validaci požadavku na vygenerování číselníků z IS CEDR III je použito schema viz kapitola 7.3.1. 4.2.1.5.1 Kontroly XSLT Dodatečné kontroly pomocí XSLT šablony v rámci žádosti o číselníky jsou definovány 27.4.1. 4.2.1.5.2 Kontroly aplikační Aplikační kontroly v rámci požadavku na generování číselníků nejsou definovány. Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012 13

4.2.2 Odpověď na požadavek o vygenerování číselníků 4.2.2.1 Datové typy Pro přenos číselníků z IS CEDR III jsou definovány zvláštní datové typy z toho důvodu, že modul číselníku může být použit i u jiných typů rozhraní. Dané datové typy jsou specifikovány v souboru viz kapitola 7.3.3. 4.2.2.2 Popis schémat Rozhraní pro předávání číselníků z IS CEDR III na resort je definováno pomocí schématu viz kapitola 27.3.2 odpovídající jednotlivým níže uvedeným datovým tabulkám. Každé tabulce ve schématu odpovídá určitá datová struktura ve formátu XML. Podrobnější popis je uveden níže samostatně pro každou samostatnou oblast dat. Všechny tabulky jsou vloženy do dávky, která je identifikována atributy dle kapitoly 4.2.2.3. Při kontrole na schéma jsou také kontrolovány datové typy a elementy, které tvoří primární klíč v dané tabulce tzn, že tyto klíčové položky v jedné dávce dat nemohou být shodné. Pokud by byly, nastane chyba schématu. 4.2.2.3 Zpráva s číselníky z IS CEDR III Zpráva s číselníky z IS CEDR III bude obsahovat následující dávku dat: dávka dat s číselníky Struktura dávky obsahuje dodatečné informace v podobě atributů elementu. Poznámky Poř.č. Jméno položky Typ Platnost 1 Datum vytvoření dávky DateTime PP 2 Odkaz na XSLT validační šablonu URL NP 3 Identifikátor požadavku souvisejících číselníků Boolean NP 1 Datum a čas vytvoření dávky. 2 Umístění dodatečné XSLT validační šablony. 3 Používá se pro dávku dat s číselníky, jedná se o nepovinou položku. Nabývá hodnoty TRUE nebo FALSE. V případě TRUE se k požadovanému číselníku automaticky generují i případné související číselníky (např. k číselníku dotačních titulu se automaticky připojí i číselník ukazatelů SR, ). Hodnota FALSE znamená negenerovat související číselníky, nevyplněná hodnota má tejný účinek jako hodnota TRUE +/ +/ souvisejících číselníků Žádaný číselník Dotační tituly Ukazatele SR Související číselník Ukazatele SR Položky RS Paragrafy RS Kapitoly SR Kapitoly SR 4.2.2.4 Dávka dat s číselníky Ministerstvo financí ČR připravuje a udržuje aktualizované stavy číselníků používaných v evidenčním systému IS CEDRIII platné pro příslušný rok. Pro předávání dat ve formě XML je na GFŘ zprovozněna služba, která se automaticky strará o vyřízení požadavků žadatelů o data s číselníky. Číselníky se předávají dle uvedených pravidel a v uvedeném rozsahu a struktuře v tzv. dávce dat s číselníky - viz níže na základě Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012 14

požadavku uživatele, který se předává e-mailem formou XML. Uživatel si zvolí rok, za který chce data předat, jaká data (tedy které číselníky) a e-mailovou adresu, na kterou se mají data odeslat. Služba požadavek ověří a v případě kladného ověření vygeneruje dávku dat s číselníky a odešle na požadovanou adresu. Dávka obsahuje vždy celý právě platný obsah dat číselníku. V této části jsou uváděny číselníky, jejichž využití se na straně resortu předpokládá pro správnou součinnost s IS CEDR III. Číselník právní formy Číselník kapitol SR */ Číselník specifických ukazatelů SR */ Číselník paragrafů rozpočtové skladby */ Číselník položek rozpočtové skladby */ Číselník dotačních titulů */ o Vazba dotační titul - položka RS o Vazba dotační titul - paragraf RS Číselník zemí Číselník bank Číselník zdrojů finačních prostředků Číselník agentur Číselník poskytovatlů Číselník členění finančních prostředků Číselník měrných jednotek */ - U číselníků, které jsou vydávany pro každý kalendářní rok (např. číselník kapitol, ukazatelů) je nastavován atribut udávající hodnotu roku za které jsou data požadována (může být žádáno i více let). Číselníky, u nichž je platnost v intervalech platnosti od-do (nevydávají se tedy daždý kalendářní rok) atribut neobsahují. U každého záznamu s daty je nastavován atribut status, který udává režim operace s daty. Tj. vkládání - Insert, modifikace - Update a mazání - Delete. V této verzi atribut Status nabývá vždy jen hodnoty Insert. Od verze IS CEDR III 4.16 jsou používány číselníky registru územní identifikace, adres a nemovitostí (RUIAN). Číselníky slouží ke kontrole správného vyplnění adresy příjemce dotace, konkrétně položek část obce, městská část a případně PSČ. Číselník okresů (správně NUTS4) pomáhá při určení obce, protože název obce je jedinečný jen v rámci okresu. Číselník krajů (NUTS3) se používá při agregaci dat pro statistické výstupy. Číselníky rovněž obsahují informaci o převodu jednotlivých položek (okresů, obcí a městských částí) na kódy NUTS, vyžadované pro vytváření statistik dle ČSÚ. Garantem číselníků RUIAN je ČUZK a jejich struktura odpovídá verzy 0.8.3 vydané ČUZK 04.09.2012. Vzhledem k tomu, že obsah číselníků a změnové soubory těchto číselníku jsou veřejně přístupné (http://vdp.cuzk.cz/) nebude IS CEDR III zasílat tyto číselníky územní identifikace v dávce dat s číselníky. Na vyžádání bude umožněno zaslat e-mailem požadované změnové soubory. Podrobnější popis datového slovníku z ČUZK je uveden v [9] Dokumentace k registru RUIAN. Dávka dat s číselníky může obsahovat následující části: Právní forma - ve struktuře popsané v kapitole 4.2.2.4.1 Kapitoly SR - ve struktuře popsané v kapitole 4.2.2.4.2 Specifické ukazatele SR - ve struktuře popsané v kapitole 4.2.2.4.3 Paragrafy RS- ve struktuře popsané v kapitole 4.2.2.4.4 Položky RS - ve struktuře popsané v kapitole 4.2.2.4.5 Dotační tituly - ve struktuře popsané v kapitole 4.2.2.4.6 Země - ve struktuře popsané v kapitole 4.2.2.4.7 Banky - ve struktuře popsané v kapitole 4.2.2.4.8 Zdroj finančních prostředků - ve struktuře popsané v kapitole 4.2.2.4.9 Agentury - ve struktuře popsané v kapitole 4.2.2.4.10 Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012 15

Poskytovatele ve struktuře popsané v kapitole 4.2.2.4.11 Členění finančních prostředků ve struktuře popsané v kapitole 4.2.2.4.12 Číselník měrných jednotek ve struktuře popsané v kapitole 4.2.2.4.13 Číselník granotvých schémat ve struktuře popsané v kapitole 4.2.2.4.14 Číselník operačních programů ve struktuře popsané v kapitole 14.2.2.4.15 4.2.2.4.1 Struktura číselniku právních forem Číselník formy příjemce dotace slouží ke správnému vyplnění datové položky Právní forma příjemce dotace Struktura věty předávaného datového souboru je uvedena v následující tabulce: Č PK Jméno položky Typ Délka Typ XML Plat Identifikátor 1 P Kód formy příjemce dotace N 3 PP AA0019 2 Typ formy N 1 PP CA0002 3 Zkrácený název formy příjemce dotace AN 3 PP AA1336 4 Úplný název formy příjemce dotace AN 150 PP AA1087 5 P Platnost od D 10 PP CA1082 6 Platnost do D 10 NP CA1082 Popis jednotlivých řádků: 1 Kód formy příjemce dotace. 2 Typ formy pro účely určení povinných položek při pořizování dat (tato položka není předávána z ČSÚ, a slouží pro bližší specifikaci povinných položek v údajích o subjektech): Rozlišujeme čtyři typy formy: 1 - Fyzická osoba nepodnikající, identifikuje se rodným číslem. 2 - Fyzická osoba podnikající, identifikuje se rodným číslem a IČO. 3 - Právnická osoba, identifikuje se IČO. 4 - Zahraniční subjekt. 3 Zkrácený název formy příjemce dotace 4 Úplný název formy příjemce dotace 5 Platnost od datum od kdy položka platí 6 Platnost do datum do kdy položka platí, není-li uvedena záznam platí od doby Platnost od dále. Pozn. Pro stejnou hodnotu položky Kód formy příjemce se nesmí překrývat intervaly položek Platnost od a Platnost do. 4.2.2.4.2 Struktura číselníku kapitol SR Číselník kapitol státního rozpočtu na sledovaný rok slouží k vytvoření správných jmen předávaných dávek dat a ke kontrole správného vyplnění datové položky Kapitola SR. Struktura věty předávaného datového souboru je uvedena v následující tabulce: Č PK Jméno položky Typ Délka Typ XML Plat Identifikátor 1 P Kód kapitoly SR AN 4 PP CA0002 2 Název kapitoly AN 80 PP AA1274 Popis jednotlivých řádků: 1 Kód kapitoly státního rozpočtu. 2 Název kapitoly státního rozpočtu. 4.2.2.4.3 Struktura číselníku ukazatelů SR Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012 16

Číselník ukazatelů SR slouží ke správnému vytvoření podkladů pro tvorbu číselníku dotačních titulů (vazba dotační titul-ukazatel SR). Struktura věty předávaného datového souboru je uvedena v následující tabulce: Č PK Jméno položky Typ Délka Typ XML Plat Identifikátor 1 P Kód kapitoly SR AN 4 PP CA0002 2 P Kód ukazatele SR AN 12 PP CA0002 3 Název ukazatele SR AN 80 PP AA1355 4 Kód nadřazeného ukazatele SR AN 12 NP CA0002 Popis jednotlivých řádků: 1 Kód kapitoly státního rozpočtu. 2 Kód ukazatele státního rozpočtu 3 Název ukazatele státního rozpočtu 4 Kód nadřazeného ukazatele SR informuje o tom, že se jedná o bližší specifikaci ukazatele s tímto nadřazeným kódem (jedná se o kód, který je vnitřně využívaný IS CEDR III a IS CEDR-resorty) 4.2.2.4.4 Struktura číselníku paragrafů rozpočtové skladby Číselník paragrafů rozpočtové skladby na sledovaný rok slouží ke kontrole správného vyplnění datové položky Kód paragrafu RS návratné dotace a Kód paragrafu RS nenávratné dotace. Struktura věty předávaného datového souboru je uvedena v následující tabulce: Č PK Jméno položky Typ Délka Typ XML Plat Identifikátor 1 P Kód paragrafu RS AN 16 PP CA0002 2 Název paragrafu RS AN 50 PP AA1335 Popis jednotlivých řádků: 1 Kód paragrafu rozpočtové skladby podle funkčního třídění. 2 Název paragrafu rozpočtové skladby podle funkčního třídění. 4.2.2.4.5 Struktura číselníku položek rozpočtové skladby Číselník položek rozpočtové skladby na sledovaný rok slouží ke kontrole správného vyplnění datových položek Kód položky RS návratné dotace a Kód položky RS nenávratné dotace. Struktura věty předávaného datového souboru je uvedena v následující tabulce: Č PK Jméno položky Typ Délka Typ XML Plat Identifikátor 1 P Kód položky RS AN 24 PP CA0002 2 Název položky RS AN 50 PP AA1356 Popis jednotlivých řádků: 1 Kód položky rozpočtové skladby podle druhového třídění. 2 Název položky rozpočtové skladby podle druhového třídění. 4.2.2.4.6 Struktura číselníku dotačních titulů Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012 17

Číselník dotačních titulů na sledovaný rok slouží ke kontrole správného vyplnění datové položky Kód dotačního titulu a jako podklad pro tvorbu dávek dat s předpisy pro poskytování dotací. Číselník dotačních titulů na sledovaný rok bude vždy připravován na GFŘ ve spolupráci s jednotlivými kapitolami SR na základě předaných dávek dat s podklady. S číselníkem dotačních titulů se předávají vždy také datové soubory obsahující vazby mezi dotačním titulem a položkou či paragrafem rozpočtové skladby. Struktura věty předávaného datového souboru je uvedena v následující tabulce: Č PK Jméno položky Typ Délka Typ XML Plat Identifikátor 1 P Kód dotačního titulu AN 11 PP CA0002 2 Vlastní kód dotačního titulu resortu AN 30 NP AA1329 3 Název dotačního titulu AN 160 PP AA1327 4 Zkrácený název dotačního titulu AN 50 PP AA1350 5 Kód ukazatele SR AN 12 PP CA0002 6 Platnost od D 10 PP CA1082 7 Platnost do D 10 NP CA1082 Popis jednotlivých řádků: 1 Kód dotačního titulu. 2 Vlastní kód dotačního titulu resortu - kód dotačního titulu dosud používaný na resortu. Slouží k svázání nově přiděleného kódu dotačního titulu s kódem dotačního titulu používaném na resortu. Jedná se o kód, který je předáván s podklady pro tvorbu číselníku dotačních titulů, nebo může být případně generován na GFŘ a v tomto případě začíná vlastní kód dotačního titulu resortu vždy řetězcem cedr3. Od roku 2000 je povinný. 3 Název dotačního titulu. 4 Zkrácený název dotačního titulu. 5 Kód ukazatele státního rozpočtu 6 Datum počátku platnosti 7 Datum ukončení platnosti Pozn. Hodnota roku položek Platnost od a Platnost do musí odpovídat hodnotě atributu Platnost. (U položky Platnost do platí jen v případě, že je hodnota vyplněná). 4.2.2.4.6.1 Struktura s vazbou dotační titul - položka RS Vazba mezi dotačním titulem a položkou rozpočtové skladby. Jeden dotační titul může být poskytován podle několika různých položek RS a naopak. Tento číselník je vždy předáván s číselníkem dotačních titulů. Struktura věty předávaného datového souboru je uvedena v následující tabulce: Č PK Jméno položky Typ Délka Typ XML Plat Identifikátor 1 P Kód dotačního titulu AN 11 PP CA0002 2 P Kód položky RS AN 24 PP CA0002 Popis jednotlivých řádků: 1 Kód dotačního titulu 2 Kód položky rozpočtové skladby podle druhového třídění. 4.2.2.4.6.2 Struktura s vazbou dotační titul - paragraf RS Vazba mezi dotačním titulem a paragrafem rozpočtové skladby. Jeden dotační titul může být poskytován podle několika různých paragrafů RS a naopak. Tento číselník je vždy předáván s číselníkem dotačních titulů. Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012 18

Struktura věty předávaného datového souboru je uvedena v následující tabulce: Č PK Jméno položky Typ Délka Typ XML Plat Identifikátor 1 P Kód dotačního titulu AN 11 PP CA0002 2 P Kód paragrafu RS AN 16 PP CA0002 Popis jednotlivých řádků: 1 Kód dotačního titulu. 2 Kód paragrafu rozpočtové skladby podle funkčního třídění. 4.2.2.4.7 Struktura číselníku zemí Číselník slouží ke správnému vyplnění datové položky Kód státu příjemce dotace a Kód státu pro adresu příjemce dotace. Je přebírán od ČSÚ. Struktura věty předávaného datového souboru číselníku států je uvedena v následující tabulce: Č PK Jméno položky Typ Délka Des Plat Identifikátor 1 P Třímístný alfabetický kód AN 3 PP AA0033 2 P Platnost od D 8 P CA1082 3 Platnost do D 8 NP CA1082 4 Dvoumístný alfabetický kód AN 2 PP AA0033 5 Třímístný numerický kód AN 3 PP AA0033 6 Plný název v češtině AN 80 PP AA0034 7 Zkrácený název v češtině AN 45 PP AA0035 8 Plný název v angličtině AN 80 NP AA0034 9 Zkrácený název v angličtině AN 45 NP AA0035 Popis jednotlivých řádků: 1 Třípísmenná zkratka státu, tato hodnota se předává v datovém souboru s příjemci dotace 2 Datum od kdy platí uvedený záznam. Spodní hranice platnosti záznamu je nastavena na 01.01.1993 3 Datum do kdy platí uvedený záznam. 4 Dvou písmenná zkratka státu. 5 Třímístný numerický kód státu. 6 Název státu český. 7 Název státu český zkrácený. 8 Název státu anglický 9 Název státu anglický zkrácený Pozn. Pro stejnou hodnotu položky Třímístný alfabetický kód se nesmí překrývat intervaly položek Platnost od a Platnost do. 4.2.2.4.8 Struktura číselníku bank Číselník bank zajišťuje předávání jednoznačných informací týkající se odkazu na daný finanční ústav a zároveň slouží ke kontrole správného vyplnění datové položky Kód banky. Struktura věty předávaného datového souboru je uvedena v následující tabulce: Č PK Jméno položky Typ Délka Des Plat Identifikátor 1 P Kód banky N 4 PP AA0045 2 KodBankaSWIFT AN 8 NP AA0756 3 P Platnost od D 8 PP CA1082 Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012 19

4 Platnost do D 8 NP CA1082 5 Název banky AN 80 PP AA1092 Popis jednotlivých řádků: 1. Kód banky, obsahuje případné vedoucí nuly. 2. Kód banky pro mezinárodní platební styk - tzv. SWIFT kód. nebo BIC 3. Datum počátku platnosti záznamu 4. Datum ukončení platnosti záznamu 5. Název banky. Pozn. Pro stejnou hodnotu položky Kód banky se nesmí překrývat intervaly položek Platnost od a Platnost do. 4.2.2.4.9 Struktura číselníku zdrojů finančních prostředků. Číselník zdrojů finančních prostředků vymezuje zdroj finančních prostředků na poskytnutí dotace nebo návratné finanční výpomoci. Struktura věty předávaného datového souboru je uvedena v následující tabulce: Č PK Jméno položky Typ Délka Des Plat Identifikátor 1. P Kód zdroje finančních prostředků AN 20 PP AA0720 2. Název zdroje finančních prostředků AN 80 PP AA1128 3. Platnost od D 8 PP CA1082 4. Platnost do D 8 NP CA1082 5. Kód nadřízeného zdroje finančních prostředků AN 20 NP AA0720 Popis jednotlivých řádků: 1. Kód zdroje finančních prostředků jednoznačný identifikátor. 2. Název zdroje finančních prostředků slovní popis. 3. Datum začátku platnosti daného záznamu. 4. Datum ukončení platnosti daného záznamu. 5. Kód nadřízeného zdroje finančních prostředků je vyplněn jen v případě existence nadřízeného záznamu. 4.2.2.4.10 Struktura číselníku agentur Číselník agentur slouží k identifikaci jednotlivých agentur zasílajících data do IS CEDR III. Struktura věty předávaného datového souboru je uvedena v následující tabulce: Č PK Jméno položky Typ Délka Des Plat Identifikátor 1. P Kód agentury AN 38 PP AA1337 2. P Číslo agentury N 2 PP AA1353 3. Kód nadřízené agentury AN 38 NP AA1337 4. Číslo nadřízené agentury N 2 NP AA1353 5. Název agentury AN 50 PP AA1339 6. Platnost od D 8 PP CA1082 7. Platnost do D 8 NP CA1082 Popis jednotlivých řádků: 1. Kód agentury jednoznačný identifikátor. 2. Číslo agentury rozlišuje dílčí zasilatele dat Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012 20

3. Kód nadřízené agentury vytváří stromovou strukturu agentur. 4. Číslo nadřízené agentury vytváří stromovou strukturu agentur a rozlišuje dílčí zasilatele dat 5. Název agentury. 6. Datum začátku platnosti daného záznamu. 7. Datum ukončení platnosti daného záznamu. 4.2.2.4.11 Struktura číselníku poskytovatelů Poskytovatelem se rozumí subjekt který poskytuje dotaci nebo návratnou finanční výpomoc ze státního rozpočtu. Poskytovatelem může být ústřední orgán státní zprávy, úřad práce. Akademie věd ČR, Grantová agentura ČR nebo organizační složka státu, kterou určí zvláštní zákon. Poskytovatel rozhoduje o přidělení dotace nebo návratné finanční výpomoci na základě žádosti příjemce.: Č PK Jméno položky Typ Délka Des Plat Identifikátor 1. P Kód poskytovatele N 3 PP AA0716 2. Kód nadřízeného poskytovatele N 3 NP AA0716 3. Název poskytovatele AN 255 PP AA1332 4. Platnost od D 8 PP CA1082 5. Platnost do D 8 NP CA1082 Popis jednotlivých řádků: 1. Kód poskytovatele jednoznačný identifikátor. 2. Kód nadřízeného poskytovatele jednoznačný identifikátor. 3. Název poskytovatele. 4. Datum začátku platnosti daného záznamu. 5. Datum ukončení platnosti daného záznamu. 4.2.2.4.12 Struktura číselníku členění finančních prostředků Číselník členění finančních prostředků je zaveden podle 44 ods. 2 písm. zákona č.218/2000 Sb. : Č PK Jméno položky Typ Délka Des Plat Identifikátor 1. P Kód členění finančních prostředků N 3 PP AA1127 2. Název členění finančních prostředků AN 255 PP AA1110 3. Platnost od D 8 PP CA1082 4. Platnost do D 8 NP CA1082 Popis jednotlivých řádků: 1. Kód členění finančních prostředků jednoznačný číselný identifikátor. 2. Název členění finančních prostředků 3. Datum začátku platnosti daného záznamu. 4. Datum ukončení platnosti daného záznamu. 4.2.2.4.13 Struktura číselníku vybraných měrných jednotek Číselník vybraných měrných jednotek je převzat z Českého statistického úřadu viz. [7] Č PK Jméno položky Typ Délka Des Plat Identifikátor 1. P Kód měrné jednotky AN 5 PP CA0002 2. Alfabetický mezinárodní kód měrné jednoty AN 3 NP AA0735 3. Měrná jednotka název AN 255 PP AA0736 Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012 21

4. Měrná jednotka zkrácený název AN 128 NP CA0011 5. Značka měrné jednotky AN 128 NP CA0011 6. Platnost od D 8 PP CA1082 7. Platnost do D 8 NP CA1082 Popis jednotlivých řádků: 1. Jednoznačný kód měrné jednotky. 2. Mezinárodní kód měrné jednotky 3. Název měrné jednotky. 4. Zkrácený název měrné jednotky 5. Značka měrné jednotky 6. Datum počátku platnosti daného záznamu. 7. Datum ukončení platnosti daného záznamu. 4.2.2.4.14 Struktura číselníku grantových schémat Číselník grantových schémat je převzat z MSSF. Popis struktury číselníku je uveden v dokumentaci k rozhraní pro předávání dat do IS CEDR III [8] 4.2.2.4.15 Struktura číselníku operačních programů Číselník operačních programů je převzat z MSSF. Popis struktury číselníku je uveden v dokumentaci k rozhraní pro předávání dat do IS CEDR III [8] 4.2.2.4.16 Struktura číselníku účelových znaků Číselník účelových znaků je ve správě GFŘ. Č PK Jméno položky Typ Délka Des Plat Identifikátor 1 P Kód účelového znaku N 5 PP AA1272 2 Kód kapitoly SR AN 4 NP CA0002 3 Název účelového znaku AN 160 PP AA1152 4 Kód dotačního titulu AN 11 NP CA0002 Popis jednotlivých řádků: 1 Kód účelového znaku pro sledování dotací veřejným rozpočtům územní úrovně 2 Kód kapitoly státního rozpočtu 3 Úplný název účelového znaku 4 Kód dotačního titulu Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012 22

5. Podrobný popis životního cyklu zprávy Oprava chyb N Start Generování zprávy klientem Validace zprávy klientem Zpráva je validní A XSLT Validace zprávy klientem N Zpráva je validní A Příjem zprávy Zpráva Odeslání zprávy na službu Parsování zpravy Zprávu lze parsovat A Ověření jména služby v hlavičce N Shoduje se A Ověření ID zpravy N Bylo jiz nekdy přijato N A Ověření podepsaných elementu Jsou všechny podelsány N A Ověření požadavku na zaslaní odpovědi Generování chyby N Je požadována odpověď A Odeslání zprávy o doručení klientovi Zpráva s chybou klientovi Zpráva o doručení klientovi Uložení zprávy do fronty Konec 1 Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012 23

1 Načtení zprávy z fronty Ověření podpisu Je podpis ověřen A Validace XML dokumentu N Dokument je validni A XSLT Validace N Dokument je validni A Generování odpovědi N Generování chyby N Vygenerováno bez chyb N A Dokument je vaidní Validace odpovědi N Dokument je validní A XSLT Validace odpovědi A Odeslání odpovědi Zpráva s chybou klientovi Zpráva o zpracování klientovi Konec Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012 24

Obr. 2 Životní cyklus zprávy Životní cyklus zprávy na straně služby, vyjádřený na předchozím obrázku, lze podrobně rozepsat v následujících bodech: 1. Odesílající strana (klient) vygeneruje zprávu, s požadavkem na vygenerování číselníku(ů). 2. Klient ověří vygenerovanou zprávu na schéma příslušné verze. Pokud zpráva není validní, nebude zprávu odesílat na službu. 3. Klient ověří vygenerovanou zprávu XSLT validační šablonou příslušné verze. Pokud zpráva není validní, nebude zprávu odesílat na službu. 4. Klient prostřednictvím emailového klienta zašle zprávu na příslušnou adresu služby viz kapitola 7.1. Pokud dojde k selhání přenosu na úrovni protokolu SMTP, služba negeneruje chybovou zprávu SOAP (nemusí k ní zpráva dorazit). Indikace chybového stavu bude provedena standardními postupy pro daný protokol. V tomto případě musí detekovat problém odesílatel a odeslat případně zprávu znovu. 5. Služba obdržela zprávu a je možno odeslat chybovou zprávu klientovi. Selže-li převzetí zprávy službou z důvodů chyby přijímající aplikace, je klientovi zaslána chybová zpráva SOAP s chybovým kódem Server.Program. Příchozí zpráva je odmítnuta jako celek. Selže-li převzetí zprávy službou z důvodů chyby ve zprávě, je klientovi zaslána chybová zpráva SOAP s chybovým kódem Client.General. Příchozí zpráva je odmítnuta jako celek. 6. Obálka SOAP je načtena parserem. Selže-li parsování zprávy službou z důvodů chyby přijímající aplikace, je klientovi zaslána chybová zpráva SOAP s chybovým kódem Server.Program. Příchozí zpráva je odmítnuta jako celek. Selže-li parsování zprávy službou z důvodů porušení pravidla správného formátování, je klientovi zaslána chybová zpráva SOAP s chybovým kódem Client.WellFormedness. Příchozí zpráva je odmítnuta jako celek. Selže-li parsování zprávy službou z důvodů porušení pravidla verze jmenného prostoru SOAP, je klientovi zaslána chybová zpráva SOAP s chybovým kódem VersionMismatch. Příchozí zpráva je odmítnuta jako celek 7. Služba ověří, zda zpráva v SOAP hlavičce obsahuje korektní adresu služby v elementu <endpoints><to> Pokud adresa neodpovídá adrese služby je klientovi zaslána chybová zpráva SOAP s chybovým kódem Client.General. 8. Jsou ověřeny identifikační údaje v obálce SOAP. Selže-li tento krok z důvodů chyby přijímající aplikace, je klientovi zaslána chybová zpráva SOAP s chybovým kódem Server.Program. Příchozí zpráva je odmítnuta jako celek. Jedná-li se o opakovanou zprávu (se stejným UUID) a tato zpráva již byla úspěšně přijata, je zpráva odmítnuta. Klientovi zaslána chybová zpráva SOAP s chybovým kódem Client.RepeatedMessage 9. Služba ověří elementy zprávy, které mají být podepsány Pokud zpráva nemá podepsány požadované elementy je klientovi zaslána chybová zpráva SOAP s chybovým kódem Client.Signature. 10. Služba ověří, zda zpráva obsahuje požadavek o zaslání zprávy o zpracování Pokud zpráva neobsahuje požadovaný element je klientovi zaslána chybová zpráva SOAP s chybovým kódem Client.General. 11. Zpráva je přijata Pokud je zpráva službou přijata klient je o tom vyrozuměn zprávou o přijetí, pokud ji požaduje. Přijatá zpráva je zařazena do fronty požadavků a čeká na okamžik zpracování. 12. Je ověřen elektronický podpis zprávy Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012 25

Selže-li ověření elektronického podpisu z důvodu chyby aplikace, je klientovi zaslána chybová zpráva SOAP s chybovým kódem Server.Program. Příchozí zpráva je odmítnuta jako celek. Selže-li ověření podpisu zprávy, je klientovi zaslána chybová zpráva SOAP s chybovým kódem Client.Signature. Příchozí zpráva je odmítnuta jako celek. 13. Zpráva je validována proti schématu a také (je-li deklarována) validační XSLT šabloně. Selže-li tento krok z důvodů chyby přijímající aplikace, je klientovi zaslána chybová zpráva SOAP s chybovým kódem Server.Program. Příchozí zpráva je odmítnuta jako celek. Selže-li tento krok z důvodů chyby validace schématem, je klientovi zaslána chybová zpráva SOAP s chybovým kódem Client.Validity.Schema. Příchozí zpráva je odmítnuta jako celek. Selže-li tento krok z důvodů chyby validace XSLT šablonou, je klientovi zaslána chybová zpráva SOAP s chybovým kódem Client.Validity.XSLT. V tomto případě je chybový výpis XSLT šablony vložen do elementu <Detail> elementu <Fault>. Příchozí zpráva je odmítnuta jako celek. 14. Zpráva je zpracována IS CEDR a je vygenerována odpověď. Selže-li tento krok z důvodů chyby přijímající aplikace, je klientovi zaslána chybová zpráva SOAP s chybovým kódem Server.Program. Příchozí zpráva je odmítnuta jako celek. 15. Klientovi je zaslána standardní zpráva SOAP s odpovědí. 16. Pokud klient neobdrží zprávu o zpracování nebo doručení do doby expirace. Zpráva je považována za nedoručenou a klient může zprávu se stejným identifikátorem opětovně zaslat na službu. Chování odesílající strany v případě komplikací s přenosem se nemusí řídit žádnou předem stanovenou logikou. Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012 26

6. Seznam změn v dokumentu od poslední verze 07.10.2011 1. Upravena adresa služby CiselnikyPozadavek201@cedr.mfcr.cz 2. Upraven rozsah položek: a. Číslo paragrafu rozpočtové skladby b. Číslo položky rozpočtové skladby c. Číslo ukazatele státního rozpočtu d. Kód kapitoly státního rozpočtu e. Kód účelového znaku f. Kód dotačního titulu g. Název právní formy 3. Upravena schémata 14.9.2012 1. Přechod na číselníky RUIAN Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012 27

7. Přílohy 7.1 Adresa služby 7.1.1 Verze 2.0.2 CiselnikyPozadavek202@cedr.mfcr.cz 7.2 WSDL Pro službu na generování číselníků je popis služby WSDL 7.2.1 Verze 2.0.2 7.2.1.1 Umístění http://cedr.mfcr.cz/smtp/ciselnikypozadavek_202/wsdl/service.wsdl 7.3 Schémata 7.3.1 ciselnikypozadavek.xsd Pro zprávu s požadavkem na vygenerování číselníků jsou schemata 7.3.1.1 Verze 2.0.2 7.3.1.1.1 Umístění Pro zprávu s požadavkem na vygenerování číselníků jsou schemata umístěna na : http://cedr.mfcr.cz/ciselniky_xml/schemas/ciselnikypozadavek/v_2.0.2/ciselnikypozadavek.xsd 7.3.2 ciselniky.xsd Pro zprávu s odpovědí na generování číselníků jsou schemata 7.3.2.1 Verze 2.0.2 7.3.2.1.1 Umístění http://cedr.mfcr.cz/ciselniky_xml/schemas/ciselniky/v_2.0.2/ciselniky.xsd 7.3.3 ciselnikydatatypes.xsd Pro schemata datových typů pro odpověď na vygenerování číselníků jsou schemata 7.3.3.1 Verze 2.0.2 7.3.3.1.1 Umístění http://cedr.mfcr.cz/ciselniky_xml/schemas/ciselniky/v_2.0.2/ciselniky.xsd 7.3.4 error_list.xsd Pro chybové hlášky jsou schemata 7.3.4.1 Verze 1.0.0 7.3.4.1.1 Umístění Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012 28

http://cedr.mfcr.cz/errorlist_xml/schemas/errorlist/v_1.0.0/error_list.xsd 7.4 XSLT validační šablony 7.4.1 xsltvalidationciselnikypozadavek.xsl XSLT validační šablona pro kontrolu požadavku na vygenerování číselníků 7.4.1.1 Verze 2.0.2 7.4.1.1.1 Umístění http://cedr.mfcr.cz/ciselniky_xml/xslt/v_2.0.2/xsltvalidation.xsl 7.5 Dokumentace ke službě (RDDL) 7.5.1 Verze 201 http://cedr.mfcr.cz/smtp/ciselnikypozadavek_202/documentation/default.htm 7.6 Příklady zpráv 7.6.1 Požadavek na vygenerování číselníků <?xml version="1.0" encoding="utf-8"?> <SOAP-ENV:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"> <SOAP-ENV:Header> <eps:endpoints xmlns:eps="http://schemas.biztalk.org/btf-2-0/endpoints" SOAP-ENV:mustUnderstand="1" Id="idEndpoints"> <eps:to> <eps:address>ciselnikypozadavek202@cedr.mfcr.cz</eps:address> </eps:to> <eps:from> <eps:address>silar@asd-software.cz</eps:address> </eps:from> </eps:endpoints> <prop:properties SOAP-ENV:mustUnderstand="1" xmlns:prop="http://schemas.biztalk.org/btf-2-0/properties" Id="idProperties"> <prop:identity>6f82580a-fd41-47c8-a6e8-0ede5eff903d</prop:identity> <prop:sentat>2004-05-17t14:41:36</prop:sentat> <prop:expiresat>2004-05-19t14:41:36</prop:expiresat> <prop:topic/> </prop:properties> <srv:services xmlns:srv="http://schemas.biztalk.org/btf-2-0/services" SOAP-ENV:mustUnderstand="1" Id="idServices"> <srv:commitmentreceiptrequest> <srv:sendto> <srv:address>silar@asd-software.cz</srv:address> </srv:sendto> <srv:sendby>2004-05-19t14:41:36</srv:sendby> </srv:commitmentreceiptrequest> <srv:deliveryreceiptrequest> <srv:sendto> <srv:address>silar@asd-software.cz</srv:address> </srv:sendto> <srv:sendby>2004-05-19t14:41:36</srv:sendby> </srv:deliveryreceiptrequest> </srv:services> <dsig:signature xmlns:dsig="http://www.w3.org/2000/09/xmldsig#" Id="idSignature"> <dsig:signedinfo> <dsig:canonicalizationmethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n- 20010315"/> <dsig:signaturemethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/> <dsig:reference URI="#idEndpoints"> <dsig:transforms> Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 2.02 ze dne 20.09.2012 29