WebAPI Kmenové údaje: Porovnání verzí

Z Prirucky
(Založena nová stránka: =Čtení pomocí WebAPI= {|border="1" cellpadding="3" cellspacing="0" |- style="background-color: #eeeeee" |'''Údaj''' |'''Datový typ''' |'''Význam''' |} =Zápis pomoc…)
 
 
(Není zobrazeno 16 mezilehlých verzí od 2 dalších uživatelů.)
Řádek 1: Řádek 1:
=Čtení pomocí WebAPI=
=Čtení pomocí WebAPI=
{|border="1" cellpadding="3" cellspacing="0"
{|class="wikitable sortable" border="1" cellpadding="3" cellspacing="0"
|- style="background-color: #eeeeee"
|- style="background-color: #eeeeee"
|'''Údaj'''
|'''Údaj'''
|'''Datový typ'''
|'''Datový typ'''
|'''Význam'''
|'''Význam'''
|-
| OsCislo
| decimal(10,0)
| osobní číslo pracovníka (čís. píchačky)
|-
| Prijmeni
| char(40)
| přijmení pracovníka
|-
| Jmeno
| char(40)
| jméno pracovníka
|-
| Titul
| char(25)
| akademický titul pracovníka
|-
| RodneJmeno
| char(40)
| rodné jméno pracovníka
|-
| RodneCislo
| char(10)
| rodné číslo pracovníka
|-
| MistoNarozeni
| char(48)
| místo narození pracovníka
|-
| RodinStav
| char(1)
| rodinný stav pracovníka
{|  style="border: 0" class="innerTable"
| 5
| -
| druh(družka)
|-
| 4
| -
| ovdovělý (á)
|-
| 3
| -
| rozvedený (á)
|-
| 2
| -
| ženatý (vdaná)
|-
| 1
| -
| svobodný (á)
|}
|-
| Narodnost
| char(2)
| národnost pracovníka
{|  style="border: 0" class="innerTable"
| 0
| -
| nezjištěná
|-
| 1
| -
| česká
|-
| 2
| -
| slovenská
|-
| 3
| -
| ukrajinská
|-
| 4
| -
| ruská
|-
| 5
| -
| polská
|-
| 6
| -
| maďarská
|-
| 7
| -
| německá
|-
| 8
| -
| bulharská
|-
| 9
| -
| ostatní
|}
|-
| StPrisl
| char(3)
| státní příslušnost pracovníka
{|  style="border: 0" class="innerTable"
| 435
| -
| Rakousko
|-
| 427
| -
| Německo
|-
| 311
| -
| Jugoslávie
|-
| 203
| -
| Česko nově
|-
| 192
| -
| Slovensko
|-
| 191
| -
| Česko
|-
| 161
| -
| Rumunsko
|-
| 151
| -
| Polsko
|-
| 131
| -
| Maďarsko
|-
| 121
| -
| Bulharsko
|-
| 101
| -
| SNS
|}
|-
| CisloOp
| char(12)
| číslo občanského průkazu
|-
| CisloPasu
| char(12)
| číslo pasu
|-
| BranPov
| char(2)
| indikace branné povinnosti pracovníka
{|  style="border: 0" class="innerTable"
| 0
| -
| nevoják
|-
| 1
| -
| branec
|-
| 2
| -
| voják
|}
|-
| UliceTrv
| char(45)
| ulice a číslo domu trvalého bydliště pracovníka
|-
| TrUlice
| char(30)
| ulice trvalého bydliště pracovníka
|-
| TrCislo
| char(14)
| číslo domu trvalého bydliště pracovníka
|-
| MistoTrv
| char(48)
| místo trvalého bydliště
|-
| StatAdr
| char(2)
| Kód státu u trvalého bydliště
|-
| PscTrv
| char(5)
| PSČ trvalého bydliště
|-
| PostaTrv
| char(48)
| pošta tvrvalého bydliště
|-
| TrvPostcode
| char(11)
| Postcode u trvalého bydliště (zahraniční adresa)
|-
| UlicePrech
| char(45)
| ulice přechodného bydliště pracovníka
|-
| PrUlice
| char(30)
| ulice přechodného bydliště pracovníka
|-
| PrCislo
| char(14)
| číslo domu přechodného bydliště pracovníka
|-
| MistoPrech
| char(48)
| místo přechodného bydliště
|-
| PrechStatAdr
| char(2)
| stát u přechodného bydliště
|-
| PscPrech
| char(5)
| PSČ přechodného bydliště
|-
| PostaPrech
| char(48)
| Pošta přechodného bydliště
|-
| PrechPostcode
| char(11)
| Postcode u přechodného bydliště (zahraniční adresa)
|-
| KmenStr
| char(10)
| kmenové středisko pracovníka
|-
| ZmenPracSch
| char(2)
| změněná pracovní schopnost
{|  style="border: 0" class="innerTable"
| ???
| -
|
|}
|-
| DruhDuchodu
| char(3)
| druh duchodu pracovnika (ciselnik JUZO) 1. číslice = orgán vyplácející důchod ;2. - 3. místo = druh důchodu
{|  style="border: 0" class="innerTable"
| 1xx
| -
|
|-
| 2xx
| -
| Úřad sociálního zabezpečení
|-
| 3xx
| -
| vojenská správa
|-
| 4xx
| -
| ministerstvo vnitra
|-
| 5xx
| -
| obecní úřady
|-
| x11
| -
| ministerstvo spravedlnosti
|-
| x12
| -
| částečný invalidní
|-
| x13
| -
| invalidní
|-
| x14
| -
| starobní
|-
| x15
| -
| vdovský
|-
| x16
| -
| sirotci
|-
| x17
| -
| sociální
|-
| x18
| -
| za výsluhu let
|-
| x19
| -
| osobní
|-
| x20
| -
| jiný důchod
|-
| x21
| -
| důchod manželky
|-
| x22
| -
| souběh důch.vdov. a část.inval.
|-
| x23
| -
| souběh důch.vdov. a invalidního
|-
| x24
| -
| souběh důch.vdov. a starobního
|-
| x25
| -
| souběh důch.vdov. a za výsluhu
|-
| x29
| -
| souběh důch.vdov. a sirotčího
|-
| x31
| -
| soubeh duch.vdov. a jineho
|-
|
| -
| zvýšení důch. pro bezmocnost
|}
|-
| DuchodOd
| date
| datum nástupu do důchodu v aktual. roce
|-
| DatumNastupu
| date
| datum nástupu do organizace
|-
| DatumVystupu
| date
| datum výstupu z organizace
|-
| DanSleva
| char(1)
| uplatňuje slevu na dani
|-
| SlevaOd || date ||Ne || datum od uplatnění daňové slevy
|-
| SlevaDo || date ||Ne || datum do uplatnění daňové slevy
|-
| DetiProDuch
| smallint
| Počet dětí započitatelných do důchodu
|-
| ZdravPoj
| smallint
| nynější zdravotní pojišťovna
|-
| ZdravPojOd
| date
| datum nástupu k zdravotní pojišťovně
|-
| MinZdravPoj
| smallint
| minulá zdravotní pojišťovna
|-
| TitulZa
| char(15)
| Tituly za jménem
|-
| ZpsOd
| date
| ZPS od
|-
| ZpsDo
| date
| ZPS do
|-
| DanNerez
| char(1)
| Příznak daňového nerezidenta
|-
| OpPlat
| date
| Konec platnosti OP
|-
| PasPlat
| date
| Konec platnosti pasu
|-
| DatDuchPredp
| date
| Datum předpokládaného důchodu
|-
| OkresNar
| char(20)
| Okres místa narození
|-
| StatNar
| char(2)
| Kód státu u místa narození
|-
| IdPodniku
| integer
| Id podniku
|-
| VydavatelPasu
| char(40)
| Vydavatel cestovního pasu
|-
| Datum1Nast
| date
| Datum 1. nástupu
|-
| EvidCislo
| char(32)
| Evidenční číslo
|-
| VyplMisto
| smallint
| výplatní místo pracovníka
|-
|}
=== Přepočet důchodového věku zaměstnance ===
K přepočtu dochází při volání metody '''InsertData''' nebo '''UpdateData''' pro skupinu údajů '''KmenoveUdaje''' a to v případě, že jsou předány změnové údaje '''RodneCislo''' nebo '''DetiProDuch'''.


|}
Podmínkou pro správnou funkcionalitu je, aby v konfiguračním souboru KS aplikačního serveru '''ASServer.exe.config''' byl v sekci <appSettings> nastaven parametr'''''"KSmzdyAppPath''''' (v hodnotě parametru se uvede cesta k desktopové aplikaci KS mzdy).
Příklad:
<add key="KSmzdyAppPath" value="C:\Program Files\KS Program\MaP"/>


