Specifikace služby IS CEDR pro poskytování informací z IS CEDR III, veřejná část

Podobné dokumenty
Specifikace http služby IS CEDR pro poskytování dokumentů z IS CEDR II

Základní zadání IS o ISVS. Sluţba poskytování dat IS o ISVS

l Kontakt s klientem SSP Popis automatizované komunikace s ÚP ČR v součinnosti a exekuci

Specifikace služby IS CEDR pro příjem dat obecným XML rozhraním IS CEDR III

Provozní dokumentace. Seznam datových schránek. Datové soubory. Vytvořeno dne: Aktualizováno: Verze: 1.

IS SDSL Dálkový způsob ověření totožnosti a věku osoby žádající o registraci Praha, Martin Prem

Popis B2B rozhraní pro elektronickou neschopenku

PODMÍNKY POSKYTOVÁNÍ PŘÍSTUPU K PORTÁLU NAMĚŘENÝCH DAT POMOCÍ WEBOVÝCH SLUŽEB SPOLEČNOSTI ČEZ DISTRIBUCE, A. S.

Funkční specifikace ABOKWS. Aplikační rozhraní elektronického bankovnictví ABO-K. Verze 0.5

Specifikace rozhraní. Oznamovací povinnost podle zákona č. 307/2013 Sb., ve znění pozdějších předpisů. Martin Falc, SW architekt.

l Kontakt s klientem SSP Popis automatizované komunikace s ÚP ČR v součinnosti a exekuci

Návrh funkcí webových služeb (WS) pro komunikaci mezi Informačním systémem datových schránek (ISDS) a spisovými službami (SS)

Požadavky pro výběrová řízení TerraBus ESB/G2x

Verze dokumentu 0.1 duben 2016

Chybová hlášení METODIKA MET-01/2014. SZR-56-1/OPICT-2013 počet stran 28 přílohy 0. Nahrazuje:

Úvod do Web Services

Popis egon služby. E93 - roszapispravnistav. Název dokumentu: Popis egon služeb Verze: Datum aktualizace: Správa základních registrů

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

TECHNICKÁ SPECIFIKACE VEŘEJNÉ ZAKÁZKY

ZZVDPN20 v1.0 Žádost o změnu způsobu výplaty při DPN

Roční periodická zpráva projektu

Národní elektronický nástroj. Import profilu zadavatele do NEN

UŽIVATELSKÁ PŘÍRUČKA K INTERNETOVÉ VERZI REGISTRU SČÍTACÍCH OBVODŮ A BUDOV (irso 4.x) VERZE 1.0

Provozní dokumentace. Seznam orgánů veřejné moci. Datové soubory. Vytvořeno dne: Aktualizováno: Verze: 1.

Referenční rozhraní. Jiří Kosek. Ministerstvo informatiky ČR. ISSS 25. března 2003

1. Webové služby. K čemu slouží? 2. RPC Web Service. 3. SOA Web Service. 4. RESTful Web services

Zákaznická SW řešení Obecný úvod

Referenční rozhraní národního konektoru Národního kontaktního místa pro ehealth úloha pacientský souhrn

Nastavení provozního prostředí webového prohlížeče pro aplikaci

ERP-001, verze 2_10, platnost od

Klientský formát POHLEDÁVKY platný od

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

Dokumentace k nevizuálnímu rozhraní aplikace DopisOnline

JAK ČÍST ZÁZNAM O VYUŽÍVÁNÍ ÚDAJŮ V REGISTRU OBYVATEL

Technická specifikace Platební brána IBS

Popis egon služby. E23 - roszapisdatovouschranku. Název dokumentu: Popis egon služeb Verze: Datum aktualizace: Správa základních registrů

Národní elektronický nástroj. Technická specifikace rozhraní pro IEN

Klientský formát POHLEDÁVKY podporovaný v KB platný od

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

Spisová agenda. Popis komunikačního rozhraní. Autor analýzy: Zadavatel: ver.: TranSoft a.s Vrbenská České Budějovice

Zrušení profilu zadavatele

8.2 Používání a tvorba databází

INFORMAČNÍ LETÁK Účinný od 1. ledna 2012 Platný pro klienty CitiBusiness

Michal Krátký, Miroslav Beneš

Protokol o atestačním řízení

Obecné importní rozhraní DotInfo EDS pro externí informační systémy. verze 1.7

Standardní lhůty pro doručení odchozího platebního příkazu. Standardní lhůty a způsob zpracování příchozího platebního příkazu

Pokročilé Webové služby a Caché security. Š. Havlíček

Centrální evidence přeplatků a nedoplatků

1 Webový server, instalace PHP a MySQL 13

Průzkumník IS DP. Návod k obsluze informačního systému o datových prvcích (IS DP) vypracovala společnost ASD Software, s. r. o.

ADIS Opt-Out rozhraní na okolní systémy. Technický popis rozhraní s pojišťovnami

1 Pro účely této vyhlášky se rozumí a) základnovou stanicí základnová stanice veřejné komunikační sítě,

Souhrn oznámení o zadání zakázek na základě rámcové smlouvy

Specifikace požadavků. POHODA Web Interface. Verze 1.0. Datum: Autor: Ondřej Šrámek

Příloha č. 1 Smlouvy o spolupráci B2B rozhraní VZP ČR

Příloha: Dodatečné informace, včetně přesného znění žádosti dodavatele o dodatečné informace

INFORMAČNÍ LETÁK Účinný od 1. června 2010 Platný pro klienty CitiBusiness

Registr Osob. zveřejněno podepsáno

