Samotný výpočet mezd přes REST API provést nelze — evidence mzda má import zakázaný. Data personalistiky ale přes API spravovat lze a import osob a pracovních poměrů je dnes i popsaný v referenční dokumentaci.
Co přes API jde
Evidence | Import |
| Podporovaný a popsaný — včetně pravidel verzování. |
| Import funguje, ale není dokumentovaný. |
| Import zakázán — mzdu nelze přes API vypočítat ani založit. |
Stav si u kterékoli evidence ověříte v poli importStatus seznamu evidencí, viz Import evidencí přes API.
Verzování osob a pracovních poměrů
Osoba i pracovní poměr se neukládají jako jeden záznam, ale jako řada časově platných verzí vymezených poli platiOd a platiDo. Import s novým platiOd proto:
najde nastavení, které se s novým obdobím překrývá, a zkrátí je (nastaví
platiDona den před novýmplatiOd),založí novou verzi s hodnotami převzatými z předchozí,
a teprve do ní zapíše importované hodnoty.
<winstrom version="1.0">
<osoba>
<osbCis>123</osbCis>
<platiOd>2026-07-01</platiOd>
<prijmeni>Novotná</prijmeni>
</osoba>
</winstrom>
💡 Atribut propsatDoBudoucna="true" promítne změnu i do všech budoucích verzí nastavení. Nepropagují se pole platiOd, platiDo a password.
Identifikace záznamů
Osoba se dohledává postupně podle vnitřního ID, osobního čísla (osbCis), rodného čísla (rodCis), kombinace rodného čísla a EČP, nebo samotného ecp. Pracovní poměr podle vnitřního ID, kodCsszPP nebo idPpv v kombinaci s platiOd.
Vnořené kolekce mají obal v camelCase a položky s pomlčkami — například bankovniSpojeni / mzdy-bankovni-spojeni, pracovniPomery / pracovni-pomer nebo staleMzdoveSlozky / stala-mzdova-slozka.
⚠️ Mzdová agenda je legislativně citlivá a chyba v datech se projeví až ve výplatě. Postupy proto vždy nejdřív vyzkoušejte na testovací firmě a výsledek zkontrolujte v aplikaci.