Automatizace SDNS uživatelská dokumentace

Transkript

1 Autmatizace SDS uživatelská dkumentace ESS Verze 3.0 Strana 1

2 1. Účel a bsah dkumentace Pr účel sběru dat d nebankvních subjektů (dále pužívána zkratka SDS) byla v první etapě realizvána internetvá aplikace SDS, umžňující nebankvním subjektům elektrnicky zasílat pžadvaná data d ČB. Prvz aplikace byl zahájen v rce Přestže aplikace SDS pskytuje vykazujícím subjektům veškeru ptřebnu funkcinalitu pr vykázání dat (prezentace metdických infrmací, vyplnění a deslání výkazů, infrmvání výsledcích zpracvání), je třeba vyplňvat všechna data d výkazů manuálně. Prt byl v druhé etapě rzhdnut (především z důvdu velkéh bjemu pžadvaných dat a zvyšující se frekvence vykazvání) vytvřit ze strany ČB pdpru vykazujícím subjektům k autmatizvanému sestavvání výkazů. V tét dkumentaci je ppsán kncept celkvéh řešení, rzsah pdpry ze strany ČB a rzsah řešení, který si napak bude muset zabezpečit vykazující subjekt. Pdpra ze strany ČB je zaměřena především na pskytvání dat metdickéh i prvzníh charakteru, která umžní autmatizaci některých činnstí na straně vykazujícíh subjektu. Pdstatnu částí tét dkumentace je prt pdrbný ppis těcht dat z věcnéh i technlgickéh hlediska. Dále je zde uveden určitý návd, jak příslušná data k autmatizaci využít. Strana 2

3 2. Kncepce autmatizace SDS 2.1 Sběr dat d nebankvních subjektů d ČB a následujícím brázku je uveden jednduché schéma kmpnent systému sběru dat d nebankvních subjektů d ČB. Dpsud byla využívána k vykazvání puze Aplikace SDS, nyní je systém rzšířen další kmpnenty - rzhraní SDS-WS a Řešení autmatizace SDS na straně vykazujícíh subjektu, které umžní vykazujícím subjektům autmatizvat některé činnsti. I při maximální úrvni řešení autmatizace na straně vykazujícíh subjektu je mžné využívat aplikaci SDS pr některé činnsti. S klesajícím stupněm autmatizace (rzsah autmatizvaných činnstí) bude samzřejmě stupat využití aplikace SDS. Vlba stupně autmatizace plně závisí na rzhdnutí vykazujícíh subjektu, a t jak z hlediska autmatizvaných prcesů, tak i z hlediska autmatizvaných výkazů. Vykazující subjekt může některé výkazy autmatizvat a některé může zasílat puze s využitím aplikace SDS. IS vykazujícíh subjektu Vykazující subjekt Řešení autmatizace SDS Rzhraní Aplikace SDS SDS-WS ČB IS ČB Veškeré kmpnenty řešení je mžn rzdělit d tří vrstev ČB Rzhraní Vykazující subjekt. Vrstva značená Vykazující subjekt je v kmpetenci každéh vykazujícíh subjekt, statní dvě vrstvy jsu v kmpetenci ČB. IS ČB v daném kntextu zabezpečuje veškeru funkcinalitu suvisející s výkaznictvím na straně ČB (především tvrbu metdiky a zpracvání dat). Rzhraní mezi ČB a vykazujícím subjektem je tvřen dvěma kmpnentami Aplikace SDS internetvá aplikace pskytuje vykazujícím subjektům následující funkce prezentace metdických infrmací (veřejná část) Strana 3

4 autentifikace a autrizace k přístupu d registrvané části prezentace přehledu pžadavků (kalendář pžadavků) (registrvaná část) ruční vyplnění výkazu (registrvaná část) imprt dat (v XML) připravených aplikací vykazujícíh subjektu (registrvaná část) mžnst dpčtu sučtvých buněk (registrvaná část) předběžné prvedení jednvýkazvých kntrl před desláním výkazu (registrvaná část) sestavení zprávy v XML a deslání, včetně elektrnickéh pdpisu (registrvaná část) přehled výsledků zpracvání registrace a administrace uživatelských účtů tat část aplikace je využívána i v případě autmatizvanéh zaslání dat prstřednictvím Web Services Aplikace SDS bude využívána i v případě autmatizvanéh zpracvání na straně vykazujícíh subjektu. I při maximálním stupni autmatizace bude tat aplikace využívána pr správu přístupvéh klíče k SDS-WS (dále vysvětlen), Při jakémkliv stupni autmatizace lze aplikaci SDS využívat např. k prhlížení metdických infrmací, k prhlížení výsledků zpracvání, pr pdepsání zprávy a deslání d ČB apd.. SDS-WS pskytuje veškeré metdické i prvzní infrmace ve strukturvané frmě, které může vykazující subjekt pužít pr autmatizaci všech suvisejících prcesů. Tt rzhraní je realizván technlgií Web Services - vykazující subjekt dstane k dispzici ppis služby v jazyce WSDL a musí si vytvřit klientsku aplikaci pr kmunikaci s tut službu. Z věcnéh hlediska zasílá subjekt parametrizvané dtazy na data a zpět dstává výsledky pžadavků na SDS-WS ve frmě XML subrů. Danu frmu budu pskytvány tyt infrmace metdické infrmace jsu členěny d něklika typů dtazů a vykazující subjekt si může vlit, které infrmace bude využívat (např. struktury výkazů, číselníky ad.), sučástí přehled i stav pžadvaných výskytů výkazů výsledky zpracvání v ČB Pdrbný rzsah a ppis pskytvaných infrmací je uveden v kapitle 4.4. Rzhraní SDS-WS rvněž pskytuje služby zaslání vykazvaných dat d ČB získání infrmací výsledcích zpracvání přehled dšlých zpráv s chybu v hlavičce. Ppis těcht služeb není sučástí tét dkumentace. Služby jsu ppsány v samstatném dkumentu Vykazvání dat prstřednictvím SDS Web Services, Příručka uživatele (prgramátra): ad/sdns_web_services_uzivatelska.pdf Strana 4

5 a nebude v tmt dkumentu ppisván. Vykazující subjekt IS vykazujícíh subjektu stávající infrmační systém, který je v daném kntextu zdrjem dat pr výkaznictví (bez hledu na stupeň autmatizace) Řešení autmatizace SDS cílem autmatizace je sestavení výkazu dle metdiky ČB a v předepsaném frmátu XML (příklad je uveden v kapitle 7, XML schema je v samstatné přílze, viz. seznam v kapitle 8) ze zdrjvých dat, které má vykazující subjekt k dispzici ve svém IS. Tat část řešení je plně v kmpetenci vykazujícíh subjektu. Jádrem navržené kncepce je existence datvéh skladu (dále jej nazýváme mezisklad), který bude bsahvat všechna data ptřebná k vykazvání a nad nímž bude realizvána funkcinalita pdprující jedntlivé prcesy suvisející s autmatizací výkaznictví (prcesy jsu ppsány v kapitle 3). Frma implementace a bsah meziskladu není ze strany ČB předepsána, nicméně nejčastěji lze předpkládat databázvé řešení na platfrmě pužívané vykazujícím subjektem. Z bsahvéh hlediska by měl mezisklad bsahvat části pr ulžení následujících typů dat zdrjvá data imprtvaná ze zdrjvých systémů (mhu být již transfrmvaná) metdická data z ČB (rzsah dle ptřeby subjektu) načtená z výstupů získaných prstřednictvím (SDS-WS) data ppisující vztah mezi zdrjvými daty a metdiku ČB (mapvání zdrjvých dat na metdiku) vykazvaná data výsledná vypčtená vykazvaná data případně i prvzní data některá jsu lze získat prstřednictvím SDS-WS Také datvá struktura meziskladu je v kmpetenci vykazujícíh subjektu, nicméně sučástí tht dkumentu je dpručená struktura ulžení dat pskytvaných ze strany ČB (ppis je uveden v kapitle 5). Jelikž vykazující subjekt nemusí využívat celý rzsah pskytvaných infrmací, může být datvá struktura příslušně mezena. Z hlediska funkčníh je rzsah řešení na mnžině autmatizvaných prcesů, minimálně bude třeba řešit imprt/transfrmaci zdrjvých dat klienta pr kmunikaci s rzhraním SDS-WS a příslušných dat d meziskladu mapvání vztahů mezi zdrjvými a vykazvanými daty výpčet vykazvaných dat sestavení zprávy v XML frmátu Odpvědná sba jeden/něklik pracvníků vykazujícíh subjektu, kteří musí zajišťvat: registraci subjektu v ČB registraci uživatele pužívající registrvaný přístup d SDS správu uživatelských účtů prstřednictvím SDS sbní kmunikaci s ČB při řešení prblémů spjených s vykazváním dat. Strana 5

