Přeskočit na hlavní obsah

JMHZ – Prohlížeč JMHZ (externí doplněk)

Jak si pomocí externího doplňku zobrazit JMHZ hlášení v čitelné podobě?

Autor: Petr Pech

Při podávání JMHZ generuje ABRA Flexi XML soubor ve formátu definovaném ČSSZ. Tento soubor je určen pro elektronické podání a není příliš přehledný pro ruční kontrolu.

Pro snadnější kontrolu dat můžete použít jednoduchý nástroj na tomto odkazu.

Tento nástroj umožňuje zobrazit XML soubor JMHZ v přehledné, lidsky čitelné podobě.

Jak nástroj použít

  1. Otevřete stránku JMHZ XML prohlížeče.

  2. Nahrajte XML soubor pro REGZEC nebo MH:

    • přetažením do okna, nebo

    • kliknutím na Načíst XML

  3. Nástroj zobrazí obsah hlášení ve strukturované podobě (formulář). Data je možné zobrazit v tabulkové podobě nebo jako karty.

K čemu je to užitečné

Pomáhá například při:

  • kontrole dat před odesláním hlášení

  • analýze chyb v XML

  • ověřování hodnot vypočtených ve mzdách

  • komunikaci s podporou

  • data je zde možné opravit a znovu do XML uložit pomocí tlačítka Uložit XML. Pokud dojde k opravě dat, která mají vliv i na hlavičku dokumentu, typicky zdravotní pojištění, pak je nutné tuto změnu promítnout i do hlavičky.

Tento nástroj slouží pouze jako pomůcka pro kontrolu XML souborů MH nebo REGZEC. Samotné podání hlášení se provádí standardním způsobem (např. přes ePortál ČSSZ).

🚧 Známá omezení a oblasti dalšího vývoje

Popis

Stav

Opraveno ve verzi

Prohlížeč JMHZ - prověřit kontrolu R172 v případě akce A2

🟢 Hotovo

jmhz-viewer-2026-05-07

Prohlížeč JMHZ - názvy obcí nemají odpovídat přesné hodnotě z číselníku

🟢 Hotovo

jmhz-viewer-2026-05-07

Prohlížeč JMHZ - chybné hodnoty číselníku Práce probíhá převážně

🟢 Hotovo

jmhz-viewer-2026-05-05

Prohlížeč JMHZ nerozpozná 'Ž' jako validní hodnotu číselníku pohlaví (chyba R16)

🟢 Hotovo

jmhz-viewer-2026-05-04

Prohlížeč JMHZ - validace - doplnit kontrolu konkrétních hodnot z číselníku

🟢 Hotovo

jmhz-viewer-2026-04-30

Prohlížeč JMHZ - API pro číselníky

🟢 Hotovo

jmhz-viewer-2026-04-30

Prohlížeč JMHZ - prověřit kontrolu R100 v případě neuvedeného Důvodu ukončení

🟢 Hotovo

jmhz-viewer-2026-04-30

Prohlížeč JMHZ - oprava kontrol M325 a M245

🟢 Hotovo

jmhz-viewer-2026-04-30

Prohlížeč JMHZ - kontroly údajů u zaměstnanců s trvalým pobytem v zahraničí

🟢 Hotovo

jmhz-viewer-2026-04-30

Prohlížeč JMHZ - chybná kontrola M229 v případě slevy na 4. a další dítě

🟢 Hotovo

jmhz-viewer-2026-04-30

Prohlížeč JMHZ - možnost načítat metadata z oficiálního CSV od ČSSZ

🟢 Hotovo

jmhz-viewer-2026-04-30

Prohlížeč JMHZ - vylepšení sanitizace a generování XML

🟢 Hotovo

jmhz-viewer-2026-04-30

Prohlížeč JMHZ - podpora ZIP v embed režimu (externí integrace)

🟢 Hotovo

jmhz-viewer-2026-04-30

Prohlížeč JMHZ - oprava řazení a ukládání dětí

🟢 Hotovo

jmhz-viewer-2026-04-30

Prohlížeč JMHZ - prověřit validaci REGZEC - druh důchodu + důchod pobírán od

🟢 Hotovo

jmhz-viewer-2026-04-23

Prohlížeč JMH - prověřit K229 pokud je více dětí, na které se neuplatňuje sleva

🟢 Hotovo

jmhz-viewer-2026-04-23