=Zápis pomocí WebAPI=
=Zápis pomocí WebAPI=
{|border="1" cellpadding="3" cellspacing="0"
{|class="wikitable sortable" border="1" cellpadding="3" cellspacing="0"
|- style="background-color: #eeeeee"
|- style="background-color: #eeeeee"
|'''Údaj'''
|'''Údaj'''
Řádek 15: Řádek 460:
|'''Povinné pole'''
|'''Povinné pole'''
|'''Význam'''
|'''Význam'''
 
|-
| OsCislo
| decimal(10,0)
| Ne
| osobní číslo pracovníka (čís. píchačky)
|-
| Prijmeni
| char(40)
| Ne
| přijmení pracovníka
|-
| Jmeno
| char(40)
| Ne
| jméno pracovníka
|-
| Titul
| char(25)
| Ne
| akademický titul pracovníka
|-
| RodneJmeno
| char(40)
| Ne
| rodné jméno pracovníka
|-
| RodneCislo
| char(10)
| Ne
| rodné číslo pracovníka
|-
| MistoNarozeni
| char(48)
| Ne
| místo narození pracovníka
|-
| RodinStav
| char(1)
| Ne
| rodinný stav pracovníka
{|  style="border: 0" class="innerTable"
| 5
| -
| druh(družka)
|-
| 4
| -
| ovdovělý (á)
|-
| 3
| -
| rozvedený (á)
|-
| 2
| -
| ženatý (vdaná)
|-
| 1
| -
| svobodný (á)
|}
|-
| Narodnost
| char(2)
| Ne
| národnost pracovníka
{|  style="border: 0" class="innerTable"
| 0
| -
| nezjištěná
|-
| 1
| -
| česká
|-
| 2
| -
| slovenská
|-
| 3
| -
| ukrajinská
|-
| 4
| -
| ruská
|-
| 5
| -
| polská
|-
| 6
| -
| maďarská
|-
| 7
| -
| německá
|-
| 8
| -
| bulharská
|-
| 9
| -
| ostatní
|}
|-
| StPrisl
| char(3)
| Ne
| státní příslušnost pracovníka
{|  style="border: 0" class="innerTable"
| 435
| -
| Rakousko
|-
| 427
| -
| Německo
|-
| 311
| -
| Jugoslávie
|-
| 203
| -
| Česko nově
|-
| 192
| -
| Slovensko
|-
| 191
| -
| Česko
|-
| 161
| -
| Rumunsko
|-
| 151
| -
| Polsko
|-
| 131
| -
| Maďarsko
|-
| 121
| -
| Bulharsko
|-
| 101
| -
| SNS
|}
|-
| CisloOp
| char(12)
| Ne
| číslo občanského průkazu
|-
| CisloPasu
| char(12)
| Ne
| číslo pasu
|-
| BranPov
| char(2)
| Ne
| indikace branné povinnosti pracovníka
{|  style="border: 0" class="innerTable"
| 0
| -
| nevoják
|-
| 1
| -
| branec
|-
| 2
| -
| voják
|}
|-
| TrUlice
| char(30)
| Ne
| ulice trvalého bydliště pracovníka
|-
| TrCislo
| char(14)
| Ne
| číslo domu trvalého bydliště pracovníka
|-
| MistoTrv
| char(48)
| Ne
| místo trvalého bydliště
|-
| StatAdr
| char(2)
| Ne
| Kód státu u trvalého bydliště
|-
| PscTrv
| char(5)
| Ne
| PSČ trvalého bydliště
|-
| PostaTrv
| char(48)
| Ne
| pošta tvrvalého bydliště
|-
| TrvPostcode
| char(11)
| Ne
| Postcode u trvalého bydliště (zahraniční adresa)
|-
| PrUlice
| char(30)
| Ne
| ulice přechodného bydliště pracovníka
|-
| PrCislo
| char(14)
| Ne
| číslo domu přechodného bydliště pracovníka
|-
| MistoPrech
| char(48)
| Ne
| místo přechodného bydliště
|-
| PrechStatAdr
| char(2)
| Ne
| stát u přechodného bydliště
|-
| PscPrech
| char(5)
| Ne
| PSČ přechodného bydliště
|-
| PostaPrech
| char(48)
| Ne
| Pošta přechodného bydliště
|-
| PrechPostcode
| char(11)
| Ne
| Postcode u přechodného bydliště (zahraniční adresa)
|-
| KmenStr
| char(10)
| Ne
| kmenové středisko pracovníka
|-
| ZmenPracSch
| char(2)
| Ne
| změněná pracovní schopnost
{|  style="border: 0" class="innerTable"
| ???
| -
|
|}
|-
| DruhDuchodu
| char(3)
| Ne
| druh duchodu pracovnika (ciselnik JUZO) 1. číslice = orgán vyplácející důchod ;2. - 3. místo = druh důchodu
{|  style="border: 0" class="innerTable"
| 1xx
| -
|
|-
| 2xx
| -
| Úřad sociálního zabezpečení
|-
| 3xx
| -
| vojenská správa
|-
| 4xx
| -
| ministerstvo vnitra
|-
| 5xx
| -
| obecní úřady
|-
| x11
| -
| ministerstvo spravedlnosti
|-
| x12
| -
| částečný invalidní
|-
| x13
| -
| invalidní
|-
| x14
| -
| starobní
|-
| x15
| -
| vdovský
|-
| x16
| -
| sirotci
|-
| x17
| -
| sociální
|-
| x18
| -
| za výsluhu let
|-
| x19
| -
| osobní
|-
| x20
| -
| jiný důchod
|-
| x21
| -
| důchod manželky
|-
| x22
| -
| souběh důch.vdov. a část.inval.
|-
| x23
| -
| souběh důch.vdov. a invalidního
|-
| x24
| -
| souběh důch.vdov. a starobního
|-
| x25
| -
| souběh důch.vdov. a za výsluhu
|-
| x29
| -
| souběh důch.vdov. a sirotčího
|-
| x31
| -
| soubeh duch.vdov. a jineho
|-
|
| -
| zvýšení důch. pro bezmocnost
|}
|-
| DuchodOd
| date
| Ne
| datum nástupu do důchodu v aktual. roce
|-
| DatumNastupu
| date
| Ne
| datum nástupu do organizace
|-
| DatumVystupu
| date
| Ne
| datum výstupu z organizace
|-
| DanSleva
| char(1)
| Ne
| uplatňuje slevu na dani
|-
| SlevaOd || date || Ne || datum od uplatnění daňové slevy
|-
| SlevaDo || date || Ne || datum do uplatnění daňové slevy
|-
| DetiProDuch
| smallint
| Ne
| Počet dětí započitatelných do důchodu
|-
| ZdravPoj
| smallint
| Ne
| nynější zdravotní pojišťovna
|-
| TitulZa
| char(15)
| Ne
| Tituly za jménem
|-
| ZpsOd
| date
| Ne
| ZPS od
|-
| ZpsDo
| date
| Ne
| ZPS do
|-
| DanNerez
| char(1)
| Ne
| Příznak daňového nerezidenta
|-
| OpPlat
| date
| Ne
| Konec platnosti OP
|-
| PasPlat
| date
| Ne
| Konec platnosti pasu
|-
| DatDuchPredp
| date
| Ne
| Datum předpokládaného důchodu
|-
| OkresNar
| char(20)
| Ne
| Okres místa narození
|-
| StatNar
| char(2)
| Ne
| Kód státu u místa narození
|-
| IdPodniku
| integer
| Ano
| Id podniku
|-
| VydavatelPasu
| char(40)
| Ne
| Vydavatel cestovního pasu
|-
| Datum1Nast
| date
| Ne
| Datum 1. nástupu
|-
| EvidCislo
| char(32)
| Ne
| Evidenční číslo
|-
| VyplMisto
| smallint
| Ne
| výplatní místo pracovníka
|}
|}


