Skip to main content

JMHZ – JMHZ Browser (External Add-on)

How to View JMHZ Reports in a Readable Format Using an External Add-on?

Written by Petr Pech

When submitting JMHZ, ABRA Flexi generates an XML file in the format defined by the ČSSZ. This file is intended for electronic submission and is not particularly easy to review manually.

For easier data verification, you can use the simple tool at this link.

This tool allows you to view the JMHZ XML file in a clear, human-readable format.

How to use the tool

  1. Open the JMHZ XML viewer page.

  2. Upload the XML file for REGZEC or MH:

    • by dragging it into the window, or

    • by clicking Load XML

  3. The tool displays the report content in a structured format (form). Data can be viewed in table format or as cards.

What it is useful for

It helps, for example, with:

  • checking data before submitting a report

  • analysing errors in XML

  • verifying values calculated in payroll

  • communicating with support

  • data can be corrected here and saved back to XML using the Save XML button. If data is corrected that also affects the document header — typically health insurance — this change must also be reflected in the header.

This tool is intended solely as a utility for reviewing MH or REGZEC XML files. The actual submission of reports is carried out in the standard way (e.g. via the ČSSZ ePortal).

🚧 Known limitations and areas for further development

Description

Status

Fixed in version

JMHZ Viewer – Municipality of workplace (10229) may not match the exact value from the code list

🟢 Done

JMHZ Viewer – improve error message when prohibited fields are filled in

🟢 Done

JMHZ Viewer – duplicate PPV ID is not flagged when duplicate ID PPV is present (error M251)

🟢 Done

jmhz-viewer-2026-05-26

JMHZ Viewer – display GUID

🟢 Done

jmhz-viewer-2026-05-26

JMHZ Viewer – disable validations for Cancellation action

🟢 Done

jmhz-viewer-2026-05-20

JMHZ Viewer – focus is on the wrong field for certain elements

🟢 Done

jmhz-viewer-2026-05-20

JMHZ Viewer – review check M343 for deferred income

🟢 Done

jmhz-viewer-2026-05-20

JMHZ Viewer – review rounding in check 315

🟢 Done

jmhz-viewer-2026-05-20

JMHZ Viewer – review check M242

🟢 Done

jmhz-viewer-2026-05-20

JMHZ Viewer – review action A8 REGZEC check

🟢 Done

jmhz-viewer-2026-05-20

JMHZ Viewer – fix display of deferred income

🟢 Done

jmhz-viewer-2026-05-15

JMHZ Viewer – fix sanitisation on save

🟢 Done

jmhz-viewer-2026-05-15

JMHZ Viewer – fix IK MPSV validation

🟢 Done

jmhz-viewer-2026-05-15

JMHZ Viewer – update MH checks

🟢 Done

jmhz-viewer-2026-05-15

JMHZ Viewer – review check R172 for action A2

🟢 Done

jmhz-viewer-2026-05-07

JMHZ Viewer – municipality names do not need to match the exact value from the code list

🟢 Done

jmhz-viewer-2026-05-07

JMHZ Viewer – incorrect values in the "Work performed predominantly" code list

🟢 Done

jmhz-viewer-2026-05-05

JMHZ Viewer does not recognise 'Ž' as a valid gender code list value (error R16)

🟢 Done

jmhz-viewer-2026-05-04

JMHZ Viewer – validation – add checks for specific code list values

🟢 Done

jmhz-viewer-2026-04-30

JMHZ Viewer – API for code lists

🟢 Done

jmhz-viewer-2026-04-30

JMHZ Viewer – review check R100 when Reason for termination is not provided

🟢 Done

jmhz-viewer-2026-04-30

JMHZ Viewer – fix checks M325 and M245

🟢 Done

jmhz-viewer-2026-04-30

JMHZ Viewer – checks for employees with permanent residence abroad

🟢 Done

jmhz-viewer-2026-04-30

JMHZ Viewer – incorrect check M229 for discount on 4th and subsequent children

🟢 Done

jmhz-viewer-2026-04-30

JMHZ Viewer – ability to load metadata from the official ČSSZ CSV file

🟢 Done

