Zasílání XML do CSÚIS – jak rozumnět stavovým zprávám

Stavové zprávy lze chápat jako zpětnou vazbu systému CSÚIS s informací o zpracování zaslaného výkazu.

Každý výkaz zaslaný do CSÚIS musí projít mnoha kroky zpracování, kdy výsledek každého kroku uvádí výkaz do určitého stavu. Informaci o proběhlé události dostává i Zodpovědná osoba formou stavové zprávy, buď to automaticky prostřednitvím SOAP kanálu, nebo do inboxu v rámci webové aplikace.

Obsahově lze stavové zprávy rozdělit na pozitivní a negativní, kdy v případě negativní stavové zprávy je očekáváno, že zodpovědná osoba (resp. účetní jednotka) provede opravu a znovuzaslání výkazu. V případě systémové chyby je třeba kontaktovat administrátora (kompetenční centum IISSP).

Stavová zpráva je identifikována hlavně kódem a popisem, podle kterých lze zjistit, jak dopadlo zpracování u zaslaného výkazu, případně jaké chyby výkaz obsahoval.

Dvě nejdůlěžitější pozitivní stavové zprávy mají kód DELVD a PROCOK.

DELVD podává informaci o tom, že XML soubor byl systémem CSÚIS přijat a technické kontroly (kontrola zabezpečení a struktury souboru) byly v pořádku. Výkaz bude dále zpracován a podroben obsahovým kontrolám.

PROCOK je finální pozitivní stavová zpráva, které zodpovědnou osobu informuje, že všechny definované kontroly na výkazem proběhly v pořádku. Až po obdržení této stavové zprávy lze považovat povinnost zaslání výkazu za splněnou.

V průběhu zpracování může dojít i k chybě během některého kroku zpracování, co má za následek vygenerování negativní stavové zprávy. Mezi nejčastější negativní stavové zprávy patří:

  • ERRSYN – chyby struktury souboru XML, neodpovídá XSD schématu
  • ERRCIS – nepřípustná hodnota číselníku ve výkazu
  • ERRDEC – chyba při dešifrování souboru XML
  • ERRVVK – chyba vnitrovýkazové hodnoty
  • ERRMVK – chyba mezivýkazové vazby

V případě obdržení výše uvedených stavových zpráv je třeba ve výkazu provézt opravu uvedené chyby a znovuzaslání do systému CSÚIS.

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.

Š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.