Prohlížeč JMHZ - umožnit načíst a uložit ZIP soubor

🟢 Hotovo

jmhz-viewer-2026-04-23

Prohlížeč JMHZ - možnost zobrazit i další informace o zaměstnanci

🟢 Hotovo

jmhz-viewer-2026-04-23

Prohlížeč JMHZ - podpora předání parametru se zákaznickým číslem Flexi

🟢 Hotovo

jmhz-viewer-2026-04-23

Prohlížeč JMHZ - validace Povinnosti polí (sloupce I - X)

🟢 Hotovo

jmhz-viewer-2026-04-23

Prohlížeč JMHZ - přidat kontroly na přílohy REGZEC

🟢 Hotovo

jmhz-viewer-2026-04-23

Prohlížeč JMHZ - prázdné elementy po smazání hodnoty způsobují XSD chyby

🟢 Hotovo

jmhz-viewer-2026-04-23

Prohlížeč JMHZ - kontrola R50 - provádět jen u akce A3

🟢 Hotovo

jmhz-viewer-2026-04-23

Prohlížeč JMHZ - prověřit kontrolu na vyplnění trvalé adresy v případě Slováků

🟢 Hotovo

jmhz-viewer-2026-04-23

Prohlížeč JMHZ - prověřit kontrolu M214 a M215

🟢 Hotovo

jmhz-viewer-2026-04-17

Prohlížeč JMHZ - prověřit kontrolu R201

🟢 Hotovo

jmhz-viewer-2026-04-17

Prohlížeč JMHZ - doplnění dalších kontrol MH

🟢 Hotovo

jmhz-viewer-2026-04-16

Prohlížeč JMHZ - REGZEC - validace Specifické povinnosti (sloupec F)

🟢 Hotovo

jmhz-viewer-2026-04-16

Prohlížeč JMHZ - REGZEC - validace Logických kontrol (sloupec G)

🟢 Hotovo

jmhz-viewer-2026-04-16

Prohlížeč JMHZ - REGZEC - validace Povinnostních podmínek (sloupce Y - AA)

🟢 Hotovo

jmhz-viewer-2026-04-16

Prohlížeč JMHZ - pokrýt dosavadní kontroly MH testy

🟢 Hotovo

jmhz-viewer-2026-04-16

Prohlížeč JMHZ - opravit načítání XML s enkódováním windows-1250

🟢 Hotovo

jmhz-viewer-2026-04-16

Prohlížeč JMHZ - podpora více souborů najednou

🟢 Hotovo

jmhz-viewer-2026-04-16

Prohlížeč JMHZ - opravy a vylepšení UI

🟢 Hotovo

jmhz-viewer-2026-04-10

Prohlížeč JMHZ - při automatickém otevření z Flexi se nespustí část základních kontrol

🟢 Hotovo

jmhz-viewer-2026-04-10

Prohlížeč JMHZ - nezobrazuje v hlavičce údaje o slevách

🟢 Hotovo

jmhz-viewer-2026-04-10

Prohlížeč JMHZ - nenahlásí chybu 329

🟢 Hotovo

jmhz-viewer-2026-04-10

Prohlížeč JMHZ - prověřit K42

🟢 Hotovo

jmhz-viewer-2026-04-10

Prohlížeč JMHZ - Dialog pro nahlášení problému

🟢 Hotovo

jmhz-viewer-2026-04-10

Prohlížeč JMHZ - vylepšení XLS exportu

🟢 Hotovo

jmhz-viewer-2026-04-10

Prohlížeč JMHZ - ukládání do PDF

🟢 Hotovo

jmhz-viewer-2026-04-08

Prohlížeč JMHZ - implementace příloh REGZEC

🟢 Hotovo

jmhz-viewer-2026-04-08

Prohlížeč JMHZ - prověřit kontrolu K37 na IK MPSV

🟢 Hotovo

jmhz-viewer-2026-04-08

Prohlížeč JMHZ - kontroly K284, K216, K7 nerespektuje typ PP

🟢 Hotovo

jmhz-viewer-2026-04-08

Prohlížeč JMHZ - prověřit kontrolu K332

🟢 Hotovo

jmhz-viewer-2026-04-08

Prohlížeč JMHZ - zpřísnit kontrolu K99

🟢 Hotovo

jmhz-viewer-2026-04-08

Prohlížeč JMHZ - prověřit K255 - validace primárního PPV u zaměstnance s více PP