=Popis=
=Popis=
==Options==
===EvidStavZam===
Ve skupině údajů "'''KmenoveUdaje'''", pro metodu "'''GetData'''", je možno nastavit parametr Option "'''EvidStavZam'''" (Evidenční stav zaměstnanců). Dle hodnoty tohoto parametru bude ve výsledné struktuře pouze požadovaná skupina zaměstnanců.
Přípustné hodnoty Option "'''EvidStavZam'''":
* 0: zaměstnanci po výstupu.
* 1: aktivní zaměstnanci
* 3: zaměstnanci v mimoevidenčním stavu
====Příklad 1====
<pre>
Zadání vlastnosti JsonOptions: { "EvidStavZam": "1" }. Metodou "GetData" bude vrácena skupina zaměstnanců, kteří jsou v evidenčním stavu.
</pre>
====Příklad 2====
<pre>
Zadání vlastnosti JsonOptions: { "EvidStavZam": "0,3" }. V tomto případě bude vrácena skupina zaměstnanců, kteří vystoupili a jsou v mimoevidenčním stavu.
</pre>
===VlozenoOd===
* '''Použití pro metodu:''' "GetData".
* '''Datový typ:''' DateTime ve formátu "yyyy-MM-dd hhmmss" (Příklad: '2021-03-22 175235').
* '''Funkcionalita:''' Při jeho vyplnění budou vráceny pouze záznamy dané skupiny údajů, které byly vloženy do databáze KS mzdy "od" zadaného data v tomto Option.
===VlozenoDo===
* '''Použití pro metodu:''' "GetData".
* '''Datový typ:''' DateTime ve formátu "yyyy-MM-dd hhmmss" (Příklad: '2021-03-22 175235').
* '''Funkcionalita:''' Při jeho vyplnění budou vráceny pouze záznamy dané skupiny údajů, které byly vloženy do databáze KS mzdy "do" zadaného data v tomto Option.
===ZmenenoOd===
* '''Použití pro metodu:''' "GetData".
* '''Datový typ:''' DateTime ve formátu "yyyy-MM-dd hhmmss" (Příklad: '2021-03-22 175235').
* '''Funkcionalita:''' Při jeho vyplnění budou vráceny pouze záznamy dané skupiny údajů, které byly změněnyvdatabáziKS mzdy "od" zadaného data v tomto Option. Bude kontrolována pouze změna položek zadaných v parametru
===ZmenenoDo===
* '''Použití pro metodu:''' "GetData".
* '''Datový typ:''' DateTime ve formátu "yyyy-MM-dd hhmmss" (Příklad: '2021-03-22 175235').
* '''Funkcionalita:''' Při jeho vyplnění budou vráceny pouze záznamy dané skupiny údajů, které byly změněnyvdatabáziKS mzdy "do" zadaného data v tomto Option.
Pokud bude zadáno více Option v parametru JsonOptions, bude vrácena množina údajů odpovídající průniku záznamů jednotlivých Option.
====Příklad 3====
<pre>
Metoda = "GetData"
SkupinaUdaju = "KmenoveUdaje"
Items = "OsCislo, Jmeno, Prijmeni, Titul"
JsonOptions = {"VlozenoOd": "2021-03-22 175000", "VlozenoDo": "2021-03-26 200000"}
Metodou "GetData" budou vráceny záznamy zaměstnanců, kteří byli v databázi KS mzdy evidováni od 22.3.2021 17:50:00 do 26.3.2021 20:00:00.
</pre>
====Příklad 4 ====
<pre>
Metoda = "GetData"
SkupinaUdaju = "KmenoveUdaje"
Items = "OsCislo, Jmeno, Prijmeni, Titul"
JsonOptions = {"ZmenenoOd": "2021-03-22 175000"}
Metodou "GetData" budou vráceny záznamy zaměstnanců, u kterých byla provedena změna v některém z údajů v parametru "Items" (OsCislo, Jmeno, Prijmeni, Titul) od 22.3.2021 17:50:00.
</pre>
=== Konečné datum daňových slev ===
Automatické doplňování datumu výstupu jako konečné datum daňových slev v příslušných agendách (základní, student, rodinní příslušníci, invalidita), pokud je nastaven rozšiřující parametr v aplikaci KS mzdy [[VYSTUP_ODPOCTY (sk.1)]] na hodnotu "a". K tomuto doplnění dojde, pokud se prostřednictvím KS webAPI zavolá metoda ''UpdateData'' pro skupinu údajů ''KmenoveUdaje'', přičemž bude vyplněn údaj ''DatumVystupu''.
Podmínkou pro správnou funkcionalitu je, aby v nastavení aplikačního serveru byl v konfiguračním souboru ASServer.exe.config nastaven parametr ''KSmzdyAppPath'' (v hodnotě parametru se uvede cesta k desktopové aplikaci KS mzdy) v sekci <appSettings>.
Příklad: <add key="KSmzdyAppPath" value="C:\Program Files\KS Program\MaP" />a
== Odkazy ==
* [[KS webAPI]]

