Jak si otestovat komunikaci s CSÚIS „nanečisto“

Pro účely otestování komunikace se systémem CSÚIS dalo Ministerstvo financí účetním jednotkám k dispozici aplikaci pro testování třetích stran.

Aplikace slouží hlavně pro:

  • Ověření schopnosti zodpovědné osoby odeslat data pomocí webových služeb (v případě použití SOAP klienta), alternativně pomocí Webové aplikace
  • Ověření správnosti postupu použitého pro zašifrování zaslané zprávy (za použití testovacího šifrovacího klíče)
  • Ověření správnosti struktury zaslané zprávy na technické úrovni (dle XSD)
  • Ověření schopnosti zodpovědné osoby přistupovat k inboxu pomocí webových služeb (v případě použití SOAP klienta), alternativně pomocí Webové aplikace umožňující stažení stavové zprávy o výsledku zpracování zaslaných dat

Aplikace neprovádí:

  • Kontrolu na přípustné hodnoty číselníků
  • Obsahovou kontrolu testovacích XML, tj. aplikaci kontrolních vazeb CSÚIS

Vstup do aplikace, přihlašovací údaje a pracovní manuál pro testování lze nalézt v dokumentech ke stažení v části Testování třetích stran. Tato aplikace neslouží pro zaslání finálních výkazů. Výkazy za danné období, pro splnění legislativní povinnosti je nutno zaslat do ostré webové aplikace, případně SOAP klienta!

Úvod

Vítejte na informačním portálu Výkaznictví.cz

Tento portál slouží jako přehledný zdroj informací týkajících se Centrálního systému účetních informací státu (CSÚIS), který v rámci účetní reformy veřejných financí spravuje Ministerstvo financí. Důraz je kladen na oblast samosprávy.

V rámci obecného popisu CSÚIS lze na tomto informačním portálu nalézt metodické informace, popis komponent a zpracování v CSÚIS a popis některých specifik týkajících se územních samosprávných celků a jejich příspěvkových organizací.

Dále informační portál obsahuje detailní popis jednotlivých kroků, které musí provézt v rámci komunikace s CSÚIS účetní jednotka, resp. její zodpovědná osoba, tak aby splnila legislativní povinnost zaslat účetní a finanční výkazy do CSÚIS.

Všechny uvedené informace jsou čerpány z veřejně dostupných zdrojů Ministerstva financí a z platné legislativy. Samotný informační portál není aktivitou Ministerstva financí.

Vlastní postřehy, či otázky mohou návštěvníci portálu sdílet v jednotlivých diskusních skupinách, nebo nahlédnout do odpovědí na často kladené dotazy.

Dále je na portálu Výkaznictví.cz k dispozici zdarma exkluzivně pořizovač výkazů.

Komunikace s CSÚIS

Pro splnění legislativní povinnosti zaslání výkazů do CSÚIS, je nutno provézt všechny z následujících pěti chronologicky řazených kroků. Opomenutí jakéhokoliv kroku, nebo jeho provedení jinak, než je popsáno v návazných informacích, způsobí problém během komunikace s CSÚIS.

Základních 5 kroků:

  1. Registrovat ZO/NZO
  2. Vytvořit výkaz ve formátu XML
  3. Vytvořený soubor XML zašifrovat
  4. Odeslat šifrované XML do CSÚIS
  5. Zjistit výsledek zpracování v CSÚIS

Jako nejjednodušší a ekonomicky nejvýhodnější lze malým účetním jednotkám doporučit následující postup:

1. Registrovat ZO/NZO pomocí standardní procesu registrace ZO účetní jednotkou, jak je popsáno zde.

2. Vytvořit výkaz ve formátu XML manuálním pořízením pomocí web pořizovače v rámci tohoto informačního portálu.

3. Vytvořený soubor XML zašifrovat pomocí šifrovací utility publikovanou Ministerstvem financí.

4. Odeslat šifrované XML do CSÚIS manuálním vložením do webové aplikace CSÚIS.

5. Zjistit výsledek zpracování revizí stavových zpráv pomocí inboxu ve webové aplikaci CSÚIS

Tvorba souboru XML