🔴 Zavřeno

Prohlížeč JMHZ - Excelovská tabulka nejde otevřít v tabulkovém editoru na MacOs

🔴 Zavřeno

Prohlížeč JMHZ - zkontrolovat, že validace formátu XML správně validuje nepovinné elementy

🔴 Zavřeno

Prohlížeč JMHZ - asi nenahlásí chybu nevyplnění Práce probíhá převážně

🔴 Zavřeno

Prohlížeč JMHZ - zpětné ukládání XML

⚪ Naplánováno

Prohlížeč JMHZ - doplnění součtového řádku přímo na stránku

⚪ Naplánováno

⚙️ Přehled změn

5. 5. 2026

Opravy chyb

  • Opraveny chybné hodnoty číselníku v prohlížeči JMHZ pro pole "Aktuálně nabízené práce" — uživatelé nyní vidí korektní možnosti výběru dle oficiálního číselníku CIS_PRUBEH_PRACE.

4. 5. 2026

Opravy chyb

  • Opravena validace pohlaví v prohlížeči JMHZ, který nyní správně rozpoznává všechny platné hodnoty číselníku pohlaví (M, Ž, 0, 9) a již neobjevuje chybná hlášení.

30. 4. 2026

Vylepšení

  • Doplněna validace hodnot z číselníků v prohlížeči JMHZ — nové kontroly nyní ověřují správnost údajů o státu vydání dokladu, kódu obce, typu daňové identifikace, typu dokladu, druhu pracovního oprávnění a dalších povinných položek. Zároveň se v editoru objevují rozbalovací nabídky s návrhy platných hodnot podle kódu nebo názvu, což urychluje vyplňování formuláře.

  • Opraveno načítání číselníků pro JMHZ — hodnoty se nyní stahují každou noc automaticky ze 4 státních zdrojů (MPSV, ČSSZ, ČSÚ) a jsou publikovány jako veřejné API, které mohou využívat i externí vývojáři a jiné systémy. Prohlížeč JMHZ tak získává přístup ke všem potřebným kontrolám na správné a vždy aktuální údaje.

  • Doplněna možnost načítat metadata zaměstnanců přímo z oficiálního CSV souboru od ČSSZ – prohlížeč je automaticky rozpozná a přiřadí k vašim záznamům podle IDPPV nebo jako zálohu podle OIČ. Pro lepší přehlednost se tabulka přizpůsobí obsahu a zobrazí pouze relevantní sloupce, a nadále jsou podporovány i vlastní CSV formáty.

  • Opraveno chování Prohlížeče JMHZ při ukládání XML — prázdná nepovinná pole se nyní odstraňují pouze v polích, která jste upravili, zatímco ostatní pole zůstávají nezměněna. Při každém uložení se do souboru automaticky vloží identifikační komentář s verzí a časovým razítkem, aby šlo odlišit XML upravené v našem nástroji od XML přímo z ERP systému.

  • Rozšířena podpora prohlížeče JMHZ tak, aby v režimu embed automaticky zpracoval ZIP soubory předané z externího systému (vedle dosavadního XML). Systém nyní umožňuje integrujícím aplikacím přenášet vícenásobná hlášení v jednom ZIP archivu a prohlížeč je bez dalšího zásahu uživatele načte a zpracuje.

Opravy chyb

  • Opravena kontrola R100 v agendě JMHZ, která chybně vyžadovala vyplnění atributu „Nárok na odstupné" i v případě, kdy „Důvod ukončení" není vyžadován podle druhu činnosti.

  • Opraveny kontroly M325 a M245 v prohlížeči JMHZ, které nyní správně rozpoznávají všechny smlouvy o provedení práce u jednoho zaměstnavatele a správně uplatňují příslušné limity. Zároveň se nyní korektně sčítá základ daně ze všech formulářů stejného zaměstnance, čímž se eliminují falešně hlášené chyby.

  • Opravena validace údajů pobytu v ČR v agendě JMHZ u zaměstnanců s trvalým pobytem v zahraničí — výjimka pro přeshraniční pracovníky se nyní správně uplatňuje při doregistraci a opravě, a systém zároveň nově vyžaduje adresu pobytu v ČR u zaměstnanců z ostatních zahraničních států.

  • Opravena kontrola M229 v prohlížeči JMHZ – už nebudou zahlášeny falešné chyby při uplatnění slevy na čtvrté a další dítě se správným pořadím.

  • Opraveno řazení vyživovaných dětí v prohlížeči JMHZ – dítě s pořadím N se nyní zobrazuje až za dětmi s číselnými pořadími. Zároveň je opraveno ukládání údajů u dětí, která se dříve po vyplnění do souboru neuložila.