Aktuální verze z 24. 7. 2023, 14:50

Čtení pomocí WebAPI

Údaj Datový typ Význam
OsCislo decimal(10,0) osobní číslo pracovníka (čís. píchačky)
Prijmeni char(40) přijmení pracovníka
Jmeno char(40) jméno pracovníka
Titul char(25) akademický titul pracovníka
RodneJmeno char(40) rodné jméno pracovníka
RodneCislo char(10) rodné číslo pracovníka
MistoNarozeni char(48) místo narození pracovníka
RodinStav char(1) rodinný stav pracovníka
5 - druh(družka)
4 - ovdovělý (á)
3 - rozvedený (á)
2 - ženatý (vdaná)
1 - svobodný (á)
Narodnost char(2) národnost pracovníka
0 - nezjištěná
1 - česká
2 - slovenská
3 - ukrajinská
4 - ruská
5 - polská
6 - maďarská
7 - německá
8 - bulharská
9 - ostatní
StPrisl char(3) státní příslušnost pracovníka
435 - Rakousko
427 - Německo
311 - Jugoslávie
203 - Česko nově
192 - Slovensko
191 - Česko
161 - Rumunsko
151 - Polsko
131 - Maďarsko
121 - Bulharsko
101 - SNS
CisloOp char(12) číslo občanského průkazu
CisloPasu char(12) číslo pasu
BranPov char(2) indikace branné povinnosti pracovníka
0 - nevoják
1 - branec
2 - voják
UliceTrv char(45) ulice a číslo domu trvalého bydliště pracovníka
TrUlice char(30) ulice trvalého bydliště pracovníka
TrCislo char(14) číslo domu trvalého bydliště pracovníka
MistoTrv char(48) místo trvalého bydliště
StatAdr char(2) Kód státu u trvalého bydliště
PscTrv char(5) PSČ trvalého bydliště
PostaTrv char(48) pošta tvrvalého bydliště
TrvPostcode char(11) Postcode u trvalého bydliště (zahraniční adresa)
UlicePrech char(45) ulice přechodného bydliště pracovníka
PrUlice char(30) ulice přechodného bydliště pracovníka
PrCislo char(14) číslo domu přechodného bydliště pracovníka
MistoPrech char(48) místo přechodného bydliště
PrechStatAdr char(2) stát u přechodného bydliště
PscPrech char(5) PSČ přechodného bydliště
PostaPrech char(48) Pošta přechodného bydliště
PrechPostcode char(11) Postcode u přechodného bydliště (zahraniční adresa)
KmenStr char(10) kmenové středisko pracovníka
ZmenPracSch char(2) změněná pracovní schopnost
??? -
DruhDuchodu char(3) druh duchodu pracovnika (ciselnik JUZO) 1. číslice = orgán vyplácející důchod ;2. - 3. místo = druh důchodu
1xx -
2xx - Úřad sociálního zabezpečení
3xx - vojenská správa
4xx - ministerstvo vnitra
5xx - obecní úřady
x11 - ministerstvo spravedlnosti
x12 - částečný invalidní
x13 - invalidní
x14 - starobní
x15 - vdovský
x16 - sirotci
x17 - sociální
x18 - za výsluhu let
x19 - osobní
x20 - jiný důchod
x21 - důchod manželky
x22 - souběh důch.vdov. a část.inval.
x23 - souběh důch.vdov. a invalidního
x24 - souběh důch.vdov. a starobního
x25 - souběh důch.vdov. a za výsluhu
x29 - souběh důch.vdov. a sirotčího
x31 - soubeh duch.vdov. a jineho
- zvýšení důch. pro bezmocnost
DuchodOd date datum nástupu do důchodu v aktual. roce
DatumNastupu date datum nástupu do organizace
DatumVystupu date datum výstupu z organizace
DanSleva char(1) uplatňuje slevu na dani
SlevaOd date Ne datum od uplatnění daňové slevy
SlevaDo date Ne datum do uplatnění daňové slevy
DetiProDuch smallint Počet dětí započitatelných do důchodu
ZdravPoj smallint nynější zdravotní pojišťovna
ZdravPojOd date datum nástupu k zdravotní pojišťovně
MinZdravPoj smallint minulá zdravotní pojišťovna
TitulZa char(15) Tituly za jménem
ZpsOd date ZPS od
ZpsDo date ZPS do
DanNerez char(1) Příznak daňového nerezidenta
OpPlat date Konec platnosti OP
PasPlat date Konec platnosti pasu
DatDuchPredp date Datum předpokládaného důchodu
OkresNar char(20) Okres místa narození
StatNar char(2) Kód státu u místa narození
IdPodniku integer Id podniku
VydavatelPasu char(40) Vydavatel cestovního pasu
Datum1Nast date Datum 1. nástupu
EvidCislo char(32) Evidenční číslo
VyplMisto smallint výplatní místo pracovníka

