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

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.2007, verze 1.07

Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR Počet stran v dokumentu celkem : 35 Rozdělovník : Číslo Počet výtisků Předáno Převzal 1. 1 x MF, odbor 38 Ing. Hana Domínová Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.09.2007

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 8 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 9 3.6.1 Integrita přenosu dat 9 3.6.2 Požadavek o zaslání číselníků 9 3.7 Pojmenovávací konvence 9 3.8 Zpracování chyb 9 3.8.1 Chyby na úrovni přenosového protokolu SMTP 9 3.8.2 Chyby při načtení zprávy SOAP 9 3.8.3 Chyby vzniklé exspirací zprávy 10 3.8.4 Chyba neoprávněného přístupu 10 3.8.5 Chyby na úrovni ověření digitálního podpisu 10 3.8.6 Chyby na úrovni validace pomocí XML Schema 10 3.8.7 Chyby na úrovni validace XSLT šablonou 10 3.8.8 Chyby na aplikační úrovni 10 4. Popis předávaných dat 11 4.1 Ustanovení pro definici platnosti elementů 11 4.2 Služba na vygenerování číselníků 11 4.2.1 Požadavek na vygenerování číselníků 11 4.2.1.1 Datové typy 11 4.2.1.2 Popis schémat 11 4.2.1.3 Zpráva s požadavkem na generování číselníků z IS CEDR III 11 4.2.1.4 Obsah Požadavku na generování číselníků 12 Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 2

4.2.1.5 Validace 12 4.2.1.5.1 Kontroly XSLT 12 4.2.1.5.2 Kontroly aplikační 12 4.2.2 Odpověď na požadavek o vygenerování číselníků 13 4.2.2.1 Datové typy 13 4.2.2.2 Popis schémat 13 4.2.2.3 Zpráva s číselníky z IS CEDR III 13 4.2.2.4 Dávka dat s číselníky 13 4.2.2.4.1 Struktura číselníku právních forem 15 4.2.2.4.2 Struktura číselníku kapitol SR 15 4.2.2.4.3 Struktura číselníku ukazatelů SR 16 4.2.2.4.4 Struktura číselníku paragrafů rozpočtové skladby 16 4.2.2.4.5 Struktura číselníku položek rozpočtové skladby 16 4.2.2.4.6 Struktura číselníku dotačních titulů 17 4.2.2.4.7 Struktura číselníku zemí 18 4.2.2.4.8 Struktura číselníku bank 18 4.2.2.4.9 Struktura číselníku zdrojů finančních prostředků. 19 4.2.2.4.10 Struktura číselníku agentur 19 4.2.2.4.11 Struktura číselníku poskytovatelů 20 4.2.2.4.12 Struktura číselníku členění finančních prostředků 20 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 21 4.2.2.4.15 Struktura číselníku operačních programů 21 5. Podrobný popis životního cyklu zprávy 22 6. Seznam změn v dokumentu od poslední verze 26 7. Přílohy 27 7.1 Adresa služby 27 7.1.1 Verze 1.1.1 27 7.2 WSDL 27 7.2.1 Verze 1.1.1 27 7.2.1.1 Umístění 27 7.3 Schémata 27 7.3.1 ciselnikypozadavek.xsd 27 7.3.1.1 Verze 1.1.1 27 7.3.1.1.1 Umístění 27 7.3.2 ciselniky.xsd 27 7.3.2.1 Verze 1.1.0 27 7.3.2.1.1 Umístění 27 7.3.3 ciselnikydatatypes.xsd 27 7.3.3.1 Verze 1.0.1 27 7.3.3.1.1 Umístění 27 7.3.4 error_list.xsd 27 7.3.4.1 Verze 1.0.0 28 7.3.4.1.1 Umístění 28 7.4 XSLT validační šablony 28 7.4.1 xsltvalidationciselnikypozadavek.xsl 28 7.4.1.1 Verze 1.1.1 28 7.4.1.1.1 Umístění 28 7.5 Příklady zpráv 28 Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 3

