Průvodce zpracováním dokumentů pro komunikaci s Veřejným rozhraním pro e-Podání (VREP)

Speciální průvodce, který je k dispozici v agendě Dokumentů po vyvolání funkce Zpracovat v rámci zpracování dokumentů, které se odesílají přes Veřejné rozhranní pro e-Podání (VREP), tj. např. s typem ovladače:

  • ELDP
  • Nemocenské pojištění
  • Přehled o výši poj. a vyplacených dávkách
  • apod.

Detailní popis podmínek komunikace přes VREP není předmětem systému ABRA Gen a tudíž není ani součástí této uživatelské příručky. Lze jej dohledat na webových stránkách ČSSZ. Obecné principy řešení problematiky e-Podání v systému ABRA Gen naleznete v kapitole Komunikace se službami e-Podání (ČSSZ).

Obsahuje všechny společné prvky průvodce.

Jednotlivé kroky tohoto průvodce:

V tomto kroku průvodce si můžete prohlédnout obsah dokumentu. Vzhled v tomto kroku je totožný jako obsah dokumentu zobrazovaný v záložce Detail, subzáložce Obsah daného dokumentu. Pokud jsou veškeré údaje v pořádku, vy s nimi souhlasíte a přebíráte za jejich odeslání přes VREP odpovědnost, pak můžete pokračovat do dalšího kroku průvodce. V opačném případě průvodce ukončete, mzdová data nejdříve dejte do pořádku a proveďte export znovu s vytvořením nového dokumentu.

V tomto kroku zadáte údaje potřebné pro ověření oprávněnosti vašeho přístupu k VREP a další komunikační parametry. Hodnoty mohou být předvyplněné, pokud je máte zadány v subzáložce Parametry ovladače u dané Kategorie dokumentů.

Název Popis
Variabilní symbol

Zadáte vám přidělený var. symbol. Položka je k dispozici pro ovladač ELDP, Nemocenského pojištění nebo Přehled o výši poj. a vyplacených dávkách. Informace k variabilními symbolu lze získat opět na webových stránkách ČSSZ. Pokud jste již v minulosti s ČSSZ komunikovali (třeba i jen písemně) a nějaké platby jí odváděli, máte již var. symbol od ní přidělen.

K listopadu 2019 platí, že informace o var. symbolu lze získat na internetové stránce E-Podání desetimístný variabilní symbol.

Tento variabilní symbol je na portálu kontrolován s var. symbolem obsaženým v údajích příslušného zaměstnance, které se v rámci zmíněných exportů čerpají ze mzdové globální proměnné S_SSZVarS-Přidělený variabilní symbol SSZ. Proto je třeba mít oba zadány správně.
Certifikát k podpisu

Po stisku tlačítka se nabídne seznam dostupných certifikátů, kde vyberete odpovídající kvalifikovaný podpisový certifikát pro provedení elektronického podpisu odesílaného dokumentu. Certifikát vám musí vystavit nějaká kvalifikovaná certifikační autorita a musíte jej mít v počítači správně nainstalován v úložišti certifikátů operačního systému, jinak se zde nebude nabízet k výběru. Viz výše. Zde zobrazený seznam certifikátů standardně podporuje třídění a to pomocí kliknutí na hlavičku sloupce nebo nastavením volbou v lokálním menu nad hlavičkou sloupců.

Pokud certifikát nevyberete, nebude možno úspěšně pokračovat.

Pokud systém ABRA vrátí chybu ohledně CryptoAPI, jedná se s největší pravděpodobností o chybně nainstalovaný certifikát a nejedná se o chybu ABRA SW (která pouze uživateli zobrazí chybu vrácenou Windows). Při instalaci certifikátu musí být proto splněny tyto podmínky:

  • Na počítači s Windows XP musí být nainstalován Service Pack 3; na počítači s Windows Server 2003 je třeba hotfix KB 938397. Bez těchto aktualizací nejsou tyto systémy schopny s certifikáty SHA-2 pracovat. Windows vyšších verzí již podporují tyto certifikáty v základu.
  • Certifikát musí být v systému připojen ke správnému CSP modulu (CSP modul musí podporovat šifrování SHA-2, resp. SHA-256).
Certifikát k šifrování

Po stisku tlačítka vyberete odpovídající certifikát pro zašifrování odesílaného dokumentu. Jedná se o šifrovací certifikát ČSSZ (pro ELDP resp. Nemocenské pojištění, Přehled o výši poj. a vyplacených dávkách), který si lze stáhnout z internetu. Musíte jej mít v počítači správně nainstalován, jinak se zde nebude nabízet k výběru. Viz výše.

K listopadu 2019 platí, že šifrovací certifikát lze stáhnout na této internetové stránce Šifrování datových zpráv.
URL portálu pro elektronické podání