6 2.2 Bezpečnst Zabezpečení systému na straně vykazujícíh subjektu je v kmpetenci tht subjektu. Veškerá kmunikace s aplikací SDS i rzhraním SDS-WS je vedena prtklem HTTPS jak přensvém prtklu pr SOAP. Server se prkazuje servervým certifikátem ČB. Samtná vykazvaná data mhu být i nadále zasílána aplikací SDS, kde je bezpečnst šetřena. Jinak viz služba Zaslání dat. Z prvzních důvdů je přístup k metdickým (zde ppsaným) webvým servisům zajištěn autrizačním klíčem. Autrizační klíč si bude spravvat vykazující subjekt prstřednictvím aplikace SDS v části Správa kntaktních infrmací. Přístupvý klíč bude subjekt zadáván jak parametr dtazu a kntrlván před sestavením výstupu. Služba Zaslání dat je využívána se zaručeným elektrnickým pdpisem, pdrbněji viz příslušná uživatelská příručka. Rvněž služby VYSKYTY_SEZAM, VYDAI_SEZAM a DZ_ERR_SEZAM mají variantu pr pužití s certifikátem. Strana 6

7 3. Prcesy vykazvání 3.1 Přehled prcesů V tét kapitle je ppsán prcesní phled na prblematiku výkaznictví. Autmatizvané vykazvání pžadvaných údajů d ČB je suhrn prcesů, které lze rzdělit d dvu skupin: skupina iniciálních prcesů (prces navázání kntaktu, prces příprava vykazvání), skupina prcesů prvzních činnstí (prces vykázání dat, prces reakce na infrmace zpracvání, prces změna metdiky vykazvání, prces údržba dat). ěkteré z těcht prcesů jsu zcela bez pdpry ze strany ČB (např. údržba dat), u jiných prcesů je pdpra ze strany ČB. V tabulce je uvedená stručná charakteristika prcesů, dále jsu prcesy pdrbněji ppsány s hledem na mžnu autmatizaci. Prces Vstupní stav Výstupní stav Stručný ppis avázání kntaktu Prvtní příprava (na vykazvání dat) ČB ani subjekt neví, že subjekt bude vykazvat. Subjekt v kntaktu s ČB, je registrván v ČB. Mžnst práce s aplikací SDS. Subjekt dpsud elektrnicky nevykazval data. Subjekt v kntaktu s ČB, je registrván v ČB. Mžnst práce s aplikací SDS. Identifikvána zdrjvá data v IS subjektu. Definván způsb výběru dat pr jedntlivé datvé subry (výkazy). Subjekt připraven na prvzní činnsti spjené s vykazváním dat. Identifikace ptřeby sbírat data d danéh subjektu, navázání kntaktu. Zavedení subjektu d systému. Stanvení sb dpvědných za vykazvání. Registrace sb subjektu v PKI. Prvtní přihlášení. Vyřešení případných prblémů s aplikací. Analýza metdiky, identifikace datvých zdrjů, příprava resp. vytvření meziskladu pr zdrjvá data, stanvení algritmů pr dpčty, mapvání zdrjů dat na buňky datvých subrů (výkazů). Vykázání dat (k danému výskytu) Subjekt připraven na prvzní činnsti spjené s vykazváním dat. astal termín, ve kterém se mají vykázat data k danému výskytu. Data úspěšně přijata v ČB. Zahrnuje vytažení zdrjvých dat z IS, jejich transfrmaci d pžadvaných struktur dle metdiky, sestavení a deslání zprávy s vydáním k výskytu výkazu. Reakce na infrmace zpracvání V ČB prběhl zpracvání některých výskytů, jsu k dispzici infrmace zpracvání. Oprava chybných výskytů, ptvrzení výskytů k ptvrzení. Prces pkrývá práci s výskyty, které jsu značeny jak chybné, resp. je pžadván jejich ptvrzení. a základě infrmace zpracvání se vlí další pstup. Změna metdiky Subjekt připraven na prvzní činnsti spjené Identifikvána zdrjvá data v IS subjektu pr nvu metdiku, Aditivní úpravy v identifikvaných datvých zdrjích předchzí metdiky, Strana 7

8 s vykazváním dat v aktuální metdice, zveřejněna nvá metdika. definván způsb výběru dat pr jedntlivé datvé subry. Subjekt připraven na prvzní činnsti spjené s vykazváním dat v nvé metdice. v algritmech pr dpčty, v mapvání. Údržba dat Subjekt připraven na prvzní činnsti spjené s vykazváním dat, některá data úspěšně vykázána. Subjekt připraven na prvzní činnsti spjené s vykazváním dat, vykázaná data zrušena z meziskladu Datvá údržba meziskladu: archivace vykázaných dat, případně rušení neptřebných dat. 3.2 avázání kntaktu Prces navázání kntaktu znamená vytvření pdmínek umžňujících vykazujícímu subjektu vykazvání. a straně ČB vede k registraci vykazujícíh subjektu, a tím k tevření aplikace SDS a případně rzhraní SDS-WS pr daný vykazující subjekt. Aplikace SDS bude pužívána v případě autmatizvanéh i neautmatizvanéh vykazvání. Rzhraní SDS-WS bude pužíván puze v případě autmatizvanéh vykazvání. 3.3 Prvtní příprava Prces je pměrně bsáhlý a znamená vytvření základních (prvtních) pdmínek pr vykazvání. Za nrmálníh průběhu autmatizvanéh vykazvání bude prces prveden puze jednu, je ale mžné jej zpakvat i v případě rzsáhlé změny metdiky vykazvání. Prces přepkládá zveřejnění metdiky vykazvání ze strany ČB. Prces lze rzdělit následujících krků: Analýza metdiky a identifikace zdrjvých dat - tent krk představuje analyticku činnst pracvníka(-ů) vykazujícíh subjektu, který analyzuje pžadavky ČB určené metdiku a identifikuje zdrjvá data. V tmt kamžiku nemusí být definvaný prces transfrmace zdrjvých dat na data vykazvaná. Pdpra ČB v tmt krku je realizvána prezentací metdiky prstřednictvím aplikace SDS neb rzhraním SDS-WS. Pkud subjekt pužije rzhraní SDS-WS, získá metdiku v XML frmě a může v meziskladu vytvřit datvé struktury, d kterých metdiku ulží. Pkud subjekt v tmt krku pracuje s metdiku prstřednictvím aplikací SDS, vytvří tyt struktury až v krku Mapvání. Mapvání - tent krk znamená vlastně detailní rzpracvání výsledku identifikace zdrjvých dat a spčívá v definvání transfrmačních vztahů mezi zdrjvými a vykazvanými daty. Mžné způsby mapvání lze rzdělit d dvu skupin: Mapvání jedntlivých údajů -znamená definvání vztahů mezi vykazvanými údaji a zdrjvými daty přím na úrvni údaje. Objektem vystupujícím v transfrmaci je tedy při tmt přístupu údaj a hdnta údaje je výsledkem transfrmace. ejsu definvány žádné vazby mezi prvky ppisu údaje a zdrjvými daty. Jestliže metdika bsahuje např údajů, bude třeba 1000-krát přiřadit vykazvanému údaji zdrj (vřetně případnéh transfrmačníh vztahu). Druhým způsbem mapvání je mapvání pdle dimenzí - při tmt přístupu není údaj bjektem vystupujícím v transfrmaci. Transfrmační vztahy se definují pr jedntlivé prvky neb pr skupiny prvků ppisu údaje (tj. dimenze) a údaj (resp. jeh hdnta) je puze výsledkem transfrmace. První a pr mapvání klíčvu dimenzí Strana 8

