Prirucky - Příspěvky [cs]

Import dat při implementaci (jednorázová funkce č. 112) (záložka Převod REGZEC)

2026-09-25T11:11:43Z

Milan: /* Převod dat z REGZEC */

Menu / Systém / Jednorázové funkce

Převod slouží k aktualizaci údajů v databázi ''KS mzdy'' z XML souboru REGZEC.


[[Image: Jednorazova-funkce-112-zalozka-Prevod-REGZEC.png|600px|right]]

== Postup importu ==

# Otevřete okno '''Import dat při implementaci'''.
# Zvolte záložku '''Převod REGZEC'''.
# V části '''Datový přenos''' je dostupná pouze hodnota '''Data REGZEC'''.
# Pomocí tlačítka '''...''' vyberte XML soubor REGZEC.
# Stiskněte tlačítko '''Načíst'''.
# Po úspěšném načtení budou data zobrazena v tabulce.
# Stiskněte tlačítko '''Převést'''.

== Režim importu ==

Pro převod dat je podporován pouze režim:

* '''Aktualizovat stávající data + import'''

Při zpracování importu jsou do databáze ukládány všechny načtené záznamy. 
Aktualizovány jsou pouze ty údaje, které jsou v XML souboru vyplněny hodnotou. 
Prázdné nebo neuvedené elementy XML '''nepřepisují''' stávající hodnoty v databázi na hodnotu NULL.

== Převod dat z REGZEC ==

Následující tabulka uvádí mapování XML elementů REGZEC na položky importu.

{| class="wikitable sortable"
! Položka importu
! XML element REGZEC

! Umístění v aplikaci
|-
| pracovnici_oic_mpsv
| employee.client.ikmpsv

| Mzdové údaje → Osobní IČ (IK MPSV)
|-
| pracovnici_statdcis_nerezid
| employee.client.taxidrezid.stat

| Cizinci → Daňová identifikace ve státě rezidence → Stát daňové rezidence
|-
| pracovnici_dcis_nerezidenta
| employee.client.taxidrezid.num

| Cizinci → Daňová identifikace ve státě rezidence → Identifikátor
|-
| pracovnici_kod_stat_drezid_od
| employee.client.taxidrezid.statchang

| Cizinci → Daňová identifikace ve státě rezidence → Datum změny státu
|-
| pracovnici_typdcis_nerezid
| employee.client.taxidrezid.type

| Cizinci → Daňová identifikace ve státě rezidence → Typ daňové identifikace
|-
| pracovnici_statdokl_nerezid
| employee.client.proofid.stat

| Cizinci → Doklad totožnosti → Stát vydání
|-
| pracovnici_cdokl_nerezid
| employee.client.proofid.num

| Cizinci → Doklad totožnosti → Číslo dokladu
|-
| pracovnici_typdokl_nerezid
| employee.client.proofid.type

| Cizinci → Doklad totožnosti → Typ dokladu
|-
| ciz_doklad_vydal
| employee.client.proofid.foreigninst

| Cizinci → Doklad totožnosti → Doklad vydal
|-
| adr_statrez_misto
| employee.client.rdr.cit

| Cizinci → Adresa bydliště ve státě rezidence → Obec
|-
| adr_statrez_stat
| employee.client.rdr.cnt

| Cizinci → Adresa bydliště ve státě rezidence → Stát
|-
| adr_statrez_pcode
| employee.client.rdr.pnu

| Cizinci → Adresa bydliště ve státě rezidence → Postcode
|-
| adr_statrez_cislo
| employee.client.rdr.num

| Cizinci → Adresa bydliště ve státě rezidence → Číslo popisné
|-
| adr_statrez_ulice
| employee.client.rdr.str

| Cizinci → Adresa bydliště ve státě rezidence → Ulice
|-
| reg_cssz_obec
| employee.forin.cit

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Obec
|-
| reg_cssz_nazev
| employee.forin.nam

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Název nositele
|-
| reg_cssz_stat
| employee.forin.cnt

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Stát
|-
| reg_cssz_pcode
| employee.forin.pnu

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Postcode
|-
| reg_cssz_cislo
| employee.forin.num

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Číslo popisné
|-
| reg_cssz_ulice
| employee.forin.str

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Ulice
|-
| sektor_pojisteni
| employee.forin.sec

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Sektor/účel
|-
| reg_cssz_cpoj
| employee.forin.id

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Číslo pojištění
|-
| spec_ciz_nositele
| employee.forin.cur

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Specifikace
|-
| prac_povol_pr_pov_od
| employee.nocitizen.permfro

| Pracovní povolení → Pracovní oprávnění od
|-
| prac_povol_pr_pov_do
| employee.nocitizen.permto

| Pracovní povolení → Pracovní oprávnění do
|-
| prac_povol_opravneni_cislo
| employee.nocitizen.permid

| Pracovní povolení → Povolení číslo
|-
| prac_povol_opravneni_vydal
| employee.nocitizen.issue

| Pracovní povolení → Povolení vydala
|-
| prac_povol_druh_opravneni
| employee.nocitizen.permtype

| Pracovní povolení → Druh pracovního oprávnění
|-
| prac_povol_doc_ochrana
| employee.nocitizen.freeacc

| Pracovní povolení → Volný přístup na trh práce
|-
| stat_pravni_prisl
| employee.forinreg.state

| Cizinci → Příslušnost k cizím právním předpisům
|-
| pracovnici_e101
| employee.forinreg.juris

| Mzdové údaje → A1
|-
| pracovnici_predcas_star_duch
| employee.pens.early / employee.pens.reducedAge

| Osobní údaje → Starobní důchod
|-
| vzdelani_stupen
| employee.fact.highedu

| Vzdělání → Stupeň
|-
| prac_pom_datum_skut_nast
| employee.job.fro

| Pracovní poměr → Datum skutečného nástupu
|-
| prac_pom_maly_rozsah
| employee.job.sme

| Pracovní poměr → Zaměstnání malého rozsahu
|-
| prac_pom_druh_cinnosti
| employee.job.rel

| Pracovní poměr → Druh činnosti
|-
| prac_pom_ic_prav_vztahu
| employee.job.oid

| Pracovní poměr → ID pojistného vztahu
|}

== Poznámky ==

* Identifikace zaměstnance probíhá podle elementu '''employee.client.bno'''.
* Import podporuje pouze soubory ve formátu XML REGZEC.
* Prázdné nebo neuvedené elementy XML nepřepisují existující údaje v databázi.
* Před importem doporučujeme ověřit správnost a úplnost vstupního XML souboru.

== Odkazy ==
* [[Převod dat před startem rutinního provozu (jednorázová funkce č. 112)]]

Import dat při implementaci (jednorázová funkce č. 112) (záložka Převod REGZEC)

2026-09-25T08:33:11Z

Milan:

Menu / Systém / Jednorázové funkce

Převod slouží k aktualizaci údajů v databázi ''KS mzdy'' z XML souboru REGZEC.


[[Image: Jednorazova-funkce-112-zalozka-Prevod-REGZEC.png|600px|right]]

== Postup importu ==

# Otevřete okno '''Import dat při implementaci'''.
# Zvolte záložku '''Převod REGZEC'''.
# V části '''Datový přenos''' je dostupná pouze hodnota '''Data REGZEC'''.
# Pomocí tlačítka '''...''' vyberte XML soubor REGZEC.
# Stiskněte tlačítko '''Načíst'''.
# Po úspěšném načtení budou data zobrazena v tabulce.
# Stiskněte tlačítko '''Převést'''.

== Režim importu ==

Pro převod dat je podporován pouze režim:

* '''Aktualizovat stávající data + import'''

Při zpracování importu jsou do databáze ukládány všechny načtené záznamy. 
Aktualizovány jsou pouze ty údaje, které jsou v XML souboru vyplněny hodnotou. 
Prázdné nebo neuvedené elementy XML '''nepřepisují''' stávající hodnoty v databázi na hodnotu NULL.

== Převod dat z REGZEC ==

Následující tabulka uvádí mapování XML elementů REGZEC na položky importu.

{| class="wikitable sortable"
! Položka importu
! XML element REGZEC

! Umístění v aplikaci
|-
| pracovnici_oic_mpsv
| employee.client.ikmpsv

| Mzdové údaje → Osobní IČ (IK MPSV)
|-
| pracovnici_statdcis_nerezid
| employee.client.taxidrezid.stat

| Cizinci → Daňová identifikace ve státě rezidence → Stát daňové rezidence
|-
| pracovnici_dcis_nerezidenta
| employee.client.taxidrezid.num

| Cizinci → Daňová identifikace ve státě rezidence → Identifikátor
|-
| pracovnici_kod_stat_drezid_od
| employee.client.taxidrezid.statchang

| Cizinci → Daňová identifikace ve státě rezidence → Datum změny státu
|-
| pracovnici_typdcis_nerezid
| employee.client.taxidrezid.type

| Cizinci → Daňová identifikace ve státě rezidence → Typ daňové identifikace
|-
| pracovnici_statdokl_nerezid
| employee.client.proofid.stat

| Cizinci → Doklad totožnosti → Stát vydání
|-
| pracovnici_cdokl_nerezid
| employee.client.proofid.num

| Cizinci → Doklad totožnosti → Číslo dokladu
|-
| pracovnici_typdokl_nerezid
| employee.client.proofid.type

| Cizinci → Doklad totožnosti → Typ dokladu
|-
| ciz_doklad_vydal
| employee.client.proofid.foreigninst

| Cizinci → Doklad totožnosti → Doklad vydal
|-
| adr_statrez_misto
| employee.client.rdr.cit

| Cizinci → Adresa bydliště ve státě rezidence → Obec
|-
| adr_statrez_stat
| employee.client.rdr.cnt

| Cizinci → Adresa bydliště ve státě rezidence → Stát
|-
| adr_statrez_pcode
| employee.client.rdr.pnu

| Cizinci → Adresa bydliště ve státě rezidence → Postcode
|-
| adr_statrez_cislo
| employee.client.rdr.num

| Cizinci → Adresa bydliště ve státě rezidence → Číslo popisné
|-
| adr_statrez_ulice
| employee.client.rdr.str

| Cizinci → Adresa bydliště ve státě rezidence → Ulice
|-
| reg_cssz_obec
| employee.forin.cit

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Obec
|-
| reg_cssz_nazev
| employee.forin.nam

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Název nositele
|-
| reg_cssz_stat
| employee.forin.cnt

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Stát
|-
| reg_cssz_pcode
| employee.forin.pnu

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Postcode
|-
| reg_cssz_cislo
| employee.forin.num

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Číslo popisné
|-
| reg_cssz_ulice
| employee.forin.str

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Ulice
|-
| sektor_pojisteni
| employee.forin.sec

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Sektor/účel
|-
| reg_cssz_cpoj
| employee.forin.id

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Číslo pojištění
|-
| spec_ciz_nositele
| employee.forin.cur

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Specifikace
|-
| prac_povol_pr_pov_do
| employee.nocitizen.permto

| Pracovní povolení → Pracovní oprávnění do
|-
| prac_povol_pr_pov_od
| employee.nocitizen.permfro

| Pracovní povolení → Pracovní oprávnění od
|-
| prac_povol_opravneni_cislo
| employee.nocitizen.permid

| Pracovní povolení → Povolení číslo
|-
| prac_povol_opravneni_vydal
| employee.nocitizen.issue

| Pracovní povolení → Povolení vydala
|-
| prac_povol_druh_opravneni
| employee.nocitizen.permtype

| Pracovní povolení → Druh pracovního oprávnění
|-
| prac_povol_doc_ochrana
| employee.nocitizen.freeacc

| Pracovní povolení → Volný přístup na trh práce
|-
| stat_pravni_prisl
| employee.forinreg.state

| Cizinci → Příslušnost k cizím právním předpisům
|-
| pracovnici_e101
| employee.forinreg.juris

| Mzdové údaje → A1
|-
| pracovnici_predcas_star_duch
| employee.pens.early / employee.pens.reducedAge

| Osobní údaje → Starobní důchod
|-
| vzdelani_stupen
| employee.fact.highedu

| Vzdělání → Stupeň
|-
| prac_pom_datum_skut_nast
| employee.job.fro

| Pracovní poměr → Datum skutečného nástupu
|-
| prac_pom_maly_rozsah
| employee.job.sme

| Pracovní poměr → Zaměstnání malého rozsahu
|-
| prac_pom_druh_cinnosti
| employee.job.rel

| Pracovní poměr → Druh činnosti
|-
| prac_pom_ic_prav_vztahu
| employee.job.oid

| Pracovní poměr → ID pojistného vztahu
|}

== Poznámky ==

* Identifikace zaměstnance probíhá podle elementu '''employee.client.bno'''.
* Import podporuje pouze soubory ve formátu XML REGZEC.
* Prázdné nebo neuvedené elementy XML nepřepisují existující údaje v databázi.
* Před importem doporučujeme ověřit správnost a úplnost vstupního XML souboru.

== Odkazy ==
* [[Převod dat před startem rutinního provozu (jednorázová funkce č. 112)]]

Soubor:Jednorazova-funkce-112-zalozka-Prevod-REGZEC.png

2026-09-25T08:27:02Z

Milan:

Import dat při implementaci (jednorázová funkce č. 112) (záložka Převod REGZEC)

2026-09-25T08:26:38Z

Milan:

Menu / Systém / Jednorázové funkce

Převod slouží k aktualizaci údajů v databázi ''KS mzdy'' z XML souboru REGZEC.

[[Soubor:Jednorazova-funkce-112-zalozka-Prevod-REGZEC.png|800px|center|Záložka Převod REGZEC]]

== Postup importu ==

# Otevřete okno '''Import dat při implementaci'''.
# Zvolte záložku '''Převod REGZEC'''.
# V části '''Datový přenos''' je dostupná pouze hodnota '''Data REGZEC'''.
# Pomocí tlačítka '''...''' vyberte XML soubor REGZEC.
# Stiskněte tlačítko '''Načíst'''.
# Po úspěšném načtení budou data zobrazena v tabulce.
# Stiskněte tlačítko '''Převést'''.

== Režim importu ==

Pro převod dat je podporován pouze režim:

* '''Aktualizovat stávající data + import'''

Při zpracování importu jsou do databáze ukládány všechny načtené záznamy. 
Aktualizovány jsou pouze ty údaje, které jsou v XML souboru vyplněny hodnotou. 
Prázdné nebo neuvedené elementy XML '''nepřepisují''' stávající hodnoty v databázi na hodnotu NULL.

== Převod dat z REGZEC ==

Následující tabulka uvádí mapování XML elementů REGZEC na položky importu.

{| class="wikitable sortable"
! Položka importu
! XML element REGZEC

! Umístění v aplikaci
|-
| pracovnici_oic_mpsv
| employee.client.ikmpsv

| Mzdové údaje → Osobní IČ (IK MPSV)
|-
| pracovnici_statdcis_nerezid
| employee.client.taxidrezid.stat

| Cizinci → Daňová identifikace ve státě rezidence → Stát daňové rezidence
|-
| pracovnici_dcis_nerezidenta
| employee.client.taxidrezid.num

| Cizinci → Daňová identifikace ve státě rezidence → Identifikátor
|-
| pracovnici_kod_stat_drezid_od
| employee.client.taxidrezid.statchang

| Cizinci → Daňová identifikace ve státě rezidence → Datum změny státu
|-
| pracovnici_typdcis_nerezid
| employee.client.taxidrezid.type

| Cizinci → Daňová identifikace ve státě rezidence → Typ daňové identifikace
|-
| pracovnici_statdokl_nerezid
| employee.client.proofid.stat

| Cizinci → Doklad totožnosti → Stát vydání
|-
| pracovnici_cdokl_nerezid
| employee.client.proofid.num

| Cizinci → Doklad totožnosti → Číslo dokladu
|-
| pracovnici_typdokl_nerezid
| employee.client.proofid.type

| Cizinci → Doklad totožnosti → Typ dokladu
|-
| ciz_doklad_vydal
| employee.client.proofid.foreigninst

| Cizinci → Doklad totožnosti → Doklad vydal
|-
| adr_statrez_misto
| employee.client.rdr.cit

| Cizinci → Adresa bydliště ve státě rezidence → Obec
|-
| adr_statrez_stat
| employee.client.rdr.cnt

| Cizinci → Adresa bydliště ve státě rezidence → Stát
|-
| adr_statrez_pcode
| employee.client.rdr.pnu

| Cizinci → Adresa bydliště ve státě rezidence → Postcode
|-
| adr_statrez_cislo
| employee.client.rdr.num

| Cizinci → Adresa bydliště ve státě rezidence → Číslo popisné
|-
| adr_statrez_ulice
| employee.client.rdr.str

| Cizinci → Adresa bydliště ve státě rezidence → Ulice
|-
| reg_cssz_obec
| employee.forin.cit

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Obec
|-
| reg_cssz_nazev
| employee.forin.nam

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Název nositele
|-
| reg_cssz_stat
| employee.forin.cnt

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Stát
|-
| reg_cssz_pcode
| employee.forin.pnu

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Postcode
|-
| reg_cssz_cislo
| employee.forin.num

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Číslo popisné
|-
| reg_cssz_ulice
| employee.forin.str

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Ulice
|-
| sektor_pojisteni
| employee.forin.sec

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Sektor/účel
|-
| reg_cssz_cpoj
| employee.forin.id

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Číslo pojištění
|-
| spec_ciz_nositele
| employee.forin.cur

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Specifikace
|-
| prac_povol_pr_pov_do
| employee.nocitizen.permto

| Pracovní povolení → Pracovní oprávnění do
|-
| prac_povol_pr_pov_od
| employee.nocitizen.permfro

| Pracovní povolení → Pracovní oprávnění od
|-
| prac_povol_opravneni_cislo
| employee.nocitizen.permid

| Pracovní povolení → Povolení číslo
|-
| prac_povol_opravneni_vydal
| employee.nocitizen.issue

| Pracovní povolení → Povolení vydala
|-
| prac_povol_druh_opravneni
| employee.nocitizen.permtype

| Pracovní povolení → Druh pracovního oprávnění
|-
| prac_povol_doc_ochrana
| employee.nocitizen.freeacc

| Pracovní povolení → Volný přístup na trh práce
|-
| stat_pravni_prisl
| employee.forinreg.state

| Cizinci → Příslušnost k cizím právním předpisům
|-
| pracovnici_e101
| employee.forinreg.juris

| Mzdové údaje → A1
|-
| pracovnici_predcas_star_duch
| employee.pens.early / employee.pens.reducedAge

| Osobní údaje → Starobní důchod
|-
| vzdelani_stupen
| employee.fact.highedu

| Vzdělání → Stupeň
|-
| prac_pom_datum_skut_nast
| employee.job.fro

| Pracovní poměr → Datum skutečného nástupu
|-
| prac_pom_maly_rozsah
| employee.job.sme

| Pracovní poměr → Zaměstnání malého rozsahu
|-
| prac_pom_druh_cinnosti
| employee.job.rel

| Pracovní poměr → Druh činnosti
|-
| prac_pom_ic_prav_vztahu
| employee.job.oid

| Pracovní poměr → ID pojistného vztahu
|}

== Poznámky ==

* Identifikace zaměstnance probíhá podle elementu '''employee.client.bno'''.
* Import podporuje pouze soubory ve formátu XML REGZEC.
* Prázdné nebo neuvedené elementy XML nepřepisují existující údaje v databázi.
* Před importem doporučujeme ověřit správnost a úplnost vstupního XML souboru.

== Odkazy ==
* [[Převod dat před startem rutinního provozu (jednorázová funkce č. 112)]]

Import dat při implementaci (jednorázová funkce č. 112)

2026-09-25T08:23:22Z

Milan: /* Prvotní převod kmenových dat */

'''Import dat při implementaci (jednorázová funkce č. 112)''' - tato jednorázová funkce je určena '''VÝHRADNĚ''' k použití '''PŘED zahájením rutinního provozu''' v systému – pro promazání dat vypočtených mezd z testovacího provozu a nastavení dat "na startovní čáru".

Provádí se '''v prvním měsíci rutinního provozu''', ještě '''před samotným zpracováním''' mezd. Převod před přechodem do rutiny si realizuje obvykle uživatel sám, dle níže uvedeného postupu.

{{jednorázové funkce}}

== Před spuštěním ==
Před spuštěním je potřeba '''dohodnout s tvůrci programu''' následující:
* stanovit o jakou společnost ('''IČ''') se jedná
* stanovit, jaký má být '''datum prvního rutinního zpracování mezd''' (např. 1.1.2017).

== Při spuštění ==

* 1. hláška při spuštění - varování [[Image: 112-prevod-pred-rutinou-uvodni-hlaska.png|80px]]

* 2. hláška při spuštění - doporučena záloha databáze [[Image: 112-prevod-pred-rutinou-uvodni-hlaska2.png|80px]]

== Datum rutinního zpracování mezd ==
Zkontrolujte, zda je správně navedeno a zobrazeno datum prvního rutinního zpracování mezd. '''Pokud nesouhlasí, nepokračujte dále''' a kontaktujte autory programu.

== Promazání dat ==
Prvním krokem je promazání dat – nastavte první měsíc rutinního zpracování a stiskněte tlačítko '''Promazání dat'''. Je provedeno promazání dat o vypočtených mzdách za dobu duplicitního provozu, tj. za všechna období, která jsou před datem definovaným v poli
: '''Datum rutinního zpracování mezd'''
Dále jsou nastaveny některé položky na výchozí hodnotu (např. 0).
: [[Promazání dat (jednorázová funkce č. 112)]]

== Struktura souborů ==
[[Image: 112-prevod-pred-rutinou-rozhrani.png|590px|right]]
Dále načítejte data z předem připravených souborů – soubory musí mít dohodnutou strukturu i dohodnutý název (popis viz na jiném místě). Je možno načítat soubory s příponou
* '''.txt'''
* '''.xls''' (MS Excel nebo OpenOffice Calc)
* '''.ods''' (OpenOffice Calc)
* '''.csv''' (textový soubor s oddělovačem středník);

: [[Struktura souborů (jednorázová funkce č. 112)]]

== Načítání dat ==
Na počítači, na kterém se provádí načtení dat, musí být daný produkt nainstalovaný (např. MS Excel). Tlačítkem
* '''...'''
nalezněte soubor. Poté stiskněte tlačítko
* '''Načíst'''
Data ze souboru budou načtena na obrazovku, zároveň je provedena kontrola dat na formální správnost (kontrola, zda osobní číslo existuje v databázi, zda je dodržen správný datový typ položky, apod.). Pak stiskněte tlačítko
* '''Převést''' – data budou uložena do systému.

Poznámka: výjimkou jsou data '''''výsledky ročního zúčtování daně''''', která jsou načítána aplikací v jiném menu (jen při zahájení rutiny od začátku roku). Pozn.2 Po provedeném převodu je proveden zápis do archívu.

* V případě zjištění neexistujícího osobního čísla nebo čísla poměru bude tento řádek označen (ve sloupci 'status' hodnotou 'Ignorovat!', dále upozorněním ve výpisu chyb) a nebude se převádět.

* V případě, že načtený údaj bude desetinné číslo s nulovou desetinnou částí, ale je očekáváno celé číslo, nebude údaj označen za chybný a dojde k převodu

* SK - Slovenská aplikace obsahuje navíc datový přenos 'prevod_prum_nem' (převod průměru pro náhrady při pracovní neschopnosti).

* Při načítání ze souborů xls (Microsoft Excel), ods (OpenOffice / LibreOffice Calc) se načtou řádky, které mají vyplněnu alespoň jednu položku datové struktury (původně se načítaly pouze řádky, které měly vyplněn první sloupec "os. číslo"). Je předpokládáno, že data jsou v souboru naplněny od první buňky A1. Čtení ze souboru se ukončí, pokud se narazí na prázdný řádek.

* Postup při načítání souboru "abs_dny_kc_obd". Standardní je volba "smazat stávající data + import". Poté stisknout tlačítko "Načíst". Po načtení dat provést přepočet průměrů stiskem tlačítka "Přepočet".

* Převod '''vícekvartálových položek''' je umožněn jen tehdy, pokud je nastaven '''první měsíc''' v kvartálu.

První měsíc kvartálu se data přenášejí do položek: ''Dělená částka 2'', ''Dělená částka 3'', ''Dělená částka 4''. Pokud budou přenášena ve druhém nebo třetím měsíci kvartálu, je nutno je přenést následovně:
:: Dělená částka 1 = Dělená částka 1 + X
:: Dělená částka 2 = Dělená částka 2 + Y
:: Dělená částka 3 = Dělená částka 3 + Z

::: Částky z původního systému:
::: X - poměrná částka, která se má použít při výpočtu průměru za aktuální kvartál
::: Y - ... za následující kvartál
::: Z - ... za další následující kvartál

[[Vícekvartálové odměny (příklad)]]

== Více IČ ==
Při výběru jednoho podniku při přihlášení budou promázána pouze data tohoto podniku. Při výběru všech podniků budou promazána data všech podniků. 

Dovolená (import zůstatků)

Příklady hlášek při rozlišování režimu všech podniků/jednoho podniku 
''POZOR! Jste přihlášeni v režimu "všechny podniky". Budou promazána data všech zaměstnanců z tab. dovolené. Tento způsob může být použit pouze pro zahájení rutinního zpracování mezd u všech podniků. Pokud zahajujete rutinní zpracování pouze u jednoho konkrétního podniku, nepokračujte dále, přihlašte se do vybraného podniku a akci zopakujte.'' ''Přejete si pokračovat? (Ano/Ne)''

''Jste přihlášeni do vybraného podniku. Bude promazána tab. dovolená pro zaměstnance vybraného podniku. (O.K.)''


[[Více IČ]]

== Prvotní převod kmenových dat ==
* [[Převod dat před startem rutinního provozu (jednorázová funkce č. 112) (záložka Prvotní převod)]]
* [[Převod dat před startem rutinního provozu (jednorázová funkce č. 112) (záložka Převod dat)]]
* [[Import dat při implementaci (jednorázová funkce č. 112) (záložka Převod REGZEC)]]

