Možné chyby při podání JMHZ a postup k jejich odstranění
Praktické tipy a postupy k odstranění chyb, které může portál ČSSZ hlásit při podání JMHZ. Odkaz na aktuální verze programů DUEL a STEREO. Aktualizace 29. 5. 2026.
JMHZ a aktuální DUEL
Aktualizovaná verze z 29. května 2026.
Pod odkazem najdete, kromě samotné verze ke stažení, seznam všech změn a novinek průběžně vydávaných v roce 2026.
JMHZ a aktuální STEREO
Aktualizovaná verze z 29. května 2026.
Pod odkazem najdete, kromě samotné verze ke stažení, seznam všech změn a novinek průběžně vydávaných v roce 2026.
Katalog kontrol Měsíčního hlášení na stránkách MPSV
ODKAZ: Na Vývojářském portále Ministerstva práce a sociálních věcí je zveřejněn katalog kontrol pro JMHZ. Vysvětluje co konkrétní chyba znamená a jaké údaje způsobily její zobrazení.
Které problémy řeší nová verze DUEL 22.0.5.11720 ze dne 29. května 2026
- I pro případ, že v daném měsíci neexistuje jediná zpracovaná mzda, plní se JMHZ pouze z Personalistiky ze živých úvazků. Dosud musela existovat alespoň jedna zpracovaná mzda.
- Do pravé nápovědy agendy JMHZ byl přidán odkaz na oficiální Katalog kontrol měsíčního hlášení na vývojářském portále MPSV.
- Plnění atributů JMHZ bylo upraveno v souladu s aktualizovanými pokyny a kontrolami ze strany portálu ČSSZ:
- 10276 - Počet neodpracovaných hodin s náhradou či nekrácením mzdy (form:hodinyNeodpracNahrada).
- 10260 - Pracovní doba sjednaná (v hodinách měsíčně) (form:sjednanyFond).
- 10269 - Přesčasové hodiny (z odpracovaných) (form:prescas) - s ohledem na kontrolu 36 se nyní uvádí pouze ty, za které jsou vyplácené příplatky.
- 10344 - Čistý příjem (form:mzdaCista) nebo
- 10338 - Náhrady za dovolenou (form:dovolena) - protože podání JMHZ se zápornými hodnotami, které mohou legitimně vzniknout ve mzdě třeba při přečerpané dovolené, nejde podat, jsou záporné, které procházejí kontrolami hodnoty uměle nulovány.
- 10275 - Celkový počet neodpracovaných hodin (form:hodinyNeodpracCelkem) - u měsíčních mezd se zahrnují i dny svátku.
- 10548 - Typ Odloženého příjmu (form:typ) - na základě kontroly 339 - Kontrola existence pracovněprávního vztahu u zaměstnavatele pro odložený příjem bylo upraveno plnění, resp. neplnění (10537 - Měsíce a 10538 - Roku).
- 10344 - Čistý příjem (form:mzdaCista) - plnění opraveno podle pokynů ohledně přeplatku na dani nebo na daňovém bonusu.
- 10068 - kód státu, jehož je zaměstnanec daňovým rezidentem - oprava plnění souvisejícího datumu změny při registraci a doregistraci.
- Pro lepší přehlednost byla upravena textace chyby při registraci a doregistraci zaměstnance v případě, že není vyplněna Klasifikace zaměstnání.
- Pro podání opravných Oznámení zaměstnavatele byl do agendy Nepřítomnosti doplněn odpovídající příznak.
- V tiskových sestavách opisů z JMHZ vylo upraveno třídění podle příjmení a jména.
- V polích procent prémií v Měsíčních mzdách se nově ukládají zaokrouhlená dvě desetinná místa.
Které problémy řeší nová verze STEREO 35.08 ze dne 29. května 2026
- Byla zcela přepracována logika práce s atributy 10001 ID podání a 10012 ID formuláře:
- První řádné podání vygeneruje ID podání i ID formuláře
- ID podání i ID formuláře z řádného podání se zachovává pro všechna opravná podání až do případného STORNO podání (včetně)
- Následující řádné podání vygeneruje nová ID podání i ID formuláře
Ukládání id formuláře
Verze 35.08 opravuje stav, kdy při podání opravného MH bylo korektně zachováno id podání, ale měnila se id formuláře pro jednotlivé zaměstnance. Nyní zůstává zachováno i id formuláře, které bylo přiděleno v prvotním řádném podání a zůstává stejné do případného storna.
Upozornění: Pokud jste již odeslali opravné MH z předchozích verzí a zpět Vám přišlo hlášení o nemožnosti propojení pomocí id formuláře, pak již STEREO původní údaje nemá k dispozici a je nutno opravné hlášení vytvořit přímo na portále sociální správy.
Ve formuláři mzdy přibyl údaj JMHZ podpořený číselníkem, který se při zadávání mzdy naplní hodnotou 0 (tzn. řádné). V případě, kdy budete podávat opravné hlášení, pak stačí ve mzdě, které se opravné hlášení týká, nastavit hodnotu 1.
Došlo ke změně názvů ukládaných souborů. Nyní se vytvoří soubor s názvem JMHRRMMx, kde RR je poslední dvojčíslí roku, MM dvojmístné uvedení měsíce a x může nabývat hodnot R – řádné, O – opravné a S – storno.
Příklad: Řádné podání za květen bude v souboru pojmenovaném JMH2605R.XML.
Které problémy řeší nová verze DUEL 22.0.4.11711 ze dne 20. května 2026
- Byl upraven výstup odpracovaných hodin v rizikové práci (atribut 10273; form:hodinyOdpracovanePocet), do kterého se hodiny odpracované v 1., 2. a 3. stupni rizika nemají započítávat (ačkoli v pojistné vrstvě odpovídající rizikové VZ a pojistné samozřejmě vystupují).
- S ohledem na kontrolu 36 byl v JMHZ upraven výpočet přesčasových hodin (atribut 10269; form:prescas) - nyní se uvádí pouze ty, za které jsou vyplácené příplatky.
- Do agend Měsíční mzdy a JMHZ byly přidány tiskové sestavy, které slouží pro kontrolu sociálního pojištění a vizuálně vychází z původního formuláře "Přehled o vyměřovacích základech". V měsíčních mzdách je vše počítáno, v JMHZ se již pouze opisují uložené hodnoty.
- Ačkoli se v JMHZ Forma vlastnictví a Typ kolektivní smlouvy odesílají pouze za 12. měsíc (kdy se tyto údaje zobrazí i v průvodci vytvořením podání), bylo pro ostatní měsíce upraveno jejich implicitní plnění do pravděpodobnějších hodnot.
Které problémy řeší nová verze STEREO 35.06 ze dne 20. května 2026
- Průběžná aktualizace JMHZ dle dostupných informací
- 10342, 10344, 10233, 10371, 10375,...
- do JMHZ již nevstupuje DruČinn= 0 - neurčeno (učni)
- Oprava výpočtu století narození z rodného čísla (využito v Osobní evidenci, evidenci dětí a druhé vyživující osoby pro JMHZ)
- Doregistrace REGZEC - prava výpočtu SQNR, odstranění elementu SME
Rezidentství - zaměstnanci ho nemají na portále a neprochází JMHZ
DŮVOD: V tomto případě se bohužel projevuje chyba na straně ČSSZ související s registrací zaměstnanců. ČSSZ potvrdila, že u části zaměstnanců došlo ke ztrátě údajů o rezidentství/nerezidentství, případně byly informace nesprávně vyplněny již při odeslání doregistrace v dubnu. V důsledku této chyby ČSSZ eviduje některé zaměstnance – rezidenty ČR (konkrétní pracovní poměry) jako nerezidenty, a proto následně JMHZ vykazuje chyby.
ŘEŠENÍ: Možností je znovu odeslat doregistraci zaměstnance (žádné údaje o rezidentství ČR už nikam v DUELu nedoplňujete): Personalistika → Operace XML → Volba č. 5 a následně odeslat XML soubor. Počkejte, až ČSSZ data zpracuje, a teprve poté odešlete opravné JMHZ.
Pokud se problém týká pouze několika zaměstnanců, můžete údaj o rezidentství upravit také ručně na portále ČSSZ – u zaměstnance doplníte do údaje Kód státu rezidentství (10068) hodnotu ČR.
Které problémy řeší nová verze DUEL 22.0.4.11710 ze dne 18. května 2026
- Automatické součtování numerických údajů pod tabulkami bylo rozšířeno o sčítání celočíselných údajů, díky čemuž je možné v agendě JMHZ snadněji provádět některé kontroly. V jiných agendách bylo ovšem nutné tuto funkčnost zakázat, protože např. automatické součty čísel dokladů (zadávaných ve tvaru 2026000001) překračují maximální rozsah datového typu integer.
- Aby bylo v JMHZ možné rozlišit jiné dávky ke mzdě, které nejsou předmětem daně (např. cestovní náhrady a jiné z § 6 odst. 6), a příjmy, které jsou od daně osvobozené (§ 6 odst. 9), byly do Personalistiky, Přípravy mezd a hlavně do Měsíčních mezd doplněné typy, pomocí kterých lze nastavit, o jakou variantu se jedná. V závislosti na nastaveném typu potom příslušné hodnoty vstupují (nebo nevstupují) do odpovídajících polí JMHZ. POZOR - po instalaci nové verze budou všechny typy nastavené jako "Není předmětem daně", což je častější. Pokud je v jiných dávkách evidován příjem "Osvobozený od daně", bude potřeba (alespoň v roce 2026) typy dávek přepnout.
- Pro zaměstnavatele na chráněném trhu práce (chráněné dílny) byly z logiky zjišťování příznaku, zda došlo ke srážkám, vypuštěny srážky dle § 147 Zákoníku práce - tedy daň z příjmů, zdravotní a sociální pojištění. (Údaj 10349 - Provedeny srážky ze mzdy nebo platu určené k uspokojení plnění zaměstnavatele; form:mzdaOzpSrazka).
- V případě dočasného přidělení bylo zadané IČO omylem doplňováno levostrannými nulami na 10 znaků. Nyní je ve shodě s XSD schématem doplňováno jen na 8 znaků (10252 - IČO uživatele).
- Pro nabízení výchozí hodnoty při pořizování měsíčních mezd byl v souvislosti s plněním JMHZ sjednocen výpočet vyloučených dní.
- Plnění neodpracovaných hodin s náhradou mzdy obsahovalo chybu, kdy se za určitých okolností připočítávaly i hodiny ze stejného měsíce nepřítomností zaměstnance minulých let. Výpočet byl opraven. Problém se týkal údajů 10277 - Počet neodpracovaných hodin v důsledku dočasné pracovní neschopnosti bez náhrady mzdy (form:hodinyNeodpracBezNahrady) a 10278 - Počet neodpracovaných hodin z důvodu dočasné pracovní neschopnosti, za které je ze strany zaměstnavatele poskytována náhrada mzdy (form:hodinyNeodpracNeschop).
- Pro daňové nerezidenty, kteří podepsali prohlášení k dani, je nyní prázdněn element 10035 - Úhrn vyplacených měsíčních daňových bonusů (form:danBonus). Tento nesmí být uveden, i když je nulový (kontrola 243).
- Při plnění OIČ a ID PPV jsou vypouštěny všechny mezery tak, aby i v případě chybného zadání nedocházelo k přetečení délky a oříznutí.
- Výstup všech textových údajů do JMHZ XML byl upraven tak, že nyní jsou ořezávány pravostranné i levostranné mezery. Typickým problémem bylo například jméno nebo příjmení dítěte, kdy zadaná mezera za jménem působila problémy.
- Byl vylepšen výpočet celkových neodpracovaných hodin, za určitých okolností se hodiny svátků napočítávaly 2x (údaj 10275 - Celkový počet neodpracovaných hodin; form:hodinyNeodpracCelkem).
- Podle pokynů se pro dohody mimo pracovní poměr nyní počet dní v evidenčním stavu vykazuje nulový (údaj 10265; form:dnyEvidencniStav).
1140 - porušuje omezení min length pro 9 rodné číslo
DŮVOD: Nějaká osoba nemá vyplněné rodné číslo. Buď přímo zaměstnanec v Personalistice, nebo jiná vyživující osoba, co je uvedená na záložce Děti v Personalistice.
ŘEŠENÍ: doplnit všem rodné číslo, i jiným vyživujícím osobám.
Do JMHZ se nenaplní jméno, příjmení, OIČ a ID PPV
DŮVOD: V číselníku STÁTY je stát, který má Kod delší než 2 znaky. (Maximum co do JMHZ projde jsou 2 znaky).
ŘESENI: Je potřeba upravit Kod v čiselniku státy. Aby např. Česka republika měla Kod = CZ. Nutno opravit u států, které jdou do JMHZ - např. pokud mám ukrajince, musí mít stát Ukrajina spravně uveden kód. POZOR na případné duplicity států, zvláště v případě, kdy tyto duplicitní údaje mají stejnou zkratku!
Chyba parseru: porušuje omezení minLength pro 1. Element obec s hodnotou se nepodařilo analyzovat.
Chyba parseru: porušuje omezení length pro 6. Element kodObce s hodnotou se nepodařilo
DŮVOD: V číselníku Umístění není vyplněn název obce a kód obce.
ŘEŠENÍ: Vyplnit název a kód obce u všech použitých umístění.
Nesprávný kód ELDP
DŮVOD: Podání JMHZ a vestavěné kontroly na ePortále ČSSZ odhalí neprávně evidované kódy ELDP u zaměstnanců i ve zpracovávaných mzdách. Tyto kódy musí být v souladu s poměrem, dohodou, souběhem, důchodem apod.
ŘEŠENÍ: Pokud se vám tato chyba zobrazí, prověřte kódy z oficiální tabulky kódů ELDP, kterou jsme zveřejnili v samostatné aktualitě.
