Na správu zamestnancov a ich pracovných pomerov slúžia v REST API dve evidencie — osoba s osobnými údajmi zamestnanca a pracovni-pomer s pracovným pomerom, ktorý je na osobu naviazaný.

ℹ️ Popri nich existujú ešte „hlavičkové" evidencie osoba-hlavicka a pracovni-pomer-hlavicka. Tie držia zamestnanca ako celok, zatiaľ čo osoba a pracovni-pomer obsahujú jeho jednotlivé časovo platné nastavenia.

Získanie dát

Dáta o osobách vyčítate metódou GET; použiť možno štandardné filtrovanie aj úroveň detailu:

GET https://demo.flexibee.eu/c/demo/osoba.xml
GET https://demo.flexibee.eu/c/demo/pracovni-pomer.json?detail=full

Verzovanie nastavenia

Obe evidencie používajú verzovanie pomocou vlastností platiOd a platiDo. Každý zamestnanec aj pracovný pomer tak môže mať viacero verzií nastavenia s rôznou časovou platnosťou. Pri importe s novým platiOd:

systém nájde existujúce nastavenie, ktoré sa s novým dátumom prekrýva,
to prekrývajúce sa automaticky skráti — nastaví mu platiDo na deň pred novým platiOd,
vytvorí novú verziu nastavenia s hodnotami skopírovanými z predchádzajúcej verzie,
a na novú verziu aplikuje hodnoty z importu.

<winstrom version="1.0">
    <osoba>
        <osbCis>123</osbCis>
        <platiOd>2026-07-01</platiOd>
        <prijmeni>Novotná</prijmeni>
    </osoba>
</winstrom>

Tento import vytvorí novú verziu nastavenia od 1. 7. 2026; predchádzajúca verzia bude automaticky ukončená k 30. 6. 2026. Odpoveď obsahuje ID novej aj skrátenej verzie.

📝 Odpoveď pri osobách často obsahuje viacero upozornení na nevyplnené legislatívne údaje — napríklad osobaOicPrazdne alebo osobaNejvyssiVzdelaniK. Import tým neblokujú, len upozorňujú, že údaje bude potrebné doplniť.

Prepísanie do budúcnosti

Atribút propsatDoBudoucna="true" premietne vykonanú zmenu aj do všetkých budúcich verzií nastavenia. Systém uloží zmenu do adresovaného nastavenia, nájde všetky nastavenia s neskorším platiOd a aplikuje na ne rovnakú zmenu:

<winstrom version="1.0">
    <pracovni-pomer propsatDoBudoucna="true">
        <idPpv>PP-001</idPpv>
        <uvazHodDenne>6.0</uvazHodDenne>
    </pracovni-pomer>
</winstrom>

Bez tohto atribútu sa zmena prejaví iba v adresovanom nastavení a budúce verzie zostanú nedotknuté. Nikdy sa nepropagujú tieto vlastnosti:

pri osobe platiOd, platiDo a password,
pri pracovnom pomere platiOd a platiDo.

Odoslanie dát

Na zápis použite metódu POST alebo PUT:

POST https://demo.flexibee.eu/c/demo/osoba.xml

<?xml version="1.0"?>
<winstrom version="1.0">
  <osoba>
    <platiOd>2021-07-01</platiOd>
    <osbCis>PP123456</osbCis>
    <prijmeni>Pavelka</prijmeni>
    <jmeno>Pavel</jmeno>
    <stredisko>code:C</stredisko>
  </osoba>
</winstrom>

Identifikácia záznamov

Osoba sa hľadá v tomto poradí: interné ID (<id>123</id>), osobné číslo (<osbCis>1</osbCis>), rodné číslo v normalizovanom formáte (<rodCis>9002020005</rodCis>), kombinácia rodCis + ecp a nakoniec samotné EČP.

Pracovný pomer sa hľadá takto: interné ID, kodCsszPP + platiOd, idPpv + platiOd, idPpv + aktívna zmluva (ak nie je uvedené platiOd) a nakoniec osoba spolu s kodCsszPP alebo idPpv.

