Samotný výpočet miezd cez REST API vykonať nemožno — evidencia mzda má import zakázaný. Dáta personalistiky sa však cez API spravovať dajú a import osôb a pracovných pomerov je dnes už aj popísaný v referenčnej dokumentácii.
Čo cez API ide
Evidencia | Import |
| Podporovaný a popísaný — vrátane pravidiel verzovania. |
| Import funguje, ale nie je dokumentovaný. |
| Import zakázaný — mzdu nemožno cez API vypočítať ani založiť. |
Stav pri ktorejkoľvek evidencii si overíte v poli importStatus zoznamu evidencií, pozri Import evidencií cez API.
Verzovanie osôb a pracovných pomerov
Osoba aj pracovný pomer sa neukladajú ako jeden záznam, ale ako séria časovo platných verzií vymedzených poľami platiOd a platiDo. Import s novým platiOd preto:
nájde nastavenie, ktoré sa s novým obdobím prekrýva, a skráti ho (nastaví
platiDona deň pred novýmplatiOd),založí novú verziu s hodnotami prevzatými z predchádzajúcej,
a až do nej zapíše importované hodnoty.
<winstrom version="1.0">
<osoba>
<osbCis>123</osbCis>
<platiOd>2026-07-01</platiOd>
<prijmeni>Novotná</prijmeni>
</osoba>
</winstrom>
💡 Atribút propsatDoBudoucna="true" premietne zmenu aj do všetkých budúcich verzií nastavenia. Nepropagujú sa polia platiOd, platiDo a password.
Identifikácia záznamov
Osoba sa vyhľadáva postupne podľa vnútorného ID, osobného čísla (osbCis), rodného čísla (rodCis), kombinácie rodného čísla a EČP, alebo samotného ecp. Pracovný pomer podľa vnútorného ID, kodCsszPP alebo idPpv v kombinácii s platiOd.
Vnorené kolekcie majú obal v camelCase a položky s pomlčkami — napríklad bankovniSpojeni / mzdy-bankovni-spojeni, pracovniPomery / pracovni-pomer alebo staleMzdoveSlozky / stala-mzdova-slozka.
⚠️ Mzdová agenda je legislatívne citlivá a chyba v dátach sa prejaví až vo výplate. Postupy preto vždy najprv vyskúšajte na testovacej firme a výsledok skontrolujte v aplikácii.