jmhz-viewer-2026-04-30

JMHZ Viewer – improvements to sanitisation and XML generation

🟢 Done

jmhz-viewer-2026-04-30

JMHZ Viewer – ZIP support in embed mode (external integration)

🟢 Done

jmhz-viewer-2026-04-30

JMHZ Viewer – fix sorting and saving of dependent children

🟢 Done

jmhz-viewer-2026-04-30

JMHZ Viewer – review REGZEC validation – type of pension + pension received from

🟢 Done

jmhz-viewer-2026-04-23

JMH Viewer – review K229 when there are multiple children for whom no discount is applied

🟢 Done

jmhz-viewer-2026-04-23

JMHZ Viewer – enable loading and saving of ZIP files

🟢 Done

jmhz-viewer-2026-04-23

JMHZ Viewer – option to display additional employee information

🟢 Done

jmhz-viewer-2026-04-23

JMHZ Viewer – support for passing Flexi customer number as a parameter

🟢 Done

jmhz-viewer-2026-04-23

JMHZ Viewer – validation of field obligations (columns I – X)

🟢 Done

jmhz-viewer-2026-04-23

JMHZ Viewer – add checks for REGZEC attachments

🟢 Done

jmhz-viewer-2026-04-23

JMHZ Viewer – empty elements after deleting a value cause XSD errors

🟢 Done

jmhz-viewer-2026-04-23

JMHZ Viewer – check R50 – perform only for action A3

🟢 Done

jmhz-viewer-2026-04-23

JMHZ Viewer – review check for permanent address completion for Slovak employees

🟢 Done

jmhz-viewer-2026-04-23

JMHZ Viewer – review checks M214 and M215

🟢 Done

jmhz-viewer-2026-04-17

JMHZ Viewer – review check R201

🟢 Done

jmhz-viewer-2026-04-17

JMHZ Viewer – add further MH checks

🟢 Done

jmhz-viewer-2026-04-16

JMHZ Viewer – REGZEC – validation of Specific obligations (column F)

🟢 Done

jmhz-viewer-2026-04-16

JMHZ Viewer – REGZEC – validation of Logical checks (column G)

🟢 Done

jmhz-viewer-2026-04-16

JMHZ Viewer – REGZEC – validation of Obligation conditions (columns Y – AA)

🟢 Done

jmhz-viewer-2026-04-16

JMHZ Viewer – cover existing MH checks with tests

🟢 Done

jmhz-viewer-2026-04-16

JMHZ Viewer – fix loading of XML files with windows-1250 encoding

🟢 Done

jmhz-viewer-2026-04-16

JMHZ Viewer – support for multiple files at once

🟢 Done

jmhz-viewer-2026-04-16

JMHZ Viewer – UI fixes and improvements

🟢 Done

jmhz-viewer-2026-04-10

JMHZ Viewer – some basic checks do not run when automatically opened from Flexi

🟢 Done

jmhz-viewer-2026-04-10

JMHZ Viewer – does not display discount data in the header

🟢 Done

jmhz-viewer-2026-04-10

JMHZ Viewer – does not report error 329

🟢 Done

jmhz-viewer-2026-04-10

JMHZ Viewer – review K42

🟢 Done

jmhz-viewer-2026-04-10

JMHZ Viewer – Report a problem dialog

🟢 Done

jmhz-viewer-2026-04-10

JMHZ Viewer – improvements to XLS export

🟢 Done

jmhz-viewer-2026-04-10

JMHZ Viewer – save to PDF

🟢 Done

jmhz-viewer-2026-04-08

JMHZ Viewer – implementation of REGZEC attachments

🟢 Done

jmhz-viewer-2026-04-08

JMHZ Viewer – review check K37 for IK MPSV

🟢 Done

jmhz-viewer-2026-04-08

JMHZ Viewer – checks K284, K216, K7 do not respect the employment type

🟢 Done

jmhz-viewer-2026-04-08

JMHZ Viewer – review check K332

🟢 Done

jmhz-viewer-2026-04-08

JMHZ Viewer – tighten check K99

🟢 Done

jmhz-viewer-2026-04-08