Přepočet důchodového věku zaměstnance

K přepočtu dochází při volání metody InsertData nebo UpdateData pro skupinu údajů KmenoveUdaje a to v případě, že jsou předány změnové údaje RodneCislo nebo DetiProDuch.

Podmínkou pro správnou funkcionalitu je, aby v konfiguračním souboru KS aplikačního serveru ASServer.exe.config byl v sekci <appSettings> nastaven parametr"KSmzdyAppPath (v hodnotě parametru se uvede cesta k desktopové aplikaci KS mzdy). Příklad: 

<add key="KSmzdyAppPath" value="C:\Program Files\KS Program\MaP"/>

Zápis pomocí WebAPI

Údaj Datový typ Povinné pole Význam
OsCislo decimal(10,0) Ne osobní číslo pracovníka (čís. píchačky)
Prijmeni char(40) Ne přijmení pracovníka
Jmeno char(40) Ne jméno pracovníka
Titul char(25) Ne akademický titul pracovníka
RodneJmeno char(40) Ne rodné jméno pracovníka
RodneCislo char(10) Ne rodné číslo pracovníka
MistoNarozeni char(48) Ne místo narození pracovníka
RodinStav char(1) Ne rodinný stav pracovníka
5 - druh(družka)
4 - ovdovělý (á)
3 - rozvedený (á)
2 - ženatý (vdaná)
1 - svobodný (á)
Narodnost char(2) Ne národnost pracovníka
0 - nezjištěná
1 - česká
2 - slovenská
3 - ukrajinská
4 - ruská
5 - polská
6 - maďarská
7 - německá
8 - bulharská
9 - ostatní
StPrisl char(3) Ne státní příslušnost pracovníka
435 - Rakousko
427 - Německo
311 - Jugoslávie
203 - Česko nově
192 - Slovensko
191 - Česko
161 - Rumunsko
151 - Polsko
131 - Maďarsko
121 - Bulharsko
101 - SNS
CisloOp char(12) Ne číslo občanského průkazu
CisloPasu char(12) Ne číslo pasu
BranPov char(2) Ne indikace branné povinnosti pracovníka
0 - nevoják
1 - branec
2 - voják
TrUlice char(30) Ne ulice trvalého bydliště pracovníka
TrCislo char(14) Ne číslo domu trvalého bydliště pracovníka
MistoTrv char(48) Ne místo trvalého bydliště
StatAdr char(2) Ne Kód státu u trvalého bydliště
PscTrv char(5) Ne PSČ trvalého bydliště
PostaTrv char(48) Ne pošta tvrvalého bydliště
TrvPostcode char(11) Ne Postcode u trvalého bydliště (zahraniční adresa)
PrUlice char(30) Ne ulice přechodného bydliště pracovníka
PrCislo char(14) Ne číslo domu přechodného bydliště pracovníka
MistoPrech char(48) Ne místo přechodného bydliště
PrechStatAdr char(2) Ne stát u přechodného bydliště
PscPrech char(5) Ne PSČ přechodného bydliště
PostaPrech char(48) Ne Pošta přechodného bydliště
PrechPostcode char(11) Ne Postcode u přechodného bydliště (zahraniční adresa)
KmenStr char(10) Ne kmenové středisko pracovníka
ZmenPracSch char(2) Ne změněná pracovní schopnost
??? -
DruhDuchodu char(3) Ne druh duchodu pracovnika (ciselnik JUZO) 1. číslice = orgán vyplácející důchod ;2. - 3. místo = druh důchodu
1xx -
2xx - Úřad sociálního zabezpečení
3xx - vojenská správa
4xx - ministerstvo vnitra
5xx - obecní úřady
x11 - ministerstvo spravedlnosti
x12 - částečný invalidní
x13 - invalidní
x14 - starobní
x15 - vdovský
x16 - sirotci
x17 - sociální
x18 - za výsluhu let
x19 - osobní
x20 - jiný důchod
x21 - důchod manželky
x22 - souběh důch.vdov. a část.inval.
x23 - souběh důch.vdov. a invalidního
x24 - souběh důch.vdov. a starobního
x25 - souběh důch.vdov. a za výsluhu
x29 - souběh důch.vdov. a sirotčího
x31 - soubeh duch.vdov. a jineho
- zvýšení důch. pro bezmocnost
DuchodOd date Ne datum nástupu do důchodu v aktual. roce
DatumNastupu date Ne datum nástupu do organizace
DatumVystupu date Ne datum výstupu z organizace
DanSleva char(1) Ne uplatňuje slevu na dani
SlevaOd date Ne datum od uplatnění daňové slevy
SlevaDo date Ne datum do uplatnění daňové slevy
DetiProDuch smallint Ne Počet dětí započitatelných do důchodu
ZdravPoj smallint Ne nynější zdravotní pojišťovna
TitulZa char(15) Ne Tituly za jménem
ZpsOd date Ne ZPS od
ZpsDo date Ne ZPS do
DanNerez char(1) Ne Příznak daňového nerezidenta
OpPlat date Ne Konec platnosti OP
PasPlat date Ne Konec platnosti pasu
DatDuchPredp date Ne Datum předpokládaného důchodu
OkresNar char(20) Ne Okres místa narození
StatNar char(2) Ne Kód státu u místa narození
IdPodniku integer Ano Id podniku
VydavatelPasu char(40) Ne Vydavatel cestovního pasu
Datum1Nast date Ne Datum 1. nástupu
EvidCislo char(32) Ne Evidenční číslo
VyplMisto smallint Ne výplatní místo pracovníka