7.5.1 Požadavek na vygenerování číselníků 28 7.5.2 Odpověď na požadavek 30 8. Reference 33 9. Seznam použitých zkratek a pojmů 34 Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 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 1.07 ze dne 20.9.2007 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 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 1.07 ze dne 20.9.2007 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], kap. 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 error_list.xsd. 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í. Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 7

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 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 3.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 error_list.xsd. 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 error_list.xsd. 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 WSDL. Soubor WSDL bude obsahovat dokumentaci, kdy formát RDF dokumentace bude odpovídat [3], kap. 5.1.3.1. Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 8

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). 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 Pojmenovávací konvence RDDL soubory, umístěné na URL XXX 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. 3.8 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 error_list.xsd. 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.8.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. 3.8.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. Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 9

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.8.3 Chyby vzniklé exspirací zprávy Tento typ chyb bude ignorován. 3.8.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.8.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.8.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. ErrorText Dokument není validní. 3.8.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.8.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 1.07 ze dne 20.9.2007 10

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. ciselníkypozadavek.xsd) 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 ciselníkypozadavek.xsd. 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 1.07 ze dne 20.9.2007 11

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 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 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 ciselníkypozadavek.xsd 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 ciselníkypozadavek.xsd. 4.2.1.5.1 Kontroly XSLT Dodatečné kontroly pomocí XSLT šablony v rámci žádosti o číselníky jsou definovány xsltvalidationciselnikypozadavek.xsl. 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 1.07 ze dne 20.9.2007 12

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 ciselnikydatatypes.xml viz. příloha 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 ciselníky.xsd 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 MF ČR zprovozněna Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 13

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ě 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 3.07 jsou číselníky územní identifikace (ÚIR - MMR) nahrazeny číselníky ÚIR - ADR, celostátním standardem pro územní identifikaci. Čí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Ú. Garanty číselníků ÚIR - ADR je MPSV a jejich struktura odpovídá Standardu ISVS k prostorové identifikaci, verze 4.2 vydané ÚVIS.Vzhledem k tomu, že obsah číselníků a změnové soubory těchto číselníku jsou veřejně přístupné (www.mpsv.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 MPSV je v příloze č. 2 Popis dat ÚIR - ADR 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 Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 14

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 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 číselníku 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 1 P Kód formy příjemce dotace N 3 PP 2 Typ formy N 1 PP 3 Zkrácený název formy příjemce dotace AN 3 PP 4 Úplný název formy příjemce dotace AN 30 PP 5 P Platnost od D 10 PP 6 Platnost do D 10 NP 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 1 P Kód kapitoly SR N 3 PP 2 Název kapitoly AN 80 PP Popis jednotlivých řádků: Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 15

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 Čí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 1 P Kód kapitoly SR N 3 PP 2 P Kód ukazatele SR AN 4 PP 3 Název ukazatele SR AN 80 PP 4 Kód nadřazeného ukazatele SR AN 4 NP 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 1 P Kód paragrafu RS N 4 PP 2 Název paragrafu RS AN 50 PP 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 1 P Kód položky RS N 4 PP 2 Název položky RS AN 50 PP Popis jednotlivých řádků: Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 16

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ů Čí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 MF ČR 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 1 P Kód dotačního titulu N 10 PP 2 Vlastní kód dotačního titulu resortu AN 30 NP 3 Název dotačního titulu AN 160 PP 4 Zkrácený název dotačního titulu AN 50 PP 5 Kód ukazatele SR AN 4 PP 6 Platnost od D 10 PP 7 Platnost do D 10 NP 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 MF 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 1 P Kód dotačního titulu N 10 PP 2 P Kód položky RS N 4 PP Popis jednotlivých řádků: 1 Kód dotačního titulu Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 17

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ů. 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 1 P Kód dotačního titulu N 10 PP 2 P Kód paragrafu RS N 4 PP 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 1 P Třímístný alfabetický kód AN 3 PP 2 P Platnost od D 8 P 3 Platnost do D 8 NP 4 Dvoumístný alfabetický kód AN 2 PP 5 Třímístný numerický kód N 3 PP 6 Plný název v češtině AN 80 PP 7 Zkrácený název v češtině AN 50 PP 8 Plný název v angličtině AN 80 NP 9 Zkrácený název v angličtině AN 50 NP 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 Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 18

Čí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 1 P Kód banky N 4 PP 2 KodBankaSWIFT AN 8 NP 3 P Platnost od D 8 PP 4 Platnost do D 8 NP 5 Název banky AN 80 PP 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 1. P Kód zdroje finančních prostředků AN 20 PP 2. Název zdroje finančních prostředků AN 80 PP 3. Platnost od D 8 PP 4. Platnost do D 8 NP 5. Kód nadřízeného zdroje finančních prostředků AN 20 NP 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 1. P Kód agentury AN 38 PP 2. P Číslo agentury N 2 PP 3. Kód nadřízené agentury AN 38 NP Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 19

4. Název agentury AN 50 PP 5. Platnost od D 8 PP 6. Platnost do D 8 NP Popis jednotlivých řádků: 1. Kód agentury jednoznačný identifikátor. 2. Číslo agentury rozlišuje dílčí zasilatele dat 3. Kód nadřízené agentury vytváří stromovou strukturu agentur. 4. Název agentury. 5. Datum začátku platnosti daného záznamu. 6. 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 1. P Kód poskytovatele N 3 PP 2. Kód nadřízeného poskytovatele N 3 NP 3. Název poskytovatele AN 255 PP 4. Platnost od D 8 PP 5. Platnost do D 8 NP 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 1. P Kód členění finančních prostředků N 3 PP 2. Název členění finančních prostředků AN 255 PP 3. Platnost od D 8 PP 4. Platnost do D 8 NP 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. Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 20

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 1. P Kód měrné jednotky AN 5 PP 2. Alfabetický mezinárodní kód měrné jednoty AN 3 NP 3. Měrná jednotka název AN 512 PP 4. Měrná jednotka zkrácený název AN 128 NP 5. Značka měrné jednotky AN 128 NP 6. Platnost od D 8 PP 7. Platnost do D 8 NP 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] Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 21

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 1.07 ze dne 20.9.2007 22

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 1.07 ze dne 20.9.2007 23

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. 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í. Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 24