JMHZ Viewer – review K255 – validation of primary PPV for an employee with multiple employment relationships

🔴 Closed

JMHZ Viewer – Excel spreadsheet cannot be opened in a spreadsheet editor on macOS

🔴 Closed

JMHZ Viewer – verify that XML format validation correctly validates optional elements

🔴 Closed

JMHZ Viewer – may not report an error when "Work performed predominantly" is not filled in

🔴 Closed

JMHZ Viewer – reverse XML saving

⚪ Planned

JMHZ Viewer – add a summary row directly on the page

⚪ Planned

JMHZ Viewer – add option to merge Monthly Report XML files from multiple payroll offices

⚪ Planned

JMHZ Viewer – enable cursor-based navigation

⚪ Planned

JMHZ Viewer – support for PREZEC

⚪ Planned

⚙️ Changelog

26 May 2026

Improvements

  • Added the option to display GUID identifiers in the JMHZ Viewer — the menu now allows you to enable display of the submission ID and form ID, with a protective warning when editing them. In addition, the table can now be scrolled sideways by dragging with the mouse, making it easier to work with wide lists of items.

Bug fixes

  • Fixed visual highlighting of duplicate PPV IDs in the JMHZ Viewer – problematic fields are now highlighted directly on the employee record, making it easier to identify errors during data checks. Also fixed the display of other error types (missing payment date, incorrect form type, and others), which are now consistently highlighted directly within the employee's data.

20 May 2026

Bug fixes

  • Fixed error evaluation in the JMHZ Viewer for cancellation reports – checks are now only triggered for relevant rules (deadlines, periods, structure), not for all rules. The same adjustment also applies to cancelling an individual employee within a corrective report.

  • Fixed navigation to the erroneous field in the JMHZ Viewer, where focus was in some cases set to the wrong location instead of the relevant field containing the error.

  • Fixed check M343 in the JMHZ agenda — the viewer now correctly recognises deferred income as a valid form type and will no longer incorrectly report it as not matching the activity type.

  • Fixed rounding in check 315 in the JMHZ Viewer – the system now correctly detects even minimal discrepancies in insurance contributions (differences from as little as CZK 1) that were previously overlooked.

  • Fixed check M242 in the JMHZ Viewer — it will no longer raise false errors about a missing country of residence, which is not available in the monthly report. The check itself continues to be performed on the ČSSZ side.

  • Fixed check for action A8 (Cancellation) in the JMHZ Viewer – the error was caused by an outdated code list source that did not include all REGZEC actions. The code list is now connected to current MPSV data, so reports will no longer contain false errors.

15 May 2026

Improvements

  • Fixed 12 outdated checks in the JMHZ Viewer that the ČSSZ ePortal no longer validates, and updated 9 checks in line with the current MPSV legislative catalogue. The viewer now correctly reflects the current requirements for monthly reports.

Bug fixes

  • Fixed the display of deferred income data in the JMHZ Viewer — the income type, month, and year of the period are now correctly displayed, as they were previously not shown. Also fixed a bug where ELDP records were being duplicated in the viewer.

  • Fixed saving of values in the JMHZ Viewer – missing sections in the XML are now automatically created and user edits are correctly saved without being lost when the file is reloaded.

7 May 2026

Bug fixes

  • Fixed check R172 in the JMHZ Viewer – it is no longer triggered for action A2, as this action does not use the work authorisation data that the check requires.

  • Expanded flexibility when entering municipality names in the JMHZ agenda – you no longer need to use the exact value from the code list and may enter your own text for the place of work.

5 May 2026

Bug fixes

  • Fixed incorrect code list values in the JMHZ Viewer for the "Currently offered work" field — users now see the correct selection options according to the official CIS_PRUBEH_PRACE code list.

4 May 2026

Bug fixes

  • Fixed gender validation in the JMHZ Viewer, which now correctly recognises all valid gender code list values (M, Ž, 0, 9) and no longer generates false error messages.

30 April 2026