Popis

Options

EvidStavZam

Ve skupině údajů "KmenoveUdaje", pro metodu "GetData", je možno nastavit parametr Option "EvidStavZam" (Evidenční stav zaměstnanců). Dle hodnoty tohoto parametru bude ve výsledné struktuře pouze požadovaná skupina zaměstnanců.

Přípustné hodnoty Option "EvidStavZam":

  • 0: zaměstnanci po výstupu.
  • 1: aktivní zaměstnanci
  • 3: zaměstnanci v mimoevidenčním stavu

Příklad 1

Zadání vlastnosti JsonOptions: { "EvidStavZam": "1" }. Metodou "GetData" bude vrácena skupina zaměstnanců, kteří jsou v evidenčním stavu.

Příklad 2

Zadání vlastnosti JsonOptions: { "EvidStavZam": "0,3" }. V tomto případě bude vrácena skupina zaměstnanců, kteří vystoupili a jsou v mimoevidenčním stavu.

VlozenoOd

  • Použití pro metodu: "GetData".
  • Datový typ: DateTime ve formátu "yyyy-MM-dd hhmmss" (Příklad: '2021-03-22 175235').
  • Funkcionalita: Při jeho vyplnění budou vráceny pouze záznamy dané skupiny údajů, které byly vloženy do databáze KS mzdy "od" zadaného data v tomto Option.