Zasílání dat do CSÚIS je možné pouze pomocí datových souborů ve formátu XML. Soubory v jiném formátu do CSÚIS nelze zasílat!

Struktura každého výkazu je v technickém manuálu definována formou XSD schématu. Toto schéma přesně definuje požadavky na strukturu XML, tak aby byl výkaz do CSÚIS přijat jako validní. Každý výkaz je po přijetí do CSÚIS kontrolován a v případě, že je odhalen nesoulad s definovanou strukturou (XSD), není výkaz dále zpracován. Pro každý výkaz je třeba vytvořit samostatné XML.

Hlavička XML obsahuje údaje o účetní jednotce a zodpovědné osobě. Hlavička výkazu obsahuje IČ, údaj o kapitole (relevantní pro ústředně řízené organizace) a identifikaci období, za které je výkaz zasílán. Tělo XML obsahuje vlastní výkaz. Patička XML obsahuje kontrolní součet a případně digitální podpis.

Výkaz ve formě XML lze vytvořit třemi způsoby:

  1. Úprava ekonomického informačního systému účetní jednotky, tak aby byl soubor XML automaticky vytvořen,
  2. Využití programu pro manuální pořizování výkazů, který nabízejí některé soukromé firmy,
  3. Pořízení zdarma pomocí web pořizovače v rámci tohoto informačním portálu.

Vytvořené XML je před odesláním dále nutno zodpovědnou osobou řádně zašifrovat pomocí zajišťovacích a identifikačních údajů.

Dokumenty ke stažení (zdroj www.mfcr.cz)

Aktualizováno k 9.10.2015 (zvýrazněno)

Legislativa a metodika

Pomocný analytický přehled (PAP)

Konsolidace

Registrace ZO

Tvorba souboru XML a číselníky

Šifrování souboru XML

Zaslání dat do CSÚIS

Testování třetích stran

Metodika

Ostatní

Revize stavových zpráv

Po odeslání XML do CSÚIS je třeba zjistit výsledek zpracování. Pouhé odeslání nemusí znamenat úspěšné zpracování na straně CSÚIS!

Je si tedy nutno potvrit, že byl výkaz v pořádku zpracován a neobsahoval žádné chyby. K tomuto účelu slouží stavové zprávy, pomocí kterých systém CSÚIS informuje o důležitých krocích v rámci zpracování, stejně tak jako o finálním výsledku.

Stejně tak jako u zasílání XML do CSÚIS i zde existují dvě komunikační cesty, jedna automatická (SOAP) a jedná manuální (webová aplikace).

Revizi stavových zpráv lze provézt třemi způsoby:

  1. Úprava ekonomického informačního systému účetní jednotky, tak aby prostřednictvím SOAP kanálu mohl přijímat informace o výsledcích zpracování z CSÚIS,
  2. Využití služeb soukromých firem, které nabízejí externí zpracování výkazů,
  3. Pomocí inboxu, který je součástí webové aplikace.

Po přihlášení ZO do webové aplikace je k dispozici přehled stavových zpráv v inboxu. Webová aplikace je dostupná z internetu a Ministerstvo financí publikovalo podrobný manuál pro její použití. Více informací lze nalézt v dokumentech ke stažení v části Zaslání dat do CSÚIS.

Zasílání dat do CSUIS

Řádně zašifrovaný XML soubor je možno odeslat do CSÚIS dvěma způsoby – komunikačním kanálem SOAP, nebo nahráním do webové aplikace. Jiný způsob zaslání není možný! Soubor musí do CSÚIS odeslat stejná ZO, jako prováděla šifrování XML.

Automaticky lze zaslat data komunikačním kanálem SOAP, kde přenos datového souboru probíhá pomocí webových služeb. Nahrání do webové aplikace je manuální varianta stejného procesu.

Zaslat soubory XML do systému CSÚIS je možno třemi způsoby:

  1. Úprava ekonomického informačního systému účetní jednotky, tak aby po vytvoření XML a jeho šifrování došlo k automatickému přenosu dat do CSÚIS pomocí SOAP kanálu,
  2. Využití služeb soukromých firem, které nabízejí externí zpracování výkazů,
  3. Manuální nahrání šifrovaného souboru XML pomocí webové aplikace.