Pre identifikáciu záznamov platia obvyklé tvary 123, code:ZKRATKA, ext:ID a ext:SYSTEM:ID. Dátumy sa zapisujú v ISO 8601, s časovým pásmom (2026-01-01+01:00) aj bez neho.

Vnorené kolekcie

Viacslovné názvy kolekcií používajú camelCase pre obal a zápis s pomlčkou pre položky:

Kolekcia	Obal	Položka
Bankové spojenie osoby	`bankovniSpojeni`	`mzdy-bankovni-spojeni`
Pracovné pomery osoby	`pracovniPomery`	`pracovni-pomer`
Deti	`deti`	`dite`
Osoby blízke	`osobyBlizke`	`osoba-blizka`
Zrážky	`srazky`	`srazka`
Stále mzdové zložky pomeru	`staleMzdoveSlozky`	`stala-mzdova-slozka`
Neprítomnosti	`nepritomnosti`	`nepritomnost`
Práca pre strediská	`praceProStrediska`	`prace-pro-stredisko`

Kompletný import osoby s pracovným pomerom

Pracovný pomer vnorený v kolekcii pracovniPomery sa automaticky prepojí s osobou, takže všetko možno poslať v jednej požiadavke:

<winstrom version="1.0">
    <osoba>
        <osbCis>1</osbCis>
        <jmeno>Jan</jmeno>
        <prijmeni>Novák</prijmeni>
        <datNaroz>1990-05-15+01:00</datNaroz>
        <rodCis>9005150001</rodCis>
        <pohlaviK>pohlavi.muz</pohlaviK>
        <zpusPlatbyK>zpusobPlatby.ucet</zpusPlatbyK>
        <zdravPoj>code:201</zdravPoj>
        <bankovniSpojeni>
            <mzdy-bankovni-spojeni>
                <buc>1234567890</buc>
                <smerKod>code:0100</smerKod>
                <primarni>true</primarni>
            </mzdy-bankovni-spojeni>
        </bankovniSpojeni>
        <pracovniPomery>
            <pracovni-pomer>
                <idPpv>PP-001</idPpv>
                <kod>PP-001</kod>
                <nazev>Hlavní pracovní poměr</nazev>
                <typPracPom>code:1-STANDARD</typPracPom>
                <aktivniOd>2026-01-01+01:00</aktivniOd>
                <zacatek>2026-01-01+01:00</zacatek>
                <hlavni>true</hlavni>
                <uvazHodDenne>8.0</uvazHodDenne>
                <uvazDnuTydne>5</uvazDnuTydne>
                <staleMzdoveSlozky>
                    <stala-mzdova-slozka>
                        <cisMzdSloz>code:MĚSÍČNÍ MZDA</cisMzdSloz>
                        <zaklMzd>45000</zaklMzd>
                    </stala-mzdova-slozka>
                </staleMzdoveSlozky>
                <nepritomnosti>
                    <nepritomnost>
                        <platiOd>2026-07-01+01:00</platiOd>
                        <platiDo>2026-07-14+01:00</platiDo>
                        <cisMzdSloz>code:DOVOLENÁ</cisMzdSloz>
                    </nepritomnost>
                </nepritomnosti>
            </pracovni-pomer>
        </pracovniPomery>
    </osoba>
</winstrom>

Mazanie nastavení

Importom možno pridávať nové nastavenia s uvedeným začiatkom platnosti a mazať vybrané nastavenia — okrem posledného zostávajúceho. Platnosti ostatných nastavení sa primerane upravia. Na zmazanie použite akciu delete:

<?xml version="1.0"?>
<winstrom version="1.0">
  <osoba action="delete">
    <id>1</id>
  </osoba>
</winstrom>

Na čo si dať pozor

Vlastnosti kodELDP a kodCsszPP nemožno po uložení pracovného pomeru zmeniť.
platiOd by malo byť prvým dňom mesiaca — inak systém zobrazí upozornenie.
Pri importe pracovného pomeru musí naviazaná osoba už existovať.

Súvisiace

Sorodni članki

Nastavenie osoby v personalistike pomocou REST API