VlozenoDo

  • Použití pro metodu: "GetData".
  • Datový typ: DateTime ve formátu "yyyy-MM-dd hhmmss" (Příklad: '2021-03-22 175235').
  • Funkcionalita: Při jeho vyplnění budou vráceny pouze záznamy dané skupiny údajů, které byly vloženy do databáze KS mzdy "do" zadaného data v tomto Option.

ZmenenoOd

  • Použití pro metodu: "GetData".
  • Datový typ: DateTime ve formátu "yyyy-MM-dd hhmmss" (Příklad: '2021-03-22 175235').
  • Funkcionalita: Při jeho vyplnění budou vráceny pouze záznamy dané skupiny údajů, které byly změněnyvdatabáziKS mzdy "od" zadaného data v tomto Option. Bude kontrolována pouze změna položek zadaných v parametru

ZmenenoDo

  • Použití pro metodu: "GetData".
  • Datový typ: DateTime ve formátu "yyyy-MM-dd hhmmss" (Příklad: '2021-03-22 175235').
  • Funkcionalita: Při jeho vyplnění budou vráceny pouze záznamy dané skupiny údajů, které byly změněnyvdatabáziKS mzdy "do" zadaného data v tomto Option.

Pokud bude zadáno více Option v parametru JsonOptions, bude vrácena množina údajů odpovídající průniku záznamů jednotlivých Option.

