Ministerstvo práce a sociálních věcí · JMHZverze 2.0 (major)S-PREHLED

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.

Datový slovník 1.5.0.3Katalog kontrol 1.5.0.4Datové scénáře 1.5.0.3Externí datová věta 1.5.0.3
Verze 2026 a 2027 běží souběžně

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.

2026

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.

2027

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 167 změněných; zbytek nevyžaduje zásah

111

kontrol k ošetření
z toho 97 nepropustných

10

dotčených interakcí
a datových scénářů

71

změn v externí
datové větě

Atributy — datový slovník

Typ změnyPočetCo to pro vás znamená
úprava konzumace atributu62nic — mění se jen, která instituce data čte
přejmenování atributu36ověřit, zda se nezměnil věcný rozsah
změna oblasti atributu30přeřazení ve struktuře dokumentu
přidání atributu28nové pole, nová logika
změna datového typu16úprava formátu
odstranění atributu15přestat posílat
změna třídy atributu8přeřazení
úprava číselníku7nové nebo odebrané hodnoty
změna četnosti5jinak se opakuje
změna periodicity hlášení1jiná perioda vykazování
odstranění prefillu1
úprava prefillu - vzorce1

Kontroly — katalog kontrol měsíčního hlášení

Druh změnyPočetCo to pro vás znamená
nová kontrola20zavést
změna pravidla90prověřit dopad
zrušená kontrola1odstranit, máte-li ji jako vlastní předvalidaci
k ošetření celkem111z toho 97 nepropustných
jen nový název atributu9nic — pravidlo ani chybový kód se nemění
dotčeno celkem120z 221 kontrol v katalogu

Nepropustná kontrola znamená odmítnuté podání

Z 111 kontrol k ošetření je 97 nepropustných — při jejich porušení podání neprojde. Ošetřete je přednostně.

Interakce a datové scénáře

KódCo se s ní dějeKde je popsaná
IN03změna interakcí atributuPrůběh pojištění v daném měsíci
IN13vyjmutí atributu z interakcePříjem v daném měsíci
IN16přidání atributu do interakceSouhrnná data zaměstnance
IN38vytvoření nové interakceSouhrnná část
IN39vytvoření nové interakceSouhrnná data zaměstnance
IN40vytvoření nové interakcePrůběh pojištění v daném měsíci
IN41vytvoření nové interakceVykonávaná pozice zaměstnance
IN42vytvoření nové interakcePrůběh zaměstnání v daném měsíci
IN43vytvoření nové interakcePrůběh zaměstnání v daném měsíci
M12změna interakcí atributuSouhrnná část

Externí datová věta — registrace zaměstnance

Typ změnyPočet
Úprava logické kontroly25
Oprava povinnostní podmínky - sloupec P8
Změna/úprava číselníku6
Změna povinnosti atributu6
Změna datového typu5
Oprava povinnostní podmínky - sloupec Z5
odstranění atributu4
přidání atributu4
Oprava povinnostní podmínky - sloupec N3
Změna vysvětlivek2
Obecná informace2
Přidání technického atributu1

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ů

Ppovinný
Nnepovinný
PPpodmíněně povinný — podmínka je uvedená u atributu
/nesmí být uveden

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

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émVzorecPříklad
DISidk + 20000kontrola 248 → chyba 20248
cJMHZidk + 40000kontrola 366 → chyba 40366

Sloupce Systém a ID kontroly, list MH.  ·  zdroj: Katalog kontrol MH 1.5.0.4

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

Všechny čtyři dokumenty jsou ke stažení na developers.mpsv.cz.

S-PREHLED §4Kde začít

  1. 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í.
  2. Vyřaďte změny bez dopadu. V každé kapitole jsou v samostatné sekci.
  3. Nejdřív nepropustné kontroly. Jejich porušení znamená odmítnuté podání.
  4. 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.