Ministerstvo práce a sociálních věcí · podklady pro dodavatele mzdových systémů
Změny JMHZ k 1. lednu 2027
Co musí mzdový a personální software změnit, aby od ledna 2027 správně podával měsíční hlášení a registrace.
MPSV provozuje obě verze procesů vedle sebe. Pro návrh vašeho řešení je to nejdůležitější informace v celé dodávce.
Podání za období 2026 a dřívější — včetně opravných a storno hlášení podaných kdykoli později. Platí dosavadní stav.
Podání za období 2027 a dále. Platí změny popsané v těchto podkladech.
Rozhoduje vykazované období, ne datum odeslání. Opravné hlášení za listopad 2026 podané v březnu 2027 se řídí verzí 2026. Vaše řešení proto musí obě sady atributů a kontrol udržovat současně a přepínat mezi nimi podle období.
S-PREHLED §1Co všechno se mění
Dodávka se dotýká čtyř zdrojových dokumentů. Tady je rozsah v každém z nich; podrobnosti jsou v kapitolách.
100
atributů k zapracování
ze 149 změněných; zbytek nevyžaduje zásah
49
kontrol k ošetření
z toho 48 nepropustných
8
dotčených interakcí
a datových scénářů
62
změn v externí
datové větě
Atributy — datový slovník
| Typ změny | Počet | Co to pro vás znamená |
|---|---|---|
| úprava konzumace atributu | 43 | nic — mění se jen, která instituce data čte |
| přejmenování atributu | 35 | ověřit, zda se nezměnil věcný rozsah |
| změna oblasti atributu | 30 | přeřazení ve struktuře dokumentu |
| přidání atributu | 28 | nové pole, nová logika |
| změna datového typu | 16 | úprava formátu |
| odstranění atributu | 15 | přestat posílat |
| změna třídy atributu | 8 | přeřazení |
| úprava číselníku | 7 | nové nebo odebrané hodnoty |
| změna četnosti | 5 | jinak se opakuje |
| změna periodicity hlášení | 1 | jiná perioda vykazování |
| úprava prefillu - vzorce | 1 |
Kontroly — katalog kontrol měsíčního hlášení
| Druh změny | Počet | Co to pro vás znamená |
|---|---|---|
| nová kontrola | 22 | zavést |
| změna pravidla | 26 | prověřit dopad |
| zrušená kontrola | 1 | odstranit, máte-li ji jako vlastní předvalidaci |
| k ošetření celkem | 49 | z toho 48 nepropustných |
| jen nový název atributu | 35 | nic — pravidlo ani chybový kód se nemění |
| dotčeno celkem | 84 | z 220 kontrol v katalogu |
Nepropustná kontrola znamená odmítnuté podání
Z 49 kontrol k ošetření je 48 nepropustných — při jejich porušení podání neprojde. Ošetřete je přednostně.
Interakce a datové scénáře
| Kód | Co se s ní děje | Kde je popsaná |
|---|---|---|
| IN03 | změna interakcí atributu | Průběh pojištění v daném měsíci |
| IN16 | přidání atributu do interakce | Souhrnná data zaměstnance |
| IN39 | vytvoření nové interakce | Souhrnná data zaměstnance |
| IN40 | vytvoření nové interakce | Průběh pojištění v daném měsíci |
| IN41 | vytvoření nové interakce | Vykonávaná pozice zaměstnance |
| IN42 | vytvoření nové interakce | Průběh zaměstnání v daném měsíci |
| IN43 | vytvoření nové interakce | Průběh zaměstnání v daném měsíci |
| M12 | změna interakcí atributu | Souhrnná část |
Externí datová věta — registrace zaměstnance
| Typ změny | Počet |
|---|---|
| Úprava logické kontroly | 18 |
| Oprava povinnostní podmínky - sloupec P | 8 |
| Změna/úprava číselníku | 6 |
| Změna povinnosti atributu | 6 |
| Změna datového typu | 5 |
| Oprava povinnostní podmínky - sloupec Z | 5 |
| odstranění atributu | 4 |
| přidání atributu | 4 |
| Oprava povinnostní podmínky - sloupec N | 3 |
| Změna vysvětlivek | 2 |
| Obecná informace | 1 |
Pro registraci zaměstnance je tento dokument tím, čím je pro měsíční hlášení datový slovník a katalog kontrol dohromady — nese atributy i jejich validační pravidla. Podrobnosti jsou v kapitole externí datové věty.
12 atributů v dodávce vzniklo a bylo zase zrušeno
Ve výsledné specifikaci 2027 neexistují — neimplementujte je. Jde o 10557, 10558, 10559, 10560, 10561, 10562, 10563, 10564, 10567, 10572, 10573, 10574.
S-PREHLED §2Kudy do podkladů
S-PREHLED §3Konvence
Povinnosti atributů
Matice povinností pro šestnáct variant akcí registrace zaměstnance, list Slovník a Vysvětlivky. · zdroj: Definice externí datové věty 1.5.0.2
Chybové kódy kontrol
Kód chyby se nikde neuvádí přímo — odvozuje se od čísla kontroly podle systému, který ji provádí.
| Systém | Vzorec | Příklad |
|---|---|---|
| DIS | idk + 20000 | kontrola 248 → chyba 20248 |
| cJMHZ | idk + 40000 | kontrola 366 → chyba 40366 |
Sloupce Systém a ID kontroly, list MH. · zdroj: Katalog kontrol MH 1.5.0.3
Interakce
Kód IN nebo M označuje situaci na ePortálu, za které se skupina atributů vykazuje. V matici datových scénářů stojí v buňce právě tento kód.
Listy Interakce, SLOVNÍK a Datové scénáře. · zdroj: Datové scénáře, interakce a povinnosti 1.5.0.2
Všechny čtyři dokumenty jsou ke stažení na developers.mpsv.cz.
S-PREHLED §4Kde začít
- Otevřete kapitoly oblastí, které ve svém systému spravujete. Kapitola dá všechny změny v té oblasti pohromadě, bez ohledu na to, ze kterého požadavku pocházejí.
- Vyřaďte změny bez dopadu. V každé kapitole jsou v samostatné sekci.
- Nejdřív nepropustné kontroly. Jejich porušení znamená odmítnuté podání.
- Naplánujte souběh verzí 2026 a 2027 dřív než jednotlivé atributy.
Podklady zpracovalo MPSV na základě dokumentů publikovaných na developers.mpsv.cz. Při rozporu mezi těmito podklady a zdrojovým dokumentem platí zdrojový dokument.