Improvements

  • Added code list value validation in the JMHZ Viewer — new checks now verify the correctness of data such as the document-issuing country, municipality code, tax identification type, document type, work authorisation type, and other mandatory fields. The editor also now displays dropdown suggestions with valid values by code or name, speeding up form completion.

  • Fixed loading of code lists for JMHZ — values are now automatically downloaded every night from 4 official sources (MPSV, ČSSZ, ČSÚ) and published as a public API that can also be used by external developers and other systems. The JMHZ Viewer thus gains access to all necessary checks against correct and always up-to-date data.

  • Added the option to load employee metadata directly from the official ČSSZ CSV file – the viewer automatically recognises and matches them to your records by IDPPV or, as a fallback, by OIČ. For better clarity, the table adapts to the content and displays only relevant columns; custom CSV formats continue to be supported as well.

  • Fixed the behaviour of the JMHZ Viewer when saving XML — empty optional fields are now removed only in fields you have edited, while all other fields remain unchanged. Each time you save, an identification comment with the version and timestamp is automatically inserted into the file, so that XML edited in our tool can be distinguished from XML generated directly by the ERP system.

  • Extended JMHZ Viewer support so that in embed mode it automatically processes ZIP files passed from an external system (in addition to the existing XML). The system now allows integrating applications to pass multiple reports in a single ZIP archive, which the viewer loads and processes without any further user interaction.

Bug fixes

  • Fixed check R100 in the JMHZ agenda, which was incorrectly requiring the "Severance pay entitlement" attribute to be filled in even when "Reason for termination" is not required based on the activity type.

  • Fixed checks M325 and M245 in the JMHZ Viewer, which now correctly recognise all agreements to complete a job with a single employer and correctly apply the applicable limits. The tax base is also now correctly summed across all forms for the same employee, eliminating falsely reported errors.

  • Fixed validation of Czech residence data in the JMHZ agenda for employees with permanent residence abroad — the exception for cross-border workers is now correctly applied during re-registration and correction, and the system now also requires a Czech residence address for employees from other foreign countries.

  • Fixed check M229 in the JMHZ Viewer – false errors will no longer be reported when applying a discount for the fourth and subsequent children with the correct order.

  • Fixed sorting of dependent children in the JMHZ Viewer – a child with order N is now displayed after children with numeric orders. Also fixed saving of children's data, which was previously not being written to the file after being filled in.

23 April 2026

Improvements

  • Extended the functionality of the JMHZ Viewer to support loading and saving ZIP files containing reports that are submitted through the e-portal in zipped format. When saving, you can choose between XML or ZIP format and select between saving directly or via a dialog with options.

  • Extended the JMHZ Viewer with detailed employee information — you can now see the personal number, first name, last name, and employment details directly in the table, without having to search through lists. Columns can also be pinned so they remain visible when scrolling.

  • Added automatic pre-selection of the customer number in the JMHZ Viewer, speeding up and simplifying the process of reporting issues directly from the Flexi application.

  • Fixed validation of mandatory and prohibited fields in the JMHZ Viewer — the system now checks whether all mandatory fields are filled in and also alerts users to fields that must not be filled in. Checks run automatically based on the employee's action type and ensure the report is correctly completed.

  • Added attachment validation in the JMHZ agenda — the system now automatically verifies the length of the attachment name and description (max. 100 characters), the size of individual files (max. 2 MB), and the total size of all attachments (max. 4 MB), with files exceeding the limits being immediately rejected. Permitted file formats are also verified, ensuring consistency and security of your reports.

  • Fixed validation in the JMHZ Viewer — empty optional fields will no longer trigger XSD errors. Deleting a value will automatically remove the field from the XML, while mandatory fields remain under control and will be correctly reported as missing.

Bug fixes

  • Improved REGZEC validation in the JMHZ agenda – the system now correctly checks the combination of pension type and the date from which the pension is received, preventing errors when reporting to the social insurance authority.

  • Fixed checks M229 and M230 in the JMH Viewer – they now correctly skip children for whom no discount is applied and no longer falsely report verification warnings.

  • Fixed check R50 in the JMHZ agenda – validation is now only performed for actions A3 and A4, eliminating false errors when working with other action types.

  • Fixed address validation in the JMHZ Viewer – it now correctly handles foreign permanent addresses (Germany, Poland, Slovakia, Austria) without unnecessarily requiring additional data.

