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>