PRO INTERNÍ POTŘEBU
Specifikace služby IS CEDR pro automatické zasílání aktualizačních dávek s výsledky kontrol
vypracovala společnost
ASD Software, s.r.o.
dokument ze dne 28.7. 2006, verze 1.0.0
Specifikace služby IS CEDR pro automatické zasílání aktualizačních dávek s výsledky kontrol
Počet stran v dokumentu celkem
:
21
Rozdělovník : Číslo Počet výtisků Předáno 1 1x MF, odbor 38 2 1x MF, odbor 43
Převzal Ing. Hana Domínová Ing. Miroslav Mrklovský
OBSAH 1.
ÚVOD ..........................................................................................................................................4
2.
PROCESNÍ POSTUPY..............................................................................................................5 2.1 2.2
3.
AKTIVACE SLUŽBY ................................................................................................................5 PŘENOS INFORMACÍ ...............................................................................................................5
TECHNICKÉ ŘEŠENÍ..............................................................................................................6 3.1 PŘENOSOVÝ FORMÁT DAT .....................................................................................................6 3.2 VALIDACE A POPIS XML DOKUMENTŮ ..................................................................................6 3.2.1 XML Schema ................................................................................................................6 3.2.2 Jmenné prostory ...........................................................................................................6 3.2.3 RDDL ...........................................................................................................................6 3.3 TRANSPORTNÍ PROTOKOLY....................................................................................................6 3.3.1 Základní transportní protokol ......................................................................................6 3.3.2 SOAP protokol..............................................................................................................6 3.3.3 Použití protokolu BizTalk.............................................................................................7 3.4 MODEL PŘENOSU ZPRÁV .......................................................................................................7 3.5 ŘEŠENÍ BEZPEČNOSTI ............................................................................................................7 3.5.1 Integrita přenosu dat....................................................................................................7 3.5.2 Důvěrnost přenosu dat .................................................................................................7 3.5.3 Nepopíratelnost odesílatele..........................................................................................7 3.6 POJMENOVÁVACÍ KONVENCE ................................................................................................8 3.7 ZPRACOVÁNÍ CHYB ...............................................................................................................8 3.7.1 Chyby na úrovni validace pomocí XML Schema .........................................................8 3.7.2 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Í DAT O KONTROLÁCH Z IS CEDR .....................................................................10 4.2.1 Popis schémat.............................................................................................................10 4.2.2 Aktualizační dávka .....................................................................................................10
5.
PODROBNÝ POPIS ŽIVOTNÍHO CYKLU ZPRÁV .........................................................13 5.1
6.
AUTOMATICKÉ VYTVÁŘENI AKTUALIZAČNÍCH DÁVEK NA DATABÁZI IS CEDR..................13
PŘÍLOHY .................................................................................................................................14 6.1.1 Struktura v XML pro aktualizační dávku ...................................................................14 6.2 SCHÉMATA PRO SLUŽBU ......................................................................................................14 6.2.1 Schéma cedr_aa_datatypes.xsd..................................................................................14 6.2.2 Schéma cedr_aa_batch.xsd ........................................................................................16 6.3 STRUKTURA SMTP KOMUNIKACE .........................................................................................18 6.3.1 Příklad aktualizační dávky .........................................................................................18
7.
REFERENCE ...........................................................................................................................21
Specifikace služby IS CEDR pro automatické zasílání aktualizačních dávek s výsledky kontrol z IS CEDR, verze 1.0.0 ze dne 28.7.2006. Název souboru : Sluzba_CEDR_AA_v_100.doc Copyright © ASD Software, s.r.o., 1995 - 2006
3
1. Úvod Tato dokumentace obsahuje popis služby IS CEDR, která v pravidelných intervalech vytváří a následně zasílá aktualizační dávku (ve formátu XML) na kontaktní e-mailovou adresu. Aktualizační dávka obsahuje informace o kontrolách (a jejich aktualizacích) prováděných FÚ v rámci správy odvodu za porušení rozpočtové kázně. Poskytovatelem této služby je Ministerstvo financí, v jehož plné kompetenci je také definice popisované služby. Předpokladem je, že dávký budou zpracovávány řadou klientských aplikací; proto jsou zvoleny taková architektonická řešení a technologie, které umožní relativně jednoduché dosažení interoperability (XML formát dat).
Specifikace služby IS CEDR pro automatické zasílání aktualizačních dávek s výsledky kontrol z IS CEDR, verze 1.0.0 ze dne 28.7.2006. Název souboru : Sluzba_CEDR_AA_v_100.doc Copyright © ASD Software, s.r.o., 1995 - 2006
4
2. Procesní postupy 2.1 Aktivace služby Služba je automaticky aktivována na základě aktivace služby CEDR-VK.
2.2 Přenos informací Služba na straně IS CEDR bude automaticky vytvářet aktualizační dávky, které budou odeslány pomocí protokolu SMTP na adresu klientů tak, jak je uvedeno na obr. 1:
Aktualizační dávka
IS CEDR
Klient služby
Obr. 1 – Zasílání aktualizačních dávek z databáze IS CEDR Poznámka: Předpokladem zasílání informací ze služby CEDR AA je provedení tzv. „Hromadného dožádání“ viz popis web-službyx CEDR-HD. V tomto případě (obr. 1) probíhají globální procesy následujícícm způsobem: 1. Na straně serveru (IS CEDR) je vygenerována elektronická dávky (ve formátu XML). K vygenrování dávky dochází vždy 1x za 24 hod a to pouze za předpokladu, že existují informace (viz dále), které mají být příslušnému příjemci doručeny. 2. Dávka je opatřena všemi náležitostmi dle této specifikace a je odeslána prostřednictvím SMTP na e-mailovou adresu příslušného příjemce (jedná se o adresu, která byla předána MF v rámci žádosti o zpřístupnění výsledků kontropl).
Specifikace služby IS CEDR pro automatické zasílání aktualizačních dávek s výsledky kontrol z IS CEDR, verze 1.0.0 ze dne 28.7.2006. Název souboru : Sluzba_CEDR_AA_v_100.doc Copyright © ASD Software, s.r.o., 1995 - 2006
5
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 dat 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řed odesláním dávky službou. Dávky XML budou mít v kořenovém elementu dokumentu deklarován jmenný prostor schématu daného dokumentu. Pomocí atributu xsi:schemaLocation bude také uvedena fyzická lokalizace schématu. Všechna schémata budou obsahovat dokumentaci schématu. Formát RDF dokumentace bude odpovídat dle [3]. Všechna schémata budou verzována v souladu se zásadami, uvedenými v [3]. Cílové jmenné prostory všech schémat budou podporovat specifikaci RDDL dle [3]. 3.2.2 Jmenné prostory Jmenné prostory schémat, popisujících přenášené XML dokumenty popisované služby, budou ve formátu URL nebo URN. 3.2.3 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].
3.3 Transportní protokoly 3.3.1 Základní transportní protokol Základním transportním protokolem pro popisovanou službu bude protokol SMTP. 3.3.2 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
), tak tělo SOAP (element ). V záhlaví SOAP budou v BizTalk elementech neseny administrativní informace (bližší viz 3.3.3). Specifikace služby IS CEDR pro automatické zasílání aktualizačních dávek s výsledky kontrol z IS CEDR, verze 1.0.0 ze dne 28.7.2006. Název souboru : Sluzba_CEDR_AA_v_100.doc Copyright © ASD Software, s.r.o., 1995 - 2006
6
Všechny elementy SOAP budou mít nastaven atribut MustUnderstand na hodnotu 1. 3.3.3 Použití protokolu BizTalk Pro administraci zpráv bude použito elementů specifikace BizTalk [1]. Zprávy přenášející data (dotazy i odpovědi) budou povinně obsahovat elementy: • •
s indikací odesílatele a adresáta zprávy <properties> popisující vlastní přenášený dokument v souladu s pravidly dle [3]. <endpoints>
Element <expiresAt> Exspirace dávky bude nastavena na jedn měsíc. Elementy specifikace BizTalk budou používat prosté řetězce pro označení účastníka komunikace. Elementy budou uvádět jmenný prostor schématu, odpovídajícího přenášené dávce. Pro jednoznačnou identifikaci dokumentu slouží subelement elementu <properties>. Platí následující pravidlo : •
Naplnění elementu 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š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. 10.1.
3.5 Ř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.6.1). 3.5.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.6.1) bude v této službě použit certifikát poskytovatele služby, kterým bude podepsáná aktualizační dávka. 3.5.2 Důvěrnost přenosu dat Důvěrností přenosu dat rozumíme zabezpečení dat proti odposlechu během transportu. Aktualizační dávky budou šifrovány veřejným klíčem certifikátu klienta služby. 3.5.3 Nepopíratelnost odesílatele Nepopíratelnost odesílatele bude implementována v souladu s [3], kap. 5.6.1. a 5.6.2. Pro účely zajištění nepopíratelnosti odesílatele bude podepisován celý element zprávy SOAP a BizTalk elementy <endpoints> , <properties>. Pro podpis bude použit certifikát identity. Element <Signature> Specifikace služby IS CEDR pro automatické zasílání aktualizačních dávek s výsledky kontrol z IS CEDR, verze 1.0.0 ze dne 28.7.2006. Název souboru : Sluzba_CEDR_AA_v_100.doc Copyright © ASD Software, s.r.o., 1995 - 2006
7
bude mít atribut Id s hodnotou “Signature”. Pro podpis bude použita kanonická transformace dle http://cedr.mfcr.cz/xml_doc/schemas/documentation/rozhraní na uir a ares 110.doc
3.6 Pojmenovávací konvence RDDL soubory, umístěné na URL jmenných prostorů, 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.7 Zpracování chyb 3.7.1 Chyby na úrovni validace pomocí XML Schema Při výskytu chyby na úrovni validace pomocí XML Schema nebude aktualizační dávka na klienta odeslána. V tomto případě bude o výskytu chyby informován zřizovatel služby. 3.7.2 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. V tomto případě bude o výskytu chyby informován zřizovatel služby.
Specifikace služby IS CEDR pro automatické zasílání aktualizačních dávek s výsledky kontrol z IS CEDR, verze 1.0.0 ze dne 28.7.2006. Název souboru : Sluzba_CEDR_AA_v_100.doc Copyright © ASD Software, s.r.o., 1995 - 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 PP Povinný Element Povinná Data NP Nepovinný Element Povinná Data NN
Nepovinný Element Nepovinná Data
NI
Nepovinný Element Ignorují se Data
Podrobný popis Element i data jsou povinná Element je volitelný ale pokud je uveden jsou povinná i 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. 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.
Specifikace služby IS CEDR pro automatické zasílání aktualizačních dávek s výsledky kontrol z IS CEDR, verze 1.0.0 ze dne 28.7.2006. Název souboru : Sluzba_CEDR_AA_v_100.doc Copyright © ASD Software, s.r.o., 1995 - 2006
9
4.2 Předávání dat o kontrolách z IS CEDR Datové typy podléhající standardu UVIS jsou specifikovány v souboru cedr_aa_datatypes.xsd (viz. Kapitola Chyba! Nenalezen zdroj odkazů..1). Jména typů jsou odvozeny z názvu položky tím způsobem, že před jméno položky je přidán prefix „typ_“ 4.2.1 Popis schémat Pro aktualizační dávku je taktéž definováno schéma (viz. Kapitola Chyba! Nenalezen zdroj odkazů..2). 4.2.2 Aktualizační dávka Aktualizační dávky budou vytvářeny v centrální databázi automaticky při každém rozhrání dat s výsledky kontrolních činností (tj. 1x za 24 hodin). Rozhodné podmínky pro generování aktualizačních dávek budou následující: 1) Ukončení/odstranění ukončení/změna ukončení kontrolní činnosti, resp. vyplnění/odstranění/změna data ukončení/projednání , nebo odstranění kontrolovaného rozhodnutí z již ukončené kontrolní činnosti 2) Odeslání platebního výměru finančním úřadem 3) změna platebního výměru na odvod(zvýšení/snížení odvodové povinnosti apod.) 4) zaplacení/vydobytí zneužitých prostředků Podmínky, které nebudou důvodem pro generování aktualizačních dávek budou následující: • vytvoření, resp. odeslání posečkání/plátkování (protože neovlivňuje výši odvodu) • vytvoření, resp. odeslání prominutí (protože není zohledněno ani v rámci služby CEDRVK) Na základě těchto rozhodných podmínek bude vytvořen následující číselník aktualizačních podmínek. Informace o podmínkách, na základě kterých bude aktualizační dávka vytvořena, budou součástí aktualizační dávky, více viz níže. Aktualizační dávka bude obsahovat pouze základní informace o příjemci dotace (odvozeno z odpovědi na hromadné dožádání). Aktuální stav dat si uživatel zjistí následným dotazem na web službu ‚Služba VK‘. A) Základní informace Poř č. 1.
Položka Odesláno dne
Povinnost Poznámka Datum odeslání aktualizační dávky z centra k poskytovateli. PP
B) Podkategorie příjemce dotace V aktualizační dávce bude uveden seznam s informacemi o příjemci dotace (odvozeno z odpovědi na hromadné dožádání) Poř č. 1.
Položka Identifikace příjemce
Povinnost Poznámka Jednoznačná identifikace(klíč) příjemce dotace v IS CEDR II, ke PP
Specifikace služby IS CEDR pro automatické zasílání aktualizačních dávek s výsledky kontrol z IS CEDR, verze 1.0.0 ze dne 28.7.2006. Název souboru : Sluzba_CEDR_AA_v_100.doc Copyright © ASD Software, s.r.o., 1995 - 2006
10
2. 3.
dotace IČ Obchodní jméno
4. 5.
RČ Titul před jménem
NP2,3
6. 7. 8. 9.
Příjmení Jméno Titul za jménem Změněno dne (od**)
NP2,3 NP2,3 NN2,3 PP
10.
Změněno dne do **
NP
NP1,3
NP1,3 NN2,3
kterému se vztahuje aktualizační dávka Identifikační číslo příjemce dotace, u kterého došlo k aktualizaci dat Obchodní jméno se vyplňuje u právnické osoby(PO) a fyzické osoby podnikající(FOP) - obchodní jméno podle Obchodního zákoníku §9 Rodné číslo příjemce dotace, u kterého došlo k aktualizaci dat Vědecké a akademické tituly uvedené před jménem fyzické osoby (FO) nebo FOP Příjmení FO nebo FOP Jméno FO nebo FOP Vědecké a akademické tituly uvedené před jménem FO nebo FOP Datum provedení změny, tj. k tomuto datu byla data naposledy/poprvé * aktualizována na zdrojovém FÚ před odesláním do centrální databáze Datum provedení změny, tj. k tomuto datu byla data naposledy aktualizována na zdrojovém FÚ před odesláním do centrální databáze
Vysvětlivky: NP1,3,NP2,3 - Identifikační číslo/rodné číslo bude mít formát, který stanovují standardy SIS ČR ke dni odsouhlasení tohoto rozhraní. ** - vyplněno, pouze pokud platí následující podmínka: protože je v aktualizační dávce zasílána globální informace o aktualizaci příjemce dotace, může existovat interval datumů od – do (minimální* a maximální datum ze všech změnových dávek, doručených do centra z FU, ze kterých je generována aktualizační dávka) => v této položce bude maximální datum ze všech změnových dávek Např. u příjemce dotace byla aktualizována data ve dvou kontrolních činnostech(každá v jiný den) a tyto informace byly postoupeny do centra v jedné dávce => obě informace budou zahrnuty do aktualizační dávky C) Podkategorie k příjemci dotace – Podmínky aktualizace Doplňkovou informací k podkategorii příjemce dotace bude seznam splněných rozhodných podmínek, na základě kterých byla aktualizační dávka vytvořena : Poř č. 1. 2.
Položka Kód podmínky aktualizace Název podmínky aktualizace
Povinnost Poznámka Kód rozhodná podmínky aktualizace dle číselníku PP PP
Název rozhodné podmínka aktualizace dle číselníku
Poznámka:Aktualizační podmínky budou zahrnuty do seznamu proto, že jedna aktualizační dávka může splňovat více splněných aktualizačních podmínek, např. ukončení kontrolní činnosti(podmínka č.1) a odeslání PVO(tj. změna PVO, podmínka č.4). Poznámka 1/2
1 – Ukončení/změna ukončení kontrolní činnosti, resp. vyplnění/změna data ukončení/projednání
Specifikace služby IS CEDR pro automatické zasílání aktualizačních dávek s výsledky kontrol z IS CEDR, verze 1.0.0 ze dne 28.7.2006. Název souboru : Sluzba_CEDR_AA_v_100.doc Copyright © ASD Software, s.r.o., 1995 - 2006
11
2 – Odstranění ukončení kontrolní činnosti, resp. odstranění data ukončení/projednání 3 - Odstranění zkontrolovaného rozhodnutí z již ukončené kontrolní činnosti 4 - Změna výše odvodu(předpis/změna odvodové povinnosti po odeslání příslušného rozhodnutí finančním úřadem, apod.) 5 – Zaplacení zneužitých prostředků(dílčí změna zaplacené částky odvodu) 6 – Vydobytí zneužitých prostředků(zaplacení celého odvodu)
Princip bude pro každého příjemce dotace(PD), obsaženého v datech s výsledky kontrol, následující: a) Systém zjistí, zda bude pro daného PD vytvářet aktualizační dávku(tj. zda byly splněny podmínky pro automatickou aktualizaci, tj. zda byl na dané RČ/IČ proveden jednoduchý dotaz, případně hromadné dožádání). b) Pokud bude splněna podmínka pro vytvoření aktualizační dávky, zjistí se seznam poskytovatelů, kteří splňují bod a) , pokud nebude splněna podmínka v bodu a), aktualizační dávka se pro daného PD vytvářet nebude . c) Pro každého poskytovatele, splňujícího bod b)) a pokud budou splněny rozhodné podmínky pro generování aktualizační dávky, bude provedena kontrola, zda má poskytovatel přístup na aktualizované rozhodnutí.Pokud ano, bude vytvořena aktualizační dávka , obsahující informace dle výše uvedeného schématu.Pokud poskytovatel nemá přístup na aktualizované rozhodnutí, nebude aktualizační dávka vytvořena. d) Po vytvoření všech dávek budou tyto odeslány na kontaktní e-mailové adresy založený v rámci přístupu na službu CEDR-VK.
Specifikace služby IS CEDR pro automatické zasílání aktualizačních dávek s výsledky kontrol z IS CEDR, verze 1.0.0 ze dne 28.7.2006. Název souboru : Sluzba_CEDR_AA_v_100.doc Copyright © ASD Software, s.r.o., 1995 - 2006
12
5. Podrobný popis životního cyklu zpráv 5.1 Automatické vytvářeni aktualizačních dávek na databázi IS CEDR Tato kapitola je zpřesněním kapitoly 2. tohoto dokumentu Popisuje detailně procesy při vytváření dávek. Řešení je možno popsat následujícím blokovým schématem:
Obr.2 – Podrobný popis životního cyklu – generování aktualizačních dávek na databázi IS CEDR
Specifikace služby IS CEDR pro automatické zasílání aktualizačních dávek s výsledky kontrol z IS CEDR, verze 1.0.0 ze dne 28.7.2006. Název souboru : Sluzba_CEDR_AA_v_100.doc Copyright © ASD Software, s.r.o., 1995 - 2006
13
6. Přílohy 6.1.1 Struktura v XML pro aktualizační dávku Název elementu v XML 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18. 19. 20. 21.
hodnota hodnota hodnota hodnota hodnota <prijmeni>hodnota <jmeno>hodnota hodnota hodnota <seznam_aktualizaci> hodnota hodnota … …
6.2 Schémata pro službu 6.2.1 Schéma cedr_aa_datatypes.xsd <xs:schema xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns="urn:cz:isvs:mfcr:schemas:cedrII:aa:datatypes:v100" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:dcterm="http://purl.org/dc/terms/" targetNamespace="urn:cz:isvs:mfcr:schemas:cedrII:aa:datatypes:v100" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:annotation> <xs:documentation xml:lang="cs">Návrh XML schématu datových typů aktualizačních dávek v IS CEDR II © ASD Software s.r.o., 1995-2006 <xs:appinfo> Aleš Janíček ([email protected]) Návrh XML schématu datových typů pro aktualizační dávky zasílané z CEDR AA verze 1.0.0. Toto schéma obsahuje definice datových typů aktualizační dávky v CEDR AA. urn:cz:isvs:mfcr:schemas:cedrII:aa:datatypes:v100 Ministerstvo financí ČR © ASD Software s.r.o., 1995 - 2006 http://app.mfcr.cz/cedr2_XML/schemas/cedr_II/aa/datatypes/v_1.0.0/cedr_aa_datatypes.xsd XML Schema 2006-04-20 2006-04-20 CEDR AA datové typy text/xml
Specifikace služby IS CEDR pro automatické zasílání aktualizačních dávek s výsledky kontrol z IS CEDR, verze 1.0.0 ze dne 28.7.2006. Název souboru : Sluzba_CEDR_AA_v_100.doc Copyright © ASD Software, s.r.o., 1995 - 2006
14
<xs:simpleType name="typ_batch_count"> <xs:annotation> <xs:documentation>Typ počet záznamů v aktualizační dávce <xs:restriction base="xs:int"/> <xs:simpleType name="typ_batch_datetime"> <xs:annotation> <xs:documentation>Typ datum čas pro dávku <xs:restriction base="xs:dateTime"/> <xs:simpleType name="typ_datum_cas"> <xs:annotation> <xs:documentation>Datum a čas <xs:restriction base="xs:dateTime"/> <xs:simpleType name="typ_IC"> <xs:annotation> <xs:documentation>Identifikační číslo <xs:restriction base="xs:string"> <xs:minLength value="8"/> <xs:maxLength value="8"/> <xs:pattern value="\d\d\d\d\d\d\d\d"/> <xs:simpleType name="typ_id_prijd"> <xs:annotation> <xs:documentation>Identifikace příjemce dotace v IS CEDR II <xs:restriction base="xs:string"> <xs:minLength value="11"/> <xs:maxLength value="11"/> <xs:pattern value="[1-9]|[1-9][0-9]{10}"/> <xs:simpleType name="typ_jmeno"> <xs:annotation> <xs:documentation>Jméno fyzické osoby nebo fyzické osoby podnikající <xs:restriction base="xs:string"> <xs:minLength value="1"/> <xs:maxLength value="24"/> <xs:simpleType name="typ_obchodni_jmeno"> <xs:annotation> <xs:documentation>Obchodní jméno u právnické osoby(PO) a fyzické osoby podnikající(FOP) - obchodní jméno podle Obchodního zákoníku §9 <xs:restriction base="xs:string"> <xs:minLength value="1"/> <xs:maxLength value="255"/> <xs:simpleType name="typ_prijmeni"> <xs:annotation> <xs:documentation>Příjmení fyzické osoby nebo fyzické osoby podnikající <xs:restriction base="xs:string"> <xs:minLength value="1"/> <xs:maxLength value="35"/> <xs:simpleType name="typ_question_count"> <xs:annotation> <xs:documentation>Typ počet dotazu <xs:restriction base="xs:int"/>
Specifikace služby IS CEDR pro automatické zasílání aktualizačních dávek s výsledky kontrol z IS CEDR, verze 1.0.0 ze dne 28.7.2006. Název souboru : Sluzba_CEDR_AA_v_100.doc Copyright © ASD Software, s.r.o., 1995 - 2006
15
<xs:simpleType name="typ_question_datetime"> <xs:annotation> <xs:documentation>Typ datum čas pro dotaz <xs:restriction base="xs:dateTime"/> <xs:simpleType name="typ_question_number"> <xs:annotation> <xs:documentation>Číslo dotazu <xs:restriction base="xs:int"/> <xs:simpleType name="typ_rodne_cislo"> <xs:annotation> <xs:documentation>Rodné číslo <xs:restriction base="xs:string"> <xs:minLength value="9"/> <xs:maxLength value="10"/> <xs:pattern value="\d\d(01|02|03|04|05|06|07|08|09|10|11|12|51|52|53|54|55|56|57|58|59|60|61|62)\d\d\d\d\d\d?"/> <xs:simpleType name="typ_titul_pred"> <xs:annotation> <xs:documentation>Titul před jménem osoby <xs:restriction base="xs:string"> <xs:minLength value="2"/> <xs:maxLength value="35"/> <xs:simpleType name="typ_titul_za"> <xs:annotation> <xs:documentation>Titul za jménem osoby <xs:restriction base="xs:string"> <xs:minLength value="2"/> <xs:maxLength value="10"/>
6.2.2 Schéma cedr_aa_batch.xsd <xs:schema xmlns:dcterm="http://purl.org/dc/terms/" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:dtt="urn:cz:isvs:mfcr:schemas:cedrII:aa:datatypes:v100" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns="urn:cz:isvs:mfcr:schemas:cedrII:aa:batch:v100" xmlns:dc="http://purl.org/dc/elements/1.1/" targetNamespace="urn:cz:isvs:mfcr:schemas:cedrII:aa:batch:v100" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:annotation> <xs:documentation xml:lang="cs">Návrh XML schématu aktualizační dávky zasílané z IS CEDR II © ASD Software s.r.o., 1995-2006 <xs:appinfo> Aleš Janíček ([email protected]) Návrh XML schématu zprávy s aktualizační dávkou zaslanou z IS CEDR II verze 1.0.0. Toto schéma obsahuje definice aktualizační dávky v IS CEDR II urn:cz:isvs:mfcr:schemas:cedrII:aa:batch:v100 Ministerstvo financí ČR © ASD Software s.r.o., 1995 - 2006 http://app.mfcr.cz/cedr2_XML/schemas/cedr_II/aa/batch/v_1.0.0/cedr_aa_batch.xsd XML Schema 2006-04-20 2006-04-20 CEDR AA aktualizační dávka text/xml
Specifikace služby IS CEDR pro automatické zasílání aktualizačních dávek s výsledky kontrol z IS CEDR, verze 1.0.0 ze dne 28.7.2006. Název souboru : Sluzba_CEDR_AA_v_100.doc Copyright © ASD Software, s.r.o., 1995 - 2006
16
<xs:import namespace="urn:cz:isvs:mfcr:schemas:cedrII:aa:datatypes:v100" schemaLocation="http://app.mfcr.cz/cedr2_XML/schemas/cedr_II/aa/datatypes/v_1.0.0/cedr_aa_datatypes.xsd"/> <xs:element name="data_batch"> <xs:annotation> <xs:documentation>Element jedné věty <xs:complexType> <xs:sequence> <xs:element name="identifikace_prijemce" type="dtt:typ_id_prijd"/> <xs:element name="IC" type="dtt:typ_IC" minOccurs="0"/> <xs:element name="obchodni_jmeno" type="dtt:typ_obchodni_jmeno" minOccurs="0"/> <xs:element name="rodne_cislo" type="dtt:typ_rodne_cislo" minOccurs="0"/> <xs:element name="titul_pred" type="dtt:typ_titul_pred" minOccurs="0"/> <xs:element name="prijmeni" type="dtt:typ_prijmeni" minOccurs="0"/> <xs:element name="jmeno" type="dtt:typ_jmeno" minOccurs="0"/> <xs:element name="titul_za" type="dtt:typ_titul_za" minOccurs="0"/> <xs:choice> <xs:element name="zmena_ke_dni" type="dtt:typ_datum_cas"/> <xs:element name="zmena_ke_dni_interval"> <xs:complexType> <xs:sequence> <xs:element name="od" type="dtt:typ_datum_cas"/> <xs:element name="do" type="dtt:typ_datum_cas"/> <xs:sequence> <xs:element name="seznam_aktualizaci"> <xs:complexType> <xs:sequence> <xs:element name="aktualizace" maxOccurs="unbounded"> <xs:annotation> <xs:documentation>Element jedné aktualizace <xs:complexType> <xs:sequence> <xs:element name="kod_podminky_aktualizace" type="xs:short"/> <xs:element name="nazev_podminky_aktualizace" type="xs:string"/> <xs:element name="batch"> <xs:annotation> <xs:documentation>Kořenový element dávky <xs:complexType> <xs:sequence> <xs:element ref="data_batch" maxOccurs="unbounded"/> <xs:attribute name="batch_datetime" type="dtt:typ_batch_datetime" use="required"/> <xs:attribute name="batch_count" type="dtt:typ_batch_count" use="required"/>
Specifikace služby IS CEDR pro automatické zasílání aktualizačních dávek s výsledky kontrol z IS CEDR, verze 1.0.0 ze dne 28.7.2006. Název souboru : Sluzba_CEDR_AA_v_100.doc Copyright © ASD Software, s.r.o., 1995 - 2006
17
6.3 Struktura smtp komunikace 6.3.1 Příklad aktualizační dávky <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>[email protected] <eps:from> <eps:address>[email protected] <prop:properties SOAP-ENV:mustUnderstand="1" xmlns:prop="http://schemas.biztalk.org/btf-2-0/properties" Id="idProperties"> <prop:identity>2c30fc8c-8824-4635-867f-ebf824fc59be <prop:sentAt>2006-07-28T11:14:37 <prop:expiresAt>2006-08-28T11:14:37 <prop:topic>urn:cz:isvs:mfcr:schemas:cedrII:aa:batch:v100 Wdar2uMVdHezPWie4JtGqtjFV60= kzKQ/BH2NZ0kMA1C4mkaHWKAW/c= yqQinS9c+D7G1QAbjV5IOb0TLQ0= aFYcAydvTQ95wg6NwMv3nZ1OiK0= MSmjzkgZTiQd41CdmAVMj0zHX2Qxhj7GN2S1BoLzQ+tb7Msj21FHCjoQ+J+6JILA0LvIWzd9nngDK9 wxi/DFKdLYAgQJQj/dcTuhUpLCoMnxBrJz9xpBucKm9tZx6PKP+B+ABMe/iDLmMsW+o/srIMQdCVY=
Specifikace služby IS CEDR pro automatické zasílání aktualizačních dávek s výsledky kontrol z IS CEDR, verze 1.0.0 ze dne 28.7.2006. Název souboru : Sluzba_CEDR_AA_v_100.doc Copyright © ASD Software, s.r.o., 1995 - 2006
18
[email protected], C=CZ, L=Praha, O=Ministerstvo financi, CN=CA Ministerstva financi - aplikace 1139e514000000004905 [email protected], C=CZ, L=Praha, O=Ministerstvo financi, CN=CEDRVK MIID5TCCA4+gAwIBAgIKETnlFAAAAABJBTANBgkqhkiG9w0BAQUFADCBizEgMB4GCSqGSIb3DQE JVibWFzdGVyQG1mY3IuY3oxCzAJBgNVBAYTAkNaMQ4wDAYDVQQHEwVQcmFoYTEdMBsGA1UZXJzdHZvIGZpbmFuY2kxKzApB gNVBAMTIkNBIE1pbmlzdGVyc3R2YSBmaW5hbmgYXBsaWthY2UwHhcNMDUwOTA4MTIyNDE0WhcNMDYwOTA4MTIzNDE0WjB2M ScwJQYJKoZIhQtbGluZUBhc2Qtc29mdHdhcmUuY3oxCzAJBgNVBAYTAkNaMQ4wDAYDVQQHEwVQUEChMUTWluaXN0ZXJzdHZvI GZpbmFuY2kxDzANBgNVBAMTBkNFRFJWSzCBnzAw0BAQEFAAOBjQAwgYkCgYEAo+OiwjyjABDwn44WMWl2umQpsimcfcIHNXcP LbOo1p P5Rk531dEkn7Ji9kunPPOeBsWYSjLvKxj1ocRGDYGA/JUxbwG0P/God1klkaE6G6UUH8yv43Fqa3mkrTCfCafn8FmeanRtQt3sn5sk6sc kXO2IclmvPO2MR0HZcCAwEAAaOCAaMwggGfMA4GUdDwEB/wQEAwIE8DATBgNVHSUEDDAKBggrBgEFBQcDAjAdBgNVHQ4EFg QUYtrGDYTtMZwHNuh//sLi0wgccGA1UdIwSBvzCBvIAUb2fdHufoJnCHUVTp4sHpFWFwcO+hgZGkgY4wgYsxIDw0BCQEWEXdlYm1h c3RlckBtZmNyLmN6MQswCQYDVQQGEwJDWjEOMAwGA1UEBxMFUpbmlzdGVyc3R2byBmaW5hbmNpMSswKQYDVQQDEyJDQS BNaW5pc3RldmEgZmluYW5jaSAtIGFwbGlrYWNlghBVPDF7W4jRt01z02TLlZwtMEEGA1UdHwQ6MDgwNqA oDKGMGh0dHA6Ly9hcHAubWZjci5jei9DZXJ0RW5yb2xsL0NBX01GX2FwbGlrYWNlLmNybDBMBgwPAYIKwYBBQUHMAKGMGh0dH A6Ly9hcHAubWZjci5jei9DZXJ0RW5yb2xsL NBX01GX2FwbGlrYWNlLmNydDANBgkqhkiG9w0BAQUFAANBAFy1pneFX36XGhF+KGVuFKpCdQiH+1l69uHMlK+4lsJVkLDfZyw8W HfpuDE3NK+RiuCEeeILVwg= <SOAP-ENV:Body Id="idBody"> 41000002746 7757164866 <prijmeni>Šlahařová <jmeno>Petra 2006-06-05T15:38:47 <seznam_aktualizaci> 2 Odstranění ukončení kontrolní činnosti 41000406270 72452641 David Kukleta 8102284058 <prijmeni>Kukleta <jmeno>David 2006-06-06T08:36:24 <seznam_aktualizaci> 6 Vydobytí zneužitých prostředků 43362000106 8261064977 <prijmeni>Čikasová <jmeno>Veronika 2006-06-05T14:45:02 <seznam_aktualizaci> 5
Specifikace služby IS CEDR pro automatické zasílání aktualizačních dávek s výsledky kontrol z IS CEDR, verze 1.0.0 ze dne 28.7.2006. Název souboru : Sluzba_CEDR_AA_v_100.doc Copyright © ASD Software, s.r.o., 1995 - 2006
19
Zaplacení zneužitých prostředků
Specifikace služby IS CEDR pro automatické zasílání aktualizačních dávek s výsledky kontrol z IS CEDR, verze 1.0.0 ze dne 28.7.2006. Název souboru : Sluzba_CEDR_AA_v_100.doc Copyright © ASD Software, s.r.o., 1995 - 2006
20
7. Reference [1] BizTalk
BizTalkTM Framework 2.0. Document and Message Specification. Microsoft Corporation, 12-December-2000.
[2] SOAP Simple Object Access Protocol (SOAP) 1.1 W3C Note 08 May 2000. Viz http://www.w3.org/TR/SOAP [3] Standardy komunikace na bázi XML XML - Standardy komunikace na bázi XML - Použití ve finančních a podpůrných informačních systémech. Verze 1.05 ASD Software, s.r.o. 2002. Viz. http://www2004.mfcr.cz/download/xml/xmlkomunikace.zip [4] XML Extensible Markup Language (XML) 1.0 (Second Edition). W3C Recommendation 6 October 2000. Viz http://www.w3.org/TR/REC-xml [5] XML Schema XML Schema Part 0: Primer. W3C Recommendation, 2 May 2001 Viz http://www.w3.org/TR/xmlschema-0/
[6] XSLT XSL Transformations (XSLT) Version 1.1. W3C Working Draft 24 August 2001 Viz http://www.w3.org/TR/xslt11
Specifikace služby IS CEDR pro automatické zasílání aktualizačních dávek s výsledky kontrol z IS CEDR, verze 1.0.0 ze dne 28.7.2006. Název souboru : Sluzba_CEDR_AA_v_100.doc Copyright © ASD Software, s.r.o., 1995 - 2006
21