23. 4. 2026

Vylepšení

  • Rozšířena funkčnost Prohlížeče JMHZ o možnost načítat a ukládat ZIP soubory obsahující výkazy, které se přes e-portál podávají zazipované. Při ukládání si můžete zvolit formát XML nebo ZIP a vybírat mezi přímým uložením či dialogem s volbami.

  • Rozšířen Prohlížeč JMHZ o zobrazení podrobných údajů o zaměstnanci – nyní vidíte osobní číslo, jméno, příjmení a údaje o pracovním poměru přímo v tabulce, bez nutnosti hledat v seznamech. Sloupce lze navíc ukotvit, aby zůstaly viditelné při posouvání tabulky.

  • Doplněna automatická předvolba zákaznického čísla v prohlížeči JMHZ, což urychluje a usnadňuje odesílání hlášení problémů přímo z aplikace Flexi.

  • Opravena validace povinných a zakázaných polí v prohlížeči JMHZ — systém nyní kontroluje, zda jsou všechna povinná pole vyplněna, a upozorňuje také na pole, která být vyplněna nesmí. Kontroly fungují automaticky na základě typu akce zaměstnance a zajišťují korektní vyplnění hlášení.

  • Doplněna kontrola příloh v agendě JMHZ — systém nyní automaticky ověřuje délku názvu a popisu přílohy (max. 100 znaků), velikost jednotlivých souborů (max. 2 MB) a celkový objem všech příloh (max. 4 MB), přičemž soubory překračující limity jsou okamžitě odmítnuty. Ověřovány jsou také povolené formáty souborů, což zajišťuje konzistenci a bezpečnost vašich výkazů.

  • Opravena validace v prohlížeči JMHZ — prázdná volitelná pole už nebudou vyvolávat XSD chyby. Smazáním hodnoty se pole automaticky odstranit z XML, zatímco povinná pole zůstávají pod kontrolou a budou správně nahlášena jako chybějící.

Opravy chyb

  • Zpřesněna validace REGZEC v agendě JMHZ – systém nyní správně kontroluje kombinaci typu důchodu a data, kdy je důchod pobírán, čímž se předchází chybám při hlášení sociální pojišťovně.

  • Opraveny kontroly M229 a M230 v prohlížeči JMH – nyní správně přeskakují děti, u kterých se neuplatňuje sleva, a nehlásí chybně ověřovací upozornění.

  • Opravena kontrola R50 v agendě JMHZ – ověřování se nyní provádí pouze pro akce A3 a A4, čímž se eliminují falešné chyby při práci s ostatními typy akcí.

  • Opravena validace adresy v prohlížeči JMHZ – nyní korektně zpracovává zahraniční trvalé pobyty (Německo, Polsko, Slovensko, Rakousko) bez zbytečného vyžadování další údaje.

17. 4. 2026

Opravy chyb

  • Opravena kontrola věku dítěte v prohlížeči JMHZ – nyní se nebude zbytečně spouštět v případech, kdy se na dítě neuplatňuje sleva.

  • Opravena kontrola R201 v prohlížeči JMHZ — systém nyní korektně ověřuje povinnost vyplnění kódu státu cizích právních předpisů pouze v případě, že je skutečně uvedena příslušnost.

16. 4. 2026