12. Je ověřen elektronický podpis zprávy 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í. 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 1.07 ze dne 20.9.2007 25

6. Seznam změn v dokumentu od poslední verze 21.12.2004 1. Přídán číselník psokytovatelů viz. 4.2.2.4.11 2. Přídán číselník členění finančních prostředků viz. 4.2.2.4.12 3. Uprevena schemata dotazu viz. 7.3.1.1 4. Uprevena schemata odpovědi viz. 7.3.2.1 14.02.2005 1. Úprava kapitoly 4.2.2.4 2. Rozšíření číselníku bank o mezinárodní kód SWIFT viz. 4.2.2.4.8 3. Přidán číselník vybranch měrných jednotek viz. 4.2.2.4.13 4. Úprava příkladů viz. 7.5.1 a 7.5.2 22.02.2005 1. Upraven popis číselníku zdrojů finančních prostředků viz. 4.2.2.4.9 2. Upraven popis číselníku poskytovatelů viz. 4.2.2.4.11 3. Upraven rozsah položek číselníků dle schématu XSD. 14.02.2006 1. Změněny názvy číselníku viz. 4.2.1.4 20.09.2007 1. Přidána kapitola s popisem číselníku operačních programů 4.2.2.4.15 2. Přidána kapitola s popisem číselníku grantových schémat 4.2.2.4.14 3. Přidán odkaz na dokumentaci s popisem rozhraní pro příjem dat do IS CEDR III. Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 26

7. Přílohy 7.1 Adresa služby 7.1.1 Verze 1.1.2 CiselnikyPozadavek112@cedr.mfcr.cz 7.2 WSDL Pro službu na generování číselníků je popis služby WSDL 7.2.1 Verze 1.1.2 7.2.1.1 Umístění http://cedr.mfcr.cz/smtp/ciselniky_xml/v_1.1.2/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 1.1.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_1.1.1/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 1.1.0 7.3.2.1.1 Umístění http://cedr.mfcr.cz/ciselniky_xml/schemas/ciselniky/v_1.1.0/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 1.0.1 7.3.3.1.1 Umístění http://cedr.mfcr.cz/ciselniky_xml/schemas/ciselniky/v_1.0.1/ciselniky.xsd 7.3.4 error_list.xsd Pro chybové hlášky jsou schemata Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 27

7.3.4.1 Verze 1.0.0 7.3.4.1.1 Umístění 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 1.1.1 7.4.1.1.1 Umístění http://cedr.mfcr.cz/ciselniky_xml/xslt/v_1.1.1/xsltvalidation.xsl 7.5 Příklady zpráv 7.5.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>ciselnikypozadavek112@wnts_test.asd-software.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> <dsig:transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n- 20010315"/> Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 28