== Odkazy ==
* [[Jednorázové funkce]]
* [[Implementace]]
* [[Vícekvartálové položky před startem rutinního provozu]]
* [[Převod dat před startem rutinního provozu (jednorázová funkce č. 112) (záložka Prvotní převod)]]
* [[Převod dat před startem rutinního provozu (jednorázová funkce č. 112) (záložka Převod dat)]]
* [[Import dat při implementaci (jednorázová funkce č. 112) (záložka Převod REGZEC)]]

Import dat při implementaci (jednorázová funkce č. 112)

2026-09-25T08:21:45Z

Milan:

'''Import dat při implementaci (jednorázová funkce č. 112)''' - tato jednorázová funkce je určena '''VÝHRADNĚ''' k použití '''PŘED zahájením rutinního provozu''' v systému – pro promazání dat vypočtených mezd z testovacího provozu a nastavení dat "na startovní čáru".

Provádí se '''v prvním měsíci rutinního provozu''', ještě '''před samotným zpracováním''' mezd. Převod před přechodem do rutiny si realizuje obvykle uživatel sám, dle níže uvedeného postupu.

{{jednorázové funkce}}

== Před spuštěním ==
Před spuštěním je potřeba '''dohodnout s tvůrci programu''' následující:
* stanovit o jakou společnost ('''IČ''') se jedná
* stanovit, jaký má být '''datum prvního rutinního zpracování mezd''' (např. 1.1.2017).

== Při spuštění ==

* 1. hláška při spuštění - varování [[Image: 112-prevod-pred-rutinou-uvodni-hlaska.png|80px]]

* 2. hláška při spuštění - doporučena záloha databáze [[Image: 112-prevod-pred-rutinou-uvodni-hlaska2.png|80px]]

== Datum rutinního zpracování mezd ==
Zkontrolujte, zda je správně navedeno a zobrazeno datum prvního rutinního zpracování mezd. '''Pokud nesouhlasí, nepokračujte dále''' a kontaktujte autory programu.

== Promazání dat ==
Prvním krokem je promazání dat – nastavte první měsíc rutinního zpracování a stiskněte tlačítko '''Promazání dat'''. Je provedeno promazání dat o vypočtených mzdách za dobu duplicitního provozu, tj. za všechna období, která jsou před datem definovaným v poli
: '''Datum rutinního zpracování mezd'''
Dále jsou nastaveny některé položky na výchozí hodnotu (např. 0).
: [[Promazání dat (jednorázová funkce č. 112)]]

== Struktura souborů ==
[[Image: 112-prevod-pred-rutinou-rozhrani.png|590px|right]]
Dále načítejte data z předem připravených souborů – soubory musí mít dohodnutou strukturu i dohodnutý název (popis viz na jiném místě). Je možno načítat soubory s příponou
* '''.txt'''
* '''.xls''' (MS Excel nebo OpenOffice Calc)
* '''.ods''' (OpenOffice Calc)
* '''.csv''' (textový soubor s oddělovačem středník);

: [[Struktura souborů (jednorázová funkce č. 112)]]

== Načítání dat ==
Na počítači, na kterém se provádí načtení dat, musí být daný produkt nainstalovaný (např. MS Excel). Tlačítkem
* '''...'''
nalezněte soubor. Poté stiskněte tlačítko
* '''Načíst'''
Data ze souboru budou načtena na obrazovku, zároveň je provedena kontrola dat na formální správnost (kontrola, zda osobní číslo existuje v databázi, zda je dodržen správný datový typ položky, apod.). Pak stiskněte tlačítko
* '''Převést''' – data budou uložena do systému.

Poznámka: výjimkou jsou data '''''výsledky ročního zúčtování daně''''', která jsou načítána aplikací v jiném menu (jen při zahájení rutiny od začátku roku). Pozn.2 Po provedeném převodu je proveden zápis do archívu.

* V případě zjištění neexistujícího osobního čísla nebo čísla poměru bude tento řádek označen (ve sloupci 'status' hodnotou 'Ignorovat!', dále upozorněním ve výpisu chyb) a nebude se převádět.

* V případě, že načtený údaj bude desetinné číslo s nulovou desetinnou částí, ale je očekáváno celé číslo, nebude údaj označen za chybný a dojde k převodu

* SK - Slovenská aplikace obsahuje navíc datový přenos 'prevod_prum_nem' (převod průměru pro náhrady při pracovní neschopnosti).

* Při načítání ze souborů xls (Microsoft Excel), ods (OpenOffice / LibreOffice Calc) se načtou řádky, které mají vyplněnu alespoň jednu položku datové struktury (původně se načítaly pouze řádky, které měly vyplněn první sloupec "os. číslo"). Je předpokládáno, že data jsou v souboru naplněny od první buňky A1. Čtení ze souboru se ukončí, pokud se narazí na prázdný řádek.

* Postup při načítání souboru "abs_dny_kc_obd". Standardní je volba "smazat stávající data + import". Poté stisknout tlačítko "Načíst". Po načtení dat provést přepočet průměrů stiskem tlačítka "Přepočet".

* Převod '''vícekvartálových položek''' je umožněn jen tehdy, pokud je nastaven '''první měsíc''' v kvartálu.

První měsíc kvartálu se data přenášejí do položek: ''Dělená částka 2'', ''Dělená částka 3'', ''Dělená částka 4''. Pokud budou přenášena ve druhém nebo třetím měsíci kvartálu, je nutno je přenést následovně:
:: Dělená částka 1 = Dělená částka 1 + X
:: Dělená částka 2 = Dělená částka 2 + Y
:: Dělená částka 3 = Dělená částka 3 + Z

::: Částky z původního systému:
::: X - poměrná částka, která se má použít při výpočtu průměru za aktuální kvartál
::: Y - ... za následující kvartál
::: Z - ... za další následující kvartál

[[Vícekvartálové odměny (příklad)]]

== Více IČ ==
Při výběru jednoho podniku při přihlášení budou promázána pouze data tohoto podniku. Při výběru všech podniků budou promazána data všech podniků. 

Dovolená (import zůstatků)

Příklady hlášek při rozlišování režimu všech podniků/jednoho podniku 
''POZOR! Jste přihlášeni v režimu "všechny podniky". Budou promazána data všech zaměstnanců z tab. dovolené. Tento způsob může být použit pouze pro zahájení rutinního zpracování mezd u všech podniků. Pokud zahajujete rutinní zpracování pouze u jednoho konkrétního podniku, nepokračujte dále, přihlašte se do vybraného podniku a akci zopakujte.'' ''Přejete si pokračovat? (Ano/Ne)''

''Jste přihlášeni do vybraného podniku. Bude promazána tab. dovolená pro zaměstnance vybraného podniku. (O.K.)''


[[Více IČ]]

== Prvotní převod kmenových dat ==
* [[Převod dat před startem rutinního provozu (jednorázová funkce č. 112) (záložka Prvotní převod)]]
* [[Převod dat před startem rutinního provozu (jednorázová funkce č. 112) (záložka Převod dat)]]

== Odkazy ==
* [[Jednorázové funkce]]
* [[Implementace]]
* [[Vícekvartálové položky před startem rutinního provozu]]
* [[Převod dat před startem rutinního provozu (jednorázová funkce č. 112) (záložka Prvotní převod)]]
* [[Převod dat před startem rutinního provozu (jednorázová funkce č. 112) (záložka Převod dat)]]
* [[Import dat při implementaci (jednorázová funkce č. 112) (záložka Převod REGZEC)]]

Import dat při implementaci (jednorázová funkce č. 112)

2026-09-25T08:20:37Z

Milan: /* Odkazy */

'''Import dat při implementaci (jednorázová funkce č. 112)''' - tato jednorázová funkce je určena '''VÝHRADNĚ''' k použití '''PŘED zahájením rutinního provozu''' v systému – pro promazání dat vypočtených mezd z testovacího provozu a nastavení dat "na startovní čáru".

Provádí se '''v prvním měsíci rutinního provozu''', ještě '''před samotným zpracováním''' mezd. Převod před přechodem do rutiny si realizuje obvykle uživatel sám, dle níže uvedeného postupu.

{{jednorázové funkce}}

== Před spuštěním ==
Před spuštěním je potřeba '''dohodnout s tvůrci programu''' následující:
* stanovit o jakou společnost ('''IČ''') se jedná
* stanovit, jaký má být '''datum prvního rutinního zpracování mezd''' (např. 1.1.2017).

== Při spuštění ==

* 1. hláška při spuštění - varování [[Image: 112-prevod-pred-rutinou-uvodni-hlaska.png|80px]]

* 2. hláška při spuštění - doporučena záloha databáze [[Image: 112-prevod-pred-rutinou-uvodni-hlaska2.png|80px]]

== Datum rutinního zpracování mezd ==
Zkontrolujte, zda je správně navedeno a zobrazeno datum prvního rutinního zpracování mezd. '''Pokud nesouhlasí, nepokračujte dále''' a kontaktujte autory programu.

== Promazání dat ==
Prvním krokem je promazání dat – nastavte první měsíc rutinního zpracování a stiskněte tlačítko '''Promazání dat'''. Je provedeno promazání dat o vypočtených mzdách za dobu duplicitního provozu, tj. za všechna období, která jsou před datem definovaným v poli
: '''Datum rutinního zpracování mezd'''
Dále jsou nastaveny některé položky na výchozí hodnotu (např. 0).
: [[Promazání dat (jednorázová funkce č. 112)]]

== Struktura souborů ==
[[Image: 112-prevod-pred-rutinou-rozhrani.png|590px|right]]
Dále načítejte data z předem připravených souborů – soubory musí mít dohodnutou strukturu i dohodnutý název (popis viz na jiném místě). Je možno načítat soubory s příponou
* '''.txt'''
* '''.xls''' (MS Excel nebo OpenOffice Calc)
* '''.ods''' (OpenOffice Calc)
* '''.csv''' (textový soubor s oddělovačem středník);

: [[Struktura souborů (jednorázová funkce č. 112)]]

== Načítání dat ==
Na počítači, na kterém se provádí načtení dat, musí být daný produkt nainstalovaný (např. MS Excel). Tlačítkem
* '''...'''
nalezněte soubor. Poté stiskněte tlačítko
* '''Načíst'''
Data ze souboru budou načtena na obrazovku, zároveň je provedena kontrola dat na formální správnost (kontrola, zda osobní číslo existuje v databázi, zda je dodržen správný datový typ položky, apod.). Pak stiskněte tlačítko
* '''Převést''' – data budou uložena do systému.

Poznámka: výjimkou jsou data '''''výsledky ročního zúčtování daně''''', která jsou načítána aplikací v jiném menu (jen při zahájení rutiny od začátku roku). Pozn.2 Po provedeném převodu je proveden zápis do archívu.

* V případě zjištění neexistujícího osobního čísla nebo čísla poměru bude tento řádek označen (ve sloupci 'status' hodnotou 'Ignorovat!', dále upozorněním ve výpisu chyb) a nebude se převádět.

* V případě, že načtený údaj bude desetinné číslo s nulovou desetinnou částí, ale je očekáváno celé číslo, nebude údaj označen za chybný a dojde k převodu

* SK - Slovenská aplikace obsahuje navíc datový přenos 'prevod_prum_nem' (převod průměru pro náhrady při pracovní neschopnosti).

* Při načítání ze souborů xls (Microsoft Excel), ods (OpenOffice / LibreOffice Calc) se načtou řádky, které mají vyplněnu alespoň jednu položku datové struktury (původně se načítaly pouze řádky, které měly vyplněn první sloupec "os. číslo"). Je předpokládáno, že data jsou v souboru naplněny od první buňky A1. Čtení ze souboru se ukončí, pokud se narazí na prázdný řádek.

* Postup při načítání souboru "abs_dny_kc_obd". Standardní je volba "smazat stávající data + import". Poté stisknout tlačítko "Načíst". Po načtení dat provést přepočet průměrů stiskem tlačítka "Přepočet".

* Převod '''vícekvartálových položek''' je umožněn jen tehdy, pokud je nastaven '''první měsíc''' v kvartálu.

První měsíc kvartálu se data přenášejí do položek: ''Dělená částka 2'', ''Dělená částka 3'', ''Dělená částka 4''. Pokud budou přenášena ve druhém nebo třetím měsíci kvartálu, je nutno je přenést následovně:
:: Dělená částka 1 = Dělená částka 1 + X
:: Dělená částka 2 = Dělená částka 2 + Y
:: Dělená částka 3 = Dělená částka 3 + Z

::: Částky z původního systému:
::: X - poměrná částka, která se má použít při výpočtu průměru za aktuální kvartál
::: Y - ... za následující kvartál
::: Z - ... za další následující kvartál

[[Vícekvartálové odměny (příklad)]]

== Více IČ ==
Při výběru jednoho podniku při přihlášení budou promázána pouze data tohoto podniku. Při výběru všech podniků budou promazána data všech podniků. 

Dovolená (import zůstatků)

Příklady hlášek při rozlišování režimu všech podniků/jednoho podniku 
''POZOR! Jste přihlášeni v režimu "všechny podniky". Budou promazána data všech zaměstnanců z tab. dovolené. Tento způsob může být použit pouze pro zahájení rutinního zpracování mezd u všech podniků. Pokud zahajujete rutinní zpracování pouze u jednoho konkrétního podniku, nepokračujte dále, přihlašte se do vybraného podniku a akci zopakujte.'' ''Přejete si pokračovat? (Ano/Ne)''

''Jste přihlášeni do vybraného podniku. Bude promazána tab. dovolená pro zaměstnance vybraného podniku. (O.K.)''


[[Více IČ]]

== Prvotní převod kmenových dat ==
* [[Převod dat před startem rutinního provozu (jednorázová funkce č. 112) (záložka Prvotní převod)]]
* [[Převod dat před startem rutinního provozu (jednorázová funkce č. 112) (záložka Převod dat)]]

== Odkazy ==
* [[Jednorázové funkce]]
* [[Implementace]]
* [[Vícekvartálové položky před startem rutinního provozu]]
* [[Převod dat před startem rutinního provozu (jednorázová funkce č. 112) (záložka Prvotní převod)]]
* [[Převod dat před startem rutinního provozu (jednorázová funkce č. 112) (záložka Převod dat)]]
* [[Import dat při implementaci (jednorázová funkce č. 112) (záložka_Převod_REGZEC)]]

Import dat při implementaci (jednorázová funkce č. 112) (záložka Převod REGZEC)

2026-09-25T08:15:04Z

Milan:

Menu / Systém / Jednorázové funkce

Převod slouží k aktualizaci údajů v databázi ''KS mzdy'' z XML souboru REGZEC.

[[Soubor:Prevod_REGZEC.png|800px|center|Záložka Převod REGZEC]]

== Postup importu ==

# Otevřete okno '''Import dat při implementaci'''.
# Zvolte záložku '''Převod REGZEC'''.
# V části '''Datový přenos''' je dostupná pouze hodnota '''Data REGZEC'''.
# Pomocí tlačítka '''...''' vyberte XML soubor REGZEC.
# Stiskněte tlačítko '''Načíst'''.
# Po úspěšném načtení budou data zobrazena v tabulce.
# Stiskněte tlačítko '''Převést'''.

== Režim importu ==

Pro převod dat je podporován pouze režim:

* '''Aktualizovat stávající data + import'''

Při zpracování importu jsou do databáze ukládány všechny načtené záznamy. 
Aktualizovány jsou pouze ty údaje, které jsou v XML souboru vyplněny hodnotou. 
Prázdné nebo neuvedené elementy XML '''nepřepisují''' stávající hodnoty v databázi na hodnotu NULL.

== Převod dat z REGZEC ==

Následující tabulka uvádí mapování XML elementů REGZEC na položky importu.

{| class="wikitable sortable"
! Položka importu
! XML element REGZEC

! Umístění v aplikaci
|-
| pracovnici_oic_mpsv
| employee.client.ikmpsv

| Mzdové údaje → Osobní IČ (IK MPSV)
|-
| pracovnici_statdcis_nerezid
| employee.client.taxidrezid.stat

| Cizinci → Daňová identifikace ve státě rezidence → Stát daňové rezidence
|-
| pracovnici_dcis_nerezidenta
| employee.client.taxidrezid.num

| Cizinci → Daňová identifikace ve státě rezidence → Identifikátor
|-
| pracovnici_kod_stat_drezid_od
| employee.client.taxidrezid.statchang

| Cizinci → Daňová identifikace ve státě rezidence → Datum změny státu
|-
| pracovnici_typdcis_nerezid
| employee.client.taxidrezid.type

| Cizinci → Daňová identifikace ve státě rezidence → Typ daňové identifikace
|-
| pracovnici_statdokl_nerezid
| employee.client.proofid.stat

| Cizinci → Doklad totožnosti → Stát vydání
|-
| pracovnici_cdokl_nerezid
| employee.client.proofid.num

| Cizinci → Doklad totožnosti → Číslo dokladu
|-
| pracovnici_typdokl_nerezid
| employee.client.proofid.type

| Cizinci → Doklad totožnosti → Typ dokladu
|-
| ciz_doklad_vydal
| employee.client.proofid.foreigninst

| Cizinci → Doklad totožnosti → Doklad vydal
|-
| adr_statrez_misto
| employee.client.rdr.cit

| Cizinci → Adresa bydliště ve státě rezidence → Obec
|-
| adr_statrez_stat
| employee.client.rdr.cnt

| Cizinci → Adresa bydliště ve státě rezidence → Stát
|-
| adr_statrez_pcode
| employee.client.rdr.pnu

| Cizinci → Adresa bydliště ve státě rezidence → Postcode
|-
| adr_statrez_cislo
| employee.client.rdr.num

| Cizinci → Adresa bydliště ve státě rezidence → Číslo popisné
|-
| adr_statrez_ulice
| employee.client.rdr.str

| Cizinci → Adresa bydliště ve státě rezidence → Ulice
|-
| reg_cssz_obec
| employee.forin.cit

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Obec
|-
| reg_cssz_nazev
| employee.forin.nam

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Název nositele
|-
| reg_cssz_stat
| employee.forin.cnt

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Stát
|-
| reg_cssz_pcode
| employee.forin.pnu

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Postcode
|-
| reg_cssz_cislo
| employee.forin.num

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Číslo popisné
|-
| reg_cssz_ulice
| employee.forin.str

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Ulice
|-
| sektor_pojisteni
| employee.forin.sec

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Sektor/účel
|-
| reg_cssz_cpoj
| employee.forin.id

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Číslo pojištění
|-
| spec_ciz_nositele
| employee.forin.cur

| Cizinci → Identifikace posledního cizozemského nositele pojištění → Specifikace
|-
| prac_povol_pr_pov_do
| employee.nocitizen.permto

| Pracovní povolení → Pracovní oprávnění do
|-
| prac_povol_pr_pov_od
| employee.nocitizen.permfro

| Pracovní povolení → Pracovní oprávnění od
|-
| prac_povol_opravneni_cislo
| employee.nocitizen.permid

| Pracovní povolení → Povolení číslo
|-
| prac_povol_opravneni_vydal
| employee.nocitizen.issue

| Pracovní povolení → Povolení vydala
|-
| prac_povol_druh_opravneni
| employee.nocitizen.permtype

| Pracovní povolení → Druh pracovního oprávnění
|-
| prac_povol_doc_ochrana
| employee.nocitizen.freeacc

| Pracovní povolení → Volný přístup na trh práce
|-
| stat_pravni_prisl
| employee.forinreg.state

| Cizinci → Příslušnost k cizím právním předpisům
|-
| pracovnici_e101
| employee.forinreg.juris

| Mzdové údaje → A1
|-
| pracovnici_predcas_star_duch
| employee.pens.early / employee.pens.reducedAge

| Osobní údaje → Starobní důchod
|-
| vzdelani_stupen
| employee.fact.highedu

| Vzdělání → Stupeň
|-
| prac_pom_datum_skut_nast
| employee.job.fro

| Pracovní poměr → Datum skutečného nástupu
|-
| prac_pom_maly_rozsah
| employee.job.sme

| Pracovní poměr → Zaměstnání malého rozsahu
|-
| prac_pom_druh_cinnosti
| employee.job.rel

| Pracovní poměr → Druh činnosti
|-
| prac_pom_ic_prav_vztahu
| employee.job.oid

| Pracovní poměr → ID pojistného vztahu
|}

== Poznámky ==

* Identifikace zaměstnance probíhá podle elementu '''employee.client.bno'''.
* Import podporuje pouze soubory ve formátu XML REGZEC.
* Prázdné nebo neuvedené elementy XML nepřepisují existující údaje v databázi.
* Před importem doporučujeme ověřit správnost a úplnost vstupního XML souboru.

== Odkazy ==
* [[Převod dat před startem rutinního provozu (jednorázová funkce č. 112)]]

Import dat při implementaci (jednorázová funkce č. 112) (záložka Převod REGZEC)

2026-09-25T06:23:06Z

Milan:

Menu / Systém / Jednorázové funkce

= Převod REGZEC =

== Popis funkcionality ==

Do okna '''Import dat při implementaci''' byla doplněna nová záložka '''Převod REGZEC'''.

Funkcionalita slouží k importu údajů z registru REGZEC prostřednictvím XML souboru.

[[Soubor:Prevod_REGZEC.png|800px|center|Záložka Převod REGZEC]]

== Postup importu ==

# Otevřete okno '''Import dat při implementaci'''.
# Zvolte záložku '''Převod REGZEC'''.
# V části '''Datový přenos''' je dostupná pouze hodnota '''Data REGZEC'''.
# Pomocí tlačítka '''...''' vyberte XML soubor REGZEC.
# Stiskněte tlačítko '''Načíst'''.
# Po úspěšném načtení budou data zobrazena v tabulce.
# Stiskněte tlačítko '''Převést'''.

== Režim importu ==

Pro převod dat je podporován pouze režim:

* '''Aktualizovat stávající data + import'''

Při zpracování importu jsou do databáze ukládány všechny načtené záznamy. Aktualizovány jsou pouze ty údaje, které jsou v XML souboru vyplněny hodnotou.

Prázdné nebo neuvedené elementy XML '''nepřepisují''' stávající hodnoty v databázi na hodnotu NULL.

== Převod dat z REGZEC ==

Následující tabulka uvádí mapování XML elementů REGZEC na položky personální databáze.

{| class="wikitable sortable"
! Položka importu
! XML element REGZEC
! Databázová položka
! Umístění v aplikaci
|-
| pracovnici_oic_mpsv
| employee.client.ikmpsv
| pracovnici.oic_mpsv
| Mzdové údaje → Osobní IČ (IK MPSV)
|-
| pracovnici_statdcis_nerezid
| employee.client.taxidrezid.stat
| pracovnici.statdcis_nerezid
| Cizinci → Daňová identifikace ve státě rezidence → Stát daňové rezidence
|-
| pracovnici_dcis_nerezidenta
| employee.client.taxidrezid.num
| pracovnici.dcis_nerezidenta
| Cizinci → Daňová identifikace ve státě rezidence → Identifikátor
|-
| pracovnici_kod_stat_drezid_od
| employee.client.taxidrezid.statchang
| pracovnici.kod_stat_drezid_od
| Cizinci → Daňová identifikace ve státě rezidence → Datum změny státu
|-
| pracovnici_typdcis_nerezid
| employee.client.taxidrezid.type
| pracovnici.typdcis_nerezid
| Cizinci → Daňová identifikace ve státě rezidence → Typ daňové identifikace
|-
| pracovnici_statdokl_nerezid
| employee.client.proofid.stat
| pracovnici.statdokl_nerezid
| Cizinci → Doklad totožnosti → Stát vydání
|-
| pracovnici_cdokl_nerezid
| employee.client.proofid.num
| pracovnici.cdokl_nerezid
| Cizinci → Doklad totožnosti → Číslo dokladu
|-
| pracovnici_typdokl_nerezid
| employee.client.proofid.type
| pracovnici.typdokl_nerezid
| Cizinci → Doklad totožnosti → Typ dokladu
|-
| ciz_doklad_vydal
| employee.client.proofid.foreigninst
| ciz_doklad_vydal
| Cizinci → Doklad totožnosti → Doklad vydal
|-
| adr_statrez_misto
| employee.client.rdr.cit
| adr_statrez_misto
| Cizinci → Adresa bydliště ve státě rezidence → Obec
|-
| adr_statrez_stat
| employee.client.rdr.cnt
| adr_statrez_stat
| Cizinci → Adresa bydliště ve státě rezidence → Stát
|-
| adr_statrez_pcode
| employee.client.rdr.pnu
| adr_statrez_pcode
| Cizinci → Adresa bydliště ve státě rezidence → Postcode
|-
| adr_statrez_cislo
| employee.client.rdr.num
| adr_statrez_cislo
| Cizinci → Adresa bydliště ve státě rezidence → Číslo popisné
|-
| adr_statrez_ulice
| employee.client.rdr.str
| adr_statrez_ulice
| Cizinci → Adresa bydliště ve státě rezidence → Ulice
|-
| reg_cssz_obec
| employee.forin.cit
| reg_cssz_obec
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Obec
|-
| reg_cssz_nazev
| employee.forin.nam
| reg_cssz_nazev
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Název nositele
|-
| reg_cssz_stat
| employee.forin.cnt
| reg_cssz_stat
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Stát
|-
| reg_cssz_pcode
| employee.forin.pnu
| reg_cssz_pcode
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Postcode
|-
| reg_cssz_cislo
| employee.forin.num
| reg_cssz_cislo
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Číslo popisné
|-
| reg_cssz_ulice
| employee.forin.str
| reg_cssz_ulice
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Ulice
|-
| sektor_pojisteni
| employee.forin.sec
| sektor_pojisteni
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Sektor/účel
|-
| reg_cssz_cpoj
| employee.forin.id
| reg_cssz_cpoj
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Číslo pojištění
|-
| spec_ciz_nositele
| employee.forin.cur
| spec_ciz_nositele
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Specifikace
|-
| prac_povol_pr_pov_do
| employee.nocitizen.permto
| prac_povol.pr_pov_do
| Pracovní povolení → Pracovní oprávnění do
|-
| prac_povol_pr_pov_od
| employee.nocitizen.permfro
| prac_povol.pr_pov_od
| Pracovní povolení → Pracovní oprávnění od
|-
| prac_povol_opravneni_cislo
| employee.nocitizen.permid
| prac_povol.opravneni_cislo
| Pracovní povolení → Povolení číslo
|-
| prac_povol_opravneni_vydal
| employee.nocitizen.issue
| prac_povol.opravneni_vydal
| Pracovní povolení → Povolení vydala
|-
| prac_povol_druh_opravneni
| employee.nocitizen.permtype
| prac_povol.druh_opravneni
| Pracovní povolení → Druh pracovního oprávnění
|-
| prac_povol_doc_ochrana
| employee.nocitizen.freeacc
| prac_povol.doc_ochrana
| Pracovní povolení → Volný přístup na trh práce
|-
| stat_pravni_prisl
| employee.forinreg.state
| stat_pravni_prisl
| Cizinci → Příslušnost k cizím právním předpisům
|-
| pracovnici_e101
| employee.forinreg.juris
| pracovnici.e101
| Mzdové údaje → A1
|-
| pracovnici_predcas_star_duch
| employee.pens.early / employee.pens.reducedAge
| pracovnici.predcas_star_duch
| Osobní údaje → Starobní důchod
|-
| vzdelani_stupen
| employee.fact.highedu
| vzdelani.stupen
| Vzdělání → Stupeň
|-
| prac_pom_datum_skut_nast
| employee.job.fro
| prac_pom.datum_skut_nast
| Pracovní poměr → Datum skutečného nástupu
|-
| prac_pom_maly_rozsah
| employee.job.sme
| prac_pom.maly_rozsah
| Pracovní poměr → Zaměstnání malého rozsahu
|-
| prac_pom_druh_cinnosti
| employee.job.rel
| prac_pom.druh_cinnosti
| Pracovní poměr → Druh činnosti
|-
| prac_pom_ic_prav_vztahu
| employee.job.oid
| prac_pom.ic_prav_vztahu
| Pracovní poměr → ID pojistného vztahu
|}