17 April 2026

Bug fixes

  • Fixed child age check in the JMHZ Viewer – it will no longer be triggered unnecessarily in cases where no discount is applied for the child.

  • Fixed check R201 in the JMHZ Viewer — the system now correctly verifies the obligation to fill in the foreign legislation country code only when the relevant affiliation is actually stated.

16 April 2026

Improvements

  • Added monthly report checks in the JMHZ Viewer — implemented 12 simple checks (e.g. mandatory completion of subordinate attributes, ELDP code checks) and 11 structural checks ensuring the correctness of the submission format. The remaining 45 checks are awaiting delivery of code lists or an extension of field mapping, while 68 complex checks require access to ČSSZ central systems.

  • Fixed specific obligation validation in the JMHZ Viewer for the REGZEC report — conditionally mandatory fields are now checked (e.g. residential address number, reason for termination of employment, foreign national's work authorisation ID) based on data entered in other fields and employee characteristics.

  • Fixed data validation in the JMHZ agenda — the viewer now correctly checks field formats, address data, dates, and logical dependencies between fields according to the REG-ZEC specification, and displays errors for mandatory fields and incorrect formats.

  • Fixed and extended obligation condition validation in the JMHZ Viewer – the system now correctly checks which fields are mandatory, optional, or prohibited under current legislation. Added 12 new checks for verifying residence data, work authorisation, and other employee parameters in accordance with the REG-ZEC specification.

  • Extended the functionality of the JMHZ Viewer to support working with multiple files simultaneously – you can now open multiple XML files at the same time and switch between them quickly without losing their state. File import via drag & drop and classic upload has also been improved, and the system now correctly handles opening multiple files in a single operation.

Bug fixes

  • Fixed loading of XML files with windows-1250 encoding in the JMHZ Viewer — the application now correctly detects and processes files in this format, which is also used by ČSSZ services.

11 April 2026

Improvements

• Fixed the visualisation of content in card view, which was previously being incorrectly truncated, and removed unwanted toast notifications from PDF exports. Also improved the visibility and consistency of unsaved-changes indicators in the editing environment and increased the loading speed of tables with a large number of records.

• Fixed the display of discount data in the JMHZ Viewer header – all discount types are now correctly displayed (employer discount, employee discounts, and the fruit and vegetables discount).

• Added a "Report a problem" button in the JMHZ Viewer, making it easier to report errors directly to the support email – the dialog allows you to describe the issue and add your customer number. When the message is sent, diagnostic information about the document and the checks that were run is automatically attached, helping the support team resolve the issue more quickly.

• Updated the JMHZ list export to Excel so that numeric values are correctly exported and the file can be opened without issues in the Numbers application on macOS.

Bug fixes

• Fixed a bug where basic monthly report checks were not triggered when the JMHZ Viewer was automatically opened from the Flexi wizard – checks now run correctly together with XSD validation.

• Fixed a bug where error 329 was not being detected. Check for error 329 has been newly implemented.

• Updated check K42 in the JMHZ Viewer so that it correctly evaluates the conditions for field 10372 depending on whether fields 10239 and 10502 are filled in. The check now works correctly even in situations where MPSV or PPV identifiers are not available.

8 April 2026

Improvements

  • An "Export to PDF" button with output configuration options has been added to the JMHZ Viewer.

  • A new Attachments category has been added to both views of the JMHZ Viewer (card and table), available for REGZEC only. Files of any type and size can be attached — for files over 20 MB the application will warn of possible slowdown. Attachments can be downloaded or removed at any time.

Fixes

  • Fixed check K37 for IK MPSV (attribute 10051) — validation now complies with the official rule for calculating the check digit.

  • Checks K7, K216, and K284 now correctly take the employee's form type into account. For the activity KS and foster parent variants, the assessment base breakdown check is skipped; in K7, field 10477 is summed instead of 10478 for these variants.

  • Fixed check K332, which was incorrectly looking for the primary PPV element as a child node instead of a sibling element.

  • Check K99 has been tightened — it now verifies that dates 10241 and 10242 fall directly within the reported month.

Did this answer your question?