9 je dimenze infrmačníh prvku (vysvětlení pjmu v dkumentaci aplikace SDS), další dimenze dpvídají parametrům. Je pravděpdbné, že mapvání bude mžn nadefinvat samstatně pr infrmační prvky a pr jedntlivé parametry. Spjením pravidel mapvání infrmačníh prvku a jedntlivých parametrů údaje ptm vznikne vazba mezi zdrjvými daty a vykazvaným údajem. Mapvání na úrvni dimenzí je efektivnější varianta, ale také nárčnější na přípravu dat v meziskladu. Výhda tht způsbu spčívá v tm, že jednu nadefinvané pravidl přiřazení se pužije pakvaně pr větší mnžství údajů (prtže infrmační prvky a parametry ppisují většinu větší mnžství údajů). Mapvání pdle dimenzí údaje je rvněž mžné kmbinvat s mapváním jedntlivých údajů. Způsb mapvání pdle dimenzí se při dále dělí: s využitím vazby infrmačních prvků na účetnictví, bez pužití vazby infrmačních prvků na účetnictví. Realizace - znamená vytvření datvých struktur meziskladu a funkcí pr plnění a transfrmaci dat. 3.4 Vykázání dat Prces znamená přeměnu zdrjvých dat na data vykazvaná. Tat přeměna prchází něklika fázemi: imprt dat z IS d meziskladu (pkud již data nejsu v meziskladu připravena), transfrmace dat pdle mapvání, kntrla výsledku transfrmace, prava dat (pkud je třeba), sestavení a deslání připravenéh vydání, dpčtení hdnt sučtvých údajů, spuštění jednvýkazvých kntrl, vytvření, pdepsání a deslání vydání. Pdpra ČB v tmt prcesu se vztahuje k zadání vstupních parametrů a ke všech fázím d deslání připravenéh vydání. Při zadání vstupních parametrů je pdpra ČB realizvána pskytnutím plánu výskytů prstřednictvím SDS i SDS-WS. Plán výskytů v XML frmě si může subjekt ulžit d meziskladu. Ulženéh plánu výskytů lze využít také v prcesu Reakce na infrmace zpracvání. Odeslat připravené vydání je mžné prstřednictvím aplikace SDS. Od kamžiku ulžení jsu vykazvaná data ulžena na straně ČB ve frmě připravenéh vydání k danému výskytu a prstřednictvím rzhraní SDS lze na tmt vydání spustit Dpčet hdnt sučtvých údajů a Jednvýkazvé kntrly. O výsledku těcht akcí se může subjekt infrmvat prstřednictvím aplikace SDS neb rzhraní SDS-WS (viz prces Reakce na infrmace zpracvání). Vytvřit z připravenéh vydání platné vydání, pdepsat jej a deslat lze pět prstřednictvím aplikace SDS. Subjekt všem nemusí tét pdpry využít a vytvřit platné vydání v meziskladu a pté jej prstřednictvím aplikace SDS puze pdepsat a deslat. 3.5 Reakce na infrmace zpracvání Prces navazuje na Vykázání dat. a rzdíl d Vykázání dat, kdy prces prchází vždy stejnu cestu, prvádění tht prcesu se může velmi lišit pdle hdnty vstupních parametrů. Vstupními parametry jsu infrmace zpracvání dané zprávy (vydání). Infrmace jsu z ČB rzesílány zvleným kmunikačním kanálem (typicky em), tj. spuštění tét akce iniciuje ČB, a zárveň jsu infrmace dstupné prstřednictvím aplikace SDS i rzhraní SDS-WS ve frmě XML Strana 9

10 dkumentu, tj. pžadavek infrmaci iniciuje subjekt. Reakce na infrmaci zpracvání se liší pdle jejíh bsahu. Obsah může být trjíh druhu: zpráva byla úspěšně přijata - není čekávána žádná akce vzhledem k ČB, subjekt může reagvat spuštěním prcesu Údržba dat (archivace, rušení, aj.); je pžadván ptvrzení zprávy - znamená t, že ČB pvažuje vykázaná data za pdezřelá (ale nemusí být chybná). Subjekt sám rzhdne, zda jsu data chybná, neb zda je ptvrdí v daném stavu. T může subjekt učinit vytvřením a desláním ptvrzvací zprávy (bez dat, puze se specifickým záhlavím) bje prstřednictvím aplikace SDS. Pkud se jedná chybu v mezivýkazvé kntrle, je nutné pslat ptvrzení na vlastníka MVK vazby; je pžadvána prava dat - znamená, že ČB pvažuje data za chybná a vyžaduje pravu. D stejnéh stavu se dstane subjekt, pkud data vyžadující ptvrzení sám značí za chybná. Subjekt musí identifikvat, zda jsu chybná zdrjvá data, zda je chyba v mapvání, neb zda je chyba v metdice. P dstranění chyby (v případě chyby v metdice ve splupráci s ČB) subjekt spustí prces Vykázání dat. Pdpra tht prcesu ze strany ČB spčívá v pskytnutí infrmací zpracvání, mžnsti vytvřit a deslat ptvrzvací zprávu. 3.6 Změna metdiky Prces je pdbný Prvtní přípravě, prtže při něm prbíhají pdbné činnsti a v krajním případě (ttální změna metdiky) může být výhdné v tmt prcesu dále nepkračvat a přejít d prcesu Prvtní příprava. Skládá se z krků: analýza metdických změn a identifikace neptřebných a nvých zdrjvých dat - tent krk představuje analyticku činnst pracvníka(-ů) vykazujícíh subjektu, který detailně identifikuje metdické změny. Pdpra ČB v tmt krku je realizvána prezentací metdiky prstřednictvím aplikace SDS neb rzhraní SDS-WS. Pžadavky na rzhraní SDS-WS může subjekt parametrizvat tak, aby dpvědi prezentvaly puze nvé a změněné bjekty metdiky(výhda prti aplikaci SDS); úprava datvé struktury meziskladu - tent krk je implementací výsledků předchzíh krku. Při plánvání úprav je všem nutn pčítat s tím, že v kamžiku prezentace nvé metdiky ještě subjekt většinu vykazuje data k půvdní metdice a mezisklad musí být schpen pracvat s více metdikami; úprava prcedur pr exprt zdrjvých dat d meziskladu - tent krk je implementací výsledků krku analýza metdických změn; úprava mapvání - tent krk je becně shdný s Mapváním při Prvtní přípravě, rzdíl je puze v mnžství nvě nadefinvaných neb změněných transfrmačních pravidel. Pdpra ČB v tmt krku je stejná jak v analýze změn a spčívá v prezentaci změn metdiky. 3.7 Údržba dat Prces znamená datvu údržbu meziskladu, tedy případnu archivaci vykázaných dat, aby byl mžn je pskytnut ČB na vyžádání znvu, a dále rušení neptřebných dat (pkud je ptřeba). Může se skládat z těcht činnstí: archivace úspěšně vykázaných dat, rušení úspěšně vykázaných dat z meziskladu, rušení neptřebných zdrjvých dat, rušení neptřebných metdických dat, zrušení neptřebných dat služících k transfrmaci, Strana 10

11 příprava dalšíh zpracvání. Prces nemá pdpru ze strany ČB. Strana 11