== Poznámky ==

* Identifikace zaměstnance probíhá podle osobního čísla zaměstnance.
* Import podporuje pouze soubory ve formátu XML REGZEC.
* Prázdné hodnoty v XML nepřepisují existující údaje v databázi.
* Před importem doporučujeme ověřit správnost a úplnost vstupního XML souboru.

== Odkazy ==
* [[Převod dat před startem rutinního provozu (jednorázová funkce č. 112)]]

Import dat při implementaci (jednorázová funkce č. 112) (záložka Převod REGZEC)

2026-09-25T06:09:54Z

Milan: /* Převod dat z REGZEC */

= Převod REGZEC =

== Popis funkcionality ==

Do okna '''Import dat při implementaci''' byla doplněna nová záložka '''Převod REGZEC'''.

Funkcionalita slouží k importu údajů z registru REGZEC prostřednictvím XML souboru.

[[Soubor:Prevod_REGZEC.png|800px|center|Záložka Převod REGZEC]]

== Postup importu ==

# Otevřete okno '''Import dat při implementaci'''.
# Zvolte záložku '''Převod REGZEC'''.
# V části '''Datový přenos''' je dostupná pouze hodnota '''Data REGZEC'''.
# Pomocí tlačítka '''...''' vyberte XML soubor REGZEC.
# Stiskněte tlačítko '''Načíst'''.
# Po úspěšném načtení budou data zobrazena v tabulce.
# Stiskněte tlačítko '''Převést'''.

== Režim importu ==

Pro převod dat je podporován pouze režim:

* '''Aktualizovat stávající data + import'''

Při zpracování importu jsou do databáze ukládány všechny načtené záznamy. Aktualizovány jsou pouze ty údaje, které jsou v XML souboru vyplněny hodnotou.

Prázdné nebo neuvedené elementy XML '''nepřepisují''' stávající hodnoty v databázi na hodnotu NULL.

== Převod dat z REGZEC ==

Následující tabulka uvádí mapování XML elementů REGZEC na položky personální databáze.

{| class="wikitable sortable"
! Položka importu
! XML element REGZEC
! Databázová položka
! Umístění v aplikaci
|-
| pracovnici_oic_mpsv
| employee.client.ikmpsv
| pracovnici.oic_mpsv
| Mzdové údaje → Osobní IČ (IK MPSV)
|-
| pracovnici_statdcis_nerezid
| employee.client.taxidrezid.stat
| pracovnici.statdcis_nerezid
| Cizinci → Daňová identifikace ve státě rezidence → Stát daňové rezidence
|-
| pracovnici_dcis_nerezidenta
| employee.client.taxidrezid.num
| pracovnici.dcis_nerezidenta
| Cizinci → Daňová identifikace ve státě rezidence → Identifikátor
|-
| pracovnici_kod_stat_drezid_od
| employee.client.taxidrezid.statchang
| pracovnici.kod_stat_drezid_od
| Cizinci → Daňová identifikace ve státě rezidence → Datum změny státu
|-
| pracovnici_typdcis_nerezid
| employee.client.taxidrezid.type
| pracovnici.typdcis_nerezid
| Cizinci → Daňová identifikace ve státě rezidence → Typ daňové identifikace
|-
| pracovnici_statdokl_nerezid
| employee.client.proofid.stat
| pracovnici.statdokl_nerezid
| Cizinci → Doklad totožnosti → Stát vydání
|-
| pracovnici_cdokl_nerezid
| employee.client.proofid.num
| pracovnici.cdokl_nerezid
| Cizinci → Doklad totožnosti → Číslo dokladu
|-
| pracovnici_typdokl_nerezid
| employee.client.proofid.type
| pracovnici.typdokl_nerezid
| Cizinci → Doklad totožnosti → Typ dokladu
|-
| ciz_doklad_vydal
| employee.client.proofid.foreigninst
| ciz_doklad_vydal
| Cizinci → Doklad totožnosti → Doklad vydal
|-
| adr_statrez_misto
| employee.client.rdr.cit
| adr_statrez_misto
| Cizinci → Adresa bydliště ve státě rezidence → Obec
|-
| adr_statrez_stat
| employee.client.rdr.cnt
| adr_statrez_stat
| Cizinci → Adresa bydliště ve státě rezidence → Stát
|-
| adr_statrez_pcode
| employee.client.rdr.pnu
| adr_statrez_pcode
| Cizinci → Adresa bydliště ve státě rezidence → Postcode
|-
| adr_statrez_cislo
| employee.client.rdr.num
| adr_statrez_cislo
| Cizinci → Adresa bydliště ve státě rezidence → Číslo popisné
|-
| adr_statrez_ulice
| employee.client.rdr.str
| adr_statrez_ulice
| Cizinci → Adresa bydliště ve státě rezidence → Ulice
|-
| reg_cssz_obec
| employee.forin.cit
| reg_cssz_obec
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Obec
|-
| reg_cssz_nazev
| employee.forin.nam
| reg_cssz_nazev
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Název nositele
|-
| reg_cssz_stat
| employee.forin.cnt
| reg_cssz_stat
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Stát
|-
| reg_cssz_pcode
| employee.forin.pnu
| reg_cssz_pcode
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Postcode
|-
| reg_cssz_cislo
| employee.forin.num
| reg_cssz_cislo
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Číslo popisné
|-
| reg_cssz_ulice
| employee.forin.str
| reg_cssz_ulice
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Ulice
|-
| sektor_pojisteni
| employee.forin.sec
| sektor_pojisteni
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Sektor/účel
|-
| reg_cssz_cpoj
| employee.forin.id
| reg_cssz_cpoj
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Číslo pojištění
|-
| spec_ciz_nositele
| employee.forin.cur
| spec_ciz_nositele
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Specifikace
|-
| prac_povol_pr_pov_do
| employee.nocitizen.permto
| prac_povol.pr_pov_do
| Pracovní povolení → Pracovní oprávnění do
|-
| prac_povol_pr_pov_od
| employee.nocitizen.permfro
| prac_povol.pr_pov_od
| Pracovní povolení → Pracovní oprávnění od
|-
| prac_povol_opravneni_cislo
| employee.nocitizen.permid
| prac_povol.opravneni_cislo
| Pracovní povolení → Povolení číslo
|-
| prac_povol_opravneni_vydal
| employee.nocitizen.issue
| prac_povol.opravneni_vydal
| Pracovní povolení → Povolení vydala
|-
| prac_povol_druh_opravneni
| employee.nocitizen.permtype
| prac_povol.druh_opravneni
| Pracovní povolení → Druh pracovního oprávnění
|-
| prac_povol_doc_ochrana
| employee.nocitizen.freeacc
| prac_povol.doc_ochrana
| Pracovní povolení → Volný přístup na trh práce
|-
| stat_pravni_prisl
| employee.forinreg.state
| stat_pravni_prisl
| Cizinci → Příslušnost k cizím právním předpisům
|-
| pracovnici_e101
| employee.forinreg.juris
| pracovnici.e101
| Mzdové údaje → A1
|-
| pracovnici_predcas_star_duch
| employee.pens.early / employee.pens.reducedAge
| pracovnici.predcas_star_duch
| Osobní údaje → Starobní důchod
|-
| vzdelani_stupen
| employee.fact.highedu
| vzdelani.stupen
| Vzdělání → Stupeň
|-
| prac_pom_datum_skut_nast
| employee.job.fro
| prac_pom.datum_skut_nast
| Pracovní poměr → Datum skutečného nástupu
|-
| prac_pom_maly_rozsah
| employee.job.sme
| prac_pom.maly_rozsah
| Pracovní poměr → Zaměstnání malého rozsahu
|-
| prac_pom_druh_cinnosti
| employee.job.rel
| prac_pom.druh_cinnosti
| Pracovní poměr → Druh činnosti
|-
| prac_pom_ic_prav_vztahu
| employee.job.oid
| prac_pom.ic_prav_vztahu
| Pracovní poměr → ID pojistného vztahu
|}

== Poznámky ==

* Identifikace zaměstnance probíhá podle osobního čísla zaměstnance.
* Import podporuje pouze soubory ve formátu XML REGZEC.
* Prázdné hodnoty v XML nepřepisují existující údaje v databázi.
* Před importem doporučujeme ověřit správnost a úplnost vstupního XML souboru.

Import dat při implementaci (jednorázová funkce č. 112) (záložka Převod REGZEC)

2026-09-24T12:59:07Z

Milan: /* Postup importu */

= Převod REGZEC =

== Popis funkcionality ==

Do okna '''Import dat při implementaci''' byla doplněna nová záložka '''Převod REGZEC'''.

Funkcionalita slouží k importu údajů z registru REGZEC prostřednictvím XML souboru.

[[Soubor:Prevod_REGZEC.png|800px|center|Záložka Převod REGZEC]]

== Postup importu ==

# Otevřete okno '''Import dat při implementaci'''.
# Zvolte záložku '''Převod REGZEC'''.
# V části '''Datový přenos''' je dostupná pouze hodnota '''Data REGZEC'''.
# Pomocí tlačítka '''...''' vyberte XML soubor REGZEC.
# Stiskněte tlačítko '''Načíst'''.
# Po úspěšném načtení budou data zobrazena v tabulce.
# Stiskněte tlačítko '''Převést'''.

== Režim importu ==

Pro převod dat je podporován pouze režim:

* '''Aktualizovat stávající data + import'''

Při zpracování importu jsou do databáze ukládány všechny načtené záznamy. Aktualizovány jsou pouze ty údaje, které jsou v XML souboru vyplněny hodnotou.

Prázdné nebo neuvedené elementy XML '''nepřepisují''' stávající hodnoty v databázi na hodnotu NULL.

== Převod dat z REGZEC ==

Následující tabulka uvádí mapování XML elementů REGZEC na položky personální databáze.

{| class="wikitable sortable"
! XML element REGZEC
! Databázová položka
! Umístění v aplikaci
|-
| employee.client.ikmpsv
| pracovnici.oic_mpsv
| Mzdové údaje → Osobní IČ (IK MPSV)
|-
| employee.client.taxidrezid.stat
| pracovnici.statdcis_nerezid
| Cizinci → Daňová identifikace ve státě rezidence → Stát daňové rezidence
|-
| employee.client.taxidrezid.num
| pracovnici.dcis_nerezidenta
| Cizinci → Daňová identifikace ve státě rezidence → Identifikátor
|-
| employee.client.taxidrezid.statchang
| pracovnici.kod_stat_drezid_od
| Cizinci → Daňová identifikace ve státě rezidence → Datum změny státu
|-
| employee.client.taxidrezid.type
| pracovnici.typdcis_nerezid
| Cizinci → Daňová identifikace ve státě rezidence → Typ daňové identifikace
|-
| employee.client.proofid.stat
| pracovnici.statdokl_nerezid
| Cizinci → Doklad totožnosti → Stát vydání
|-
| employee.client.proofid.num
| pracovnici.cdokl_nerezid
| Cizinci → Doklad totožnosti → Číslo dokladu
|-
| employee.client.proofid.type
| pracovnici.typdokl_nerezid
| Cizinci → Doklad totožnosti → Typ dokladu
|-
| employee.client.proofid.foreigninst
| ciz_doklad_vydal
| Cizinci → Doklad totožnosti → Doklad vydal
|-
| employee.client.rdr.cit
| adr_statrez_misto
| Cizinci → Adresa bydliště ve státě rezidence → Obec
|-
| employee.client.rdr.cnt
| adr_statrez_stat
| Cizinci → Adresa bydliště ve státě rezidence → Stát
|-
| employee.client.rdr.pnu
| adr_statrez_pcode
| Cizinci → Adresa bydliště ve státě rezidence → Postcode
|-
| employee.client.rdr.num
| adr_statrez_cislo
| Cizinci → Adresa bydliště ve státě rezidence → Číslo popisné
|-
| employee.client.rdr.str
| adr_statrez_ulice
| Cizinci → Adresa bydliště ve státě rezidence → Ulice
|-
| employee.forin.cit
| reg_cssz_obec
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Obec
|-
| employee.forin.nam
| reg_cssz_nazev
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Název nositele
|-
| employee.forin.cnt
| reg_cssz_stat
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Stát
|-
| employee.forin.pnu
| reg_cssz_pcode
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Postcode
|-
| employee.forin.num
| reg_cssz_cislo
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Číslo popisné
|-
| employee.forin.str
| reg_cssz_ulice
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Ulice
|-
| employee.forin.sec
| sektor_pojisteni
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Sektor/účel
|-
| employee.forin.id
| reg_cssz_cpoj
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Číslo pojištění
|-
| employee.forin.cur
| spec_ciz_nositele
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Specifikace
|-
| employee.nocitizen.permto
| prac_povol.pr_pov_do
| Pracovní povolení → Pracovní oprávnění do
|-
| employee.nocitizen.permfro
| prac_povol.pr_pov_od
| Pracovní povolení → Pracovní oprávnění od
|-
| employee.nocitizen.permid
| prac_povol.opravneni_cislo
| Pracovní povolení → Povolení číslo
|-
| employee.nocitizen.issue
| prac_povol.opravneni_vydal
| Pracovní povolení → Povolení vydala
|-
| employee.nocitizen.permtype
| prac_povol.druh_opravneni
| Pracovní povolení → Druh pracovního oprávnění
|-
| employee.nocitizen.freeacc
| prac_povol.doc_ochrana
| Pracovní povolení → Volný přístup na trh práce
|-
| employee.forinreg.state
| stat_pravni_prisl
| Cizinci → Příslušnost k cizím právním předpisům
|-
| employee.forinreg.juris
| pracovnici.e101
| Mzdové údaje → A1
|-
| employee.pens.early / employee.pens.reducedAge
| pracovnici.predcas_star_duch
| Osobní údaje → Starobní důchod
|-
| employee.fact.highedu
| vzdelani.stupen
| Vzdělání → Stupeň
|-
| employee.job.fro
| prac_pom.datum_skut_nast
| Pracovní poměr → Datum skutečného nástupu
|-
| employee.job.sme
| prac_pom.maly_rozsah
| Pracovní poměr → Zaměstnání malého rozsahu
|-
| employee.job.rel
| prac_pom.druh_cinnosti
| Pracovní poměr → Druh činnosti
|-
| employee.job.oid
| prac_pom.ic_prav_vztahu
| Pracovní poměr → ID pojistného vztahu
|}

== Poznámky ==

* Identifikace zaměstnance probíhá podle osobního čísla zaměstnance.
* Import podporuje pouze soubory ve formátu XML REGZEC.
* Prázdné hodnoty v XML nepřepisují existující údaje v databázi.
* Před importem doporučujeme ověřit správnost a úplnost vstupního XML souboru.

Import dat při implementaci (jednorázová funkce č. 112) (záložka Převod REGZEC)

2026-09-24T12:57:31Z

Milan: /* Popis funkcionality */

= Převod REGZEC =

== Popis funkcionality ==

Do okna '''Import dat při implementaci''' byla doplněna nová záložka '''Převod REGZEC'''.

Funkcionalita slouží k importu údajů z registru REGZEC prostřednictvím XML souboru.

[[Soubor:Prevod_REGZEC.png|800px|center|Záložka Převod REGZEC]]

== Postup importu ==

# Otevřete okno '''Import dat při implementaci'''.
# Zvolte záložku '''Převod REGZEC'''.
# V části '''Datový přenos''' je dostupná pouze hodnota:
#* '''Data REGZEC'''
# Pomocí tlačítka '''...''' vyberte XML soubor REGZEC.
# Stiskněte tlačítko '''Načíst'''.
# Po úspěšném načtení budou data zobrazena v tabulce.
# Stiskněte tlačítko '''Převést'''.

== Režim importu ==

Pro převod dat je podporován pouze režim:

* '''Aktualizovat stávající data + import'''

Při zpracování importu jsou do databáze ukládány všechny načtené záznamy. Aktualizovány jsou pouze ty údaje, které jsou v XML souboru vyplněny hodnotou.

Prázdné nebo neuvedené elementy XML '''nepřepisují''' stávající hodnoty v databázi na hodnotu NULL.

== Převod dat z REGZEC ==

Následující tabulka uvádí mapování XML elementů REGZEC na položky personální databáze.

{| class="wikitable sortable"
! XML element REGZEC
! Databázová položka
! Umístění v aplikaci
|-
| employee.client.ikmpsv
| pracovnici.oic_mpsv
| Mzdové údaje → Osobní IČ (IK MPSV)
|-
| employee.client.taxidrezid.stat
| pracovnici.statdcis_nerezid
| Cizinci → Daňová identifikace ve státě rezidence → Stát daňové rezidence
|-
| employee.client.taxidrezid.num
| pracovnici.dcis_nerezidenta
| Cizinci → Daňová identifikace ve státě rezidence → Identifikátor
|-
| employee.client.taxidrezid.statchang
| pracovnici.kod_stat_drezid_od
| Cizinci → Daňová identifikace ve státě rezidence → Datum změny státu
|-
| employee.client.taxidrezid.type
| pracovnici.typdcis_nerezid
| Cizinci → Daňová identifikace ve státě rezidence → Typ daňové identifikace
|-
| employee.client.proofid.stat
| pracovnici.statdokl_nerezid
| Cizinci → Doklad totožnosti → Stát vydání
|-
| employee.client.proofid.num
| pracovnici.cdokl_nerezid
| Cizinci → Doklad totožnosti → Číslo dokladu
|-
| employee.client.proofid.type
| pracovnici.typdokl_nerezid
| Cizinci → Doklad totožnosti → Typ dokladu
|-
| employee.client.proofid.foreigninst
| ciz_doklad_vydal
| Cizinci → Doklad totožnosti → Doklad vydal
|-
| employee.client.rdr.cit
| adr_statrez_misto
| Cizinci → Adresa bydliště ve státě rezidence → Obec
|-
| employee.client.rdr.cnt
| adr_statrez_stat
| Cizinci → Adresa bydliště ve státě rezidence → Stát
|-
| employee.client.rdr.pnu
| adr_statrez_pcode
| Cizinci → Adresa bydliště ve státě rezidence → Postcode
|-
| employee.client.rdr.num
| adr_statrez_cislo
| Cizinci → Adresa bydliště ve státě rezidence → Číslo popisné
|-
| employee.client.rdr.str
| adr_statrez_ulice
| Cizinci → Adresa bydliště ve státě rezidence → Ulice
|-
| employee.forin.cit
| reg_cssz_obec
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Obec
|-
| employee.forin.nam
| reg_cssz_nazev
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Název nositele
|-
| employee.forin.cnt
| reg_cssz_stat
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Stát
|-
| employee.forin.pnu
| reg_cssz_pcode
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Postcode
|-
| employee.forin.num
| reg_cssz_cislo
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Číslo popisné
|-
| employee.forin.str
| reg_cssz_ulice
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Ulice
|-
| employee.forin.sec
| sektor_pojisteni
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Sektor/účel
|-
| employee.forin.id
| reg_cssz_cpoj
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Číslo pojištění
|-
| employee.forin.cur
| spec_ciz_nositele
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Specifikace
|-
| employee.nocitizen.permto
| prac_povol.pr_pov_do
| Pracovní povolení → Pracovní oprávnění do
|-
| employee.nocitizen.permfro
| prac_povol.pr_pov_od
| Pracovní povolení → Pracovní oprávnění od
|-
| employee.nocitizen.permid
| prac_povol.opravneni_cislo
| Pracovní povolení → Povolení číslo
|-
| employee.nocitizen.issue
| prac_povol.opravneni_vydal
| Pracovní povolení → Povolení vydala
|-
| employee.nocitizen.permtype
| prac_povol.druh_opravneni
| Pracovní povolení → Druh pracovního oprávnění
|-
| employee.nocitizen.freeacc
| prac_povol.doc_ochrana
| Pracovní povolení → Volný přístup na trh práce
|-
| employee.forinreg.state
| stat_pravni_prisl
| Cizinci → Příslušnost k cizím právním předpisům
|-
| employee.forinreg.juris
| pracovnici.e101
| Mzdové údaje → A1
|-
| employee.pens.early / employee.pens.reducedAge
| pracovnici.predcas_star_duch
| Osobní údaje → Starobní důchod
|-
| employee.fact.highedu
| vzdelani.stupen
| Vzdělání → Stupeň
|-
| employee.job.fro
| prac_pom.datum_skut_nast
| Pracovní poměr → Datum skutečného nástupu
|-
| employee.job.sme
| prac_pom.maly_rozsah
| Pracovní poměr → Zaměstnání malého rozsahu
|-
| employee.job.rel
| prac_pom.druh_cinnosti
| Pracovní poměr → Druh činnosti
|-
| employee.job.oid
| prac_pom.ic_prav_vztahu
| Pracovní poměr → ID pojistného vztahu
|}

== Poznámky ==

* Identifikace zaměstnance probíhá podle osobního čísla zaměstnance.
* Import podporuje pouze soubory ve formátu XML REGZEC.
* Prázdné hodnoty v XML nepřepisují existující údaje v databázi.
* Před importem doporučujeme ověřit správnost a úplnost vstupního XML souboru.

Import dat při implementaci (jednorázová funkce č. 112) (záložka Převod REGZEC)

2026-09-24T12:55:28Z

Milan: založena nová stránka s textem „= Převod REGZEC = == Popis funkcionality == Do okna **Import dat při implementaci** (dříve **Převod dat před startem rutinního provozu**) byla doplněna nová záložka **Převod REGZEC**. Funkcionalita slouží k importu údajů z registru REGZEC prostřednictvím XML souboru. Záložka Převod REGZEC == Postup importu == # Otevřete okno '''Import dat při implementaci'''. # Zvolte záložku '''…“

= Převod REGZEC =

== Popis funkcionality ==

Do okna **Import dat při implementaci** (dříve **Převod dat před startem rutinního provozu**) byla doplněna nová záložka **Převod REGZEC**.

Funkcionalita slouží k importu údajů z registru REGZEC prostřednictvím XML souboru.

[[Soubor:Prevod_REGZEC.png|800px|center|Záložka Převod REGZEC]]

== Postup importu ==

# Otevřete okno '''Import dat při implementaci'''.
# Zvolte záložku '''Převod REGZEC'''.
# V části '''Datový přenos''' je dostupná pouze hodnota:
#* '''Data REGZEC'''
# Pomocí tlačítka '''...''' vyberte XML soubor REGZEC.
# Stiskněte tlačítko '''Načíst'''.
# Po úspěšném načtení budou data zobrazena v tabulce.
# Stiskněte tlačítko '''Převést'''.

== Režim importu ==

Pro převod dat je podporován pouze režim:

* '''Aktualizovat stávající data + import'''

Při zpracování importu jsou do databáze ukládány všechny načtené záznamy. Aktualizovány jsou pouze ty údaje, které jsou v XML souboru vyplněny hodnotou.

Prázdné nebo neuvedené elementy XML '''nepřepisují''' stávající hodnoty v databázi na hodnotu NULL.

== Převod dat z REGZEC ==

Následující tabulka uvádí mapování XML elementů REGZEC na položky personální databáze.