Můžete vybrat jednu z adres ostrého serveru portálu (Výchozí URL) nebo zkušebního (Testovací URL) pro zkušební provoz, ověření funkčnosti apod. Adresy jsou příslušně předvyplněny, nicméně uživatel ji může libovolně změnit.

Předvyplňované www adresy jsou napevno součástí zvoleného ovladače, přičemž pro různé lokalizace je určen jejich vlastní komunikační driver, který musí být přizpůsoben dle požadavků v dané zemi.

V současné době je adresa portálu epodani.cssz.cz/VREP/submission (dříve podporované adresy vrep1-t.cssz.cz/VREP/submission resp. vrep2-t.cssz.cz/VREP/submission byly zrušeny 17. 9. 2020). Testovací adresa je t-epodani.css.cz/VREP/submission.
Použít proxy Po zatržení parametru je možné nadefinovat Nastavení HTTP serveru proxy.

Zadaná nastavení lze uložit pro další použití pomocí zatržítka ve spodní části okna průvodce. V tom případě se uloží do subzáložky Parametry ovladače u dané Kategorie dokumentů (a poté se při příštím zpracování dle údajů na dané kategorii předvyplní, jak bylo řečeno výše). Zatržítko je k dispozici pouze, pokud má uživatel přístupové právo k opravám kategorií dokumentů. Stav zatržítka se nepamatuje.

Pokud v zadání autentifikačních údajů uděláte chybu, neproběhne odeslání na portál úspěšně.

Po stisku tlačítka Dále systém provede kontrolu zadaných údajů a pokud chybí nějaký povinný údaj, vyžádá si jeho doplnění.

V tomto kroku komunikační ovladač provede zašifrování odesílaných dat a elektronické podepsání a spojí se se serverem na adrese zvolené v předchozím kroku. Odešle data a čeká na potvrzení přijetí, pokud potvrzení přijetí nepřijde, pak v několika intervalech za sebou o něj znovu požádá. O průběhu je postupně zobrazována informace s pomocí přehledných grafických symbolů. Podle výsledku celou transakci ukončí nebo stornuje a nastaví stav odesílaného dokumentu. Viz Typy ovladačů a stavy zpracování. O výsledku se můžete podrobněji informovat dále po stisku tlačítka Dokončit. Odeslání můžete přerušit pomocí tlačítka Přerušit. Příklady průběhu zpracování a stavy z nich plynoucí:

Odeslání dokumentu vytvořeného ovladačem pro ELDP, pokud podání dokumentu selhalo kvůli chybě v těle zprávy, tj. u zaměstnance nebyl vyplněn var. symbol. Systém se snaží doklad odeslat a v několika časových intervalech se snaží ověřit u serveru, jak podání dopadlo a zda byla data přijata:

Příklad průběhu zpracování

Stav dokumentu se změní a doklad bude ve stavu Neodesláno kvůli chybě. Takový doklad již nebude možno odeslat znovu. Je třeba odstranit příčinu chyby (v tomto případě doplnit údaje zaměstnance, provést znovu export s vytvořením nového dokumentu ELDP a ten odeslat.)

Pokud je k dispozici o výsledku zpracování nějaký protokol, chybová zpráva apod., je možné si je rovnou v tomto kroku průvodce zobrazit a vytisknout pomocí funkčního tlačítka Výsledek. Forma odpovědi závisí na portálu, tj. výsledek může vypadat např. následovně:

Příklad zobrazeného protokolu o chybě při odesílání ELDP, když nesouhlasí variabilní symbol přidělený ČSSZ uživateli s variabilním symbolem nastaveným ve mzdách v globálních proměnných, což je výchozí podmínka, aby se zpracování dokumentu na portálu vůbec zahájilo

Příklad zobrazeného protokolu o chybě při odesílání ELDP, kdy se už zpracování zahájilo, ale v sestaveném ELDP daného zaměstnance jsou chyby, kvůli kterým jej portál nemůže přijmout

Příklad zobrazeného protokolu o chybě při odesílání výkazu Nemocenského pojištění.

Tento výsledek je možné si zobrazit i kdykoliv později, viz Obsah dokumentu - seznam souborů obsažených v daném dokumentu. Po stisku tlačítka Dokončit se průvodce ukončí a vrátí se do agendy dokumentů, odkud bylo zpracování dokumentu dané kategorie vyvoláno.

Logování

Pro lepší diagnostiku případných potíží při komunikaci s VREP si o průběhu komunikace s portálem můžeme zobrazit log. Logování komunikace s VREP se konfiguruje jako ostatní logování v konfiguračním souboru Nexus.cfgv sekci [Log.PVSCommunications]. Konfigurační soubor Nexus.cfg systém hledá ve stejné cestě, jako je AbraGen.exe.