Vylepšení

  • Doplněny kontroly měsíčního hlášení v prohlížeči JMHZ — implementováno 12 jednoduchých kontrol (např. povinné vyplnění podřazených atributů, kontrola kódů ELDP) a 11 strukturálních kontrol zajišťujících správnost formátu podání. Zbývajících 45 kontrol čeká na dodání číselníků nebo rozšíření field mappingu, zatímco 68 komplexních kontrol vyžaduje přístup k centrálním systémům ČSSZ.

  • Opravena validace specifických povinností v prohlížeči JMHZ pro výkaz REGZEC — nově jsou kontrolovány podmíněně povinné údaje (např. číslo popisné adresy rezidence, důvod ukončení pracovního vztahu, ID pracovního oprávnění cizince) na základě vyplněných údajů v dalších polích a charakteristik zaměstnance.

  • Opravena validace údajů v agendě JMHZ — prohlížeč nyní korektně kontroluje formáty polí, adresní údaje, data a logické závislosti mezi poli dle specifikace REG-ZEC a zobrazuje chyby na povinné údaje a nesprávné formáty.

  • Opravena a rozšířena validace povinnostních podmínek v prohlížeči JMHZ – systém nyní správně kontroluje, která pole jsou povinná, nepovinná nebo zakázaná dle aktuální legislativy. Doplněno 12 nových kontrol pro ověřování údajů o pobytu, oprávnění k práci a další parametry zaměstnanců v souladu se specifikací REG-ZEC.

  • Rozšířena funkcionalita prohlížeče JMHZ o podporu práce s více soubory najednou – můžete nyní otevřít více XML souborů současně a rychle mezi nimi přepínat bez ztráty jejich stavu. Vylepšen také import souborů drag & drop i klasickým nahráváním, přičemž systém nyní správně zvládá otevírání více souborů v jedné operaci.

Opravy chyb

  • Opraveno načítání XML souborů s enkódováním windows-1250 v prohlížeči JMHZ — aplikace nyní správně detekuje a zpracuje soubory v tomto formátu, který používají také služby ČSSZ.

11. 4. 2026

Vylepšení

• Opravena vizualizace obsahu v card view, který se předtím nesprávně usekával, a odstraněny nežádoucí toast notifikace z PDF exportů. Zlepšena také viditelnost a konzistence indikátorů neuložených změn v prostředí editace a zvýšena rychlost načítání tabulek s velkým počtem záznamů.

• Opraveno zobrazování údajů o slevách v hlavičce prohlížeče JMHZ – nyní se správně zobrazují všechny typy slev (sleva zaměstnavatele, slevy zaměstnanců a sleva na ovoce a zeleninu).

• Přidáno tlačítko „Nahlásit problém" v prohlížeči JMHZ, které vám usnadní hlášení chyb přímo do e-mailu na podporu – dialog vám umožní popsat problém a přidat vaše číslo zákazníka. Při odeslání zprávy se automaticky přiloží diagnostické informace o dokumentu a spuštěných kontrolách, které pomůžou týmu podpory problém rychleji vyřešit.

• Upraven export seznamu JMHZ do Excelu tak, aby se správně exportovaly číselné hodnoty a soubor byl bez problémů otevíratelný i v aplikaci Numbers na počítačích se systémem macOS.

Opravy chyb

• Opravena chyba, kdy se při automatickém otevření prohlížeče JMHZ z průvodce Flexi nespouštěly základní kontroly měsíčního hlášení – nyní se kontroly spustí korektně spolu s XSD validací.

• Opravena chyba, kdy nebyla detekována případná chyba 329. Nově implementována kontrola chyby 329.

• Upravena kontrola K42 v prohlížeči JMHZ tak, aby správně vyhodnocovala podmínky pro pole 10372 v závislosti na vyplnění polí 10239 a 10502. Kontrola nyní korektně funguje i v situacích, kdy nejsou dostupné identifikátory MPSV nebo PPV.

8. 4. 2026

Vylepšení

  • V Prohlížeči JMHZ přidáno tlačítko „Export do PDF" s možností nastavení výstupu.

  • V obou zobrazeních Prohlížeče JMHZ (karta i tabulka) přibyla nová kategorie Přílohy, dostupná pouze pro REGZEC. Lze připojit soubor libovolného typu a velikosti — při velikosti nad 20 MB aplikace upozorní na možné zpomalení. Přílohy je možné zpětně stáhnout nebo odstranit.

Opravy

  • Opravena kontrola K37 pro IK MPSV (atribut 10051) — validace nyní odpovídá oficiálnímu pravidlu pro výpočet kontrolní číslice.

  • Kontroly K7, K216 a K284 nyní správně zohledňují typ formuláře zaměstnance. Pro varianty činnost KS a pěstoun se přeskakuje kontrola rozkladu vyměřovacího základu, v K7 se pro tyto varianty sčítá pole 10477 místo 10478.

  • Opravena kontrola K332, která chybně hledala element primární PPV jako potomka místo jako sousední element.

  • Kontrola K99 zpřísněna — nově ověřuje, že data 10241 a 10242 přímo patří do hlášeného měsíce.

Dostali jste odpověď na svou otázku?