{| class="wikitable sortable"
! XML element REGZEC
! Databázová položka
! Umístění v aplikaci
|-
| employee.client.ikmpsv
| pracovnici.oic_mpsv
| Mzdové údaje → Osobní IČ (IK MPSV)
|-
| employee.client.taxidrezid.stat
| pracovnici.statdcis_nerezid
| Cizinci → Daňová identifikace ve státě rezidence → Stát daňové rezidence
|-
| employee.client.taxidrezid.num
| pracovnici.dcis_nerezidenta
| Cizinci → Daňová identifikace ve státě rezidence → Identifikátor
|-
| employee.client.taxidrezid.statchang
| pracovnici.kod_stat_drezid_od
| Cizinci → Daňová identifikace ve státě rezidence → Datum změny státu
|-
| employee.client.taxidrezid.type
| pracovnici.typdcis_nerezid
| Cizinci → Daňová identifikace ve státě rezidence → Typ daňové identifikace
|-
| employee.client.proofid.stat
| pracovnici.statdokl_nerezid
| Cizinci → Doklad totožnosti → Stát vydání
|-
| employee.client.proofid.num
| pracovnici.cdokl_nerezid
| Cizinci → Doklad totožnosti → Číslo dokladu
|-
| employee.client.proofid.type
| pracovnici.typdokl_nerezid
| Cizinci → Doklad totožnosti → Typ dokladu
|-
| employee.client.proofid.foreigninst
| ciz_doklad_vydal
| Cizinci → Doklad totožnosti → Doklad vydal
|-
| employee.client.rdr.cit
| adr_statrez_misto
| Cizinci → Adresa bydliště ve státě rezidence → Obec
|-
| employee.client.rdr.cnt
| adr_statrez_stat
| Cizinci → Adresa bydliště ve státě rezidence → Stát
|-
| employee.client.rdr.pnu
| adr_statrez_pcode
| Cizinci → Adresa bydliště ve státě rezidence → Postcode
|-
| employee.client.rdr.num
| adr_statrez_cislo
| Cizinci → Adresa bydliště ve státě rezidence → Číslo popisné
|-
| employee.client.rdr.str
| adr_statrez_ulice
| Cizinci → Adresa bydliště ve státě rezidence → Ulice
|-
| employee.forin.cit
| reg_cssz_obec
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Obec
|-
| employee.forin.nam
| reg_cssz_nazev
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Název nositele
|-
| employee.forin.cnt
| reg_cssz_stat
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Stát
|-
| employee.forin.pnu
| reg_cssz_pcode
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Postcode
|-
| employee.forin.num
| reg_cssz_cislo
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Číslo popisné
|-
| employee.forin.str
| reg_cssz_ulice
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Ulice
|-
| employee.forin.sec
| sektor_pojisteni
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Sektor/účel
|-
| employee.forin.id
| reg_cssz_cpoj
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Číslo pojištění
|-
| employee.forin.cur
| spec_ciz_nositele
| Cizinci → Identifikace posledního cizozemského nositele pojištění → Specifikace
|-
| employee.nocitizen.permto
| prac_povol.pr_pov_do
| Pracovní povolení → Pracovní oprávnění do
|-
| employee.nocitizen.permfro
| prac_povol.pr_pov_od
| Pracovní povolení → Pracovní oprávnění od
|-
| employee.nocitizen.permid
| prac_povol.opravneni_cislo
| Pracovní povolení → Povolení číslo
|-
| employee.nocitizen.issue
| prac_povol.opravneni_vydal
| Pracovní povolení → Povolení vydala
|-
| employee.nocitizen.permtype
| prac_povol.druh_opravneni
| Pracovní povolení → Druh pracovního oprávnění
|-
| employee.nocitizen.freeacc
| prac_povol.doc_ochrana
| Pracovní povolení → Volný přístup na trh práce
|-
| employee.forinreg.state
| stat_pravni_prisl
| Cizinci → Příslušnost k cizím právním předpisům
|-
| employee.forinreg.juris
| pracovnici.e101
| Mzdové údaje → A1
|-
| employee.pens.early / employee.pens.reducedAge
| pracovnici.predcas_star_duch
| Osobní údaje → Starobní důchod
|-
| employee.fact.highedu
| vzdelani.stupen
| Vzdělání → Stupeň
|-
| employee.job.fro
| prac_pom.datum_skut_nast
| Pracovní poměr → Datum skutečného nástupu
|-
| employee.job.sme
| prac_pom.maly_rozsah
| Pracovní poměr → Zaměstnání malého rozsahu
|-
| employee.job.rel
| prac_pom.druh_cinnosti
| Pracovní poměr → Druh činnosti
|-
| employee.job.oid
| prac_pom.ic_prav_vztahu
| Pracovní poměr → ID pojistného vztahu
|}

== Poznámky ==

* Identifikace zaměstnance probíhá podle osobního čísla zaměstnance.
* Import podporuje pouze soubory ve formátu XML REGZEC.
* Prázdné hodnoty v XML nepřepisují existující údaje v databázi.
* Před importem doporučujeme ověřit správnost a úplnost vstupního XML souboru.

Úlohy (KS aplikační server)

2026-09-18T08:58:30Z

Milan: /* 005 – Přenos uchazečů z LMC */

''Úlohy (KS aplikační server)'' - portfolio úloh, které může vykonávat [[KS aplikační server]]. Nastavení (parametrizaci) úloh provádějte prostřednictvím aplikace [[AS Seance Manager]].

* '''[[E-mailové notifikace (Rozšíření aplikace)]]'''

{|class="wikitable sortable" border="1" cellpadding="3" cellspacing="0"
|+ Portfolio úloh aplikačního serveru KS
! <center>Kód</center>
! <center>Název</center>
! <center>Poznámka</center>
|-
| 001 || Výplatní lístky ||
|-
| 002 || Hodnocení zaměstnanců ||
|-
| 003 || Vyhodnocení školicí akce ||
|-
| 004 || Ukončení pracovních poměrů ||
|-
| 005 || Přenos uchazečů z LMC || Zákaznická.
|-
| 007 || Přenos nákladových transakcí do AX || Zákaznická.
|-
| 008 || Přenos platebních příkazů mzdových transakcí do AX || Zákaznická.
|-
| 009 || Přenos evidenčních údajů zaměstnanců do AX || Zákaznická.
|-
| 010 || Test e-mailu || Zůstává trvale zapnuto.
|-
| 013 || Přenos do ATTIS || Zákaznická.
|-
| 014 || Přenos do SAP || Zákaznická.
|-
| 018 || Výstup zaměstnanců ||
|-
| 019 || Ukončení zkušební doby ||
|-
| 034 || Končí platnost osvědčení vzdělávací aktivity ||
|-
| 036 || Končí platnost lékařských prohlídek podřízeným ||
|-
| 063 || [[Požadavky - výzva uživateli (Úloha AS 63)|Požadavky - výzva uživateli]] || [[Rozšíření aplikace]]
|-
| 064 || Přenos do AX || Zákaznická.
|-
| 065 || Ukončení zkušební doby podřízeného ||
|-
| 066 || Nástup nového podřízeného zaměstnance ||
|-
| 067 || Ukončení doby určité ||
|-
| 069 || Výpis z insolvenčního rejstříku || [[Insolvenční rejstřík]]
|-
| 073 || '''[[Webová služba KSWebAPI (Úloha AS 73)|Webová služba KSWebAPI]]''' || [[Rozšíření aplikace]]
|-
| 074 || [[Blahopřání k narozeninám (Úloha AS 74)|Blahopřání k narozeninám]] || Zákaznická
|-
| 075 || [[Distribuce ELDP (Úloha AS 75)|Distribuce ELDP]] ||
|-
| 076 || Synchronizace kalendáře || [[Export rozdílových souborů ICS (Kalendář KS portál)]]
|-
| 078 || [[Odesílání vystavených dokumentů e-mailem (SK) (Úloha AS 78)|Odesílání vystavených dokumentů e-mailem (SK)]] ||
|-
| 079 || Nevyplněny ujeté kilometry u služeních cest (zaměstnanec) ||
|-
| 080 || Nevyplněny ujeté kilometry u služebních cest (e-mail) ||
|-
| 081 || [[Odesílání hromadného příkazu (Úloha AS 81)|Odesílání hromadného příkazu]] ||
|-
| 085 || Ukončení pracovních poměrů (Úloha AS 85)|Ukončení pracovních poměrů || [[Rozšíření aplikace]]
|-
| 088 || [[Import souborů z výroby do KS docházky (Úloha AS 88)|Import souborů z výroby do KS docházky]] ||
|-
| 089 || Synchronizace dat do [[GIRITON]] ||
|-
| 093 || Automatické uzavírání požadavků || [[Automatické uzavření požadavku po stanovené době]]
|-
| 100 || Obecná notifikace || odesílá emaily z desktop a portálu
|-
| 101 || [[Odesílání dokumentů vystavených e-mailem (Úloha AS 101)|Odesílání dokumentů vystavených e-mailem]]
|}

== Úlohy řízené časem ==
=== Varianta přesný čas ===
U některých úloh, které se mají spustit v určitém čase resp. spouštět opakovaně, je k dispozici prvek pro nastavení časových intervalů.

[[Image: ASSeanceManager-nastaveni-ulohy-napr-018-spustit-okamzite.png]]
[[Image: ASSeanceManager-nastaveni-ulohy-napr-018-spustit-v-case.png]]

* '''Spustit okamžitě''' - pokud k tomu není nastavena perioda, je úloha spuštěna jednou, v řádu sekund po restartu AS.
* '''Spustit v čase''' - den a konkrétní čas
* '''Perioda spuštění''' - číselná hodnota
* '''Typ intervalu''' - výběr ''vteřina/minuta/hodina/Den/Týden/Měsíc/Čtvrtletí/Pololetí/Rok''
* '''Od kdy odesílat''' - omezení denního času odesílání notifikací
* '''Do kdy odesílat''' - omezení denního času odesílání notifikací

''Příklad''

Perioda = 2, typ = Hodina, Spustit v čase = 1.5.2017 13:20:00
: Bude docházet ke spouštění co 2 hodiny, tj. první spuštění v 13:20:00 hod, další 15:20:00, 17:20:00, ...
Informace o příštím spuštění je uvedena u dané úlohy na hlavní obrazovce a dále v detailnějším seznamu úloh.

Spustit v čase - pokud je hodnota v budoucnu, dojde ke spuštění v tomto budoucím čase. Pokud je hodnota již v minulosti, dojde ke spuštění po připočtení jednoho nebo více násobků určené periody, až se bude jednat o realizovatelný okamžik.


=== Varianta jen perioda ===
Jiným prvkem pro nastavení periody spuštění má název ''Priorita (s)''.
[[Image: ASSeanceManager-nastaveni-ulohy-napr-036-priorita-ulohy.png]]

Zde se zadává perioda automatického spouštění - číselná hodnota představující čas v sekundách. V případě deaktivování úlohy systém obvykle automaticky mění hodnotu na zápornou - nereálnou.

== 001 - Výplatní lístky ==
Svázáno s akcí v KS mzdy PROFi přes NetBridge. Konvertuje výplatní lístek do PDF. Zamyká jej případně heslem. Pak jej KS-AS odesílá. Po stisku tlačítka v KS mzdy PROFi v nejbližším tisku KS-AS odejde. Interval tiku nastavený prioritou.

''Parametry'':
[[Image: ASSeanceManager-uloha-001-nastaveni.png|550px]]
[[Image: ASSeanceManager-uloha-001.png|50px]]
* '''''Priorita úlony''''' (s - sekundy)
* '''''Default Credentials'''''
Souvisí s přenosem e-mailem. Určuje se tím režim v rámci odesílání e-mailů bez autentizace.
:: 1 - Je-li nastavena hodnota 1, pak se SMTP serveru předá i výchozí pověření. Může být potřeba nastavit např. u MS Exchange serveru. 
:: 0 - Je-li nastavena hodnota 0, pak se SMTP serveru nepředá žádné pověření - výchozí stav u většiny konfigurací SMTP serverů.

== 002 - Hodnocení zaměstnanců ==
Svázáno s akcí v C/S aplikaci přes DB. KS-AS jenom odesílá prostý text s informací. Po stisku tlačítka v C/S v nejbližším tiku KS-AS odejde. Interval tiku je nastavený prioritou.

''Parametry'':
* '''''Priorita úlony''''' (s)

== 003 - Vyhodnocení školicí akce ==
Svázáno s akcí v C/S aplikaci přes NetBridge. KS-AS odesílá informační text. Po stisku tlačítka v C/S odejde v nejbližším tiku přes KS-AS. Interval tisku je nastavený prioritou.

Notifikace je zasílána jen těm lidem, kteří se školení zúčastnili a zároveň nevyhodnotili ještě ani jednu otázku.

''Parametry'':
* '''''Priorita úlony''''' (s)
* '''''Kolik dní zasílat''''' - jak dlouho po ukončené vzdělávací akci mají odcházet žádosti o vyhodnocení (s ohledem na výše uvedenou podmínku o účasti a dosavadního nevyhodnocení)

== 004 - Ukončení pracovních poměrů ==
''Parametry'':
* '''''Priorita úlony''''' (s)

== 005 – Přenos uchazečů z LMC ==

- Automaticky se přenášejí údaje o uchazečích z Flexidotazníku LMC do databáze aplikace KS mzdy. 
- Přenos dat je realizován prostřednictvím externí webové služby LMC pomocí HTTPS POST rozhraní. 
- Webová služba poskytuje data ve formátu XML. 
- '''''Struktura XML může být pro jednotlivé zákazníky upravena individuálně. Z tohoto důvodu může být nutné provést mapování číselníků a datových položek mezi systémem LMC a aplikací KS Mzdy v rámci konkrétního zákaznického řešení.'''''

''Parametry:''
* '''''Url - Adresa webové služby LMC'''''
* '''''Login uživatele - Přihlašovací jméno klienta'''''
* '''''Heslo uživatele - Přihlašovací heslo klienta'''''
* '''''Defaultní čas od - Datum a čas, od kterého se standardně začínají načítat data uchazečů'''''
* '''''Opakovat od - Volitelné datum začátku období pro opakované stažení dat'''''
* '''''Opakovat do - Volitelné datum konce období pro opakované stažení dat'''''

''Opakované stažení dat:''

Parametry "Opakovat od" a "Opakovat do" slouží k ručnímu opakování přenosu dat za zadané období. Po jejich vyplnění budou načtena data uchazečů, která byla v externím systému vytvořena nebo změněna v uvedeném datovém rozsahu.

== 007 – Přenos nákladových transakcí do AX ==

Vystavuje se webová WCF služba na portu 9001. Tato služba má metodu, po jejímž zavolání z externího systému převede data nákladových transakcí do MS Dynamics.
Parametry:
* '''''Priorita úlohy (s)'''''
* '''''Den v měsíci'''''

== 008 – Přenos platebních příkazů mzdových transakcí do AX ==

- Vystavuje se webová WCF služba na portu 9001. Tato služba má metodu, po jejímž zavolání z externího systému převede data platebních příkazů mzdových transakcí do MS Dynamics.
''Parametry:''
* '''''Priorita úlohy (s)'''''
* '''''Den v měsíci'''''

== 009 – Přenos evidenčních údajů zaměstnanců do AX ==

Vystavuje se webová WCF služba na portu 9001. Tato služba má metodu, po jejímž zavolání z externího systému převede data evidenčních údajů zaměstnanců do MS Dynamics.
''Parametry:''
* '''''Priorita úlohy (s)'''''
* '''''Hodina ve dni'''''

== 010 – Test e-mailu ==
Zůstává trvale zapnuto. Svázano s akcí v KS mzdy PROFi přes NetBridge. KS-AS odesílá. Po stisku tlačítka v KS mzdy PROFi v nejbližším tiku KS-AS odejde testovací e-mail. Interval tiku je nastavený prioritou v ASSM.
''Parametry:''
* '''''Priorita úlohy (s)'''''

== 013 – Přenos do ATTIS ==

Volá se plně časovačem metoda webové služby napsaná v Zdroje.DLL. Toto DLL je interně v KS-AS. Touto akcí dojde k požadovanému přenosu dat.
* '''''Spustit okamžitě / Spustit v čase + čas'''''
* '''''Perioda spuštění''''' – počet intervalů a typ intervalu
* '''''Cílové umístění'''''

== 014 – Přenos do SAP ==

Volá se plně časovačem metoda webové služby napsaná v Zdroje.DLL. Toto DLL je interně v KS-AS. Touto akcí dojde k požadovanému přenosu dat.
* '''''Spustit okamžitě / Spustit v čase + čas'''''
* '''''Perioda spuštění''''' – počet intervalů a typ intervalu
* '''''Koncový bod služby'''''
* '''''Uživatel služby'''''
* '''''Heslo uživatele'''''
* '''''Jednotka intervalu spuštění'''''
* '''''Počet jednotek'''''
* '''''Čas prvního spuštění'''''

== 018 – Výstup zaměstnanců ==
E-mailová notifikace o zaměstnancích, kteří vystupují ze společnosti (v agendě "Evidence zaměstnanců" se kontroluje položka "Datum výstupu").
Prostřednictvím aplikace KS aplikační server se automaticky odesílají e-mailové notifikace na zadané e-maily příjemců (oddělovačem e-mailů je čárka).

''Parametry:''
* '''''Kolik dnů předem upozorňovat'''''
* '''''Upozornit pouze v daný den'''''
* '''''E-maily příjemců upozornění'''''
* '''''E-mail odesílatele'''''

Pokud tato úloha není dostupná, je potřeba ji aktivovat pomocí [[Rozšíření aplikace]] "Výstup zaměstnanců".

== 019 – Ukončení zkušební doby ==
Automaticky se odesílají e-mailové notifikace na zadané e-mail(y) příjemců. Stačí nastavit první spuštění, perioda, časové období během dne, kolik dnů předem upozorňovat a příjemci
Parametry:
* '''''Spustit okamžitě / Spustit v čase + čas'''''
* '''''Perioda spuštění''''' – počet intervalů a typ intervalu
* '''''Časové období během dne, od kdy do kdy odesílat'''''
* '''''Kolik dnů předem upozorňovat'''''
* '''''E-maily příjemců upozornění'''''

== 034 – Končí platnost osvědčení vzdělávací aktivity ==
Posílá se seznam těch, kterým končí platnost osvědčení vzdělávací aktivity do 14 dnů. Automaticky se odesílají e-mailové notifikace přímým nadřízeným. E-maily se zjistí z databáze KS mzdy PROFi. Stačí nastavit prioritu. E-maily se posílají napevno v denní době mezi 23:00:00 a 23:59:59. Jako podklad pro odesílání emailových notifikací slouží v desktop aplikaci sestava '''PV002''' ([[Vzdělávání - sestavy]]).

''Parametry:''
* '''''Priorita úlohy (s)'''''

== 036 – Končí platnost lékařských prohlídek podřízeným ==
Tato úloha odesílá seznam zaměstnanců, kterým končí platnost lékařských prohlídek. Automaticky se odesílají e-mailové notifikace přímým nadřízeným, přičemž e-mail adresáta se přebere z kontaktů zaměstnance (E-mail do práce). Budou zasílány notifikace o končících platnostech všech typů lékařských prohlídek, které jsou evidovány v evidenci lékařských prohlídek (Aplikace: KS mzdy; menu: PIS > Lékařská evidence > Evidence lékařských prohlídek; záložka: Plánované).

Notifikace o končících platnostech lékařských prohlídek budou zasílány s předstihem (dny) dle nastaveného parametru v ASSM 'Kolik dnů předem informovat'.

''Parametry:''
* '''''Vyloučit mimoevidenční stav'''''
* '''''Kolik dnů předem informovat'''''

== 064 – Přenos do AX ==

Volá se plně časovačem metoda webové služby napsaná v Zdroje.DLL. Toto DLL je interně v KS-AS. Touto akcí dojde k požadovanému přenosu dat.

''Parametry:''
Spustit okamžitě / Spustit v čase + čas
* '''''Perioda spuštění''''' – počet intervalů a typ intervalu
* '''''Uživatelské jméno'''''
* '''''Heslo'''''
* '''''Konfigurační soubor s cestou'''''
* '''''Umístění logů'''''
* '''''Token'''''
* '''''ID podniků'''''

== 065 – Ukončení zkušební doby podřízeného ==
Automaticky se odesílají e-mailové notifikace na emaily přímých nadřízených. Stačí nastavit první spuštění, perioda, časové období během dne, kolik dnů předem upozorňovat.

''Parametry:''
* '''''Priorita úlohy (s)'''''
* '''''Časové období během dne, od kdy do kdy odesílat'''''

== 066 – Nástup nového podřízeného zaměstnance ==
- Automaticky se odesílají e-mailové notifikace na emaily přímých nadřízených. Stačí nastavit první spuštění, perioda, časové období během dne, kolik dnů předem upozorňovat.

''Parametry:''
* '''''Kolik dnů předem upozorňovat'''''

== 067 – Ukončení doby určité ==
- Automaticky se odesílají e-mailové notifikace na zadané e-mail(y) příjemců. Stačí nastavit první spuštění, perioda, časové období během dne, kolik dnů předem upozorňovat a příjemce.

''Parametry:''
* '''''Kolik dnů předem upozorňovat'''''
* '''''E-maily příjemců upozornění'''''

== 078 - Odesílání vystavených dokumentů e-mailem (SK) ==
* Možnost odeslat také dokument MK 118 (Vyhlásenie o poukázaní podielu zaplatenej dane z príjmov fyzickej osoby). Pro odesílání tohoto dokumentu musí být doplněn výčet dokumentů v parametru AS "Druhy dokumentů" o číslo sestavy MK 118.

== 079 - Nevyplněny ujeté kilometry u služebních cest (zaměstnanec) ==
Notifikace bude odesílat na e-maily zaměstnanců nevyplněné kilometry za období v rozsahu prvního až posledního dne aktuálního měsíce. Datum odeslání notifikace (např. 25 den v měsíci) bude nastaven intervalem spouštění dané úlohy.

== 080 - Nevyplněny ujeté kilometry u služebních cest (e-mail) ==
Na zadaný e-mail v parametrech úlohy bude notifikace odesílat sestavu s nevyplněnými kilometry zaměstnanců, za období v rozsahu prvního až posledního dne aktuálního měsíce.

Notifikace je nastavena tak, že k odeslání dojde poslední pracovní den v měsíci (jsou zohledněny víkendové dny a svátky), přičemž den odeslání je ještě možno upravit nastavením parametru '''''Kolik dnů předem informovat'''''. Pokud bude zmíněný parametr vyplněn kladnou nenulovou hodnotou, dojde k dřívějšímu odeslání o zadaný počet dnů, než poslední pracovní den měsíce.

U této úlohy musí být nastaven interval spouštění úlohy '''s periodou 1 den''', protože skutečný den odeslání se potom dopočítává aplikační logikou.

== 085 - Ukončení pracovních poměrů ==
E-mailová notifikace o zaměstnancích, kterým končí pracovní poměr (v agendě "Pracovní poměry" se kontroluje položka "Ukončení pracovního poměru").
Pokud je vyplněn parametr "E-maily příjemců upozornění", budou se odesílat notifikace na zadané e-maily v tomto parametru (oddělovačem e-mailů je čárka). Pokud tento parametr nebude vyplněn, odesílají se notifikace přímým nadřízeným.

''Parametry:''
* '''''Kolik dnů předem upozorňovat'''''
* '''''Upozornit pouze v daný den'''''
* '''''E-maily příjemců upozornění'''''
* '''''E-mail odesílatele'''''

Pokud tato úloha není dostupná, je potřeba ji aktivovat pomocí [[Rozšíření aplikace]] "Ukončení pracovních poměrů".

== 100 - Obecná notifikace ==
V seznamů zpráv této úlohy se zobrazují notifikace odesílané aplikacemi KS portál a KS mzdy, které se odesílají prostřednictvím AS.

== Odkazy ==
* [[AS Seance Manager]]
* [[KS aplikační server]]
* SELECT * FROM cis_notifikaci; SELECT * FROM zpravy; SELECT * FROM zpr_notif;

Konfigurace (KS webAPI)

2026-06-18T07:01:44Z

Milan: /* Příklad */

Základní konfigurace webové služby ''KS webAPI'' se provádí v konfiguračním souboru ''ASServer.exe.config'', který je součástí Windows služby [[KS aplikační server]] (AS). V tomto souboru se nastavuje transportní protokol (HTTP/HTTPS), komunikační protokol (SOAP/REST), adresa webové služby (Endpoint), certifikát pro zabezpečení komunikace, atd. Toto nastavení je potřeba pro zpřístupnění webové služby klientské aplikaci.

Nastavení uživatelských účtů a oprávnění k přenášeným údajům se nastavuje v aplikaci [[AS Seance Manager]] (ASSM).

== Konfigurační soubor ==

Konfigurace se provádí v konfiguračním souboru Windows služby [[KS aplikační server]].
* '''''ASServer.exe.config''''' - soubor je uložen v adresáři ''ASServer'', v umístění instance [[KS aplikační server]], které bylo vybráno pro instalaci [[KS aplikační server]].

V konfiguračním souboru je nutné nastavit ''Endpoint'', ''Binding'', ''Behavior'' a ''WebApiType'', případně další nastavení.

== Příklad ==
Níže je uvedena vzorová konfigurace, která využívá zabezpečení s ověřením uživatelského jména na straně klienta a proto je potřeba nastavit certifikát v části '''''<serviceCertificate>'''''

Dále je nutné nastavit, jaký typ API se bude používat. To určuje parametr s klíčem ''WebApiType'' a hodnotou "soap,rest", "rest" nebo "soap".
V případě nevyplnění tohoto parametru bude použito pouze SOAP API.

<pre>
<appSettings>
...
<add key="WebApiType" value="rest" />
...
</appSettings>
</pre>

SOAP a REST lze využívat souběžně.

'''Vzorová konfigurace SOAP'''
<pre>
<system.serviceModel>
<services>
<service name="KSProgram.AS.WCF.KSWebAPI" behaviorConfiguration="KSWebAPIBehavior">
<host>
<baseAddresses>
<add baseAddress="http://localhost:9001/KSAsServer/WebService/WebAPI"/>
</baseAddresses>
</host>

