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
Open the JMHZ XML viewer page.
Upload the XML file for REGZEC or MH:
by dragging it into the window, or
by clicking Load XML
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.