20010315"/> 20010315"/> 20010315"/> </dsig:transforms> <dsig:digestmethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/> <dsig:digestvalue>sfs6ghsyfjkcmdxznljullkbuqk=</dsig:digestvalue> </dsig:reference> <dsig:reference URI="#idProperties"> <dsig:transforms> <dsig:transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n- </dsig:transforms> <dsig:digestmethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/> <dsig:digestvalue>0oqil/rdi/lz9ssxajakuefipya=</dsig:digestvalue> </dsig:reference> <dsig:reference URI="#idServices"> <dsig:transforms> <dsig:transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n- </dsig:transforms> <dsig:digestmethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/> <dsig:digestvalue>f6a/9wxni8n8nhumwwnn2te/9l8=</dsig:digestvalue> </dsig:reference> <dsig:reference URI="#idBody"> <dsig:transforms> <dsig:transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n- </dsig:transforms> <dsig:digestmethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/> <dsig:digestvalue>snnb28dhmmpssrex3l3hj7qa0vq=</dsig:digestvalue> </dsig:reference> </dsig:signedinfo> <dsig:signaturevalue>exoppk3n36gunx5penxi+sdcn1ruztq7nvikckxeu4xmj6iwbh53wt6ni/smqp2faljikn10fupc/cq Y5N3Q==</dsig:SignatureValue> <dsig:keyinfo> <dsig:x509data> <dsig:x509issuerserial> <dsig:x509issuername>c=cz, L=SU, O=ASD Software, CN=ASDCertif5</dsig:X509IssuerName> <dsig:x509serialnumber>7356f7710000000000e7</dsig:x509serialnumber> </dsig:x509issuerserial> <dsig:x509subjectname>c=cz, L=SU, O=ASD Software, CN=asd512</dsig:X509SubjectName> <dsig:x509certificate>miic/jccaqigawibagikc1b3cqaaaaaa5zanbgkqhkig9w0baqufadbgmqswcqydvqqgewjdwj ELUEBxMCU1UxFTATBgNVBAoTDEFTRCBTb2Z0d2FyZTETMBEGA1UEAxMKQVNEQ2VydGlmNTAwMzA4MTIxMTU0MThaFw0wN DA4MTIxMjA0MThaMEIxCzAJBgNVBAYTAkNaMQswCQYDVQQHEwUEChMMQVNEIFNvZnR3YXJlMQ8wDQYDVQQDEwZhc2Q1MT IwXDANBgkqhkiG9w0BAM9HXXlt9oBJg5s0LARiAZRIXsqwGdLeLWZ9/FCJAMybaq/aKu/14KDTqfQGgl7zD03Vx5vPN+43UA5CQIDAQ ABo4IBejCCAXYwDgYDVR0PAQH/BAQDAgTwMBMGA1UdJQQGA1UdDgQWBBSrBjT1fUzNd6RNTZMHedKnCE76qzB9BgNVHSME djb0gbwx5g3knnuyqfjjkncqfkpegwrjelmakga1uebhmcq1oxczajbgnvbactalnvmruweqgu29mdhdhcmuxezarbgnvbam TCkFTRENlcnRpZjWCEG0ux9C6mI6vTw0iqgvlfBEAwPjA8oDqgOIY2aHR0cDovL3dudHM1LmFzZC1zb2Z0d2FyZS5jei9DZXJ0RW5xsL 0FTRENlcnRpZjUuY3JsMGgGCCsGAQUFBwEBBFwwWjBYBggrBgEFBQcwAoZMaHR0cDovL3LmFzZC1zb2Z0d2FyZS5jei9DZXJ0R W5yb2xsL3dudHM1LmFzZC1zb2Z0d2FyZS5jel9BU RDZXJ0aWY1LmNydDANBgkqhkiG9w0BAQUFAANBABuELGkUVGnUSw8XQhwWVLaRypyJ8pjDTXmIC9E+zRSXxZNMHKhWg7IqnJ xwkgqsib12gqfpophe/mo=</dsig:x509certificate> </dsig:x509data> </dsig:keyinfo> </dsig:signature> </SOAP-ENV:Header> <SOAP-ENV:Body Id="idBody"> <ciselnikypozadavek xmlns="urn:cz:isvs:mfcr:schema:ciselnikypozadavek:v111" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="urn:cz:isvs:mfcr:schema:ciselnikypozadavek:v111 http://serverschema/ciselniky_xml/schemas/ciselnikypozadavek/v_1.1.1/ciselnikypozadavek.xsd" vazby="true" validation_xslt="http://serverschema/ciselniky_xml/xslt/v_1.1.1/xsltvalidation.xsl"> <Ciselnik> <JmenoCiselniku>Agentury</JmenoCiselniku> </Ciselnik> </ciselnikypozadavek> </SOAP-ENV:Body> </SOAP-ENV:Envelope> Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 29