Č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