Webová aplikace je místo pro manuální vložení šifrovaného XML do CSÚIS. Jedná se pouze a manuální verzi SOAP kanálu, tzn. že všechny náležitosti komunikace musí být i zde splněny. Výkaz vkládá ZO, není možno vložit nezašifrovaný soubor a po ZO je vyžadováno přihlášení uživatelským jménem a heslem, které získala během registrace ZO.

Webová aplikace je dostupná z internetu a Ministerstvo financí publikovalo podrobný manuál pro její použití. Více informací lze nalézt v dokumentech ke stažení v části Zaslání dat do CSÚIS.

Šifrování souboru XML

Komunikace mezi zodpovědnou osobou (ZO) a CSÚIS musí vždy probíhat šifrovaně. Nezašifrovaný či nesprávně šifrovaný soubor XML bude systémem CSÚIS odmítnut!

Každé XML, které ZO do CSÚIS odesílá, musí být šifrované šifrovacím klíčem dané ZO. ZO obdrží tento šifrovací klíč v rámci procesu své registrace od účetní jednotky (jako součást balíčku ZaIS).

Šifrování pro účely komunikace s CSÚIS je značně specifické a je třeba přesně dodržet postup popsaný vyhláškou č. 383/2009 Sb. Hlavní pravidlo je, že šifrovat a odesílat do systému CSÚIS musí jedna a tatáž ZO.

Šifrovat soubory XML lze třemi způsoby:

  1. Úprava ekonomického informačního systému účetní jednotky, tak aby vytvořený XML soubor byl i automaticky zašifrován
  2. Využití služeb soukromých firem, které nabízejí šifrování XML v rámci možnosti registrovat tyto subjekty jako ZO
  3. Zašifrování pomocí Šifrovací utility publikovanou Ministerstvem financí

Šifrovací utilita je volně ke stažení na webu Ministerstva financí spolu s podrobným manuálem na její použití. Více informací lze nalézt v dokumentech ke stažení v části Šifrování souboru XML.

Zašifrovaný soubor XML je již možno odeslat do systému CSÚIS.

portl

Portál IISSP

Portál IISSP je jediná platforma, která umožňuje externím uživatelům přístup přímo do systému CSÚIS. Tento přístup je umožněn pouze správcům kapitol státního rozpočtu a krajským úřadům. Přihlašovací údaje zodpovědné osoby, ani účetní jednotky nelze použít k přihlášení na portál.

Přístup na portál je možný na tomto odkazu, na základě uživatelského jména a hesla.

Funkcionalita portálu umožňuje krajskému úřadu provádět následující úkony nad výkazy obcí, DSO a příspěvkových organizací:

  1. Sledovat proces sběru dat – umožňuje vyhodnotit, které účetní jednotky již zaslaly data, případně s jakou chybou
  2. Vyhodnocovat kontrolní vazby – umožňuje vyhodnotit výsledky obsahových kontrol (VVK a MVK) v rámci jednotlivých výkazů
  3. Analyzovat data ve výkazech – umožňuje provádět pokročilou analýzu a agregace nad daty zaslaných výkazů
  4. Schvalovat sumář finančního výkazu – umožňuje elektronicky schválit sumář za kraj

Jednotlivé oblasti jsou znázorněny na následujícím schématu.

Schéma SAP Portál (zdroj: www.mfcr.cz)

Číselníky

V rámci systému IISSP existuje mnoho číselníků, které jsou během zpracování výkazů v CSÚIS použity. Na struktuře těchto číselníků je postaveno mnoho výstupů ze systému IISSP a příchozí výkazy jsou na přípustné hodnoty číselníků kontrolovány.

Nejdůležitějším číselníkem je Číselník účetních jednotek, který obsahuje seznam vybraných účetních jednotek spolu s celou řadou atributů (název, adresa, kategorizace). Každá účetní jednotka je kromě IČ identifikována zárověň interním kódem IISSP.

Některé číselníky jsou v aktuální podobě publikovány na internetových stránkách MF.