Michal Kolařík ISZR - Brána k základním registrům

Profilová část maturitní zkoušky 2017/2018

Studium protokolu Session Decription Protocol. Jaroslav Vilč

Tvorba informačních systémů

Modul Kontakt s klientem SSP. OKcentrum. Uživatelská příručka. Poskytování součinnosti ÚP ČR

Popis egon služby E38 - ruianctiseznamzmen

mbank.cz mtransfer Okamžitá notifikace o mtransferu Dokumentace pro externího partnera

VYHLÁŠKA. ze dne 20. dubna o uveřejňování vyhlášení pro účely zákona o veřejných zakázkách a náležitostech profilu zadavatele

Katalog egon služeb verze: 0.01

Popis egon služby. E164 - iszrprobe. Název dokumentu: Popis egon služeb Verze: Datum aktualizace: Správa základních registrů

Technická specifikace struktury ABO formátu UHL1 DATOVÝ SOUBOR

Platební systém XPAY [

KSRZIS. Postup kroků nutných pro napojení nemocničního informačního systému s registrem NSHNU v prostředí registrů resortu zdravotnictví

Specifika a scénáře vykazování dat AnaCredit prostřednictvím systému MtS-ISL-SÚD-SDNS

Technická dokumentace B2C WS postcode

Příloha číslo 6 - Technický popis řešení poukazování hotovostních plateb vybraných druhů daní

Modul IRZ návod k použití

Popis egon služby. E36 - ruianctiadresu. Název dokumentu: Popis egon služeb Verze: Datum aktualizace: Správa základních registrů

Specifikace služby RVI_NOU01B

TRANSPORTY výbušnin (TranV)

Popis egon služby. E17 - rospridelicp. Název dokumentu: Popis egon služeb Verze: Datum aktualizace: Správa základních registrů

Výtisk č.: Počet listů 9. Přílohy: 0 ÚZIS ČR

Oznámení profilu Zadavatele

1. Webový server, instalace PHP a MySQL 13

Komunikační protokol PŘÍJMOVÁ AGENDA

B2B SOAP - popis funkcionality

Popis webové služby pro sledování změn údajů o nemovitostech

Výtisk č.: Počet listů 12. Přílohy: 0 ÚZIS ČR. Příručka pro aktivaci účtu

Systém elektronického bankovnictví GEMINI 5. Napojení na účetní systémy popis exportních / importních souborů. Verze 1.1

POPIS TECHNICKÉHO ŘEŠENÍ INFORMAČNÍHO SYSTÉMU PRO SBĚR DAT V PROJEKTU SLEDOVÁNÍ DEKUBITŮ JAKO INDIKÁTORU KVALITY OŠETŘOVATELSKÉ PÉČE NA NÁRODNÍ ÚROVNI

NAHLAŠOVÁNÍ UBYTOVANÝCH CIZINCŮ PŘES PORTÁL UBYPORT

PODMÍNKY POSKYTOVÁNÍ PŘÍSTUPU K PORTÁLU NAMĚŘENÝCH DAT POMOCÍ WEBOVÝCH SLUŽEB SPOLEČNOSTI ČEZ DISTRIBUCE, A. S.

Popis egon služby. E37 - ruianvyhledejadresu. Název dokumentu: Popis egon služeb Verze: Datum aktualizace: Správa základních registrů

DOKUMENTACE ROZHRANÍ

SPRÁVA ZÁKLADNÍCH REGISTRŮ PODMÍNKY PRO PŘIPOJENÍ AGENDOVÝCH INFORMAČNÍCH SYSTÉMŮ DO ISZR. verze 2.00

Webové služby DPD. Verze

Oznámení na profilu kupujícího

Transkript:

PRO INTERNÍ POTŘEBU Specifikace služby IS CEDR pro poskytování informací z IS CEDR III, veřejná část vypracovala společnost ASD Software, s.r.o. dokument ze dne 21.11.2006, verze 1.00

Specifikace služby IS CEDR pro poskytování informací z IS CEDR III, veřejná část Počet stran v dokumentu celkem : 22 Rozdělovník : Číslo Počet výtisků Předáno Převzal 1 1 x MF, odbor 38 Ing. Hana Domínová Copyright ASD Software, s.r.o., 2002-2006 2

OBSAH 1. ÚVOD...5 2. USE-CASE STUDIE...6 3. TECHNICKÉ ŘEŠENÍ...7 3.1 PŘENOSOVÝ FORMÁT DAT...7 3.2 VALIDACE A POPIS XML DOKUMENTŮ...7 3.2.1 XML Schema...7 3.2.2 Jmenné prostory...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...7 3.4 MODEL PŘENOSU ZPRÁV...7 3.5 POPIS SLUŽBY VE FORMÁTU WSDL...7 3.6 ŘEŠENÍ BEZPEČNOSTI...7 3.7 ZPRACOVÁNÍ CHYB...8 3.7.1 Chyby na úrovni přenosového protokolu HTTP...8 3.7.2 Chyby při načtení zprávy SOAP...8 3.7.3 Chyby vzniklé exspirací zprávy...8 3.7.4 Chyby na úrovni validace pomocí XML Schema...8 3.7.5 Chyby na úrovni aplikační...8 4. POPIS PŘEDÁVANÝCH DAT...9 4.1 USTANOVENÍ PRO DEFINICI PLATNOSTI ELEMENTŮ...9 4.2 PŘEDÁVÁNÍ INFORMACÍ Z IS CEDR III...9 4.2.1 Popis schémat...9 4.3 SLUŽBA POSKYTUJÍCÍ VEŘEJNÉ ÚDAJE...9 4.3.1 Dotaz na veřejné údaje...9 4.3.1.1 Atributy dotazu...10 4.3.1.2 Atribut pole ObchodníJmeno...10 4.3.2 Odpověď na veřejné údaje...11 4.3.2.1 PříjemceDotace - identifikace subjektu...11 4.3.2.2 Obchodní jména...12 4.3.2.3 Adresa sídla subjektu...12 4.3.2.4 Adresa kódy...12 4.3.2.5 Objekt číslo domovní...13 4.3.2.6 Adresa text...13 4.3.2.7 Projekt...14 4.3.2.8 Finanční částky zdroj...14 4.3.2.9 Atributy odpovědi...15 4.3.2.10 Finanční částka období...15 4.3.2.11 Částky uvolněné...15 4.3.2.12 Platba...16 4.3.2.13 Částky čerpané...16 4.3.2.14 Částky vrácené...16 4.3.2.15 Kalendář splátek...16 4.3.2.16 Splátky plánované...17 4.3.2.17 Splátky skutečné...17 Copyright ASD Software, s.r.o., 2002-2006 3

5. PODROBNÝ POPIS ŽIVOTNÍHO CYKLU ZPRÁV...18 5.1 DOTAZY NA DATABÁZI IS CEDR III...18 6. PŘÍLOHY...20 6.1 ADRESA SLUŽBY...20 6.2 STRUKTURA XMLSCHEMA PRO VEŘEJNÝ DOTAZ...20 6.3 STRUKTURA XMLSCHEMA PRO ODPOVĚĎ NA VEŘEJNÝ DOTAZ...20 7. REFERENCE...21 8. NÁVRHY PRO DALŠÍ VERZE SLUŽBY...22 Copyright ASD Software, s.r.o., 2002-2006 4

1. Úvod Tato dokumentace obsahuje popis služby IS CEDR, poskytující informace o evidovaných dotacích a příjemcích dotací v IS CEDR III. Tento materiál popisuje automatickou HTTP službu, která na základě předaných požadavků vrací zpět uživateli požadované informace o příjemcích dotací a jejich dotacích ze státního rozpočtu, státních fondů a prostředků EU. Poskytovatelem této služby je Ministerstvo financí, v jehož plné kompetenci je také definice popisované služby. Vlastní řešení je rozděleno na dvě samostatné služby, první poskytuje veřejné informace a je přístupná bez omezení, druhá služba poskytuje komplexní informace a oprávněnost přístupu ke službě se ověřeje certifikátem. V této podobě se jedná o pracovní materiál, od konečné podoby se tento dokument může lišit úpravami, které jsou reakcí na optimální realizaci služeb v tomto dokumentu popsaných. Předpokladem je, že služba bude využívána řadou klientských aplikací; proto jsou zvoleny taková architektonická řešení a technologie, které umožní relativně jednoduché dosažení interoperability (Serviceoriented architektura, XML formát dat, webové služby). Copyright ASD Software, s.r.o., 2002-2006 5

2. Use-case studie Služba na straně IS CEDR bude podporovat možnost vznášení dotazů na uložená data v IS CEDR tak, jak je uvedeno na obr. 1: Dotaz na službu CEDR Zpracování dotazu CEDR Klient služby Odpověď služby CEDR Obr. 1 Dotazy klientů na databázi IS CEDR V tomto případě (obr. 1) probíhají globální procesy následujícícm způsobem: 1. Na straně klienta je vygenerována zpráva, obsahující dotaz na aplikaci IS CEDR III. Spuštění přenosu se děje ad hoc uživatelem; to znamená, že neexistuje časový plán dotazů. 2. Zpráva (dotaz) je opatřena všemi náležitostmi dle této specifikace a je odeslána pomocí protokolu HTTP na adresu aplikace IS CEDR III (bude upřesněna po dokončení realizace služby). Spojení mezi komunikujícími stranami není přerušeno. 3. Aplikace IS CEDR III přijme dotaz a zpracuje jej v souladu s pravidly, stanovenými v této specifikaci. Zpět klientské straně odešle zprávu o výsledku zpracování dotazu. Copyright ASD Software, s.r.o., 2002-2006 6

3. Technické řešení 3.1 Přenosový formát dat Jako formát pro přenos dat bude použit standard XML 1.0, Second Edition [2]. 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 zprávy mají pro účely validace vytvořen popis formátu zprávy dle standardu SAML 2.0 [4]. Validace XML dokumentů dle XML Schema [3] 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. 3.2.2 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.3 Transportní protokoly 3.3.1 Základní transportní protokol Základním transportním protokolem pro popisovanou službu bude protokol HTTP. Komunikace při přenosu zpráv mezi klientem a službou nebude přerušena, dotaz a přenos odpovědi služby ke klientovi proběhne tedy v rámci jednoho spojení. 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 6.1. 3.3.3 SOAP protokol Nad protokolem HTTP bude použit rozšiřující XML protokol SOAP ve verzi 1.1 [1]. Struktura zpráv při použití SOAP protokolu je dána specifikací [4]. 3.4 Model přenosu zpráv Jako model pro přenos zpráv bude použit model request-response. Vzhledem k on-line komunikaci nejsou implementovány informativní zprávy služby. 3.5 Popis služby ve formátu WSDL Služba IS CEDR III, přebírající dotazy, bude popsána ve formátu WSDL. Soubor WSDL bude umístěn na adrese http://cedr.mfcr.cz/ws/cedrinfopublic_v102/service.asmx?wsdl. 3.6 Řešení bezpečnosti Pro veřejnou službu nebudou implementovaný žádné bezpečností prostředky. Copyright ASD Software, s.r.o., 2002-2006 7

3.7 Zpracování chyb Zpracování chyb bude ošetřeno v souladu se zásadami uvedenými ve specifikaci [4] a [5]. 3.7.1 Chyby na úrovni přenosového protokolu HTTP Chyby na úrovni přenosového protokolu HTTP 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.7.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. Na klienta bude odeslána pouze chybová zpráva ve formátu SOAP. 3.7.3 Chyby vzniklé exspirací zprávy Tyto chyby jsou způsobeny vypršením lhůty v elementech WS-security utility v elementu <wsu:timestamp> nebo špatnou synchronizací časů jak na straně serveru tak na straně Agenta. Zpráva je odmítnuta jako celek. Chybová zpráva ve formátu SOAP je odeslána klientovi. Chybový kód je v tomto případě soap:server 3.7.4 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.7.5 Chyby na úrovni aplikační Tyto chyby se týkají např. selhání aplikační databáze CEDR, narušení referenční integrity či primárních klíčů aplikační databáze. Při výskytu chyby na úrovni validace pomocí vnitřní logiky aplikace CEDR bude v této verzi dotaz odmítnut. Chybová zpráva ve formátu SOAP je odeslána zpět klientovi. Obecný chybový kód je v tomto případě soap:server. Copyright ASD Software, s.r.o., 2002-2006 8

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 Předávání informací z IS CEDR III. 4.2.1 Popis schémat Pro veřejnou část služby jsou definována dvě schémata. Jedno schéma je využíváno při dotazu na IS CEDR III a druhé při návratu odpovědi. 4.3 Služba poskytující veřejné údaje Jedná se o webovou službu, která uživateli poskytuje veřejné informace o subjektech a dotacích těchto subjektů evidovaných v IS CEDR III. 4.3.1 Dotaz na veřejné údaje Služba podporuje tři typy dotazů v závislosti na zvoleném klíči pro vyhledávání. Lze zvolit vyhledávání dle ICO nebo obchodního jména nebo dle kombinace jména a příjmení osoby. Pro dotaz na získání kontrolních informací je vytvořeno schéma 6.2, které obsahuje následující datové položky : Poř.č. Jméno položky Typ Node Typ Platnost 1 ICO bus:subjekticotype Element NP* 2 ObchodniJmeno ObchodniJmenoType Element NP* 3 Prijmeni per:osobaprijmenitype Element NP* 4 Jmeno per:osobajmenotype Element NP* Copyright ASD Software, s.r.o., 2002-2006 9

5 PravniFormaKod bus:subjektpravniformakodtype Element NP 6 PoskytovatelKod fkis:dotaceposkytovatelkodtype Element NP 7 SmlouvaCislo cmn:spiscislojednacitype Element NP 8 RozpoctoveObdobi cmn:roktype Element NP 9 PocetVet xs:int Element NP * alespoň jenda kombinace je zadána dle zvoleného dotazu 1 Identifikační číslo bude mít formát, který stanovují standardy ČR ke dni odsouhlasení této služby. 2 Název subjektu, lze zadat i podřetězec. Minimální délka řetězce je 4 znaky. 3 Příjmení příjemce dotace. 4 Jméno příjemce dotace. 5 Právní forma subjektu, hodnota z číselníku právních forem. 6 Kod poskytovatele dat, hodnota z číselníku poskytovatelů. Subjekt, který je oprávněn poskytovat finanční prostředky. 7 Jednoznačný identifikátor projektu,neinvestiční dotace, akce (rgistrační číslo pro ISPROFIN, číslo projektu pro MSSF). 8 Rok, ve kterém byla dotace poskytnuta. 9 Maximální počet vrácených záznamů pro dotaz implicitně 10, maximálně 100. Pokud počet vyhovujících záznamů vznesené dotazem přesáhne hodnotu maximálního počtu vracených záznamů, bude v odpovědi obsaženo prvních X záznamů, kde X se rovná hodnotě elementu MaxPocetVet. Celkový počet záznamů vyhovující danému dotazu je uveden v odpovědi v samostatném elementu PocetVyhovujicichZaznamu. 4.3.1.1 Atributy dotazu Dotaz obsahuje další dodatečné informace v podobě atributů. Atributy dotazu : Poř.č. Jméno položky Typ Platnost 1 davkasestavenidatumcas crd:datumcastype PP 2 validation_xslt crd:davkaxsltvalidationtype NP 1 Datum a čas vytvoření dotazu 2 Umístění dodatečné validační šablony 4.3.1.2 Atribut pole ObchodníJmeno Pro pole ObchodniJmeno lze použít atribut pouzitlike. Tento atribut umožňuje přepínání způsobu vyhledávání obchodního jména v databázi. Defaultně je nastaven na rovno 0, což signifikuje vyhledávání na rovnost. Služba vrací jen záznamy s exaktní hodnotou. Při hodnotě atributu rovno 1,2,3 se použije vyhledávací klauzule Like, která vrací záznamy, kde se hledaný řetězec vyskytuje i jako podřetězec. Poř.č. Jméno položky Typ Platnost 1 pouzitlike xs:boolean NP 1 Volba vyhledávání hledané hodnoty v poli ObchodniJmeno. Defaultně rovno 0. Význam hodnoty: 0 - přesný výraz 1 - like z obou stran, viz *hl.hodnota* 2 - like zprava, viz hl.hodnota* Copyright ASD Software, s.r.o., 2002-2006 10

3 - like zleva, viz *hl.hodnota 4.3.2 Odpověď na veřejné údaje Pro odpověď na výše definovaný dotaz na získání kontrolních informací je vytvořeno schéma 6.3, které obsahuje následující datové položky : 1 PocetVyhovujicichZaznamu xs:int Element 1 PP 2 PrijemciDotaci PrijemceDotaceStructure Structure 0..100 NP 1 Počet záznamů vyhovující výběrové podmínce. 2 Seznam příjemců dotací 4.3.2.1 PříjemceDotace - identifikace subjektu 1 ICO bus:subjekticotype Element 0..1 NP* 2 ObchodniJmena ObchodniJmenaStrukture Structure 0..n NP* 3 Prijmeni per:osobaprijmenitype Element 0..1 NP* 4 Jmeno per:osobajmenotype Element 0..1 NP* 5 SidloAdresa AdresaStructure Structure 0..1 PP 6 PravniFormaKod bus:subjektpravniformakodtype Element 1 PP 7 PravniFormaNazev fkis:subjektpravniformanazevtype Element 1 PP 8 Projekt ProjektStructure Structure 1..n PP * Alespoň jeden, nebo více elementů je uvedeno v závislosti na právní formě subjektu. 1 Identifikační číslo subjektu. 2 Obchodní jména subjektu. Rozdělené dle jazykové mutace. 3 Příjmení subjektu 4 Jméno subjektu 5 Zde je uvedena adresa subjektu. Pro právnicé osoby se uvádí sídlo firmy (hodnota kvalifikátoru adresy = 1). U fyzických osob a fyzických osob podnikajících se uvádí trvalé bydliště (hodnota kvalifikátoru adresy = 4). U cizinců (právní forma 421) mohou být uvedeny oba typy adresy. Pokud je uveden StatKod!= 'CZ' a typ právní formy je 1 nebo 2 bude v SidleAdresa očekáván typ adresy 4. Při insertu je element povinný a závisí na typu právní formy. Při modifikaci je nepovinný. 6 Právní forma subjektu podle číselníku PF 7 Název pravní formy podle číselníku PF 8 Seznam projektů Každý uzel PrijemceDotace obsahuje atribut ID. Tento atribut identifikuje jednotlivé příjemce dotace v rámci skupiny vyhovujících záznamů v uzlu PrijemciDotaci. Poř.č. Jméno položky Typ Platnost 1 ID xs:int PP 1 Atribut obsahující identifikaci příjemce dotace Copyright ASD Software, s.r.o., 2002-2006 11

4.3.2.2 Obchodní jména 1 ObchodniJmeno bus:subjektobchodnijmenotype Element 1 PP 2 jazykkod jazyktype Atribut 1 PP 1 Obchodní jméno příjemce dotace 2 Kód jazyku v němž je zadán název 4.3.2.3 Adresa sídla subjektu 1 AdresaKody AdresaVystupniKodyBaseStructure Structure 0..1 NP* 2 AdresaText ObjektAdresaTextBaseStructure Structure 0..1 NP* * alespoň jedna větev musí být uvedena 1 Adresa zadána kody dle UIR, viz dále 4.3.2.4 2 Adresa zadána textem, viz dále 4.3.2.6 4.3.2.4 Adresa kódy 1 AdresaPredavaciKod spa:objektadresapredavacikodtype Element 0..1 NP* 2 AdresaKvalifikatorKod spa:adresakvalifikatorkodtype Element 0..1 NP 3 ShodaKod AdresaShodaKod Element 0..1 NP 4 CastObcePredavaciKod spa:castobcekodtype Element 0..1 NP* 5 MestskaCastPredavaciKod cmn:roktype Element 0..1 NP* 6 ObjektCisloDomovni spa:objektcislodomovnistructure Structure 0..1 NP* 7 UlicePredavaciKod spa:ulicepredavacikodtype Element 0..1 NP* 8 UliceNazev spa:ulicenazevtype Element 0..1 NP* 9 ObjektCisloOrientacni spa:objektcisloorientacnitype Element 0..1 NP* 10 PSC spa:psctype Element 0..1 NP* * Položka 1 nebo položky 4 až 10 jsou vráceny 1 Předávací kód adresy stavebního objektu je jednoznačné číselné vyjádření konkrétních hodnot (výskytů) adresy stavebního objektu ve smyslu vymezení v odst. 3.31 Standardu ISVS k prostorové identifikaci. Předávací kód adresy stavebního objektu je jedinečný v rámci ČR 2 Datový prvek pro upřesnění věcného obsahu adresy. Prvek nabývá věcného významu ve spojení s adresou. Je určen k upřesnění věcného obsahu adresy, tj. toho, co či kdo se nachází na místě určeném adresou, resp. k čemu údaj o adrese slouží.kvalifikátor adresy: 1 adresa organizace, 2 adresa provozní jednotky, 3 pracoviště, 4- trvalé bydliště u fyz.osoby, 5-přechodné bydliště, 9- doručovací adresa. V případě modifikace záznamu bude kód ignorován. 3 Kód shody informací o adrese ověřených v externích systémech 4 Předávací kód části obce je číselný prostorový identifikátor standardního prvku prostorové identifikace "část obce". Standardní prvek prostorové identifikace "část obce" je vymezen v kap. 3 Standardu ISVS k prostorové identifikaci. Předávací kód části obce je určován po vzniku části obce číselníkem v rámci Územně identifikačního registru základních sídelních jednotek, provozovaného v garanci Ministerstva pro místní Copyright ASD Software, s.r.o., 2002-2006 12

rozvoj. Předávací kód části obce je jedinečný v rámci České republiky. Pozn. Předávací kód části obce vzniká reálně fixací stávajícího kódu části obce (katalogový list AA0056) k počátku roku 2001. Tím je umožněn bezproblémový přechod uživatelů z dosud v čase proměnného kódu části obce na v čase neproměnný předávací kód 5 Předávací kód městské části resp. městského obvodu je číselný prostorový identifikátor standardního prvku prostorové identifikace "městská část resp. městský obvod". Standardní prvek prostorové identifikace "městská část resp. městský obvod" je vymezen v kap. 3 Standardu ISVS k prostorové identifikaci. Předávací kód městské části resp. městského obvodu je určen číselníkem. Předávací kód městské části resp. městského obvodu je jedinečný v rámci České republiky. 6 Struktura složená z DruhKod - Kód druhu čísla domovního je číselný kvalifikátor pro upřesnění, zda se jedná o číslo popisné či číslo evidenční.í a Hodnota - Hodnota čísla domovního je společný název pro číselnou hodnotu prostorového identifikátoru AA0065 Číslo popisné a prostorového identifikátoru AA0066 Číslo evidenční. Viz dále 4.3.2.5 7 Předávací kód ulice a veřejného prostranství je číselný prostorový identifikátor standardního prvku prostorové identifikace "ulice a veřejné prostranství". Standardní prvek prostorové identifikace "ulice a veřejné prostranství" je vymezen v kap. 3 Standardu ISVS k prostorové identifikaci. Předávací kód ulice a veřejného prostranství je jedinečný v rámci České republiky. 8 Název ulice a veřejného prostranství je slovní prostorový identifikátor standardního prvku prostorové identifikace "ulice a veřejné prostranství". Standardní prvek prostorové identifikace "ulice a veřejné prostranství" je vymezen v kap. 3 Standardu ISVS k prostorové identifikaci. Název ulice a veřejného prostranství je určen obcí. Název ulice a veřejného prostranství je jedinečný v rámci obce, ne v rámci České republiky ani okresu. 9 Číslo orientační je číselný prostorový identifikátor standardního prvku prostorové identifikace "stavební objekt", pokud jde o stavební objekt, který je označen číslem orientačním. Standardní prvek prostorové identifikace "stavební objekt" je vymezen v kap. 3 Standardu ISVS k prostorové identifikaci. Číslo orientační je přidělováno rozhodnutím obecního úřadu. Číslo orientační je jedinečné pouze v rámci ulice nebo veřejného prostranství. 10 Datový prvek pro číslicové vyjádření směrovacích údajů, zajišťující dodávání zásilek do objektu v ČR, nebo samostatné poštovní směrovací číslo přidělené organizaci. 4.3.2.5 Objekt číslo domovní 1 DruhKod CisloDomovniDruhKodType Element 1 PP 2 Hodnota CisloDomovniHodnotaType Element 1 PP 1 Kód druhu čísla domovního je číselný kvalifikátor pro upřesnění, zda se jedná o číslo popisné či číslo evidenční 2 Hodnota čísla domovního je společný název pro číselnou hodnotu prostorového identifikátoru AA0065 Číslo popisné a prostorového identifikátoru AA0066 Číslo evidenční. 4.3.2.6 Adresa text 1 StatKod StatKodType Element 0..1 NP 2 AdresaText spa:adresatexttype Element 0..1 NP 3 AdresaKvalifikatorKod spa:adresakvalifikatorkodtype Element 0..1 NP * alespoň jedna větev musí být uvedena 1 Datový prvek pro kódové označení státu. Pozn.: Kód musí být ve tvaru třímístný abecední. 2 Adresa textem je nestrukturovaný zápis adresy jedním řádkem textu. Používá se v případech, kdy není možno Copyright ASD Software, s.r.o., 2002-2006 13

dodržet strukturování adres podle požadavků (např. pro zahraniční adresy). 3 Datový prvek pro upřesnění věcného obsahu adresy. Prvek nabývá věcného významu ve spojení s adresou. Je určen k upřesnění věcného obsahu adresy, tj. toho, co či kdo se nachází na místě určeném adresou, resp. k čemu údaj o adrese slouží.kvalifikátor adresy: 1 adresa organizace, 2 adresa provozní jednotky, 3 pracoviště, 4- trvalé bydliště u fyz.osoby, 5-přechodné bydliště, 9 doručovací adresa 4.3.2.7 Projekt 1 ProjektNazev fkis:projektnazevtype Element 0..1 NP 2 SmlouvaCislo cmn:spiscislojednacitype Element 1 PP 3 SmlouvaPodpisDatum cmn:datumxmltype Element 1 PP 4 OperacniProgramKod fkis:operacniprogramkodtype Element 0..1 NP* 5 OperacniProgramNazev fkis:financnirozvahapolozkanazevtype Element 0..1 NP* 6 FinancniCastky FinancniCastkyZdrojStructure Structure 0..n NP 1 Název projektu 2 Jednoznačný identifikátor projektu,neinvestiční dotace, akce (rgistrační číslo pro ISPROFIN, číslo projektu pro MSSF). 3 Datum podpisu smlouvy. 4 Kód operačního programu 5 Název operačního programu 6 Výpis finančních částek dle zdroje. Každý uzel Projekt obsahuje atribut ID. Tento atribut identifikuje jednotlivé projekty v rámci skupiny vyhovujících záznamů v uzlu Projekty. Poř.č. Jméno položky Typ Platnost 1 ID xs:int PP 1 Atribut obsahující identifikaci projektu 4.3.2.8 Finanční částky zdroj 1 FinancniZdrojKod fkis:financnizdrojkodtype Element 1 PP 2 FinancniZdrojNazev fkis:financnizdrojnazevtype Element 1 PP 3 PoskytovatelKod fkis:dotaceposkytovatelkodtype Element 0..1 NP 4 PoskytovatelNazev fkis:dotaceposkytovatelnazevtype Element 0..1 NP 5 InvesticeIndikator fkis:financnicastkainvesticeindikatortype Element 0..1 PP 6 NavratnostIndikator fkis:financnicastkanavratnostindikatortype Element 0..1 PP 7 CastkaRozhodnuta cmn:financnicastkatype Element 1 PP 8 FinancniCastkyObdobi FinancniCastkyObdobiStructure Structure 0..n NP 9 KalendarSplatek KalendarSplatekStructure Structure 0..1 NP 1 Finanční zdroj hodnota z číselníku zdojů finančních prostředků. 2 Název finančního zdroje dle číselníku Copyright ASD Software, s.r.o., 2002-2006 14

3 Kód poskytovatele čerpaný z číselníku poskytovatelů. 4 Název poskytovatele čerpaný z číselníku poskytovatelů 5 Kód investice: 0 - neinvestiční, 1 investiční 6 Kód návratnosti : 0 - nenávratná,1 - návratná 7 Výše přiznaných finančních prostředků (dle rozhodnutí) pro období. 8 Struktura finančních částek dle období 9 Struktura obsahuje informace o splátkovém kalendáři pro daného přijemce dotace. 4.3.2.9 Atributy odpovědi Struktura odpovědi obsahuje dodatečné informace v podobě atributů elementu. Poř.č. Jméno položky Typ Platnost 1 davkasestavenidatumcas crd:datumcastype PP 2 validation_xslt crd:davkaxsltvalidationtype NP 1 Datum a čas vytvoření odpovědi. 2 Umístění dodatečné validační šablony. 4.3.2.10 Finanční částka období Poř.č. Jméno položky Typ Node Typ Násobnost Platnost 1 DotaceTitulKod fkis:dotacetitulkodtype Element 0..1 NP 2 DotaceTitulNazev fkis:dotacetitulnazevtype Element 0..1 NP 3 RozpoctoveObdobi cmn:roktype Element 1 PP 4 CastkaSpotrebovana cmn:financnicastkatype Element 0..1 NP 5 CastkyUvolnene FinancniCastkyUvolnenaStructure Structure 0..n NP 6 CastkyCerpane FinancniCastkyCerpanaStructure Structure 0..n NP 7 CastkyVracene FinancniCastkyVracenaStructure Structure 0..n NP 1 Kód dotačního titulu. 2 Název dotačního titulu. 3 Období v kterém byla dotace poskytnuta 4 Výše účelně vynaložených poskytnutých finančních prostředků. 5 Struktura s informacemi o uvolněných částkách v daném období. 6 Struktura s informacemi o čerpaných částkách v daném období. 7 Struktura s informacemi o vrácených částkách v daném období. 4.3.2.11 Částky uvolněné 1 UvolneniDatum cmn:datumxmltype Element 1 PP 2 OperaceDruhKod fkis:operacedruhkodtype Element 0..1 NP 3 DoplatekIndikator fkis:doplatekindikatortype Element 1 PP 4 Platba PlatbaStructure Structure 1 PP 1 Datum uvolnění finančních prostředků. 2 Příznak, jde-li o vystavení limitky nebo převod prostředků (0-limit, 1-čerpání). 3 Příznak doplatku - vyjadřuje skutečnost, kdy příjemci byla přiznána nějaká výše prostředků podle určité Copyright ASD Software, s.r.o., 2002-2006 15

smlouvy, ale nebyla vyčerpána celá z prostředků běžného roku a rozdíl mezi poskytnutou a čerpanou částkou se vyplácí z prostředků následujícího roku podle původní smlouvy. 4 Struktura s informacemi kdy z jakého účtu a na jaký účet byla částka uvolněna. 4.3.2.12 Platba 1 CastkaVyse cmn:financnicastkatype Element 1 PP 2 SplatnostDatum cmn:datumxmltype Element 0..1 NP 1 Výše částky 2 Datum splatnosti platby 4.3.2.13 Částky čerpané 1 CerpaniDatum cmn:datumxmltype Element 0..1 NP 2 CastkaVyse cmn:financnicastkatype Element 0..1 NP 1 Datum, kdy byla částka čerpána. 2 Výše čerpané částky 4.3.2.14 Částky vrácené 1 VraceniDatum cmn:datumxmltype Element 0..1 NP 2 CastkaVyse cmn:financnicastkatype Element 0..1 NP 1 Datum, kdy byla částka vrácena. 2 Výše čerpané částky 4.3.2.15 Kalendář splátek 1 UroceniIndikator fkis:kalendarsplatekuroceniindikatortype Element 0..1 NP 2 SplatkyPlanovane SplatkyPlanovaneStructure Structure 0..n NP 3 SplatkySkutecne SplatkySkutecneStructure Structure 0..n NP 1 Indikátor úročení částek platebního kalendáře. 2 Struktura s informacemi o naplánovaných splátkách pro daného příjemce dotace. Počet splátek skutečných nemusí souhlasit s počtem splátek naplánopvaných. 3 Struktura s informacemi kdy daný příjemce dotace splatill naplánované částky a v jaké výši platbu provedl. Počet splátek skutečných nemusí souhlasit s počtem splátek naplánopvaných. Copyright ASD Software, s.r.o., 2002-2006 16

4.3.2.16 Splátky plánované Struktura přebírá strukturu Platby. 4.3.2.17 Splátky skutečné Struktura přebírá strukturu Platby. Copyright ASD Software, s.r.o., 2002-2006 17

5. Podrobný popis životního cyklu zpráv 5.1 Dotazy na databázi IS CEDR III Tato kapitola je zpřesněním kapitoly 2. tohoto dokumentu s přihlédnutím ke kapitole 3. Technické řešení. Popisuje detailně procesy při přenosu zpráv včetně ošetření chybových stavů. Řešení je možno popsat následujícím blokovým schématem: Start generování dotazu Agentem Zpráva s dotazem na službu SP odeslání dotazu na službu SP přijem zprávy službou SP Ano Ne Obsahuje zpráva elementy WSaddressing? Ano Ne Obsahuje zpráva elementy time stamp? Ano chybová zpráva generování chybové zprávy Ano Zpráva expirovala? Ne Ne Je podporován daný typ dotazu? generování odpovědi službou SP Zpracování dotazu na službou SP Ano zpráva s odpovědí odeslání odpovědi Agentovi Konec Obr.2 Podrobný popis životního cyklu zpráv - dotazy na databázi IS CEDR Copyright ASD Software, s.r.o., 2002-2006 18

Životní cyklus zprávy na straně služby, vyjádřený na obr.2, lze podrobně rozepsat v následujících bodech: 1. Odesílající strana (Agent) vygeneruje zprávu s dotazem na službu. 2. Agent se prostřednictvím sítě Internet / intranet spojí protokolem HTTPS se službou na adrese uvedené v kapitole [Chyba! Nenalezen zdroj odkazů.] a odešle zprávu. Pokud dojde k selhání přenosu na úrovni protokolu HTTPS, 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. 3. Pokud je zpráva přijata službou je možno provést vstupní kontroly a je možno odeslat chybovou zprávu Agentovi. 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 soap:server. 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 soap:server. 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 tato chyba indikována pomocí HTTP protokolu chybovým kódem 400 Bad request. 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 tato chyba indikována pomocí HTTP protokolu chybovým kódem 400 Bad request. Příchozí zpráva je odmítnuta jako celek. Pokud zpráva neobsahuje elementy wsa:action, wsa:messageid, wsa:to je klientovi tato chyba indikována pomocí HTTP protokolu chybovým kódem 400 Bad request. Příchozí zpráva je odmítnuta jako celek. Pokud zpráva neobsahuje element wsa:replyto je klientovi zaslána chybová zpráva SOAP s chybovým kódem q0:security. Příchozí zpráva je odmítnuta jako celek. Selže-li ověření časových a identifikačních údajů v SOAP obálce z důvodů chyby přijímající aplikace, je klientovi zaslána chybová zpráva SOAP s chybovým kódem soap:server. Příchozí zpráva je odmítnuta jako celek. Má-li příchozí zpráva proexspirovaný čas zpracování v elementu <wsu:timestamp>, bude zpráva odmítnuta jako celek. Klientovi zaslána chybová zpráva SOAP s chybovým kódem soap:server. 4. Na základě předané zprávy je vyhodnocen typ dotazu a zda je tento dotaz službou podporován. Selže-li tento krok, je klientovi zaslána chybová zpráva SOAP s chybovým kódem soap:client. Příchozí zpráva je odmítnuta jako celek. 5. Zpráva je zpracována aplikací 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 soap:server. Příchozí zpráva je odmítnuta jako celek. 6. 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. Vzhledem k tomu, že cyklus dotaz-odpověď nemá charakter typické transakce, je možno stanovit ošetření chyb na klientské straně prakticky libovolně. Copyright ASD Software, s.r.o., 2002-2006 19

6. Přílohy 6.1 Adresa služby http://cedr.mfcr.cz/ws/cedrinfopublic_v102/service.asmx 6.2 Struktura XMLSchema pro veřejný dotaz http://cedr.mfcr.cz/cedr_xml/schemas/cedr/info_public/v_1.0.2/cedr3.infopublic.v102.request.xsd 6.3 Struktura XMLSchema pro odpověď na veřejný dotaz http://cedr.mfcr.cz/cedr_xml/schemas/cedr/info_public/v_1.0.2/cedr3.infopublic.v102.response.xsd Copyright ASD Software, s.r.o., 2002-2006 20

7. Reference [1] SOAP Simple Object Access Protocol (SOAP) 1.1 W3C Note 08 May 2000. Viz http://www.w3.org/tr/soap [2] XML Extensible Markup Language (XML) 1.0 (Second Edition). W3C Recommendation 6 October 2000. Viz http://www.w3.org/tr/rec-xml [3] XML Schema XML Schema Part 0: Primer. W3C Recommendation, 2 May 2001 Viz http://www.w3.org/tr/xmlschema-0/ [4] SAML Asssertion and Protocol SAML Asssertion and Protocol 2.0 (SAML-Core-2.0) Viz. http://www.oasis-open.org/committees/download.php/19852/sstc-saml-core-errata-2.0-wd-02-diff.pdf [5] Basic Profile Basic Profile Version 1.1 Viz. http://www.ws-i.org/profiles/basicprofile-1.1-2004-08-24.html Copyright ASD Software, s.r.o., 2002-2006 21

8. Návrhy pro další verze služby V tomto odstavci jsou definovány návrhy pro úpravy a rozšíření následující verze. Copyright ASD Software, s.r.o., 2002-2006 22