Nastavení osoby v personalistice pomocí REST API

Pro import přes API je využívána evidence Osoba, její popis naleznete na adrese:

https://{váš server}/c/{id firmy}/osoba/properties

Získání dat

Pro načtení informací o osobě využijeme metodu GET na endpoint (analogicky .json):

https://{váš server}/c/{id firmy}/osoba.xml

Pro získání dat můžeme využít standardní filtrování a úroveň detailu.

Odeslání dat

Pro odeslání dat o osobě využijeme metodu POST na endpoint (analogicky .json):

https://{váš server}/c/{id firmy}/osoba.xml

Příklad těla požadavku:

<?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>

Importem lze pouze přidávat nová nastavení osoby s uvedeným začátkem platnosti a nebo mazat vybraná nastavení kromě posledního. Platnosti ostatních nastavení se adekvátně upravují.

Smazání nastavení provedeme metodou metodou POST a pomocí akce delete. https://{váš server}/c/{id firmy}/osoba.xml

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

Nově importovaná nastavení osoby lze kromě odkazem na hlavičku osoby (https://{váš server}/c/{id firmy}/osoba-hlavicka/properties)

identifikovat také osobním číslem zaměstnance:

<?xml version="1.0"?>
<osbCis>PP123456</osbCis>