Příklad 3

Metoda = "GetData"
SkupinaUdaju = "KmenoveUdaje"
Items = "OsCislo, Jmeno, Prijmeni, Titul"
JsonOptions = {"VlozenoOd": "2021-03-22 175000", "VlozenoDo": "2021-03-26 200000"}

Metodou "GetData" budou vráceny záznamy zaměstnanců, kteří byli v databázi KS mzdy evidováni od 22.3.2021 17:50:00 do 26.3.2021 20:00:00.

Příklad 4

Metoda = "GetData"
SkupinaUdaju = "KmenoveUdaje"
Items = "OsCislo, Jmeno, Prijmeni, Titul"
JsonOptions = {"ZmenenoOd": "2021-03-22 175000"}

Metodou "GetData" budou vráceny záznamy zaměstnanců, u kterých byla provedena změna v některém z údajů v parametru "Items" (OsCislo, Jmeno, Prijmeni, Titul) od 22.3.2021 17:50:00.

Konečné datum daňových slev

Automatické doplňování datumu výstupu jako konečné datum daňových slev v příslušných agendách (základní, student, rodinní příslušníci, invalidita), pokud je nastaven rozšiřující parametr v aplikaci KS mzdy VYSTUP_ODPOCTY (sk.1) na hodnotu "a". K tomuto doplnění dojde, pokud se prostřednictvím KS webAPI zavolá metoda UpdateData pro skupinu údajů KmenoveUdaje, přičemž bude vyplněn údaj DatumVystupu.

Podmínkou pro správnou funkcionalitu je, aby v nastavení aplikačního serveru byl v konfiguračním souboru ASServer.exe.config nastaven parametr KSmzdyAppPath (v hodnotě parametru se uvede cesta k desktopové aplikaci KS mzdy) v sekci <appSettings>. 

Příklad: <add key="KSmzdyAppPath" value="C:\Program Files\KS Program\MaP" />a

Odkazy

Citováno z „http://prirucky.ksprogram.cz/index.php?title=WebAPI_Kmenové_údaje&oldid=45024“