<endpoint address=""
binding="wsHttpBinding"
bindingConfiguration="KSWebAPIBinding"
contract="KSProgram.AS.WCF.IKSWebAPI" />
</service>
</services>
<bindings>
<wsHttpBinding>
<binding name="KSWebAPIBinding">
<security mode="Message">
<message clientCredentialType="UserName" />
</security>
<readerQuotas maxDepth="2147483647" maxStringContentLength="2147483647"
maxArrayLength="2147483647"
maxBytesPerRead="2147483647" maxNameTableCharCount="2147483647" />
</binding>
</wsHttpBinding>
</bindings>

<behaviors>
<serviceBehaviors>
<behavior name="KSWebAPIBehavior">
<serviceMetadata httpGetEnabled="true"/>
<serviceDebug includeExceptionDetailInFaults="true"/>
<serviceCredentials>
<userNameAuthentication userNamePasswordValidationMode="Custom"
customUserNamePasswordValidatorType="KSProgram.AS.WCF.PasswordValidator, WCFLib"/>
<serviceCertificate findValue="WebAPI_cert" storeLocation="LocalMachine"
storeName="My" x509FindType="FindBySubjectName"/>
</serviceCredentials>
</behavior>
</serviceBehaviors>
</behaviors>
</system.serviceModel>
</pre>

'''Vzorová konfigurace REST'''
<pre>
<system.serviceModel>
<services>
<service name="WCFLib.KSWebAPI.RESTApi.KSWebAPIRest" behaviorConfiguration="KSWebAPIBehaviorRest">
<endpoint address="Rest" behaviorConfiguration="webBehavior" binding="webHttpBinding" bindingConfiguration="KSWebAPIBindingRest" contract="WCFLib.KSWebAPI.RESTApi.IKSWebAPIRest"/>
<host>
<baseAddresses>
<add baseAddress="https://localhost:9002/KSAsServer/WebService/WebAPI"/>
</baseAddresses>
</host>
</service>
</services>
<bindings>
<webHttpBinding>
<binding name="KSWebAPIBindingRest" maxBufferPoolSize="2147483647" maxReceivedMessageSize="2147483647" maxBufferSize="2147483647" sendTimeout="00:10:00" receiveTimeout="00:10:00" crossDomainScriptAccessEnabled="false">
<readerQuotas maxDepth="2147483647" maxStringContentLength="2147483647" maxArrayLength="2147483647" maxBytesPerRead="2147483647"/>
<security mode="Transport">
</security>
</binding>
</webHttpBinding>
</bindings>
<behaviors>
<serviceBehaviors>
<behavior name="KSWebAPIBehaviorRest">
<serviceMetadata httpGetEnabled="false" httpsGetEnabled="true"/>
<serviceDebug includeExceptionDetailInFaults="true"/>
<serviceCredentials>
<serviceCertificate findValue="7fdc925e54075d60a48939f24c1eec7d7052d3b0" storeLocation="LocalMachine" storeName="My" x509FindType="FindByThumbprint" />
</serviceCredentials>
</behavior>
</serviceBehaviors>
<endpointBehaviors>
<behavior name="webBehavior">
<webHttp defaultOutgoingResponseFormat="Json"/>
</behavior>
</endpointBehaviors>
</behaviors>
<standardEndpoints>
<webScriptEndpoint>
<standardEndpoint crossDomainScriptAccessEnabled="true">
</standardEndpoint>
</webScriptEndpoint>
</standardEndpoints>
<serviceHostingEnvironment aspNetCompatibilityEnabled="true"/>
</system.serviceModel>
</pre>

== AS Seance Manager - Úloha č. 73 ==
[[AS Seance Manager]] (dále ASSM) je aplikace, která byla nainstalována společně s AS a slouží ke správě AS (spouštění instancí AS, konfigurace úloh, kontrola stavu úloh, atd.). ASSM je umístěn v adresáři, který byl vybrán pro instalaci AS - '''''...\KS-AS\ASSeanceManager\ASSeanceManager.exe'''''.

V případě KS webAPI je zde typ úlohy
* '''''Webová služba KSwebAPI''''' (Kód = 73) v seznamu ''Typ úlohy''. V části ''Nastavení webové služby'' se provádí nastavení uživatelských účtů pro autentizaci.

ASSM (soubor '''ASSeanceManager.exe''') je nutné spouštět jako '''správce'''.

[[Soubor:Nastaveni-as-seancemanager-webapi.jpg|450px]]

===Správa uživatelů===
V [[AS Seance Manager]] se provádí nastavení uživatelských účtů pro autentizaci. V sekci ''''Nastavení webové služby'''' se po stisku tlačítka ''Správa uživatelů'' otevře příslušné okno.

[[Image: KSwebAPI-Konektor Advanto-SpravaUzivatelu.png|400px]]


=== Oprávnění na položky ===

V [[AS Seance Manager]] se provádí nastavení oprávnění ''''Čtení'''' a ''''Zápis'''' na položky pro jednotlivé skupiny položek. V sekci ''''Nastavení webové služby'''' se po stisku tlačítka ''''Přístupová práva'''' otevře příslušné okno.

[[Soubor:Pristupova-prava-polozky-ks-webapi.jpg|350px]]

== Odkazy ==
* [[Správa (KS webAPI)]]

WebAPI Import průchodů

2026-05-05T12:14:32Z

Milan: /* Informace pro správce KS webAPI */

WebAPI Import průchodů

2026-05-05T12:11:42Z

Milan:

WebAPI Import průchodů

2026-05-05T12:10:49Z

Milan: /* Popis */

Položky (KS webAPI)

2026-05-05T12:01:36Z

Milan:

V tabulce jsou uvedeny obecné skupiny údajů (a údaje), které se mohou lišit v závislosti na konkrétním uživateli. Dále se seznam liší dle varianty KS webAPI (Free, Reader, Writer).

'''Vždy je tedy nutné vygenerovat vlastní HTML dokumentaci s popisem datových struktur skupin údajů, a jí se řídit.''' Vygenerování HTML dokumentace se provede v aplikaci ''KS mzdy'' (menu: Systém > Web API), viz [[Generování (KS webAPI)]].

{|class="wikitable sortable" border="1" cellpadding="3" cellspacing="0"
|- style="background-color: #eeeeee"
!'''Skupiny údajů'''
!'''Čtení'''
!'''Zápis'''
!'''Význam'''
|-
| [[WebAPI Pracovní pomůcky|PracovniPomucky]]
| Ano
| Ano
| Přiřazení prac. pomůcek zaměstnancům
|-
| [[WebAPI Pomucky ciselnik|PomuckyCiselnik]]
| Ano
| Ano
| Číselník pracovních pomůcek
|-
| [[WebAPI Pomucky na sklade|PomuckyNaSklade]]
| Ano
| Ne
| Pracovní pomůcky na skladě
|-
| [[WebAPI Zpracované mzdy |ZpracovaneMzdy ]]
| Ano
| Ne
| Mzdy zaměstnanců a odvody podniku.
|-
| [[WebAPI Jazykové znalosti |JazykoveZnalosti ]]
| Ano
| Ano
| Jazykové znalosti zaměstnanců
|-
| [[WebAPI Dovolená|Dovolena ]]
| Ano
| Ne
| Dovolená v hodinách (legislativa 2021)
|-
| [[WebAPI Divize|Divize ]]
| Ano
| Ano
| Číselník divizí
|-
| [[WebAPI Benefitní volno|BenefitniVolno ]]
| Ano
| Ne
| Benefitní volna zaměstnanců
|-
| [[WebAPI Zpracovaná docházka|ZpracovanaDochazka ]]
| Ano
| Ano
| Sesumovaná docházková data pro mzdy
|-
| [[WebAPI Platby |Platby ]]
| Ano
| Ano
| Platby zaměstanců
|-
| [[WebAPI Podpisové vzory |PodpisoveVzory ]]
| Ano
| Ne
| Podpisové vzory
|-
| [[WebAPI Pracovní místa|PracovniMista ]]
| Ano
| Ano
| Číselník pracovních míst
|-
| [[WebAPI Atributy pracovních míst |PracovniMistaAtributy]]
| Ano
| Ano
| Vlastnosti přiřazené pracovním místům
|-
| [[WebAPI Pracovní poměry |PracovniPomery ]]
| Ano
| Ano
| Pracovněprávní poměry zaměstnanců
|-
| [[WebAPI Pracovní postup|PracovniPostup ]]
| Ano
| Ne
| Pracovní postup zaměstnanců
|-
| [[WebAPI Pracovní povolení|PracovniPovoleni ]]
| Ano
| Ano
| Pracovní povolení cizinců
|-
| Priplatky || Ano || Ano || [[Příplatky]]
|-
| [[WebAPI Kmenové údaje|KmenoveUdaje ]]
| Ano
| Ano
| Evidence zaměstnanců
|-
| [[WebAPI Rodinní příslušníci|RodinniPrislusnici ]]
| Ano
| Ano
| Rodinní příslušníci
|-
| [[WebAPI Rodinní příslušníci slevy|RodinniPrislusniciSlevy ]]
| Ano
| Ano
| Daňové zvýhodnění rodinných příslušníků
|-
| [[WebAPI Skupiny středisek |SkupinyStredisek ]]
| Ano
| Ano
| Číselník skupiny středisek
|-
| [[WebAPI Služební cesty výdaje |SluzebniCestyVydaje ]]
| Ano
| Ne
| Cestovní výdaje/náhrady
|-
| [[WebAPI Služební cesty|SluzebniCesty ]]
| Ano
| Ne
| Služební cesty
|-
| [[WebAPI Služební cesty vyučtování|SluzebniCestyVyuctovani ]]
| Ano
| Ne
| Vyúčtování služebních cest
|-
| [[WebAPI Služební cesty zálohy|SluzebniCestyZalohy ]]
| Ano
| Ne
| Zálohy na služební cesty
|-
| [[WebAPI Střediska|Strediska ]]
| Ano
| Ano
| Číselník středisek
|-
| [[WebAPI Systemizace pracovních míst|SystemizacePracovnichMist]] || Ano || Ne || Systemizace pracovních míst
|-
| [[WebAPI Kontakty|Kontakty]]
| Ano
| Ano
| Kontakty (telefonní čísla, emaily)
|-
| [[WebAPI Vzdělání|Vzdelani ]]
| Ano
| Ano
| Dosažené vzdělání zaměstnanců
|-
| [[WebAPI KumulacePoVyuctovani|KumulacePoVyuctovani]] || Ano || Ne || Měsíční kumulace a další údaje po vyúčtování za os.číslo.
|-
| [[WebAPI MimoevidencniStavy|MimoevidencniStavy]] || Ano || Ne || [[Mimoevidenční stav]]
|-
| [[WebAPI Poznamky|Poznamky]] || Ano || Ne || Poznámky
|-
| [[WebAPI CiselnikJazyku|CiselnikJazyku]] || Ano || Ne || Číselník jazyků
|-
| [[WebAPI CiselnikStupnuVzdelani|CiselnikStupnuVzdelani]] || Ano || Ne || Číselník stupňů vzdělání
|-
| [[WebAPI iTutor_Courses|iTutor_Courses]] || Ano || Ano || iTutor - Platné kurzy

|-
| [[WebAPI Import průchodů|ImportPruchodu]] || Ne || Ano || Import průchodů
|-
| [[WebAPI Týdenní rozvrhy|TydenniRozvrhy]] || Ano || Ano || Číselník [[Týdenní rozvrhy]]
|-
| [[DataVyroby (KS webAPI)|DataVyroby]] || Ano || Ano || Data výroby
|-
| PrukazyZamestnanci || || ||
|-
| PrukazyVzdelavani || || ||
|-
| WorkflowNepritomnostiVsechnyTypy || || || db tab workfl_absence; možno aplikovat boolean Option s názvem ''PozadavkyPlatnyZaznam'' - pokud je aplikován, budou vráceny jen poslední platné záznamy z wkfl. Pokud nebude aplikováno, tak se ke každému požadavku vrátí tolik záznamů, kolika stupni schvalování ten který požadavek prošel. Pokud je potřeba získat data jen o schválených požadavcích, nastavte podmínku SysStav='o'. (hd 61207)
|-
| PouzitaOsobniCisla || || || Seznam použitých osobních čísel (tato již nemohou být použita při zakládání nových zaměstnanců).
|-
| [[DokumentyVystavene]] || Ano || Ne || [[Dokumenty vystavené]]
|}

== Odkazy ==
* [[Klient (KS webAPI)]]

WebAPI Import průchodů

2026-05-05T11:55:06Z

Milan:

WebAPI Import průchodů

2026-05-05T11:54:25Z

Milan: /* Příklad 1 */

WebAPI Import průchodů

2026-05-05T11:53:53Z

Milan: /* Příklad 2 */

WebAPI Import průchodů

2026-05-05T11:53:04Z

Milan: /* Popis */

WebAPI Import průchodů

2026-05-05T11:48:52Z

Milan: /* Zápis pomocí WebAPI */

=Zápis pomocí WebAPI=
{|border="1" cellpadding="3" cellspacing="0"
|- style="background-color: #eeeeee"
|'''Údaj'''
|'''Datový typ'''
|'''Povinné pole'''
|'''Význam'''

|-
| IdZaznamu
| integer
| Ne
| Jednoznačná identifikace záznamu v externím systému.
|-
| OsCislo
| decimal(10,0)
| Ano
| Osobní číslo zaměstnance.
|-
| CisloPom
| smallint
| Ne
| Číslo pracovního poměru.
|-
| Kod
| char(10)
| Ano
| Docházkový kód externího systému.
|-
| Cas
| char(17)
| Ano
| Datum a čas ve formátu yyyy-MM-dd hhmmss.
|-
| NazevZarizeni
| char(50)
| Ne
| Název zařízení externího systému.
|}

=Popis=

==Options==

===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 1====
<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 2 ====
<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>

== Odkazy ==
* [[KS webAPI]]

WebAPI Import průchodů

2026-05-05T11:47:57Z