12 4. Ppis rzhraní SDS-WS 4.1 SDS-WS charakteristika Rzhraní SDS-WS je webvé rzhraní implementvané technlgií Web-Services. Prstřednictvím tht rzhraní může uživatel zadat 12 různých dtazů (míněn z phledu lgickéh, technlgický phled je ppsán v dstavci 4.3). Dtazy je mžné rzdělit d třech skupin: metdické infrmace dtazy Seznam metdik, Seznam datvých subrů, Seznam dimenzí, Obsah datvéh subru, Obsah dimenzí, Dimenze datvé blasti, Vazba na účetnictví, Ppis infrmačních prvků, Jednvýkazvé kntrly, Mezivýkazvé kntrly. plán výskytů dtaz Seznam výskytů, infrmace zpracvání dtaz Seznam vydání, Přehled chybných dšlých zpráv. Každý dtaz je parametrizvatelný, princip zadávání dtazů je ppsán v dstavci SDS-WS přístup Pvinnými parametry každéh dtazu je kód subjektu a jeh autrizační klíč. Kódem subjektu je zpravidla IČO. Autrizační klíč je textvý řetězec (minimálně 5 znaků - alfanumerické znaky, $, #, _), který si subjekt spravuje sám prstřednictvím aplikace SDS vytvření neb změnu přístupvéh klíče k SDS-WS může prvádět puze registrvaný uživatel přihlášený přiděleným uživatelským kódem a heslem a příslušnu rlí Správce kntaktních infrmací. Kmunikace s SDS-WS je vedena HTTPS prtklem. 4.3 SDS-WS technlgie Rzhraní je realizván technlgií Web-Services, knkrétně jedinu implementací WS vytvřenu pr Oracle 9i rel. 2 SOAP Server. Subjekt dstane k dispzici definici tét služby v jazyce WSDL (verze 1.2). a základě WSDL definice si subjekt musí vytvřit SOAP klienta, který mu umžní rzhraní SDS-WS využít. Služba pskytuje dvě metdy (v jazyce WSDL messages): getparams vstupním textvým parametrem je kód dtazu,tj. jeden z řetězců: METODIKY_SEZAM, DATOVE_SOUBORY_SEZAM, DIMEZE_SEZAM, DATOVE_SOUBORY_OBSAH, DIMEZE_OBSAH, DATOVA_OBLAST_DIMEZE, UCETICTVI, IFORMACI_PRVKY_POPIS, LOGICKE_KOTROLY_SEZAM, MVK_SEZAM, VYSKYTY_SEZAM, VYSKYTY_SEZAM_JH VYDAI_SEZAM, Strana 12

13 VYDAI_SEZAM_JH, DZ_ERR_SEZAM DZ_ERR_SEZAM_JH Přiřazení hdnty řetězce k dtazu je mnemtechnické a nevyžaduje dalšíh kmentáře. Odpvědí vlání metdy je XML dkument, který daný dtaz ppisuje. Tent dkument bsahuje textvý ppis dtazu a seznam parametrů dtazu. U každéh parametru je definván jmén, datvý typ, maska, rzlišení zda je parametr pvinný či nepvinný, seznam přípustných hdnt (pkud existuje). Struktura dkumentu dpvídá XML schématu, které subjekt dstane k dispzici (viz. kapitla 6). perfrmquery - úklem vykazujícíh subjektu je d dkumentu získanéh pmcí getparams dplnit hdnty parametrů (ve skutečnsti t znamená dplnit hdntu určitých XMLelementů, knkrétně XML-elementů <HdntaPar/>) a takt vyplněný subr deslat jak parametr ppisvané službě prstřednictvím vlání metdy perfrmquery. Výsledkem vlání metdy perfrmquery je pět XML dkument. Tent dkument pět dpvídá určitému XML schématu, které subjekt dstane k dispzici (viz. kapitla 6). Jeden dtaz na rzhraní SDS-WS (v lgickém smyslu) se skládá ze třech (resp. dvu) krků: vlání getparams (vlitelný krk), zadání hdnt parametrů (pvinný krk), vlání perfrmquery (pvinný krk). WSDL definice WS a schémata jsu v přílhách, jejichž seznam je v kapitle 8. V kapitle 4.4 jsu ppsány jedntlivé dtazy jejich parametry a struktura výsledku, k některých dtazům jsu v kapitle 6 uvedeny příklady. 4.4 SDS-WS ppis dtazů Tabulky uvedené v tét kapitle ppisují každý z dvanácti dtazů přístupných prstřednictvím SDS- WS. Tabulka pr daný dtaz je rzdělena na tři části: ppis účelu dtazu jaké infrmace daný dtaz pskytuje, stručný kmentář vybraných vstupních parametrů tabulka vstupních parametrů se jménem parametru, seznamem mžných hdnt (tučně je vždy značena default hdnta), významem parametru, tabulka struktury výsledku dtazu s ppisem atributu, jménem entity meziskladu, kteru je mžn daným výsledkem plnit a dpvídajícím atributem tét entity. Jména entit meziskladu a jejich atributů dpvídají návrhu Datvému bsahu meziskladu (viz 5.2) v tmt dkumentu. V knkrétní realizaci meziskladu může být vztah výsledku dtazu k datvé struktuře meziskladu dlišný. SDS-WS věření a autrizace. Ověření a autrizace k dtazvání prstřednictvím rzhraní SDS-WS je řešena na aplikační úrvni. Znamená t, že sučástí každéh dtazu (knkrétně každéh vlání metdy perfrmquery) je dvjice parametrů: kód kmunikujícíh subjektu, autrizační klíč kmunikujícíh subjektu. V některých případech je kmunikující subjekt sučasně vykazujícím, v některých případech zastupuje více jiných subjektů. V kapitle 6 jsu uvedeny příklady některých dtazů. Strana 13

14 Seznam metdik METODIKY_SEZAM Ppis účelu dtazu Účelem je získat seznam zveřejněných metdik s bdbím jejich platnsti. Pskytuje především infrmaci, d kdy platí nvá metdika. Metdiky jsu v ČB členěny d funkčních blastí (každá metdika patří d jedné funkční blasti). Vstupním parametrem Rzsah lze zvlit, zda má výsledný seznam bsahvat všechny metdiky neb puze metdiky týkající se danéh subjektu. Předpkládá se, že vykazující subjekt budu zajímat puze metdiky, které se jej týkají, a prt bude v dtazu zadána hdnta VYKAZOVAT. Vstupními parametry ObdbiOd a ObdbiD se vymezí bdbí platnsti metdik. Dle zadanéh bdbí bude seznam bsahvat metdiky, které suvisí se zadaným bdbím. Vstupní parametry Parametr Mžné hdnty Význam Subjekt Kód subjektu Kódem subjektu je zpravidla ÍČO AuthKey Autrizační klíč Autrizační klíč subjektu Rzsah ObdbiOd ObdbiD VSE VYKAZOVAT Datum evyplněná hdnta Datum Pskytnuté infrmace a jejich pužití evyplněná hdnta Ppis Entita meziskladu Atribut Všechny metdiky Puze metdiky pr daný subjekt Metdiky platné v bdbí d zadanéh data Bez mezení Metdiky platné v bdbí d zadanéh data Bez mezení Kód funkční blasti METODIKA FUKCI_OBLAST Kód metdiky METODIKA ID Datum pčátku platnsti metdiky Datum knce platnsti metdiky METODIKA METODIKA PLA_OD PLA_DO Strana 14

15 Seznam datvých subrů DATOVE_SOUBORY_SEZAM Ppis účelu dtazu Účelem je získat seznam datvých subrů (výkazů) platných v určitém bdbí. Seznam datvých subrů je zpravidla první infrmací, kteru ptřebuje vykazující subjekt k metdice znát. Vstupním parametrem Rzsah lze zvlit, zda má výsledný seznam bsahvat všechny datvé subry neb puze datvé subry, které se týkají danéh subjektu (tzn. tyt datvé subry má subjekt zasílat). Předpkládá se, že vykazující subjekt budu zajímat puze datvé subry, které se jej týkají, a prt bude v dtazu zadána hdnta VYKAZOVAT. Zejména při změně metdiky je výhdné zjistit seznam nvých neb změněných datvých subrů. V tmt případě lze pužít vstupní parametr Změna s hdntu A. Vstupními parametry ObdbiOd a ObdbiD se vymezí bdbí platnsti metdik, pr které má být seznam datvých subrů vytvřen. Dle hdnt těcht parametrů lze zaslat seznam pr jednu metdiku neb seznamy pr více metdik. Ke každému datvému subru existuje textvý ppis se stručnu charakteristiku danéh datvéh subru. Seznam datvých subrů bsahvat může i tent ppis jedntlivých datvých subrů, pkud byla zadána pr vstupní parametr Ppis hdnta A. Vstupní parametry Parametr Hdnty Význam Subjekt Kód subjektu Kódem subjektu je zpravidla ÍČO AuthKey Autrizační klíč Autrizační klíč kmunikujícíh subjektu Rzsah Změna ObdbiOd ObdbiD Ppis VSE VYKAZOVAT A Datum evyplněná hdnta Datum evyplněná hdnta A Pskytnuté infrmace a jejich pužití Všechny datvé subry Puze datvé subry pr daný subjekt Puze nvé a změněné datvé subry v metdice Všechny datvé subry Platné v bdbí d Bez mezení Platné v bdbí d Bez mezení Pžadván ppis epžadván ppis Ppis Entita meziskladu Atribut entity/vazba Kód metdiky DATOVY_SOUBOR Vazba na metdiku Kód datvéh subru DATOVY_SOUBOR ID ázev datvéh subru DATOVY_SOUBOR AZEV Verze datvéh subru DATOVY_SOUBOR VERZE Strana 15

16 Varianta datvéh subru DATOVY_SOUBOR VARIATA Příznak nvý/změna DATOVY_SOUBOR ZMEA Ppis datvéh subru DATOVY_SOUBOR POPIS Strana 16

17 Seznam dimenzí DIMEZE_SEZAM Ppis účelu dtazu Každý pžadvaný údaj, jehž hdnta má být zasílána d ČB, je ppsán mnžinu dimenzí s hdntami. Obecně je v metdice pr ppis údajů pužita mnžina dimenzí, každá dimenze má definvaný br hdnt (zpravidla číselník) a každý údaj je ppsán vybranu pdmnžinu dimenzí s hdntami. Tyt dimenze lze pužít pr mapvání vztahů mezi zdrjvými a vykazvanými údaji (věcně neb i technlgicky). Účelem tht dtazu je získat úplný seznam dimenzí pr určitu metdiku. Dalšími dtazy lze k pžadvaným dimenzím získat další infrmace. Pkud vykazující subjekt bude implementvat metdiku část meziskladu dle dpručení v tmt dkumentu, bude tent seznam pužit k vygenervání struktury tabulek entit MET_HODOTA_S a MET_HODOTA_D Vstupním parametrem Rzsah lze zvlit, zda má výsledný seznam bsahvat dimenze údajů všech datvých subrů neb puze údajů z datvých subrů, které se týkají danéh subjektu (tzn. tyt datvé subry má subjekt zasílat). Předpkládá se, že vykazující subjekt budu zajímat puze dimenze údajů datvých subrů, které se jej týkají, a prt bude v dtazu zadána hdnta VYKAZOVAT. Vstupními parametry ObdbiOd a ObdbiD se vymezí bdbí platnsti metdik, pr které má být seznam dimenzí vytvřen. Dle hdnt těcht parametrů lze zaslat seznam pr jednu metdiku neb seznamy pr více metdik. Ke každému dimenzi existuje textvý ppis se stručnu charakteristiku dané dimenze. Seznam dimenzí může bsahvat i tent ppis jedntlivých dimenzí, pkud byla zadána pr vstupní parametr Ppis hdnta A. Vstupní parametry Parametr Hdnty Význam Subjekt Kód subjektu Kódem subjektu je zpravidla ÍČO AuthKey Autrizační klíč Autrizační klíč kmunikujícíh subjektu ObdbiOd ObdbiD Rzsah Ppis Datum evyplněná hdnta Datum evyplněná hdnta VSE VYKAZOVAT A Pskytnuté infrmace a jejich pužití Platné v bdbí_d Bez mezení Platné v bdbí_d Bez mezení Všechny dimenze Puze dimenze týkající se subjektu Pžadván ppis epžadván ppis Ppis Entita meziskladu Atribut entity Kód metdiky DIMEZE Vazba na metdiku Kód dimenze DIMEZE MET_HODOTA_S ID ázev slupce Pxxxx Strana 17

18 MET_HODOTA_D ázev dimenze DIMEZE AZEV Ppis dimenze DIMEZE POPIS Dynamická indikace, zda je dimenze dynamická a má být pužita pr tabulku MET_HODOTY_D DIMEZE ázev slupce Pxxxx DYAMICKA Strana 18

19 Obsah datvéh subru DATOVE_SOUBORY_OBSAH Ppis účelu dtazu Tent dtaz je velmi důležitý, prtže pskytuje nutné infrmace bsahu datvéh subru, kterými jsu: - seznam datvých blastí (tabulek), d kterých je datvý subr rzdělen - seznam údajů datvéh subru s vazbu na jeh pzici v knkrétní datvé blasti (datvá blast, řádek, slupec) - tzv. sémantický ppis údajů, tj. ppis údaje prstřednictvím dimenzí a jejich hdnt - další infrmace - např. maska pžadvanéh frmátu; násbek vykazvaných hdnt (např. jedntky, tisíce, miliny) ad. - seznam dynamických parametrů jejichž hdnty jsu vyplňvány na straně vykazujícíh subjektu a psílány splečně s údaji, včetně vazby na pzice v datvé blasti (datvá blast, řádek). Vstupními parametry lze zvlit rzsah pskytnutých infrmací. Minimální jedntku je jeden knkrétní datvý subr v knkrétní metdice. Přestže lze najednu získat infrmace pr všechny datvé subry a t i za více metdik, je vzhledem k velkému mnžství infrmací (zejména v případě větších datvých subrů) ptimální zadávat dtazy právě pr knkrétní datvý subr. Vstupním parametrem Rzsah lze zvlit, zda má výsledný seznam bsahvat infrmace všech datvých subrů neb puze k datvým subrům, které se týkají danéh subjektu (tzn. tyt datvé subry má subjekt zasílat). Předpkládá se, že vykazující subjekt budu zajímat puze infrmace k datvým subrům, které se jej týkají, a prt bude v dtazu zadána hdnta VYKAZOVAT. Vstupními parametry ObdbiOd a ObdbiD se vymezí bdbí platnsti metdik, pr které mají být infrmace zaslány. V případě těcht parametrů je ptimální zadat hdnty pr knkrétní metdiku. Při změně metdiky může být účelné získat infrmace puze k nvým neb změněným datvým subrům. V tmt případě se zadá pr parametr Změna hdnta A. Vstupním parametrem DatvySubr lze zadat pžadavek infrmací pr knkrétní datvý subr. Prtže sémantický ppis údajů nemusí vykazující subjekty někdy využívat, je zasílání tét infrmace vlitelné. Pkud je sémantický ppis pžadván, musí být vstupní parametr SemantickyPpis zadán s hdntu A. Ke každému datvé blasti existuje textvý ppis se stručnu charakteristiku dané datvé blasti. Seznam dimenzí může bsahvat i tent ppis jedntlivých dimenzí, pkud byla zadána pr vstupní parametr Ppis hdnta A. Vstupní parametry Parametr Hdnty Význam Subjekt Kód subjektu Kódem subjektu je zpravidla ÍČO AuthKey Autrizační klíč Autrizační klíč kmunikujícíh subjektu Rzsah ObdbiOd VSE VYKAZOVAT Datum evyplněná hdnta Všechny datvé subry Puze vykazvané Platné v bdbí d Bez mezení Strana 19

20 ObdbiD Změna Datum evyplněná hdnta A Platné v bdbí d Bez mezení Puze nvé a změněné datvé subry DatvySubr SemantickyPpis Ppis Pskytnuté infrmace Kód datvéh subru evyplněná hdnta A A Všechny datvé subry Kód knkrétníh datvéh subru Bez mezení Pžadván sémantický ppis epžadván sémantický ppis Pžadván ppis epžadván ppis Ppis Entita meziskladu Atribut entity Kód metdiky DATOVA_OBLAST MET_HODOTA_S Vazba na metdiku Vazba na metdiku Kód datvéh subru DATOVA_OBLAST Vazba na datvý subr Kód datvé blasti DATOVA_OBLAST ID ázev datvé blasti DATOVA_OBLAST AZEV Ppis datvé blasti DATOVA_OBLAST POPIS Příznak nvý/změna pr datvu blast Identifikátr údaje / Dynamický parametr DATOVA_OBLAST MET_HODOTA_S ZMEA Čísl řádku MET_HODOTA_S RADEK Čísl slupce MET_HODOTA_S SLOUPEC Indikace, zda je údaj dynamický MET_HODOTA_S UDAJ / Dynamický parametr DYAMICKY Datvý typ údaje MET_HODOTA_S DATATYP ásbek údaje MET_HODOTA_S ASOBEK Maska MET_HODOTA_S MASKA Sémantický ppis MET_HODOTA_S Hdntu atributu je vnřená tabulka se sémantickým ppisem, tj. s atributy Kód a hdnta dimenze. Strana 20

21 Obsah dimenze DIMEZE_OBSAH Ppis účelu dtazu Účelem je získat hdnt dimenzí s jejich názvy, případně i textvými ppisy. Rzlišujeme následující 3 typy dimenzí, kterými jsu ppsány pžadvané údaje - infrmační prvky (základní ukazatel) seznam je tvřen všemi infrmačními prvky s jejich kódy, názvy a případně i textvými ppisy - parametr nad číselníkem seznam je tvřen plžkami příslušnéh číselníku s jejich kódy, názvy a případně i textvými plžkami; prtže některé plžky jsu tzv. sučtvé (plžka je svým věcným významem agregací jiných plžek), je pr takvu plžku uveden také seznam příslušných elementárních plžek. - parametr nad datvý typem seznam je tvřen definvanými intervaly nad datvými typy, které jsu pužity pr ppis údajů. Zadáním vstupních parametrů lze zvlit rzsah pžadvaných infrmací. Seznam lze získat pr knkrétní dimenzi neb i více dimenzí, a t i za více metdik. Vstupním parametrem Rzsah lze zvlit, zda má výsledný seznam bsahvat prvky všech dimenzí neb puze dimenzí, které se týkají danéh subjektu. Předpkládá se, že vykazující subjekt budu zajímat puze infrmace k dimenzím, které se jej týkají, a prt bude v dtazu zadána hdnta VYKAZOVAT. Vstupními parametry ObdbiOd a ObdbiD se vymezí bdbí platnsti metdik, pr které mají být infrmace zaslány. V případě těcht parametrů je ptimální zadat hdnty pr knkrétní metdiku. Vstupním parametrem Dimenze lze zadat pžadavek infrmací pr knkrétní dimenzi. Ke každému prvku dimenze může existvat textvý ppis, který pdrbněji definuje věcný význam. Seznam hdnt dimenzí může bsahvat i tent ppis, pkud byla zadána pr vstupní parametr Ppis hdnta A. Seznam infrmačních prvků s jejich názvy a případně definicemi, seznam hdnt parametrů, tj. plžek číselníků s názvy a případně definicemi neb seznam intervalů nad datvými typy. Pr sučtvé plžky číselníků jsu zasílány i kódy jejich elementárních plžek. Vstupní parametry Parametr Hdnty Význam Subjekt Kód subjektu Kódem subjektu je zpravidla ÍČO AuthKey Autrizační klíč Autrizační klíč kmunikujícíh subjektu Rzsah ObdbiOd VSE VYKAZOVAT Datum evyplněná hdnta Všechny dimenze Puze ptřebné dimenze Platné v bdbí d Bez mezení Strana 21

22 ObdbiD Dimenze Ppis Pskytnuté infrmace Datum evyplněná hdnta Kód dimenze evyplněná hdnta A Platné v bdbí d Bez mezení Kód knkrétní dimenze Bez mezení Pžadván textvý ppis Ppis Entita meziskladu Atribut entity epžadván textvý ppis Kód metdiky HODOTA_DIMEZE Vazba na metdiku Kód dimenze HODOTA_DIMEZE Vazba na dimenzi Kód hdnty (IP, plžky číselníku, intervalu DT) ázev hdnty (IP, plžky číselníku, intervalu DT) HODOTA_DIMEZE HODOTA_DIMEZE ID AZEV Příznak nvá/změněná HODOTA_DIMEZE ZMEA Ppis hdnty (IP, plžky číselníku, intervalu DT) Infrmace elementárních plžkách k sučtvé HODOTA_DIMEZE HODOTA_DIMEZE_ELEM POPIS Vazba sučtvá elementární plžka. Hdntu atributu je vnřená tabulka s kódy elementárních plžek. Strana 22

23 Dimenze datvé blasti DATOVA_OBLAST_DIMEZE Ppis účelu dtazu Účelem je získat seznam dimenzí datvé blasti a jejich hdnt. a rzdíl d celkvéh seznamu pužitých dimenzí a hdnt jedntlivých dimenzí (např. celých číselníků), pskytuje tent seznam infrmace knkrétních dimenzích datvé blasti a knkrétních pužitých hdntách. Existují tři typy dimenzí: - Infrmační prvky (základní ukazatel) seznam je tvřen všemi infrmačními prvky s jejich kódy, názvy a případně i textvými ppisy, - Parametr nad číselníkem seznam je tvřen plžkami příslušnéh číselníku s jejich kódy, názvy a případně i textvými plžkami. Pr tzv. sučtvé plžky je uveden také seznam příslušných elementárních plžek, - Parametr nad datvým typem seznam je tvřen definvanými intervaly nad datvými typy, které jsu pužity pr ppis údajů. Prtže je tent výstup využíván pr účel sestavení struktury datvé blasti, bsahuje rvněž infrmace přadí prvků dimenze v rámci datvé blasti, su dimenze a přadí dimenze v rámci sy. Rvněž bude pskytvána infrmace, zda je dynamický parametr sučástí unikátníh klíče a případně kteréh, v případě existence více unikátních klíčů. Uvedené infrmace lze získat najednu pr všechny datvéh blasti celé metdiky, a t i za více metdik, neb napak i pr knkrétní datvu blast v knkrétní metdice. Rzsah infrmací, které se získají jedním prvedením dtazu, je dán zadáním vstupních parametrů. Vstupním parametrem Rzsah lze zvlit, zda má výsledný seznam bsahvat příslušné infrmace pr všechny datvé subry neb puze ty, které se týkají danéh subjektu. Předpkládá se, že vykazující subjekt budu zajímat puze infrmace k datvým subrům, které se jej týkají, a prt bude v dtazu zadána hdnta VYKAZOVAT. Vstupními parametry ObdbiOd a ObdbiD se vymezí bdbí platnsti metdik, pr které mají být infrmace zaslány. V případě těcht parametrů je ptimální zadat hdnty pr knkrétní metdiku. Při změně metdiky může být účelné získat infrmace puze pr nvé neb změněné datvé subry. V daném případě je třeba zadat parametr Změna s hdntu A. ejčastěji budu zřejmě infrmace pžadvány pr knkrétní datvý subr neb dknce knkrétní datvu blast. V daném případě se zadá hdnta parametr DatvySubr neb DatvaOblast. Vstupní parametry Parametr Hdnty Význam Subjekt Kód subjektu Kódem subjektu je zpravidla IČO AuthKey Autrizační klíč Autrizační klíč kmunikujícíh subjektu ObdbiOd ObdbiD Datum evyplnění hdnta Datum evyplněná hdnta Platné v bdbí d Bez mezení Platné v bdbí d Bez mezení Rzsah VSE Za všechny datvé subry Puze vykazvané datvé Strana 23

24 Zmena DatvySubr DatvaOblast Pskytnuté infrmace VYKAZOVAT A Kód datvéh subru evyplněná hdnta Kód datvé blasti evyplněná hdnta subry Puze nvé a změněné datvé subry Bez mezení Kód knkrétníh datvéh subru Bez mezení Kód knkrétní datvé blasti Bez mezení Ppis Entita meziskladu Atribut entity Kód metdiky DIMEZE_DO HODOTA_DIMEZE_DO Vazba na metdiku Kód datvé blasti DIMEZE_DO Vazba na datvu blast Kód dimenze DIMEZE_DO Vazba na dimenzi Typ dimenze DO (knstantní, statická, dynamická) DIMEZE_DO TYP Kód hdnty HODOTA_DIMEZE_DO ID Osa dimenze (R řádky, S- slupce, K - karty) HODOTA_DIMEZE_DO OSA Přadí dimenze HODOTA_DIMEZE_DO PORADI Hdnta dimenze HODOTA_DIMEZE_DO HODOTA Přadí hdnty dimenze HODOTA_DIMEZE_DO PORADI_HODOTA Unikátnst HODOTA_DIMEMZE_DO UIKATOST IPPvinny HODOTA_DIMEZE_IP POVIY Indikace sučtvé hdnty HODOTA_DIMEZE_PCI SOUCTOVA Datvý typ HODOTA_DIMEZE_DT DATATYP Maska HODOTA_DIMEZE_DT MASKA Délka HODOTA_DIMEZE_DT DELKA Pčet desetinných míst HODOTA_DIMEZE_DT DESETIY Hdnta dlní meze intervalu HODOTA_DIMEZE_DT DOLI_MEZ Hdnta hrní meze intervalu HODOTA_DIMEZE_DT HORI_MEZ Strana 24

25 Vazba na účetnictví - UCETICTVI Ppis účelu dtazu Účelem je získat infrmace vazbě infrmačních prvků na účetnictví. Infrmační prvky mhu mít definvánu mnžinu syntetických účtů, s nimiž suvisí. Vazba na účetnictví může bsahvat i další infrmace (pdrbně je vysvětlen v dkumentaci k aplikaci SDS). V některých případech může být účelné využít tut vazbu k mapvání vztahu mezi zdrjvými a vykazvanými daty. Vstupním parametrem Rzsah lze zvlit, zda má výsledný seznam bsahvat příslušné infrmace k infrmačním prvkům všech datvých subrů neb puze těch, které se týkají danéh subjektu. Předpkládá se, že vykazující subjekt budu zajímat puze infrmace k datvým subrům, které se jej týkají, a prt bude v dtazu zadána hdnta VYKAZOVAT. Vstupními parametry ObdbiOd a ObdbiD se vymezí bdbí platnsti metdik, pr které mají být infrmace zaslány. V případě těcht parametrů je ptimální zadat hdnty pr knkrétní metdiku. ěkdy může být účelné získat dané infrmace puze k infrmačním prvků knkrétníh datvéh subru. Ptm je třeba zadat hdntu vstupníh parametru DatvySubr. Vstupní parametry Parametr Hdnty Význam Subjekt Kód subjektu Kóde subjektu je zpravidla IČO AuthKey Autrizační klíč Autrizační klíč kmunikujícíh subjektu ObdbiOd ObdbiD Rzsah DatvySubr Pskytnuté infrmace Datum evyplněná hdnta Datum evyplněná hdnta VSE VYKAZOVAT Kód datvéh subru evyplněná hdnta Platné v bdbí d Bez mezení Platné v bdbí d Bez mezení Za všechny datvé subry Puze za vykazvané datvé subry Kód knkrétníh datvéh subru Bez mezení Ppis Entita meziskladu Atribut entity Kód metdiky VAZBA_IP_A_UCTY Vazba na metdiku Kód infrmačníh prvku VAZBA_IP_A_UCTY Vazba na infrmační prvek (hdntu dimenze) Kód účtu VAZBA_IP_A_UCTY UCET Typ vazby VAZBA_IP_A_UCTY TYP_VAZBY Operátr VAZBA_IP_A_UCTY OPERATOR Část účtu VAZBA_IP_A_UCTY CAST Indikace výběru účtu VAZBA_IP_A_UCTY VYBEROVE Strana 25

26 Infrmační prvky ppis IFORMACI_PRVKY_POPIS Ppis účelu dtazu Účelem je získat vazbu mezi Infrmačními prvky (primárními) a Sekundárními infrmačními prvky d nich dvzených. Sémantický ppis údaje ve výstupu DATOVE_SOUBORY_OBSAH vždy bsahuje tzv. primární infrmační prvky. Seznam dimenzí a jejich hdnt ve výstupu DIMEZE_OBSAH může míst primárníh prvku bsahvat tzv. sekundární infrmační prvek. Sekundární inf. prvek dpvídá primárnímu inf. prvku plus jednmu neb více parametrů, které dplňují bsahvý význam daný primárním inf. prvkem. Příklad: ABD Hypteční úvěry, ABD0312_002 - *Hypteční úvěry - k financvání nemvitstí na bydlení ABD0312_002= ABD0312(P0021.S_HUEMB) Existence sekundárních IP je z důvdů jedntné sady dimenzí v rámci datvé blasti. V případě pužití ABD0312_002 v datvé blasti je dimenze P0021 vzhledem k datvé blasti skryta. Výstup DIMEZE_OBSAH bsahuje IP skutečně pužité v rámci dané datvé blasti. Výstup DATOVE_SOUBORY_OBSAH bsahuje primární IP, prtže cílem tht výstupu byl prezentvat ppisy údajů glbálně se všemi dimenzinálními jedntlivými IP. Vztah mezi sekundárními a primárními IP je bsahem tét služby. Vstupními parametry ObdbiOd a ObdbiD se vymezí bdbí platnsti metdik, pr které má být seznam infrmačních prvků vytvřen. Dle hdnt těcht parametrů lze zaslat seznam pr jednu metdiku neb seznamy pr více metdik. Vstupním parametrem DatvySubr lze dtaz mezit puze na jeden knkrétní datvý subr a jeh Infrmační prvky. Implicitně je tent parametr nevyplněn. Vstupní parametry Parametr Hdnty Význam Subjekt Kód subjektu Kódem subjektu je zpravidla IČO AuthKey Autrizační klíč Autrizační klíč kmunikujícíh subjektu ObdbiOd ObdbiD DatvySubr Datum evyplněná hdnta Datum evyplněná hdnta Kód datvéh subru evyplněná hdnta Datvé subry platné v bdbí d Bez mezení Platné v bdbí d Bez mezení Kód knkrétníh datvéh subru Bez mezení Strana 26

27 Pskytnuté infrmace a jejich pužití Ppis Entita meziskladu Atribut entity/vazba Kód metdiky IFORMACI_PRVKY_POPIS Vazba na metdiku Kód sekundárníh IP IFORMACI_PRVKY_POPIS ID Sémantický ppis IP IFORMACI_PRVKY_POPIS vnřená entita SEMATICKY_POPIS Strana 27

28 Seznam jednvýkazvých kntrl LOGICKE_KOTROLY_SEZAM Ppis účelu dtazu Účelem je získat seznam jednvýkazvých kntrl (JVK) pr: - datvé subry platné v určitém bdbí neb - knkrétní zadaný datvý subr Vstupním parametrem Rzsah lze zvlit, zda má výsledný seznam bsahvat krky kntrl pr všechny datvé subry neb puze pr datvé subry, které se týkají danéh subjektu (tzn. tyt datvé subry má subjekt zasílat). Předpkládá se, že vykazující subjekt budu zajímat puze datvé subry a lgické kntrly, které se jej týkají, a prt bude v dtazu zadána implicitně hdnta VYKAZOVAT. Zejména při změně metdiky je výhdné zjistit seznam krků lgických kntrl pr nvé neb změněné datvé subry. V tmt případě lze pužít vstupní parametr Změna s hdntu A, jeh implicitní hdnta je však. Vstupními parametry ObdbiOd a ObdbiD se vymezí bdbí platnsti metdik, pr které má být seznam datvých subrů s lgickými kntrlami vytvřen. Dle hdnt těcht parametrů lze zaslat seznam pr jednu metdiku neb seznamy pr více metdik. Vstupním parametrem DatvySubr lze dtaz mezit puze na jeden knkrétní datvý subr a jeh krky JVK. Implicitně je tent parametr nevyplněn. Psledním vstupním parametrem je SemantickyPpis. Hdnta tht parametru určuje, zda se d výstupu zahrne i neuživatelský (sémantický) definiční text kntrly. Implicitně má tent parametr hdntu. Vstupní parametry Parametr Hdnty Význam Subjekt Kód subjektu Kódem subjektu je zpravidla IČO AuthKey Autrizační klíč Autrizační klíč kmunikujícíh subjektu Rzsah ObdbiOd ObdbiD Změna VSE VYKAZOVAT Datum evyplněná hdnta Datum evyplněná hdnta A Krky LK všech datvých subrů Krky LK puze pr vykazvané Datvé subry platné v bdbí d Bez mezení Datvé subry platné v bdbí d Bez mezení Puze nvé a změněné datvé subry Všechny datvé subry Strana 28

29 DatvySubr SemantickyPpis Kód datvéh subru evyplněná hdnta A Pskytnuté infrmace a jejich pužití Kód knkrétníh datvéh subru Bez mezení Pžadván sémantický ppis krků epžadván sémantický ppis Ppis Entita meziskladu Atribut entity/vazba Kód metdiky DATOVY_SOUBOR Vazba na metdiku Kód datvéh subru KROK_KOTROLY Vazba na datvý subr Kód krku lgické kntrly KROK_KOTROLY KOD Druh kntrly KROK_KOTROLY DRUH ázev krku lgické kntrly KROK_KOTROLY AZEV Uživatelský text kntrly KROK_KOTROLY OBSAH_UZIVATELSKY Sémantický text kntrly KROK_KOTROLY OBSAH_SEMATICKY Strana 29

30 Seznam jednvýkazvých kntrl MVK_SEZAM Ppis účelu dtazu Účelem je získat seznam mezivýkazvých kntrl (MVK) pr: - datvé subry platné v určitém bdbí neb - knkrétní zadaný datvý subr Vstupním parametrem Rzsah lze zvlit, zda má výsledný seznam bsahvat krky mezivýkazvých kntrl pr všechny datvé subry neb puze pr datvé subry, které se týkají danéh subjektu (tzn. tyt datvé subry má subjekt zasílat). Předpkládá se, že vykazující subjekt budu zajímat puze datvé subry a mezivýkazvé kntrly, které se jej týkají, a prt bude v dtazu zadána implicitně hdnta VYKAZOVAT. Zejména při změně metdiky je výhdné zjistit seznam krků mezivýkazvých kntrl pr nvé neb změněné datvé subry. V tmt případě lze pužít vstupní parametr Změna s hdntu A, jeh implicitní hdnta je však. Vstupními parametry ObdbiOd a ObdbiD se vymezí bdbí platnsti metdik, pr které má být seznam datvých subrů s mezivýkazvými kntrlami vytvřen. Dle hdnt těcht parametrů lze zaslat seznam pr jednu metdiku neb seznamy pr více metdik. Vstupním parametrem DatvySubr lze dtaz mezit puze na jeden knkrétní datvý subr a jeh krky MVK. Implicitně je tent parametr nevyplněn. Psledním vstupním parametrem je SemantickyPpis. Hdnta tht parametru určuje, zda se d výstupu zahrne i neuživatelský (sémantický) definiční text kntrly. Implicitně má tent parametr hdntu. Vstupní parametry Parametr Hdnty Význam Subjekt Kód subjektu Kódem subjektu je zpravidla IČO AuthKey Autrizační klíč Autrizační klíč kmunikujícíh subjektu Rzsah ObdbiOd ObdbiD VSE VYKAZOVAT Datum evyplněná hdnta Datum evyplněná hdnta Krky MVK všech datvých subrů Krky MVK puze pr vykazvané Datvé subry platné v bdbí d Bez mezení Datvé subry platné v bdbí d Bez mezení Změna A Puze nvé a změněné datvé subry Všechny datvé subry Strana 30

31 DatvySubr SemantickyPpis Kód datvéh subru evyplněná hdnta A Pskytnuté infrmace a jejich pužití Kód knkrétníh datvéh subru Bez mezení Pžadván sémantický ppis krků epžadván sémantický ppis Ppis Entita meziskladu Atribut entity/vazba Kód metdiky DATOVY_SOUBOR Vazba na metdiku Kód datvéh subru MV_KOTROLA Vazba na datvý subr Kód mezivýkazvé kntrly MV_KOTROLA ID ázev mezivýkazvé kntrly MV_KOTROLA AZEV Kód mezivýkazvé kntrly CLE_MV_KOTROLY Vazba na mezivýkazvu kntrlu Kód datvéh subru CLE_MV_KOTROLY Vazba na datvý subr Relativní bdbí CLE_MV_KOTROLY RELOBD Kód mezivýkazvé kntrly KROK_MV_KOTROLY Vazba na mezivýkazvu kntrlu Kód krku kntrly KROK_MV_KOTROLY KOD Druh kntrly KROK_MV_KOTROLY DRUH ázev krku kntrly KROK_MV_KOTROLY AZEV Uživatelský text kntrly KROK_MV_KOTROLY OBSAH_UZIVATELSKY Sémantický text kntrly KROK_MV_KOTROLY OBSAH_SEMATICKY Strana 31

32 Seznam výskytů VYSKYTY_SEZAM Ppis účelu dtazu Účelem je získat jednak vlastní kalendář vykazvacích pvinnstí, ale také průběžně aktualizvat infrmace k jedntlivým výskytům jejich stavu. Subjekt získá infrmace puze k vlastním výskytům, cž jsu výskyty, které může zaslat. Pkud tedy určitý subjekt zastupuje více jiných (např. investiční splečnst vykazuje za jedntlivé fndy), může získat infrmace výskytech všech těcht subjektů. Ve vstupním parametru Subjekt se vyplňuje kód kmunikujícíh subjektu, který může být někdy dlišný d vykazujícíh subjektu. Vstupními parametry ObdbiOd, ObdbiD, SubjektV, RzsahV a DatvySubr se vymezí mnžina výskytů datvých subrů. Služba má variantu pr uživatele s certifikátem veřejné CA míst pužití autrizačníh kódu VYSKYTY_SEZAM_JH, viz dkumentace: s_web_services_uzivatelska.pdf Vstupní parametry Parametr Hdnty Význam Subjekt Kód subjektu Kód subjektu je zpravidla IČO AuthKey Autrizační klíč Autrizační klíč kmunikujícíh subjektu ObdbiOd ObdbiD SubjektV RzsahV DatvySubr Datum evyplněná hdnta Datum Pskytnuté infrmace a jejich pužití evyplněná hdnta Kód vykazujícíh subjektu evyplněná hdnta Kód rzsahu vykazujícíh subjektu evyplněná hdnta Kód datvéh subru evyplněná hdnta Výskyty se stavem_ke_dni d danéh data Bez mezení Výskyty se stavem_ke_dni d danéh data Bez mezení Kód knkrétníh vykazujícíh subjektu (zpravidla IČO) Bez mezení Kód knkrétníh rzsahu vykazujícíh subjektu (význam dle metdiky) Bez mezení Kód knkrétníh datvéh subru Bez mezení Ppis Entita meziskladu Atribut entity Infrmace výskytech DATOVY_SOUBOR_VYSKYT Všechny atributy Strana 32

33 Seznam vydání (s infrmacemi zpracvání) VYDAI_SEZAM Ppis účelu dtazu Účelem je získat pdrbnější infrmace zpracvání zaslaných dat k výskytu datvéh subru. Zda budu tyt infrmace využívány, závisí na stupni autmatizace na straně subjektu. Pdrbné infrmace lze získat vždy pr knkrétní výskyt datvéh subru, který se specifikuje vstupními parametry ObdbiV, SubjektV, RzsahV, DatvySubr. Prtže k výskytu datvéh subru mhl být pstupně zaslán i více vydání, je mžn parametrem Rzsah zadat, zda mají být infrmace zaslány ke všem vydáním (hdnta VSE ) neb puze k pslednímu zpracvanému (hdnta POSLEDI ). Výstupem dtazu bude seznam vydání (zpráv), které subjekt zaslal k danému výskytu datvéh subru, s uvedením výsledku jejich zpracvání a seznamem případných chyb. Ppis chyb zahrnuje seznam chybných krků kntrl neb textvé ppisy chyb zpracvání. Krmě vydání zaslaných d ČB a zde zpracvaných, může k výskytu datvéh subru existvat i tzv. připravené vydání (význam ppsán v dkumentaci k aplikaci SDS). Pkud existuje, je v seznamu vždy uveden. Služba má variantu pr uživatele s certifikátem veřejné CA míst pužití autrizačníh kódu VYDAI_SEZAM_JH, viz dkumentace: s_web_services_uzivatelska.pdf Vstupní parametry Parametr Hdnty Význam Subjekt Kód subjektu Kódem subjektu je zpravidla IČO AuthKey Autrizační klíč Autrizační klíč kmunikujícíh subjektu ObdbiV Datum Stav_ke_dni SubjektV Kód subjektu Kód vykazujícíh subjektu (zpravidla IČO) RzsahV Rzsah subjektu Rzsah vykazujícíh subjektu DatvySubr Kód datvéh subru Kód knkrétníh datvéh subru Rzsah VSE POSLEDI Všechny zprávy k výskytu Puze pslední zpráva Ppis A Zaslat ppis chyb Strana 33