Milan: založena nová stránka s textem „=Zápis pomocí WebAPI= {|border="1" cellpadding="3" cellspacing="0" |- style="background-color: #eeeeee" |'''Údaj''' |'''Datový typ''' |'''Povinné pole''' |'''Význam''' |- | IdZaznamu | integer | Ne | Jednoznačná identifikace záznamu v externím systému. |- | OsCislo | decimal(10,0) | Ano | osobní číslo pracovníka |- | CisloPom | smallint | Ne | Číslo pracovního poměru. |- | Kod | char(10) | Ano | Docházkový kód externího s…“

=Zápis pomocí WebAPI=
{|border="1" cellpadding="3" cellspacing="0"
|- style="background-color: #eeeeee"
|'''Údaj'''
|'''Datový typ'''
|'''Povinné pole'''
|'''Význam'''

|-
| IdZaznamu
| integer
| Ne
| Jednoznačná identifikace záznamu v externím systému.
|-
| OsCislo
| decimal(10,0)
| Ano
| osobní číslo pracovníka
|-
| CisloPom
| smallint
| Ne
| Číslo pracovního poměru.
|-
| Kod
| char(10)
| Ano
| Docházkový kód externího systému.
|-
| Cas
| char(17)
| Ano
| Datum a čas ve formátu yyyy-MM-dd hhmmss.
|-
| NazevZarizeni
| char(50)
| Ne
| Název zařízení externího systému.
|}

=Popis=

==Options==

===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 1====
<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 2 ====
<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>

== Odkazy ==
* [[KS webAPI]]

WebAPI Systemizace pracovních míst

2026-02-17T08:37:19Z

Milan: /* Čtení pomocí WebAPI */

''Systemizace pracovních míst.''

=Čtení pomocí WebAPI=
{|border="1" cellpadding="3" cellspacing="0"
|- style="background-color: #eeeeee"
|'''Údaj'''
|'''Datový typ'''
|'''Význam'''
|-
|IdPracmist || integer || Identifikátor prvku v systemizaci (prac. místa, atd..).
|-
|CisPracmist || char(12) || Číslo prvku (pracovního místa).
|-
|NazevPracmist || char(120) || Název prvku (pracovního místa).
|-
|IdNadrizeny || integer || Identifikátor nadřízeného prvku - vždy prac. místo.
|-
|CisNadrizeny || char(12) || Číslo nadřízeného prvku (pracovního místa).
|-
|NazevNadrizeny || char(120) || Název nadřízeného prvku (pracovního místa).
|-
|IdSystemizace || integer || Vazba na nejvyšší úroveň - systemizaci podniku.
|-
|VedouciFunkce || char(1) || Zda se jedná o vedoucí pracovní místo (a - ano, n - ne).
|-
|ZamOsCislo || decimal(10,0) || Osobní číslo zaměstnance.
|-
|ZamCisloPom || smallint || Číslo pracovního poměru zaměstnance.
|}

== Komentář ==
* V položce ''VedouciFunkce'' je předávána informace z atributu pracovního místa č. 60 (Vedoucí funkce).
* Položky ''ZamOsCislo'' a ''ZamCisloPom'' jsou doplňkové a slouží k načtení zařazení zaměstnanců na pracovní místo, která jsou platná k aktuálnímu dni. Pomocí Option [[EvidStavZam]] je možno dále omezit načtenou množinu zaměstnanců.

== Odkazy ==
* [[Položky (KS webAPI)]]

EvidStavZam

2026-02-17T08:32:32Z

Milan:

''EvidStavZam'' je [[JsonOptions]] option [[KS webAPI]].
{|border="1" cellpadding="3" cellspacing="0"
|-
! scope="row"| Option
| EvidStavZam
|-
! scope="row"| Metoda
| GetData
|-
! scope="row"| Skupina údajů
| [[KmenoveUdaje]], [[WebAPI_Kontakty|Kontakty]], [[WebAPI_Systemizace_pracovních_míst|SystemizacePracovnichMist]]
|-
! scope="row"| Rozsah
|
0: zaměstnanci po výstupu.
1: aktivní zaměstnanci
2: aktivní zaměstnanci bez mimoevidenčního stavu
3: zaměstnanci v mimoevidenčním stavu
|-
! scope="row"| Popis
| Vrátí zaměstnance s ohledem na evidenční stav.
|}

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

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

== Odkazy ==
* [[JsonOptions]]

Položky (KS webAPI)

2026-02-17T08:02:05Z

Milan:

V tabulce jsou uvedeny obecné skupiny údajů (a údaje), které se mohou lišit v závislosti na konkrétním uživateli. Dále se seznam liší dle varianty KS webAPI (Free, Reader, Writer).

'''Vždy je tedy nutné vygenerovat vlastní HTML dokumentaci s popisem datových struktur skupin údajů, a jí se řídit.''' Vygenerování HTML dokumentace se provede v aplikaci ''KS mzdy'' (menu: Systém > Web API), viz [[Generování (KS webAPI)]].

{|class="wikitable sortable" border="1" cellpadding="3" cellspacing="0"
|- style="background-color: #eeeeee"
!'''Skupiny údajů'''
!'''Čtení'''
!'''Zápis'''
!'''Význam'''
|-
| [[WebAPI Pracovní pomůcky|PracovniPomucky]]
| Ano
| Ano
| Přiřazení prac. pomůcek zaměstnancům
|-
| [[WebAPI Pomucky ciselnik|PomuckyCiselnik]]
| Ano
| Ano
| Číselník pracovních pomůcek
|-
| [[WebAPI Pomucky na sklade|PomuckyNaSklade]]
| Ano
| Ne
| Pracovní pomůcky na skladě
|-
| [[WebAPI Zpracované mzdy |ZpracovaneMzdy ]]
| Ano
| Ne
| Mzdy zaměstnanců a odvody podniku.
|-
| [[WebAPI Jazykové znalosti |JazykoveZnalosti ]]
| Ano
| Ano
| Jazykové znalosti zaměstnanců
|-
| [[WebAPI Dovolená|Dovolena ]]
| Ano
| Ne
| Dovolená v hodinách (legislativa 2021)
|-
| [[WebAPI Divize|Divize ]]
| Ano
| Ano
| Číselník divizí
|-
| [[WebAPI Benefitní volno|BenefitniVolno ]]
| Ano
| Ne
| Benefitní volna zaměstnanců
|-
| [[WebAPI Zpracovaná docházka|ZpracovanaDochazka ]]
| Ano
| Ano
| Sesumovaná docházková data pro mzdy
|-
| [[WebAPI Platby |Platby ]]
| Ano
| Ano
| Platby zaměstanců
|-
| [[WebAPI Podpisové vzory |PodpisoveVzory ]]
| Ano
| Ne
| Podpisové vzory
|-
| [[WebAPI Pracovní místa|PracovniMista ]]
| Ano
| Ano
| Číselník pracovních míst
|-
| [[WebAPI Atributy pracovních míst |PracovniMistaAtributy]]
| Ano
| Ano
| Vlastnosti přiřazené pracovním místům
|-
| [[WebAPI Pracovní poměry |PracovniPomery ]]
| Ano
| Ano
| Pracovněprávní poměry zaměstnanců
|-
| [[WebAPI Pracovní postup|PracovniPostup ]]
| Ano
| Ne
| Pracovní postup zaměstnanců
|-
| [[WebAPI Pracovní povolení|PracovniPovoleni ]]
| Ano
| Ano
| Pracovní povolení cizinců
|-
| Priplatky || Ano || Ano || [[Příplatky]]
|-
| [[WebAPI Kmenové údaje|KmenoveUdaje ]]
| Ano
| Ano
| Evidence zaměstnanců
|-
| [[WebAPI Rodinní příslušníci|RodinniPrislusnici ]]
| Ano
| Ano
| Rodinní příslušníci
|-
| [[WebAPI Rodinní příslušníci slevy|RodinniPrislusniciSlevy ]]
| Ano
| Ano
| Daňové zvýhodnění rodinných příslušníků
|-
| [[WebAPI Skupiny středisek |SkupinyStredisek ]]
| Ano
| Ano
| Číselník skupiny středisek
|-
| [[WebAPI Služební cesty výdaje |SluzebniCestyVydaje ]]
| Ano
| Ne
| Cestovní výdaje/náhrady
|-
| [[WebAPI Služební cesty|SluzebniCesty ]]
| Ano
| Ne
| Služební cesty
|-
| [[WebAPI Služební cesty vyučtování|SluzebniCestyVyuctovani ]]
| Ano
| Ne
| Vyúčtování služebních cest
|-
| [[WebAPI Služební cesty zálohy|SluzebniCestyZalohy ]]
| Ano
| Ne
| Zálohy na služební cesty
|-
| [[WebAPI Střediska|Strediska ]]
| Ano
| Ano
| Číselník středisek
|-
| [[WebAPI Systemizace pracovních míst|SystemizacePracovnichMist]] || Ano || Ne || Systemizace pracovních míst
|-
| [[WebAPI Kontakty|Kontakty]]
| Ano
| Ano
| Kontakty (telefonní čísla, emaily)
|-
| [[WebAPI Vzdělání|Vzdelani ]]
| Ano
| Ano
| Dosažené vzdělání zaměstnanců
|-
| [[WebAPI KumulacePoVyuctovani|KumulacePoVyuctovani]] || Ano || Ne || Měsíční kumulace a další údaje po vyúčtování za os.číslo.
|-
| [[WebAPI MimoevidencniStavy|MimoevidencniStavy]] || Ano || Ne || [[Mimoevidenční stav]]
|-
| [[WebAPI Poznamky|Poznamky]] || Ano || Ne || Poznámky
|-
| [[WebAPI CiselnikJazyku|CiselnikJazyku]] || Ano || Ne || Číselník jazyků
|-
| [[WebAPI CiselnikStupnuVzdelani|CiselnikStupnuVzdelani]] || Ano || Ne || Číselník stupňů vzdělání
|-
| [[WebAPI iTutor_Courses|iTutor_Courses]] || Ano || Ano || iTutor - Platné kurzy

|-
| [[WebAPI Týdenní rozvrhy|TydenniRozvrhy]] || Ano || Ano || Číselník [[Týdenní rozvrhy]]
|-
| [[DataVyroby (KS webAPI)|DataVyroby]] || Ano || Ano || Data výroby
|-
| PrukazyZamestnanci || || ||
|-
| PrukazyVzdelavani || || ||
|-
| WorkflowNepritomnostiVsechnyTypy || || || db tab workfl_absence; možno aplikovat boolean Option s názvem ''PozadavkyPlatnyZaznam'' - pokud je aplikován, budou vráceny jen poslední platné záznamy z wkfl. Pokud nebude aplikováno, tak se ke každému požadavku vrátí tolik záznamů, kolika stupni schvalování ten který požadavek prošel. Pokud je potřeba získat data jen o schválených požadavcích, nastavte podmínku SysStav='o'. (hd 61207)
|-
| PouzitaOsobniCisla || || || Seznam použitých osobních čísel (tato již nemohou být použita při zakládání nových zaměstnanců).
|-
| [[DokumentyVystavene]] || Ano || Ne || [[Dokumenty vystavené]]
|}

== Odkazy ==
* [[Klient (KS webAPI)]]

WebAPI Systemizace pracovních míst

2026-02-17T07:57:53Z

Milan: založena nová stránka s textem „''Systemizace pracovních míst.'' =Čtení pomocí WebAPI= {|border="1" cellpadding="3" cellspacing="0" |- style="background-color: #eeeeee" |'''Údaj''' |'''Datový typ''' |'''Význam''' |- |IdPracmist || integer || Identifikátor prvku v systemizaci (prac. místa, atd..). |- |CisPracmist || char(12) || Číslo prvku (pracovního místa). |- |NazevPracmist || char(120) || Název prvku (pracovního místa). |- |IdNadrizeny || integer || Identifiká…“

EvidStavZam

2026-02-17T07:44:14Z

Milan:

''EvidStavZam'' je [[JsonOptions]] option [[KS webAPI]].
{|border="1" cellpadding="3" cellspacing="0"
|-
! scope="row"| Option
| EvidStavZam
|-
! scope="row"| Metoda
| GetData
|-
! scope="row"| Skupina údajů
| [[KmenoveUdaje]], [[WebAPI_Kontakty|Kontakty]], [[SystemizacePracovnichMist]]
|-
! scope="row"| Rozsah
|
0: zaměstnanci po výstupu.
1: aktivní zaměstnanci
2: aktivní zaměstnanci bez mimoevidenčního stavu
3: zaměstnanci v mimoevidenčním stavu
|-
! scope="row"| Popis
| Vrátí zaměstnance s ohledem na evidenční stav.
|}

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

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

== Odkazy ==
* [[JsonOptions]]

EvidStavZam

2026-02-17T07:42:32Z

Milan:

''EvidStavZam'' je [[JsonOptions]] option [[KS webAPI]].
{|border="1" cellpadding="3" cellspacing="0"
|-
! scope="row"| Option
| EvidStavZam
|-
! scope="row"| Metoda
| GetData
|-
! scope="row"| Skupina údajů
| [[KmenoveUdaje]], [[WebAPI_Kontakty|Kontakty]]
|-
! scope="row"| Rozsah
|
0: zaměstnanci po výstupu.
1: aktivní zaměstnanci
2: aktivní zaměstnanci bez mimoevidenčního stavu
3: zaměstnanci v mimoevidenčním stavu
|-
! scope="row"| Popis
| Vrátí zaměstnance s ohledem na evidenční stav.
|}

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

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

== Odkazy ==
* [[JsonOptions]]

Protokol REST (KS webAPI)

2026-01-28T10:07:59Z

Milan:

<h2>Základní informace</h2>
Komplexní API pro správu dat souhrnů údajů, zaměstnanců a autentizaci uživatelů.
Umožňuje vkládání, aktualizaci, výběr a mazání dat v různých souhrnech údajů na základě
specifikovaných kritérií a operací prováděných prostřednictvím HTTP metod.

<h2 id="access">Autentizace</h2>
<ol>
<li>
Zabezpečení protokolu
Všechny dotazy na API musí být zasílány prostřednictvím zabezpečeného protokolu HTTPS.
</li>
<li>
Přístupová oprávnění
Uživatel musí mít povolení k užívání API, které mu uděluje administrátor. K tomu je nezbytné mít vygenerováno jméno a heslo k API.
</li>
<li>
Autentizace
Pro autentizaci je třeba odeslat na adresu .../KSAsServer/WebService/WebAPI/rest/users/authenticate JSON body s údaji "Username" a "Password". Pokud jsou tyto údaje správné, obdržíte token, který je nutný pro používání API po určitou dobu. Token i jeho platnost jsou vráceny v těle odpovědi.
</li>
<li>
Použití tokenu
Při každém volání API ,mimo autentizaci, je třeba zaslat platný token jedním ze dvou způsobů:

<ul class="ulAktualizace">
<li>
V HEADER

Plain: <pre>Authorization - eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&</pre>

Bearer: <pre>Authorization - Bearer eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&</pre>


</li>
<li>
V URI
<pre>GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/Jmeno/Karel?token=eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&</pre>
</li>
</ul>
Způsob HEADER je preferován před URI.
</li>
</ol>

<h3>Příklad</h3>
Požadavek
<pre>
POST /KSAsServer/WebService/WebAPI/rest/user/authenticate

body:
{
"Username": "jmeno",
"Password": "heslo"
}
</pre>
Odpověď
<pre>
{
"ErrorCode": 0,
"ErrorMessage": null,
"ErrorText": null,
"IsError": false,
"Message": "Created",
"ResponseDatetime": "/Date(1720705997339+0200)/",
"StatusCode": 201,
"Token": "jkdsjflsdfjsdfklsjdflskdfjs.6tQew",
"ValidTo": "/Date(1720715997000+0200)/"
}</pre>

<h1 id="methods">Metody</h1>
Veškerá dokumentakce k metodám: [[Metody (KS webAPI)|Metody]].


<h3>Parametry</h3>
<ul>
<li>
Request header
Content-Type - application/raw
Accept - application/json
</li>
<li>
Items

Vyplňuje se v případě volání metody GET/POST. Předává se seznam [[Položky (KS webAPI)|Položky]], které budou v návratové datové struktuře, na které má uživatel oprávnění.
Jednotlivé položky se oddělují čárkou. Pokud bude v parametru předáno více položek, vrací se návratová datová struktura, která obsahuje všechny
položky uvedené v parametru oddělené čárkami. Pokud bude zadáno více 'Item' v parametru, bude vrácena množina údajů odpovídající průniku
záznamů jednotlivých 'Item'. V případě nezadání paramteru, vrátí všechny položky, na které má uživatel oprávnění.

</li>
<li>[[JsonSearchCriteria]]</li>

<li>[[JsonOptions]]</li>

<li>Token</li>
</ul>

<h3>Proměnné cesty</h3>
<ul>
<li>
ItemGroup

(Required)
Název souhrnu údajů. Parametr {ItemGroup} je nutno zaměnit za reálný souhrn údajů.
Předává se název skupiny údajů (entity) v KS mzdy (např. 'KmenoveUdaje').

</li>
</ul>

<pre>
GET /KSAsServer/WebService/WebAPI/rest/{ItemGroup]/{Item}?token=12asd16a5sda1s32d&Items=Jmeno,Prijmeni,OsCislo,RodneCislo&JsonSearchCriteria=[{ 'Item': 'OsCislo', 'Operator': '<=', 'Value': 100 }]
</pre>


<h2 id="get-method">GET - Vrací data souhrnu údajů podle zadaného názvu souhrnu.</h2>

Povinné parametry:
Token, ItemGroup.


Volitelné parametry:
JsonSearchCriteria, Items, JsonOptions.


<h3>Příklad</h3>
Vrátí data ze souhrnu údajů "KmenoveUdaje", kde OsCislo <= 100.
Požadavek
<pre>GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/?token=12asd16a5sda1s32d&Items=Jmeno,Prijmeni,OsCislo,RodneCislo&JsonSearchCriteria=[{ 'Item': 'OsCislo', 'Operator': '<=', 'Value': 100 }]</pre>
Odpověď
<pre>
{
"Data": "[{\"OsCislo\":36,\"Titul\":null,\"Jmeno\":\"Miroslav\",\"Prijmeni\":\"Nový\",\"RodneCislo\":\"123456789\"...}],
"ErrorCode": 0,
"ErrorMessage": null,
"ErrorText": null,
"IsError": false,
"Message": "Data nalezena.",
"ResponseDatetime": "/Date(1720696754982+0200)/",
"StatusCode": "200"
}</pre>


<h2 id="get-zamestnanec">GET - Vyhledá zaměstnance ze skupiny údajů 'KmenoveUdaje' podle zadaného osobního čísla.</h2>

Povinné parametry:
Token, ItemGroup, aOsCislo.


Volitelné parametry:
JsonSearchCriteria, Items, JsonOptions.


<h3>Příklad</h3>
Vrátí data ze souhrnu údajů "KmenoveUdaje", kde OsCislo = 1. Vrátí sloupce OsCislo, Titul, Jmeno, Primeni, RodneCislo
Požadavek
<pre>GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/1?token=eyJ0eXAiOIiwi7_GcdkwUuTTLDL4&Items=OsCislo, Titul, Jmeno, Prijmeni, RodneCislo</pre>
Odpověď
<pre>
{
"Data": "[{\"OsCislo\":1,\"Titul\":\"Ing.\",\"Jmeno\":\"Pavel\",\"Prijmeni\":\"Hovorka\",\"RodneCislo\":\"581227411\"}]",
"ErrorCode": 0,
"ErrorMessage": null,
"ErrorText": null,
"IsError": false,
"Message": "Data nalezena.",
"ResponseDatetime": "/Date(1720766282434+0200)/",
"StatusCode": "200"
}</pre>


<h2 id="get-item">GET - Vrací data, kde údaj 'Item' má hodnotu 'Value' v rámci zadaného souhrnu údajů 'ItemGroup'.</h2>

Povinné parametry:
Token, ItemGroup, Item, Value.


Volitelné parametry:
JsonSearchCriteria, Items, JsonOptions.


<h3>Příklad</h3>
Vrátí data ze souhrnu údajů "KmenoveUdaje", kde Jmeno = Pavel.
Požadavek
<pre>GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/Jmeno/Pavel?token=eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&</pre>
Odpověď
<pre>
{
"Data": "[{\"OsCislo\":1,\"Titul\":\"Ing.\",\"Jmeno\":\"Pavel\",\"Prijmeni\":\"Hovorka\",\"RodneCislo\":\"581227411\"},
{\"OsCislo\":18,\"Titul\":null,\"Jmeno\":\"Pavel\"...}]",
"ErrorCode": 0,
"ErrorMessage": null,
"ErrorText": null,
"IsError": false,
"Message": "Data nalezena.",
"ResponseDatetime": "/Date(1720766630099+0200)/",
"StatusCode": "200"
}</pre>


<h2 id="post-method">POST - Vkládá data do zadaného souhrnu údajů.</h2>

Metoda InsertData zapisuje data do databáze KS mzdy.


Povinné parametry:
Token, ItemGroup, JsonChangeData (data v těle požadavku).

<h3>Příklad</h3>
Vloží data z body požadavku do souhrnu údajů "KmenoveUdaje".
Požadavek
<pre>
POST /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje?token=eyJ0eXAiOiJKV1QtL2BDA7_GcdkwUuTTLDL4&

Body:
[
{
"IdPodniku": "1",
"Jmeno": "Karel",
"Prijmeni": "Nový",
"RodneCislo": "9710085892",
"MistoNarozeni": "Vsetín",
"StatNar": "CZ",
"StPrisl": "203",
"RodinStav": "2",
"TrCislo": "100",
"PscTrv": "75501",
"MistoTrv": "Vsetín",
"KmenStr": "1",
"DatumNastupu": "2019-01-01"
}
]</pre>
Odpověď
<pre>
{
"Data": "[{\"OsCislo\": 95967,\"IdPodniku\": 1,\"Jmeno\": \"Karel\",\"Prijmeni\": \"Nový\""...}]",
"ErrorCode": 0,
"ErrorMessage": null,
"ErrorText": null,
"IsError": false,
"Message": "Vybraná data byla vložena.",
"ResponseDatetime": "/Date(1720767043837+0200)/",
"StatusCode": "201"
}</pre>


<h2 id="put-method">PUT / UPDATE - Aktualizuje data do zadaného souhrnu údajů.</h2>

Povinné parametry:
Token, ItemGroup, JsonChangeData (data v těle požadavku), JsonSearchCriteria.

<h3>Příklad</h3>
Aktualizuje data v souhrnu údajů "Kontakty", kde Hodnota = 222 222 222, na Hodnota = 111 111 111. 
Požadavek
<pre>
PUT /KSAsServer/WebService/WebAPI/rest/Kontakty?token=eyJ0eXAiOiJKV1QiLaW_GcdkwUuTTLDL4&JsonSearchCriteria=[{ "Item": "Hodnota", "Operator": "=", "Value": "222 222 222"}]

Body:
[
{
"Hodnota": "111 111 111"
}
]</pre>
Odpověď
<pre>
{
"Data": "",
"ErrorCode": 0,
"ErrorMessage": null,
"ErrorText": null,
"IsError": false,
"Message": "Vybraná data byla aktualizována.",
"ResponseDatetime": "/Date(1721030337638+0200)/",
"StatusCode": "204"
}</pre>


<h2 id="delete-method">DELETE - Smaže data v zadaném souhrnu údajů.</h2>

Metoda DELETE smaže data v databázi KS mzdy.


Povinné parametry:
Token, ItemGroup, JsonSearchCriteria.

<h3>Příklad</h3>
Smaže data v souhrnu údajů "Kontakty", kde Hodnota = 111 111 111
Požadavek
<pre>
DELETE KSAsServer/WebService/WebAPI/rest/Kontakty?token=eyJ0eXAiOiJKV1QiLCk&JsonSearchCriteria=[{ "Item": "Hodnota", "Operator": "=", "Value": "111 111 111"}]</pre>
Odpověď
<pre>
{
"Data": "",
"ErrorCode": 0,
"ErrorMessage": null,
"ErrorText": null,
"IsError": false,
"Message": "Vybraná data byla smazána.",
"ResponseDatetime": "/Date(1721030823993+0200)/",
"StatusCode": "204"
}</pre>
</div>

== Odkazy ==
* [[Protokoly (KS webAPI)|Protokoly]]
* [[Klient (KS webAPI)]]

WebAPI Týdenní rozvrhy

2025-11-05T09:49:52Z

Milan:

==Čtení pomocí KS webAPI==
{|border="1" cellpadding="3" cellspacing="0"
|- style="background-color: #eeeeee"
|'''Údaj'''
|'''Datový typ'''
|'''Význam'''
|-
|CisRoz || smallint || Pořadové číslo.
|-
|NazRoz || char(20) || Název rozvrhu.
|-
|PoHod || decimal(4,2) || Délka pracovní doby pro pondělí.
|-
|UtHod || decimal(4,2) || Délka pracovní doby pro úterý.
|-
|StHod || decimal(4,2) || Délka pracovní doby pro středu.
|-
|CtHod || decimal(4,2) || Délka pracovní doby pro čtvrtek.
|-
|PaHod || decimal(4,2) || Délka pracovní doby pro pátek.
|-
|SoHod || decimal(4,2) || Délka pracovní doby pro sobotu.
|-
|NeHod || decimal(4,2) || Délka pracovní doby pro neděli.
|-
|PoZac || char(4) || Začátek směny pro pondělí (počet minut od začátku směny).
|-
|UtZac || char(4) || Začátek směny pro úterý (počet minut od začátku směny).
|-
|StZac || char(4) || Začátek směny pro středu (počet minut od začátku směny).
|-
|CtZac || char(4) || Začátek směny pro čtvrtek (počet minut od začátku směny).
|-
|PaZac || char(4) || Začátek směny pro pátek (počet minut od začátku směny).
|-
|SoZac || char(4) || Začátek směny pro sobotu (počet minut od začátku směny).
|-
|NeZac || char(4) || Začátek směny pro neděli (počet minut od začátku směny).
|-
|Dopocet || char(1) || Indikace provádění automatického dopočtu (n - neprovádět).
|}

==Zápis pomocí KS webAPI==
{|border="1" cellpadding="3" cellspacing="0"
|- style="background-color: #eeeeee"
|'''Údaj'''
|'''Datový typ'''
|'''Povinné pole'''
|'''Význam'''
|-
|CisRoz || smallint || Ano || Pořadové číslo.
|-
|NazRoz || char(20) || Ano || Název rozvrhu.
|-
|PoHod || decimal(4,2) || Ano || Délka pracovní doby pro pondělí.
|-
|UtHod || decimal(4,2) || Ano || Délka pracovní doby pro úterý.
|-
|StHod || decimal(4,2) || Ano || Délka pracovní doby pro středu.
|-
|CtHod || decimal(4,2) || Ano || Délka pracovní doby pro čtvrtek.
|-
|PaHod || decimal(4,2) || Ano || Délka pracovní doby pro pátek.
|-
|SoHod || decimal(4,2) || Ano || Délka pracovní doby pro sobotu.
|-
|NeHod || decimal(4,2) || Ano || Délka pracovní doby pro neděli.
|-
|PoZac || char(4) || Ne || Začátek směny pro pondělí (počet minut od začátku směny).
|-
|UtZac || char(4) || Ne || Začátek směny pro úterý (počet minut od začátku směny).
|-
|StZac || char(4) || Ne || Začátek směny pro středu (počet minut od začátku směny).
|-
|CtZac || char(4) || Ne || Začátek směny pro čtvrtek (počet minut od začátku směny).
|-
|PaZac || char(4) || Ne || Začátek směny pro pátek (počet minut od začátku směny).
|-
|SoZac || char(4) || Ne || Začátek směny pro sobotu (počet minut od začátku směny).
|-
|NeZac || char(4) || Ne || Začátek směny pro neděli (počet minut od začátku směny).
|-
|Dopocet || char(1) || Ne || Indikace provádění automatického dopočtu (n - neprovádět).
|}

== Odkazy ==
* [[Položky (KS webAPI)]]

Položky (KS webAPI)

2025-11-05T09:38:07Z

Milan:

V tabulce jsou uvedeny obecné skupiny údajů (a údaje), které se mohou lišit v závislosti na konkrétním uživateli. Dále se seznam liší dle varianty KS webAPI (Free, Reader, Writer).

'''Vždy je tedy nutné vygenerovat vlastní HTML dokumentaci s popisem datových struktur skupin údajů, a jí se řídit.''' Vygenerování HTML dokumentace se provede v aplikaci ''KS mzdy'' (menu: Systém > Web API), viz [[Generování (KS webAPI)]].

{|class="wikitable sortable" border="1" cellpadding="3" cellspacing="0"
|- style="background-color: #eeeeee"
!'''Skupiny údajů'''
!'''Čtení'''
!'''Zápis'''
!'''Význam'''
|-
| [[WebAPI Pracovní pomůcky|PracovniPomucky]]
| Ano
| Ano
| Přiřazení prac. pomůcek zaměstnancům
|-
| [[WebAPI Pomucky ciselnik|PomuckyCiselnik]]
| Ano
| Ano
| Číselník pracovních pomůcek
|-
| [[WebAPI Pomucky na sklade|PomuckyNaSklade]]
| Ano
| Ne
| Pracovní pomůcky na skladě
|-
| [[WebAPI Zpracované mzdy |ZpracovaneMzdy ]]
| Ano
| Ne
| Mzdy zaměstnanců a odvody podniku.
|-
| [[WebAPI Jazykové znalosti |JazykoveZnalosti ]]
| Ano
| Ano
| Jazykové znalosti zaměstnanců
|-
| [[WebAPI Dovolená|Dovolena ]]
| Ano
| Ne
| Dovolená v hodinách (legislativa 2021)
|-
| [[WebAPI Divize|Divize ]]
| Ano
| Ano
| Číselník divizí
|-
| [[WebAPI Benefitní volno|BenefitniVolno ]]
| Ano
| Ne
| Benefitní volna zaměstnanců
|-
| [[WebAPI Zpracovaná docházka|ZpracovanaDochazka ]]
| Ano
| Ano
| Sesumovaná docházková data pro mzdy
|-
| [[WebAPI Platby |Platby ]]
| Ano
| Ano
| Platby zaměstanců
|-
| [[WebAPI Podpisové vzory |PodpisoveVzory ]]
| Ano
| Ne
| Podpisové vzory
|-
| [[WebAPI Pracovní místa|PracovniMista ]]
| Ano
| Ano
| Číselník pracovních míst
|-
| [[WebAPI Atributy pracovních míst |PracovniMistaAtributy]]
| Ano
| Ano
| Vlastnosti přiřazené pracovním místům
|-
| [[WebAPI Pracovní poměry |PracovniPomery ]]
| Ano
| Ano
| Pracovněprávní poměry zaměstnanců
|-
| [[WebAPI Pracovní postup|PracovniPostup ]]
| Ano
| Ne
| Pracovní postup zaměstnanců
|-
| [[WebAPI Pracovní povolení|PracovniPovoleni ]]
| Ano
| Ano
| Pracovní povolení cizinců
|-
| Priplatky || Ano || Ano || [[Příplatky]]
|-
| [[WebAPI Kmenové údaje|KmenoveUdaje ]]
| Ano
| Ano
| Evidence zaměstnanců
|-
| [[WebAPI Rodinní příslušníci|RodinniPrislusnici ]]
| Ano
| Ano
| Rodinní příslušníci
|-
| [[WebAPI Rodinní příslušníci slevy|RodinniPrislusniciSlevy ]]
| Ano
| Ano
| Daňové zvýhodnění rodinných příslušníků
|-
| [[WebAPI Skupiny středisek |SkupinyStredisek ]]
| Ano
| Ano
| Číselník skupiny středisek
|-
| [[WebAPI Služební cesty výdaje |SluzebniCestyVydaje ]]
| Ano
| Ne
| Cestovní výdaje/náhrady
|-
| [[WebAPI Služební cesty|SluzebniCesty ]]
| Ano
| Ne
| Služební cesty
|-
| [[WebAPI Služební cesty vyučtování|SluzebniCestyVyuctovani ]]
| Ano
| Ne
| Vyúčtování služebních cest
|-
| [[WebAPI Služební cesty zálohy|SluzebniCestyZalohy ]]
| Ano
| Ne
| Zálohy na služební cesty
|-
| [[WebAPI Střediska|Strediska ]]
| Ano
| Ano
| Číselník středisek
|-
| [[WebAPI Kontakty|Kontakty]]
| Ano
| Ano
| Kontakty (telefonní čísla, emaily)
|-
| [[WebAPI Vzdělání|Vzdelani ]]
| Ano
| Ano
| Dosažené vzdělání zaměstnanců
|-
| [[WebAPI KumulacePoVyuctovani|KumulacePoVyuctovani]] || Ano || Ne || Měsíční kumulace a další údaje po vyúčtování za os.číslo.
|-
| [[WebAPI MimoevidencniStavy|MimoevidencniStavy]] || Ano || Ne || [[Mimoevidenční stav]]
|-
| [[WebAPI Poznamky|Poznamky]] || Ano || Ne || Poznámky
|-
| [[WebAPI CiselnikJazyku|CiselnikJazyku]] || Ano || Ne || Číselník jazyků
|-
| [[WebAPI CiselnikStupnuVzdelani|CiselnikStupnuVzdelani]] || Ano || Ne || Číselník stupňů vzdělání
|-
| [[WebAPI iTutor_Courses|iTutor_Courses]] || Ano || Ano || iTutor - Platné kurzy

|-
| [[WebAPI Týdenní rozvrhy|TydenniRozvrhy]] || Ano || Ano || Číselník [[Týdenní rozvrhy]]
|-
| [[DataVyroby (KS webAPI)|DataVyroby]] || Ano || Ano || Data výroby
|-
| PrukazyZamestnanci || || ||
|-
| PrukazyVzdelavani || || ||
|-
| WorkflowNepritomnostiVsechnyTypy || || || db tab workfl_absence; možno aplikovat boolean Option s názvem ''PozadavkyPlatnyZaznam'' - pokud je aplikován, budou vráceny jen poslední platné záznamy z wkfl. Pokud nebude aplikováno, tak se ke každému požadavku vrátí tolik záznamů, kolika stupni schvalování ten který požadavek prošel. Pokud je potřeba získat data jen o schválených požadavcích, nastavte podmínku SysStav='o'. (hd 61207)
|-
| PouzitaOsobniCisla || || || Seznam použitých osobních čísel (tato již nemohou být použita při zakládání nových zaměstnanců).
|-
| [[DokumentyVystavene]] || Ano || Ne || [[Dokumenty vystavené]]
|}

== Odkazy ==
* [[Klient (KS webAPI)]]

WebAPI Týdenní rozvrhy

2025-11-05T09:36:07Z

Milan: založena nová stránka s textem „== Odkazy == * Položky (KS webAPI)“

== Odkazy ==
* [[Položky (KS webAPI)]]

Položky (KS webAPI)

2025-11-05T09:32:25Z

Milan:

V tabulce jsou uvedeny obecné skupiny údajů (a údaje), které se mohou lišit v závislosti na konkrétním uživateli. Dále se seznam liší dle varianty KS webAPI (Free, Reader, Writer).

'''Vždy je tedy nutné vygenerovat vlastní HTML dokumentaci s popisem datových struktur skupin údajů, a jí se řídit.''' Vygenerování HTML dokumentace se provede v aplikaci ''KS mzdy'' (menu: Systém > Web API), viz [[Generování (KS webAPI)]].

{|class="wikitable sortable" border="1" cellpadding="3" cellspacing="0"
|- style="background-color: #eeeeee"
!'''Skupiny údajů'''
!'''Čtení'''
!'''Zápis'''
!'''Význam'''
|-
| [[WebAPI Pracovní pomůcky|PracovniPomucky]]
| Ano
| Ano
| Přiřazení prac. pomůcek zaměstnancům
|-
| [[WebAPI Pomucky ciselnik|PomuckyCiselnik]]
| Ano
| Ano
| Číselník pracovních pomůcek
|-
| [[WebAPI Pomucky na sklade|PomuckyNaSklade]]
| Ano
| Ne
| Pracovní pomůcky na skladě
|-
| [[WebAPI Zpracované mzdy |ZpracovaneMzdy ]]
| Ano
| Ne
| Mzdy zaměstnanců a odvody podniku.
|-
| [[WebAPI Jazykové znalosti |JazykoveZnalosti ]]
| Ano
| Ano
| Jazykové znalosti zaměstnanců
|-
| [[WebAPI Dovolená|Dovolena ]]
| Ano
| Ne
| Dovolená v hodinách (legislativa 2021)
|-
| [[WebAPI Divize|Divize ]]
| Ano
| Ano
| Číselník divizí
|-
| [[WebAPI Benefitní volno|BenefitniVolno ]]
| Ano
| Ne
| Benefitní volna zaměstnanců
|-
| [[WebAPI Zpracovaná docházka|ZpracovanaDochazka ]]
| Ano
| Ano
| Sesumovaná docházková data pro mzdy
|-
| [[WebAPI Platby |Platby ]]
| Ano
| Ano
| Platby zaměstanců
|-
| [[WebAPI Podpisové vzory |PodpisoveVzory ]]
| Ano
| Ne
| Podpisové vzory
|-
| [[WebAPI Pracovní místa|PracovniMista ]]
| Ano
| Ano
| Číselník pracovních míst
|-
| [[WebAPI Atributy pracovních míst |PracovniMistaAtributy]]
| Ano
| Ano
| Vlastnosti přiřazené pracovním místům
|-
| [[WebAPI Pracovní poměry |PracovniPomery ]]
| Ano
| Ano
| Pracovněprávní poměry zaměstnanců
|-
| [[WebAPI Pracovní postup|PracovniPostup ]]
| Ano
| Ne
| Pracovní postup zaměstnanců
|-
| [[WebAPI Pracovní povolení|PracovniPovoleni ]]
| Ano
| Ano
| Pracovní povolení cizinců
|-
| Priplatky || Ano || Ano || [[Příplatky]]
|-
| [[WebAPI Kmenové údaje|KmenoveUdaje ]]
| Ano
| Ano
| Evidence zaměstnanců
|-
| [[WebAPI Rodinní příslušníci|RodinniPrislusnici ]]
| Ano
| Ano
| Rodinní příslušníci
|-
| [[WebAPI Rodinní příslušníci slevy|RodinniPrislusniciSlevy ]]
| Ano
| Ano
| Daňové zvýhodnění rodinných příslušníků
|-
| [[WebAPI Skupiny středisek |SkupinyStredisek ]]
| Ano
| Ano
| Číselník skupiny středisek
|-
| [[WebAPI Služební cesty výdaje |SluzebniCestyVydaje ]]
| Ano
| Ne
| Cestovní výdaje/náhrady
|-
| [[WebAPI Služební cesty|SluzebniCesty ]]
| Ano
| Ne
| Služební cesty
|-
| [[WebAPI Služební cesty vyučtování|SluzebniCestyVyuctovani ]]
| Ano
| Ne
| Vyúčtování služebních cest
|-
| [[WebAPI Služební cesty zálohy|SluzebniCestyZalohy ]]
| Ano
| Ne
| Zálohy na služební cesty
|-
| [[WebAPI Střediska|Strediska ]]
| Ano
| Ano
| Číselník středisek
|-
| [[WebAPI Kontakty|Kontakty]]
| Ano
| Ano
| Kontakty (telefonní čísla, emaily)
|-
| [[WebAPI Vzdělání|Vzdelani ]]
| Ano
| Ano
| Dosažené vzdělání zaměstnanců
|-
| [[WebAPI KumulacePoVyuctovani|KumulacePoVyuctovani]] || Ano || Ne || Měsíční kumulace a další údaje po vyúčtování za os.číslo.
|-
| [[WebAPI MimoevidencniStavy|MimoevidencniStavy]] || Ano || Ne || [[Mimoevidenční stav]]
|-
| [[WebAPI Poznamky|Poznamky]] || Ano || Ne || Poznámky
|-
| [[WebAPI CiselnikJazyku|CiselnikJazyku]] || Ano || Ne || Číselník jazyků
|-
| [[WebAPI CiselnikStupnuVzdelani|CiselnikStupnuVzdelani]] || Ano || Ne || Číselník stupňů vzdělání
|-
| [[WebAPI iTutor_Courses|iTutor_Courses]] || Ano || Ano || iTutor - Platné kurzy

|-
| TydenniRozvrhy || Ano || Ano || Číselník [[Týdenní rozvrhy]]
|-
| [[DataVyroby (KS webAPI)|DataVyroby]] || Ano || Ano || Data výroby
|-
| PrukazyZamestnanci || || ||
|-
| PrukazyVzdelavani || || ||
|-
| WorkflowNepritomnostiVsechnyTypy || || || db tab workfl_absence; možno aplikovat boolean Option s názvem ''PozadavkyPlatnyZaznam'' - pokud je aplikován, budou vráceny jen poslední platné záznamy z wkfl. Pokud nebude aplikováno, tak se ke každému požadavku vrátí tolik záznamů, kolika stupni schvalování ten který požadavek prošel. Pokud je potřeba získat data jen o schválených požadavcích, nastavte podmínku SysStav='o'. (hd 61207)
|-
| PouzitaOsobniCisla || || || Seznam použitých osobních čísel (tato již nemohou být použita při zakládání nových zaměstnanců).
|-
| [[DokumentyVystavene]] || Ano || Ne || [[Dokumenty vystavené]]
|}

== Odkazy ==
* [[Klient (KS webAPI)]]

Položky (KS webAPI)

2025-11-05T08:38:54Z

Milan:

V tabulce jsou uvedeny obecné skupiny údajů (a údaje), které se mohou lišit v závislosti na konkrétním uživateli. Dále se seznam liší dle varianty KS webAPI (Free, Reader, Writer).

'''Vždy je tedy nutné vygenerovat vlastní HTML dokumentaci s popisem datových struktur skupin údajů, a jí se řídit.''' Vygenerování HTML dokumentace se provede v aplikaci ''KS mzdy'' (menu: Systém > Web API), viz [[Generování (KS webAPI)]].

{|class="wikitable sortable" border="1" cellpadding="3" cellspacing="0"
|- style="background-color: #eeeeee"
!'''Skupiny údajů'''
!'''Čtení'''
!'''Zápis'''
!'''Význam'''
|-
| [[WebAPI Pracovní pomůcky|PracovniPomucky]]
| Ano
| Ano
| Přiřazení prac. pomůcek zaměstnancům
|-
| [[WebAPI Pomucky ciselnik|PomuckyCiselnik]]
| Ano
| Ano
| Číselník pracovních pomůcek
|-
| [[WebAPI Pomucky na sklade|PomuckyNaSklade]]
| Ano
| Ne
| Pracovní pomůcky na skladě
|-
| [[WebAPI Zpracované mzdy |ZpracovaneMzdy ]]
| Ano
| Ne
| Mzdy zaměstnanců a odvody podniku.
|-
| [[WebAPI Jazykové znalosti |JazykoveZnalosti ]]
| Ano
| Ano
| Jazykové znalosti zaměstnanců
|-
| [[WebAPI Dovolená|Dovolena ]]
| Ano
| Ne
| Dovolená v hodinách (legislativa 2021)
|-
| [[WebAPI Divize|Divize ]]
| Ano
| Ano
| Číselník divizí
|-
| [[WebAPI Benefitní volno|BenefitniVolno ]]
| Ano
| Ne
| Benefitní volna zaměstnanců
|-
| [[WebAPI Zpracovaná docházka|ZpracovanaDochazka ]]
| Ano
| Ano
| Sesumovaná docházková data pro mzdy
|-
| [[WebAPI Platby |Platby ]]
| Ano
| Ano
| Platby zaměstanců
|-
| [[WebAPI Podpisové vzory |PodpisoveVzory ]]
| Ano
| Ne
| Podpisové vzory
|-
| [[WebAPI Pracovní místa|PracovniMista ]]
| Ano
| Ano
| Číselník pracovních míst
|-
| [[WebAPI Atributy pracovních míst |PracovniMistaAtributy]]
| Ano
| Ano
| Vlastnosti přiřazené pracovním místům
|-
| [[WebAPI Pracovní poměry |PracovniPomery ]]
| Ano
| Ano
| Pracovněprávní poměry zaměstnanců
|-
| [[WebAPI Pracovní postup|PracovniPostup ]]
| Ano
| Ne
| Pracovní postup zaměstnanců
|-
| [[WebAPI Pracovní povolení|PracovniPovoleni ]]
| Ano
| Ano
| Pracovní povolení cizinců
|-
| Priplatky || Ano || Ano || [[Příplatky]]
|-
| [[WebAPI Kmenové údaje|KmenoveUdaje ]]
| Ano
| Ano
| Evidence zaměstnanců
|-
| [[WebAPI Rodinní příslušníci|RodinniPrislusnici ]]
| Ano
| Ano
| Rodinní příslušníci
|-
| [[WebAPI Rodinní příslušníci slevy|RodinniPrislusniciSlevy ]]
| Ano
| Ano
| Daňové zvýhodnění rodinných příslušníků
|-
| [[WebAPI Skupiny středisek |SkupinyStredisek ]]
| Ano
| Ano
| Číselník skupiny středisek
|-
| [[WebAPI Služební cesty výdaje |SluzebniCestyVydaje ]]
| Ano
| Ne
| Cestovní výdaje/náhrady
|-
| [[WebAPI Služební cesty|SluzebniCesty ]]
| Ano
| Ne
| Služební cesty
|-
| [[WebAPI Služební cesty vyučtování|SluzebniCestyVyuctovani ]]
| Ano
| Ne
| Vyúčtování služebních cest
|-
| [[WebAPI Služební cesty zálohy|SluzebniCestyZalohy ]]
| Ano
| Ne
| Zálohy na služební cesty
|-
| [[WebAPI Střediska|Strediska ]]
| Ano
| Ano
| Číselník středisek
|-
| [[WebAPI Kontakty|Kontakty]]
| Ano
| Ano
| Kontakty (telefonní čísla, emaily)
|-
| [[WebAPI Vzdělání|Vzdelani ]]
| Ano
| Ano
| Dosažené vzdělání zaměstnanců
|-
| [[WebAPI KumulacePoVyuctovani|KumulacePoVyuctovani]] || Ano || Ne || Měsíční kumulace a další údaje po vyúčtování za os.číslo.
|-
| [[WebAPI MimoevidencniStavy|MimoevidencniStavy]] || Ano || Ne || [[Mimoevidenční stav]]
|-
| [[WebAPI Poznamky|Poznamky]] || Ano || Ne || Poznámky
|-
| [[WebAPI CiselnikJazyku|CiselnikJazyku]] || Ano || Ne || Číselník jazyků
|-
| [[WebAPI CiselnikStupnuVzdelani|CiselnikStupnuVzdelani]] || Ano || Ne || Číselník stupňů vzdělání
|-
| [[WebAPI iTutor_Courses|iTutor_Courses]] || Ano || Ano || iTutor - Platné kurzy
|-
| [[WebAPI Plánované směny|Plánované směny]] || || ||
|-
| [[WebAPI Požadavky|Požadavky]] || || || [[Požadavky]]
|-
| TydenniRozvrhy || || || číselník [[Týdenní rozvrhy]]
|-
| [[DataVyroby (KS webAPI)|DataVyroby]] || Ano || Ano || Data výroby
|-
| PrukazyZamestnanci || || ||
|-
| PrukazyVzdelavani || || ||
|-
| WorkflowNepritomnostiVsechnyTypy || || || db tab workfl_absence; možno aplikovat boolean Option s názvem ''PozadavkyPlatnyZaznam'' - pokud je aplikován, budou vráceny jen poslední platné záznamy z wkfl. Pokud nebude aplikováno, tak se ke každému požadavku vrátí tolik záznamů, kolika stupni schvalování ten který požadavek prošel. Pokud je potřeba získat data jen o schválených požadavcích, nastavte podmínku SysStav='o'. (hd 61207)
|-
| PouzitaOsobniCisla || || || Seznam použitých osobních čísel (tato již nemohou být použita při zakládání nových zaměstnanců).
|-
| [[DokumentyVystavene]] || Ano || Ne || [[Dokumenty vystavené]]
|}

== Odkazy ==
* [[Klient (KS webAPI)]]

WebAPI iTutor Courses

2025-11-05T08:31:12Z

Milan:

==Čtení pomocí KS webAPI==
{|border="1" cellpadding="3" cellspacing="0"
|- style="background-color: #eeeeee"
|'''Údaj'''
|'''Datový typ'''
|'''Význam'''
|-
|UserId || decimal(10,0) || Jednoznačný identifikátor uživatele.
|-
|CourseId || char(10) || Jednoznačný identifikátor kurzu.
|-
|Name || char(100) || Název kurzu.
|-
|Begda || date || Datum počátku platnosti kurzu.
|-
|Endda || date || Datum konce platnosti kurzu.
|-
|Pdf || blob || PDF certifikát v řetězci BASE64.
|}

==Zápis pomocí KS webAPI==
{|border="1" cellpadding="3" cellspacing="0"
|- style="background-color: #eeeeee"
|'''Údaj'''
|'''Datový typ'''
|'''Povinné pole'''
|'''Význam'''
|-
|UserId || decimal(10,0) || Ano || Jednoznačný identifikátor uživatele.
|-
|CourseId || char(10) || Ano || Jednoznačný identifikátor kurzu.
|-
|Name || char(100) || Ano || Název kurzu.
|-
|Begda || date || Ano || Datum počátku platnosti kurzu.
|-
|Endda || date || Ne || Datum konce platnosti kurzu.
|-
|Pdf || blob || Ne || PDF certifikát v řetězci BASE64.
|}

== Odkazy ==
* [[Položky (KS webAPI)]]

WebAPI Poznamky

2025-11-05T08:22:02Z

Milan:

=Čtení pomocí KS webAPI=
{|border="1" cellpadding="3" cellspacing="0"
|- style="background-color: #eeeeee"
|'''Údaj'''
|'''Datový typ'''
|'''Význam'''
|-
|OsCislo || decimal(10,0) || Osobní číslo zaměstnance.
|-
|CisloPom || smallint || Číslo pracovního poměru zaměstnance.
|-
|ProgJmeno || char(14) || Vazba na egendu, ve které se pořizuje.
|-
|Hlavicka || char(20) || Text hlavičky poznámky.
|-
|Vlastnik || char(128) || Uživatel, který zavedl hlavičku do evidence.
|-
|IdHlavickapozn || integer || Vazba na hlavičku poznámky (nebo 0 - jednotlivá vlastní poznámka).
|-
|Obsah || char(2000) || Text poznámky.
|-
|Vyznam || char(80) || Význam hodnoty, pokud je text poznámky číselníkem.
|}

== Odkazy ==
* [[Položky (KS webAPI)]]

DataVyroby (KS webAPI)

2025-11-05T07:25:02Z

Milan:

''DataVyroby (KS webAPI)''

==Čtení pomocí WebAPI==
{|border="1" cellpadding="3" cellspacing="0"
|- style="background-color: #eeeeee"
|'''Údaj'''
|'''Datový typ'''
|'''Význam'''
|-
|OsCislo || decimal(10,0) || Osobní číslo pracovníka.
|-
|CisloPom || smallint || Číslo poměru.
|-
|Zakazka || char(20) || Projekt.
|-
|Cinnost || char(20) || Další členění v rámci projektu.
|-
|Stred || char(10) || Středisko.
|-
|Kod || smallint || Kód mzdové položky.
|-
|Dny || decimal(3,1) || Dny.
|-
|Hodiny || decimal(5,2) || Hodiny.
|-
|Castka || decimal(8,2) || Částka.
|-
|DatumOd || date || Datum od.
|-
|DatumDo || date || Datum do.
|-
|Davka || smallint || Číslo dávky.
|-
|Obdobi || date || Datum 1. dne období.
|}

==Zápis pomocí WebAPI==
{|border="1" cellpadding="3" cellspacing="0"
|- style="background-color: #eeeeee"
|'''Údaj'''
|'''Datový typ'''
|'''Povinné pole'''
|'''Význam'''
|-
|OsCislo || decimal(10,0) || Ano || Osobní číslo pracovníka.
|-
|CisloPom || smallint || Ano || Číslo poměru.
|-
|Zakazka || char(20) || Ne || Projekt.
|-
|Cinnost || char(20) || Ne || Další členění v rámci projektu.
|-
|Stred || char(10) || Ne || Středisko.
|-
|Kod || smallint || Ne || Kód mzdové položky.
|-
|Dny || decimal(3,1) || Ne || Dny.
|-
|Hodiny || decimal(5,2) || Ne || Hodiny.
|-
|Castka || decimal(8,2) || Ne || Částka.
|-
|DatumOd || date || Ne || Datum od.
|-
|DatumDo || date || Ne || Datum do.
|-
|Davka || smallint || Ne || Číslo dávky.
|}

== Komentář ==
* ''kod'' - kód mzdové položky, '''povinné''' pole.
* Funkcionalita se řídí parametry popisovanými zde: [[Import do výrobáku]].
* ''Zakazka'' a ''Cinnost'' - zapisovány mohou být volné hodnoty (neprobíhá kontrola na omezení hodnot, např. dle číselníku).
* Při vkládání dochází k promazání, proto pozor na správnou strukturu: [[Metody (KS webAPI)]] - není možné provádět INSERT po jednotlivých záznamech.

== Odkazy ==
* [[Položky (KS webAPI)]]
* db: vyrobak

Položky (KS webAPI)

2025-11-05T07:17:09Z

Milan:

V tabulce jsou uvedeny obecné skupiny údajů (a údaje), které se mohou lišit v závislosti na konkrétním uživateli. Dále se seznam liší dle varianty KS webAPI (Free, Reader, Writer).

'''Vždy je tedy nutné vygenerovat vlastní HTML dokumentaci s popisem datových struktur skupin údajů, a jí se řídit.''' Vygenerování HTML dokumentace se provede v aplikaci ''KS mzdy'' (menu: Systém > Web API), viz [[Generování (KS webAPI)]].

{|class="wikitable sortable" border="1" cellpadding="3" cellspacing="0"
|- style="background-color: #eeeeee"
!'''Skupiny údajů'''
!'''Čtení'''
!'''Zápis'''
!'''Význam'''
|-
| [[WebAPI Pracovní pomůcky|PracovniPomucky]]
| Ano
| Ano
| Přiřazení prac. pomůcek zaměstnancům
|-
| [[WebAPI Pomucky ciselnik|PomuckyCiselnik]]
| Ano
| Ano
| Číselník pracovních pomůcek
|-
| [[WebAPI Pomucky na sklade|PomuckyNaSklade]]
| Ano
| Ne
| Pracovní pomůcky na skladě
|-
| [[WebAPI Zpracované mzdy |ZpracovaneMzdy ]]
| Ano
| Ne
| Mzdy zaměstnanců a odvody podniku.
|-
| [[WebAPI Jazykové znalosti |JazykoveZnalosti ]]
| Ano
| Ano
| Jazykové znalosti zaměstnanců
|-
| [[WebAPI Dovolená|Dovolena ]]
| Ano
| Ne
| Dovolená v hodinách (legislativa 2021)
|-
| [[WebAPI Divize|Divize ]]
| Ano
| Ano
| Číselník divizí
|-
| [[WebAPI Benefitní volno|BenefitniVolno ]]
| Ano
| Ne
| Benefitní volna zaměstnanců
|-
| [[WebAPI Zpracovaná docházka|ZpracovanaDochazka ]]
| Ano
| Ano
| Sesumovaná docházková data pro mzdy
|-
| [[WebAPI Platby |Platby ]]
| Ano
| Ano
| Platby zaměstanců
|-
| [[WebAPI Podpisové vzory |PodpisoveVzory ]]
| Ano
| Ne
| Podpisové vzory
|-
| [[WebAPI Pracovní místa|PracovniMista ]]
| Ano
| Ano
| Číselník pracovních míst
|-
| [[WebAPI Atributy pracovních míst |PracovniMistaAtributy]]
| Ano
| Ano
| Vlastnosti přiřazené pracovním místům
|-
| [[WebAPI Pracovní poměry |PracovniPomery ]]
| Ano
| Ano
| Pracovněprávní poměry zaměstnanců
|-
| [[WebAPI Pracovní postup|PracovniPostup ]]
| Ano
| Ne
| Pracovní postup zaměstnanců
|-
| [[WebAPI Pracovní povolení|PracovniPovoleni ]]
| Ano
| Ano
| Pracovní povolení cizinců
|-
| Priplatky || Ano || Ano || [[Příplatky]]
|-
| [[WebAPI Kmenové údaje|KmenoveUdaje ]]
| Ano
| Ano
| Evidence zaměstnanců
|-
| [[WebAPI Rodinní příslušníci|RodinniPrislusnici ]]
| Ano
| Ano
| Rodinní příslušníci
|-
| [[WebAPI Rodinní příslušníci slevy|RodinniPrislusniciSlevy ]]
| Ano
| Ano
| Daňové zvýhodnění rodinných příslušníků
|-
| [[WebAPI Skupiny středisek |SkupinyStredisek ]]
| Ano
| Ano
| Číselník skupiny středisek
|-
| [[WebAPI Služební cesty výdaje |SluzebniCestyVydaje ]]
| Ano
| Ne
| Cestovní výdaje/náhrady
|-
| [[WebAPI Služební cesty|SluzebniCesty ]]
| Ano
| Ne
| Služební cesty
|-
| [[WebAPI Služební cesty vyučtování|SluzebniCestyVyuctovani ]]
| Ano
| Ne
| Vyúčtování služebních cest
|-
| [[WebAPI Služební cesty zálohy|SluzebniCestyZalohy ]]
| Ano
| Ne
| Zálohy na služební cesty
|-
| [[WebAPI Střediska|Strediska ]]
| Ano
| Ano
| Číselník středisek
|-
| [[WebAPI Kontakty|Kontakty]]
| Ano
| Ano
| Kontakty (telefonní čísla, emaily)
|-
| [[WebAPI Vzdělání|Vzdelani ]]
| Ano
| Ano
| Dosažené vzdělání zaměstnanců
|-
| [[WebAPI KumulacePoVyuctovani|KumulacePoVyuctovani]] || Ano || Ne || Měsíční kumulace a další údaje po vyúčtování za os.číslo.
|-
| [[WebAPI MimoevidencniStavy|MimoevidencniStavy]] || Ano || Ne || [[Mimoevidenční stav]]
|-
| [[WebAPI Poznamky|Poznamky]] || Ano || Ne || Poznámky
|-
| [[WebAPI CiselnikJazyku|CiselnikJazyku]] || Ano || Ne || Číselník jazyků
|-
| [[WebAPI CiselnikStupnuVzdelani|CiselnikStupnuVzdelani]] || Ano || Ne || Číselník stupňů vzdělání
|-
| [[WebAPI iTutor_Courses|iTutor_Courses]] || || ||
|-
| [[WebAPI Plánované směny|Plánované směny]] || || ||
|-
| [[WebAPI Požadavky|Požadavky]] || || || [[Požadavky]]
|-
| TydenniRozvrhy || || || číselník [[Týdenní rozvrhy]]
|-
| [[DataVyroby (KS webAPI)|DataVyroby]] || Ano || Ano || Data výroby
|-
| PrukazyZamestnanci || || ||
|-
| PrukazyVzdelavani || || ||
|-
| WorkflowNepritomnostiVsechnyTypy || || || db tab workfl_absence; možno aplikovat boolean Option s názvem ''PozadavkyPlatnyZaznam'' - pokud je aplikován, budou vráceny jen poslední platné záznamy z wkfl. Pokud nebude aplikováno, tak se ke každému požadavku vrátí tolik záznamů, kolika stupni schvalování ten který požadavek prošel. Pokud je potřeba získat data jen o schválených požadavcích, nastavte podmínku SysStav='o'. (hd 61207)
|-
| PouzitaOsobniCisla || || || Seznam použitých osobních čísel (tato již nemohou být použita při zakládání nových zaměstnanců).
|-
| [[DokumentyVystavene]] || Ano || Ne || [[Dokumenty vystavené]]
|}

== Odkazy ==
* [[Klient (KS webAPI)]]

DataVyroby (KS webAPI)

2025-11-05T07:15:00Z

Milan:

''DataVyroby (KS webAPI)''

==Čtení pomocí WebAPI==
{|border="1" cellpadding="3" cellspacing="0"
|- style="background-color: #eeeeee"
|'''Údaj'''
|'''Datový typ'''
|'''Význam'''
|-
|OsCislo || DECIMAL(10,0) || Osobní číslo pracovníka.
|-
|CisloPom || SMALLINT || Číslo poměru.
|-
|Zakazka || CHAR(20) || Projekt.
|-
|Cinnost || CHAR(20) || Další členění v rámci projektu.
|-
|Stred || CHAR(10) || Středisko.
|-
|Kod || SMALLINT || Kód mzdové položky.
|-
|Dny || DECIMAL(3,1) || Dny.
|-
|Hodiny || DECIMAL(5,2) || Hodiny.
|-
|Castka || DECIMAL(8,2) || Částka.
|-
|DatumOd || DATE || Datum od.
|-
|DatumDo || DATE || Datum do.
|-
|Davka || SMALLINT || Číslo dávky.
|-
|Obdobi || DATE || Datum 1. dne období.
|}

==Zápis pomocí WebAPI==
{|border="1" cellpadding="3" cellspacing="0"
|- style="background-color: #eeeeee"
|'''Údaj'''
|'''Datový typ'''
|'''Povinné pole'''
|'''Význam'''
|-
|OsCislo || DECIMAL(10,0) || Ano || Osobní číslo pracovníka.
|-
|CisloPom || SMALLINT || Ano || Číslo poměru.
|-
|Zakazka || CHAR(20) || Ne || Projekt.
|-
|Cinnost || CHAR(20) || Ne || Další členění v rámci projektu.
|-
|Stred || CHAR(10) || Ne || Středisko.
|-
|Kod || SMALLINT || Ne || Kód mzdové položky.
|-
|Dny || DECIMAL(3,1) || Ne || Dny.
|-
|Hodiny || DECIMAL(5,2) || Ne || Hodiny.
|-
|Castka || DECIMAL(8,2) || Ne || Částka.
|-
|DatumOd || DATE || Ne || Datum od.
|-
|DatumDo || DATE || Ne || Datum do.
|-
|Davka || SMALLINT || Ne || Číslo dávky.
|}

== Komentář ==
* ''kod'' - kód mzdové položky, '''povinné''' pole.
* Funkcionalita se řídí parametry popisovanými zde: [[Import do výrobáku]].
* ''Zakazka'' a ''Cinnost'' - zapisovány mohou být volné hodnoty (neprobíhá kontrola na omezení hodnot, např. dle číselníku).
* Při vkládání dochází k promazání, proto pozor na správnou strukturu: [[Metody (KS webAPI)]] - není možné provádět INSERT po jednotlivých záznamech.

== Odkazy ==
* [[Položky (KS webAPI)]]
* db: vyrobak

Univerzální číselníky

2025-09-08T09:05:28Z

Milan: /* DB */

Menu: Evidence > Číselníky > Univerzální číselníky 

V této agendě jsou umístěny číselníky, jejichž struktura je velmi jednoduchá a vzájemně podobná. V podstatě se vždy jedná pouze o vazbu '''Číslo(id) položky – Význam (název) položky'''.

Použití je potom v místě, kde je vyžadována hodnota taková, že se vyplněnými položkami z číselníku naplní rozbalovací menu a uživatel může zadat pouze hodnotu, která byla dříve zanesena do příslušného číselníku.

Seznam číselníků:
{| class = "sortable" border="1" cellpadding="3" cellspacing="0"
| Číselník
| Použití číselníku

|-
| Branná povinnost
| [[Osobní údaje]]

|-
| Délka úvazku *
| [[Délka úvazku]]

|-
| Hodnoty odpovědí
| [[Školící akce - vyhodnocení]]

|-
| [[Koeficienty (adm) (univerzální číselník)|Koeficienty (adm)]]
|

|-
| Konstantní symboly *
| [[Platby]]

|-
| Měrné jednotky
|

|-
| Modely pracovní doby
| Nepoužíváno - přesměrováno na [[Model pracovní doby]]

|-
| Národnost
| [[Osobní údaje]]

|-
| Názvy účtů
|

|-
| [[Praktické zkušenosti (číselník)]]
| [[Praktické zkušenosti]]

|-
| [[Rozpočtová kategorie]]
| [[Pracovní poměry]]

|-
| [[Skupina pracujících|Skupiny pracujících]]
| [[Pracovní poměry]]

|-
| Skupiny průkazů
| [[Evidence uchazečů#Průkazy]], [[FBK (Služební cesty)]]

|-
| Služební cesty - druh nákladu
| [[Služební cesty (zákaznické úpravy)]]

|-
| Směnnost
| [[Rozvrh]]

|-
| Stavy dokumentu
| [[Dokumenty vystavené]]

|-
| Stupně jazykových znalostí
|

|-
| Stupně porušení prac.kázně
|

|-
| Tituly
|

|-
| [[Typy akreditací šk.akcí (číselník)]]
| [[Školící akce (Editace)]]

|-
| Typy odborných činností
|

|-
| Úvazek, přestávka
|

|-
| Vojenské hodnosti
|

|-
| Výdejní místa
|

|-
| [[Výkaz]]
| [[Pracovní poměry]]

|-
| WEB docházka - operace
|

|-
| WEB docházka - výkazy práce
|

|}

<nowiki>*</nowiki> adm - administrátorský číselník, může jej editovat jen administrátor aplikace.

== DB ==
{|border="1" cellpadding="3" cellspacing="0"
|+ Univerzální číselníky - DB
|- style="background-color: #eeeeee"
|tab
|sloupec
|typ
|popis
|null
|-
|rowspan="4"|univ_cisel
| id || smallint || identifikátor daného číselníku ||
|-
| cislo || char(7) || číslo (vazební hodnota) na daný číselník ||
|-
| vyznam || char(120)|| význam (popis hodnoty) || x
|-
| archiv || char(1) || příznak archivu (null; "a") || x
|}

== Odkazy ==
<div style="text-align:center">[[Číselníky|Zpět]] | [[Obecná evidence osob]]</div>

Konfigurace (KS webAPI)

2025-03-19T08:52:59Z

Milan: /* Konfigurační soubor */

Základní konfigurace webové služby ''KS webAPI'' se provádí v konfiguračním souboru ''ASServer.exe.config'', který je součástí Windows služby [[KS aplikační server]] (AS). V tomto souboru se nastavuje transportní protokol (HTTP/HTTPS), komunikační protokol (SOAP/REST), adresa webové služby (Endpoint), certifikát pro zabezpečení komunikace, atd. Toto nastavení je potřeba pro zpřístupnění webové služby klientské aplikaci.

Nastavení uživatelských účtů a oprávnění k přenášeným údajům se nastavuje v aplikaci [[AS Seance Manager]] (ASSM).

== Konfigurační soubor ==

Konfigurace se provádí v konfiguračním souboru Windows služby [[KS aplikační server]].
* '''''ASServer.exe.config''''' - soubor je uložen v adresáři ''ASServer'', v umístění instance [[KS aplikační server]], které bylo vybráno pro instalaci [[KS aplikační server]].

V konfiguračním souboru se nastaví ''Endpoint'', ''Binding'', ''Behavior'', případně jiná nastavení.

== Příklad ==
Níže je uvedena vzorová konfigurace, která využívá zabezpečení s ověřením uživatelského jména na straně klienta a proto je potřeba nastavit certifikát v části '''''<serviceCertificate>'''''

SOAP a REST lze využívat souběžně.

'''Vzorová konfigurace SOAP'''
<pre>
<system.serviceModel>
<services>
<service name="KSProgram.AS.WCF.KSWebAPI" behaviorConfiguration="KSWebAPIBehavior">
<host>
<baseAddresses>
<add baseAddress="http://localhost:9001/KSAsServer/WebService/WebAPI"/>
</baseAddresses>
</host>

<endpoint address=""
binding="wsHttpBinding"
bindingConfiguration="KSWebAPIBinding"
contract="KSProgram.AS.WCF.IKSWebAPI" />
</service>
</services>
<bindings>
<wsHttpBinding>
<binding name="KSWebAPIBinding">
<security mode="Message">
<message clientCredentialType="UserName" />
</security>
<readerQuotas maxDepth="2147483647" maxStringContentLength="2147483647"
maxArrayLength="2147483647"
maxBytesPerRead="2147483647" maxNameTableCharCount="2147483647" />
</binding>
</wsHttpBinding>
</bindings>

<behaviors>
<serviceBehaviors>
<behavior name="KSWebAPIBehavior">
<serviceMetadata httpGetEnabled="true"/>
<serviceDebug includeExceptionDetailInFaults="true"/>
<serviceCredentials>
<userNameAuthentication userNamePasswordValidationMode="Custom"
customUserNamePasswordValidatorType="KSProgram.AS.WCF.PasswordValidator, WCFLib"/>
<serviceCertificate findValue="WebAPI_cert" storeLocation="LocalMachine"
storeName="My" x509FindType="FindBySubjectName"/>
</serviceCredentials>
</behavior>
</serviceBehaviors>
</behaviors>
</system.serviceModel>
</pre>

'''Vzorová konfigurace REST'''
<pre>
<system.serviceModel>
<services>
<service name="WCFLib.KSWebAPI.RESTApi.KSWebAPIRest" behaviorConfiguration="KSWebAPIBehaviorRest">
<endpoint address="Rest" behaviorConfiguration="webBehavior" binding="webHttpBinding" bindingConfiguration="KSWebAPIBindingRest" contract="WCFLib.KSWebAPI.RESTApi.IKSWebAPIRest"/>
<host>
<baseAddresses>
<add baseAddress="https://localhost:9002/KSAsServer/WebService/WebAPI"/>
</baseAddresses>
</host>
</service>
</services>
<bindings>
<webHttpBinding>
<binding name="KSWebAPIBindingRest" maxBufferPoolSize="2147483647" maxReceivedMessageSize="2147483647" maxBufferSize="2147483647" sendTimeout="00:10:00" receiveTimeout="00:10:00" crossDomainScriptAccessEnabled="false">
<readerQuotas maxDepth="2147483647" maxStringContentLength="2147483647" maxArrayLength="2147483647" maxBytesPerRead="2147483647"/>
<security mode="Transport">
</security>
</binding>
</webHttpBinding>
</bindings>
<behaviors>
<serviceBehaviors>
<behavior name="KSWebAPIBehaviorRest">
<serviceMetadata httpGetEnabled="false" httpsGetEnabled="true"/>
<serviceDebug includeExceptionDetailInFaults="true"/>
<serviceCredentials>
<serviceCertificate findValue="4564qwe23gdf8gd32f4fhf6f12s3a1sd" storeLocation="LocalMachine" storeName="My" x509FindType="FindBySerialNumber"/>
</serviceCredentials>
</behavior>
</serviceBehaviors>
<endpointBehaviors>
<behavior name="webBehavior">
<webHttp defaultOutgoingResponseFormat="Json"/>
</behavior>
</endpointBehaviors>
</behaviors>
<standardEndpoints>
<webScriptEndpoint>
<standardEndpoint crossDomainScriptAccessEnabled="true">
</standardEndpoint>
</webScriptEndpoint>
</standardEndpoints>
<serviceHostingEnvironment aspNetCompatibilityEnabled="true"/>
</system.serviceModel>
</pre>

== AS Seance Manager - Úloha č. 73 ==
[[AS Seance Manager]] (dále ASSM) je aplikace, která byla nainstalována společně s AS a slouží ke správě AS (spouštění instancí AS, konfigurace úloh, kontrola stavu úloh, atd.). ASSM je umístěn v adresáři, který byl vybrán pro instalaci AS - '''''...\KS-AS\ASSeanceManager\ASSeanceManager.exe'''''.

V případě KS webAPI je zde typ úlohy
* '''''Webová služba KSwebAPI''''' (Kód = 73) v seznamu ''Typ úlohy''. V části ''Nastavení webové služby'' se provádí nastavení uživatelských účtů pro autentizaci.

ASSM (soubor '''ASSeanceManager.exe''') je nutné spouštět jako '''správce'''.

[[Soubor:Nastaveni-as-seancemanager-webapi.jpg|450px]]

===Správa uživatelů===
V [[AS Seance Manager]] se provádí nastavení uživatelských účtů pro autentizaci. V sekci ''''Nastavení webové služby'''' se po stisku tlačítka ''Správa uživatelů'' otevře příslušné okno.

[[Image: KSwebAPI-Konektor Advanto-SpravaUzivatelu.png|400px]]


=== Oprávnění na položky ===

V [[AS Seance Manager]] se provádí nastavení oprávnění ''''Čtení'''' a ''''Zápis'''' na položky pro jednotlivé skupiny položek. V sekci ''''Nastavení webové služby'''' se po stisku tlačítka ''''Přístupová práva'''' otevře příslušné okno.

[[Soubor:Pristupova-prava-polozky-ks-webapi.jpg|350px]]

== Odkazy ==
* [[Správa (KS webAPI)]]

Konfigurace (KS webAPI)

2025-03-19T08:50:23Z

Milan: /* Konfigurační soubor */

Základní konfigurace webové služby ''KS webAPI'' se provádí v konfiguračním souboru ''ASServer.exe.config'', který je součástí Windows služby [[KS aplikační server]] (AS). V tomto souboru se nastavuje transportní protokol (HTTP/HTTPS), komunikační protokol (SOAP/REST), adresa webové služby (Endpoint), certifikát pro zabezpečení komunikace, atd. Toto nastavení je potřeba pro zpřístupnění webové služby klientské aplikaci.

Nastavení uživatelských účtů a oprávnění k přenášeným údajům se nastavuje v aplikaci [[AS Seance Manager]] (ASSM).

== Konfigurační soubor ==

Konfigurace se provádí v konfiguračním souboru Windows služby [[KS aplikační server]]
* '''''ASServer.exe.config''''' - soubor je uložen v adresáři ''ASServer'', v umístění instance [[KS aplikační server]], které bylo vybráno pro instalaci [[KS aplikační server]].

V konfiguračním souboru se nastaví ''Endpoint'', ''Binding'', ''Behavior'', případně jiná nastavení.

== Příklad ==
Níže je uvedena vzorová konfigurace, která využívá zabezpečení s ověřením uživatelského jména na straně klienta a proto je potřeba nastavit certifikát v části '''''<serviceCertificate>'''''

SOAP a REST lze využívat souběžně.

'''Vzorová konfigurace SOAP'''
<pre>
<system.serviceModel>
<services>
<service name="KSProgram.AS.WCF.KSWebAPI" behaviorConfiguration="KSWebAPIBehavior">
<host>
<baseAddresses>
<add baseAddress="http://localhost:9001/KSAsServer/WebService/WebAPI"/>
</baseAddresses>
</host>

<endpoint address=""
binding="wsHttpBinding"
bindingConfiguration="KSWebAPIBinding"
contract="KSProgram.AS.WCF.IKSWebAPI" />
</service>
</services>
<bindings>
<wsHttpBinding>
<binding name="KSWebAPIBinding">
<security mode="Message">
<message clientCredentialType="UserName" />
</security>
<readerQuotas maxDepth="2147483647" maxStringContentLength="2147483647"
maxArrayLength="2147483647"
maxBytesPerRead="2147483647" maxNameTableCharCount="2147483647" />
</binding>
</wsHttpBinding>
</bindings>

<behaviors>
<serviceBehaviors>
<behavior name="KSWebAPIBehavior">
<serviceMetadata httpGetEnabled="true"/>
<serviceDebug includeExceptionDetailInFaults="true"/>
<serviceCredentials>
<userNameAuthentication userNamePasswordValidationMode="Custom"
customUserNamePasswordValidatorType="KSProgram.AS.WCF.PasswordValidator, WCFLib"/>
<serviceCertificate findValue="WebAPI_cert" storeLocation="LocalMachine"
storeName="My" x509FindType="FindBySubjectName"/>
</serviceCredentials>
</behavior>
</serviceBehaviors>
</behaviors>
</system.serviceModel>
</pre>

'''Vzorová konfigurace REST'''
<pre>
<system.serviceModel>
<services>
<service name="WCFLib.KSWebAPI.RESTApi.KSWebAPIRest" behaviorConfiguration="KSWebAPIBehaviorRest">
<endpoint address="Rest" behaviorConfiguration="webBehavior" binding="webHttpBinding" bindingConfiguration="KSWebAPIBindingRest" contract="WCFLib.KSWebAPI.RESTApi.IKSWebAPIRest"/>
<host>
<baseAddresses>
<add baseAddress="https://localhost:9002/KSAsServer/WebService/WebAPI"/>
</baseAddresses>
</host>
</service>
</services>
<bindings>
<webHttpBinding>
<binding name="KSWebAPIBindingRest" maxBufferPoolSize="2147483647" maxReceivedMessageSize="2147483647" maxBufferSize="2147483647" sendTimeout="00:10:00" receiveTimeout="00:10:00" crossDomainScriptAccessEnabled="false">
<readerQuotas maxDepth="2147483647" maxStringContentLength="2147483647" maxArrayLength="2147483647" maxBytesPerRead="2147483647"/>
<security mode="Transport">
</security>
</binding>
</webHttpBinding>
</bindings>
<behaviors>
<serviceBehaviors>
<behavior name="KSWebAPIBehaviorRest">
<serviceMetadata httpGetEnabled="false" httpsGetEnabled="true"/>
<serviceDebug includeExceptionDetailInFaults="true"/>
<serviceCredentials>
<serviceCertificate findValue="4564qwe23gdf8gd32f4fhf6f12s3a1sd" storeLocation="LocalMachine" storeName="My" x509FindType="FindBySerialNumber"/>
</serviceCredentials>
</behavior>
</serviceBehaviors>
<endpointBehaviors>
<behavior name="webBehavior">
<webHttp defaultOutgoingResponseFormat="Json"/>
</behavior>
</endpointBehaviors>
</behaviors>
<standardEndpoints>
<webScriptEndpoint>
<standardEndpoint crossDomainScriptAccessEnabled="true">
</standardEndpoint>
</webScriptEndpoint>
</standardEndpoints>
<serviceHostingEnvironment aspNetCompatibilityEnabled="true"/>
</system.serviceModel>
</pre>

== AS Seance Manager - Úloha č. 73 ==
[[AS Seance Manager]] (dále ASSM) je aplikace, která byla nainstalována společně s AS a slouží ke správě AS (spouštění instancí AS, konfigurace úloh, kontrola stavu úloh, atd.). ASSM je umístěn v adresáři, který byl vybrán pro instalaci AS - '''''...\KS-AS\ASSeanceManager\ASSeanceManager.exe'''''.

V případě KS webAPI je zde typ úlohy
* '''''Webová služba KSwebAPI''''' (Kód = 73) v seznamu ''Typ úlohy''. V části ''Nastavení webové služby'' se provádí nastavení uživatelských účtů pro autentizaci.

ASSM (soubor '''ASSeanceManager.exe''') je nutné spouštět jako '''správce'''.

[[Soubor:Nastaveni-as-seancemanager-webapi.jpg|450px]]

===Správa uživatelů===
V [[AS Seance Manager]] se provádí nastavení uživatelských účtů pro autentizaci. V sekci ''''Nastavení webové služby'''' se po stisku tlačítka ''Správa uživatelů'' otevře příslušné okno.

[[Image: KSwebAPI-Konektor Advanto-SpravaUzivatelu.png|400px]]


=== Oprávnění na položky ===

V [[AS Seance Manager]] se provádí nastavení oprávnění ''''Čtení'''' a ''''Zápis'''' na položky pro jednotlivé skupiny položek. V sekci ''''Nastavení webové služby'''' se po stisku tlačítka ''''Přístupová práva'''' otevře příslušné okno.

[[Soubor:Pristupova-prava-polozky-ks-webapi.jpg|350px]]

== Odkazy ==
* [[Správa (KS webAPI)]]

Konfigurace (KS webAPI)

2025-03-19T08:48:10Z

Milan:

Základní konfigurace webové služby ''KS webAPI'' se provádí v konfiguračním souboru ''ASServer.exe.config'', který je součástí Windows služby [[KS aplikační server]] (AS). V tomto souboru se nastavuje transportní protokol (HTTP/HTTPS), komunikační protokol (SOAP/REST), adresa webové služby (Endpoint), certifikát pro zabezpečení komunikace, atd. Toto nastavení je potřeba pro zpřístupnění webové služby klientské aplikaci.

Nastavení uživatelských účtů a oprávnění k přenášeným údajům se nastavuje v aplikaci [[AS Seance Manager]] (ASSM).

== Konfigurační soubor ==

Konfigurace se provádí v konfiguračním souboru [[KS aplikační server]]
* '''''ASServer.exe.config''''' - soubor je uložen v adresáři ''ASServer'', v umístění instance [[KS aplikační server]], které bylo vybráno pro instalaci [[KS aplikační server]].

V konfiguračním souboru se nastaví ''Endpoint'', ''Binding'', ''Behavior'', případně jiná nastavení.

== Příklad ==
Níže je uvedena vzorová konfigurace, která využívá zabezpečení s ověřením uživatelského jména na straně klienta a proto je potřeba nastavit certifikát v části '''''<serviceCertificate>'''''

SOAP a REST lze využívat souběžně.

'''Vzorová konfigurace SOAP'''
<pre>
<system.serviceModel>
<services>
<service name="KSProgram.AS.WCF.KSWebAPI" behaviorConfiguration="KSWebAPIBehavior">
<host>
<baseAddresses>
<add baseAddress="http://localhost:9001/KSAsServer/WebService/WebAPI"/>
</baseAddresses>
</host>

<endpoint address=""
binding="wsHttpBinding"
bindingConfiguration="KSWebAPIBinding"
contract="KSProgram.AS.WCF.IKSWebAPI" />
</service>
</services>
<bindings>
<wsHttpBinding>
<binding name="KSWebAPIBinding">
<security mode="Message">
<message clientCredentialType="UserName" />
</security>
<readerQuotas maxDepth="2147483647" maxStringContentLength="2147483647"
maxArrayLength="2147483647"
maxBytesPerRead="2147483647" maxNameTableCharCount="2147483647" />
</binding>
</wsHttpBinding>
</bindings>

<behaviors>
<serviceBehaviors>
<behavior name="KSWebAPIBehavior">
<serviceMetadata httpGetEnabled="true"/>
<serviceDebug includeExceptionDetailInFaults="true"/>
<serviceCredentials>
<userNameAuthentication userNamePasswordValidationMode="Custom"
customUserNamePasswordValidatorType="KSProgram.AS.WCF.PasswordValidator, WCFLib"/>
<serviceCertificate findValue="WebAPI_cert" storeLocation="LocalMachine"
storeName="My" x509FindType="FindBySubjectName"/>
</serviceCredentials>
</behavior>
</serviceBehaviors>
</behaviors>
</system.serviceModel>
</pre>

'''Vzorová konfigurace REST'''
<pre>
<system.serviceModel>
<services>
<service name="WCFLib.KSWebAPI.RESTApi.KSWebAPIRest" behaviorConfiguration="KSWebAPIBehaviorRest">
<endpoint address="Rest" behaviorConfiguration="webBehavior" binding="webHttpBinding" bindingConfiguration="KSWebAPIBindingRest" contract="WCFLib.KSWebAPI.RESTApi.IKSWebAPIRest"/>
<host>
<baseAddresses>
<add baseAddress="https://localhost:9002/KSAsServer/WebService/WebAPI"/>
</baseAddresses>
</host>
</service>
</services>
<bindings>
<webHttpBinding>
<binding name="KSWebAPIBindingRest" maxBufferPoolSize="2147483647" maxReceivedMessageSize="2147483647" maxBufferSize="2147483647" sendTimeout="00:10:00" receiveTimeout="00:10:00" crossDomainScriptAccessEnabled="false">
<readerQuotas maxDepth="2147483647" maxStringContentLength="2147483647" maxArrayLength="2147483647" maxBytesPerRead="2147483647"/>
<security mode="Transport">
</security>
</binding>
</webHttpBinding>
</bindings>
<behaviors>
<serviceBehaviors>
<behavior name="KSWebAPIBehaviorRest">
<serviceMetadata httpGetEnabled="false" httpsGetEnabled="true"/>
<serviceDebug includeExceptionDetailInFaults="true"/>
<serviceCredentials>
<serviceCertificate findValue="4564qwe23gdf8gd32f4fhf6f12s3a1sd" storeLocation="LocalMachine" storeName="My" x509FindType="FindBySerialNumber"/>
</serviceCredentials>
</behavior>
</serviceBehaviors>
<endpointBehaviors>
<behavior name="webBehavior">
<webHttp defaultOutgoingResponseFormat="Json"/>
</behavior>
</endpointBehaviors>
</behaviors>
<standardEndpoints>
<webScriptEndpoint>
<standardEndpoint crossDomainScriptAccessEnabled="true">
</standardEndpoint>
</webScriptEndpoint>
</standardEndpoints>
<serviceHostingEnvironment aspNetCompatibilityEnabled="true"/>
</system.serviceModel>
</pre>

== AS Seance Manager - Úloha č. 73 ==
[[AS Seance Manager]] (dále ASSM) je aplikace, která byla nainstalována společně s AS a slouží ke správě AS (spouštění instancí AS, konfigurace úloh, kontrola stavu úloh, atd.). ASSM je umístěn v adresáři, který byl vybrán pro instalaci AS - '''''...\KS-AS\ASSeanceManager\ASSeanceManager.exe'''''.

V případě KS webAPI je zde typ úlohy
* '''''Webová služba KSwebAPI''''' (Kód = 73) v seznamu ''Typ úlohy''. V části ''Nastavení webové služby'' se provádí nastavení uživatelských účtů pro autentizaci.

ASSM (soubor '''ASSeanceManager.exe''') je nutné spouštět jako '''správce'''.

[[Soubor:Nastaveni-as-seancemanager-webapi.jpg|450px]]

===Správa uživatelů===
V [[AS Seance Manager]] se provádí nastavení uživatelských účtů pro autentizaci. V sekci ''''Nastavení webové služby'''' se po stisku tlačítka ''Správa uživatelů'' otevře příslušné okno.

[[Image: KSwebAPI-Konektor Advanto-SpravaUzivatelu.png|400px]]


=== Oprávnění na položky ===

V [[AS Seance Manager]] se provádí nastavení oprávnění ''''Čtení'''' a ''''Zápis'''' na položky pro jednotlivé skupiny položek. V sekci ''''Nastavení webové služby'''' se po stisku tlačítka ''''Přístupová práva'''' otevře příslušné okno.

[[Soubor:Pristupova-prava-polozky-ks-webapi.jpg|350px]]

== Odkazy ==
* [[Správa (KS webAPI)]]

Správa (KS webAPI)

2025-03-19T07:40:15Z

Milan:

Webová služba ''KS webAPI'' běží jako součást Windows služby [[KS aplikační server]].
''KS webAPI'' se zpřístupní aktivací [[Rozšíření aplikace]] typu [[Konektory_(KS_webAPI)|Konektory]].

* [[Zpřístupnění (KS webAPI)|Zpřístupnění]] 
** Varianta: '''[[Konektory (KS webAPI)|Konektory]]'''
* [[KS aplikační server]] 
* [[Konfigurace (KS webAPI)|Konfigurace]] 

== Odkazy ==

* [[KS webAPI]]

Správa (KS webAPI)

2025-03-18T13:48:49Z

Milan:

Webová služba ''KS webAPI'' běží jako součást Windows služby [[KS aplikační server]].

* [[Zpřístupnění (KS webAPI)|Zpřístupnění]] 
** Varianta: '''[[Konektory (KS webAPI)|Konektory]]'''
* [[KS aplikační server]] 
* [[Konfigurace (KS webAPI)|Konfigurace]] 

== Odkazy ==

* [[KS webAPI]]

KS webAPI

2025-03-18T13:21:55Z

Milan:

''KS webAPI'' je webová služba postavená na technologii ''Windows Communication Foundation (WCF)''. Umožňuje klientské aplikaci získávat údaje z databáze ''KS mzdy'' nebo do ní zapisovat data.

* '''[[Správa (KS webAPI)|Správa]]'''
* '''[[Klient (KS webAPI)|Klient]]'''

== Odkazy ==

* [[Systémová příručka]]
* [[Logování (Aplikační server KS)]]

Generování (KS webAPI)

2025-03-18T12:25:24Z

Milan: /* Generování */

Jedná se o úlohu, která provede vygenerování HTML dokumentace datových struktur KS webAPI.

Kdy spouštět:
* při '''zpřístupnění''' [[KS webAPI]]
* při vydání nové verze ('''aktualizaci''') [[KS webAPI]]

== Účel ==
* zapsání nových položek do databáze (DB: webapi_items)
* vygenerování dokumentačních tabulek v html

== Generování ==
Generování se provádí v aplikaci ''KS mzdy'' (menu: Systém > Web API).

[[Image: Chcete spustut generovani dokumentace a pristupu pro WebAPI.png|250px]]
[[Image: WebAPI generovani pristupu a dokumentace cilovy adresar.png|70px]]
[[Image: WebAPI generovani bylo uspesne dokonceno.png|250px]]

== Výsledek ==
* aktualizovány položky do databáze
* do určeného umístění (adresáře) jsou uloženy soubory dokumentace

[[Image: WebAPI generovani-Stazene soubory.png|150px]]
[[Image: KS WebAPI-Index.png|450px]]
[[Image: KS WebAPI-PracovniPomery-R.png|350px]]

== Odkazy ==
* [[KS webAPI]]