<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="cs">
	<id>https://prirucky.ksprogram.cz/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Pavelm</id>
	<title>Prirucky - Příspěvky [cs]</title>
	<link rel="self" type="application/atom+xml" href="https://prirucky.ksprogram.cz/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Pavelm"/>
	<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Speci%C3%A1ln%C3%AD:P%C5%99%C3%ADsp%C4%9Bvky/Pavelm"/>
	<updated>2026-10-17T04:40:04Z</updated>
	<subtitle>Příspěvky</subtitle>
	<generator>MediaWiki 1.37.2</generator>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Konfigurace_(KS_webAPI)&amp;diff=49042</id>
		<title>Konfigurace (KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Konfigurace_(KS_webAPI)&amp;diff=49042"/>
		<updated>2025-11-10T11:10:14Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: /* Příklad */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;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.&lt;br /&gt;
&lt;br /&gt;
Nastavení uživatelských účtů a oprávnění k přenášeným údajům se nastavuje v aplikaci [[AS Seance Manager]] (ASSM).&lt;br /&gt;
&lt;br /&gt;
== Konfigurační soubor ==&lt;br /&gt;
&lt;br /&gt;
Konfigurace se provádí v konfiguračním souboru Windows služby [[KS aplikační server]].&lt;br /&gt;
* '''''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]].&lt;br /&gt;
&lt;br /&gt;
V konfiguračním souboru je nutné nastavit ''Endpoint'', ''Binding'', ''Behavior'' a ''WebApiType'', případně další nastavení.&lt;br /&gt;
&lt;br /&gt;
== Příklad ==&lt;br /&gt;
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 '''''&amp;lt;serviceCertificate&amp;gt;'''''&lt;br /&gt;
&lt;br /&gt;
Dále je nutné nastavit, jaký typ API se bude používat. To určuje parametr s klíčem ''WebApiType'' a hodnotou &amp;quot;soap,rest&amp;quot;, &amp;quot;rest&amp;quot; nebo &amp;quot;soap&amp;quot;.&lt;br /&gt;
V případě nevyplnění tohoto parametru bude použito pouze SOAP API.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;lt;appSettings&amp;gt;&lt;br /&gt;
...&lt;br /&gt;
&amp;lt;add key=&amp;quot;WebApiType&amp;quot; value=&amp;quot;rest&amp;quot; /&amp;gt;&lt;br /&gt;
...&lt;br /&gt;
&amp;lt;/appSettings&amp;gt;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
SOAP a REST lze využívat souběžně.&lt;br /&gt;
&lt;br /&gt;
'''Vzorová konfigurace SOAP'''&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;lt;system.serviceModel&amp;gt;&lt;br /&gt;
  &amp;lt;services&amp;gt;  &lt;br /&gt;
    &amp;lt;service name=&amp;quot;KSProgram.AS.WCF.KSWebAPI&amp;quot; behaviorConfiguration=&amp;quot;KSWebAPIBehavior&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;host&amp;gt;&lt;br /&gt;
        &amp;lt;baseAddresses&amp;gt;&lt;br /&gt;
          &amp;lt;add baseAddress=&amp;quot;http://localhost:9001/KSAsServer/WebService/WebAPI&amp;quot;/&amp;gt;&lt;br /&gt;
        &amp;lt;/baseAddresses&amp;gt;&lt;br /&gt;
      &amp;lt;/host&amp;gt;&lt;br /&gt;
&lt;br /&gt;
      &amp;lt;endpoint address=&amp;quot;&amp;quot;&lt;br /&gt;
                binding=&amp;quot;wsHttpBinding&amp;quot;&lt;br /&gt;
                bindingConfiguration=&amp;quot;KSWebAPIBinding&amp;quot;&lt;br /&gt;
                contract=&amp;quot;KSProgram.AS.WCF.IKSWebAPI&amp;quot; /&amp;gt;&lt;br /&gt;
    &amp;lt;/service&amp;gt;&lt;br /&gt;
  &amp;lt;/services&amp;gt;&lt;br /&gt;
  &amp;lt;bindings&amp;gt;&lt;br /&gt;
      &amp;lt;wsHttpBinding&amp;gt;&lt;br /&gt;
        &amp;lt;binding name=&amp;quot;KSWebAPIBinding&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;security mode=&amp;quot;Message&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;message clientCredentialType=&amp;quot;UserName&amp;quot; /&amp;gt;&lt;br /&gt;
 &amp;lt;/security&amp;gt;&lt;br /&gt;
 &amp;lt;readerQuotas maxDepth=&amp;quot;2147483647&amp;quot; maxStringContentLength=&amp;quot;2147483647&amp;quot;&lt;br /&gt;
        maxArrayLength=&amp;quot;2147483647&amp;quot;   &lt;br /&gt;
        maxBytesPerRead=&amp;quot;2147483647&amp;quot; maxNameTableCharCount=&amp;quot;2147483647&amp;quot; /&amp;gt;&lt;br /&gt;
&amp;lt;/binding&amp;gt;&lt;br /&gt;
      &amp;lt;/wsHttpBinding&amp;gt;&lt;br /&gt;
    &amp;lt;/bindings&amp;gt;&lt;br /&gt;
&lt;br /&gt;
    &amp;lt;behaviors&amp;gt;&lt;br /&gt;
      &amp;lt;serviceBehaviors&amp;gt;&lt;br /&gt;
        &amp;lt;behavior name=&amp;quot;KSWebAPIBehavior&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;serviceMetadata httpGetEnabled=&amp;quot;true&amp;quot;/&amp;gt;&lt;br /&gt;
  &amp;lt;serviceDebug includeExceptionDetailInFaults=&amp;quot;true&amp;quot;/&amp;gt;&lt;br /&gt;
  &amp;lt;serviceCredentials&amp;gt;&lt;br /&gt;
      &amp;lt;userNameAuthentication userNamePasswordValidationMode=&amp;quot;Custom&amp;quot;  &lt;br /&gt;
             customUserNamePasswordValidatorType=&amp;quot;KSProgram.AS.WCF.PasswordValidator, WCFLib&amp;quot;/&amp;gt;&lt;br /&gt;
   &amp;lt;serviceCertificate findValue=&amp;quot;WebAPI_cert&amp;quot; storeLocation=&amp;quot;LocalMachine&amp;quot;  &lt;br /&gt;
             storeName=&amp;quot;My&amp;quot; x509FindType=&amp;quot;FindBySubjectName&amp;quot;/&amp;gt;&lt;br /&gt;
  &amp;lt;/serviceCredentials&amp;gt;&lt;br /&gt;
&amp;lt;/behavior&amp;gt;&lt;br /&gt;
      &amp;lt;/serviceBehaviors&amp;gt;&lt;br /&gt;
    &amp;lt;/behaviors&amp;gt;&lt;br /&gt;
&amp;lt;/system.serviceModel&amp;gt;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
'''Vzorová konfigurace REST'''&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;lt;system.serviceModel&amp;gt;&lt;br /&gt;
	&amp;lt;services&amp;gt;&lt;br /&gt;
		&amp;lt;service name=&amp;quot;WCFLib.KSWebAPI.RESTApi.KSWebAPIRest&amp;quot; behaviorConfiguration=&amp;quot;KSWebAPIBehaviorRest&amp;quot;&amp;gt;&lt;br /&gt;
			&amp;lt;endpoint address=&amp;quot;Rest&amp;quot; behaviorConfiguration=&amp;quot;webBehavior&amp;quot; binding=&amp;quot;webHttpBinding&amp;quot; bindingConfiguration=&amp;quot;KSWebAPIBindingRest&amp;quot; contract=&amp;quot;WCFLib.KSWebAPI.RESTApi.IKSWebAPIRest&amp;quot;/&amp;gt;&lt;br /&gt;
			&amp;lt;host&amp;gt;&lt;br /&gt;
				&amp;lt;baseAddresses&amp;gt;&lt;br /&gt;
					&amp;lt;add baseAddress=&amp;quot;https://localhost:9002/KSAsServer/WebService/WebAPI&amp;quot;/&amp;gt;&lt;br /&gt;
				&amp;lt;/baseAddresses&amp;gt;&lt;br /&gt;
			&amp;lt;/host&amp;gt;&lt;br /&gt;
		&amp;lt;/service&amp;gt;&lt;br /&gt;
	&amp;lt;/services&amp;gt;&lt;br /&gt;
	&amp;lt;bindings&amp;gt;&lt;br /&gt;
		&amp;lt;webHttpBinding&amp;gt;&lt;br /&gt;
			&amp;lt;binding name=&amp;quot;KSWebAPIBindingRest&amp;quot; maxBufferPoolSize=&amp;quot;2147483647&amp;quot; maxReceivedMessageSize=&amp;quot;2147483647&amp;quot; maxBufferSize=&amp;quot;2147483647&amp;quot; sendTimeout=&amp;quot;00:10:00&amp;quot; receiveTimeout=&amp;quot;00:10:00&amp;quot; crossDomainScriptAccessEnabled=&amp;quot;false&amp;quot;&amp;gt;&lt;br /&gt;
				&amp;lt;readerQuotas maxDepth=&amp;quot;2147483647&amp;quot; maxStringContentLength=&amp;quot;2147483647&amp;quot; maxArrayLength=&amp;quot;2147483647&amp;quot; maxBytesPerRead=&amp;quot;2147483647&amp;quot;/&amp;gt;&lt;br /&gt;
				&amp;lt;security mode=&amp;quot;Transport&amp;quot;&amp;gt;&lt;br /&gt;
				&amp;lt;/security&amp;gt;&lt;br /&gt;
			&amp;lt;/binding&amp;gt;&lt;br /&gt;
		&amp;lt;/webHttpBinding&amp;gt;&lt;br /&gt;
	&amp;lt;/bindings&amp;gt;&lt;br /&gt;
	&amp;lt;behaviors&amp;gt;&lt;br /&gt;
		&amp;lt;serviceBehaviors&amp;gt;&lt;br /&gt;
			&amp;lt;behavior name=&amp;quot;KSWebAPIBehaviorRest&amp;quot;&amp;gt;&lt;br /&gt;
				&amp;lt;serviceMetadata httpGetEnabled=&amp;quot;false&amp;quot; httpsGetEnabled=&amp;quot;true&amp;quot;/&amp;gt;&lt;br /&gt;
				&amp;lt;serviceDebug includeExceptionDetailInFaults=&amp;quot;true&amp;quot;/&amp;gt;&lt;br /&gt;
				&amp;lt;serviceCredentials&amp;gt;&lt;br /&gt;
					&amp;lt;serviceCertificate findValue=&amp;quot;4564qwe23gdf8gd32f4fhf6f12s3a1sd&amp;quot; storeLocation=&amp;quot;LocalMachine&amp;quot; storeName=&amp;quot;My&amp;quot; x509FindType=&amp;quot;FindBySerialNumber&amp;quot;/&amp;gt;&lt;br /&gt;
				&amp;lt;/serviceCredentials&amp;gt;&lt;br /&gt;
			&amp;lt;/behavior&amp;gt;&lt;br /&gt;
		&amp;lt;/serviceBehaviors&amp;gt;&lt;br /&gt;
		&amp;lt;endpointBehaviors&amp;gt;&lt;br /&gt;
			&amp;lt;behavior name=&amp;quot;webBehavior&amp;quot;&amp;gt;&lt;br /&gt;
				&amp;lt;webHttp defaultOutgoingResponseFormat=&amp;quot;Json&amp;quot;/&amp;gt;&lt;br /&gt;
			&amp;lt;/behavior&amp;gt;&lt;br /&gt;
		&amp;lt;/endpointBehaviors&amp;gt;&lt;br /&gt;
	&amp;lt;/behaviors&amp;gt;&lt;br /&gt;
	&amp;lt;standardEndpoints&amp;gt;&lt;br /&gt;
		&amp;lt;webScriptEndpoint&amp;gt;&lt;br /&gt;
			&amp;lt;standardEndpoint crossDomainScriptAccessEnabled=&amp;quot;true&amp;quot;&amp;gt;&lt;br /&gt;
			&amp;lt;/standardEndpoint&amp;gt;&lt;br /&gt;
		&amp;lt;/webScriptEndpoint&amp;gt;&lt;br /&gt;
	&amp;lt;/standardEndpoints&amp;gt;&lt;br /&gt;
	&amp;lt;serviceHostingEnvironment aspNetCompatibilityEnabled=&amp;quot;true&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/system.serviceModel&amp;gt;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== AS Seance Manager - Úloha č. 73 ==&lt;br /&gt;
[[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'''''.&lt;br /&gt;
&lt;br /&gt;
V případě KS webAPI je zde typ úlohy &lt;br /&gt;
* '''''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.&lt;br /&gt;
&lt;br /&gt;
ASSM (soubor '''ASSeanceManager.exe''') je nutné spouštět jako '''správce'''.&lt;br /&gt;
&lt;br /&gt;
[[Soubor:Nastaveni-as-seancemanager-webapi.jpg|450px]]&lt;br /&gt;
&lt;br /&gt;
===Správa uživatelů===&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
[[Image: KSwebAPI-Konektor Advanto-SpravaUzivatelu.png|400px]] &lt;br /&gt;
&amp;lt;!-- [[Soubor:Sprava-uzivatelu-KS-WEBAPI.jpg|350px]] --&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Oprávnění na položky ===&lt;br /&gt;
&lt;br /&gt;
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. &lt;br /&gt;
&lt;br /&gt;
[[Soubor:Pristupova-prava-polozky-ks-webapi.jpg|350px]]&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Správa (KS webAPI)]]&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Konfigurace_(KS_webAPI)&amp;diff=49041</id>
		<title>Konfigurace (KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Konfigurace_(KS_webAPI)&amp;diff=49041"/>
		<updated>2025-11-10T10:58:14Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: /* Konfigurační soubor */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;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.&lt;br /&gt;
&lt;br /&gt;
Nastavení uživatelských účtů a oprávnění k přenášeným údajům se nastavuje v aplikaci [[AS Seance Manager]] (ASSM).&lt;br /&gt;
&lt;br /&gt;
== Konfigurační soubor ==&lt;br /&gt;
&lt;br /&gt;
Konfigurace se provádí v konfiguračním souboru Windows služby [[KS aplikační server]].&lt;br /&gt;
* '''''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]].&lt;br /&gt;
&lt;br /&gt;
V konfiguračním souboru je nutné nastavit ''Endpoint'', ''Binding'', ''Behavior'' a ''WebApiType'', případně další nastavení.&lt;br /&gt;
&lt;br /&gt;
== Příklad ==&lt;br /&gt;
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 '''''&amp;lt;serviceCertificate&amp;gt;'''''&lt;br /&gt;
&lt;br /&gt;
SOAP a REST lze využívat souběžně.&lt;br /&gt;
&lt;br /&gt;
'''Vzorová konfigurace SOAP'''&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;lt;system.serviceModel&amp;gt;&lt;br /&gt;
  &amp;lt;services&amp;gt;  &lt;br /&gt;
    &amp;lt;service name=&amp;quot;KSProgram.AS.WCF.KSWebAPI&amp;quot; behaviorConfiguration=&amp;quot;KSWebAPIBehavior&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;host&amp;gt;&lt;br /&gt;
        &amp;lt;baseAddresses&amp;gt;&lt;br /&gt;
          &amp;lt;add baseAddress=&amp;quot;http://localhost:9001/KSAsServer/WebService/WebAPI&amp;quot;/&amp;gt;&lt;br /&gt;
        &amp;lt;/baseAddresses&amp;gt;&lt;br /&gt;
      &amp;lt;/host&amp;gt;&lt;br /&gt;
&lt;br /&gt;
      &amp;lt;endpoint address=&amp;quot;&amp;quot;&lt;br /&gt;
                binding=&amp;quot;wsHttpBinding&amp;quot;&lt;br /&gt;
                bindingConfiguration=&amp;quot;KSWebAPIBinding&amp;quot;&lt;br /&gt;
                contract=&amp;quot;KSProgram.AS.WCF.IKSWebAPI&amp;quot; /&amp;gt;&lt;br /&gt;
    &amp;lt;/service&amp;gt;&lt;br /&gt;
  &amp;lt;/services&amp;gt;&lt;br /&gt;
  &amp;lt;bindings&amp;gt;&lt;br /&gt;
      &amp;lt;wsHttpBinding&amp;gt;&lt;br /&gt;
        &amp;lt;binding name=&amp;quot;KSWebAPIBinding&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;security mode=&amp;quot;Message&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;message clientCredentialType=&amp;quot;UserName&amp;quot; /&amp;gt;&lt;br /&gt;
 &amp;lt;/security&amp;gt;&lt;br /&gt;
 &amp;lt;readerQuotas maxDepth=&amp;quot;2147483647&amp;quot; maxStringContentLength=&amp;quot;2147483647&amp;quot;&lt;br /&gt;
        maxArrayLength=&amp;quot;2147483647&amp;quot;   &lt;br /&gt;
        maxBytesPerRead=&amp;quot;2147483647&amp;quot; maxNameTableCharCount=&amp;quot;2147483647&amp;quot; /&amp;gt;&lt;br /&gt;
&amp;lt;/binding&amp;gt;&lt;br /&gt;
      &amp;lt;/wsHttpBinding&amp;gt;&lt;br /&gt;
    &amp;lt;/bindings&amp;gt;&lt;br /&gt;
&lt;br /&gt;
    &amp;lt;behaviors&amp;gt;&lt;br /&gt;
      &amp;lt;serviceBehaviors&amp;gt;&lt;br /&gt;
        &amp;lt;behavior name=&amp;quot;KSWebAPIBehavior&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;serviceMetadata httpGetEnabled=&amp;quot;true&amp;quot;/&amp;gt;&lt;br /&gt;
  &amp;lt;serviceDebug includeExceptionDetailInFaults=&amp;quot;true&amp;quot;/&amp;gt;&lt;br /&gt;
  &amp;lt;serviceCredentials&amp;gt;&lt;br /&gt;
      &amp;lt;userNameAuthentication userNamePasswordValidationMode=&amp;quot;Custom&amp;quot;  &lt;br /&gt;
             customUserNamePasswordValidatorType=&amp;quot;KSProgram.AS.WCF.PasswordValidator, WCFLib&amp;quot;/&amp;gt;&lt;br /&gt;
   &amp;lt;serviceCertificate findValue=&amp;quot;WebAPI_cert&amp;quot; storeLocation=&amp;quot;LocalMachine&amp;quot;  &lt;br /&gt;
             storeName=&amp;quot;My&amp;quot; x509FindType=&amp;quot;FindBySubjectName&amp;quot;/&amp;gt;&lt;br /&gt;
  &amp;lt;/serviceCredentials&amp;gt;&lt;br /&gt;
&amp;lt;/behavior&amp;gt;&lt;br /&gt;
      &amp;lt;/serviceBehaviors&amp;gt;&lt;br /&gt;
    &amp;lt;/behaviors&amp;gt;&lt;br /&gt;
&amp;lt;/system.serviceModel&amp;gt;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
'''Vzorová konfigurace REST'''&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;lt;system.serviceModel&amp;gt;&lt;br /&gt;
	&amp;lt;services&amp;gt;&lt;br /&gt;
		&amp;lt;service name=&amp;quot;WCFLib.KSWebAPI.RESTApi.KSWebAPIRest&amp;quot; behaviorConfiguration=&amp;quot;KSWebAPIBehaviorRest&amp;quot;&amp;gt;&lt;br /&gt;
			&amp;lt;endpoint address=&amp;quot;Rest&amp;quot; behaviorConfiguration=&amp;quot;webBehavior&amp;quot; binding=&amp;quot;webHttpBinding&amp;quot; bindingConfiguration=&amp;quot;KSWebAPIBindingRest&amp;quot; contract=&amp;quot;WCFLib.KSWebAPI.RESTApi.IKSWebAPIRest&amp;quot;/&amp;gt;&lt;br /&gt;
			&amp;lt;host&amp;gt;&lt;br /&gt;
				&amp;lt;baseAddresses&amp;gt;&lt;br /&gt;
					&amp;lt;add baseAddress=&amp;quot;https://localhost:9002/KSAsServer/WebService/WebAPI&amp;quot;/&amp;gt;&lt;br /&gt;
				&amp;lt;/baseAddresses&amp;gt;&lt;br /&gt;
			&amp;lt;/host&amp;gt;&lt;br /&gt;
		&amp;lt;/service&amp;gt;&lt;br /&gt;
	&amp;lt;/services&amp;gt;&lt;br /&gt;
	&amp;lt;bindings&amp;gt;&lt;br /&gt;
		&amp;lt;webHttpBinding&amp;gt;&lt;br /&gt;
			&amp;lt;binding name=&amp;quot;KSWebAPIBindingRest&amp;quot; maxBufferPoolSize=&amp;quot;2147483647&amp;quot; maxReceivedMessageSize=&amp;quot;2147483647&amp;quot; maxBufferSize=&amp;quot;2147483647&amp;quot; sendTimeout=&amp;quot;00:10:00&amp;quot; receiveTimeout=&amp;quot;00:10:00&amp;quot; crossDomainScriptAccessEnabled=&amp;quot;false&amp;quot;&amp;gt;&lt;br /&gt;
				&amp;lt;readerQuotas maxDepth=&amp;quot;2147483647&amp;quot; maxStringContentLength=&amp;quot;2147483647&amp;quot; maxArrayLength=&amp;quot;2147483647&amp;quot; maxBytesPerRead=&amp;quot;2147483647&amp;quot;/&amp;gt;&lt;br /&gt;
				&amp;lt;security mode=&amp;quot;Transport&amp;quot;&amp;gt;&lt;br /&gt;
				&amp;lt;/security&amp;gt;&lt;br /&gt;
			&amp;lt;/binding&amp;gt;&lt;br /&gt;
		&amp;lt;/webHttpBinding&amp;gt;&lt;br /&gt;
	&amp;lt;/bindings&amp;gt;&lt;br /&gt;
	&amp;lt;behaviors&amp;gt;&lt;br /&gt;
		&amp;lt;serviceBehaviors&amp;gt;&lt;br /&gt;
			&amp;lt;behavior name=&amp;quot;KSWebAPIBehaviorRest&amp;quot;&amp;gt;&lt;br /&gt;
				&amp;lt;serviceMetadata httpGetEnabled=&amp;quot;false&amp;quot; httpsGetEnabled=&amp;quot;true&amp;quot;/&amp;gt;&lt;br /&gt;
				&amp;lt;serviceDebug includeExceptionDetailInFaults=&amp;quot;true&amp;quot;/&amp;gt;&lt;br /&gt;
				&amp;lt;serviceCredentials&amp;gt;&lt;br /&gt;
					&amp;lt;serviceCertificate findValue=&amp;quot;4564qwe23gdf8gd32f4fhf6f12s3a1sd&amp;quot; storeLocation=&amp;quot;LocalMachine&amp;quot; storeName=&amp;quot;My&amp;quot; x509FindType=&amp;quot;FindBySerialNumber&amp;quot;/&amp;gt;&lt;br /&gt;
				&amp;lt;/serviceCredentials&amp;gt;&lt;br /&gt;
			&amp;lt;/behavior&amp;gt;&lt;br /&gt;
		&amp;lt;/serviceBehaviors&amp;gt;&lt;br /&gt;
		&amp;lt;endpointBehaviors&amp;gt;&lt;br /&gt;
			&amp;lt;behavior name=&amp;quot;webBehavior&amp;quot;&amp;gt;&lt;br /&gt;
				&amp;lt;webHttp defaultOutgoingResponseFormat=&amp;quot;Json&amp;quot;/&amp;gt;&lt;br /&gt;
			&amp;lt;/behavior&amp;gt;&lt;br /&gt;
		&amp;lt;/endpointBehaviors&amp;gt;&lt;br /&gt;
	&amp;lt;/behaviors&amp;gt;&lt;br /&gt;
	&amp;lt;standardEndpoints&amp;gt;&lt;br /&gt;
		&amp;lt;webScriptEndpoint&amp;gt;&lt;br /&gt;
			&amp;lt;standardEndpoint crossDomainScriptAccessEnabled=&amp;quot;true&amp;quot;&amp;gt;&lt;br /&gt;
			&amp;lt;/standardEndpoint&amp;gt;&lt;br /&gt;
		&amp;lt;/webScriptEndpoint&amp;gt;&lt;br /&gt;
	&amp;lt;/standardEndpoints&amp;gt;&lt;br /&gt;
	&amp;lt;serviceHostingEnvironment aspNetCompatibilityEnabled=&amp;quot;true&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/system.serviceModel&amp;gt;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== AS Seance Manager - Úloha č. 73 ==&lt;br /&gt;
[[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'''''.&lt;br /&gt;
&lt;br /&gt;
V případě KS webAPI je zde typ úlohy &lt;br /&gt;
* '''''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.&lt;br /&gt;
&lt;br /&gt;
ASSM (soubor '''ASSeanceManager.exe''') je nutné spouštět jako '''správce'''.&lt;br /&gt;
&lt;br /&gt;
[[Soubor:Nastaveni-as-seancemanager-webapi.jpg|450px]]&lt;br /&gt;
&lt;br /&gt;
===Správa uživatelů===&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
[[Image: KSwebAPI-Konektor Advanto-SpravaUzivatelu.png|400px]] &lt;br /&gt;
&amp;lt;!-- [[Soubor:Sprava-uzivatelu-KS-WEBAPI.jpg|350px]] --&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Oprávnění na položky ===&lt;br /&gt;
&lt;br /&gt;
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. &lt;br /&gt;
&lt;br /&gt;
[[Soubor:Pristupova-prava-polozky-ks-webapi.jpg|350px]]&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Správa (KS webAPI)]]&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=TypyPozadavkuExtCall&amp;diff=48263</id>
		<title>TypyPozadavkuExtCall</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=TypyPozadavkuExtCall&amp;diff=48263"/>
		<updated>2025-05-05T11:01:06Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;'''TypyPozadavkuExtCall''' je [[Parametry (KS portál)|parametr]] určující, které typy požadavků se mají odesílat přes WorkFlowExtCall.&lt;br /&gt;
&lt;br /&gt;
== Funkcionalita ==&lt;br /&gt;
&lt;br /&gt;
{|border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Název&lt;br /&gt;
| TypyPozadavkuExtCall&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Skupina&lt;br /&gt;
| Požadavky&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Popis&lt;br /&gt;
| Typy požadavků, které se mají odesílat přes WorkFlowExtCall. Pro všechny *. Oddělovačem je čárka. Př.: absence, dovol, dochazka&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Rozsah &lt;br /&gt;
| &lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Typy požadavků ==&lt;br /&gt;
&lt;br /&gt;
Základní seznam typů požadavků.&lt;br /&gt;
&amp;lt;ul&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Dovolená&amp;lt;/strong&amp;gt; – dovol&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Služební cesta&amp;lt;/strong&amp;gt; – sluzc&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Docházka&amp;lt;/strong&amp;gt; – dochazka&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Náhrada výdajů&amp;lt;/strong&amp;gt; – nahrv&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Školení&amp;lt;/strong&amp;gt; – skol&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Změna osobních údajů&amp;lt;/strong&amp;gt; – zmosudaju&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Odměny&amp;lt;/strong&amp;gt; – odmeny&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Benefity&amp;lt;/strong&amp;gt; – benefit&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Absence&amp;lt;/strong&amp;gt; – absence&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Ověřování údajů&amp;lt;/strong&amp;gt; – overovani&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Řešení konfliktů&amp;lt;/strong&amp;gt; – konflikt&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Stornování absence&amp;lt;/strong&amp;gt; – stabs&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Plán dovolené&amp;lt;/strong&amp;gt; – plandovol&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Relevantní skutečnosti&amp;lt;/strong&amp;gt; – relev&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Nástup zaměstnance&amp;lt;/strong&amp;gt; – nastupzam&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Změna pracovního poměru&amp;lt;/strong&amp;gt; – zmppv&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Práce na projektech&amp;lt;/strong&amp;gt; – dobanaproj&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Prémie Fond Odměn&amp;lt;/strong&amp;gt; – premiefo&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Dokument (obecný požadavek)&amp;lt;/strong&amp;gt; – dokument&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Žádost o schválení pracovního místa&amp;lt;/strong&amp;gt; – pracmisto&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Žádost o změnu bankovního účtu&amp;lt;/strong&amp;gt; – zmuctu&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Prohlášení k dani&amp;lt;/strong&amp;gt; – danprohl&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Žádost o roční zúčtování&amp;lt;/strong&amp;gt; – zroczuct&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Odměny sloupcově&amp;lt;/strong&amp;gt; – odmenysl&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Odměny sloupcově 1&amp;lt;/strong&amp;gt; – odmenysl1&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Odměny sloupcově 2&amp;lt;/strong&amp;gt; – odmenysl2&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Odměny sloupcově 3&amp;lt;/strong&amp;gt; – odmenysl3&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Odměny sloupcově 4&amp;lt;/strong&amp;gt; – odmenysl4&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Odměny sloupcově 5&amp;lt;/strong&amp;gt; – odmenysl5&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Kategorie vzdělávání&amp;lt;/strong&amp;gt; – katvzdel&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Podpis&amp;lt;/strong&amp;gt; – podpis&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Přidání vozu&amp;lt;/strong&amp;gt; – vozidlo&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Převod dovolené do dalšího roku&amp;lt;/strong&amp;gt; – prevdov&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Roční plánování&amp;lt;/strong&amp;gt; – annual&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Rozpočet&amp;lt;/strong&amp;gt; – budget&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Založení školení&amp;lt;/strong&amp;gt; – zalozskol&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Předpisy&amp;lt;/strong&amp;gt; – predpisy&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Půjčení vozu&amp;lt;/strong&amp;gt; – pujcvuz&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Rozpis hodin&amp;lt;/strong&amp;gt; – rozphod&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Nespecifikováno&amp;lt;/strong&amp;gt; – nespecifikovano&amp;lt;/li&amp;gt;&lt;br /&gt;
&amp;lt;/ul&amp;gt;&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=TypyPozadavkuExtCall&amp;diff=48262</id>
		<title>TypyPozadavkuExtCall</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=TypyPozadavkuExtCall&amp;diff=48262"/>
		<updated>2025-05-05T11:00:19Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;'''TypyPozadavkuExtCall''' je [[Parametry (KS portál)|parametr]] určující, které typy požadavků se mají odesílat přes WorkFlowExtCall.&lt;br /&gt;
&lt;br /&gt;
== Funkcionalita ==&lt;br /&gt;
&lt;br /&gt;
{|border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Název&lt;br /&gt;
| TypyPozadavkuExtCall&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Skupina&lt;br /&gt;
| Požadavky&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Popis&lt;br /&gt;
| Typy požadavků, které se mají odesílat přes WorkFlowExtCall. Pro všechny *. Oddělovačem je čárka. Př.: absence, dovol, dochazka&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Rozsah &lt;br /&gt;
| &lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Typy požadavků ==&lt;br /&gt;
&lt;br /&gt;
Základní seznam typů požadavků.&lt;br /&gt;
&amp;lt;ul&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Dovolená&amp;lt;/strong&amp;gt; – dovol&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Služební cesta&amp;lt;/strong&amp;gt; – sluzc&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Docházka&amp;lt;/strong&amp;gt; – dochazka&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Náhrada výdajů&amp;lt;/strong&amp;gt; – nahrv&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Školení&amp;lt;/strong&amp;gt; – skol&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Změna osobních údajů&amp;lt;/strong&amp;gt; – zmosudaju&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Odměny&amp;lt;/strong&amp;gt; – odmeny&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Benefity&amp;lt;/strong&amp;gt; – benefit&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Absence&amp;lt;/strong&amp;gt; – absence&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Ověřování údajů&amp;lt;/strong&amp;gt; – overovani&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Řešení konfliktů&amp;lt;/strong&amp;gt; – konflikt&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Stornování absence&amp;lt;/strong&amp;gt; – stabs&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Plán dovolené&amp;lt;/strong&amp;gt; – plandovol&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Relevantní skutečnosti&amp;lt;/strong&amp;gt; – relev&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Nástup zaměstnance&amp;lt;/strong&amp;gt; – nastupzam&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Změna pracovního poměru&amp;lt;/strong&amp;gt; – zmppv&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Práce na projektech&amp;lt;/strong&amp;gt; – dobanaproj&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Prémie Fond Odměn&amp;lt;/strong&amp;gt; – premiefo&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Běžné výdaje (Provident)&amp;lt;/strong&amp;gt; – vydaje&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Dokument (obecný požadavek)&amp;lt;/strong&amp;gt; – dokument&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Žádost o schválení pracovního místa&amp;lt;/strong&amp;gt; – pracmisto&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Žádost o změnu bankovního účtu&amp;lt;/strong&amp;gt; – zmuctu&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Prohlášení k dani&amp;lt;/strong&amp;gt; – danprohl&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Žádost o roční zúčtování&amp;lt;/strong&amp;gt; – zroczuct&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Odměny sloupcově&amp;lt;/strong&amp;gt; – odmenysl&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Odměny sloupcově 1&amp;lt;/strong&amp;gt; – odmenysl1&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Odměny sloupcově 2&amp;lt;/strong&amp;gt; – odmenysl2&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Odměny sloupcově 3&amp;lt;/strong&amp;gt; – odmenysl3&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Odměny sloupcově 4&amp;lt;/strong&amp;gt; – odmenysl4&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Odměny sloupcově 5&amp;lt;/strong&amp;gt; – odmenysl5&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Kategorie vzdělávání&amp;lt;/strong&amp;gt; – katvzdel&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Podpis&amp;lt;/strong&amp;gt; – podpis&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Přidání vozu&amp;lt;/strong&amp;gt; – vozidlo&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Převod dovolené do dalšího roku&amp;lt;/strong&amp;gt; – prevdov&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Roční plánování&amp;lt;/strong&amp;gt; – annual&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Rozpočet&amp;lt;/strong&amp;gt; – budget&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Založení školení&amp;lt;/strong&amp;gt; – zalozskol&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Předpisy&amp;lt;/strong&amp;gt; – predpisy&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Půjčení vozu&amp;lt;/strong&amp;gt; – pujcvuz&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Rozpis hodin&amp;lt;/strong&amp;gt; – rozphod&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Nespecifikováno&amp;lt;/strong&amp;gt; – nespecifikovano&amp;lt;/li&amp;gt;&lt;br /&gt;
&amp;lt;/ul&amp;gt;&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=TypyPozadavkuExtCall&amp;diff=48261</id>
		<title>TypyPozadavkuExtCall</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=TypyPozadavkuExtCall&amp;diff=48261"/>
		<updated>2025-05-05T10:59:38Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;'''TypyPozadavkuExtCall''' je [[Parametry (KS portál)|parametr]] určující, které typy požadavků se mají odesílat přes WorkFlowExtCall.&lt;br /&gt;
&lt;br /&gt;
== Funkcionalita ==&lt;br /&gt;
&lt;br /&gt;
{|border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Název&lt;br /&gt;
| TypyPozadavkuExtCall&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Skupina&lt;br /&gt;
| Požadavky&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Popis&lt;br /&gt;
| Typy požadavků, které se mají odesílat přes WorkFlowExtCall. Pro všechny *. Oddělovačem je čárka. Př.: absence, dovol, dochazka&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Rozsah &lt;br /&gt;
| &lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
'''Typy požadavků'''&lt;br /&gt;
&lt;br /&gt;
Základní seznam typů požadavků.&lt;br /&gt;
&amp;lt;ul&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Dovolená&amp;lt;/strong&amp;gt; – dovol&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Služební cesta&amp;lt;/strong&amp;gt; – sluzc&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Docházka&amp;lt;/strong&amp;gt; – dochazka&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Náhrada výdajů&amp;lt;/strong&amp;gt; – nahrv&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Školení&amp;lt;/strong&amp;gt; – skol&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Změna osobních údajů&amp;lt;/strong&amp;gt; – zmosudaju&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Odměny&amp;lt;/strong&amp;gt; – odmeny&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Benefity&amp;lt;/strong&amp;gt; – benefit&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Absence&amp;lt;/strong&amp;gt; – absence&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Ověřování údajů&amp;lt;/strong&amp;gt; – overovani&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Řešení konfliktů&amp;lt;/strong&amp;gt; – konflikt&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Stornování absence&amp;lt;/strong&amp;gt; – stabs&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Plán dovolené&amp;lt;/strong&amp;gt; – plandovol&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Relevantní skutečnosti&amp;lt;/strong&amp;gt; – relev&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Nástup zaměstnance&amp;lt;/strong&amp;gt; – nastupzam&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Změna pracovního poměru&amp;lt;/strong&amp;gt; – zmppv&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Práce na projektech&amp;lt;/strong&amp;gt; – dobanaproj&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Prémie Fond Odměn&amp;lt;/strong&amp;gt; – premiefo&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Běžné výdaje (Provident)&amp;lt;/strong&amp;gt; – vydaje&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Dokument (obecný požadavek)&amp;lt;/strong&amp;gt; – dokument&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Žádost o schválení pracovního místa&amp;lt;/strong&amp;gt; – pracmisto&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Žádost o změnu bankovního účtu&amp;lt;/strong&amp;gt; – zmuctu&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Prohlášení k dani&amp;lt;/strong&amp;gt; – danprohl&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Žádost o roční zúčtování&amp;lt;/strong&amp;gt; – zroczuct&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Odměny sloupcově&amp;lt;/strong&amp;gt; – odmenysl&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Odměny sloupcově 1&amp;lt;/strong&amp;gt; – odmenysl1&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Odměny sloupcově 2&amp;lt;/strong&amp;gt; – odmenysl2&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Odměny sloupcově 3&amp;lt;/strong&amp;gt; – odmenysl3&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Odměny sloupcově 4&amp;lt;/strong&amp;gt; – odmenysl4&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Odměny sloupcově 5&amp;lt;/strong&amp;gt; – odmenysl5&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Kategorie vzdělávání&amp;lt;/strong&amp;gt; – katvzdel&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Podpis&amp;lt;/strong&amp;gt; – podpis&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Přidání vozu&amp;lt;/strong&amp;gt; – vozidlo&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Převod dovolené do dalšího roku&amp;lt;/strong&amp;gt; – prevdov&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Roční plánování&amp;lt;/strong&amp;gt; – annual&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Rozpočet&amp;lt;/strong&amp;gt; – budget&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Založení školení&amp;lt;/strong&amp;gt; – zalozskol&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Předpisy&amp;lt;/strong&amp;gt; – predpisy&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Půjčení vozu&amp;lt;/strong&amp;gt; – pujcvuz&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Rozpis hodin&amp;lt;/strong&amp;gt; – rozphod&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Nespecifikováno&amp;lt;/strong&amp;gt; – nespecifikovano&amp;lt;/li&amp;gt;&lt;br /&gt;
&amp;lt;/ul&amp;gt;&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Parametry_(Po%C5%BEadavky)&amp;diff=48260</id>
		<title>Parametry (Požadavky)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Parametry_(Po%C5%BEadavky)&amp;diff=48260"/>
		<updated>2025-05-05T10:59:30Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;'''Parametry (Požadavky)'''&lt;br /&gt;
&lt;br /&gt;
{|class=&amp;quot;wikitable sortable&amp;quot; border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
| &amp;lt;center&amp;gt;'''Skupina'''&amp;lt;/center&amp;gt;&lt;br /&gt;
| &amp;lt;center&amp;gt;'''Název'''&amp;lt;/center&amp;gt;&lt;br /&gt;
| &amp;lt;center&amp;gt;'''Popis'''&amp;lt;/center&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[absence_volne_dny]]||Nastavuje zda se při žádosti o absenci má povolit žádost na volné dny. Hodnoty 'a'- ano, 'n'- ne, 'n'-ne&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[AbsenceKody]]||Určuje seznam docházkových kódů pro zpracování v požadavku typu 'Absence'. Oddělovačem je čárka&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[AbsenceOmezeni]]||Určuje, zda při schvalování absence povolovat pokračování podle uzavřenosti období nebo podle kalendářního data., o-období, k-kalendářní datum&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[AdresatiVMimoev]]||Pokud nastaven na 'a' tak adresátem požadavku budou i zaměstnanci v mimoevidenčním stavu.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[BenefitniVolnoKody]]||Kódy docházkových kódů určené pr benefitní volno. Oddělovačem je čárka.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[BVaDovolKontrola]]||Pokud nastaveno na ano, tak se při žádosti o dovolenou bude kontrolovat zůstatek dovolené spolu s benefitním volnem dohromady.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[DiskuseEmail]]||Určuje, zda se mají odesílat emaily při zadání diskuze do požadavku, a-ano, n-ne.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[DanPocetPriloh]]||Kontrolovat počet příloh v prohlášení a v žádosti o RZ?&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[Dochazka]]||Zapnutí(a), vypnutí(n) nebo zapnutí vyjma mimoev.stav(e) schvalovacího procesu na docházku. Možné hodnoty 'a', 'n', 'e'&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[DochazkaRestart]]||Pokud nastaven na 'a', tak se automaticky po smazání požadavku na docházku vytvoří nový požadavek.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||&amp;lt;s&amp;gt;[[DovolPouzivat]]&amp;lt;/s&amp;gt;||&amp;lt;s&amp;gt;Zapnutí, vypnutí používání požadavku typu dovolená. Možné hodnoty 'a', 'n'&amp;lt;/s&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[DovolSchvaleno]]||Kam se má zapsat schválená dovolená. Hodnoty:'a'-absence, 'd'-docházka, 'e'-tabulka ex_absence&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[EmailOdkud]]||Odkud zjišťovat email zaměstnance: ev-evidence, ad-ActiveDirectory&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[ExtCallURL]]||URL pro externí systém pro schvalování požadavků&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[ChybyNaEmail]]||Email adresa, na kterou budou posílány chyby (např. nenalezení adresáta)&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[KontrolaCasuZadani]]||Kontrola na zadání času v požadavku na absenci. Čas nesmí být mimo plánovanou směnu. Možné hodnoty:m-jen proti kalendářům, a-kalendáře i model, n-nepoužívat&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[KodyNeorezPD]]||Zadávají se doch. kódy, u kterých se při zápisu přes požadavek typu absence nemá čas ořezávat podle plánované směny, oddělovačem je čárka.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[NačítatAutomaticky]]||Nastavuje výchozí stav tlačítka ''Načítat automaticky''.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[NačítatAutomatickyUložení]]||Nastavuje, ja dlouho si tlačítko ''Načítat automaticky'' bude pamatovat svou uživatelem změněnou hodnotu. (stránka) - v rámci práce ve stránce Požadavky, (přihlášení) - v rámci jednoho přihlášení do aplikace, (stále)- nastavení se uloží na stálo&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[NepřítNaPracKontr]]|| Zapíná kontrolu na překrytí nepřítomnosti na pracovišti pokud se jedná o odprac. dobu&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[NVSchvaleno]]||Kam se má zapsat schválené náhr. volno. Hodnoty:'a'-absence, 'd'-docházka&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[OdmenyLimityKontrola]]||Určuje, zda se při ukládání požadavku na odměny má provádět kontrola hodnoty limitů. Hodnoty 'c' - sazby a částky, 'n' - ne&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[odmeny_poznamka]]||Nastavuje, zda lze v žádosti o odměny zadávat poznámku. Hodnoty 'a'- ano, 'n'- ne&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[odmeny_sobe]]||Nastavuje, zda lze v žádosti o odměny povolit zadávat odměnu sám sobě. Hodnoty 'a'- ano, 'n'- ne&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[OdměnySlExtra1Popisek]]||Nastavuje popisek extra požadavku na odměny sloupcově, varianta 1&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[PlatbaKod]]||Kód který určuje platbu pro požadavek na změnu účtu&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[PlatbaKonstSymb]]||Konstantní symbol,který bude přiřazen nové platbě&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[PlatbaVarSymb]]||Variabilní symbol,který bude přiřazen nové platbě&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[PodepsaneProhlaseni]]||Kontrolovat podepsané prohlášení při žádosti o RZ?&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[PozadavkyZastup]]||Povolit založení požadavku za jiné zaměstnance '0'-není povoleno, '1'-je povoleno&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[PozadKalendarOmezit]]||Omezení plánovacího kalendáře v požadavcích na organizační jednotku. 'prac_mist'-pracovní místo, 'prac_str'-pracovní středisko, 'kmen_str'-kmenové středisko&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[PravaCitlivePoz]]||Zapíná/vypíná práva na citlivé požadavky &lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[SeznWorkflAdr]]||	Pokud nastaven na ano, tak seznam požadavků bude při načítání využívat workl_adresat(Spustit jednoráz. funkci č. 133, 'Inicializace workfl_adresati')&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[Split]]||Pokud nastaven na 'a' tak schválené absence zapíše také k os. číslům se stejným rodným číslem.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[TypyPozadavkuExtCall]]||Typy požadavků, které se mají odesílat přes WorkFlowExtCall. Pro všechny *. Oddělovačem je čárka. Př.: absence, dovol, dochazka.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[VyloučitStorna]]||Pokud nastaven na 'a', tak stornované absence a dovolené se nebudou zobrazovat v seznamu požadavků. &lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[WorkflAutUzavir]]||Zapnutí/vypnutí automatického uzavírání požadavků&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[WorkflInterNotif]]||Interval v hod. odesílání upozornění na blížící se vypršení požadavku&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[WorkflStartNotif]]||Doba v hod pro začátek odesílání upozornění na vypršení požadavku&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[ZapisNVKod]]||Kód zápisu schváleného náhr. volna. Možné hodnoty: kód NV nebo 0&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[ZapisSCKod]]||Kód pro zápis schválené služební cesty do docházky. Možné hodnoty: kód služební cesty nebo 0&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[ZobrazObdobiPoz]]||Jaké období se má zobrazovat v požadavcích.a-aktuální měsíc,m-mzdové období&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Parametry (KS portál)]]&lt;br /&gt;
* [[Požadavky (KS portál)]]&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=TypyPozadavkuExtCall&amp;diff=48259</id>
		<title>TypyPozadavkuExtCall</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=TypyPozadavkuExtCall&amp;diff=48259"/>
		<updated>2025-05-05T10:58:56Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: založena nová stránka s textem „'''TypyPozadavkuExtCall''' je parametr určující, které typy požadavků se mají odesílat přes WorkFlowExtCall.  == Funkcionalita ==  {|border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot; |- ! scope=&amp;quot;row&amp;quot;| Název | TypyPozadavkuExtCall |- ! scope=&amp;quot;row&amp;quot;| Skupina | Požadavky |- ! scope=&amp;quot;row&amp;quot;| Popis | Typy požadavků, které se mají odesílat přes WorkFlowExtCall. Pro všechny *. Oddělovačem je čárka. Př.: absence, dovol,…“&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;'''TypyPozadavkuExtCall''' je [[Parametry (KS portál)|parametr]] určující, které typy požadavků se mají odesílat přes WorkFlowExtCall.&lt;br /&gt;
&lt;br /&gt;
== Funkcionalita ==&lt;br /&gt;
&lt;br /&gt;
{|border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Název&lt;br /&gt;
| TypyPozadavkuExtCall&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Skupina&lt;br /&gt;
| Požadavky&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Popis&lt;br /&gt;
| Typy požadavků, které se mají odesílat přes WorkFlowExtCall. Pro všechny *. Oddělovačem je čárka. Př.: absence, dovol, dochazka&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Rozsah &lt;br /&gt;
| &lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=ExtCallURL&amp;diff=48258</id>
		<title>ExtCallURL</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=ExtCallURL&amp;diff=48258"/>
		<updated>2025-05-05T10:57:17Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: /* Funkcionalita */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;'''ExtCallURL''' je [[Parametry (KS portál)|parametr]] určující URL externího systému pro schvalování požadavků pomocí e-mailu.&lt;br /&gt;
&lt;br /&gt;
== Funkcionalita ==&lt;br /&gt;
&lt;br /&gt;
{|border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Název&lt;br /&gt;
| ExtCallURL&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Skupina&lt;br /&gt;
| Požadavky&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Popis&lt;br /&gt;
| URL pro externí systém pro schvalování požadavků&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Rozsah &lt;br /&gt;
| &lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=ExtCallURL&amp;diff=48257</id>
		<title>ExtCallURL</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=ExtCallURL&amp;diff=48257"/>
		<updated>2025-05-05T10:56:54Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: založena nová stránka s textem „'''ExtCallURL''' je parametr určující URL externího systému pro schvalování požadavků pomocí e-mailu.  == Funkcionalita ==  {|border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot; |- ! scope=&amp;quot;row&amp;quot;| Název | ExtCallURL |- ! scope=&amp;quot;row&amp;quot;| Skupina | Požadavky |- ! scope=&amp;quot;row&amp;quot;| Popis | URL pro externí systém pro schvalování požadavků |- ! scope=&amp;quot;row&amp;quot;| Rozsah  | ev/ad |}“&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;'''ExtCallURL''' je [[Parametry (KS portál)|parametr]] určující URL externího systému pro schvalování požadavků pomocí e-mailu.&lt;br /&gt;
&lt;br /&gt;
== Funkcionalita ==&lt;br /&gt;
&lt;br /&gt;
{|border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Název&lt;br /&gt;
| ExtCallURL&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Skupina&lt;br /&gt;
| Požadavky&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Popis&lt;br /&gt;
| URL pro externí systém pro schvalování požadavků&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Rozsah &lt;br /&gt;
| ev/ad&lt;br /&gt;
|}&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Parametry_(Po%C5%BEadavky)&amp;diff=48256</id>
		<title>Parametry (Požadavky)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Parametry_(Po%C5%BEadavky)&amp;diff=48256"/>
		<updated>2025-05-05T10:55:01Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;'''Parametry (Požadavky)'''&lt;br /&gt;
&lt;br /&gt;
{|class=&amp;quot;wikitable sortable&amp;quot; border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
| &amp;lt;center&amp;gt;'''Skupina'''&amp;lt;/center&amp;gt;&lt;br /&gt;
| &amp;lt;center&amp;gt;'''Název'''&amp;lt;/center&amp;gt;&lt;br /&gt;
| &amp;lt;center&amp;gt;'''Popis'''&amp;lt;/center&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[absence_volne_dny]]||Nastavuje zda se při žádosti o absenci má povolit žádost na volné dny. Hodnoty 'a'- ano, 'n'- ne, 'n'-ne&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[AbsenceKody]]||Určuje seznam docházkových kódů pro zpracování v požadavku typu 'Absence'. Oddělovačem je čárka&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[AbsenceOmezeni]]||Určuje, zda při schvalování absence povolovat pokračování podle uzavřenosti období nebo podle kalendářního data., o-období, k-kalendářní datum&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[AdresatiVMimoev]]||Pokud nastaven na 'a' tak adresátem požadavku budou i zaměstnanci v mimoevidenčním stavu.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[BenefitniVolnoKody]]||Kódy docházkových kódů určené pr benefitní volno. Oddělovačem je čárka.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[BVaDovolKontrola]]||Pokud nastaveno na ano, tak se při žádosti o dovolenou bude kontrolovat zůstatek dovolené spolu s benefitním volnem dohromady.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[DiskuseEmail]]||Určuje, zda se mají odesílat emaily při zadání diskuze do požadavku, a-ano, n-ne.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[DanPocetPriloh]]||Kontrolovat počet příloh v prohlášení a v žádosti o RZ?&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[Dochazka]]||Zapnutí(a), vypnutí(n) nebo zapnutí vyjma mimoev.stav(e) schvalovacího procesu na docházku. Možné hodnoty 'a', 'n', 'e'&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[DochazkaRestart]]||Pokud nastaven na 'a', tak se automaticky po smazání požadavku na docházku vytvoří nový požadavek.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||&amp;lt;s&amp;gt;[[DovolPouzivat]]&amp;lt;/s&amp;gt;||&amp;lt;s&amp;gt;Zapnutí, vypnutí používání požadavku typu dovolená. Možné hodnoty 'a', 'n'&amp;lt;/s&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[DovolSchvaleno]]||Kam se má zapsat schválená dovolená. Hodnoty:'a'-absence, 'd'-docházka, 'e'-tabulka ex_absence&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[EmailOdkud]]||Odkud zjišťovat email zaměstnance: ev-evidence, ad-ActiveDirectory&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[ExtCallURL]]||URL pro externí systém pro schvalování požadavků&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[ChybyNaEmail]]||Email adresa, na kterou budou posílány chyby (např. nenalezení adresáta)&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[KontrolaCasuZadani]]||Kontrola na zadání času v požadavku na absenci. Čas nesmí být mimo plánovanou směnu. Možné hodnoty:m-jen proti kalendářům, a-kalendáře i model, n-nepoužívat&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[KodyNeorezPD]]||Zadávají se doch. kódy, u kterých se při zápisu přes požadavek typu absence nemá čas ořezávat podle plánované směny, oddělovačem je čárka.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[NačítatAutomaticky]]||Nastavuje výchozí stav tlačítka ''Načítat automaticky''.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[NačítatAutomatickyUložení]]||Nastavuje, ja dlouho si tlačítko ''Načítat automaticky'' bude pamatovat svou uživatelem změněnou hodnotu. (stránka) - v rámci práce ve stránce Požadavky, (přihlášení) - v rámci jednoho přihlášení do aplikace, (stále)- nastavení se uloží na stálo&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[NepřítNaPracKontr]]|| Zapíná kontrolu na překrytí nepřítomnosti na pracovišti pokud se jedná o odprac. dobu&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[NVSchvaleno]]||Kam se má zapsat schválené náhr. volno. Hodnoty:'a'-absence, 'd'-docházka&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[OdmenyLimityKontrola]]||Určuje, zda se při ukládání požadavku na odměny má provádět kontrola hodnoty limitů. Hodnoty 'c' - sazby a částky, 'n' - ne&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[odmeny_poznamka]]||Nastavuje, zda lze v žádosti o odměny zadávat poznámku. Hodnoty 'a'- ano, 'n'- ne&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[odmeny_sobe]]||Nastavuje, zda lze v žádosti o odměny povolit zadávat odměnu sám sobě. Hodnoty 'a'- ano, 'n'- ne&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[OdměnySlExtra1Popisek]]||Nastavuje popisek extra požadavku na odměny sloupcově, varianta 1&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[PlatbaKod]]||Kód který určuje platbu pro požadavek na změnu účtu&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[PlatbaKonstSymb]]||Konstantní symbol,který bude přiřazen nové platbě&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[PlatbaVarSymb]]||Variabilní symbol,který bude přiřazen nové platbě&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[PodepsaneProhlaseni]]||Kontrolovat podepsané prohlášení při žádosti o RZ?&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[PozadavkyZastup]]||Povolit založení požadavku za jiné zaměstnance '0'-není povoleno, '1'-je povoleno&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[PozadKalendarOmezit]]||Omezení plánovacího kalendáře v požadavcích na organizační jednotku. 'prac_mist'-pracovní místo, 'prac_str'-pracovní středisko, 'kmen_str'-kmenové středisko&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[PravaCitlivePoz]]||Zapíná/vypíná práva na citlivé požadavky &lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[SeznWorkflAdr]]||	Pokud nastaven na ano, tak seznam požadavků bude při načítání využívat workl_adresat(Spustit jednoráz. funkci č. 133, 'Inicializace workfl_adresati')&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[Split]]||Pokud nastaven na 'a' tak schválené absence zapíše také k os. číslům se stejným rodným číslem.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[TypyPozadavkuExtCall]]||Typy požadavků, které se mají odesílat přes WorkFlowExtCall. Pro všechny *. Oddělovačem je čárka. Př.: absence, dovol, dochazka.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[VyloučitStorna]]||Pokud nastaven na 'a', tak stornované absence a dovolené se nebudou zobrazovat v seznamu požadavků. &lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[WorkflAutUzavir]]||Zapnutí/vypnutí automatického uzavírání požadavků&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[WorkflInterNotif]]||Interval v hod. odesílání upozornění na blížící se vypršení požadavku&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[WorkflStartNotif]]||Doba v hod pro začátek odesílání upozornění na vypršení požadavku&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[ZapisNVKod]]||Kód zápisu schváleného náhr. volna. Možné hodnoty: kód NV nebo 0&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[ZapisSCKod]]||Kód pro zápis schválené služební cesty do docházky. Možné hodnoty: kód služební cesty nebo 0&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;Požadavky&amp;lt;/center&amp;gt;||[[ZobrazObdobiPoz]]||Jaké období se má zobrazovat v požadavcích.a-aktuální měsíc,m-mzdové období&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
'''Typy požadavků'''&lt;br /&gt;
&lt;br /&gt;
Základní seznam typů požadavků.&lt;br /&gt;
&amp;lt;ul&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Dovolená&amp;lt;/strong&amp;gt; – dovol&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Služební cesta&amp;lt;/strong&amp;gt; – sluzc&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Docházka&amp;lt;/strong&amp;gt; – dochazka&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Náhrada výdajů&amp;lt;/strong&amp;gt; – nahrv&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Školení&amp;lt;/strong&amp;gt; – skol&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Změna osobních údajů&amp;lt;/strong&amp;gt; – zmosudaju&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Odměny&amp;lt;/strong&amp;gt; – odmeny&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Benefity&amp;lt;/strong&amp;gt; – benefit&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Absence&amp;lt;/strong&amp;gt; – absence&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Ověřování údajů&amp;lt;/strong&amp;gt; – overovani&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Řešení konfliktů&amp;lt;/strong&amp;gt; – konflikt&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Stornování absence&amp;lt;/strong&amp;gt; – stabs&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Plán dovolené&amp;lt;/strong&amp;gt; – plandovol&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Relevantní skutečnosti&amp;lt;/strong&amp;gt; – relev&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Nástup zaměstnance&amp;lt;/strong&amp;gt; – nastupzam&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Změna pracovního poměru&amp;lt;/strong&amp;gt; – zmppv&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Práce na projektech&amp;lt;/strong&amp;gt; – dobanaproj&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Prémie Fond Odměn&amp;lt;/strong&amp;gt; – premiefo&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Běžné výdaje (Provident)&amp;lt;/strong&amp;gt; – vydaje&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Dokument (obecný požadavek)&amp;lt;/strong&amp;gt; – dokument&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Žádost o schválení pracovního místa&amp;lt;/strong&amp;gt; – pracmisto&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Žádost o změnu bankovního účtu&amp;lt;/strong&amp;gt; – zmuctu&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Prohlášení k dani&amp;lt;/strong&amp;gt; – danprohl&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Žádost o roční zúčtování&amp;lt;/strong&amp;gt; – zroczuct&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Odměny sloupcově&amp;lt;/strong&amp;gt; – odmenysl&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Odměny sloupcově 1&amp;lt;/strong&amp;gt; – odmenysl1&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Odměny sloupcově 2&amp;lt;/strong&amp;gt; – odmenysl2&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Odměny sloupcově 3&amp;lt;/strong&amp;gt; – odmenysl3&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Odměny sloupcově 4&amp;lt;/strong&amp;gt; – odmenysl4&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Odměny sloupcově 5&amp;lt;/strong&amp;gt; – odmenysl5&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Kategorie vzdělávání&amp;lt;/strong&amp;gt; – katvzdel&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Podpis&amp;lt;/strong&amp;gt; – podpis&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Přidání vozu&amp;lt;/strong&amp;gt; – vozidlo&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Převod dovolené do dalšího roku&amp;lt;/strong&amp;gt; – prevdov&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Roční plánování&amp;lt;/strong&amp;gt; – annual&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Rozpočet&amp;lt;/strong&amp;gt; – budget&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Založení školení&amp;lt;/strong&amp;gt; – zalozskol&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Předpisy&amp;lt;/strong&amp;gt; – predpisy&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Půjčení vozu&amp;lt;/strong&amp;gt; – pujcvuz&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Rozpis hodin&amp;lt;/strong&amp;gt; – rozphod&amp;lt;/li&amp;gt;&lt;br /&gt;
  &amp;lt;li&amp;gt;&amp;lt;strong&amp;gt;Nespecifikováno&amp;lt;/strong&amp;gt; – nespecifikovano&amp;lt;/li&amp;gt;&lt;br /&gt;
&amp;lt;/ul&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Parametry (KS portál)]]&lt;br /&gt;
* [[Požadavky (KS portál)]]&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Import_pr%C5%AFchod%C5%AF&amp;diff=47970</id>
		<title>Import průchodů</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Import_pr%C5%AFchod%C5%AF&amp;diff=47970"/>
		<updated>2025-03-11T14:17:02Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Import průchodů je [[Rozšíření aplikace]] &amp;lt;small&amp;gt;([[KS docházka (Rozšíření aplikace)]])&amp;lt;/small&amp;gt;., které umožňuje importovat data z docházkových, nebo přístupových systémů třetích stran do modulu Docházka v aplikaci KS Portál.&lt;br /&gt;
&lt;br /&gt;
Způsob importu průchodů závisí na verzi KS Docházky:&lt;br /&gt;
&amp;lt;ul&amp;gt;&lt;br /&gt;
    &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;KS Docházka (starší verze)&amp;lt;/b&amp;gt;&lt;br /&gt;
        &amp;lt;ul&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;Využívá webovou službu dostupnou v aplikaci &amp;lt;b&amp;gt;KS Portál&amp;lt;/b&amp;gt;.&amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;Import probíhá přes protokol &amp;lt;b&amp;gt;SOAP&amp;lt;/b&amp;gt;.&amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;Rozšíření: &amp;lt;b&amp;gt;Import průchodů&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ul&amp;gt;&lt;br /&gt;
    &amp;lt;/li&amp;gt;&lt;br /&gt;
&amp;lt;/ul&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;ul&amp;gt;&lt;br /&gt;
    &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;KS Docházka 2024 (novější verze)&amp;lt;/b&amp;gt;&lt;br /&gt;
        &amp;lt;ul&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;Využívá webovou službu &amp;lt;b&amp;gt;aplikačního serveru&amp;lt;/b&amp;gt;.&amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;Podporuje import přes protokoly &amp;lt;b&amp;gt;SOAP i REST&amp;lt;/b&amp;gt;.&amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;Rozšíření: &amp;lt;b&amp;gt;Import průchodů SOAP/REST - Nová&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ul&amp;gt;&lt;br /&gt;
    &amp;lt;/li&amp;gt;&lt;br /&gt;
&amp;lt;/ul&amp;gt;&lt;br /&gt;
&amp;lt;i&amp;gt;&lt;br /&gt;
Lze využít v případě, že jsou k dispozici informace o průchodech zaměstnanců přes nějaký terminál nebo turniket a k takto získaným datům nelze přistupovat z plnohodnotného docházkového systému. Pokud tedy nelze data pro mzdy připravit jinak, je možné je naimportovat do modulu Docházka v aplikaci KS portál, kde s nimi lze pracovat jako s běžným docházkovým systémem.&lt;br /&gt;
&amp;lt;/i&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h2&amp;gt;Import průchodů pro - KS Docházka (starší verze) &amp;lt;/h2&amp;gt;&lt;br /&gt;
&amp;lt;h3&amp;gt;Nastavení&amp;lt;/h3&amp;gt;&lt;br /&gt;
* Aktivace rozšíření.&lt;br /&gt;
* Následně je potřeba do web.cofigu do appsettings doplnit klíč '''''WsAuthKey''''', jako hodnotu zadejte dostatečně dlouhý bezpečný řetězec. Tato hodnota musí být předávána v autentizační SOAP hlavičce s názvem '''''AuthKeyHeader''''', a to při každém požadavku o zápis průchodu.&lt;br /&gt;
* Pokud bude aktivní rozšíření, popis služby lze získat přes odkaz v KS portále&lt;br /&gt;
 [rootKSportalu]/webservices/dchpruchody.asmx?op=PruchodVloz&lt;br /&gt;
* V struktuře předávaných dat jsou důležité následující položky&lt;br /&gt;
: ''OsCislo'' - Osobní číslo zaměstnance&lt;br /&gt;
: ''Kod'' - Kód dopovídající číselníku docházkových kódů&lt;br /&gt;
: ''Cas'' - DateTime&lt;br /&gt;
* Pokud při zápisu dojde k chybě tak ta je vrácena s kódem a popisem chyby (popis dále).&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h4&amp;gt;SOAP 1.1&amp;lt;/h4&amp;gt;&lt;br /&gt;
Následuje ukázkový požadavek a odpověď SOAP 1.1. Uvedené zástupce je třeba nahradit skutečnými hodnotami.&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
 POST /ksportal/webservices/dchpruchody.asmx HTTP/1.1&lt;br /&gt;
 Host: localhost&lt;br /&gt;
 Content-Type: text/xml; charset=utf-8&lt;br /&gt;
 Content-Length: length&lt;br /&gt;
 SOAPAction: &amp;quot;ksprtl/WebServices/PruchodVloz&amp;quot;&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;br /&gt;
 &amp;lt;soap:Envelope xmlns:xsi=&amp;quot;http://www.w3.org/2001/XMLSchema-instance&amp;quot; xmlns:xsd=&amp;quot;http://www.w3.org/2001/XMLSchema&amp;quot; xmlns:soap=&amp;quot;http://schemas.xmlsoap.org /soap/envelope/&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;soap:Header&amp;gt;&lt;br /&gt;
    &amp;lt;AuthKeyHeader xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;AuthKey&amp;gt;string&amp;lt;/AuthKey&amp;gt;&lt;br /&gt;
    &amp;lt;/AuthKeyHeader&amp;gt;&lt;br /&gt;
  &amp;lt;/soap:Header&amp;gt;&lt;br /&gt;
  &amp;lt;soap:Body&amp;gt;&lt;br /&gt;
    &amp;lt;PruchodVloz xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;pr&amp;gt;&lt;br /&gt;
        &amp;lt;OsCislo&amp;gt;decimal&amp;lt;/OsCislo&amp;gt;&lt;br /&gt;
        &amp;lt;CisloPom&amp;gt;short&amp;lt;/CisloPom&amp;gt;&lt;br /&gt;
        &amp;lt;Kod&amp;gt;int&amp;lt;/Kod&amp;gt;&lt;br /&gt;
        &amp;lt;Prac_str&amp;gt;string&amp;lt;/Prac_str&amp;gt;&lt;br /&gt;
        &amp;lt;Cas&amp;gt;dateTime&amp;lt;/Cas&amp;gt;&lt;br /&gt;
        &amp;lt;Doba&amp;gt;string&amp;lt;/Doba&amp;gt;&lt;br /&gt;
        &amp;lt;Kodprst&amp;gt;string&amp;lt;/Kodprst&amp;gt;&lt;br /&gt;
        &amp;lt;Sazba&amp;gt;decimal&amp;lt;/Sazba&amp;gt;&lt;br /&gt;
        &amp;lt;Castka&amp;gt;decimal&amp;lt;/Castka&amp;gt;&lt;br /&gt;
        &amp;lt;C_pole1&amp;gt;string&amp;lt;/C_pole1&amp;gt;&lt;br /&gt;
        &amp;lt;C_pole2&amp;gt;string&amp;lt;/C_pole2&amp;gt;&lt;br /&gt;
        &amp;lt;N_pole1&amp;gt;long&amp;lt;/N_pole1&amp;gt;&lt;br /&gt;
        &amp;lt;N_pole2&amp;gt;long&amp;lt;/N_pole2&amp;gt;&lt;br /&gt;
        &amp;lt;Poznamka&amp;gt;string&amp;lt;/Poznamka&amp;gt;&lt;br /&gt;
      &amp;lt;/pr&amp;gt;&lt;br /&gt;
    &amp;lt;/PruchodVloz&amp;gt;&lt;br /&gt;
  &amp;lt;/soap:Body&amp;gt;&lt;br /&gt;
 &amp;lt;/soap:Envelope&amp;gt;&lt;br /&gt;
 HTTP/1.1 200 OK&lt;br /&gt;
 Content-Type: text/xml; charset=utf-8&lt;br /&gt;
 Content-Length: length&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;br /&gt;
 &amp;lt;soap:Envelope xmlns:xsi=&amp;quot;http://www.w3.org/2001/XMLSchema-instance&amp;quot; xmlns:xsd=&amp;quot;http://www.w3.org/2001/XMLSchema&amp;quot; xmlns:soap=&amp;quot;http://schemas.xmlsoap.org /soap/envelope/&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;soap:Body&amp;gt;&lt;br /&gt;
    &amp;lt;PruchodVlozResponse xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;PruchodVlozResult&amp;gt;&lt;br /&gt;
        &amp;lt;ErrorCode&amp;gt;int&amp;lt;/ErrorCode&amp;gt;&lt;br /&gt;
        &amp;lt;ErrorString&amp;gt;string&amp;lt;/ErrorString&amp;gt;&lt;br /&gt;
      &amp;lt;/PruchodVlozResult&amp;gt;&lt;br /&gt;
    &amp;lt;/PruchodVlozResponse&amp;gt;&lt;br /&gt;
  &amp;lt;/soap:Body&amp;gt;&lt;br /&gt;
 &amp;lt;/soap:Envelope&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h4&amp;gt;SOAP 1.2&amp;lt;/h4&amp;gt;&lt;br /&gt;
Následuje ukázkový požadavek a odpověď SOAP 1.2. Uvedené zástupce je třeba nahradit skutečnými hodnotami.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
 POST /ksportal/webservices/dchpruchody.asmx HTTP/1.1&lt;br /&gt;
 Host: localhost&lt;br /&gt;
 Content-Type: application/soap+xml; charset=utf-8&lt;br /&gt;
 Content-Length: length&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;br /&gt;
 &amp;lt;soap12:Envelope xmlns:xsi=&amp;quot;http://www.w3.org/2001/XMLSchema-instance&amp;quot; xmlns:xsd=&amp;quot;http://www.w3.org/2001/XMLSchema&amp;quot; xmlns:soap12=&amp;quot;http://www.w3.org/2003/05/soap- envelope&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;soap12:Header&amp;gt;&lt;br /&gt;
    &amp;lt;AuthKeyHeader xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;AuthKey&amp;gt;string&amp;lt;/AuthKey&amp;gt;&lt;br /&gt;
    &amp;lt;/AuthKeyHeader&amp;gt;&lt;br /&gt;
  &amp;lt;/soap12:Header&amp;gt;&lt;br /&gt;
  &amp;lt;soap12:Body&amp;gt;&lt;br /&gt;
    &amp;lt;PruchodVloz xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;pr&amp;gt;&lt;br /&gt;
        &amp;lt;OsCislo&amp;gt;decimal&amp;lt;/OsCislo&amp;gt;&lt;br /&gt;
        &amp;lt;CisloPom&amp;gt;short&amp;lt;/CisloPom&amp;gt;&lt;br /&gt;
        &amp;lt;Kod&amp;gt;int&amp;lt;/Kod&amp;gt;&lt;br /&gt;
        &amp;lt;Prac_str&amp;gt;string&amp;lt;/Prac_str&amp;gt;&lt;br /&gt;
        &amp;lt;Cas&amp;gt;dateTime&amp;lt;/Cas&amp;gt;&lt;br /&gt;
        &amp;lt;Doba&amp;gt;string&amp;lt;/Doba&amp;gt;&lt;br /&gt;
        &amp;lt;Kodprst&amp;gt;string&amp;lt;/Kodprst&amp;gt;&lt;br /&gt;
        &amp;lt;Sazba&amp;gt;decimal&amp;lt;/Sazba&amp;gt;&lt;br /&gt;
        &amp;lt;Castka&amp;gt;decimal&amp;lt;/Castka&amp;gt;&lt;br /&gt;
        &amp;lt;C_pole1&amp;gt;string&amp;lt;/C_pole1&amp;gt;&lt;br /&gt;
        &amp;lt;C_pole2&amp;gt;string&amp;lt;/C_pole2&amp;gt;&lt;br /&gt;
        &amp;lt;N_pole1&amp;gt;long&amp;lt;/N_pole1&amp;gt;&lt;br /&gt;
        &amp;lt;N_pole2&amp;gt;long&amp;lt;/N_pole2&amp;gt;&lt;br /&gt;
        &amp;lt;Poznamka&amp;gt;string&amp;lt;/Poznamka&amp;gt;&lt;br /&gt;
      &amp;lt;/pr&amp;gt;&lt;br /&gt;
    &amp;lt;/PruchodVloz&amp;gt;&lt;br /&gt;
  &amp;lt;/soap12:Body&amp;gt;&lt;br /&gt;
 &amp;lt;/soap12:Envelope&amp;gt;&lt;br /&gt;
 HTTP/1.1 200 OK&lt;br /&gt;
 Content-Type: application/soap+xml; charset=utf-8&lt;br /&gt;
 Content-Length: length&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;br /&gt;
 &amp;lt;soap12:Envelope xmlns:xsi=&amp;quot;http://www.w3.org/2001/XMLSchema-instance&amp;quot; xmlns:xsd=&amp;quot;http://www.w3.org/2001/XMLSchema&amp;quot; xmlns:soap12=&amp;quot;http://www.w3.org/2003/05/soap-envelope&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;soap12:Body&amp;gt;&lt;br /&gt;
    &amp;lt;PruchodVlozResponse xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;PruchodVlozResult&amp;gt;&lt;br /&gt;
        &amp;lt;ErrorCode&amp;gt;int&amp;lt;/ErrorCode&amp;gt;&lt;br /&gt;
        &amp;lt;ErrorString&amp;gt;string&amp;lt;/ErrorString&amp;gt;&lt;br /&gt;
      &amp;lt;/PruchodVlozResult&amp;gt;&lt;br /&gt;
    &amp;lt;/PruchodVlozResponse&amp;gt;&lt;br /&gt;
  &amp;lt;/soap12:Body&amp;gt;&lt;br /&gt;
 &amp;lt;/soap12:Envelope&amp;gt;&lt;br /&gt;
 &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h2&amp;gt;Import průchodů pro - KS Docházka 2024 (novější verze)&amp;lt;/h2&amp;gt;&lt;br /&gt;
Umožňuje synchronizovat data prostřednictvím KSweb API (SOAP/REST) uložená v aplikaci KS mzdý PROFI z evidence zaměstnanců, pracovních poměrů a číselníku středisek do libovolných připojených terminálů. Dále se pak data z průchodových terminálů přenáší zpět do modulu Docházka v aplikaci KS portál.&lt;br /&gt;
&lt;br /&gt;
'''POZOR:''' Tato funkcionalita vyžaduje nainstalovanou a spuštěnou aplikaci server KS-AS. Před aktivací této funkcionality ověřte, že aplikace server je funkční. Pokud aplikace není nainstalována nebo nefunguje správně, stáhněte si nejnovější instalační balíček instalátor utility (MapSetup.exe) a nainstalujte jej na stejný server jako je instalována aplikace KS mzdý PROFI nebo jej stáhněte z ftp://ftp.ksprogram.cz/download/&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h3&amp;gt;Položky&amp;lt;/h3&amp;gt;&lt;br /&gt;
{|class=&amp;quot;wikitable sortable&amp;quot; border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|- style=&amp;quot;background-color: #eeeeee&amp;quot;&lt;br /&gt;
!'''Údaj'''&lt;br /&gt;
!'''Datový typ'''&lt;br /&gt;
!'''Povinné pole'''&lt;br /&gt;
!'''Význam'''&lt;br /&gt;
|-&lt;br /&gt;
| IdZaznamu || integer || Ne || Jednoznačná identifikace záznamu v externím systému.&lt;br /&gt;
|-&lt;br /&gt;
| OsCislo || decimal(10,0) || Ano || Osobní číslo zaměstnance.&lt;br /&gt;
|-&lt;br /&gt;
| CisloPom || smallint || Ne || Číslo pracovního poměru.&lt;br /&gt;
|-&lt;br /&gt;
| Kod || char(10) || Ano || Docházkový kód externího systému.&lt;br /&gt;
|-&lt;br /&gt;
| Cas || char(17) || Ano || Datum a čas ve formátu yyyy-MM-dd hhmmss.&lt;br /&gt;
|-&lt;br /&gt;
| NazevZarizeni || char(50) || Ne || Název zařízení externího systému.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''REST'''&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
curl -X POST https://example.com/api/rest/ImportPruchodu \&lt;br /&gt;
  -H &amp;quot;Content-Type: text/plain&amp;quot; \&lt;br /&gt;
  -d '{&lt;br /&gt;
    &amp;quot;IdZaznamu&amp;quot;: 123,&lt;br /&gt;
    &amp;quot;OsCislo&amp;quot;: 4567890123,&lt;br /&gt;
    &amp;quot;CisloPom&amp;quot;: 1,&lt;br /&gt;
    &amp;quot;Kod&amp;quot;: &amp;quot;ABC123&amp;quot;,&lt;br /&gt;
    &amp;quot;Cas&amp;quot;: &amp;quot;2025-03-11 105844&amp;quot;,&lt;br /&gt;
    &amp;quot;NazevZarizeni&amp;quot;: &amp;quot;Externí zařízení&amp;quot;&lt;br /&gt;
  }'&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''SOAP'''&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;lt;soap:Envelope xmlns:soap=&amp;quot;http://www.w3.org/2003/05/soap-envelope&amp;quot; xmlns:web=&amp;quot;http://KSProgram/KSAsServer/WebService&amp;quot; xmlns:ksp=&amp;quot;http://schemas.datacontract.org/2004/07/KSProgram.AS.WCF&amp;quot;&amp;gt;&lt;br /&gt;
    &amp;lt;soap:Header/&amp;gt;&lt;br /&gt;
    &amp;lt;soap:Body&amp;gt;&lt;br /&gt;
      &amp;lt;web:InsertData&amp;gt;&lt;br /&gt;
        &amp;lt;web:aParam&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:DataValidationOnly&amp;gt;false&amp;lt;/ksp:DataValidationOnly&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:ItemGroup&amp;gt;ImportPruchodu&amp;lt;/ksp:ItemGroup&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:Items&amp;gt;&amp;lt;/ksp:Items&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:JsonChangeData&amp;gt;[{&lt;br /&gt;
            &amp;quot;IdZaznamu&amp;quot;: 123,&lt;br /&gt;
            &amp;quot;OsCislo&amp;quot;: 4567890123,&lt;br /&gt;
            &amp;quot;CisloPom&amp;quot;: 1,&lt;br /&gt;
            &amp;quot;Kod&amp;quot;: &amp;quot;ABC123&amp;quot;,&lt;br /&gt;
            &amp;quot;Cas&amp;quot;: &amp;quot;2025-03-11 105844&amp;quot;,&lt;br /&gt;
            &amp;quot;NazevZarizeni&amp;quot;: &amp;quot;Externí zařízení&amp;quot;&lt;br /&gt;
          }]&amp;lt;/ksp:JsonChangeData&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:JsonOptions&amp;gt;&amp;lt;/ksp:JsonOptions&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:JsonSearchCriteria&amp;gt;&amp;lt;/ksp:JsonSearchCriteria&amp;gt;&lt;br /&gt;
        &amp;lt;/web:aParam&amp;gt;&lt;br /&gt;
      &amp;lt;/web:InsertData&amp;gt;&lt;br /&gt;
    &amp;lt;/soap:Body&amp;gt;&lt;br /&gt;
  &amp;lt;/soap:Envelope&amp;gt;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Příručka KS portál]]&lt;br /&gt;
* [[Rozšíření aplikace]]&lt;br /&gt;
* &amp;lt;small&amp;gt;hd 51867&amp;lt;/small&amp;gt;&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Import_pr%C5%AFchod%C5%AF&amp;diff=47969</id>
		<title>Import průchodů</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Import_pr%C5%AFchod%C5%AF&amp;diff=47969"/>
		<updated>2025-03-11T14:08:14Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Import průchodů je [[Rozšíření aplikace]] &amp;lt;small&amp;gt;([[KS docházka (Rozšíření aplikace)]])&amp;lt;/small&amp;gt;., které umožňuje importovat data z docházkových, nebo přístupových systémů třetích stran do modulu Docházka v aplikaci KS Portál.&lt;br /&gt;
&lt;br /&gt;
Způsob importu průchodů závisí na verzi KS Docházky:&lt;br /&gt;
&amp;lt;ul&amp;gt;&lt;br /&gt;
    &amp;lt;li&amp;gt;&lt;br /&gt;
        '''KS Docházka (starší verze)''' využívá webovou službu dostupnou v aplikaci KS Portál. Import probíhá přes protokol SOAP.&lt;br /&gt;
    &amp;lt;/li&amp;gt;&lt;br /&gt;
    &amp;lt;li&amp;gt;&lt;br /&gt;
        '''KS Docházka 2024 (novější verze)''' využívá webovou službu aplikačního serveru. Podporuje import přes protokoly SOAP i REST.&lt;br /&gt;
    &amp;lt;/li&amp;gt;&lt;br /&gt;
&amp;lt;/ul&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;i&amp;gt;&lt;br /&gt;
Lze využít v případě, že jsou k dispozici informace o průchodech zaměstnanců přes nějaký terminál nebo turniket a k takto získaným datům nelze přistupovat z plnohodnotného docházkového systému. Pokud tedy nelze data pro mzdy připravit jinak, je možné je naimportovat do modulu Docházka v aplikaci KS portál, kde s nimi lze pracovat jako s běžným docházkovým systémem.&lt;br /&gt;
&amp;lt;/i&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h2&amp;gt;Import průchodů pro - KS Docházka (starší verze) &amp;lt;/h2&amp;gt;&lt;br /&gt;
&amp;lt;h3&amp;gt;Nastavení&amp;lt;/h3&amp;gt;&lt;br /&gt;
* Aktivace rozšíření.&lt;br /&gt;
* Následně je potřeba do web.cofigu do appsettings doplnit klíč '''''WsAuthKey''''', jako hodnotu zadejte dostatečně dlouhý bezpečný řetězec. Tato hodnota musí být předávána v autentizační SOAP hlavičce s názvem '''''AuthKeyHeader''''', a to při každém požadavku o zápis průchodu.&lt;br /&gt;
* Pokud bude aktivní rozšíření, popis služby lze získat přes odkaz v KS portále&lt;br /&gt;
 [rootKSportalu]/webservices/dchpruchody.asmx?op=PruchodVloz&lt;br /&gt;
* V struktuře předávaných dat jsou důležité následující položky&lt;br /&gt;
: ''OsCislo'' - Osobní číslo zaměstnance&lt;br /&gt;
: ''Kod'' - Kód dopovídající číselníku docházkových kódů&lt;br /&gt;
: ''Cas'' - DateTime&lt;br /&gt;
* Pokud při zápisu dojde k chybě tak ta je vrácena s kódem a popisem chyby (popis dále).&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h4&amp;gt;SOAP 1.1&amp;lt;/h4&amp;gt;&lt;br /&gt;
Následuje ukázkový požadavek a odpověď SOAP 1.1. Uvedené zástupce je třeba nahradit skutečnými hodnotami.&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
 POST /ksportal/webservices/dchpruchody.asmx HTTP/1.1&lt;br /&gt;
 Host: localhost&lt;br /&gt;
 Content-Type: text/xml; charset=utf-8&lt;br /&gt;
 Content-Length: length&lt;br /&gt;
 SOAPAction: &amp;quot;ksprtl/WebServices/PruchodVloz&amp;quot;&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;br /&gt;
 &amp;lt;soap:Envelope xmlns:xsi=&amp;quot;http://www.w3.org/2001/XMLSchema-instance&amp;quot; xmlns:xsd=&amp;quot;http://www.w3.org/2001/XMLSchema&amp;quot; xmlns:soap=&amp;quot;http://schemas.xmlsoap.org /soap/envelope/&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;soap:Header&amp;gt;&lt;br /&gt;
    &amp;lt;AuthKeyHeader xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;AuthKey&amp;gt;string&amp;lt;/AuthKey&amp;gt;&lt;br /&gt;
    &amp;lt;/AuthKeyHeader&amp;gt;&lt;br /&gt;
  &amp;lt;/soap:Header&amp;gt;&lt;br /&gt;
  &amp;lt;soap:Body&amp;gt;&lt;br /&gt;
    &amp;lt;PruchodVloz xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;pr&amp;gt;&lt;br /&gt;
        &amp;lt;OsCislo&amp;gt;decimal&amp;lt;/OsCislo&amp;gt;&lt;br /&gt;
        &amp;lt;CisloPom&amp;gt;short&amp;lt;/CisloPom&amp;gt;&lt;br /&gt;
        &amp;lt;Kod&amp;gt;int&amp;lt;/Kod&amp;gt;&lt;br /&gt;
        &amp;lt;Prac_str&amp;gt;string&amp;lt;/Prac_str&amp;gt;&lt;br /&gt;
        &amp;lt;Cas&amp;gt;dateTime&amp;lt;/Cas&amp;gt;&lt;br /&gt;
        &amp;lt;Doba&amp;gt;string&amp;lt;/Doba&amp;gt;&lt;br /&gt;
        &amp;lt;Kodprst&amp;gt;string&amp;lt;/Kodprst&amp;gt;&lt;br /&gt;
        &amp;lt;Sazba&amp;gt;decimal&amp;lt;/Sazba&amp;gt;&lt;br /&gt;
        &amp;lt;Castka&amp;gt;decimal&amp;lt;/Castka&amp;gt;&lt;br /&gt;
        &amp;lt;C_pole1&amp;gt;string&amp;lt;/C_pole1&amp;gt;&lt;br /&gt;
        &amp;lt;C_pole2&amp;gt;string&amp;lt;/C_pole2&amp;gt;&lt;br /&gt;
        &amp;lt;N_pole1&amp;gt;long&amp;lt;/N_pole1&amp;gt;&lt;br /&gt;
        &amp;lt;N_pole2&amp;gt;long&amp;lt;/N_pole2&amp;gt;&lt;br /&gt;
        &amp;lt;Poznamka&amp;gt;string&amp;lt;/Poznamka&amp;gt;&lt;br /&gt;
      &amp;lt;/pr&amp;gt;&lt;br /&gt;
    &amp;lt;/PruchodVloz&amp;gt;&lt;br /&gt;
  &amp;lt;/soap:Body&amp;gt;&lt;br /&gt;
 &amp;lt;/soap:Envelope&amp;gt;&lt;br /&gt;
 HTTP/1.1 200 OK&lt;br /&gt;
 Content-Type: text/xml; charset=utf-8&lt;br /&gt;
 Content-Length: length&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;br /&gt;
 &amp;lt;soap:Envelope xmlns:xsi=&amp;quot;http://www.w3.org/2001/XMLSchema-instance&amp;quot; xmlns:xsd=&amp;quot;http://www.w3.org/2001/XMLSchema&amp;quot; xmlns:soap=&amp;quot;http://schemas.xmlsoap.org /soap/envelope/&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;soap:Body&amp;gt;&lt;br /&gt;
    &amp;lt;PruchodVlozResponse xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;PruchodVlozResult&amp;gt;&lt;br /&gt;
        &amp;lt;ErrorCode&amp;gt;int&amp;lt;/ErrorCode&amp;gt;&lt;br /&gt;
        &amp;lt;ErrorString&amp;gt;string&amp;lt;/ErrorString&amp;gt;&lt;br /&gt;
      &amp;lt;/PruchodVlozResult&amp;gt;&lt;br /&gt;
    &amp;lt;/PruchodVlozResponse&amp;gt;&lt;br /&gt;
  &amp;lt;/soap:Body&amp;gt;&lt;br /&gt;
 &amp;lt;/soap:Envelope&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h4&amp;gt;SOAP 1.2&amp;lt;/h4&amp;gt;&lt;br /&gt;
Následuje ukázkový požadavek a odpověď SOAP 1.2. Uvedené zástupce je třeba nahradit skutečnými hodnotami.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
 POST /ksportal/webservices/dchpruchody.asmx HTTP/1.1&lt;br /&gt;
 Host: localhost&lt;br /&gt;
 Content-Type: application/soap+xml; charset=utf-8&lt;br /&gt;
 Content-Length: length&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;br /&gt;
 &amp;lt;soap12:Envelope xmlns:xsi=&amp;quot;http://www.w3.org/2001/XMLSchema-instance&amp;quot; xmlns:xsd=&amp;quot;http://www.w3.org/2001/XMLSchema&amp;quot; xmlns:soap12=&amp;quot;http://www.w3.org/2003/05/soap- envelope&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;soap12:Header&amp;gt;&lt;br /&gt;
    &amp;lt;AuthKeyHeader xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;AuthKey&amp;gt;string&amp;lt;/AuthKey&amp;gt;&lt;br /&gt;
    &amp;lt;/AuthKeyHeader&amp;gt;&lt;br /&gt;
  &amp;lt;/soap12:Header&amp;gt;&lt;br /&gt;
  &amp;lt;soap12:Body&amp;gt;&lt;br /&gt;
    &amp;lt;PruchodVloz xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;pr&amp;gt;&lt;br /&gt;
        &amp;lt;OsCislo&amp;gt;decimal&amp;lt;/OsCislo&amp;gt;&lt;br /&gt;
        &amp;lt;CisloPom&amp;gt;short&amp;lt;/CisloPom&amp;gt;&lt;br /&gt;
        &amp;lt;Kod&amp;gt;int&amp;lt;/Kod&amp;gt;&lt;br /&gt;
        &amp;lt;Prac_str&amp;gt;string&amp;lt;/Prac_str&amp;gt;&lt;br /&gt;
        &amp;lt;Cas&amp;gt;dateTime&amp;lt;/Cas&amp;gt;&lt;br /&gt;
        &amp;lt;Doba&amp;gt;string&amp;lt;/Doba&amp;gt;&lt;br /&gt;
        &amp;lt;Kodprst&amp;gt;string&amp;lt;/Kodprst&amp;gt;&lt;br /&gt;
        &amp;lt;Sazba&amp;gt;decimal&amp;lt;/Sazba&amp;gt;&lt;br /&gt;
        &amp;lt;Castka&amp;gt;decimal&amp;lt;/Castka&amp;gt;&lt;br /&gt;
        &amp;lt;C_pole1&amp;gt;string&amp;lt;/C_pole1&amp;gt;&lt;br /&gt;
        &amp;lt;C_pole2&amp;gt;string&amp;lt;/C_pole2&amp;gt;&lt;br /&gt;
        &amp;lt;N_pole1&amp;gt;long&amp;lt;/N_pole1&amp;gt;&lt;br /&gt;
        &amp;lt;N_pole2&amp;gt;long&amp;lt;/N_pole2&amp;gt;&lt;br /&gt;
        &amp;lt;Poznamka&amp;gt;string&amp;lt;/Poznamka&amp;gt;&lt;br /&gt;
      &amp;lt;/pr&amp;gt;&lt;br /&gt;
    &amp;lt;/PruchodVloz&amp;gt;&lt;br /&gt;
  &amp;lt;/soap12:Body&amp;gt;&lt;br /&gt;
 &amp;lt;/soap12:Envelope&amp;gt;&lt;br /&gt;
 HTTP/1.1 200 OK&lt;br /&gt;
 Content-Type: application/soap+xml; charset=utf-8&lt;br /&gt;
 Content-Length: length&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;br /&gt;
 &amp;lt;soap12:Envelope xmlns:xsi=&amp;quot;http://www.w3.org/2001/XMLSchema-instance&amp;quot; xmlns:xsd=&amp;quot;http://www.w3.org/2001/XMLSchema&amp;quot; xmlns:soap12=&amp;quot;http://www.w3.org/2003/05/soap-envelope&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;soap12:Body&amp;gt;&lt;br /&gt;
    &amp;lt;PruchodVlozResponse xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;PruchodVlozResult&amp;gt;&lt;br /&gt;
        &amp;lt;ErrorCode&amp;gt;int&amp;lt;/ErrorCode&amp;gt;&lt;br /&gt;
        &amp;lt;ErrorString&amp;gt;string&amp;lt;/ErrorString&amp;gt;&lt;br /&gt;
      &amp;lt;/PruchodVlozResult&amp;gt;&lt;br /&gt;
    &amp;lt;/PruchodVlozResponse&amp;gt;&lt;br /&gt;
  &amp;lt;/soap12:Body&amp;gt;&lt;br /&gt;
 &amp;lt;/soap12:Envelope&amp;gt;&lt;br /&gt;
 &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h2&amp;gt;Import průchodů pro - KS Docházka 2024 (novější verze)&amp;lt;/h2&amp;gt;&lt;br /&gt;
Umožňuje synchronizovat data prostřednictvím KSweb API (SOAP/REST) uložená v aplikaci KS mzdý PROFI z evidence zaměstnanců, pracovních poměrů a číselníku středisek do libovolných připojených terminálů. Dále se pak data z průchodových terminálů přenáší zpět do modulu Docházka v aplikaci KS portál.&lt;br /&gt;
&lt;br /&gt;
'''POZOR:''' Tato funkcionalita vyžaduje nainstalovanou a spuštěnou aplikaci server KS-AS. Před aktivací této funkcionality ověřte, že aplikace server je funkční. Pokud aplikace není nainstalována nebo nefunguje správně, stáhněte si nejnovější instalační balíček instalátor utility (MapSetup.exe) a nainstalujte jej na stejný server jako je instalována aplikace KS mzdý PROFI nebo jej stáhněte z ftp://ftp.ksprogram.cz/download/&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h3&amp;gt;Položky&amp;lt;/h3&amp;gt;&lt;br /&gt;
{|class=&amp;quot;wikitable sortable&amp;quot; border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|- style=&amp;quot;background-color: #eeeeee&amp;quot;&lt;br /&gt;
!'''Údaj'''&lt;br /&gt;
!'''Datový typ'''&lt;br /&gt;
!'''Povinné pole'''&lt;br /&gt;
!'''Význam'''&lt;br /&gt;
|-&lt;br /&gt;
| IdZaznamu || integer || Ne || Jednoznačná identifikace záznamu v externím systému.&lt;br /&gt;
|-&lt;br /&gt;
| OsCislo || decimal(10,0) || Ano || Osobní číslo zaměstnance.&lt;br /&gt;
|-&lt;br /&gt;
| CisloPom || smallint || Ne || Číslo pracovního poměru.&lt;br /&gt;
|-&lt;br /&gt;
| Kod || char(10) || Ano || Docházkový kód externího systému.&lt;br /&gt;
|-&lt;br /&gt;
| Cas || char(17) || Ano || Datum a čas ve formátu yyyy-MM-dd hhmmss.&lt;br /&gt;
|-&lt;br /&gt;
| NazevZarizeni || char(50) || Ne || Název zařízení externího systému.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''REST'''&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
curl -X POST https://example.com/api/rest/ImportPruchodu \&lt;br /&gt;
  -H &amp;quot;Content-Type: text/plain&amp;quot; \&lt;br /&gt;
  -d '{&lt;br /&gt;
    &amp;quot;IdZaznamu&amp;quot;: 123,&lt;br /&gt;
    &amp;quot;OsCislo&amp;quot;: 4567890123,&lt;br /&gt;
    &amp;quot;CisloPom&amp;quot;: 1,&lt;br /&gt;
    &amp;quot;Kod&amp;quot;: &amp;quot;ABC123&amp;quot;,&lt;br /&gt;
    &amp;quot;Cas&amp;quot;: &amp;quot;2025-03-11 105844&amp;quot;,&lt;br /&gt;
    &amp;quot;NazevZarizeni&amp;quot;: &amp;quot;Externí zařízení&amp;quot;&lt;br /&gt;
  }'&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''SOAP'''&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;lt;soap:Envelope xmlns:soap=&amp;quot;http://www.w3.org/2003/05/soap-envelope&amp;quot; xmlns:web=&amp;quot;http://KSProgram/KSAsServer/WebService&amp;quot; xmlns:ksp=&amp;quot;http://schemas.datacontract.org/2004/07/KSProgram.AS.WCF&amp;quot;&amp;gt;&lt;br /&gt;
    &amp;lt;soap:Header/&amp;gt;&lt;br /&gt;
    &amp;lt;soap:Body&amp;gt;&lt;br /&gt;
      &amp;lt;web:InsertData&amp;gt;&lt;br /&gt;
        &amp;lt;web:aParam&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:DataValidationOnly&amp;gt;false&amp;lt;/ksp:DataValidationOnly&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:ItemGroup&amp;gt;ImportPruchodu&amp;lt;/ksp:ItemGroup&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:Items&amp;gt;&amp;lt;/ksp:Items&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:JsonChangeData&amp;gt;[{&lt;br /&gt;
            &amp;quot;IdZaznamu&amp;quot;: 123,&lt;br /&gt;
            &amp;quot;OsCislo&amp;quot;: 4567890123,&lt;br /&gt;
            &amp;quot;CisloPom&amp;quot;: 1,&lt;br /&gt;
            &amp;quot;Kod&amp;quot;: &amp;quot;ABC123&amp;quot;,&lt;br /&gt;
            &amp;quot;Cas&amp;quot;: &amp;quot;2025-03-11 105844&amp;quot;,&lt;br /&gt;
            &amp;quot;NazevZarizeni&amp;quot;: &amp;quot;Externí zařízení&amp;quot;&lt;br /&gt;
          }]&amp;lt;/ksp:JsonChangeData&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:JsonOptions&amp;gt;&amp;lt;/ksp:JsonOptions&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:JsonSearchCriteria&amp;gt;&amp;lt;/ksp:JsonSearchCriteria&amp;gt;&lt;br /&gt;
        &amp;lt;/web:aParam&amp;gt;&lt;br /&gt;
      &amp;lt;/web:InsertData&amp;gt;&lt;br /&gt;
    &amp;lt;/soap:Body&amp;gt;&lt;br /&gt;
  &amp;lt;/soap:Envelope&amp;gt;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Příručka KS portál]]&lt;br /&gt;
* [[Rozšíření aplikace]]&lt;br /&gt;
* &amp;lt;small&amp;gt;hd 51867&amp;lt;/small&amp;gt;&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Import_pr%C5%AFchod%C5%AF&amp;diff=47968</id>
		<title>Import průchodů</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Import_pr%C5%AFchod%C5%AF&amp;diff=47968"/>
		<updated>2025-03-11T13:30:44Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;''Import průchodů'' je [[Rozšíření aplikace]] &amp;lt;small&amp;gt;([[KS docházka (Rozšíření aplikace)]])&amp;lt;/small&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
'''Dva způsoby importu průchodů'''&lt;br /&gt;
&amp;lt;ul&amp;gt;&lt;br /&gt;
    &amp;lt;li&amp;gt;&lt;br /&gt;
        Přes webovou službu pro import dat pro [[KS docházka|KS docházku]]. Dokumentace je součástí webové služby.&lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            Protokol SOAP. &lt;br /&gt;
        &amp;lt;/ol&amp;gt;         &lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            Rozšíření &amp;quot;Import průchodů&amp;quot;&lt;br /&gt;
        &amp;lt;/ol&amp;gt;    &lt;br /&gt;
    &amp;lt;/li&amp;gt;&lt;br /&gt;
    &amp;lt;li&amp;gt;&lt;br /&gt;
        Přes aplikační server. &lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            Protokol SOAP/REST. &lt;br /&gt;
        &amp;lt;/ol&amp;gt;         &lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            Rozšíření &amp;quot;Import průchodů SOAP/REST - Nová&amp;quot;&lt;br /&gt;
        &amp;lt;/ol&amp;gt;        &lt;br /&gt;
    &amp;lt;/li&amp;gt;&lt;br /&gt;
&amp;lt;/ul&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;i&amp;gt;&lt;br /&gt;
S touto funkcí je možné importovat data z docházkových nebo přístupových systémů třetích stran do modulu Docházka v aplikaci KS portál.&lt;br /&gt;
&lt;br /&gt;
Lze využít v případě, že jsou k dispozici informace o průchodech zaměstnanců přes nějaký terminál nebo turniket a k takto získaným datům nelze přistupovat z plnohodnotného docházkového systému. Pokud tedy nelze data pro mzdy připravit jinak, je možné je naimportovat do modulu Docházka v aplikaci KS portál, kde s nimi lze pracovat jako s běžným docházkovým systémem.&lt;br /&gt;
&amp;lt;/i&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h2&amp;gt;Import průchodů přes webovou službu&amp;lt;/h2&amp;gt;&lt;br /&gt;
&amp;lt;h3&amp;gt;Nastavení&amp;lt;/h3&amp;gt;&lt;br /&gt;
* Aktivace rozšíření.&lt;br /&gt;
* Následně je potřeba do web.cofigu do appsettings doplnit klíč '''''WsAuthKey''''', jako hodnotu zadejte dostatečně dlouhý bezpečný řetězec. Tato hodnota musí být předávána v autentizační SOAP hlavičce s názvem '''''AuthKeyHeader''''', a to při každém požadavku o zápis průchodu.&lt;br /&gt;
* Pokud bude aktivní rozšíření, popis služby lze získat přes odkaz v KS portále&lt;br /&gt;
 [rootKSportalu]/webservices/dchpruchody.asmx?op=PruchodVloz&lt;br /&gt;
* V struktuře předávaných dat jsou důležité následující položky&lt;br /&gt;
: ''OsCislo'' - Osobní číslo zaměstnance&lt;br /&gt;
: ''Kod'' - Kód dopovídající číselníku docházkových kódů&lt;br /&gt;
: ''Cas'' - DateTime&lt;br /&gt;
* Pokud při zápisu dojde k chybě tak ta je vrácena s kódem a popisem chyby (popis dále).&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h4&amp;gt;SOAP 1.1&amp;lt;/h4&amp;gt;&lt;br /&gt;
Následuje ukázkový požadavek a odpověď SOAP 1.1. Uvedené zástupce je třeba nahradit skutečnými hodnotami.&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
 POST /ksportal/webservices/dchpruchody.asmx HTTP/1.1&lt;br /&gt;
 Host: localhost&lt;br /&gt;
 Content-Type: text/xml; charset=utf-8&lt;br /&gt;
 Content-Length: length&lt;br /&gt;
 SOAPAction: &amp;quot;ksprtl/WebServices/PruchodVloz&amp;quot;&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;br /&gt;
 &amp;lt;soap:Envelope xmlns:xsi=&amp;quot;http://www.w3.org/2001/XMLSchema-instance&amp;quot; xmlns:xsd=&amp;quot;http://www.w3.org/2001/XMLSchema&amp;quot; xmlns:soap=&amp;quot;http://schemas.xmlsoap.org /soap/envelope/&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;soap:Header&amp;gt;&lt;br /&gt;
    &amp;lt;AuthKeyHeader xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;AuthKey&amp;gt;string&amp;lt;/AuthKey&amp;gt;&lt;br /&gt;
    &amp;lt;/AuthKeyHeader&amp;gt;&lt;br /&gt;
  &amp;lt;/soap:Header&amp;gt;&lt;br /&gt;
  &amp;lt;soap:Body&amp;gt;&lt;br /&gt;
    &amp;lt;PruchodVloz xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;pr&amp;gt;&lt;br /&gt;
        &amp;lt;OsCislo&amp;gt;decimal&amp;lt;/OsCislo&amp;gt;&lt;br /&gt;
        &amp;lt;CisloPom&amp;gt;short&amp;lt;/CisloPom&amp;gt;&lt;br /&gt;
        &amp;lt;Kod&amp;gt;int&amp;lt;/Kod&amp;gt;&lt;br /&gt;
        &amp;lt;Prac_str&amp;gt;string&amp;lt;/Prac_str&amp;gt;&lt;br /&gt;
        &amp;lt;Cas&amp;gt;dateTime&amp;lt;/Cas&amp;gt;&lt;br /&gt;
        &amp;lt;Doba&amp;gt;string&amp;lt;/Doba&amp;gt;&lt;br /&gt;
        &amp;lt;Kodprst&amp;gt;string&amp;lt;/Kodprst&amp;gt;&lt;br /&gt;
        &amp;lt;Sazba&amp;gt;decimal&amp;lt;/Sazba&amp;gt;&lt;br /&gt;
        &amp;lt;Castka&amp;gt;decimal&amp;lt;/Castka&amp;gt;&lt;br /&gt;
        &amp;lt;C_pole1&amp;gt;string&amp;lt;/C_pole1&amp;gt;&lt;br /&gt;
        &amp;lt;C_pole2&amp;gt;string&amp;lt;/C_pole2&amp;gt;&lt;br /&gt;
        &amp;lt;N_pole1&amp;gt;long&amp;lt;/N_pole1&amp;gt;&lt;br /&gt;
        &amp;lt;N_pole2&amp;gt;long&amp;lt;/N_pole2&amp;gt;&lt;br /&gt;
        &amp;lt;Poznamka&amp;gt;string&amp;lt;/Poznamka&amp;gt;&lt;br /&gt;
      &amp;lt;/pr&amp;gt;&lt;br /&gt;
    &amp;lt;/PruchodVloz&amp;gt;&lt;br /&gt;
  &amp;lt;/soap:Body&amp;gt;&lt;br /&gt;
 &amp;lt;/soap:Envelope&amp;gt;&lt;br /&gt;
 HTTP/1.1 200 OK&lt;br /&gt;
 Content-Type: text/xml; charset=utf-8&lt;br /&gt;
 Content-Length: length&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;br /&gt;
 &amp;lt;soap:Envelope xmlns:xsi=&amp;quot;http://www.w3.org/2001/XMLSchema-instance&amp;quot; xmlns:xsd=&amp;quot;http://www.w3.org/2001/XMLSchema&amp;quot; xmlns:soap=&amp;quot;http://schemas.xmlsoap.org /soap/envelope/&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;soap:Body&amp;gt;&lt;br /&gt;
    &amp;lt;PruchodVlozResponse xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;PruchodVlozResult&amp;gt;&lt;br /&gt;
        &amp;lt;ErrorCode&amp;gt;int&amp;lt;/ErrorCode&amp;gt;&lt;br /&gt;
        &amp;lt;ErrorString&amp;gt;string&amp;lt;/ErrorString&amp;gt;&lt;br /&gt;
      &amp;lt;/PruchodVlozResult&amp;gt;&lt;br /&gt;
    &amp;lt;/PruchodVlozResponse&amp;gt;&lt;br /&gt;
  &amp;lt;/soap:Body&amp;gt;&lt;br /&gt;
 &amp;lt;/soap:Envelope&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h4&amp;gt;SOAP 1.2&amp;lt;/h4&amp;gt;&lt;br /&gt;
Následuje ukázkový požadavek a odpověď SOAP 1.2. Uvedené zástupce je třeba nahradit skutečnými hodnotami.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
 POST /ksportal/webservices/dchpruchody.asmx HTTP/1.1&lt;br /&gt;
 Host: localhost&lt;br /&gt;
 Content-Type: application/soap+xml; charset=utf-8&lt;br /&gt;
 Content-Length: length&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;br /&gt;
 &amp;lt;soap12:Envelope xmlns:xsi=&amp;quot;http://www.w3.org/2001/XMLSchema-instance&amp;quot; xmlns:xsd=&amp;quot;http://www.w3.org/2001/XMLSchema&amp;quot; xmlns:soap12=&amp;quot;http://www.w3.org/2003/05/soap- envelope&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;soap12:Header&amp;gt;&lt;br /&gt;
    &amp;lt;AuthKeyHeader xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;AuthKey&amp;gt;string&amp;lt;/AuthKey&amp;gt;&lt;br /&gt;
    &amp;lt;/AuthKeyHeader&amp;gt;&lt;br /&gt;
  &amp;lt;/soap12:Header&amp;gt;&lt;br /&gt;
  &amp;lt;soap12:Body&amp;gt;&lt;br /&gt;
    &amp;lt;PruchodVloz xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;pr&amp;gt;&lt;br /&gt;
        &amp;lt;OsCislo&amp;gt;decimal&amp;lt;/OsCislo&amp;gt;&lt;br /&gt;
        &amp;lt;CisloPom&amp;gt;short&amp;lt;/CisloPom&amp;gt;&lt;br /&gt;
        &amp;lt;Kod&amp;gt;int&amp;lt;/Kod&amp;gt;&lt;br /&gt;
        &amp;lt;Prac_str&amp;gt;string&amp;lt;/Prac_str&amp;gt;&lt;br /&gt;
        &amp;lt;Cas&amp;gt;dateTime&amp;lt;/Cas&amp;gt;&lt;br /&gt;
        &amp;lt;Doba&amp;gt;string&amp;lt;/Doba&amp;gt;&lt;br /&gt;
        &amp;lt;Kodprst&amp;gt;string&amp;lt;/Kodprst&amp;gt;&lt;br /&gt;
        &amp;lt;Sazba&amp;gt;decimal&amp;lt;/Sazba&amp;gt;&lt;br /&gt;
        &amp;lt;Castka&amp;gt;decimal&amp;lt;/Castka&amp;gt;&lt;br /&gt;
        &amp;lt;C_pole1&amp;gt;string&amp;lt;/C_pole1&amp;gt;&lt;br /&gt;
        &amp;lt;C_pole2&amp;gt;string&amp;lt;/C_pole2&amp;gt;&lt;br /&gt;
        &amp;lt;N_pole1&amp;gt;long&amp;lt;/N_pole1&amp;gt;&lt;br /&gt;
        &amp;lt;N_pole2&amp;gt;long&amp;lt;/N_pole2&amp;gt;&lt;br /&gt;
        &amp;lt;Poznamka&amp;gt;string&amp;lt;/Poznamka&amp;gt;&lt;br /&gt;
      &amp;lt;/pr&amp;gt;&lt;br /&gt;
    &amp;lt;/PruchodVloz&amp;gt;&lt;br /&gt;
  &amp;lt;/soap12:Body&amp;gt;&lt;br /&gt;
 &amp;lt;/soap12:Envelope&amp;gt;&lt;br /&gt;
 HTTP/1.1 200 OK&lt;br /&gt;
 Content-Type: application/soap+xml; charset=utf-8&lt;br /&gt;
 Content-Length: length&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;br /&gt;
 &amp;lt;soap12:Envelope xmlns:xsi=&amp;quot;http://www.w3.org/2001/XMLSchema-instance&amp;quot; xmlns:xsd=&amp;quot;http://www.w3.org/2001/XMLSchema&amp;quot; xmlns:soap12=&amp;quot;http://www.w3.org/2003/05/soap-envelope&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;soap12:Body&amp;gt;&lt;br /&gt;
    &amp;lt;PruchodVlozResponse xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;PruchodVlozResult&amp;gt;&lt;br /&gt;
        &amp;lt;ErrorCode&amp;gt;int&amp;lt;/ErrorCode&amp;gt;&lt;br /&gt;
        &amp;lt;ErrorString&amp;gt;string&amp;lt;/ErrorString&amp;gt;&lt;br /&gt;
      &amp;lt;/PruchodVlozResult&amp;gt;&lt;br /&gt;
    &amp;lt;/PruchodVlozResponse&amp;gt;&lt;br /&gt;
  &amp;lt;/soap12:Body&amp;gt;&lt;br /&gt;
 &amp;lt;/soap12:Envelope&amp;gt;&lt;br /&gt;
 &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h2&amp;gt;Import průchodů přes aplikační server&amp;lt;/h2&amp;gt;&lt;br /&gt;
Umožňuje synchronizovat data prostřednictvím KSweb API (SOAP/REST) uložená v aplikaci KS mzdý PROFI z evidence zaměstnanců, pracovních poměrů a číselníku středisek do libovolných připojených terminálů. Dále se pak data z průchodových terminálů přenáší zpět do modulu Docházka v aplikaci KS portál.&lt;br /&gt;
&lt;br /&gt;
'''POZOR:''' Tato funkcionalita vyžaduje nainstalovanou a spuštěnou aplikaci server KS-AS. Před aktivací této funkcionality ověřte, že aplikace server je funkční. Pokud aplikace není nainstalována nebo nefunguje správně, stáhněte si nejnovější instalační balíček instalátor utility (MapSetup.exe) a nainstalujte jej na stejný server jako je instalována aplikace KS mzdý PROFI nebo jej stáhněte z ftp://ftp.ksprogram.cz/download/&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h3&amp;gt;Položky&amp;lt;/h3&amp;gt;&lt;br /&gt;
{|class=&amp;quot;wikitable sortable&amp;quot; border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|- style=&amp;quot;background-color: #eeeeee&amp;quot;&lt;br /&gt;
!'''Údaj'''&lt;br /&gt;
!'''Datový typ'''&lt;br /&gt;
!'''Povinné pole'''&lt;br /&gt;
!'''Význam'''&lt;br /&gt;
|-&lt;br /&gt;
| IdZaznamu || integer || Ne || Jednoznačná identifikace záznamu v externím systému.&lt;br /&gt;
|-&lt;br /&gt;
| OsCislo || decimal(10,0) || Ano || Osobní číslo zaměstnance.&lt;br /&gt;
|-&lt;br /&gt;
| CisloPom || smallint || Ne || Číslo pracovního poměru.&lt;br /&gt;
|-&lt;br /&gt;
| Kod || char(10) || Ano || Docházkový kód externího systému.&lt;br /&gt;
|-&lt;br /&gt;
| Cas || char(17) || Ano || Datum a čas ve formátu yyyy-MM-dd hhmmss.&lt;br /&gt;
|-&lt;br /&gt;
| NazevZarizeni || char(50) || Ne || Název zařízení externího systému.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''REST'''&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
curl -X POST https://example.com/api/rest/ImportPruchodu \&lt;br /&gt;
  -H &amp;quot;Content-Type: text/plain&amp;quot; \&lt;br /&gt;
  -d '{&lt;br /&gt;
    &amp;quot;IdZaznamu&amp;quot;: 123,&lt;br /&gt;
    &amp;quot;OsCislo&amp;quot;: 4567890123,&lt;br /&gt;
    &amp;quot;CisloPom&amp;quot;: 1,&lt;br /&gt;
    &amp;quot;Kod&amp;quot;: &amp;quot;ABC123&amp;quot;,&lt;br /&gt;
    &amp;quot;Cas&amp;quot;: &amp;quot;2025-03-11 105844&amp;quot;,&lt;br /&gt;
    &amp;quot;NazevZarizeni&amp;quot;: &amp;quot;Externí zařízení&amp;quot;&lt;br /&gt;
  }'&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''SOAP'''&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;lt;soap:Envelope xmlns:soap=&amp;quot;http://www.w3.org/2003/05/soap-envelope&amp;quot; xmlns:web=&amp;quot;http://KSProgram/KSAsServer/WebService&amp;quot; xmlns:ksp=&amp;quot;http://schemas.datacontract.org/2004/07/KSProgram.AS.WCF&amp;quot;&amp;gt;&lt;br /&gt;
    &amp;lt;soap:Header/&amp;gt;&lt;br /&gt;
    &amp;lt;soap:Body&amp;gt;&lt;br /&gt;
      &amp;lt;web:InsertData&amp;gt;&lt;br /&gt;
        &amp;lt;web:aParam&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:DataValidationOnly&amp;gt;false&amp;lt;/ksp:DataValidationOnly&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:ItemGroup&amp;gt;ImportPruchodu&amp;lt;/ksp:ItemGroup&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:Items&amp;gt;&amp;lt;/ksp:Items&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:JsonChangeData&amp;gt;[{&lt;br /&gt;
            &amp;quot;IdZaznamu&amp;quot;: 123,&lt;br /&gt;
            &amp;quot;OsCislo&amp;quot;: 4567890123,&lt;br /&gt;
            &amp;quot;CisloPom&amp;quot;: 1,&lt;br /&gt;
            &amp;quot;Kod&amp;quot;: &amp;quot;ABC123&amp;quot;,&lt;br /&gt;
            &amp;quot;Cas&amp;quot;: &amp;quot;2025-03-11 105844&amp;quot;,&lt;br /&gt;
            &amp;quot;NazevZarizeni&amp;quot;: &amp;quot;Externí zařízení&amp;quot;&lt;br /&gt;
          }]&amp;lt;/ksp:JsonChangeData&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:JsonOptions&amp;gt;&amp;lt;/ksp:JsonOptions&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:JsonSearchCriteria&amp;gt;&amp;lt;/ksp:JsonSearchCriteria&amp;gt;&lt;br /&gt;
        &amp;lt;/web:aParam&amp;gt;&lt;br /&gt;
      &amp;lt;/web:InsertData&amp;gt;&lt;br /&gt;
    &amp;lt;/soap:Body&amp;gt;&lt;br /&gt;
  &amp;lt;/soap:Envelope&amp;gt;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Příručka KS portál]]&lt;br /&gt;
* [[Rozšíření aplikace]]&lt;br /&gt;
* &amp;lt;small&amp;gt;hd 51867&amp;lt;/small&amp;gt;&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Import_pr%C5%AFchod%C5%AF&amp;diff=47967</id>
		<title>Import průchodů</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Import_pr%C5%AFchod%C5%AF&amp;diff=47967"/>
		<updated>2025-03-11T13:30:02Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;''Import průchodů'' je [[Rozšíření aplikace]] &amp;lt;small&amp;gt;([[KS docházka (Rozšíření aplikace)]])&amp;lt;/small&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
'''Dva způsoby importu průchodů'''&lt;br /&gt;
&amp;lt;ul&amp;gt;&lt;br /&gt;
    &amp;lt;li&amp;gt;&lt;br /&gt;
        Přes webovou službu pro import dat pro [[KS docházka|KS docházku]]. Dokumentace je součástí webové služby.&lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            Protokol SOAP. &lt;br /&gt;
        &amp;lt;/ol&amp;gt;         &lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            Rozšíření &amp;quot;Import průchodů&amp;quot;&lt;br /&gt;
        &amp;lt;/ol&amp;gt;    &lt;br /&gt;
    &amp;lt;/li&amp;gt;&lt;br /&gt;
    &amp;lt;li&amp;gt;&lt;br /&gt;
        Přes aplikační server. &lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            Protokol SOAP/REST. &lt;br /&gt;
        &amp;lt;/ol&amp;gt;         &lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            Rozšíření &amp;quot;Import průchodů SOAP/REST - Nová&amp;quot;&lt;br /&gt;
        &amp;lt;/ol&amp;gt;        &lt;br /&gt;
    &amp;lt;/li&amp;gt;&lt;br /&gt;
&amp;lt;/ul&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;i&amp;gt;&lt;br /&gt;
S touto funkcí je možné importovat data z docházkových nebo přístupových systémů třetích stran do modulu Docházka v aplikaci KS portál.&lt;br /&gt;
&lt;br /&gt;
Lze využít v případě, že jsou k dispozici informace o průchodech zaměstnanců přes nějaký terminál nebo turniket a k takto získaným datům nelze přistupovat z plnohodnotného docházkového systému. Pokud tedy nelze data pro mzdy připravit jinak, je možné je naimportovat do modulu Docházka v aplikaci KS portál, kde s nimi lze pracovat jako s běžným docházkovým systémem.&lt;br /&gt;
&amp;lt;/i&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h2&amp;gt;Import průchodů přes webovou službu&amp;lt;/h2&amp;gt;&lt;br /&gt;
&amp;lt;h3&amp;gt;Nastavení&amp;lt;/h3&amp;gt;&lt;br /&gt;
* Aktivace rozšíření.&lt;br /&gt;
* Následně je potřeba do web.cofigu do appsettings doplnit klíč '''''WsAuthKey''''', jako hodnotu zadejte dostatečně dlouhý bezpečný řetězec. Tato hodnota musí být předávána v autentizační SOAP hlavičce s názvem '''''AuthKeyHeader''''', a to při každém požadavku o zápis průchodu.&lt;br /&gt;
* Pokud bude aktivní rozšíření, popis služby lze získat přes odkaz v KS portále&lt;br /&gt;
 [rootKSportalu]/webservices/dchpruchody.asmx?op=PruchodVloz&lt;br /&gt;
* V struktuře předávaných dat jsou důležité následující položky&lt;br /&gt;
: ''OsCislo'' - Osobní číslo zaměstnance&lt;br /&gt;
: ''Kod'' - Kód dopovídající číselníku docházkových kódů&lt;br /&gt;
: ''Cas'' - DateTime&lt;br /&gt;
* Pokud při zápisu dojde k chybě tak ta je vrácena s kódem a popisem chyby (popis dále).&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h4&amp;gt;SOAP 1.1&amp;lt;/h4&amp;gt;&lt;br /&gt;
Následuje ukázkový požadavek a odpověď SOAP 1.1. Uvedené zástupce je třeba nahradit skutečnými hodnotami.&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
 POST /ksportal/webservices/dchpruchody.asmx HTTP/1.1&lt;br /&gt;
 Host: localhost&lt;br /&gt;
 Content-Type: text/xml; charset=utf-8&lt;br /&gt;
 Content-Length: length&lt;br /&gt;
 SOAPAction: &amp;quot;ksprtl/WebServices/PruchodVloz&amp;quot;&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;br /&gt;
 &amp;lt;soap:Envelope xmlns:xsi=&amp;quot;http://www.w3.org/2001/XMLSchema-instance&amp;quot; xmlns:xsd=&amp;quot;http://www.w3.org/2001/XMLSchema&amp;quot; xmlns:soap=&amp;quot;http://schemas.xmlsoap.org /soap/envelope/&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;soap:Header&amp;gt;&lt;br /&gt;
    &amp;lt;AuthKeyHeader xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;AuthKey&amp;gt;string&amp;lt;/AuthKey&amp;gt;&lt;br /&gt;
    &amp;lt;/AuthKeyHeader&amp;gt;&lt;br /&gt;
  &amp;lt;/soap:Header&amp;gt;&lt;br /&gt;
  &amp;lt;soap:Body&amp;gt;&lt;br /&gt;
    &amp;lt;PruchodVloz xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;pr&amp;gt;&lt;br /&gt;
        &amp;lt;OsCislo&amp;gt;decimal&amp;lt;/OsCislo&amp;gt;&lt;br /&gt;
        &amp;lt;CisloPom&amp;gt;short&amp;lt;/CisloPom&amp;gt;&lt;br /&gt;
        &amp;lt;Kod&amp;gt;int&amp;lt;/Kod&amp;gt;&lt;br /&gt;
        &amp;lt;Prac_str&amp;gt;string&amp;lt;/Prac_str&amp;gt;&lt;br /&gt;
        &amp;lt;Cas&amp;gt;dateTime&amp;lt;/Cas&amp;gt;&lt;br /&gt;
        &amp;lt;Doba&amp;gt;string&amp;lt;/Doba&amp;gt;&lt;br /&gt;
        &amp;lt;Kodprst&amp;gt;string&amp;lt;/Kodprst&amp;gt;&lt;br /&gt;
        &amp;lt;Sazba&amp;gt;decimal&amp;lt;/Sazba&amp;gt;&lt;br /&gt;
        &amp;lt;Castka&amp;gt;decimal&amp;lt;/Castka&amp;gt;&lt;br /&gt;
        &amp;lt;C_pole1&amp;gt;string&amp;lt;/C_pole1&amp;gt;&lt;br /&gt;
        &amp;lt;C_pole2&amp;gt;string&amp;lt;/C_pole2&amp;gt;&lt;br /&gt;
        &amp;lt;N_pole1&amp;gt;long&amp;lt;/N_pole1&amp;gt;&lt;br /&gt;
        &amp;lt;N_pole2&amp;gt;long&amp;lt;/N_pole2&amp;gt;&lt;br /&gt;
        &amp;lt;Poznamka&amp;gt;string&amp;lt;/Poznamka&amp;gt;&lt;br /&gt;
      &amp;lt;/pr&amp;gt;&lt;br /&gt;
    &amp;lt;/PruchodVloz&amp;gt;&lt;br /&gt;
  &amp;lt;/soap:Body&amp;gt;&lt;br /&gt;
 &amp;lt;/soap:Envelope&amp;gt;&lt;br /&gt;
 HTTP/1.1 200 OK&lt;br /&gt;
 Content-Type: text/xml; charset=utf-8&lt;br /&gt;
 Content-Length: length&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;br /&gt;
 &amp;lt;soap:Envelope xmlns:xsi=&amp;quot;http://www.w3.org/2001/XMLSchema-instance&amp;quot; xmlns:xsd=&amp;quot;http://www.w3.org/2001/XMLSchema&amp;quot; xmlns:soap=&amp;quot;http://schemas.xmlsoap.org /soap/envelope/&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;soap:Body&amp;gt;&lt;br /&gt;
    &amp;lt;PruchodVlozResponse xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;PruchodVlozResult&amp;gt;&lt;br /&gt;
        &amp;lt;ErrorCode&amp;gt;int&amp;lt;/ErrorCode&amp;gt;&lt;br /&gt;
        &amp;lt;ErrorString&amp;gt;string&amp;lt;/ErrorString&amp;gt;&lt;br /&gt;
      &amp;lt;/PruchodVlozResult&amp;gt;&lt;br /&gt;
    &amp;lt;/PruchodVlozResponse&amp;gt;&lt;br /&gt;
  &amp;lt;/soap:Body&amp;gt;&lt;br /&gt;
 &amp;lt;/soap:Envelope&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h4&amp;gt;SOAP 1.2&amp;lt;/h4&amp;gt;&lt;br /&gt;
Následuje ukázkový požadavek a odpověď SOAP 1.2. Uvedené zástupce je třeba nahradit skutečnými hodnotami.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
 POST /ksportal/webservices/dchpruchody.asmx HTTP/1.1&lt;br /&gt;
 Host: localhost&lt;br /&gt;
 Content-Type: application/soap+xml; charset=utf-8&lt;br /&gt;
 Content-Length: length&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;br /&gt;
 &amp;lt;soap12:Envelope xmlns:xsi=&amp;quot;http://www.w3.org/2001/XMLSchema-instance&amp;quot; xmlns:xsd=&amp;quot;http://www.w3.org/2001/XMLSchema&amp;quot; xmlns:soap12=&amp;quot;http://www.w3.org/2003/05/soap- envelope&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;soap12:Header&amp;gt;&lt;br /&gt;
    &amp;lt;AuthKeyHeader xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;AuthKey&amp;gt;string&amp;lt;/AuthKey&amp;gt;&lt;br /&gt;
    &amp;lt;/AuthKeyHeader&amp;gt;&lt;br /&gt;
  &amp;lt;/soap12:Header&amp;gt;&lt;br /&gt;
  &amp;lt;soap12:Body&amp;gt;&lt;br /&gt;
    &amp;lt;PruchodVloz xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;pr&amp;gt;&lt;br /&gt;
        &amp;lt;OsCislo&amp;gt;decimal&amp;lt;/OsCislo&amp;gt;&lt;br /&gt;
        &amp;lt;CisloPom&amp;gt;short&amp;lt;/CisloPom&amp;gt;&lt;br /&gt;
        &amp;lt;Kod&amp;gt;int&amp;lt;/Kod&amp;gt;&lt;br /&gt;
        &amp;lt;Prac_str&amp;gt;string&amp;lt;/Prac_str&amp;gt;&lt;br /&gt;
        &amp;lt;Cas&amp;gt;dateTime&amp;lt;/Cas&amp;gt;&lt;br /&gt;
        &amp;lt;Doba&amp;gt;string&amp;lt;/Doba&amp;gt;&lt;br /&gt;
        &amp;lt;Kodprst&amp;gt;string&amp;lt;/Kodprst&amp;gt;&lt;br /&gt;
        &amp;lt;Sazba&amp;gt;decimal&amp;lt;/Sazba&amp;gt;&lt;br /&gt;
        &amp;lt;Castka&amp;gt;decimal&amp;lt;/Castka&amp;gt;&lt;br /&gt;
        &amp;lt;C_pole1&amp;gt;string&amp;lt;/C_pole1&amp;gt;&lt;br /&gt;
        &amp;lt;C_pole2&amp;gt;string&amp;lt;/C_pole2&amp;gt;&lt;br /&gt;
        &amp;lt;N_pole1&amp;gt;long&amp;lt;/N_pole1&amp;gt;&lt;br /&gt;
        &amp;lt;N_pole2&amp;gt;long&amp;lt;/N_pole2&amp;gt;&lt;br /&gt;
        &amp;lt;Poznamka&amp;gt;string&amp;lt;/Poznamka&amp;gt;&lt;br /&gt;
      &amp;lt;/pr&amp;gt;&lt;br /&gt;
    &amp;lt;/PruchodVloz&amp;gt;&lt;br /&gt;
  &amp;lt;/soap12:Body&amp;gt;&lt;br /&gt;
 &amp;lt;/soap12:Envelope&amp;gt;&lt;br /&gt;
 HTTP/1.1 200 OK&lt;br /&gt;
 Content-Type: application/soap+xml; charset=utf-8&lt;br /&gt;
 Content-Length: length&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;br /&gt;
 &amp;lt;soap12:Envelope xmlns:xsi=&amp;quot;http://www.w3.org/2001/XMLSchema-instance&amp;quot; xmlns:xsd=&amp;quot;http://www.w3.org/2001/XMLSchema&amp;quot; xmlns:soap12=&amp;quot;http://www.w3.org/2003/05/soap-envelope&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;soap12:Body&amp;gt;&lt;br /&gt;
    &amp;lt;PruchodVlozResponse xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;PruchodVlozResult&amp;gt;&lt;br /&gt;
        &amp;lt;ErrorCode&amp;gt;int&amp;lt;/ErrorCode&amp;gt;&lt;br /&gt;
        &amp;lt;ErrorString&amp;gt;string&amp;lt;/ErrorString&amp;gt;&lt;br /&gt;
      &amp;lt;/PruchodVlozResult&amp;gt;&lt;br /&gt;
    &amp;lt;/PruchodVlozResponse&amp;gt;&lt;br /&gt;
  &amp;lt;/soap12:Body&amp;gt;&lt;br /&gt;
 &amp;lt;/soap12:Envelope&amp;gt;&lt;br /&gt;
 &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h2&amp;gt;Import průchodů přes aplikační server&amp;lt;/h2&amp;gt;&lt;br /&gt;
Umožňuje synchronizovat data prostřednictvím KSweb API (SOAP/REST) uložená v aplikaci KS mzdý PROFI z evidence zaměstnanců, pracovních poměrů a číselníku středisek do libovolných připojených terminálů. Dále se pak data z průchodových terminálů přenáší zpět do modulu Docházka v aplikaci KS portál.&lt;br /&gt;
&lt;br /&gt;
'''POZOR:''' Tato funkcionalita vyžaduje nainstalovanou a spuštěnou aplikaci server KS-AS. Před aktivací této funkcionality ověřte, že aplikace server je funkční. Pokud aplikace není nainstalována nebo nefunguje správně, stáhněte si nejnovější instalační balíček instalátor utility (MapSetup.exe) a nainstalujte jej na stejný server jako je instalována aplikace KS mzdý PROFI nebo jej stáhněte z ftp://ftp.ksprogram.cz/download/&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h3&amp;gt;Položky&amp;lt;/h3&amp;gt;&lt;br /&gt;
{|class=&amp;quot;wikitable sortable&amp;quot; border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|- style=&amp;quot;background-color: #eeeeee&amp;quot;&lt;br /&gt;
!'''Údaj'''&lt;br /&gt;
!'''Datový typ'''&lt;br /&gt;
!'''Povinné pole'''&lt;br /&gt;
!'''Význam'''&lt;br /&gt;
|-&lt;br /&gt;
| IdZaznamu || integer || Ne || Jednoznačná identifikace záznamu v externím systému.&lt;br /&gt;
|-&lt;br /&gt;
| OsCislo || decimal(10,0) || Ano || Osobní číslo zaměstnance.&lt;br /&gt;
|-&lt;br /&gt;
| CisloPom || smallint || Ne || Číslo pracovního poměru.&lt;br /&gt;
|-&lt;br /&gt;
| Kod || char(10) || Ano || Docházkový kód externího systému.&lt;br /&gt;
|-&lt;br /&gt;
| Cas || char(17) || Ano || Datum a čas ve formátu yyyy-MM-dd hhmmss.&lt;br /&gt;
|-&lt;br /&gt;
| NazevZarizeni || char(50) || Ne || Název zařízení externího systému.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''REST'''&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
curl -X POST https://example.com/api/rest/ImportPruchodu \&lt;br /&gt;
  -H &amp;quot;Content-Type: text/plain&amp;quot; \&lt;br /&gt;
  -d '{&lt;br /&gt;
    &amp;quot;IdZaznamu&amp;quot;: 123,&lt;br /&gt;
    &amp;quot;OsCislo&amp;quot;: 4567890123,&lt;br /&gt;
    &amp;quot;CisloPom&amp;quot;: 1,&lt;br /&gt;
    &amp;quot;Kod&amp;quot;: &amp;quot;ABC123&amp;quot;,&lt;br /&gt;
    &amp;quot;Cas&amp;quot;: &amp;quot;2025-03-11 105844&amp;quot;,&lt;br /&gt;
    &amp;quot;NazevZarizeni&amp;quot;: &amp;quot;Externí zařízení&amp;quot;&lt;br /&gt;
  }'&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''SOAP'''&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;lt;soap:Envelope xmlns:soap=&amp;quot;http://www.w3.org/2003/05/soap-envelope&amp;quot; xmlns:web=&amp;quot;http://KSProgram/KSAsServer/WebService&amp;quot; xmlns:ksp=&amp;quot;http://schemas.datacontract.org/2004/07/KSProgram.AS.WCF&amp;quot;&amp;gt;&lt;br /&gt;
    &amp;lt;soap:Header/&amp;gt;&lt;br /&gt;
    &amp;lt;soap:Body&amp;gt;&lt;br /&gt;
      &amp;lt;web:InsertData&amp;gt;&lt;br /&gt;
        &amp;lt;web:aParam&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:DataValidationOnly&amp;gt;false&amp;lt;/ksp:DataValidationOnly&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:ItemGroup&amp;gt;ImportPruchodu&amp;lt;/ksp:ItemGroup&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:Items&amp;gt;&amp;lt;/ksp:Items&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:JsonChangeData&amp;gt;[{&lt;br /&gt;
            &amp;quot;IdZaznamu&amp;quot;: 123,&lt;br /&gt;
            &amp;quot;OsCislo&amp;quot;: 4567890123,&lt;br /&gt;
            &amp;quot;CisloPom&amp;quot;: 1,&lt;br /&gt;
            &amp;quot;Kod&amp;quot;: &amp;quot;ABC123&amp;quot;,&lt;br /&gt;
            &amp;quot;Cas&amp;quot;: &amp;quot;2025-03-11 105844&amp;quot;,&lt;br /&gt;
            &amp;quot;NazevZarizeni&amp;quot;: &amp;quot;Externí zařízení&amp;quot;&lt;br /&gt;
          }]&amp;lt;/ksp:JsonChangeData&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:JsonOptions&amp;gt;&amp;lt;/ksp:JsonOptions&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:JsonSearchCriteria&amp;gt;&amp;lt;/ksp:JsonSearchCriteria&amp;gt;&lt;br /&gt;
        &amp;lt;/web:aParam&amp;gt;&lt;br /&gt;
      &amp;lt;/web:InsertData&amp;gt;&lt;br /&gt;
    &amp;lt;/soap:Body&amp;gt;&lt;br /&gt;
  &amp;lt;/soap:Envelope&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Příručka KS portál]]&lt;br /&gt;
* [[Rozšíření aplikace]]&lt;br /&gt;
* &amp;lt;small&amp;gt;hd 51867&amp;lt;/small&amp;gt;&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Import_pr%C5%AFchod%C5%AF&amp;diff=47966</id>
		<title>Import průchodů</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Import_pr%C5%AFchod%C5%AF&amp;diff=47966"/>
		<updated>2025-03-11T13:26:08Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;''Import průchodů'' je [[Rozšíření aplikace]] &amp;lt;small&amp;gt;([[KS docházka (Rozšíření aplikace)]])&amp;lt;/small&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
'''Dva způsoby importu průchodů'''&lt;br /&gt;
&amp;lt;ul&amp;gt;&lt;br /&gt;
    &amp;lt;li&amp;gt;&lt;br /&gt;
        Přes webovou službu pro import dat pro [[KS docházka|KS docházku]]. Dokumentace je součástí webové služby.&lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            Protokol SOAP. &lt;br /&gt;
        &amp;lt;/ol&amp;gt;         &lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            Rozšíření &amp;quot;Import průchodů&amp;quot;&lt;br /&gt;
        &amp;lt;/ol&amp;gt;    &lt;br /&gt;
    &amp;lt;/li&amp;gt;&lt;br /&gt;
    &amp;lt;li&amp;gt;&lt;br /&gt;
        Přes aplikační server. &lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            Protokol SOAP/REST. &lt;br /&gt;
        &amp;lt;/ol&amp;gt;         &lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            Rozšíření &amp;quot;Import průchodů SOAP/REST - Nová&amp;quot;&lt;br /&gt;
        &amp;lt;/ol&amp;gt;        &lt;br /&gt;
    &amp;lt;/li&amp;gt;&lt;br /&gt;
&amp;lt;/ul&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;i&amp;gt;&lt;br /&gt;
S touto funkcí je možné importovat data z docházkových nebo přístupových systémů třetích stran do modulu Docházka v aplikaci KS portál.&lt;br /&gt;
&lt;br /&gt;
Lze využít v případě, že jsou k dispozici informace o průchodech zaměstnanců přes nějaký terminál nebo turniket a k takto získaným datům nelze přistupovat z plnohodnotného docházkového systému. Pokud tedy nelze data pro mzdy připravit jinak, je možné je naimportovat do modulu Docházka v aplikaci KS portál, kde s nimi lze pracovat jako s běžným docházkovým systémem.&lt;br /&gt;
&amp;lt;/i&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h2&amp;gt;Import průchodů přes webovou službu&amp;lt;/h2&amp;gt;&lt;br /&gt;
&amp;lt;h3&amp;gt;Nastavení&amp;lt;/h3&amp;gt;&lt;br /&gt;
* Aktivace rozšíření.&lt;br /&gt;
* Následně je potřeba do web.cofigu do appsettings doplnit klíč '''''WsAuthKey''''', jako hodnotu zadejte dostatečně dlouhý bezpečný řetězec. Tato hodnota musí být předávána v autentizační SOAP hlavičce s názvem '''''AuthKeyHeader''''', a to při každém požadavku o zápis průchodu.&lt;br /&gt;
* Pokud bude aktivní rozšíření, popis služby lze získat přes odkaz v KS portále&lt;br /&gt;
 [rootKSportalu]/webservices/dchpruchody.asmx?op=PruchodVloz&lt;br /&gt;
* V struktuře předávaných dat jsou důležité následující položky&lt;br /&gt;
: ''OsCislo'' - Osobní číslo zaměstnance&lt;br /&gt;
: ''Kod'' - Kód dopovídající číselníku docházkových kódů&lt;br /&gt;
: ''Cas'' - DateTime&lt;br /&gt;
* Pokud při zápisu dojde k chybě tak ta je vrácena s kódem a popisem chyby (popis dále).&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h4&amp;gt;SOAP 1.1&amp;lt;/h4&amp;gt;&lt;br /&gt;
Následuje ukázkový požadavek a odpověď SOAP 1.1. Uvedené zástupce je třeba nahradit skutečnými hodnotami.&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
 POST /ksportal/webservices/dchpruchody.asmx HTTP/1.1&lt;br /&gt;
 Host: localhost&lt;br /&gt;
 Content-Type: text/xml; charset=utf-8&lt;br /&gt;
 Content-Length: length&lt;br /&gt;
 SOAPAction: &amp;quot;ksprtl/WebServices/PruchodVloz&amp;quot;&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;br /&gt;
 &amp;lt;soap:Envelope xmlns:xsi=&amp;quot;http://www.w3.org/2001/XMLSchema-instance&amp;quot; xmlns:xsd=&amp;quot;http://www.w3.org/2001/XMLSchema&amp;quot; xmlns:soap=&amp;quot;http://schemas.xmlsoap.org /soap/envelope/&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;soap:Header&amp;gt;&lt;br /&gt;
    &amp;lt;AuthKeyHeader xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;AuthKey&amp;gt;string&amp;lt;/AuthKey&amp;gt;&lt;br /&gt;
    &amp;lt;/AuthKeyHeader&amp;gt;&lt;br /&gt;
  &amp;lt;/soap:Header&amp;gt;&lt;br /&gt;
  &amp;lt;soap:Body&amp;gt;&lt;br /&gt;
    &amp;lt;PruchodVloz xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;pr&amp;gt;&lt;br /&gt;
        &amp;lt;OsCislo&amp;gt;decimal&amp;lt;/OsCislo&amp;gt;&lt;br /&gt;
        &amp;lt;CisloPom&amp;gt;short&amp;lt;/CisloPom&amp;gt;&lt;br /&gt;
        &amp;lt;Kod&amp;gt;int&amp;lt;/Kod&amp;gt;&lt;br /&gt;
        &amp;lt;Prac_str&amp;gt;string&amp;lt;/Prac_str&amp;gt;&lt;br /&gt;
        &amp;lt;Cas&amp;gt;dateTime&amp;lt;/Cas&amp;gt;&lt;br /&gt;
        &amp;lt;Doba&amp;gt;string&amp;lt;/Doba&amp;gt;&lt;br /&gt;
        &amp;lt;Kodprst&amp;gt;string&amp;lt;/Kodprst&amp;gt;&lt;br /&gt;
        &amp;lt;Sazba&amp;gt;decimal&amp;lt;/Sazba&amp;gt;&lt;br /&gt;
        &amp;lt;Castka&amp;gt;decimal&amp;lt;/Castka&amp;gt;&lt;br /&gt;
        &amp;lt;C_pole1&amp;gt;string&amp;lt;/C_pole1&amp;gt;&lt;br /&gt;
        &amp;lt;C_pole2&amp;gt;string&amp;lt;/C_pole2&amp;gt;&lt;br /&gt;
        &amp;lt;N_pole1&amp;gt;long&amp;lt;/N_pole1&amp;gt;&lt;br /&gt;
        &amp;lt;N_pole2&amp;gt;long&amp;lt;/N_pole2&amp;gt;&lt;br /&gt;
        &amp;lt;Poznamka&amp;gt;string&amp;lt;/Poznamka&amp;gt;&lt;br /&gt;
      &amp;lt;/pr&amp;gt;&lt;br /&gt;
    &amp;lt;/PruchodVloz&amp;gt;&lt;br /&gt;
  &amp;lt;/soap:Body&amp;gt;&lt;br /&gt;
 &amp;lt;/soap:Envelope&amp;gt;&lt;br /&gt;
 HTTP/1.1 200 OK&lt;br /&gt;
 Content-Type: text/xml; charset=utf-8&lt;br /&gt;
 Content-Length: length&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;br /&gt;
 &amp;lt;soap:Envelope xmlns:xsi=&amp;quot;http://www.w3.org/2001/XMLSchema-instance&amp;quot; xmlns:xsd=&amp;quot;http://www.w3.org/2001/XMLSchema&amp;quot; xmlns:soap=&amp;quot;http://schemas.xmlsoap.org /soap/envelope/&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;soap:Body&amp;gt;&lt;br /&gt;
    &amp;lt;PruchodVlozResponse xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;PruchodVlozResult&amp;gt;&lt;br /&gt;
        &amp;lt;ErrorCode&amp;gt;int&amp;lt;/ErrorCode&amp;gt;&lt;br /&gt;
        &amp;lt;ErrorString&amp;gt;string&amp;lt;/ErrorString&amp;gt;&lt;br /&gt;
      &amp;lt;/PruchodVlozResult&amp;gt;&lt;br /&gt;
    &amp;lt;/PruchodVlozResponse&amp;gt;&lt;br /&gt;
  &amp;lt;/soap:Body&amp;gt;&lt;br /&gt;
 &amp;lt;/soap:Envelope&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h4&amp;gt;SOAP 1.2&amp;lt;/h4&amp;gt;&lt;br /&gt;
Následuje ukázkový požadavek a odpověď SOAP 1.2. Uvedené zástupce je třeba nahradit skutečnými hodnotami.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
 POST /ksportal/webservices/dchpruchody.asmx HTTP/1.1&lt;br /&gt;
 Host: localhost&lt;br /&gt;
 Content-Type: application/soap+xml; charset=utf-8&lt;br /&gt;
 Content-Length: length&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;br /&gt;
 &amp;lt;soap12:Envelope xmlns:xsi=&amp;quot;http://www.w3.org/2001/XMLSchema-instance&amp;quot; xmlns:xsd=&amp;quot;http://www.w3.org/2001/XMLSchema&amp;quot; xmlns:soap12=&amp;quot;http://www.w3.org/2003/05/soap- envelope&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;soap12:Header&amp;gt;&lt;br /&gt;
    &amp;lt;AuthKeyHeader xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;AuthKey&amp;gt;string&amp;lt;/AuthKey&amp;gt;&lt;br /&gt;
    &amp;lt;/AuthKeyHeader&amp;gt;&lt;br /&gt;
  &amp;lt;/soap12:Header&amp;gt;&lt;br /&gt;
  &amp;lt;soap12:Body&amp;gt;&lt;br /&gt;
    &amp;lt;PruchodVloz xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;pr&amp;gt;&lt;br /&gt;
        &amp;lt;OsCislo&amp;gt;decimal&amp;lt;/OsCislo&amp;gt;&lt;br /&gt;
        &amp;lt;CisloPom&amp;gt;short&amp;lt;/CisloPom&amp;gt;&lt;br /&gt;
        &amp;lt;Kod&amp;gt;int&amp;lt;/Kod&amp;gt;&lt;br /&gt;
        &amp;lt;Prac_str&amp;gt;string&amp;lt;/Prac_str&amp;gt;&lt;br /&gt;
        &amp;lt;Cas&amp;gt;dateTime&amp;lt;/Cas&amp;gt;&lt;br /&gt;
        &amp;lt;Doba&amp;gt;string&amp;lt;/Doba&amp;gt;&lt;br /&gt;
        &amp;lt;Kodprst&amp;gt;string&amp;lt;/Kodprst&amp;gt;&lt;br /&gt;
        &amp;lt;Sazba&amp;gt;decimal&amp;lt;/Sazba&amp;gt;&lt;br /&gt;
        &amp;lt;Castka&amp;gt;decimal&amp;lt;/Castka&amp;gt;&lt;br /&gt;
        &amp;lt;C_pole1&amp;gt;string&amp;lt;/C_pole1&amp;gt;&lt;br /&gt;
        &amp;lt;C_pole2&amp;gt;string&amp;lt;/C_pole2&amp;gt;&lt;br /&gt;
        &amp;lt;N_pole1&amp;gt;long&amp;lt;/N_pole1&amp;gt;&lt;br /&gt;
        &amp;lt;N_pole2&amp;gt;long&amp;lt;/N_pole2&amp;gt;&lt;br /&gt;
        &amp;lt;Poznamka&amp;gt;string&amp;lt;/Poznamka&amp;gt;&lt;br /&gt;
      &amp;lt;/pr&amp;gt;&lt;br /&gt;
    &amp;lt;/PruchodVloz&amp;gt;&lt;br /&gt;
  &amp;lt;/soap12:Body&amp;gt;&lt;br /&gt;
 &amp;lt;/soap12:Envelope&amp;gt;&lt;br /&gt;
 HTTP/1.1 200 OK&lt;br /&gt;
 Content-Type: application/soap+xml; charset=utf-8&lt;br /&gt;
 Content-Length: length&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;br /&gt;
 &amp;lt;soap12:Envelope xmlns:xsi=&amp;quot;http://www.w3.org/2001/XMLSchema-instance&amp;quot; xmlns:xsd=&amp;quot;http://www.w3.org/2001/XMLSchema&amp;quot; xmlns:soap12=&amp;quot;http://www.w3.org/2003/05/soap-envelope&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;soap12:Body&amp;gt;&lt;br /&gt;
    &amp;lt;PruchodVlozResponse xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;PruchodVlozResult&amp;gt;&lt;br /&gt;
        &amp;lt;ErrorCode&amp;gt;int&amp;lt;/ErrorCode&amp;gt;&lt;br /&gt;
        &amp;lt;ErrorString&amp;gt;string&amp;lt;/ErrorString&amp;gt;&lt;br /&gt;
      &amp;lt;/PruchodVlozResult&amp;gt;&lt;br /&gt;
    &amp;lt;/PruchodVlozResponse&amp;gt;&lt;br /&gt;
  &amp;lt;/soap12:Body&amp;gt;&lt;br /&gt;
 &amp;lt;/soap12:Envelope&amp;gt;&lt;br /&gt;
 &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h2&amp;gt;Import průchodů přes aplikační server&amp;lt;/h2&amp;gt;&lt;br /&gt;
Umožňuje synchronizovat data prostřednictvím KSweb API (SOAP/REST) uložená v aplikaci KS mzdý PROFI z evidence zaměstnanců, pracovních poměrů a číselníku středisek do libovolných připojených terminálů. Dále se pak data z průchodových terminálů přenáší zpět do modulu Docházka v aplikaci KS portál.&lt;br /&gt;
&lt;br /&gt;
'''POZOR:''' Tato funkcionalita vyžaduje nainstalovanou a spuštěnou aplikaci server KS-AS. Před aktivací této funkcionality ověřte, že aplikace server je funkční. Pokud aplikace není nainstalována nebo nefunguje správně, stáhněte si nejnovější instalační balíček instalátor utility (MapSetup.exe) a nainstalujte jej na stejný server jako je instalována aplikace KS mzdý PROFI nebo jej stáhněte z ftp://ftp.ksprogram.cz/download/&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h3&amp;gt;Položky&amp;lt;/h3&amp;gt;&lt;br /&gt;
&amp;lt;table border=&amp;quot;1&amp;quot;&amp;gt;&lt;br /&gt;
    &amp;lt;tr&amp;gt;&lt;br /&gt;
      &amp;lt;th&amp;gt;Údaj&amp;lt;/th&amp;gt;&lt;br /&gt;
      &amp;lt;th&amp;gt;Datový typ&amp;lt;/th&amp;gt;&lt;br /&gt;
      &amp;lt;th&amp;gt;Povinné pole&amp;lt;/th&amp;gt;&lt;br /&gt;
      &amp;lt;th&amp;gt;Význam&amp;lt;/th&amp;gt;&lt;br /&gt;
    &amp;lt;/tr&amp;gt;&lt;br /&gt;
    &amp;lt;tr&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;IdZaznamu&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;integer&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Ne&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Jednoznačná identifikace záznamu v externím systému.&amp;lt;/td&amp;gt;&lt;br /&gt;
    &amp;lt;/tr&amp;gt;&lt;br /&gt;
    &amp;lt;tr&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;OsCislo&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;decimal(10,0)&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Ano&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Osobní číslo zaměstnance.&amp;lt;/td&amp;gt;&lt;br /&gt;
    &amp;lt;/tr&amp;gt;&lt;br /&gt;
    &amp;lt;tr&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;CisloPom&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;smallint&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Ne&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Číslo pracovního poměru.&amp;lt;/td&amp;gt;&lt;br /&gt;
    &amp;lt;/tr&amp;gt;&lt;br /&gt;
    &amp;lt;tr&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Kod&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;char(10)&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Ano&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Docházkový kód externího systému.&amp;lt;/td&amp;gt;&lt;br /&gt;
    &amp;lt;/tr&amp;gt;&lt;br /&gt;
    &amp;lt;tr&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Cas&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;char(17)&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Ano&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Datum a čas ve formátu yyyy-MM-dd hhmmss.&amp;lt;/td&amp;gt;&lt;br /&gt;
    &amp;lt;/tr&amp;gt;&lt;br /&gt;
    &amp;lt;tr&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;NazevZarizeni&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;char(50)&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Ne&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Název zařízení externího systému.&amp;lt;/td&amp;gt;&lt;br /&gt;
    &amp;lt;/tr&amp;gt;&lt;br /&gt;
&amp;lt;/table&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''REST'''&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
curl -X POST https://example.com/api/rest/ImportPruchodu \&lt;br /&gt;
  -H &amp;quot;Content-Type: text/plain&amp;quot; \&lt;br /&gt;
  -d '{&lt;br /&gt;
    &amp;quot;IdZaznamu&amp;quot;: 123,&lt;br /&gt;
    &amp;quot;OsCislo&amp;quot;: 4567890123,&lt;br /&gt;
    &amp;quot;CisloPom&amp;quot;: 1,&lt;br /&gt;
    &amp;quot;Kod&amp;quot;: &amp;quot;ABC123&amp;quot;,&lt;br /&gt;
    &amp;quot;Cas&amp;quot;: &amp;quot;2025-03-11 105844&amp;quot;,&lt;br /&gt;
    &amp;quot;NazevZarizeni&amp;quot;: &amp;quot;Externí zařízení&amp;quot;&lt;br /&gt;
  }'&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''SOAP'''&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;lt;soap:Envelope xmlns:soap=&amp;quot;http://www.w3.org/2003/05/soap-envelope&amp;quot; xmlns:web=&amp;quot;http://KSProgram/KSAsServer/WebService&amp;quot; xmlns:ksp=&amp;quot;http://schemas.datacontract.org/2004/07/KSProgram.AS.WCF&amp;quot;&amp;gt;&lt;br /&gt;
    &amp;lt;soap:Header/&amp;gt;&lt;br /&gt;
    &amp;lt;soap:Body&amp;gt;&lt;br /&gt;
      &amp;lt;web:InsertData&amp;gt;&lt;br /&gt;
        &amp;lt;web:aParam&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:DataValidationOnly&amp;gt;false&amp;lt;/ksp:DataValidationOnly&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:ItemGroup&amp;gt;ImportPruchodu&amp;lt;/ksp:ItemGroup&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:Items&amp;gt;&amp;lt;/ksp:Items&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:JsonChangeData&amp;gt;[{&lt;br /&gt;
            &amp;quot;IdZaznamu&amp;quot;: 123,&lt;br /&gt;
            &amp;quot;OsCislo&amp;quot;: 4567890123,&lt;br /&gt;
            &amp;quot;CisloPom&amp;quot;: 1,&lt;br /&gt;
            &amp;quot;Kod&amp;quot;: &amp;quot;ABC123&amp;quot;,&lt;br /&gt;
            &amp;quot;Cas&amp;quot;: &amp;quot;2025-03-11 105844&amp;quot;,&lt;br /&gt;
            &amp;quot;NazevZarizeni&amp;quot;: &amp;quot;Externí zařízení&amp;quot;&lt;br /&gt;
          }]&amp;lt;/ksp:JsonChangeData&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:JsonOptions&amp;gt;&amp;lt;/ksp:JsonOptions&amp;gt;&lt;br /&gt;
          &amp;lt;ksp:JsonSearchCriteria&amp;gt;&amp;lt;/ksp:JsonSearchCriteria&amp;gt;&lt;br /&gt;
        &amp;lt;/web:aParam&amp;gt;&lt;br /&gt;
      &amp;lt;/web:InsertData&amp;gt;&lt;br /&gt;
    &amp;lt;/soap:Body&amp;gt;&lt;br /&gt;
  &amp;lt;/soap:Envelope&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Příručka KS portál]]&lt;br /&gt;
* [[Rozšíření aplikace]]&lt;br /&gt;
* &amp;lt;small&amp;gt;hd 51867&amp;lt;/small&amp;gt;&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Import_pr%C5%AFchod%C5%AF&amp;diff=47965</id>
		<title>Import průchodů</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Import_pr%C5%AFchod%C5%AF&amp;diff=47965"/>
		<updated>2025-03-11T10:13:19Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;''Import průchodů'' je [[Rozšíření aplikace]] &amp;lt;small&amp;gt;([[KS docházka (Rozšíření aplikace)]])&amp;lt;/small&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
'''Dva způsoby importu průchodů'''&lt;br /&gt;
&amp;lt;ul&amp;gt;&lt;br /&gt;
    &amp;lt;li&amp;gt;&lt;br /&gt;
        Přes webovou službu pro import dat pro [[KS docházka|KS docházku]]. Dokumentace je součástí webové služby.&lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            Protokol SOAP. &lt;br /&gt;
        &amp;lt;/ol&amp;gt;         &lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            Rozšíření &amp;quot;Import průchodů&amp;quot;&lt;br /&gt;
        &amp;lt;/ol&amp;gt;    &lt;br /&gt;
    &amp;lt;/li&amp;gt;&lt;br /&gt;
    &amp;lt;li&amp;gt;&lt;br /&gt;
        Přes aplikační server. &lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            Protokol SOAP/REST. &lt;br /&gt;
        &amp;lt;/ol&amp;gt;         &lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            Rozšíření &amp;quot;Import průchodů SOAP/REST - Nová&amp;quot;&lt;br /&gt;
        &amp;lt;/ol&amp;gt;        &lt;br /&gt;
    &amp;lt;/li&amp;gt;&lt;br /&gt;
&amp;lt;/ul&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;i&amp;gt;&lt;br /&gt;
S touto funkcí je možné importovat data z docházkových nebo přístupových systémů třetích stran do modulu Docházka v aplikaci KS portál.&lt;br /&gt;
&lt;br /&gt;
Lze využít v případě, že jsou k dispozici informace o průchodech zaměstnanců přes nějaký terminál nebo turniket a k takto získaným datům nelze přistupovat z plnohodnotného docházkového systému. Pokud tedy nelze data pro mzdy připravit jinak, je možné je naimportovat do modulu Docházka v aplikaci KS portál, kde s nimi lze pracovat jako s běžným docházkovým systémem.&lt;br /&gt;
&amp;lt;/i&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h2&amp;gt;Import průchodů přes webovou službu&amp;lt;/h2&amp;gt;&lt;br /&gt;
&amp;lt;h3&amp;gt;Nastavení&amp;lt;/h3&amp;gt;&lt;br /&gt;
* Aktivace rozšíření.&lt;br /&gt;
* Následně je potřeba do web.cofigu do appsettings doplnit klíč '''''WsAuthKey''''', jako hodnotu zadejte dostatečně dlouhý bezpečný řetězec. Tato hodnota musí být předávána v autentizační SOAP hlavičce s názvem '''''AuthKeyHeader''''', a to při každém požadavku o zápis průchodu.&lt;br /&gt;
* Pokud bude aktivní rozšíření, popis služby lze získat přes odkaz v KS portále&lt;br /&gt;
 [rootKSportalu]/webservices/dchpruchody.asmx?op=PruchodVloz&lt;br /&gt;
* V struktuře předávaných dat jsou důležité následující položky&lt;br /&gt;
: ''OsCislo'' - Osobní číslo zaměstnance&lt;br /&gt;
: ''Kod'' - Kód dopovídající číselníku docházkových kódů&lt;br /&gt;
: ''Cas'' - DateTime&lt;br /&gt;
* Pokud při zápisu dojde k chybě tak ta je vrácena s kódem a popisem chyby (popis dále).&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h4&amp;gt;SOAP 1.1&amp;lt;/h4&amp;gt;&lt;br /&gt;
Následuje ukázkový požadavek a odpověď SOAP 1.1. Uvedené zástupce je třeba nahradit skutečnými hodnotami.&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
 POST /ksportal/webservices/dchpruchody.asmx HTTP/1.1&lt;br /&gt;
 Host: localhost&lt;br /&gt;
 Content-Type: text/xml; charset=utf-8&lt;br /&gt;
 Content-Length: length&lt;br /&gt;
 SOAPAction: &amp;quot;ksprtl/WebServices/PruchodVloz&amp;quot;&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;br /&gt;
 &amp;lt;soap:Envelope xmlns:xsi=&amp;quot;http://www.w3.org/2001/XMLSchema-instance&amp;quot; xmlns:xsd=&amp;quot;http://www.w3.org/2001/XMLSchema&amp;quot; xmlns:soap=&amp;quot;http://schemas.xmlsoap.org /soap/envelope/&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;soap:Header&amp;gt;&lt;br /&gt;
    &amp;lt;AuthKeyHeader xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;AuthKey&amp;gt;string&amp;lt;/AuthKey&amp;gt;&lt;br /&gt;
    &amp;lt;/AuthKeyHeader&amp;gt;&lt;br /&gt;
  &amp;lt;/soap:Header&amp;gt;&lt;br /&gt;
  &amp;lt;soap:Body&amp;gt;&lt;br /&gt;
    &amp;lt;PruchodVloz xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;pr&amp;gt;&lt;br /&gt;
        &amp;lt;OsCislo&amp;gt;decimal&amp;lt;/OsCislo&amp;gt;&lt;br /&gt;
        &amp;lt;CisloPom&amp;gt;short&amp;lt;/CisloPom&amp;gt;&lt;br /&gt;
        &amp;lt;Kod&amp;gt;int&amp;lt;/Kod&amp;gt;&lt;br /&gt;
        &amp;lt;Prac_str&amp;gt;string&amp;lt;/Prac_str&amp;gt;&lt;br /&gt;
        &amp;lt;Cas&amp;gt;dateTime&amp;lt;/Cas&amp;gt;&lt;br /&gt;
        &amp;lt;Doba&amp;gt;string&amp;lt;/Doba&amp;gt;&lt;br /&gt;
        &amp;lt;Kodprst&amp;gt;string&amp;lt;/Kodprst&amp;gt;&lt;br /&gt;
        &amp;lt;Sazba&amp;gt;decimal&amp;lt;/Sazba&amp;gt;&lt;br /&gt;
        &amp;lt;Castka&amp;gt;decimal&amp;lt;/Castka&amp;gt;&lt;br /&gt;
        &amp;lt;C_pole1&amp;gt;string&amp;lt;/C_pole1&amp;gt;&lt;br /&gt;
        &amp;lt;C_pole2&amp;gt;string&amp;lt;/C_pole2&amp;gt;&lt;br /&gt;
        &amp;lt;N_pole1&amp;gt;long&amp;lt;/N_pole1&amp;gt;&lt;br /&gt;
        &amp;lt;N_pole2&amp;gt;long&amp;lt;/N_pole2&amp;gt;&lt;br /&gt;
        &amp;lt;Poznamka&amp;gt;string&amp;lt;/Poznamka&amp;gt;&lt;br /&gt;
      &amp;lt;/pr&amp;gt;&lt;br /&gt;
    &amp;lt;/PruchodVloz&amp;gt;&lt;br /&gt;
  &amp;lt;/soap:Body&amp;gt;&lt;br /&gt;
 &amp;lt;/soap:Envelope&amp;gt;&lt;br /&gt;
 HTTP/1.1 200 OK&lt;br /&gt;
 Content-Type: text/xml; charset=utf-8&lt;br /&gt;
 Content-Length: length&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;br /&gt;
 &amp;lt;soap:Envelope xmlns:xsi=&amp;quot;http://www.w3.org/2001/XMLSchema-instance&amp;quot; xmlns:xsd=&amp;quot;http://www.w3.org/2001/XMLSchema&amp;quot; xmlns:soap=&amp;quot;http://schemas.xmlsoap.org /soap/envelope/&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;soap:Body&amp;gt;&lt;br /&gt;
    &amp;lt;PruchodVlozResponse xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;PruchodVlozResult&amp;gt;&lt;br /&gt;
        &amp;lt;ErrorCode&amp;gt;int&amp;lt;/ErrorCode&amp;gt;&lt;br /&gt;
        &amp;lt;ErrorString&amp;gt;string&amp;lt;/ErrorString&amp;gt;&lt;br /&gt;
      &amp;lt;/PruchodVlozResult&amp;gt;&lt;br /&gt;
    &amp;lt;/PruchodVlozResponse&amp;gt;&lt;br /&gt;
  &amp;lt;/soap:Body&amp;gt;&lt;br /&gt;
 &amp;lt;/soap:Envelope&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h4&amp;gt;SOAP 1.2&amp;lt;/h4&amp;gt;&lt;br /&gt;
Následuje ukázkový požadavek a odpověď SOAP 1.2. Uvedené zástupce je třeba nahradit skutečnými hodnotami.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
 POST /ksportal/webservices/dchpruchody.asmx HTTP/1.1&lt;br /&gt;
 Host: localhost&lt;br /&gt;
 Content-Type: application/soap+xml; charset=utf-8&lt;br /&gt;
 Content-Length: length&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;br /&gt;
 &amp;lt;soap12:Envelope xmlns:xsi=&amp;quot;http://www.w3.org/2001/XMLSchema-instance&amp;quot; xmlns:xsd=&amp;quot;http://www.w3.org/2001/XMLSchema&amp;quot; xmlns:soap12=&amp;quot;http://www.w3.org/2003/05/soap- envelope&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;soap12:Header&amp;gt;&lt;br /&gt;
    &amp;lt;AuthKeyHeader xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;AuthKey&amp;gt;string&amp;lt;/AuthKey&amp;gt;&lt;br /&gt;
    &amp;lt;/AuthKeyHeader&amp;gt;&lt;br /&gt;
  &amp;lt;/soap12:Header&amp;gt;&lt;br /&gt;
  &amp;lt;soap12:Body&amp;gt;&lt;br /&gt;
    &amp;lt;PruchodVloz xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;pr&amp;gt;&lt;br /&gt;
        &amp;lt;OsCislo&amp;gt;decimal&amp;lt;/OsCislo&amp;gt;&lt;br /&gt;
        &amp;lt;CisloPom&amp;gt;short&amp;lt;/CisloPom&amp;gt;&lt;br /&gt;
        &amp;lt;Kod&amp;gt;int&amp;lt;/Kod&amp;gt;&lt;br /&gt;
        &amp;lt;Prac_str&amp;gt;string&amp;lt;/Prac_str&amp;gt;&lt;br /&gt;
        &amp;lt;Cas&amp;gt;dateTime&amp;lt;/Cas&amp;gt;&lt;br /&gt;
        &amp;lt;Doba&amp;gt;string&amp;lt;/Doba&amp;gt;&lt;br /&gt;
        &amp;lt;Kodprst&amp;gt;string&amp;lt;/Kodprst&amp;gt;&lt;br /&gt;
        &amp;lt;Sazba&amp;gt;decimal&amp;lt;/Sazba&amp;gt;&lt;br /&gt;
        &amp;lt;Castka&amp;gt;decimal&amp;lt;/Castka&amp;gt;&lt;br /&gt;
        &amp;lt;C_pole1&amp;gt;string&amp;lt;/C_pole1&amp;gt;&lt;br /&gt;
        &amp;lt;C_pole2&amp;gt;string&amp;lt;/C_pole2&amp;gt;&lt;br /&gt;
        &amp;lt;N_pole1&amp;gt;long&amp;lt;/N_pole1&amp;gt;&lt;br /&gt;
        &amp;lt;N_pole2&amp;gt;long&amp;lt;/N_pole2&amp;gt;&lt;br /&gt;
        &amp;lt;Poznamka&amp;gt;string&amp;lt;/Poznamka&amp;gt;&lt;br /&gt;
      &amp;lt;/pr&amp;gt;&lt;br /&gt;
    &amp;lt;/PruchodVloz&amp;gt;&lt;br /&gt;
  &amp;lt;/soap12:Body&amp;gt;&lt;br /&gt;
 &amp;lt;/soap12:Envelope&amp;gt;&lt;br /&gt;
 HTTP/1.1 200 OK&lt;br /&gt;
 Content-Type: application/soap+xml; charset=utf-8&lt;br /&gt;
 Content-Length: length&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;br /&gt;
 &amp;lt;soap12:Envelope xmlns:xsi=&amp;quot;http://www.w3.org/2001/XMLSchema-instance&amp;quot; xmlns:xsd=&amp;quot;http://www.w3.org/2001/XMLSchema&amp;quot; xmlns:soap12=&amp;quot;http://www.w3.org/2003/05/soap-envelope&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;soap12:Body&amp;gt;&lt;br /&gt;
    &amp;lt;PruchodVlozResponse xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;PruchodVlozResult&amp;gt;&lt;br /&gt;
        &amp;lt;ErrorCode&amp;gt;int&amp;lt;/ErrorCode&amp;gt;&lt;br /&gt;
        &amp;lt;ErrorString&amp;gt;string&amp;lt;/ErrorString&amp;gt;&lt;br /&gt;
      &amp;lt;/PruchodVlozResult&amp;gt;&lt;br /&gt;
    &amp;lt;/PruchodVlozResponse&amp;gt;&lt;br /&gt;
  &amp;lt;/soap12:Body&amp;gt;&lt;br /&gt;
 &amp;lt;/soap12:Envelope&amp;gt;&lt;br /&gt;
 &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h2&amp;gt;Import průchodů přes aplikační server&amp;lt;/h2&amp;gt;&lt;br /&gt;
Umožňuje synchronizovat data prostřednictvím KSweb API (SOAP/REST) uložená v aplikaci KS mzdý PROFI z evidence zaměstnanců, pracovních poměrů a číselníku středisek do libovolných připojených terminálů. Dále se pak data z průchodových terminálů přenáší zpět do modulu Docházka v aplikaci KS portál.&lt;br /&gt;
&lt;br /&gt;
'''POZOR:''' Tato funkcionalita vyžaduje nainstalovanou a spuštěnou aplikaci server KS-AS. Před aktivací této funkcionality ověřte, že aplikace server je funkční. Pokud aplikace není nainstalována nebo nefunguje správně, stáhněte si nejnovější instalační balíček instalátor utility (MapSetup.exe) a nainstalujte jej na stejný server jako je instalována aplikace KS mzdý PROFI nebo jej stáhněte z ftp://ftp.ksprogram.cz/download/&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h3&amp;gt;Položky&amp;lt;/h3&amp;gt;&lt;br /&gt;
&amp;lt;table border=&amp;quot;1&amp;quot;&amp;gt;&lt;br /&gt;
    &amp;lt;tr&amp;gt;&lt;br /&gt;
      &amp;lt;th&amp;gt;Údaj&amp;lt;/th&amp;gt;&lt;br /&gt;
      &amp;lt;th&amp;gt;Datový typ&amp;lt;/th&amp;gt;&lt;br /&gt;
      &amp;lt;th&amp;gt;Povinné pole&amp;lt;/th&amp;gt;&lt;br /&gt;
      &amp;lt;th&amp;gt;Význam&amp;lt;/th&amp;gt;&lt;br /&gt;
    &amp;lt;/tr&amp;gt;&lt;br /&gt;
    &amp;lt;tr&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;IdZaznamu&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;integer&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Ne&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Jednoznačná identifikace záznamu v externím systému.&amp;lt;/td&amp;gt;&lt;br /&gt;
    &amp;lt;/tr&amp;gt;&lt;br /&gt;
    &amp;lt;tr&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;OsCislo&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;decimal(10,0)&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Ano&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Osobní číslo zaměstnance.&amp;lt;/td&amp;gt;&lt;br /&gt;
    &amp;lt;/tr&amp;gt;&lt;br /&gt;
    &amp;lt;tr&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;CisloPom&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;smallint&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Ne&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Číslo pracovního poměru.&amp;lt;/td&amp;gt;&lt;br /&gt;
    &amp;lt;/tr&amp;gt;&lt;br /&gt;
    &amp;lt;tr&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Kod&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;char(10)&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Ano&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Docházkový kód externího systému.&amp;lt;/td&amp;gt;&lt;br /&gt;
    &amp;lt;/tr&amp;gt;&lt;br /&gt;
    &amp;lt;tr&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Cas&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;char(17)&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Ano&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Datum a čas ve formátu yyyy-MM-dd hhmmss.&amp;lt;/td&amp;gt;&lt;br /&gt;
    &amp;lt;/tr&amp;gt;&lt;br /&gt;
    &amp;lt;tr&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;NazevZarizeni&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;char(50)&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Ne&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Název zařízení externího systému.&amp;lt;/td&amp;gt;&lt;br /&gt;
    &amp;lt;/tr&amp;gt;&lt;br /&gt;
&amp;lt;/table&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''REST'''&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
curl -X POST https://example.com/api/rest/ImportPruchodu \&lt;br /&gt;
  -H &amp;quot;Content-Type: text/plain&amp;quot; \&lt;br /&gt;
  -d '{&lt;br /&gt;
    &amp;quot;IdZaznamu&amp;quot;: 123,&lt;br /&gt;
    &amp;quot;OsCislo&amp;quot;: 4567890123,&lt;br /&gt;
    &amp;quot;CisloPom&amp;quot;: 1,&lt;br /&gt;
    &amp;quot;Kod&amp;quot;: &amp;quot;ABC123&amp;quot;,&lt;br /&gt;
    &amp;quot;Cas&amp;quot;: &amp;quot;2025-03-11 105844&amp;quot;,&lt;br /&gt;
    &amp;quot;NazevZarizeni&amp;quot;: &amp;quot;Externí zařízení&amp;quot;&lt;br /&gt;
  }'&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Příručka KS portál]]&lt;br /&gt;
* [[Rozšíření aplikace]]&lt;br /&gt;
* &amp;lt;small&amp;gt;hd 51867&amp;lt;/small&amp;gt;&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Import_pr%C5%AFchod%C5%AF&amp;diff=47964</id>
		<title>Import průchodů</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Import_pr%C5%AFchod%C5%AF&amp;diff=47964"/>
		<updated>2025-03-11T10:12:21Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;''Import průchodů'' je [[Rozšíření aplikace]] &amp;lt;small&amp;gt;([[KS docházka (Rozšíření aplikace)]])&amp;lt;/small&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
'''Dva způsoby importu průchodů'''&lt;br /&gt;
&amp;lt;ul&amp;gt;&lt;br /&gt;
    &amp;lt;li&amp;gt;&lt;br /&gt;
        Přes webovou službu pro import dat pro [[KS docházka|KS docházku]]. Dokumentace je součástí webové služby.&lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            Protokol SOAP. &lt;br /&gt;
        &amp;lt;/ol&amp;gt;         &lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            Rozšíření &amp;quot;Import průchodů&amp;quot;&lt;br /&gt;
        &amp;lt;/ol&amp;gt;    &lt;br /&gt;
    &amp;lt;/li&amp;gt;&lt;br /&gt;
    &amp;lt;li&amp;gt;&lt;br /&gt;
        Přes aplikační server. &lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            Protokol SOAP/REST. &lt;br /&gt;
        &amp;lt;/ol&amp;gt;         &lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            Rozšíření &amp;quot;Import průchodů SOAP/REST - Nová&amp;quot;&lt;br /&gt;
        &amp;lt;/ol&amp;gt;        &lt;br /&gt;
    &amp;lt;/li&amp;gt;&lt;br /&gt;
&amp;lt;/ul&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;i&amp;gt;&lt;br /&gt;
S touto funkcí je možné importovat data z docházkových nebo přístupových systémů třetích stran do modulu Docházka v aplikaci KS portál.&lt;br /&gt;
&lt;br /&gt;
Lze využít v případě, že jsou k dispozici informace o průchodech zaměstnanců přes nějaký terminál nebo turniket a k takto získaným datům nelze přistupovat z plnohodnotného docházkového systému. Pokud tedy nelze data pro mzdy připravit jinak, je možné je naimportovat do modulu Docházka v aplikaci KS portál, kde s nimi lze pracovat jako s běžným docházkovým systémem.&lt;br /&gt;
&amp;lt;/i&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h2&amp;gt;Import průchodů přes webovou službu&amp;lt;/h2&amp;gt;&lt;br /&gt;
&amp;lt;h3&amp;gt;Nastavení&amp;lt;/h3&amp;gt;&lt;br /&gt;
* Aktivace rozšíření.&lt;br /&gt;
* Následně je potřeba do web.cofigu do appsettings doplnit klíč '''''WsAuthKey''''', jako hodnotu zadejte dostatečně dlouhý bezpečný řetězec. Tato hodnota musí být předávána v autentizační SOAP hlavičce s názvem '''''AuthKeyHeader''''', a to při každém požadavku o zápis průchodu.&lt;br /&gt;
* Pokud bude aktivní rozšíření, popis služby lze získat přes odkaz v KS portále&lt;br /&gt;
 [rootKSportalu]/webservices/dchpruchody.asmx?op=PruchodVloz&lt;br /&gt;
* V struktuře předávaných dat jsou důležité následující položky&lt;br /&gt;
: ''OsCislo'' - Osobní číslo zaměstnance&lt;br /&gt;
: ''Kod'' - Kód dopovídající číselníku docházkových kódů&lt;br /&gt;
: ''Cas'' - DateTime&lt;br /&gt;
* Pokud při zápisu dojde k chybě tak ta je vrácena s kódem a popisem chyby (popis dále).&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h4&amp;gt;SOAP 1.1&amp;lt;/h4&amp;gt;&lt;br /&gt;
Následuje ukázkový požadavek a odpověď SOAP 1.1. Uvedené zástupce je třeba nahradit skutečnými hodnotami.&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
 POST /ksportal/webservices/dchpruchody.asmx HTTP/1.1&lt;br /&gt;
 Host: localhost&lt;br /&gt;
 Content-Type: text/xml; charset=utf-8&lt;br /&gt;
 Content-Length: length&lt;br /&gt;
 SOAPAction: &amp;quot;ksprtl/WebServices/PruchodVloz&amp;quot;&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;br /&gt;
 &amp;lt;soap:Envelope xmlns:xsi=&amp;quot;http://www.w3.org/2001/XMLSchema-instance&amp;quot; xmlns:xsd=&amp;quot;http://www.w3.org/2001/XMLSchema&amp;quot; xmlns:soap=&amp;quot;http://schemas.xmlsoap.org /soap/envelope/&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;soap:Header&amp;gt;&lt;br /&gt;
    &amp;lt;AuthKeyHeader xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;AuthKey&amp;gt;string&amp;lt;/AuthKey&amp;gt;&lt;br /&gt;
    &amp;lt;/AuthKeyHeader&amp;gt;&lt;br /&gt;
  &amp;lt;/soap:Header&amp;gt;&lt;br /&gt;
  &amp;lt;soap:Body&amp;gt;&lt;br /&gt;
    &amp;lt;PruchodVloz xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;pr&amp;gt;&lt;br /&gt;
        &amp;lt;OsCislo&amp;gt;decimal&amp;lt;/OsCislo&amp;gt;&lt;br /&gt;
        &amp;lt;CisloPom&amp;gt;short&amp;lt;/CisloPom&amp;gt;&lt;br /&gt;
        &amp;lt;Kod&amp;gt;int&amp;lt;/Kod&amp;gt;&lt;br /&gt;
        &amp;lt;Prac_str&amp;gt;string&amp;lt;/Prac_str&amp;gt;&lt;br /&gt;
        &amp;lt;Cas&amp;gt;dateTime&amp;lt;/Cas&amp;gt;&lt;br /&gt;
        &amp;lt;Doba&amp;gt;string&amp;lt;/Doba&amp;gt;&lt;br /&gt;
        &amp;lt;Kodprst&amp;gt;string&amp;lt;/Kodprst&amp;gt;&lt;br /&gt;
        &amp;lt;Sazba&amp;gt;decimal&amp;lt;/Sazba&amp;gt;&lt;br /&gt;
        &amp;lt;Castka&amp;gt;decimal&amp;lt;/Castka&amp;gt;&lt;br /&gt;
        &amp;lt;C_pole1&amp;gt;string&amp;lt;/C_pole1&amp;gt;&lt;br /&gt;
        &amp;lt;C_pole2&amp;gt;string&amp;lt;/C_pole2&amp;gt;&lt;br /&gt;
        &amp;lt;N_pole1&amp;gt;long&amp;lt;/N_pole1&amp;gt;&lt;br /&gt;
        &amp;lt;N_pole2&amp;gt;long&amp;lt;/N_pole2&amp;gt;&lt;br /&gt;
        &amp;lt;Poznamka&amp;gt;string&amp;lt;/Poznamka&amp;gt;&lt;br /&gt;
      &amp;lt;/pr&amp;gt;&lt;br /&gt;
    &amp;lt;/PruchodVloz&amp;gt;&lt;br /&gt;
  &amp;lt;/soap:Body&amp;gt;&lt;br /&gt;
 &amp;lt;/soap:Envelope&amp;gt;&lt;br /&gt;
 HTTP/1.1 200 OK&lt;br /&gt;
 Content-Type: text/xml; charset=utf-8&lt;br /&gt;
 Content-Length: length&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;br /&gt;
 &amp;lt;soap:Envelope xmlns:xsi=&amp;quot;http://www.w3.org/2001/XMLSchema-instance&amp;quot; xmlns:xsd=&amp;quot;http://www.w3.org/2001/XMLSchema&amp;quot; xmlns:soap=&amp;quot;http://schemas.xmlsoap.org /soap/envelope/&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;soap:Body&amp;gt;&lt;br /&gt;
    &amp;lt;PruchodVlozResponse xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;PruchodVlozResult&amp;gt;&lt;br /&gt;
        &amp;lt;ErrorCode&amp;gt;int&amp;lt;/ErrorCode&amp;gt;&lt;br /&gt;
        &amp;lt;ErrorString&amp;gt;string&amp;lt;/ErrorString&amp;gt;&lt;br /&gt;
      &amp;lt;/PruchodVlozResult&amp;gt;&lt;br /&gt;
    &amp;lt;/PruchodVlozResponse&amp;gt;&lt;br /&gt;
  &amp;lt;/soap:Body&amp;gt;&lt;br /&gt;
 &amp;lt;/soap:Envelope&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h4&amp;gt;SOAP 1.2&amp;lt;/h4&amp;gt;&lt;br /&gt;
Následuje ukázkový požadavek a odpověď SOAP 1.2. Uvedené zástupce je třeba nahradit skutečnými hodnotami.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
 POST /ksportal/webservices/dchpruchody.asmx HTTP/1.1&lt;br /&gt;
 Host: localhost&lt;br /&gt;
 Content-Type: application/soap+xml; charset=utf-8&lt;br /&gt;
 Content-Length: length&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;br /&gt;
 &amp;lt;soap12:Envelope xmlns:xsi=&amp;quot;http://www.w3.org/2001/XMLSchema-instance&amp;quot; xmlns:xsd=&amp;quot;http://www.w3.org/2001/XMLSchema&amp;quot; xmlns:soap12=&amp;quot;http://www.w3.org/2003/05/soap- envelope&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;soap12:Header&amp;gt;&lt;br /&gt;
    &amp;lt;AuthKeyHeader xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;AuthKey&amp;gt;string&amp;lt;/AuthKey&amp;gt;&lt;br /&gt;
    &amp;lt;/AuthKeyHeader&amp;gt;&lt;br /&gt;
  &amp;lt;/soap12:Header&amp;gt;&lt;br /&gt;
  &amp;lt;soap12:Body&amp;gt;&lt;br /&gt;
    &amp;lt;PruchodVloz xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;pr&amp;gt;&lt;br /&gt;
        &amp;lt;OsCislo&amp;gt;decimal&amp;lt;/OsCislo&amp;gt;&lt;br /&gt;
        &amp;lt;CisloPom&amp;gt;short&amp;lt;/CisloPom&amp;gt;&lt;br /&gt;
        &amp;lt;Kod&amp;gt;int&amp;lt;/Kod&amp;gt;&lt;br /&gt;
        &amp;lt;Prac_str&amp;gt;string&amp;lt;/Prac_str&amp;gt;&lt;br /&gt;
        &amp;lt;Cas&amp;gt;dateTime&amp;lt;/Cas&amp;gt;&lt;br /&gt;
        &amp;lt;Doba&amp;gt;string&amp;lt;/Doba&amp;gt;&lt;br /&gt;
        &amp;lt;Kodprst&amp;gt;string&amp;lt;/Kodprst&amp;gt;&lt;br /&gt;
        &amp;lt;Sazba&amp;gt;decimal&amp;lt;/Sazba&amp;gt;&lt;br /&gt;
        &amp;lt;Castka&amp;gt;decimal&amp;lt;/Castka&amp;gt;&lt;br /&gt;
        &amp;lt;C_pole1&amp;gt;string&amp;lt;/C_pole1&amp;gt;&lt;br /&gt;
        &amp;lt;C_pole2&amp;gt;string&amp;lt;/C_pole2&amp;gt;&lt;br /&gt;
        &amp;lt;N_pole1&amp;gt;long&amp;lt;/N_pole1&amp;gt;&lt;br /&gt;
        &amp;lt;N_pole2&amp;gt;long&amp;lt;/N_pole2&amp;gt;&lt;br /&gt;
        &amp;lt;Poznamka&amp;gt;string&amp;lt;/Poznamka&amp;gt;&lt;br /&gt;
      &amp;lt;/pr&amp;gt;&lt;br /&gt;
    &amp;lt;/PruchodVloz&amp;gt;&lt;br /&gt;
  &amp;lt;/soap12:Body&amp;gt;&lt;br /&gt;
 &amp;lt;/soap12:Envelope&amp;gt;&lt;br /&gt;
 HTTP/1.1 200 OK&lt;br /&gt;
 Content-Type: application/soap+xml; charset=utf-8&lt;br /&gt;
 Content-Length: length&lt;br /&gt;
 &lt;br /&gt;
 &amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;br /&gt;
 &amp;lt;soap12:Envelope xmlns:xsi=&amp;quot;http://www.w3.org/2001/XMLSchema-instance&amp;quot; xmlns:xsd=&amp;quot;http://www.w3.org/2001/XMLSchema&amp;quot; xmlns:soap12=&amp;quot;http://www.w3.org/2003/05/soap-envelope&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;soap12:Body&amp;gt;&lt;br /&gt;
    &amp;lt;PruchodVlozResponse xmlns=&amp;quot;ksprtl/WebServices&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;PruchodVlozResult&amp;gt;&lt;br /&gt;
        &amp;lt;ErrorCode&amp;gt;int&amp;lt;/ErrorCode&amp;gt;&lt;br /&gt;
        &amp;lt;ErrorString&amp;gt;string&amp;lt;/ErrorString&amp;gt;&lt;br /&gt;
      &amp;lt;/PruchodVlozResult&amp;gt;&lt;br /&gt;
    &amp;lt;/PruchodVlozResponse&amp;gt;&lt;br /&gt;
  &amp;lt;/soap12:Body&amp;gt;&lt;br /&gt;
 &amp;lt;/soap12:Envelope&amp;gt;&lt;br /&gt;
 &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h2&amp;gt;Import průchodů přes aplikační server&amp;lt;/h2&amp;gt;&lt;br /&gt;
Umožňuje synchronizovat data prostřednictvím KSweb API (SOAP/REST) uložená v aplikaci KS mzdý PROFI z evidence zaměstnanců, pracovních poměrů a číselníku středisek do libovolných připojených terminálů. Dále se pak data z průchodových terminálů přenáší zpět do modulu Docházka v aplikaci KS portál.&lt;br /&gt;
&lt;br /&gt;
POZOR: Tato funkcionalita vyžaduje nainstalovanou a spuštěnou aplikaci server KS-AS. Před aktivací této funkcionality ověřte, že aplikace server je funkční. Pokud aplikace není nainstalována nebo nefunguje správně, stáhněte si nejnovější instalační balíček instalátor utility (MapSetup.exe) a nainstalujte jej na stejný server jako je instalována aplikace KS mzdý PROFI nebo jej stáhněte z ftp://ftp.ksprogram.cz/download/&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h3&amp;gt;Položky&amp;lt;/h3&amp;gt;&lt;br /&gt;
&amp;lt;table border=&amp;quot;1&amp;quot;&amp;gt;&lt;br /&gt;
    &amp;lt;tr&amp;gt;&lt;br /&gt;
      &amp;lt;th&amp;gt;Údaj&amp;lt;/th&amp;gt;&lt;br /&gt;
      &amp;lt;th&amp;gt;Datový typ&amp;lt;/th&amp;gt;&lt;br /&gt;
      &amp;lt;th&amp;gt;Povinné pole&amp;lt;/th&amp;gt;&lt;br /&gt;
      &amp;lt;th&amp;gt;Význam&amp;lt;/th&amp;gt;&lt;br /&gt;
    &amp;lt;/tr&amp;gt;&lt;br /&gt;
    &amp;lt;tr&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;IdZaznamu&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;integer&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Ne&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Jednoznačná identifikace záznamu v externím systému.&amp;lt;/td&amp;gt;&lt;br /&gt;
    &amp;lt;/tr&amp;gt;&lt;br /&gt;
    &amp;lt;tr&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;OsCislo&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;decimal(10,0)&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Ano&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Osobní číslo zaměstnance.&amp;lt;/td&amp;gt;&lt;br /&gt;
    &amp;lt;/tr&amp;gt;&lt;br /&gt;
    &amp;lt;tr&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;CisloPom&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;smallint&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Ne&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Číslo pracovního poměru.&amp;lt;/td&amp;gt;&lt;br /&gt;
    &amp;lt;/tr&amp;gt;&lt;br /&gt;
    &amp;lt;tr&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Kod&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;char(10)&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Ano&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Docházkový kód externího systému.&amp;lt;/td&amp;gt;&lt;br /&gt;
    &amp;lt;/tr&amp;gt;&lt;br /&gt;
    &amp;lt;tr&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Cas&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;char(17)&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Ano&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Datum a čas ve formátu yyyy-MM-dd hhmmss.&amp;lt;/td&amp;gt;&lt;br /&gt;
    &amp;lt;/tr&amp;gt;&lt;br /&gt;
    &amp;lt;tr&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;NazevZarizeni&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;char(50)&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Ne&amp;lt;/td&amp;gt;&lt;br /&gt;
      &amp;lt;td&amp;gt;Název zařízení externího systému.&amp;lt;/td&amp;gt;&lt;br /&gt;
    &amp;lt;/tr&amp;gt;&lt;br /&gt;
&amp;lt;/table&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''REST'''&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
curl -X POST https://example.com/api/rest/ImportPruchodu \&lt;br /&gt;
  -H &amp;quot;Content-Type: text/plain&amp;quot; \&lt;br /&gt;
  -d '{&lt;br /&gt;
    &amp;quot;IdZaznamu&amp;quot;: 123,&lt;br /&gt;
    &amp;quot;OsCislo&amp;quot;: 4567890123,&lt;br /&gt;
    &amp;quot;CisloPom&amp;quot;: 1,&lt;br /&gt;
    &amp;quot;Kod&amp;quot;: &amp;quot;ABC123&amp;quot;,&lt;br /&gt;
    &amp;quot;Cas&amp;quot;: &amp;quot;2025-03-11 105844&amp;quot;,&lt;br /&gt;
    &amp;quot;NazevZarizeni&amp;quot;: &amp;quot;Externí zařízení&amp;quot;&lt;br /&gt;
  }'&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Příručka KS portál]]&lt;br /&gt;
* [[Rozšíření aplikace]]&lt;br /&gt;
* &amp;lt;small&amp;gt;hd 51867&amp;lt;/small&amp;gt;&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Protokol_REST_(KS_webAPI)&amp;diff=47963</id>
		<title>Protokol REST (KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Protokol_REST_(KS_webAPI)&amp;diff=47963"/>
		<updated>2025-03-10T12:15:20Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;        &amp;lt;h2&amp;gt;Základní informace&amp;lt;/h2&amp;gt;&lt;br /&gt;
Komplexní API pro správu dat souhrnů údajů, zaměstnanců a autentizaci uživatelů.&lt;br /&gt;
Umožňuje vkládání, aktualizaci, výběr a mazání dat v různých souhrnech údajů na základě&lt;br /&gt;
specifikovaných kritérií a operací prováděných prostřednictvím HTTP metod.&lt;br /&gt;
        &amp;lt;!-- AUTENTIZACE --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;access&amp;quot;&amp;gt;Autentizace&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Zabezpečení protokolu&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Všechny dotazy na API musí být zasílány prostřednictvím zabezpečeného protokolu HTTPS.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Přístupová oprávnění&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;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.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Autentizace&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Pro autentizaci je třeba odeslat na adresu &amp;lt;i&amp;gt;.../KSAsServer/WebService/WebAPI/rest/users/authenticate&amp;lt;/i&amp;gt; JSON body s údaji &amp;lt;i&amp;gt;&amp;quot;Username&amp;quot;&amp;lt;/i&amp;gt; a &amp;lt;i&amp;gt;&amp;quot;Password&amp;quot;&amp;lt;/i&amp;gt;. Pokud jsou tyto údaje správné, obdržíte &amp;lt;b&amp;gt;token&amp;lt;/b&amp;gt;, který je nutný pro používání API po určitou dobu. Token i jeho platnost jsou vráceny v těle odpovědi.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Použití tokenu&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Při každém volání API ,mimo autentizaci, je třeba zaslat platný token jedním ze dvou způsobů:&amp;lt;/p&amp;gt;&lt;br /&gt;
               &lt;br /&gt;
                &amp;lt;ul class=&amp;quot;ulAktualizace&amp;quot;&amp;gt;&lt;br /&gt;
                    &amp;lt;li&amp;gt;&lt;br /&gt;
                        V HEADER&lt;br /&gt;
                        &amp;lt;p&amp;gt;&lt;br /&gt;
                            Plain:  &amp;lt;pre&amp;gt;Authorization -   eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
                            Bearer: &amp;lt;pre&amp;gt;Authorization -   Bearer eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
                        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
                    &amp;lt;/li&amp;gt;&lt;br /&gt;
                   &amp;lt;li&amp;gt;&lt;br /&gt;
                       V URI&lt;br /&gt;
                          &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/Jmeno/Karel?token=eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
                   &amp;lt;/li&amp;gt;&lt;br /&gt;
                &amp;lt;/ul&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Způsob HEADER je preferován před URI.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ol&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
POST /KSAsServer/WebService/WebAPI/rest/user/authenticate&lt;br /&gt;
&lt;br /&gt;
body:&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Username&amp;quot;: &amp;quot;jmeno&amp;quot;,&lt;br /&gt;
    &amp;quot;Password&amp;quot;: &amp;quot;heslo&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
        &amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Created&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720705997339+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: 201,&lt;br /&gt;
    &amp;quot;Token&amp;quot;: &amp;quot;jkdsjflsdfjsdfklsjdflskdfjs.6tQew&amp;quot;,&lt;br /&gt;
    &amp;quot;ValidTo&amp;quot;: &amp;quot;/Date(1720715997000+0200)/&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;!-- METODY --&amp;gt;&lt;br /&gt;
        &amp;lt;h1 id=&amp;quot;methods&amp;quot;&amp;gt;Metody&amp;lt;/h1&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Veškerá dokumentakce k metodám: [[Metody (KS webAPI)|Metody]].&amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- PARAMTERY --&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Parametry&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;ul&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Request header&amp;lt;/b&amp;gt;&lt;br /&gt;
&amp;lt;p&amp;gt;Content-Type -   application/raw&amp;lt;/p&amp;gt;&lt;br /&gt;
&amp;lt;p&amp;gt;Accept -         application/json&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Items&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;&lt;br /&gt;
                    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í.&lt;br /&gt;
                    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&lt;br /&gt;
                    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&lt;br /&gt;
                    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í.&lt;br /&gt;
                &amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;[[JsonSearchCriteria]]&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;[[JsonOptions]]&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;Token&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ul&amp;gt;&lt;br /&gt;
        &amp;lt;!-- CESTY --&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Proměnné cesty&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;ul&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;ItemGroup&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;&lt;br /&gt;
                    (Required)&lt;br /&gt;
                    Název souhrnu údajů. Parametr {ItemGroup} je nutno zaměnit za reálný souhrn údajů.&lt;br /&gt;
                    Předává se název skupiny údajů (entity) v KS mzdy (např. 'KmenoveUdaje').&lt;br /&gt;
                &amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ul&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
GET /KSAsServer/WebService/WebAPI/rest/{ItemGroup]/{Item}?token=12asd16a5sda1s32d&amp;amp;Items=Jmeno,Prijmeni,OsCislo,RodneCislo&amp;amp;JsonSearchCriteria=[{ 'Item': 'OsCislo', 'Operator': '&amp;lt;=', 'Value': 100 }]&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-SOUHRN METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-method&amp;quot;&amp;gt;GET - Vrací data souhrnu údajů podle zadaného názvu souhrnu.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde OsCislo &amp;lt;= 100.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/?token=12asd16a5sda1s32d&amp;amp;Items=Jmeno,Prijmeni,OsCislo,RodneCislo&amp;amp;JsonSearchCriteria=[{ 'Item': 'OsCislo', 'Operator': '&amp;lt;=', 'Value': 100 }]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:36,\&amp;quot;Titul\&amp;quot;:null,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Miroslav\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Nový\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;123456789\&amp;quot;...}],&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720696754982+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-ZAMĚSTNANEC METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-zamestnanec&amp;quot;&amp;gt;GET - Vyhledá zaměstnance ze skupiny údajů 'KmenoveUdaje' podle zadaného osobního čísla.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, aOsCislo.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde OsCislo = 1. Vrátí sloupce OsCislo, Titul, Jmeno, Primeni, RodneCislo&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/1?token=eyJ0eXAiOIiwi7_GcdkwUuTTLDL4&amp;amp;Items=OsCislo, Titul, Jmeno, Prijmeni, RodneCislo&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:1,\&amp;quot;Titul\&amp;quot;:\&amp;quot;Ing.\&amp;quot;,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Hovorka\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;581227411\&amp;quot;}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720766282434+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-ITEM METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-item&amp;quot;&amp;gt;GET - Vrací data, kde údaj 'Item' má hodnotu 'Value' v rámci zadaného souhrnu údajů 'ItemGroup'.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, Item, Value.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde Jmeno = Pavel.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/Jmeno/Pavel?token=eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:1,\&amp;quot;Titul\&amp;quot;:\&amp;quot;Ing.\&amp;quot;,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Hovorka\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;581227411\&amp;quot;},&lt;br /&gt;
            {\&amp;quot;OsCislo\&amp;quot;:18,\&amp;quot;Titul\&amp;quot;:null,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;...}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720766630099+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- POST METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;post-method&amp;quot;&amp;gt;POST - Vkládá data do zadaného souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            Metoda InsertData zapisuje data do databáze KS mzdy.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, JsonChangeData (data v těle požadavku).&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vloží data z body požadavku do souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
POST /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje?token=eyJ0eXAiOiJKV1QtL2BDA7_GcdkwUuTTLDL4&amp;amp;&lt;br /&gt;
&lt;br /&gt;
Body:&lt;br /&gt;
[&lt;br /&gt;
    {&lt;br /&gt;
        &amp;quot;IdPodniku&amp;quot;: &amp;quot;1&amp;quot;,&lt;br /&gt;
        &amp;quot;Jmeno&amp;quot;: &amp;quot;Karel&amp;quot;,&lt;br /&gt;
        &amp;quot;Prijmeni&amp;quot;: &amp;quot;Nový&amp;quot;,&lt;br /&gt;
        &amp;quot;RodneCislo&amp;quot;: &amp;quot;9710085892&amp;quot;,&lt;br /&gt;
        &amp;quot;MistoNarozeni&amp;quot;: &amp;quot;Vsetín&amp;quot;,&lt;br /&gt;
        &amp;quot;StatNar&amp;quot;: &amp;quot;CZ&amp;quot;,&lt;br /&gt;
        &amp;quot;StPrisl&amp;quot;: &amp;quot;203&amp;quot;,&lt;br /&gt;
        &amp;quot;RodinStav&amp;quot;: &amp;quot;2&amp;quot;,&lt;br /&gt;
        &amp;quot;TrCislo&amp;quot;: &amp;quot;100&amp;quot;,&lt;br /&gt;
        &amp;quot;PscTrv&amp;quot;: &amp;quot;75501&amp;quot;,&lt;br /&gt;
        &amp;quot;MistoTrv&amp;quot;: &amp;quot;Vsetín&amp;quot;,&lt;br /&gt;
        &amp;quot;KmenStr&amp;quot;: &amp;quot;1&amp;quot;,&lt;br /&gt;
        &amp;quot;DatumNastupu&amp;quot;: &amp;quot;2019-01-01&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;: 95967,\&amp;quot;IdPodniku\&amp;quot;: 1,\&amp;quot;Jmeno\&amp;quot;: \&amp;quot;Karel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;: \&amp;quot;Nový\&amp;quot;&amp;quot;...}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla vložena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720767043837+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;201&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- PUT METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;put-method&amp;quot;&amp;gt;PUT / UPDATE - Aktualizuje data do zadaného souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, JsonChangeData (data v těle požadavku), JsonSearchCriteria.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Aktualizuje data v souhrnu údajů &amp;quot;Kontakty&amp;quot;, kde Hodnota = 222 222 222, na Hodnota = 111 111 111. &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
PUT /KSAsServer/WebService/WebAPI/rest/Kontakty?token=eyJ0eXAiOiJKV1QiLaW_GcdkwUuTTLDL4&amp;amp;JsonSearchCriteria=[{ &amp;quot;Item&amp;quot;: &amp;quot;Hodnota&amp;quot;, &amp;quot;Operator&amp;quot;: &amp;quot;=&amp;quot;, &amp;quot;Value&amp;quot;: &amp;quot;222 222 222&amp;quot;}]&lt;br /&gt;
&lt;br /&gt;
Body:&lt;br /&gt;
[&lt;br /&gt;
    {&lt;br /&gt;
        &amp;quot;Hodnota&amp;quot;: &amp;quot;111 111 111&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla aktualizována.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1721030337638+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;204&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- DELETE METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;delete-method&amp;quot;&amp;gt;DELETE - Smaže data v zadaném souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            Metoda DELETE smaže data v databázi KS mzdy.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, JsonSearchCriteria.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Smaže data v souhrnu údajů &amp;quot;Kontakty&amp;quot;, kde Hodnota = 111 111 111&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
DELETE KSAsServer/WebService/WebAPI/rest/Kontakty?token=eyJ0eXAiOiJKV1QiLCk&amp;amp;JsonSearchCriteria=[{ &amp;quot;Item&amp;quot;: &amp;quot;Hodnota&amp;quot;, &amp;quot;Operator&amp;quot;: &amp;quot;=&amp;quot;, &amp;quot;Value&amp;quot;: &amp;quot;111 111 111&amp;quot;}]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla smazána.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1721030823993+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;204&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
    &amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Protokoly (KS webAPI)|Protokoly]]&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Protokol_REST_(KS_webAPI)&amp;diff=47962</id>
		<title>Protokol REST (KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Protokol_REST_(KS_webAPI)&amp;diff=47962"/>
		<updated>2025-03-10T12:05:54Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: /* Odkazy */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;        &amp;lt;h2&amp;gt;Základní informace&amp;lt;/h2&amp;gt;&lt;br /&gt;
Komplexní API pro správu dat souhrnů údajů, zaměstnanců a autentizaci uživatelů.&lt;br /&gt;
Umožňuje vkládání, aktualizaci, výběr a mazání dat v různých souhrnech údajů na základě&lt;br /&gt;
specifikovaných kritérií a operací prováděných prostřednictvím HTTP metod.&lt;br /&gt;
        &amp;lt;!-- AUTENTIZACE --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;access&amp;quot;&amp;gt;Autentizace&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Zabezpečení protokolu&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Všechny dotazy na API musí být zasílány prostřednictvím zabezpečeného protokolu HTTPS.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Přístupová oprávnění&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;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.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Autentizace&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Pro autentizaci je třeba odeslat na adresu &amp;lt;i&amp;gt;.../KSAsServer/WebService/WebAPI/rest/users/authenticate&amp;lt;/i&amp;gt; JSON body s údaji &amp;lt;i&amp;gt;&amp;quot;Username&amp;quot;&amp;lt;/i&amp;gt; a &amp;lt;i&amp;gt;&amp;quot;Password&amp;quot;&amp;lt;/i&amp;gt;. Pokud jsou tyto údaje správné, obdržíte &amp;lt;strong&amp;gt;token&amp;lt;/strong&amp;gt;, který je nutný pro používání API po určitou dobu. Token i jeho platnost jsou vráceny v těle odpovědi.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Použití tokenu&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Při každém volání API ,mimo autentizaci, je třeba zaslat platný token jedním ze dvou způsobů:&amp;lt;/p&amp;gt;&lt;br /&gt;
               &lt;br /&gt;
                &amp;lt;ul class=&amp;quot;ulAktualizace&amp;quot;&amp;gt;&lt;br /&gt;
                    &amp;lt;li&amp;gt;&lt;br /&gt;
                        V HEADER&lt;br /&gt;
                        &amp;lt;p&amp;gt;&lt;br /&gt;
                            Plain:  &amp;lt;pre&amp;gt;Authorization -   eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
                            Bearer: &amp;lt;pre&amp;gt;Authorization -   Bearer eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
                        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
                    &amp;lt;/li&amp;gt;&lt;br /&gt;
                   &amp;lt;li&amp;gt;&lt;br /&gt;
                       V URI&lt;br /&gt;
                          &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/Jmeno/Karel?token=eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
                   &amp;lt;/li&amp;gt;&lt;br /&gt;
                &amp;lt;/ul&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Způsob HEADER je preferován před URI.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ol&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
POST /KSAsServer/WebService/WebAPI/rest/user/authenticate&lt;br /&gt;
&lt;br /&gt;
body:&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Username&amp;quot;: &amp;quot;jmeno&amp;quot;,&lt;br /&gt;
    &amp;quot;Password&amp;quot;: &amp;quot;heslo&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
        &amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Created&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720705997339+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: 201,&lt;br /&gt;
    &amp;quot;Token&amp;quot;: &amp;quot;jkdsjflsdfjsdfklsjdflskdfjs.6tQew&amp;quot;,&lt;br /&gt;
    &amp;quot;ValidTo&amp;quot;: &amp;quot;/Date(1720715997000+0200)/&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;!-- METODY --&amp;gt;&lt;br /&gt;
        &amp;lt;h1 id=&amp;quot;methods&amp;quot;&amp;gt;Metody&amp;lt;/h1&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Veškerá dokumentakce k metodám: [[Metody (KS webAPI)|Metody]].&amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- PARAMTERY --&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Parametry&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;ul&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Request header&amp;lt;/b&amp;gt;&lt;br /&gt;
&amp;lt;p&amp;gt;Content-Type -   application/raw&amp;lt;/p&amp;gt;&lt;br /&gt;
&amp;lt;p&amp;gt;Accept -         application/json&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Items&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;&lt;br /&gt;
                    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í.&lt;br /&gt;
                    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&lt;br /&gt;
                    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&lt;br /&gt;
                    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í.&lt;br /&gt;
                &amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;[[JsonSearchCriteria]]&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;[[JsonOptions]]&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;Token&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ul&amp;gt;&lt;br /&gt;
        &amp;lt;!-- CESTY --&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Proměnné cesty&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;ul&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;ItemGroup&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;&lt;br /&gt;
                    (Required)&lt;br /&gt;
                    Název souhrnu údajů. Parametr {ItemGroup} je nutno zaměnit za reálný souhrn údajů.&lt;br /&gt;
                    Předává se název skupiny údajů (entity) v KS mzdy (např. 'KmenoveUdaje').&lt;br /&gt;
                &amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ul&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
GET /KSAsServer/WebService/WebAPI/rest/{ItemGroup]/{Item}?token=12asd16a5sda1s32d&amp;amp;Items=Jmeno,Prijmeni,OsCislo,RodneCislo&amp;amp;JsonSearchCriteria=[{ 'Item': 'OsCislo', 'Operator': '&amp;lt;=', 'Value': 100 }]&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-SOUHRN METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-method&amp;quot;&amp;gt;GET - Vrací data souhrnu údajů podle zadaného názvu souhrnu.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde OsCislo &amp;lt;= 100.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/?token=12asd16a5sda1s32d&amp;amp;Items=Jmeno,Prijmeni,OsCislo,RodneCislo&amp;amp;JsonSearchCriteria=[{ 'Item': 'OsCislo', 'Operator': '&amp;lt;=', 'Value': 100 }]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:36,\&amp;quot;Titul\&amp;quot;:null,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Miroslav\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Nový\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;123456789\&amp;quot;...}],&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720696754982+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-ZAMĚSTNANEC METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-zamestnanec&amp;quot;&amp;gt;GET - Vyhledá zaměstnance ze skupiny údajů 'KmenoveUdaje' podle zadaného osobního čísla.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, aOsCislo.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde OsCislo = 1. Vrátí sloupce OsCislo, Titul, Jmeno, Primeni, RodneCislo&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/1?token=eyJ0eXAiOIiwi7_GcdkwUuTTLDL4&amp;amp;items=OsCislo, Titul, Jmeno, Prijmeni, RodneCislo&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:1,\&amp;quot;Titul\&amp;quot;:\&amp;quot;Ing.\&amp;quot;,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Hovorka\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;581227411\&amp;quot;}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720766282434+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-ITEM METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-item&amp;quot;&amp;gt;GET - Vrací data, kde údaj 'Item' má hodnotu 'Value' v rámci zadaného souhrnu údajů 'ItemGroup'.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, Item, Value.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde Jmeno = Pavel.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/Jmeno/Pavel?token=eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:1,\&amp;quot;Titul\&amp;quot;:\&amp;quot;Ing.\&amp;quot;,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Hovorka\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;581227411\&amp;quot;},&lt;br /&gt;
            {\&amp;quot;OsCislo\&amp;quot;:18,\&amp;quot;Titul\&amp;quot;:null,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;...}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720766630099+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- POST METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;post-method&amp;quot;&amp;gt;POST - Vkládá data do zadaného souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            Metoda InsertData zapisuje data do databáze KS mzdy.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, JsonChangeData (data v těle požadavku).&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vloží data z body požadavku do souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
POST /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje?token=eyJ0eXAiOiJKV1QtL2BDA7_GcdkwUuTTLDL4&amp;amp;&lt;br /&gt;
&lt;br /&gt;
Body:&lt;br /&gt;
[&lt;br /&gt;
    {&lt;br /&gt;
        &amp;quot;IdPodniku&amp;quot;: &amp;quot;1&amp;quot;,&lt;br /&gt;
        &amp;quot;Jmeno&amp;quot;: &amp;quot;Karel&amp;quot;,&lt;br /&gt;
        &amp;quot;Prijmeni&amp;quot;: &amp;quot;Nový&amp;quot;,&lt;br /&gt;
        &amp;quot;RodneCislo&amp;quot;: &amp;quot;9710085892&amp;quot;,&lt;br /&gt;
        &amp;quot;MistoNarozeni&amp;quot;: &amp;quot;Vsetín&amp;quot;,&lt;br /&gt;
        &amp;quot;StatNar&amp;quot;: &amp;quot;CZ&amp;quot;,&lt;br /&gt;
        &amp;quot;StPrisl&amp;quot;: &amp;quot;203&amp;quot;,&lt;br /&gt;
        &amp;quot;RodinStav&amp;quot;: &amp;quot;2&amp;quot;,&lt;br /&gt;
        &amp;quot;TrCislo&amp;quot;: &amp;quot;100&amp;quot;,&lt;br /&gt;
        &amp;quot;PscTrv&amp;quot;: &amp;quot;75501&amp;quot;,&lt;br /&gt;
        &amp;quot;MistoTrv&amp;quot;: &amp;quot;Vsetín&amp;quot;,&lt;br /&gt;
        &amp;quot;KmenStr&amp;quot;: &amp;quot;1&amp;quot;,&lt;br /&gt;
        &amp;quot;DatumNastupu&amp;quot;: &amp;quot;2019-01-01&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;: 95967,\&amp;quot;IdPodniku\&amp;quot;: 1,\&amp;quot;Jmeno\&amp;quot;: \&amp;quot;Karel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;: \&amp;quot;Nový\&amp;quot;&amp;quot;...}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla vložena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720767043837+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;201&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- PUT METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;put-method&amp;quot;&amp;gt;PUT / UPDATE - Aktualizuje data do zadaného souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, JsonChangeData (data v těle požadavku), JsonSearchCriteria.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Aktualizuje data v souhrnu údajů &amp;quot;Kontakty&amp;quot;, kde Hodnota = 222 222 222, na Hodnota = 111 111 111. &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
PUT /KSAsServer/WebService/WebAPI/rest/Kontakty?token=eyJ0eXAiOiJKV1QiLaW_GcdkwUuTTLDL4&amp;amp;JsonSearchCriteria=[{ &amp;quot;Item&amp;quot;: &amp;quot;Hodnota&amp;quot;, &amp;quot;Operator&amp;quot;: &amp;quot;=&amp;quot;, &amp;quot;Value&amp;quot;: &amp;quot;222 222 222&amp;quot;}]&lt;br /&gt;
&lt;br /&gt;
Body:&lt;br /&gt;
[&lt;br /&gt;
    {&lt;br /&gt;
        &amp;quot;Hodnota&amp;quot;: &amp;quot;111 111 111&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla aktualizována.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1721030337638+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;204&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- DELETE METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;delete-method&amp;quot;&amp;gt;DELETE - Smaže data v zadaném souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            Metoda DELETE smaže data v databázi KS mzdy.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, JsonSearchCriteria.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Smaže data v souhrnu údajů &amp;quot;Kontakty&amp;quot;, kde Hodnota = 111 111 111&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
DELETE KSAsServer/WebService/WebAPI/rest/Kontakty?token=eyJ0eXAiOiJKV1QiLCk&amp;amp;JsonSearchCriteria=[{ &amp;quot;Item&amp;quot;: &amp;quot;Hodnota&amp;quot;, &amp;quot;Operator&amp;quot;: &amp;quot;=&amp;quot;, &amp;quot;Value&amp;quot;: &amp;quot;111 111 111&amp;quot;}]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla smazána.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1721030823993+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;204&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
    &amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Protokoly (KS webAPI)|Protokoly]]&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Protokol_SOAP_(KS_webAPI)&amp;diff=47961</id>
		<title>Protokol SOAP (KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Protokol_SOAP_(KS_webAPI)&amp;diff=47961"/>
		<updated>2025-03-10T12:05:45Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;'''Příručka je ve výstavbě ''' – informace v této dokumentaci mohou být průběžně aktualizovány a rozšiřovány.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Protokoly (KS webAPI)|Protokoly]]&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Protokol_SOAP_(KS_webAPI)&amp;diff=47960</id>
		<title>Protokol SOAP (KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Protokol_SOAP_(KS_webAPI)&amp;diff=47960"/>
		<updated>2025-03-10T12:05:24Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;'''Příručka je ve výstavbě ''' – informace v této dokumentaci mohou být průběžně aktualizovány a rozšiřovány.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Klient (KS webAPI)]]&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Protokol_SOAP_(KS_webAPI)&amp;diff=47959</id>
		<title>Protokol SOAP (KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Protokol_SOAP_(KS_webAPI)&amp;diff=47959"/>
		<updated>2025-03-10T12:04:46Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;'''Příručka je ve výstavbě ''' – informace v této dokumentaci mohou být průběžně aktualizovány a rozšiřovány.&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Protokol_SOAP_(KS_webAPI)&amp;diff=47958</id>
		<title>Protokol SOAP (KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Protokol_SOAP_(KS_webAPI)&amp;diff=47958"/>
		<updated>2025-03-10T12:03:44Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: založena nová stránka s textem „Příručka ve výstavbě.“&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Příručka ve výstavbě.&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Protokoly_(KS_webAPI)&amp;diff=47957</id>
		<title>Protokoly (KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Protokoly_(KS_webAPI)&amp;diff=47957"/>
		<updated>2025-03-10T12:03:19Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Toto API poskytuje rozhraní pro komunikaci mezi klientskými aplikacemi a backendovým systémem. Podporuje jak &amp;lt;b&amp;gt;RESTful&amp;lt;/b&amp;gt;, tak &amp;lt;b&amp;gt;SOAP&amp;lt;/b&amp;gt; architekturu, což umožňuje flexibilní integraci dle požadavků uživatele.  &lt;br /&gt;
&lt;br /&gt;
- &amp;lt;b&amp;gt;REST API&amp;lt;/b&amp;gt; &lt;br /&gt;
využívá standardní HTTP metody (GET, POST, PUT, DELETE) a vrací odpovědi ve formátu JSON.&lt;br /&gt;
&lt;br /&gt;
- &amp;lt;b&amp;gt;SOAP API&amp;lt;/b&amp;gt;&lt;br /&gt;
komunikuje prostřednictvím XML zpráv a využívá protokol &amp;lt;b&amp;gt;SOAP 1.1 / 1.2&amp;lt;/b&amp;gt;.  &lt;br /&gt;
&lt;br /&gt;
API vyžaduje autentizaci a podporuje různé metody zabezpečení, v závislosti na konfiguraci služby.  &lt;br /&gt;
&lt;br /&gt;
Další detaily o jednotlivých metodách a jejich použití naleznete v následujících sekcích.&lt;br /&gt;
&lt;br /&gt;
* '''[[Protokol REST (KS webAPI)|Protokol REST]]'''&lt;br /&gt;
* '''[[Protokol SOAP (KS webAPI)|Protokol SOAP]]'''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Klient (KS webAPI)]]&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Konfigurace_(KS_webAPI)&amp;diff=47956</id>
		<title>Konfigurace (KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Konfigurace_(KS_webAPI)&amp;diff=47956"/>
		<updated>2025-03-10T12:01:06Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: /* Příklad */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;''Konfigurace KS webAPI'' se provádí převážně v konfiguračním souboru [[KS aplikační server]] (dále též '''AS''') &amp;lt;br&amp;gt; &lt;br /&gt;
Některá nastavení (např. Správa uživatelů) se provádí v aplikaci [[AS Seance Manager]] (dále též '''ASSM''').&lt;br /&gt;
&lt;br /&gt;
== Konfigurační soubor ==&lt;br /&gt;
&lt;br /&gt;
Konfigurace se provádí v konfiguračním souboru [[KS aplikační server]]&lt;br /&gt;
* '''''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]].&lt;br /&gt;
&lt;br /&gt;
V konfiguračním souboru se nastaví ''Endpoint'', ''Binding'', ''Behavior'', případně jiná nastavení.&lt;br /&gt;
&lt;br /&gt;
== Příklad ==&lt;br /&gt;
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 '''''&amp;lt;serviceCertificate&amp;gt;'''''&lt;br /&gt;
&lt;br /&gt;
SOAP a REST lze využívat souběžně.&lt;br /&gt;
&lt;br /&gt;
'''Vzorová konfigurace SOAP'''&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;lt;system.serviceModel&amp;gt;&lt;br /&gt;
  &amp;lt;services&amp;gt;  &lt;br /&gt;
    &amp;lt;service name=&amp;quot;KSProgram.AS.WCF.KSWebAPI&amp;quot; behaviorConfiguration=&amp;quot;KSWebAPIBehavior&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;host&amp;gt;&lt;br /&gt;
        &amp;lt;baseAddresses&amp;gt;&lt;br /&gt;
          &amp;lt;add baseAddress=&amp;quot;http://localhost:9001/KSAsServer/WebService/WebAPI&amp;quot;/&amp;gt;&lt;br /&gt;
        &amp;lt;/baseAddresses&amp;gt;&lt;br /&gt;
      &amp;lt;/host&amp;gt;&lt;br /&gt;
&lt;br /&gt;
      &amp;lt;endpoint address=&amp;quot;&amp;quot;&lt;br /&gt;
                binding=&amp;quot;wsHttpBinding&amp;quot;&lt;br /&gt;
                bindingConfiguration=&amp;quot;KSWebAPIBinding&amp;quot;&lt;br /&gt;
                contract=&amp;quot;KSProgram.AS.WCF.IKSWebAPI&amp;quot; /&amp;gt;&lt;br /&gt;
    &amp;lt;/service&amp;gt;&lt;br /&gt;
  &amp;lt;/services&amp;gt;&lt;br /&gt;
  &amp;lt;bindings&amp;gt;&lt;br /&gt;
      &amp;lt;wsHttpBinding&amp;gt;&lt;br /&gt;
        &amp;lt;binding name=&amp;quot;KSWebAPIBinding&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;security mode=&amp;quot;Message&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;message clientCredentialType=&amp;quot;UserName&amp;quot; /&amp;gt;&lt;br /&gt;
 &amp;lt;/security&amp;gt;&lt;br /&gt;
 &amp;lt;readerQuotas maxDepth=&amp;quot;2147483647&amp;quot; maxStringContentLength=&amp;quot;2147483647&amp;quot;&lt;br /&gt;
        maxArrayLength=&amp;quot;2147483647&amp;quot;   &lt;br /&gt;
        maxBytesPerRead=&amp;quot;2147483647&amp;quot; maxNameTableCharCount=&amp;quot;2147483647&amp;quot; /&amp;gt;&lt;br /&gt;
&amp;lt;/binding&amp;gt;&lt;br /&gt;
      &amp;lt;/wsHttpBinding&amp;gt;&lt;br /&gt;
    &amp;lt;/bindings&amp;gt;&lt;br /&gt;
&lt;br /&gt;
    &amp;lt;behaviors&amp;gt;&lt;br /&gt;
      &amp;lt;serviceBehaviors&amp;gt;&lt;br /&gt;
        &amp;lt;behavior name=&amp;quot;KSWebAPIBehavior&amp;quot;&amp;gt;&lt;br /&gt;
  &amp;lt;serviceMetadata httpGetEnabled=&amp;quot;true&amp;quot;/&amp;gt;&lt;br /&gt;
  &amp;lt;serviceDebug includeExceptionDetailInFaults=&amp;quot;true&amp;quot;/&amp;gt;&lt;br /&gt;
  &amp;lt;serviceCredentials&amp;gt;&lt;br /&gt;
      &amp;lt;userNameAuthentication userNamePasswordValidationMode=&amp;quot;Custom&amp;quot;  &lt;br /&gt;
             customUserNamePasswordValidatorType=&amp;quot;KSProgram.AS.WCF.PasswordValidator, WCFLib&amp;quot;/&amp;gt;&lt;br /&gt;
   &amp;lt;serviceCertificate findValue=&amp;quot;WebAPI_cert&amp;quot; storeLocation=&amp;quot;LocalMachine&amp;quot;  &lt;br /&gt;
             storeName=&amp;quot;My&amp;quot; x509FindType=&amp;quot;FindBySubjectName&amp;quot;/&amp;gt;&lt;br /&gt;
  &amp;lt;/serviceCredentials&amp;gt;&lt;br /&gt;
&amp;lt;/behavior&amp;gt;&lt;br /&gt;
      &amp;lt;/serviceBehaviors&amp;gt;&lt;br /&gt;
    &amp;lt;/behaviors&amp;gt;&lt;br /&gt;
&amp;lt;/system.serviceModel&amp;gt;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
'''Vzorová konfigurace REST'''&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;lt;system.serviceModel&amp;gt;&lt;br /&gt;
	&amp;lt;services&amp;gt;&lt;br /&gt;
		&amp;lt;service name=&amp;quot;WCFLib.KSWebAPI.RESTApi.KSWebAPIRest&amp;quot; behaviorConfiguration=&amp;quot;KSWebAPIBehaviorRest&amp;quot;&amp;gt;&lt;br /&gt;
			&amp;lt;endpoint address=&amp;quot;Rest&amp;quot; behaviorConfiguration=&amp;quot;webBehavior&amp;quot; binding=&amp;quot;webHttpBinding&amp;quot; bindingConfiguration=&amp;quot;KSWebAPIBindingRest&amp;quot; contract=&amp;quot;WCFLib.KSWebAPI.RESTApi.IKSWebAPIRest&amp;quot;/&amp;gt;&lt;br /&gt;
			&amp;lt;host&amp;gt;&lt;br /&gt;
				&amp;lt;baseAddresses&amp;gt;&lt;br /&gt;
					&amp;lt;add baseAddress=&amp;quot;https://localhost:9002/KSAsServer/WebService/WebAPI&amp;quot;/&amp;gt;&lt;br /&gt;
				&amp;lt;/baseAddresses&amp;gt;&lt;br /&gt;
			&amp;lt;/host&amp;gt;&lt;br /&gt;
		&amp;lt;/service&amp;gt;&lt;br /&gt;
	&amp;lt;/services&amp;gt;&lt;br /&gt;
	&amp;lt;bindings&amp;gt;&lt;br /&gt;
		&amp;lt;webHttpBinding&amp;gt;&lt;br /&gt;
			&amp;lt;binding name=&amp;quot;KSWebAPIBindingRest&amp;quot; maxBufferPoolSize=&amp;quot;2147483647&amp;quot; maxReceivedMessageSize=&amp;quot;2147483647&amp;quot; maxBufferSize=&amp;quot;2147483647&amp;quot; sendTimeout=&amp;quot;00:10:00&amp;quot; receiveTimeout=&amp;quot;00:10:00&amp;quot; crossDomainScriptAccessEnabled=&amp;quot;false&amp;quot;&amp;gt;&lt;br /&gt;
				&amp;lt;readerQuotas maxDepth=&amp;quot;2147483647&amp;quot; maxStringContentLength=&amp;quot;2147483647&amp;quot; maxArrayLength=&amp;quot;2147483647&amp;quot; maxBytesPerRead=&amp;quot;2147483647&amp;quot;/&amp;gt;&lt;br /&gt;
				&amp;lt;security mode=&amp;quot;Transport&amp;quot;&amp;gt;&lt;br /&gt;
				&amp;lt;/security&amp;gt;&lt;br /&gt;
			&amp;lt;/binding&amp;gt;&lt;br /&gt;
		&amp;lt;/webHttpBinding&amp;gt;&lt;br /&gt;
	&amp;lt;/bindings&amp;gt;&lt;br /&gt;
	&amp;lt;behaviors&amp;gt;&lt;br /&gt;
		&amp;lt;serviceBehaviors&amp;gt;&lt;br /&gt;
			&amp;lt;behavior name=&amp;quot;KSWebAPIBehaviorRest&amp;quot;&amp;gt;&lt;br /&gt;
				&amp;lt;serviceMetadata httpGetEnabled=&amp;quot;false&amp;quot; httpsGetEnabled=&amp;quot;true&amp;quot;/&amp;gt;&lt;br /&gt;
				&amp;lt;serviceDebug includeExceptionDetailInFaults=&amp;quot;true&amp;quot;/&amp;gt;&lt;br /&gt;
				&amp;lt;serviceCredentials&amp;gt;&lt;br /&gt;
					&amp;lt;serviceCertificate findValue=&amp;quot;4564qwe23gdf8gd32f4fhf6f12s3a1sd&amp;quot; storeLocation=&amp;quot;LocalMachine&amp;quot; storeName=&amp;quot;My&amp;quot; x509FindType=&amp;quot;FindBySerialNumber&amp;quot;/&amp;gt;&lt;br /&gt;
				&amp;lt;/serviceCredentials&amp;gt;&lt;br /&gt;
			&amp;lt;/behavior&amp;gt;&lt;br /&gt;
		&amp;lt;/serviceBehaviors&amp;gt;&lt;br /&gt;
		&amp;lt;endpointBehaviors&amp;gt;&lt;br /&gt;
			&amp;lt;behavior name=&amp;quot;webBehavior&amp;quot;&amp;gt;&lt;br /&gt;
				&amp;lt;webHttp defaultOutgoingResponseFormat=&amp;quot;Json&amp;quot;/&amp;gt;&lt;br /&gt;
			&amp;lt;/behavior&amp;gt;&lt;br /&gt;
		&amp;lt;/endpointBehaviors&amp;gt;&lt;br /&gt;
	&amp;lt;/behaviors&amp;gt;&lt;br /&gt;
	&amp;lt;standardEndpoints&amp;gt;&lt;br /&gt;
		&amp;lt;webScriptEndpoint&amp;gt;&lt;br /&gt;
			&amp;lt;standardEndpoint crossDomainScriptAccessEnabled=&amp;quot;true&amp;quot;&amp;gt;&lt;br /&gt;
			&amp;lt;/standardEndpoint&amp;gt;&lt;br /&gt;
		&amp;lt;/webScriptEndpoint&amp;gt;&lt;br /&gt;
	&amp;lt;/standardEndpoints&amp;gt;&lt;br /&gt;
	&amp;lt;serviceHostingEnvironment aspNetCompatibilityEnabled=&amp;quot;true&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/system.serviceModel&amp;gt;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== AS Seance Manager - Úloha = 73 ==&lt;br /&gt;
[[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'''''.&lt;br /&gt;
&lt;br /&gt;
V případě KS webAPI je zde typ úlohy &lt;br /&gt;
* '''''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.&lt;br /&gt;
&lt;br /&gt;
ASSM (soubor '''ASSeanceManager.exe''') je nutné spouštět jako '''správce'''.&lt;br /&gt;
&lt;br /&gt;
[[Soubor:Nastaveni-as-seancemanager-webapi.jpg|450px]]&lt;br /&gt;
&lt;br /&gt;
===Správa uživatelů===&lt;br /&gt;
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.&lt;br /&gt;
&lt;br /&gt;
[[Image: KSwebAPI-Konektor Advanto-SpravaUzivatelu.png|400px]] &lt;br /&gt;
&amp;lt;!-- [[Soubor:Sprava-uzivatelu-KS-WEBAPI.jpg|350px]] --&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Oprávnění na položky ===&lt;br /&gt;
&lt;br /&gt;
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. &lt;br /&gt;
&lt;br /&gt;
[[Soubor:Pristupova-prava-polozky-ks-webapi.jpg|350px]]&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Správa (KS webAPI)]]&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Protokoly_(KS_webAPI)&amp;diff=47955</id>
		<title>Protokoly (KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Protokoly_(KS_webAPI)&amp;diff=47955"/>
		<updated>2025-03-10T11:57:54Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Toto API poskytuje rozhraní pro komunikaci mezi klientskými aplikacemi a backendovým systémem. Podporuje jak &amp;lt;b&amp;gt;RESTful&amp;lt;/b&amp;gt;, tak &amp;lt;b&amp;gt;SOAP&amp;lt;/b&amp;gt; architekturu, což umožňuje flexibilní integraci dle požadavků uživatele.  &lt;br /&gt;
&lt;br /&gt;
- &amp;lt;b&amp;gt;REST API&amp;lt;/b&amp;gt; &lt;br /&gt;
využívá standardní HTTP metody (GET, POST, PUT, DELETE) a vrací odpovědi ve formátu JSON.&lt;br /&gt;
&lt;br /&gt;
- &amp;lt;b&amp;gt;SOAP API&amp;lt;/b&amp;gt;&lt;br /&gt;
komunikuje prostřednictvím XML zpráv a využívá protokol &amp;lt;b&amp;gt;SOAP 1.1 / 1.2&amp;lt;/b&amp;gt;.  &lt;br /&gt;
&lt;br /&gt;
API vyžaduje autentizaci a podporuje různé metody zabezpečení, v závislosti na konfiguraci služby.  &lt;br /&gt;
&lt;br /&gt;
Další detaily o jednotlivých metodách a jejich použití naleznete v následujících sekcích.&lt;br /&gt;
&lt;br /&gt;
* '''[[Protokol REST (KS webAPI)|Protokol REST]]'''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Klient (KS webAPI)]]&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Protokoly_(KS_webAPI)&amp;diff=47954</id>
		<title>Protokoly (KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Protokoly_(KS_webAPI)&amp;diff=47954"/>
		<updated>2025-03-10T11:54:10Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Toto API poskytuje rozhraní pro komunikaci mezi klientskými aplikacemi a backendovým systémem. Podporuje jak &amp;lt;b&amp;gt;RESTful&amp;lt;/b&amp;gt;, tak **SOAP** architekturu, což umožňuje flexibilní integraci dle požadavků uživatele.  &lt;br /&gt;
&lt;br /&gt;
- **REST API** využívá standardní HTTP metody (`GET`, `POST`, `PUT`, `DELETE`) a vrací odpovědi ve formátu JSON nebo XML.  &lt;br /&gt;
- **SOAP API** komunikuje prostřednictvím XML zpráv a využívá protokol **SOAP 1.1 / 1.2**.  &lt;br /&gt;
&lt;br /&gt;
API vyžaduje autentizaci a podporuje různé metody zabezpečení, jako jsou **OAuth 2.0**, **JWT tokeny** nebo **Basic Authentication**, v závislosti na konfiguraci služby.  &lt;br /&gt;
&lt;br /&gt;
Další detaily o jednotlivých metodách a jejich použití naleznete v následujících sekcích.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* '''[[Protokol REST (KS webAPI)|Protokol REST]]'''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Klient (KS webAPI)]]&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Protokoly_(KS_webAPI)&amp;diff=47953</id>
		<title>Protokoly (KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Protokoly_(KS_webAPI)&amp;diff=47953"/>
		<updated>2025-03-10T11:53:20Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&amp;lt;h1&amp;gt;Dokumentace Web API&amp;lt;/h1&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Toto API poskytuje rozhraní pro komunikaci mezi klientskými aplikacemi a backendovým systémem. Podporuje jak **RESTful**, tak **SOAP** architekturu, což umožňuje flexibilní integraci dle požadavků uživatele.  &lt;br /&gt;
&lt;br /&gt;
- **REST API** využívá standardní HTTP metody (`GET`, `POST`, `PUT`, `DELETE`) a vrací odpovědi ve formátu JSON nebo XML.  &lt;br /&gt;
- **SOAP API** komunikuje prostřednictvím XML zpráv a využívá protokol **SOAP 1.1 / 1.2**.  &lt;br /&gt;
&lt;br /&gt;
API vyžaduje autentizaci a podporuje různé metody zabezpečení, jako jsou **OAuth 2.0**, **JWT tokeny** nebo **Basic Authentication**, v závislosti na konfiguraci služby.  &lt;br /&gt;
&lt;br /&gt;
Další detaily o jednotlivých metodách a jejich použití naleznete v následujících sekcích.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* '''[[Protokol REST (KS webAPI)|Protokol REST]]'''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Klient (KS webAPI)]]&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Protokol_REST_(KS_webAPI)&amp;diff=47952</id>
		<title>Protokol REST (KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Protokol_REST_(KS_webAPI)&amp;diff=47952"/>
		<updated>2025-03-10T11:50:57Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;        &amp;lt;h2&amp;gt;Základní informace&amp;lt;/h2&amp;gt;&lt;br /&gt;
Komplexní API pro správu dat souhrnů údajů, zaměstnanců a autentizaci uživatelů.&lt;br /&gt;
Umožňuje vkládání, aktualizaci, výběr a mazání dat v různých souhrnech údajů na základě&lt;br /&gt;
specifikovaných kritérií a operací prováděných prostřednictvím HTTP metod.&lt;br /&gt;
        &amp;lt;!-- AUTENTIZACE --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;access&amp;quot;&amp;gt;Autentizace&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Zabezpečení protokolu&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Všechny dotazy na API musí být zasílány prostřednictvím zabezpečeného protokolu HTTPS.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Přístupová oprávnění&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;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.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Autentizace&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Pro autentizaci je třeba odeslat na adresu &amp;lt;i&amp;gt;.../KSAsServer/WebService/WebAPI/rest/users/authenticate&amp;lt;/i&amp;gt; JSON body s údaji &amp;lt;i&amp;gt;&amp;quot;Username&amp;quot;&amp;lt;/i&amp;gt; a &amp;lt;i&amp;gt;&amp;quot;Password&amp;quot;&amp;lt;/i&amp;gt;. Pokud jsou tyto údaje správné, obdržíte &amp;lt;strong&amp;gt;token&amp;lt;/strong&amp;gt;, který je nutný pro používání API po určitou dobu. Token i jeho platnost jsou vráceny v těle odpovědi.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Použití tokenu&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Při každém volání API ,mimo autentizaci, je třeba zaslat platný token jedním ze dvou způsobů:&amp;lt;/p&amp;gt;&lt;br /&gt;
               &lt;br /&gt;
                &amp;lt;ul class=&amp;quot;ulAktualizace&amp;quot;&amp;gt;&lt;br /&gt;
                    &amp;lt;li&amp;gt;&lt;br /&gt;
                        V HEADER&lt;br /&gt;
                        &amp;lt;p&amp;gt;&lt;br /&gt;
                            Plain:  &amp;lt;pre&amp;gt;Authorization -   eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
                            Bearer: &amp;lt;pre&amp;gt;Authorization -   Bearer eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
                        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
                    &amp;lt;/li&amp;gt;&lt;br /&gt;
                   &amp;lt;li&amp;gt;&lt;br /&gt;
                       V URI&lt;br /&gt;
                          &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/Jmeno/Karel?token=eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
                   &amp;lt;/li&amp;gt;&lt;br /&gt;
                &amp;lt;/ul&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Způsob HEADER je preferován před URI.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ol&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
POST /KSAsServer/WebService/WebAPI/rest/user/authenticate&lt;br /&gt;
&lt;br /&gt;
body:&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Username&amp;quot;: &amp;quot;jmeno&amp;quot;,&lt;br /&gt;
    &amp;quot;Password&amp;quot;: &amp;quot;heslo&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
        &amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Created&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720705997339+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: 201,&lt;br /&gt;
    &amp;quot;Token&amp;quot;: &amp;quot;jkdsjflsdfjsdfklsjdflskdfjs.6tQew&amp;quot;,&lt;br /&gt;
    &amp;quot;ValidTo&amp;quot;: &amp;quot;/Date(1720715997000+0200)/&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;!-- METODY --&amp;gt;&lt;br /&gt;
        &amp;lt;h1 id=&amp;quot;methods&amp;quot;&amp;gt;Metody&amp;lt;/h1&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Veškerá dokumentakce k metodám: [[Metody (KS webAPI)|Metody]].&amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- PARAMTERY --&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Parametry&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;ul&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Request header&amp;lt;/b&amp;gt;&lt;br /&gt;
&amp;lt;p&amp;gt;Content-Type -   application/raw&amp;lt;/p&amp;gt;&lt;br /&gt;
&amp;lt;p&amp;gt;Accept -         application/json&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Items&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;&lt;br /&gt;
                    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í.&lt;br /&gt;
                    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&lt;br /&gt;
                    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&lt;br /&gt;
                    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í.&lt;br /&gt;
                &amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;[[JsonSearchCriteria]]&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;[[JsonOptions]]&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;Token&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ul&amp;gt;&lt;br /&gt;
        &amp;lt;!-- CESTY --&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Proměnné cesty&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;ul&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;ItemGroup&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;&lt;br /&gt;
                    (Required)&lt;br /&gt;
                    Název souhrnu údajů. Parametr {ItemGroup} je nutno zaměnit za reálný souhrn údajů.&lt;br /&gt;
                    Předává se název skupiny údajů (entity) v KS mzdy (např. 'KmenoveUdaje').&lt;br /&gt;
                &amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ul&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
GET /KSAsServer/WebService/WebAPI/rest/{ItemGroup]/{Item}?token=12asd16a5sda1s32d&amp;amp;Items=Jmeno,Prijmeni,OsCislo,RodneCislo&amp;amp;JsonSearchCriteria=[{ 'Item': 'OsCislo', 'Operator': '&amp;lt;=', 'Value': 100 }]&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-SOUHRN METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-method&amp;quot;&amp;gt;GET - Vrací data souhrnu údajů podle zadaného názvu souhrnu.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde OsCislo &amp;lt;= 100.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/?token=12asd16a5sda1s32d&amp;amp;Items=Jmeno,Prijmeni,OsCislo,RodneCislo&amp;amp;JsonSearchCriteria=[{ 'Item': 'OsCislo', 'Operator': '&amp;lt;=', 'Value': 100 }]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:36,\&amp;quot;Titul\&amp;quot;:null,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Miroslav\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Nový\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;123456789\&amp;quot;...}],&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720696754982+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-ZAMĚSTNANEC METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-zamestnanec&amp;quot;&amp;gt;GET - Vyhledá zaměstnance ze skupiny údajů 'KmenoveUdaje' podle zadaného osobního čísla.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, aOsCislo.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde OsCislo = 1. Vrátí sloupce OsCislo, Titul, Jmeno, Primeni, RodneCislo&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/1?token=eyJ0eXAiOIiwi7_GcdkwUuTTLDL4&amp;amp;items=OsCislo, Titul, Jmeno, Prijmeni, RodneCislo&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:1,\&amp;quot;Titul\&amp;quot;:\&amp;quot;Ing.\&amp;quot;,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Hovorka\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;581227411\&amp;quot;}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720766282434+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-ITEM METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-item&amp;quot;&amp;gt;GET - Vrací data, kde údaj 'Item' má hodnotu 'Value' v rámci zadaného souhrnu údajů 'ItemGroup'.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, Item, Value.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde Jmeno = Pavel.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/Jmeno/Pavel?token=eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:1,\&amp;quot;Titul\&amp;quot;:\&amp;quot;Ing.\&amp;quot;,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Hovorka\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;581227411\&amp;quot;},&lt;br /&gt;
            {\&amp;quot;OsCislo\&amp;quot;:18,\&amp;quot;Titul\&amp;quot;:null,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;...}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720766630099+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- POST METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;post-method&amp;quot;&amp;gt;POST - Vkládá data do zadaného souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            Metoda InsertData zapisuje data do databáze KS mzdy.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, JsonChangeData (data v těle požadavku).&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vloží data z body požadavku do souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
POST /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje?token=eyJ0eXAiOiJKV1QtL2BDA7_GcdkwUuTTLDL4&amp;amp;&lt;br /&gt;
&lt;br /&gt;
Body:&lt;br /&gt;
[&lt;br /&gt;
    {&lt;br /&gt;
        &amp;quot;IdPodniku&amp;quot;: &amp;quot;1&amp;quot;,&lt;br /&gt;
        &amp;quot;Jmeno&amp;quot;: &amp;quot;Karel&amp;quot;,&lt;br /&gt;
        &amp;quot;Prijmeni&amp;quot;: &amp;quot;Nový&amp;quot;,&lt;br /&gt;
        &amp;quot;RodneCislo&amp;quot;: &amp;quot;9710085892&amp;quot;,&lt;br /&gt;
        &amp;quot;MistoNarozeni&amp;quot;: &amp;quot;Vsetín&amp;quot;,&lt;br /&gt;
        &amp;quot;StatNar&amp;quot;: &amp;quot;CZ&amp;quot;,&lt;br /&gt;
        &amp;quot;StPrisl&amp;quot;: &amp;quot;203&amp;quot;,&lt;br /&gt;
        &amp;quot;RodinStav&amp;quot;: &amp;quot;2&amp;quot;,&lt;br /&gt;
        &amp;quot;TrCislo&amp;quot;: &amp;quot;100&amp;quot;,&lt;br /&gt;
        &amp;quot;PscTrv&amp;quot;: &amp;quot;75501&amp;quot;,&lt;br /&gt;
        &amp;quot;MistoTrv&amp;quot;: &amp;quot;Vsetín&amp;quot;,&lt;br /&gt;
        &amp;quot;KmenStr&amp;quot;: &amp;quot;1&amp;quot;,&lt;br /&gt;
        &amp;quot;DatumNastupu&amp;quot;: &amp;quot;2019-01-01&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;: 95967,\&amp;quot;IdPodniku\&amp;quot;: 1,\&amp;quot;Jmeno\&amp;quot;: \&amp;quot;Karel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;: \&amp;quot;Nový\&amp;quot;&amp;quot;...}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla vložena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720767043837+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;201&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- PUT METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;put-method&amp;quot;&amp;gt;PUT / UPDATE - Aktualizuje data do zadaného souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, JsonChangeData (data v těle požadavku), JsonSearchCriteria.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Aktualizuje data v souhrnu údajů &amp;quot;Kontakty&amp;quot;, kde Hodnota = 222 222 222, na Hodnota = 111 111 111. &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
PUT /KSAsServer/WebService/WebAPI/rest/Kontakty?token=eyJ0eXAiOiJKV1QiLaW_GcdkwUuTTLDL4&amp;amp;JsonSearchCriteria=[{ &amp;quot;Item&amp;quot;: &amp;quot;Hodnota&amp;quot;, &amp;quot;Operator&amp;quot;: &amp;quot;=&amp;quot;, &amp;quot;Value&amp;quot;: &amp;quot;222 222 222&amp;quot;}]&lt;br /&gt;
&lt;br /&gt;
Body:&lt;br /&gt;
[&lt;br /&gt;
    {&lt;br /&gt;
        &amp;quot;Hodnota&amp;quot;: &amp;quot;111 111 111&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla aktualizována.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1721030337638+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;204&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- DELETE METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;delete-method&amp;quot;&amp;gt;DELETE - Smaže data v zadaném souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            Metoda DELETE smaže data v databázi KS mzdy.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, JsonSearchCriteria.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Smaže data v souhrnu údajů &amp;quot;Kontakty&amp;quot;, kde Hodnota = 111 111 111&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
DELETE KSAsServer/WebService/WebAPI/rest/Kontakty?token=eyJ0eXAiOiJKV1QiLCk&amp;amp;JsonSearchCriteria=[{ &amp;quot;Item&amp;quot;: &amp;quot;Hodnota&amp;quot;, &amp;quot;Operator&amp;quot;: &amp;quot;=&amp;quot;, &amp;quot;Value&amp;quot;: &amp;quot;111 111 111&amp;quot;}]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla smazána.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1721030823993+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;204&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
    &amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Klient (KS webAPI)]]&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Protokol_REST_(KS_webAPI)&amp;diff=47951</id>
		<title>Protokol REST (KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Protokol_REST_(KS_webAPI)&amp;diff=47951"/>
		<updated>2025-03-10T11:50:10Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;        &amp;lt;h2&amp;gt;Základní informace&amp;lt;/h2&amp;gt;&lt;br /&gt;
Komplexní API pro správu dat souhrnů údajů, zaměstnanců a autentizaci uživatelů.&lt;br /&gt;
Umožňuje vkládání, aktualizaci, výběr a mazání dat v různých souhrnech údajů na základě&lt;br /&gt;
specifikovaných kritérií a operací prováděných prostřednictvím HTTP metod.&lt;br /&gt;
        &amp;lt;!-- AUTENTIZACE --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;access&amp;quot;&amp;gt;Autentizace&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Zabezpečení protokolu&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Všechny dotazy na API musí být zasílány prostřednictvím zabezpečeného protokolu HTTPS.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Přístupová oprávnění&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;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.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Autentizace&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Pro autentizaci je třeba odeslat na adresu &amp;lt;i&amp;gt;.../KSAsServer/WebService/WebAPI/rest/users/authenticate&amp;lt;/i&amp;gt; JSON body s údaji &amp;lt;i&amp;gt;&amp;quot;Username&amp;quot;&amp;lt;/i&amp;gt; a &amp;lt;i&amp;gt;&amp;quot;Password&amp;quot;&amp;lt;/i&amp;gt;. Pokud jsou tyto údaje správné, obdržíte &amp;lt;strong&amp;gt;token&amp;lt;/strong&amp;gt;, který je nutný pro používání API po určitou dobu. Token i jeho platnost jsou vráceny v těle odpovědi.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Použití tokenu&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Při každém volání API ,mimo autentizaci, je třeba zaslat platný token jedním ze dvou způsobů:&amp;lt;/p&amp;gt;&lt;br /&gt;
               &lt;br /&gt;
                &amp;lt;ul class=&amp;quot;ulAktualizace&amp;quot;&amp;gt;&lt;br /&gt;
                    &amp;lt;li&amp;gt;&lt;br /&gt;
                        V HEADER&lt;br /&gt;
                        &amp;lt;p&amp;gt;&lt;br /&gt;
                            Plain:  &amp;lt;pre&amp;gt;Authorization -   eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
                            Bearer: &amp;lt;pre&amp;gt;Authorization -   Bearer eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
                        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
                    &amp;lt;/li&amp;gt;&lt;br /&gt;
                   &amp;lt;li&amp;gt;&lt;br /&gt;
                       V URI&lt;br /&gt;
                          &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/Jmeno/Karel?token=eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
                   &amp;lt;/li&amp;gt;&lt;br /&gt;
                &amp;lt;/ul&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Způsob HEADER je preferován před URI.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ol&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
POST /KSAsServer/WebService/WebAPI/rest/user/authenticate&lt;br /&gt;
&lt;br /&gt;
body:&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Username&amp;quot;: &amp;quot;jmeno&amp;quot;,&lt;br /&gt;
    &amp;quot;Password&amp;quot;: &amp;quot;heslo&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
        &amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Created&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720705997339+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: 201,&lt;br /&gt;
    &amp;quot;Token&amp;quot;: &amp;quot;jkdsjflsdfjsdfklsjdflskdfjs.6tQew&amp;quot;,&lt;br /&gt;
    &amp;quot;ValidTo&amp;quot;: &amp;quot;/Date(1720715997000+0200)/&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;!-- METODY --&amp;gt;&lt;br /&gt;
        &amp;lt;h1 id=&amp;quot;methods&amp;quot;&amp;gt;Metody&amp;lt;/h1&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Veškerá dokumentakce k metodám: [[Metody (KS webAPI)|Metody]].&amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- PARAMTERY --&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Parametry&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;ul&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Request header&amp;lt;/b&amp;gt;&lt;br /&gt;
&amp;lt;p&amp;gt;Content-Type -   application/raw&amp;lt;/p&amp;gt;&lt;br /&gt;
&amp;lt;p&amp;gt;Accept -         application/json&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Items&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;&lt;br /&gt;
                    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í.&lt;br /&gt;
                    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&lt;br /&gt;
                    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&lt;br /&gt;
                    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í.&lt;br /&gt;
                &amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;[[JsonSearchCriteria]]&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;[[JsonOptions]]&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;Token&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ul&amp;gt;&lt;br /&gt;
        &amp;lt;!-- CESTY --&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Proměnné cesty&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;ul&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;ItemGroup&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;&lt;br /&gt;
                    (Required)&lt;br /&gt;
                    Název souhrnu údajů. Parametr {ItemGroup} je nutno zaměnit za reálný souhrn údajů.&lt;br /&gt;
                    Předává se název skupiny údajů (entity) v KS mzdy (např. 'KmenoveUdaje').&lt;br /&gt;
                &amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ul&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
GET /KSAsServer/WebService/WebAPI/rest/{ItemGroup]/{Item}?token=12asd16a5sda1s32d&amp;amp;Items=Jmeno,Prijmeni,OsCislo,RodneCislo&amp;amp;JsonSearchCriteria=[{ 'Item': 'OsCislo', 'Operator': '&amp;lt;=', 'Value': 100 }]&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-SOUHRN METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-method&amp;quot;&amp;gt;GET - Vrací data souhrnu údajů podle zadaného názvu souhrnu.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde OsCislo &amp;lt;= 100.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/?token=12asd16a5sda1s32d&amp;amp;Items=Jmeno,Prijmeni,OsCislo,RodneCislo&amp;amp;JsonSearchCriteria=[{ 'Item': 'OsCislo', 'Operator': '&amp;lt;=', 'Value': 100 }]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:36,\&amp;quot;Titul\&amp;quot;:null,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Miroslav\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Nový\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;123456789\&amp;quot;...}],&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720696754982+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-ZAMĚSTNANEC METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-zamestnanec&amp;quot;&amp;gt;GET - Vyhledá zaměstnance ze skupiny údajů 'KmenoveUdaje' podle zadaného osobního čísla.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, aOsCislo.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde OsCislo = 1. Vrátí sloupce OsCislo, Titul, Jmeno, Primeni, RodneCislo&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/1?token=eyJ0eXAiOIiwi7_GcdkwUuTTLDL4&amp;amp;items=OsCislo, Titul, Jmeno, Prijmeni, RodneCislo&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:1,\&amp;quot;Titul\&amp;quot;:\&amp;quot;Ing.\&amp;quot;,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Hovorka\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;581227411\&amp;quot;}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720766282434+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-ITEM METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-item&amp;quot;&amp;gt;GET - Vrací data, kde údaj 'Item' má hodnotu 'Value' v rámci zadaného souhrnu údajů 'ItemGroup'.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, Item, Value.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde Jmeno = Pavel.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/Jmeno/Pavel?token=eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:1,\&amp;quot;Titul\&amp;quot;:\&amp;quot;Ing.\&amp;quot;,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Hovorka\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;581227411\&amp;quot;},&lt;br /&gt;
            {\&amp;quot;OsCislo\&amp;quot;:18,\&amp;quot;Titul\&amp;quot;:null,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;...}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720766630099+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- POST METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;post-method&amp;quot;&amp;gt;POST - Vkládá data do zadaného souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            Metoda InsertData zapisuje data do databáze KS mzdy.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, JsonChangeData (data v těle požadavku).&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vloží data z body požadavku do souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
POST /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje?token=eyJ0eXAiOiJKV1QtL2BDA7_GcdkwUuTTLDL4&amp;amp;&lt;br /&gt;
&lt;br /&gt;
Body:&lt;br /&gt;
[&lt;br /&gt;
    {&lt;br /&gt;
        &amp;quot;IdPodniku&amp;quot;: &amp;quot;1&amp;quot;,&lt;br /&gt;
        &amp;quot;Jmeno&amp;quot;: &amp;quot;Karel&amp;quot;,&lt;br /&gt;
        &amp;quot;Prijmeni&amp;quot;: &amp;quot;Nový&amp;quot;,&lt;br /&gt;
        &amp;quot;RodneCislo&amp;quot;: &amp;quot;9710085892&amp;quot;,&lt;br /&gt;
        &amp;quot;MistoNarozeni&amp;quot;: &amp;quot;Vsetín&amp;quot;,&lt;br /&gt;
        &amp;quot;StatNar&amp;quot;: &amp;quot;CZ&amp;quot;,&lt;br /&gt;
        &amp;quot;StPrisl&amp;quot;: &amp;quot;203&amp;quot;,&lt;br /&gt;
        &amp;quot;RodinStav&amp;quot;: &amp;quot;2&amp;quot;,&lt;br /&gt;
        &amp;quot;TrCislo&amp;quot;: &amp;quot;100&amp;quot;,&lt;br /&gt;
        &amp;quot;PscTrv&amp;quot;: &amp;quot;75501&amp;quot;,&lt;br /&gt;
        &amp;quot;MistoTrv&amp;quot;: &amp;quot;Vsetín&amp;quot;,&lt;br /&gt;
        &amp;quot;KmenStr&amp;quot;: &amp;quot;1&amp;quot;,&lt;br /&gt;
        &amp;quot;DatumNastupu&amp;quot;: &amp;quot;2019-01-01&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;: 95967,\&amp;quot;IdPodniku\&amp;quot;: 1,\&amp;quot;Jmeno\&amp;quot;: \&amp;quot;Karel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;: \&amp;quot;Nový\&amp;quot;&amp;quot;...}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla vložena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720767043837+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;201&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- PUT METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;put-method&amp;quot;&amp;gt;PUT / UPDATE - Aktualizuje data do zadaného souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, JsonChangeData (data v těle požadavku), JsonSearchCriteria.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Aktualizuje data v souhrnu údajů &amp;quot;Kontakty&amp;quot;, kde Hodnota = 222 222 222, na Hodnota = 111 111 111. &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
PUT /KSAsServer/WebService/WebAPI/rest/Kontakty?token=eyJ0eXAiOiJKV1QiLaW_GcdkwUuTTLDL4&amp;amp;JsonSearchCriteria=[{ &amp;quot;Item&amp;quot;: &amp;quot;Hodnota&amp;quot;, &amp;quot;Operator&amp;quot;: &amp;quot;=&amp;quot;, &amp;quot;Value&amp;quot;: &amp;quot;222 222 222&amp;quot;}]&lt;br /&gt;
&lt;br /&gt;
Body:&lt;br /&gt;
[&lt;br /&gt;
    {&lt;br /&gt;
        &amp;quot;Hodnota&amp;quot;: &amp;quot;111 111 111&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla aktualizována.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1721030337638+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;204&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- DELETE METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;delete-method&amp;quot;&amp;gt;DELETE - Smaže data v zadaném souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            Metoda DELETE smaže data v databázi KS mzdy.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, JsonSearchCriteria.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Smaže data v souhrnu údajů &amp;quot;Kontakty&amp;quot;, kde Hodnota = 111 111 111&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
DELETE KSAsServer/WebService/WebAPI/rest/Kontakty?token=eyJ0eXAiOiJKV1QiLCk&amp;amp;JsonSearchCriteria=[{ &amp;quot;Item&amp;quot;: &amp;quot;Hodnota&amp;quot;, &amp;quot;Operator&amp;quot;: &amp;quot;=&amp;quot;, &amp;quot;Value&amp;quot;: &amp;quot;111 111 111&amp;quot;}]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla smazána.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1721030823993+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;204&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
    &amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
* [[KS webAPI]]&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Protokoly_(KS_webAPI)&amp;diff=47950</id>
		<title>Protokoly (KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Protokoly_(KS_webAPI)&amp;diff=47950"/>
		<updated>2025-03-10T11:49:20Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;* '''[[Protokol REST (KS webAPI)|Protokol REST]]'''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Klient (KS webAPI)]]&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Protokoly_(KS_webAPI)&amp;diff=47949</id>
		<title>Protokoly (KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Protokoly_(KS_webAPI)&amp;diff=47949"/>
		<updated>2025-03-10T11:49:07Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;KS webAPI využívá dva protokoly&lt;br /&gt;
&lt;br /&gt;
* '''[[Protokol REST (KS webAPI)|Protokol REST]]'''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Klient (KS webAPI)]]&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Protokoly_(KS_webAPI)&amp;diff=47948</id>
		<title>Protokoly (KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Protokoly_(KS_webAPI)&amp;diff=47948"/>
		<updated>2025-03-10T11:48:45Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;KS webAPI využívá dva protokoly&lt;br /&gt;
&lt;br /&gt;
* '''[[Protokol REST (KS webAPI)|Protokol REST]]'''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
* [[KS webAPI]]&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Protokoly_(KS_webAPI)&amp;diff=47947</id>
		<title>Protokoly (KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Protokoly_(KS_webAPI)&amp;diff=47947"/>
		<updated>2025-03-10T11:48:11Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;KS webAPI využívá dva protokoly&lt;br /&gt;
&lt;br /&gt;
* '''[[Protokol REST (KS webAPI)|Protokol REST]]'''&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=KS_webAPI&amp;diff=47946</id>
		<title>KS webAPI</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=KS_webAPI&amp;diff=47946"/>
		<updated>2025-03-10T11:48:03Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;''KS webAPI'' je webová služba postavená na technologii ''Windows Communication Foundation''. Umožňuje předávat údaje z databáze ''KS mzdy'' klientské aplikaci nebo ukládat údaje do databáze ''KS mzdy'' zaslané klientskou aplikací.&lt;br /&gt;
&lt;br /&gt;
* '''[[Správa (KS webAPI)|Správa]]'''&lt;br /&gt;
* '''[[Klient (KS webAPI)|Klient]]'''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
* [[Systémová příručka]]&lt;br /&gt;
* [[Logování (Aplikační server KS)]]&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Protokoly_(KS_webAPI)&amp;diff=47945</id>
		<title>Protokoly (KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Protokoly_(KS_webAPI)&amp;diff=47945"/>
		<updated>2025-03-10T11:47:44Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: založena nová stránka s textem „KS webAPI využívá dva protokoly“&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;KS webAPI využívá dva protokoly&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Klient_(KS_webAPI)&amp;diff=47944</id>
		<title>Klient (KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Klient_(KS_webAPI)&amp;diff=47944"/>
		<updated>2025-03-10T11:47:04Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;''KS webAPI'' je webová služba postavená na technologii ''Windows Communication Foundation''. Umožňuje předávat údaje z databáze ''KS mzdy'' klientské aplikaci nebo ukládat údaje do databáze ''KS mzdy'' zaslané klientskou aplikací.&lt;br /&gt;
&lt;br /&gt;
Komunikační protokol služby je HTTP, případně HTTPS pro zabezpečené připojení pomocí SSL. Pro výměnu zpráv mezi klientem a serverem je podporován protokol '''''SOAP''''' i '''''REST'''''.&lt;br /&gt;
&lt;br /&gt;
* [[Položky (KS webAPI)|Položky]]&lt;br /&gt;
* [[Metody (KS webAPI)|Metody]]&lt;br /&gt;
* [[Autentizace (KS webAPI)|Autentizace]]&lt;br /&gt;
* [[Chybové stavy (KS webAPI)|Chybové stavy]]&lt;br /&gt;
* [[Klientská aplikace (KS webAPI)|Klientská aplikace]]&lt;br /&gt;
* [[Protokoly (KS webAPI)|Protokoly]]&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
* [[KS webAPI]]&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Protokol_REST_(KS_webAPI)&amp;diff=47943</id>
		<title>Protokol REST (KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Protokol_REST_(KS_webAPI)&amp;diff=47943"/>
		<updated>2025-03-10T11:43:05Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;        &amp;lt;h2&amp;gt;Základní informace&amp;lt;/h2&amp;gt;&lt;br /&gt;
Komplexní API pro správu dat souhrnů údajů, zaměstnanců a autentizaci uživatelů.&lt;br /&gt;
Umožňuje vkládání, aktualizaci, výběr a mazání dat v různých souhrnech údajů na základě&lt;br /&gt;
specifikovaných kritérií a operací prováděných prostřednictvím HTTP metod.&lt;br /&gt;
        &amp;lt;!-- AUTENTIZACE --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;access&amp;quot;&amp;gt;Autentizace&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Zabezpečení protokolu&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Všechny dotazy na API musí být zasílány prostřednictvím zabezpečeného protokolu HTTPS.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Přístupová oprávnění&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;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.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Autentizace&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Pro autentizaci je třeba odeslat na adresu &amp;lt;i&amp;gt;.../KSAsServer/WebService/WebAPI/rest/users/authenticate&amp;lt;/i&amp;gt; JSON body s údaji &amp;lt;i&amp;gt;&amp;quot;Username&amp;quot;&amp;lt;/i&amp;gt; a &amp;lt;i&amp;gt;&amp;quot;Password&amp;quot;&amp;lt;/i&amp;gt;. Pokud jsou tyto údaje správné, obdržíte &amp;lt;strong&amp;gt;token&amp;lt;/strong&amp;gt;, který je nutný pro používání API po určitou dobu. Token i jeho platnost jsou vráceny v těle odpovědi.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Použití tokenu&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Při každém volání API ,mimo autentizaci, je třeba zaslat platný token jedním ze dvou způsobů:&amp;lt;/p&amp;gt;&lt;br /&gt;
               &lt;br /&gt;
                &amp;lt;ul class=&amp;quot;ulAktualizace&amp;quot;&amp;gt;&lt;br /&gt;
                    &amp;lt;li&amp;gt;&lt;br /&gt;
                        V HEADER&lt;br /&gt;
                        &amp;lt;p&amp;gt;&lt;br /&gt;
                            Plain:  &amp;lt;pre&amp;gt;Authorization -   eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
                            Bearer: &amp;lt;pre&amp;gt;Authorization -   Bearer eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
                        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
                    &amp;lt;/li&amp;gt;&lt;br /&gt;
                   &amp;lt;li&amp;gt;&lt;br /&gt;
                       V URI&lt;br /&gt;
                          &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/Jmeno/Karel?token=eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
                   &amp;lt;/li&amp;gt;&lt;br /&gt;
                &amp;lt;/ul&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Způsob HEADER je preferován před URI.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ol&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
POST /KSAsServer/WebService/WebAPI/rest/user/authenticate&lt;br /&gt;
&lt;br /&gt;
body:&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Username&amp;quot;: &amp;quot;jmeno&amp;quot;,&lt;br /&gt;
    &amp;quot;Password&amp;quot;: &amp;quot;heslo&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
        &amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Created&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720705997339+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: 201,&lt;br /&gt;
    &amp;quot;Token&amp;quot;: &amp;quot;jkdsjflsdfjsdfklsjdflskdfjs.6tQew&amp;quot;,&lt;br /&gt;
    &amp;quot;ValidTo&amp;quot;: &amp;quot;/Date(1720715997000+0200)/&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;!-- METODY --&amp;gt;&lt;br /&gt;
        &amp;lt;h1 id=&amp;quot;methods&amp;quot;&amp;gt;Metody&amp;lt;/h1&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Veškerá dokumentakce k metodám: [[Metody (KS webAPI)|Metody]].&amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- PARAMTERY --&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Parametry&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;ul&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Request header&amp;lt;/b&amp;gt;&lt;br /&gt;
&amp;lt;p&amp;gt;Content-Type -   application/raw&amp;lt;/p&amp;gt;&lt;br /&gt;
&amp;lt;p&amp;gt;Accept -         application/json&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Items&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;&lt;br /&gt;
                    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í.&lt;br /&gt;
                    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&lt;br /&gt;
                    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&lt;br /&gt;
                    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í.&lt;br /&gt;
                &amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;[[JsonSearchCriteria]]&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;[[JsonOptions]]&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;Token&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ul&amp;gt;&lt;br /&gt;
        &amp;lt;!-- CESTY --&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Proměnné cesty&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;ul&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;ItemGroup&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;&lt;br /&gt;
                    (Required)&lt;br /&gt;
                    Název souhrnu údajů. Parametr {ItemGroup} je nutno zaměnit za reálný souhrn údajů.&lt;br /&gt;
                    Předává se název skupiny údajů (entity) v KS mzdy (např. 'KmenoveUdaje').&lt;br /&gt;
                &amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ul&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
GET /KSAsServer/WebService/WebAPI/rest/{ItemGroup]/{Item}?token=12asd16a5sda1s32d&amp;amp;Items=Jmeno,Prijmeni,OsCislo,RodneCislo&amp;amp;JsonSearchCriteria=[{ 'Item': 'OsCislo', 'Operator': '&amp;lt;=', 'Value': 100 }]&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-SOUHRN METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-method&amp;quot;&amp;gt;GET - Vrací data souhrnu údajů podle zadaného názvu souhrnu.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde OsCislo &amp;lt;= 100.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/?token=12asd16a5sda1s32d&amp;amp;Items=Jmeno,Prijmeni,OsCislo,RodneCislo&amp;amp;JsonSearchCriteria=[{ 'Item': 'OsCislo', 'Operator': '&amp;lt;=', 'Value': 100 }]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:36,\&amp;quot;Titul\&amp;quot;:null,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Miroslav\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Nový\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;123456789\&amp;quot;...}],&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720696754982+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-ZAMĚSTNANEC METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-zamestnanec&amp;quot;&amp;gt;GET - Vyhledá zaměstnance ze skupiny údajů 'KmenoveUdaje' podle zadaného osobního čísla.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, aOsCislo.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde OsCislo = 1. Vrátí sloupce OsCislo, Titul, Jmeno, Primeni, RodneCislo&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/1?token=eyJ0eXAiOIiwi7_GcdkwUuTTLDL4&amp;amp;items=OsCislo, Titul, Jmeno, Prijmeni, RodneCislo&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:1,\&amp;quot;Titul\&amp;quot;:\&amp;quot;Ing.\&amp;quot;,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Hovorka\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;581227411\&amp;quot;}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720766282434+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-ITEM METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-item&amp;quot;&amp;gt;GET - Vrací data, kde údaj 'Item' má hodnotu 'Value' v rámci zadaného souhrnu údajů 'ItemGroup'.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, Item, Value.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde Jmeno = Pavel.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/Jmeno/Pavel?token=eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:1,\&amp;quot;Titul\&amp;quot;:\&amp;quot;Ing.\&amp;quot;,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Hovorka\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;581227411\&amp;quot;},&lt;br /&gt;
            {\&amp;quot;OsCislo\&amp;quot;:18,\&amp;quot;Titul\&amp;quot;:null,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;...}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720766630099+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- POST METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;post-method&amp;quot;&amp;gt;POST - Vkládá data do zadaného souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            Metoda InsertData zapisuje data do databáze KS mzdy.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, JsonChangeData (data v těle požadavku).&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vloží data z body požadavku do souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
POST /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje?token=eyJ0eXAiOiJKV1QtL2BDA7_GcdkwUuTTLDL4&amp;amp;&lt;br /&gt;
&lt;br /&gt;
Body:&lt;br /&gt;
[&lt;br /&gt;
    {&lt;br /&gt;
        &amp;quot;IdPodniku&amp;quot;: &amp;quot;1&amp;quot;,&lt;br /&gt;
        &amp;quot;Jmeno&amp;quot;: &amp;quot;Karel&amp;quot;,&lt;br /&gt;
        &amp;quot;Prijmeni&amp;quot;: &amp;quot;Nový&amp;quot;,&lt;br /&gt;
        &amp;quot;RodneCislo&amp;quot;: &amp;quot;9710085892&amp;quot;,&lt;br /&gt;
        &amp;quot;MistoNarozeni&amp;quot;: &amp;quot;Vsetín&amp;quot;,&lt;br /&gt;
        &amp;quot;StatNar&amp;quot;: &amp;quot;CZ&amp;quot;,&lt;br /&gt;
        &amp;quot;StPrisl&amp;quot;: &amp;quot;203&amp;quot;,&lt;br /&gt;
        &amp;quot;RodinStav&amp;quot;: &amp;quot;2&amp;quot;,&lt;br /&gt;
        &amp;quot;TrCislo&amp;quot;: &amp;quot;100&amp;quot;,&lt;br /&gt;
        &amp;quot;PscTrv&amp;quot;: &amp;quot;75501&amp;quot;,&lt;br /&gt;
        &amp;quot;MistoTrv&amp;quot;: &amp;quot;Vsetín&amp;quot;,&lt;br /&gt;
        &amp;quot;KmenStr&amp;quot;: &amp;quot;1&amp;quot;,&lt;br /&gt;
        &amp;quot;DatumNastupu&amp;quot;: &amp;quot;2019-01-01&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;: 95967,\&amp;quot;IdPodniku\&amp;quot;: 1,\&amp;quot;Jmeno\&amp;quot;: \&amp;quot;Karel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;: \&amp;quot;Nový\&amp;quot;&amp;quot;...}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla vložena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720767043837+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;201&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- PUT METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;put-method&amp;quot;&amp;gt;PUT / UPDATE - Aktualizuje data do zadaného souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, JsonChangeData (data v těle požadavku), JsonSearchCriteria.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Aktualizuje data v souhrnu údajů &amp;quot;Kontakty&amp;quot;, kde Hodnota = 222 222 222, na Hodnota = 111 111 111. &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
PUT /KSAsServer/WebService/WebAPI/rest/Kontakty?token=eyJ0eXAiOiJKV1QiLaW_GcdkwUuTTLDL4&amp;amp;JsonSearchCriteria=[{ &amp;quot;Item&amp;quot;: &amp;quot;Hodnota&amp;quot;, &amp;quot;Operator&amp;quot;: &amp;quot;=&amp;quot;, &amp;quot;Value&amp;quot;: &amp;quot;222 222 222&amp;quot;}]&lt;br /&gt;
&lt;br /&gt;
Body:&lt;br /&gt;
[&lt;br /&gt;
    {&lt;br /&gt;
        &amp;quot;Hodnota&amp;quot;: &amp;quot;111 111 111&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla aktualizována.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1721030337638+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;204&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- DELETE METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;delete-method&amp;quot;&amp;gt;DELETE - Smaže data v zadaném souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            Metoda DELETE smaže data v databázi KS mzdy.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, JsonSearchCriteria.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Smaže data v souhrnu údajů &amp;quot;Kontakty&amp;quot;, kde Hodnota = 111 111 111&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
DELETE KSAsServer/WebService/WebAPI/rest/Kontakty?token=eyJ0eXAiOiJKV1QiLCk&amp;amp;JsonSearchCriteria=[{ &amp;quot;Item&amp;quot;: &amp;quot;Hodnota&amp;quot;, &amp;quot;Operator&amp;quot;: &amp;quot;=&amp;quot;, &amp;quot;Value&amp;quot;: &amp;quot;111 111 111&amp;quot;}]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla smazána.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1721030823993+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;204&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
    &amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
* [[KS webAPI]]&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=KS_webAPI&amp;diff=47942</id>
		<title>KS webAPI</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=KS_webAPI&amp;diff=47942"/>
		<updated>2025-03-10T11:42:27Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;''KS webAPI'' je webová služba postavená na technologii ''Windows Communication Foundation''. Umožňuje předávat údaje z databáze ''KS mzdy'' klientské aplikaci nebo ukládat údaje do databáze ''KS mzdy'' zaslané klientskou aplikací.&lt;br /&gt;
&lt;br /&gt;
* '''[[Správa (KS webAPI)|Správa]]'''&lt;br /&gt;
* '''[[Klient (KS webAPI)|Klient]]'''&lt;br /&gt;
* '''[[Protokol REST (KS webAPI)|Protokol REST]]'''&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
* [[Systémová příručka]]&lt;br /&gt;
* [[Logování (Aplikační server KS)]]&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=KS_webAPI&amp;diff=47941</id>
		<title>KS webAPI</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=KS_webAPI&amp;diff=47941"/>
		<updated>2025-03-10T11:42:15Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;''KS webAPI'' je webová služba postavená na technologii ''Windows Communication Foundation''. Umožňuje předávat údaje z databáze ''KS mzdy'' klientské aplikaci nebo ukládat údaje do databáze ''KS mzdy'' zaslané klientskou aplikací.&lt;br /&gt;
&lt;br /&gt;
* '''[[Správa (KS webAPI)|Správa]]'''&lt;br /&gt;
* '''[[Klient (KS webAPI)|Klient]]'''&lt;br /&gt;
* '''[[Protokol REST (KS webAPI)|Protokol REST]]'''&lt;br /&gt;
* '''[[Rest API(KS webAPI)|Protokol REST]]'''&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
* [[Systémová příručka]]&lt;br /&gt;
* [[Logování (Aplikační server KS)]]&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Rest_API(KS_webAPI)&amp;diff=47940</id>
		<title>Rest API(KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Rest_API(KS_webAPI)&amp;diff=47940"/>
		<updated>2025-03-10T11:41:20Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: Pavelm přesunul stránku Rest API(KS webAPI) na Protokol REST (KS webAPI)&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;#PŘESMĚRUJ [[Protokol REST (KS webAPI)]]&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Protokol_REST_(KS_webAPI)&amp;diff=47939</id>
		<title>Protokol REST (KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Protokol_REST_(KS_webAPI)&amp;diff=47939"/>
		<updated>2025-03-10T11:41:19Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: Pavelm přesunul stránku Rest API(KS webAPI) na Protokol REST (KS webAPI)&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;        &amp;lt;h2&amp;gt;Základní informace&amp;lt;/h2&amp;gt;&lt;br /&gt;
Komplexní API pro správu dat souhrnů údajů, zaměstnanců a autentizaci uživatelů.&lt;br /&gt;
Umožňuje vkládání, aktualizaci, výběr a mazání dat v různých souhrnech údajů na základě&lt;br /&gt;
specifikovaných kritérií a operací prováděných prostřednictvím HTTP metod.&lt;br /&gt;
        &amp;lt;!-- AUTENTIZACE --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;access&amp;quot;&amp;gt;Autentizace&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Zabezpečení protokolu&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Všechny dotazy na API musí být zasílány prostřednictvím zabezpečeného protokolu HTTPS.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Přístupová oprávnění&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;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.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Autentizace&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Pro autentizaci je třeba odeslat na adresu &amp;lt;i&amp;gt;.../KSAsServer/WebService/WebAPI/rest/users/authenticate&amp;lt;/i&amp;gt; JSON body s údaji &amp;lt;i&amp;gt;&amp;quot;Username&amp;quot;&amp;lt;/i&amp;gt; a &amp;lt;i&amp;gt;&amp;quot;Password&amp;quot;&amp;lt;/i&amp;gt;. Pokud jsou tyto údaje správné, obdržíte &amp;lt;strong&amp;gt;token&amp;lt;/strong&amp;gt;, který je nutný pro používání API po určitou dobu. Token i jeho platnost jsou vráceny v těle odpovědi.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Použití tokenu&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Při každém volání API ,mimo autentizaci, je třeba zaslat platný token jedním ze dvou způsobů:&amp;lt;/p&amp;gt;&lt;br /&gt;
               &lt;br /&gt;
                &amp;lt;ul class=&amp;quot;ulAktualizace&amp;quot;&amp;gt;&lt;br /&gt;
                    &amp;lt;li&amp;gt;&lt;br /&gt;
                        V HEADER&lt;br /&gt;
                        &amp;lt;p&amp;gt;&lt;br /&gt;
                            Plain:  &amp;lt;pre&amp;gt;Authorization -   eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
                            Bearer: &amp;lt;pre&amp;gt;Authorization -   Bearer eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
                        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
                    &amp;lt;/li&amp;gt;&lt;br /&gt;
                   &amp;lt;li&amp;gt;&lt;br /&gt;
                       V URI&lt;br /&gt;
                          &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/Jmeno/Karel?token=eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
                   &amp;lt;/li&amp;gt;&lt;br /&gt;
                &amp;lt;/ul&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Způsob HEADER je preferován před URI.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ol&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
POST /KSAsServer/WebService/WebAPI/rest/user/authenticate&lt;br /&gt;
&lt;br /&gt;
body:&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Username&amp;quot;: &amp;quot;jmeno&amp;quot;,&lt;br /&gt;
    &amp;quot;Password&amp;quot;: &amp;quot;heslo&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
        &amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Created&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720705997339+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: 201,&lt;br /&gt;
    &amp;quot;Token&amp;quot;: &amp;quot;jkdsjflsdfjsdfklsjdflskdfjs.6tQew&amp;quot;,&lt;br /&gt;
    &amp;quot;ValidTo&amp;quot;: &amp;quot;/Date(1720715997000+0200)/&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;!-- METODY --&amp;gt;&lt;br /&gt;
        &amp;lt;h1 id=&amp;quot;methods&amp;quot;&amp;gt;Metody&amp;lt;/h1&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Veškerá dokumentakce k metodám: [[Metody (KS webAPI)|Metody]].&amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- PARAMTERY --&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Parametry&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;ul&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Request header&amp;lt;/b&amp;gt;&lt;br /&gt;
&amp;lt;p&amp;gt;Content-Type -   application/raw&amp;lt;/p&amp;gt;&lt;br /&gt;
&amp;lt;p&amp;gt;Accept -         application/json&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Items&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;&lt;br /&gt;
                    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í.&lt;br /&gt;
                    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&lt;br /&gt;
                    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&lt;br /&gt;
                    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í.&lt;br /&gt;
                &amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;[[JsonSearchCriteria]]&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;[[JsonOptions]]&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;Token&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ul&amp;gt;&lt;br /&gt;
        &amp;lt;!-- CESTY --&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Proměnné cesty&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;ul&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;ItemGroup&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;&lt;br /&gt;
                    (Required)&lt;br /&gt;
                    Název souhrnu údajů. Parametr {ItemGroup} je nutno zaměnit za reálný souhrn údajů.&lt;br /&gt;
                    Předává se název skupiny údajů (entity) v KS mzdy (např. 'KmenoveUdaje').&lt;br /&gt;
                &amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ul&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
GET /KSAsServer/WebService/WebAPI/rest/{ItemGroup]/{Item}?token=12asd16a5sda1s32d&amp;amp;Items=Jmeno,Prijmeni,OsCislo,RodneCislo&amp;amp;JsonSearchCriteria=[{ 'Item': 'OsCislo', 'Operator': '&amp;lt;=', 'Value': 100 }]&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-SOUHRN METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-method&amp;quot;&amp;gt;GET - Vrací data souhrnu údajů podle zadaného názvu souhrnu.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde OsCislo &amp;lt;= 100.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/?token=12asd16a5sda1s32d&amp;amp;Item=Jmeno,Prijmeni,OsCislo,RodneCislo&amp;amp;JsonSearchCriteria=[{ 'Item': 'OsCislo', 'Operator': '&amp;lt;=', 'Value': 100 }]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:36,\&amp;quot;Titul\&amp;quot;:null,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Miroslav\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Nový\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;123456789\&amp;quot;...}],&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720696754982+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-ZAMĚSTNANEC METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-zamestnanec&amp;quot;&amp;gt;GET - Vyhledá zaměstnance ze skupiny údajů 'KmenoveUdaje' podle zadaného osobního čísla.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, aOsCislo.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde OsCislo = 1. Vrátí sloupce OsCislo, Titul, Jmeno, Primeni, RodneCislo&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/1?token=eyJ0eXAiOIiwi7_GcdkwUuTTLDL4&amp;amp;items=OsCislo, Titul, Jmeno, Prijmeni, RodneCislo&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:1,\&amp;quot;Titul\&amp;quot;:\&amp;quot;Ing.\&amp;quot;,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Hovorka\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;581227411\&amp;quot;}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720766282434+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-ITEM METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-item&amp;quot;&amp;gt;GET - Vrací data, kde údaj 'Item' má hodnotu 'Value' v rámci zadaného souhrnu údajů 'ItemGroup'.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, Item, Value.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde Jmeno = Pavel.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/Jmeno/Pavel?token=eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:1,\&amp;quot;Titul\&amp;quot;:\&amp;quot;Ing.\&amp;quot;,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Hovorka\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;581227411\&amp;quot;},&lt;br /&gt;
            {\&amp;quot;OsCislo\&amp;quot;:18,\&amp;quot;Titul\&amp;quot;:null,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;...}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720766630099+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- POST METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;post-method&amp;quot;&amp;gt;POST - Vkládá data do zadaného souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            Metoda InsertData zapisuje data do databáze KS mzdy.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, JsonChangeData (data v těle požadavku).&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vloží data z body požadavku do souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
POST /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje?token=eyJ0eXAiOiJKV1QtL2BDA7_GcdkwUuTTLDL4&amp;amp;&lt;br /&gt;
&lt;br /&gt;
Body:&lt;br /&gt;
[&lt;br /&gt;
    {&lt;br /&gt;
        &amp;quot;IdPodniku&amp;quot;: &amp;quot;1&amp;quot;,&lt;br /&gt;
        &amp;quot;Jmeno&amp;quot;: &amp;quot;Karel&amp;quot;,&lt;br /&gt;
        &amp;quot;Prijmeni&amp;quot;: &amp;quot;Nový&amp;quot;,&lt;br /&gt;
        &amp;quot;RodneCislo&amp;quot;: &amp;quot;9710085892&amp;quot;,&lt;br /&gt;
        &amp;quot;MistoNarozeni&amp;quot;: &amp;quot;Vsetín&amp;quot;,&lt;br /&gt;
        &amp;quot;StatNar&amp;quot;: &amp;quot;CZ&amp;quot;,&lt;br /&gt;
        &amp;quot;StPrisl&amp;quot;: &amp;quot;203&amp;quot;,&lt;br /&gt;
        &amp;quot;RodinStav&amp;quot;: &amp;quot;2&amp;quot;,&lt;br /&gt;
        &amp;quot;TrCislo&amp;quot;: &amp;quot;100&amp;quot;,&lt;br /&gt;
        &amp;quot;PscTrv&amp;quot;: &amp;quot;75501&amp;quot;,&lt;br /&gt;
        &amp;quot;MistoTrv&amp;quot;: &amp;quot;Vsetín&amp;quot;,&lt;br /&gt;
        &amp;quot;KmenStr&amp;quot;: &amp;quot;1&amp;quot;,&lt;br /&gt;
        &amp;quot;DatumNastupu&amp;quot;: &amp;quot;2019-01-01&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;: 95967,\&amp;quot;IdPodniku\&amp;quot;: 1,\&amp;quot;Jmeno\&amp;quot;: \&amp;quot;Karel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;: \&amp;quot;Nový\&amp;quot;&amp;quot;...}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla vložena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720767043837+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;201&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- PUT METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;put-method&amp;quot;&amp;gt;PUT / UPDATE - Aktualizuje data do zadaného souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, JsonChangeData (data v těle požadavku), JsonSearchCriteria.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Aktualizuje data v souhrnu údajů &amp;quot;Kontakty&amp;quot;, kde Hodnota = 222 222 222, na Hodnota = 111 111 111. &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
PUT /KSAsServer/WebService/WebAPI/rest/Kontakty?token=eyJ0eXAiOiJKV1QiLaW_GcdkwUuTTLDL4&amp;amp;JsonSearchCriteria=[{ &amp;quot;Item&amp;quot;: &amp;quot;Hodnota&amp;quot;, &amp;quot;Operator&amp;quot;: &amp;quot;=&amp;quot;, &amp;quot;Value&amp;quot;: &amp;quot;222 222 222&amp;quot;}]&lt;br /&gt;
&lt;br /&gt;
Body:&lt;br /&gt;
[&lt;br /&gt;
    {&lt;br /&gt;
        &amp;quot;Hodnota&amp;quot;: &amp;quot;111 111 111&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla aktualizována.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1721030337638+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;204&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- DELETE METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;delete-method&amp;quot;&amp;gt;DELETE - Smaže data v zadaném souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            Metoda DELETE smaže data v databázi KS mzdy.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, JsonSearchCriteria.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Smaže data v souhrnu údajů &amp;quot;Kontakty&amp;quot;, kde Hodnota = 111 111 111&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
DELETE KSAsServer/WebService/WebAPI/rest/Kontakty?token=eyJ0eXAiOiJKV1QiLCk&amp;amp;JsonSearchCriteria=[{ &amp;quot;Item&amp;quot;: &amp;quot;Hodnota&amp;quot;, &amp;quot;Operator&amp;quot;: &amp;quot;=&amp;quot;, &amp;quot;Value&amp;quot;: &amp;quot;111 111 111&amp;quot;}]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla smazána.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1721030823993+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;204&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
    &amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
* [[KS webAPI]]&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=KS_webAPI&amp;diff=47938</id>
		<title>KS webAPI</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=KS_webAPI&amp;diff=47938"/>
		<updated>2025-03-10T11:40:47Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;''KS webAPI'' je webová služba postavená na technologii ''Windows Communication Foundation''. Umožňuje předávat údaje z databáze ''KS mzdy'' klientské aplikaci nebo ukládat údaje do databáze ''KS mzdy'' zaslané klientskou aplikací.&lt;br /&gt;
&lt;br /&gt;
* '''[[Správa (KS webAPI)|Správa]]'''&lt;br /&gt;
* '''[[Klient (KS webAPI)|Klient]]'''&lt;br /&gt;
* '''[[Rest API(KS webAPI)|Protokol REST]]'''&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
* [[Systémová příručka]]&lt;br /&gt;
* [[Logování (Aplikační server KS)]]&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Protokol_REST_(KS_webAPI)&amp;diff=47937</id>
		<title>Protokol REST (KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Protokol_REST_(KS_webAPI)&amp;diff=47937"/>
		<updated>2025-03-10T11:40:01Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;        &amp;lt;h2&amp;gt;Základní informace&amp;lt;/h2&amp;gt;&lt;br /&gt;
Komplexní API pro správu dat souhrnů údajů, zaměstnanců a autentizaci uživatelů.&lt;br /&gt;
Umožňuje vkládání, aktualizaci, výběr a mazání dat v různých souhrnech údajů na základě&lt;br /&gt;
specifikovaných kritérií a operací prováděných prostřednictvím HTTP metod.&lt;br /&gt;
        &amp;lt;!-- AUTENTIZACE --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;access&amp;quot;&amp;gt;Autentizace&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Zabezpečení protokolu&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Všechny dotazy na API musí být zasílány prostřednictvím zabezpečeného protokolu HTTPS.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Přístupová oprávnění&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;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.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Autentizace&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Pro autentizaci je třeba odeslat na adresu &amp;lt;i&amp;gt;.../KSAsServer/WebService/WebAPI/rest/users/authenticate&amp;lt;/i&amp;gt; JSON body s údaji &amp;lt;i&amp;gt;&amp;quot;Username&amp;quot;&amp;lt;/i&amp;gt; a &amp;lt;i&amp;gt;&amp;quot;Password&amp;quot;&amp;lt;/i&amp;gt;. Pokud jsou tyto údaje správné, obdržíte &amp;lt;strong&amp;gt;token&amp;lt;/strong&amp;gt;, který je nutný pro používání API po určitou dobu. Token i jeho platnost jsou vráceny v těle odpovědi.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Použití tokenu&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Při každém volání API ,mimo autentizaci, je třeba zaslat platný token jedním ze dvou způsobů:&amp;lt;/p&amp;gt;&lt;br /&gt;
               &lt;br /&gt;
                &amp;lt;ul class=&amp;quot;ulAktualizace&amp;quot;&amp;gt;&lt;br /&gt;
                    &amp;lt;li&amp;gt;&lt;br /&gt;
                        V HEADER&lt;br /&gt;
                        &amp;lt;p&amp;gt;&lt;br /&gt;
                            Plain:  &amp;lt;pre&amp;gt;Authorization -   eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
                            Bearer: &amp;lt;pre&amp;gt;Authorization -   Bearer eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
                        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
                    &amp;lt;/li&amp;gt;&lt;br /&gt;
                   &amp;lt;li&amp;gt;&lt;br /&gt;
                       V URI&lt;br /&gt;
                          &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/Jmeno/Karel?token=eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
                   &amp;lt;/li&amp;gt;&lt;br /&gt;
                &amp;lt;/ul&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Způsob HEADER je preferován před URI.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ol&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
POST /KSAsServer/WebService/WebAPI/rest/user/authenticate&lt;br /&gt;
&lt;br /&gt;
body:&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Username&amp;quot;: &amp;quot;jmeno&amp;quot;,&lt;br /&gt;
    &amp;quot;Password&amp;quot;: &amp;quot;heslo&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
        &amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Created&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720705997339+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: 201,&lt;br /&gt;
    &amp;quot;Token&amp;quot;: &amp;quot;jkdsjflsdfjsdfklsjdflskdfjs.6tQew&amp;quot;,&lt;br /&gt;
    &amp;quot;ValidTo&amp;quot;: &amp;quot;/Date(1720715997000+0200)/&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;!-- METODY --&amp;gt;&lt;br /&gt;
        &amp;lt;h1 id=&amp;quot;methods&amp;quot;&amp;gt;Metody&amp;lt;/h1&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Veškerá dokumentakce k metodám: [[Metody (KS webAPI)|Metody]].&amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- PARAMTERY --&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Parametry&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;ul&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Request header&amp;lt;/b&amp;gt;&lt;br /&gt;
&amp;lt;p&amp;gt;Content-Type -   application/raw&amp;lt;/p&amp;gt;&lt;br /&gt;
&amp;lt;p&amp;gt;Accept -         application/json&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Items&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;&lt;br /&gt;
                    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í.&lt;br /&gt;
                    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&lt;br /&gt;
                    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&lt;br /&gt;
                    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í.&lt;br /&gt;
                &amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;[[JsonSearchCriteria]]&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;[[JsonOptions]]&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;Token&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ul&amp;gt;&lt;br /&gt;
        &amp;lt;!-- CESTY --&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Proměnné cesty&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;ul&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;ItemGroup&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;&lt;br /&gt;
                    (Required)&lt;br /&gt;
                    Název souhrnu údajů. Parametr {ItemGroup} je nutno zaměnit za reálný souhrn údajů.&lt;br /&gt;
                    Předává se název skupiny údajů (entity) v KS mzdy (např. 'KmenoveUdaje').&lt;br /&gt;
                &amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ul&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
GET /KSAsServer/WebService/WebAPI/rest/{ItemGroup]/{Item}?token=12asd16a5sda1s32d&amp;amp;Items=Jmeno,Prijmeni,OsCislo,RodneCislo&amp;amp;JsonSearchCriteria=[{ 'Item': 'OsCislo', 'Operator': '&amp;lt;=', 'Value': 100 }]&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-SOUHRN METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-method&amp;quot;&amp;gt;GET - Vrací data souhrnu údajů podle zadaného názvu souhrnu.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde OsCislo &amp;lt;= 100.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/?token=12asd16a5sda1s32d&amp;amp;Item=Jmeno,Prijmeni,OsCislo,RodneCislo&amp;amp;JsonSearchCriteria=[{ 'Item': 'OsCislo', 'Operator': '&amp;lt;=', 'Value': 100 }]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:36,\&amp;quot;Titul\&amp;quot;:null,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Miroslav\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Nový\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;123456789\&amp;quot;...}],&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720696754982+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-ZAMĚSTNANEC METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-zamestnanec&amp;quot;&amp;gt;GET - Vyhledá zaměstnance ze skupiny údajů 'KmenoveUdaje' podle zadaného osobního čísla.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, aOsCislo.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde OsCislo = 1. Vrátí sloupce OsCislo, Titul, Jmeno, Primeni, RodneCislo&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/1?token=eyJ0eXAiOIiwi7_GcdkwUuTTLDL4&amp;amp;items=OsCislo, Titul, Jmeno, Prijmeni, RodneCislo&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:1,\&amp;quot;Titul\&amp;quot;:\&amp;quot;Ing.\&amp;quot;,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Hovorka\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;581227411\&amp;quot;}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720766282434+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-ITEM METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-item&amp;quot;&amp;gt;GET - Vrací data, kde údaj 'Item' má hodnotu 'Value' v rámci zadaného souhrnu údajů 'ItemGroup'.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, Item, Value.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde Jmeno = Pavel.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/Jmeno/Pavel?token=eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:1,\&amp;quot;Titul\&amp;quot;:\&amp;quot;Ing.\&amp;quot;,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Hovorka\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;581227411\&amp;quot;},&lt;br /&gt;
            {\&amp;quot;OsCislo\&amp;quot;:18,\&amp;quot;Titul\&amp;quot;:null,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;...}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720766630099+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- POST METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;post-method&amp;quot;&amp;gt;POST - Vkládá data do zadaného souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            Metoda InsertData zapisuje data do databáze KS mzdy.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, JsonChangeData (data v těle požadavku).&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vloží data z body požadavku do souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
POST /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje?token=eyJ0eXAiOiJKV1QtL2BDA7_GcdkwUuTTLDL4&amp;amp;&lt;br /&gt;
&lt;br /&gt;
Body:&lt;br /&gt;
[&lt;br /&gt;
    {&lt;br /&gt;
        &amp;quot;IdPodniku&amp;quot;: &amp;quot;1&amp;quot;,&lt;br /&gt;
        &amp;quot;Jmeno&amp;quot;: &amp;quot;Karel&amp;quot;,&lt;br /&gt;
        &amp;quot;Prijmeni&amp;quot;: &amp;quot;Nový&amp;quot;,&lt;br /&gt;
        &amp;quot;RodneCislo&amp;quot;: &amp;quot;9710085892&amp;quot;,&lt;br /&gt;
        &amp;quot;MistoNarozeni&amp;quot;: &amp;quot;Vsetín&amp;quot;,&lt;br /&gt;
        &amp;quot;StatNar&amp;quot;: &amp;quot;CZ&amp;quot;,&lt;br /&gt;
        &amp;quot;StPrisl&amp;quot;: &amp;quot;203&amp;quot;,&lt;br /&gt;
        &amp;quot;RodinStav&amp;quot;: &amp;quot;2&amp;quot;,&lt;br /&gt;
        &amp;quot;TrCislo&amp;quot;: &amp;quot;100&amp;quot;,&lt;br /&gt;
        &amp;quot;PscTrv&amp;quot;: &amp;quot;75501&amp;quot;,&lt;br /&gt;
        &amp;quot;MistoTrv&amp;quot;: &amp;quot;Vsetín&amp;quot;,&lt;br /&gt;
        &amp;quot;KmenStr&amp;quot;: &amp;quot;1&amp;quot;,&lt;br /&gt;
        &amp;quot;DatumNastupu&amp;quot;: &amp;quot;2019-01-01&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;: 95967,\&amp;quot;IdPodniku\&amp;quot;: 1,\&amp;quot;Jmeno\&amp;quot;: \&amp;quot;Karel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;: \&amp;quot;Nový\&amp;quot;&amp;quot;...}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla vložena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720767043837+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;201&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- PUT METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;put-method&amp;quot;&amp;gt;PUT / UPDATE - Aktualizuje data do zadaného souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, JsonChangeData (data v těle požadavku), JsonSearchCriteria.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Aktualizuje data v souhrnu údajů &amp;quot;Kontakty&amp;quot;, kde Hodnota = 222 222 222, na Hodnota = 111 111 111. &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
PUT /KSAsServer/WebService/WebAPI/rest/Kontakty?token=eyJ0eXAiOiJKV1QiLaW_GcdkwUuTTLDL4&amp;amp;JsonSearchCriteria=[{ &amp;quot;Item&amp;quot;: &amp;quot;Hodnota&amp;quot;, &amp;quot;Operator&amp;quot;: &amp;quot;=&amp;quot;, &amp;quot;Value&amp;quot;: &amp;quot;222 222 222&amp;quot;}]&lt;br /&gt;
&lt;br /&gt;
Body:&lt;br /&gt;
[&lt;br /&gt;
    {&lt;br /&gt;
        &amp;quot;Hodnota&amp;quot;: &amp;quot;111 111 111&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla aktualizována.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1721030337638+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;204&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- DELETE METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;delete-method&amp;quot;&amp;gt;DELETE - Smaže data v zadaném souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            Metoda DELETE smaže data v databázi KS mzdy.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, ItemGroup, JsonSearchCriteria.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Smaže data v souhrnu údajů &amp;quot;Kontakty&amp;quot;, kde Hodnota = 111 111 111&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
DELETE KSAsServer/WebService/WebAPI/rest/Kontakty?token=eyJ0eXAiOiJKV1QiLCk&amp;amp;JsonSearchCriteria=[{ &amp;quot;Item&amp;quot;: &amp;quot;Hodnota&amp;quot;, &amp;quot;Operator&amp;quot;: &amp;quot;=&amp;quot;, &amp;quot;Value&amp;quot;: &amp;quot;111 111 111&amp;quot;}]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla smazána.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1721030823993+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;204&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
    &amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
* [[KS webAPI]]&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Protokol_REST_(KS_webAPI)&amp;diff=47935</id>
		<title>Protokol REST (KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Protokol_REST_(KS_webAPI)&amp;diff=47935"/>
		<updated>2025-03-10T10:33:17Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;        &amp;lt;h2&amp;gt;Základní informace&amp;lt;/h2&amp;gt;&lt;br /&gt;
Komplexní API pro správu dat souhrnů údajů, zaměstnanců a autentizaci uživatelů.&lt;br /&gt;
Umožňuje vkládání, aktualizaci, výběr a mazání dat v různých souhrnech údajů na základě&lt;br /&gt;
specifikovaných kritérií a operací prováděných prostřednictvím HTTP metod.&lt;br /&gt;
        &amp;lt;!-- AUTENTIZACE --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;access&amp;quot;&amp;gt;Autentizace&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Zabezpečení protokolu&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Všechny dotazy na API musí být zasílány prostřednictvím zabezpečeného protokolu HTTPS.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Přístupová oprávnění&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;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.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Autentizace&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Pro autentizaci je třeba odeslat na adresu &amp;lt;i&amp;gt;.../KSAsServer/WebService/WebAPI/rest/users/authenticate&amp;lt;/i&amp;gt; JSON body s údaji &amp;lt;i&amp;gt;&amp;quot;Username&amp;quot;&amp;lt;/i&amp;gt; a &amp;lt;i&amp;gt;&amp;quot;Password&amp;quot;&amp;lt;/i&amp;gt;. Pokud jsou tyto údaje správné, obdržíte &amp;lt;strong&amp;gt;token&amp;lt;/strong&amp;gt;, který je nutný pro používání API po určitou dobu. Token i jeho platnost jsou vráceny v těle odpovědi.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Použití tokenu&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Při každém volání API ,mimo autentizaci, je třeba zaslat platný token jedním ze dvou způsobů:&amp;lt;/p&amp;gt;&lt;br /&gt;
               &lt;br /&gt;
                &amp;lt;ul class=&amp;quot;ulAktualizace&amp;quot;&amp;gt;&lt;br /&gt;
                    &amp;lt;li&amp;gt;&lt;br /&gt;
                        V HEADER&lt;br /&gt;
                        &amp;lt;p&amp;gt;&lt;br /&gt;
                            Plain:  &amp;lt;pre&amp;gt;Authorization -   eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
                            Bearer: &amp;lt;pre&amp;gt;Authorization -   Bearer eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
                        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
                    &amp;lt;/li&amp;gt;&lt;br /&gt;
                   &amp;lt;li&amp;gt;&lt;br /&gt;
                       V URI&lt;br /&gt;
                          &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/Jmeno/Karel?token=eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
                   &amp;lt;/li&amp;gt;&lt;br /&gt;
                &amp;lt;/ul&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Způsob HEADER je preferován před URI.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ol&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
POST /KSAsServer/WebService/WebAPI/rest/user/authenticate&lt;br /&gt;
&lt;br /&gt;
body:&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Username&amp;quot;: &amp;quot;jmeno&amp;quot;,&lt;br /&gt;
    &amp;quot;Password&amp;quot;: &amp;quot;heslo&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
        &amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Created&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720705997339+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: 201,&lt;br /&gt;
    &amp;quot;Token&amp;quot;: &amp;quot;jkdsjflsdfjsdfklsjdflskdfjs.6tQew&amp;quot;,&lt;br /&gt;
    &amp;quot;ValidTo&amp;quot;: &amp;quot;/Date(1720715997000+0200)/&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;!-- METODY --&amp;gt;&lt;br /&gt;
        &amp;lt;h1 id=&amp;quot;methods&amp;quot;&amp;gt;Metody&amp;lt;/h1&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Veškerá dokumentakce k metodám: [[Metody (KS webAPI)|Metody]].&amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- PARAMTERY --&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Parametry&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;ul&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Request header&amp;lt;/b&amp;gt;&lt;br /&gt;
&amp;lt;p&amp;gt;Content-Type -   application/raw&amp;lt;/p&amp;gt;&lt;br /&gt;
&amp;lt;p&amp;gt;Accept -         application/json&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Items&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;&lt;br /&gt;
                    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í.&lt;br /&gt;
                    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&lt;br /&gt;
                    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&lt;br /&gt;
                    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í.&lt;br /&gt;
                &amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;[[JsonSearchCriteria]]&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;[[JsonOptions]]&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;Token&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ul&amp;gt;&lt;br /&gt;
        &amp;lt;!-- CESTY --&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Proměnné cesty&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;ul&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;aItemGroup&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;&lt;br /&gt;
                    (Required)&lt;br /&gt;
                    Název souhrnu údajů. Parametr {aItemGroup} je nutno zaměnit za reálný souhrn údajů.&lt;br /&gt;
                    Předává se název skupiny údajů (entity) v KS mzdy (např. 'KmenoveUdaje').&lt;br /&gt;
                &amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ul&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-SOUHRN METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-method&amp;quot;&amp;gt;GET - Vrací data souhrnu údajů podle zadaného názvu souhrnu.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, aItemGroup.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde OsCislo &amp;lt;= 100.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/?token=12asd16a5sda1s32d&amp;amp;Item=Jmeno,Prijmeni,OsCislo,RodneCislo&amp;amp;JsonSearchCriteria=[{ 'Item': 'OsCislo', 'Operator': '&amp;lt;=', 'Value': 100 }]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:36,\&amp;quot;Titul\&amp;quot;:null,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Miroslav\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Nový\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;123456789\&amp;quot;...}],&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720696754982+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-ZAMĚSTNANEC METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-zamestnanec&amp;quot;&amp;gt;GET - Vyhledá zaměstnance ze skupiny údajů 'KmenoveUdaje' podle zadaného osobního čísla.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, aItemGroup, aOsCislo.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde OsCislo = 1. Vrátí sloupce OsCislo, Titul, Jmeno, Primeni, RodneCislo&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/1?token=eyJ0eXAiOIiwi7_GcdkwUuTTLDL4&amp;amp;items=OsCislo, Titul, Jmeno, Prijmeni, RodneCislo&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:1,\&amp;quot;Titul\&amp;quot;:\&amp;quot;Ing.\&amp;quot;,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Hovorka\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;581227411\&amp;quot;}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720766282434+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-ITEM METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-item&amp;quot;&amp;gt;GET - Vrací data, kde údaj 'aItem' má hodnotu 'aValue' v rámci zadaného souhrnu údajů 'aItemGroup'.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, aItemGroup, aItem, aValue.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde Jmeno = Pavel.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/Jmeno/Pavel?token=eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:1,\&amp;quot;Titul\&amp;quot;:\&amp;quot;Ing.\&amp;quot;,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Hovorka\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;581227411\&amp;quot;},&lt;br /&gt;
            {\&amp;quot;OsCislo\&amp;quot;:18,\&amp;quot;Titul\&amp;quot;:null,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;...}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720766630099+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- POST METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;post-method&amp;quot;&amp;gt;POST - Vkládá data do zadaného souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            Metoda InsertData zapisuje data do databáze KS mzdy.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, aItemGroup, JsonChangeData (data v těle požadavku).&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vloží data z body požadavku do souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
POST /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje?token=eyJ0eXAiOiJKV1QtL2BDA7_GcdkwUuTTLDL4&amp;amp;&lt;br /&gt;
&lt;br /&gt;
Body:&lt;br /&gt;
[&lt;br /&gt;
    {&lt;br /&gt;
        &amp;quot;IdPodniku&amp;quot;: &amp;quot;1&amp;quot;,&lt;br /&gt;
        &amp;quot;Jmeno&amp;quot;: &amp;quot;Karel&amp;quot;,&lt;br /&gt;
        &amp;quot;Prijmeni&amp;quot;: &amp;quot;Nový&amp;quot;,&lt;br /&gt;
        &amp;quot;RodneCislo&amp;quot;: &amp;quot;9710085892&amp;quot;,&lt;br /&gt;
        &amp;quot;MistoNarozeni&amp;quot;: &amp;quot;Vsetín&amp;quot;,&lt;br /&gt;
        &amp;quot;StatNar&amp;quot;: &amp;quot;CZ&amp;quot;,&lt;br /&gt;
        &amp;quot;StPrisl&amp;quot;: &amp;quot;203&amp;quot;,&lt;br /&gt;
        &amp;quot;RodinStav&amp;quot;: &amp;quot;2&amp;quot;,&lt;br /&gt;
        &amp;quot;TrCislo&amp;quot;: &amp;quot;100&amp;quot;,&lt;br /&gt;
        &amp;quot;PscTrv&amp;quot;: &amp;quot;75501&amp;quot;,&lt;br /&gt;
        &amp;quot;MistoTrv&amp;quot;: &amp;quot;Vsetín&amp;quot;,&lt;br /&gt;
        &amp;quot;KmenStr&amp;quot;: &amp;quot;1&amp;quot;,&lt;br /&gt;
        &amp;quot;DatumNastupu&amp;quot;: &amp;quot;2019-01-01&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;: 95967,\&amp;quot;IdPodniku\&amp;quot;: 1,\&amp;quot;Jmeno\&amp;quot;: \&amp;quot;Karel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;: \&amp;quot;Nový\&amp;quot;&amp;quot;...}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla vložena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720767043837+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;201&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- PUT METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;put-method&amp;quot;&amp;gt;PUT / UPDATE - Aktualizuje data do zadaného souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, aItemGroup, JsonChangeData (data v těle požadavku), JsonSearchCriteria.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Aktualizuje data v souhrnu údajů &amp;quot;Kontakty&amp;quot;, kde Hodnota = 222 222 222, na Hodnota = 111 111 111. &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
PUT /KSAsServer/WebService/WebAPI/rest/Kontakty?token=eyJ0eXAiOiJKV1QiLaW_GcdkwUuTTLDL4&amp;amp;JsonSearchCriteria=[{ &amp;quot;Item&amp;quot;: &amp;quot;Hodnota&amp;quot;, &amp;quot;Operator&amp;quot;: &amp;quot;=&amp;quot;, &amp;quot;Value&amp;quot;: &amp;quot;222 222 222&amp;quot;}]&lt;br /&gt;
&lt;br /&gt;
Body:&lt;br /&gt;
[&lt;br /&gt;
    {&lt;br /&gt;
        &amp;quot;Hodnota&amp;quot;: &amp;quot;111 111 111&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla aktualizována.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1721030337638+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;204&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- DELETE METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;delete-method&amp;quot;&amp;gt;DELETE - Smaže data v zadaném souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            Metoda DELETE smaže data v databázi KS mzdy.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, aItemGroup, JsonSearchCriteria.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Smaže data v souhrnu údajů &amp;quot;Kontakty&amp;quot;, kde Hodnota = 111 111 111&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
DELETE KSAsServer/WebService/WebAPI/rest/Kontakty?token=eyJ0eXAiOiJKV1QiLCk&amp;amp;JsonSearchCriteria=[{ &amp;quot;Item&amp;quot;: &amp;quot;Hodnota&amp;quot;, &amp;quot;Operator&amp;quot;: &amp;quot;=&amp;quot;, &amp;quot;Value&amp;quot;: &amp;quot;111 111 111&amp;quot;}]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla smazána.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1721030823993+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;204&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
    &amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
* [[KS webAPI]]&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Protokol_REST_(KS_webAPI)&amp;diff=47934</id>
		<title>Protokol REST (KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Protokol_REST_(KS_webAPI)&amp;diff=47934"/>
		<updated>2025-03-10T10:32:54Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;        &amp;lt;h2&amp;gt;Základní informace&amp;lt;/h2&amp;gt;&lt;br /&gt;
Komplexní API pro správu dat souhrnů údajů, zaměstnanců a autentizaci uživatelů.&lt;br /&gt;
Umožňuje vkládání, aktualizaci, výběr a mazání dat v různých souhrnech údajů na základě&lt;br /&gt;
specifikovaných kritérií a operací prováděných prostřednictvím HTTP metod.&lt;br /&gt;
        &amp;lt;!-- AUTENTIZACE --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;access&amp;quot;&amp;gt;Autentizace k API KS Program&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Zabezpečení protokolu&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Všechny dotazy na API musí být zasílány prostřednictvím zabezpečeného protokolu HTTPS.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Přístupová oprávnění&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;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.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Autentizace&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Pro autentizaci je třeba odeslat na adresu &amp;lt;i&amp;gt;.../KSAsServer/WebService/WebAPI/rest/users/authenticate&amp;lt;/i&amp;gt; JSON body s údaji &amp;lt;i&amp;gt;&amp;quot;Username&amp;quot;&amp;lt;/i&amp;gt; a &amp;lt;i&amp;gt;&amp;quot;Password&amp;quot;&amp;lt;/i&amp;gt;. Pokud jsou tyto údaje správné, obdržíte &amp;lt;strong&amp;gt;token&amp;lt;/strong&amp;gt;, který je nutný pro používání API po určitou dobu. Token i jeho platnost jsou vráceny v těle odpovědi.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Použití tokenu&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Při každém volání API ,mimo autentizaci, je třeba zaslat platný token jedním ze dvou způsobů:&amp;lt;/p&amp;gt;&lt;br /&gt;
               &lt;br /&gt;
                &amp;lt;ul class=&amp;quot;ulAktualizace&amp;quot;&amp;gt;&lt;br /&gt;
                    &amp;lt;li&amp;gt;&lt;br /&gt;
                        V HEADER&lt;br /&gt;
                        &amp;lt;p&amp;gt;&lt;br /&gt;
                            Plain:  &amp;lt;pre&amp;gt;Authorization -   eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
                            Bearer: &amp;lt;pre&amp;gt;Authorization -   Bearer eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
                        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
                    &amp;lt;/li&amp;gt;&lt;br /&gt;
                   &amp;lt;li&amp;gt;&lt;br /&gt;
                       V URI&lt;br /&gt;
                          &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/Jmeno/Karel?token=eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
                   &amp;lt;/li&amp;gt;&lt;br /&gt;
                &amp;lt;/ul&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Způsob HEADER je preferován před URI.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ol&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
POST /KSAsServer/WebService/WebAPI/rest/user/authenticate&lt;br /&gt;
&lt;br /&gt;
body:&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Username&amp;quot;: &amp;quot;jmeno&amp;quot;,&lt;br /&gt;
    &amp;quot;Password&amp;quot;: &amp;quot;heslo&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
        &amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Created&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720705997339+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: 201,&lt;br /&gt;
    &amp;quot;Token&amp;quot;: &amp;quot;jkdsjflsdfjsdfklsjdflskdfjs.6tQew&amp;quot;,&lt;br /&gt;
    &amp;quot;ValidTo&amp;quot;: &amp;quot;/Date(1720715997000+0200)/&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;!-- METODY --&amp;gt;&lt;br /&gt;
        &amp;lt;h1 id=&amp;quot;methods&amp;quot;&amp;gt;Metody&amp;lt;/h1&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Veškerá dokumentakce k metodám: [[Metody (KS webAPI)|Metody]].&amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- PARAMTERY --&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Parametry&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;ul&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Request header&amp;lt;/b&amp;gt;&lt;br /&gt;
&amp;lt;p&amp;gt;Content-Type -   application/raw&amp;lt;/p&amp;gt;&lt;br /&gt;
&amp;lt;p&amp;gt;Accept -         application/json&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Items&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;&lt;br /&gt;
                    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í.&lt;br /&gt;
                    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&lt;br /&gt;
                    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&lt;br /&gt;
                    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í.&lt;br /&gt;
                &amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;[[JsonSearchCriteria]]&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;[[JsonOptions]]&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;Token&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ul&amp;gt;&lt;br /&gt;
        &amp;lt;!-- CESTY --&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Proměnné cesty&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;ul&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;aItemGroup&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;&lt;br /&gt;
                    (Required)&lt;br /&gt;
                    Název souhrnu údajů. Parametr {aItemGroup} je nutno zaměnit za reálný souhrn údajů.&lt;br /&gt;
                    Předává se název skupiny údajů (entity) v KS mzdy (např. 'KmenoveUdaje').&lt;br /&gt;
                &amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ul&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-SOUHRN METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-method&amp;quot;&amp;gt;GET - Vrací data souhrnu údajů podle zadaného názvu souhrnu.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, aItemGroup.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde OsCislo &amp;lt;= 100.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/?token=12asd16a5sda1s32d&amp;amp;Item=Jmeno,Prijmeni,OsCislo,RodneCislo&amp;amp;JsonSearchCriteria=[{ 'Item': 'OsCislo', 'Operator': '&amp;lt;=', 'Value': 100 }]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:36,\&amp;quot;Titul\&amp;quot;:null,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Miroslav\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Nový\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;123456789\&amp;quot;...}],&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720696754982+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-ZAMĚSTNANEC METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-zamestnanec&amp;quot;&amp;gt;GET - Vyhledá zaměstnance ze skupiny údajů 'KmenoveUdaje' podle zadaného osobního čísla.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, aItemGroup, aOsCislo.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde OsCislo = 1. Vrátí sloupce OsCislo, Titul, Jmeno, Primeni, RodneCislo&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/1?token=eyJ0eXAiOIiwi7_GcdkwUuTTLDL4&amp;amp;items=OsCislo, Titul, Jmeno, Prijmeni, RodneCislo&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:1,\&amp;quot;Titul\&amp;quot;:\&amp;quot;Ing.\&amp;quot;,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Hovorka\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;581227411\&amp;quot;}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720766282434+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-ITEM METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-item&amp;quot;&amp;gt;GET - Vrací data, kde údaj 'aItem' má hodnotu 'aValue' v rámci zadaného souhrnu údajů 'aItemGroup'.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, aItemGroup, aItem, aValue.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde Jmeno = Pavel.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/Jmeno/Pavel?token=eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:1,\&amp;quot;Titul\&amp;quot;:\&amp;quot;Ing.\&amp;quot;,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Hovorka\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;581227411\&amp;quot;},&lt;br /&gt;
            {\&amp;quot;OsCislo\&amp;quot;:18,\&amp;quot;Titul\&amp;quot;:null,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;...}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720766630099+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- POST METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;post-method&amp;quot;&amp;gt;POST - Vkládá data do zadaného souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            Metoda InsertData zapisuje data do databáze KS mzdy.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, aItemGroup, JsonChangeData (data v těle požadavku).&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vloží data z body požadavku do souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
POST /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje?token=eyJ0eXAiOiJKV1QtL2BDA7_GcdkwUuTTLDL4&amp;amp;&lt;br /&gt;
&lt;br /&gt;
Body:&lt;br /&gt;
[&lt;br /&gt;
    {&lt;br /&gt;
        &amp;quot;IdPodniku&amp;quot;: &amp;quot;1&amp;quot;,&lt;br /&gt;
        &amp;quot;Jmeno&amp;quot;: &amp;quot;Karel&amp;quot;,&lt;br /&gt;
        &amp;quot;Prijmeni&amp;quot;: &amp;quot;Nový&amp;quot;,&lt;br /&gt;
        &amp;quot;RodneCislo&amp;quot;: &amp;quot;9710085892&amp;quot;,&lt;br /&gt;
        &amp;quot;MistoNarozeni&amp;quot;: &amp;quot;Vsetín&amp;quot;,&lt;br /&gt;
        &amp;quot;StatNar&amp;quot;: &amp;quot;CZ&amp;quot;,&lt;br /&gt;
        &amp;quot;StPrisl&amp;quot;: &amp;quot;203&amp;quot;,&lt;br /&gt;
        &amp;quot;RodinStav&amp;quot;: &amp;quot;2&amp;quot;,&lt;br /&gt;
        &amp;quot;TrCislo&amp;quot;: &amp;quot;100&amp;quot;,&lt;br /&gt;
        &amp;quot;PscTrv&amp;quot;: &amp;quot;75501&amp;quot;,&lt;br /&gt;
        &amp;quot;MistoTrv&amp;quot;: &amp;quot;Vsetín&amp;quot;,&lt;br /&gt;
        &amp;quot;KmenStr&amp;quot;: &amp;quot;1&amp;quot;,&lt;br /&gt;
        &amp;quot;DatumNastupu&amp;quot;: &amp;quot;2019-01-01&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;: 95967,\&amp;quot;IdPodniku\&amp;quot;: 1,\&amp;quot;Jmeno\&amp;quot;: \&amp;quot;Karel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;: \&amp;quot;Nový\&amp;quot;&amp;quot;...}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla vložena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720767043837+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;201&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- PUT METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;put-method&amp;quot;&amp;gt;PUT / UPDATE - Aktualizuje data do zadaného souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, aItemGroup, JsonChangeData (data v těle požadavku), JsonSearchCriteria.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Aktualizuje data v souhrnu údajů &amp;quot;Kontakty&amp;quot;, kde Hodnota = 222 222 222, na Hodnota = 111 111 111. &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
PUT /KSAsServer/WebService/WebAPI/rest/Kontakty?token=eyJ0eXAiOiJKV1QiLaW_GcdkwUuTTLDL4&amp;amp;JsonSearchCriteria=[{ &amp;quot;Item&amp;quot;: &amp;quot;Hodnota&amp;quot;, &amp;quot;Operator&amp;quot;: &amp;quot;=&amp;quot;, &amp;quot;Value&amp;quot;: &amp;quot;222 222 222&amp;quot;}]&lt;br /&gt;
&lt;br /&gt;
Body:&lt;br /&gt;
[&lt;br /&gt;
    {&lt;br /&gt;
        &amp;quot;Hodnota&amp;quot;: &amp;quot;111 111 111&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla aktualizována.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1721030337638+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;204&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- DELETE METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;delete-method&amp;quot;&amp;gt;DELETE - Smaže data v zadaném souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            Metoda DELETE smaže data v databázi KS mzdy.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, aItemGroup, JsonSearchCriteria.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Smaže data v souhrnu údajů &amp;quot;Kontakty&amp;quot;, kde Hodnota = 111 111 111&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
DELETE KSAsServer/WebService/WebAPI/rest/Kontakty?token=eyJ0eXAiOiJKV1QiLCk&amp;amp;JsonSearchCriteria=[{ &amp;quot;Item&amp;quot;: &amp;quot;Hodnota&amp;quot;, &amp;quot;Operator&amp;quot;: &amp;quot;=&amp;quot;, &amp;quot;Value&amp;quot;: &amp;quot;111 111 111&amp;quot;}]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla smazána.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1721030823993+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;204&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
    &amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
* [[KS webAPI]]&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=KS_webAPI&amp;diff=47933</id>
		<title>KS webAPI</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=KS_webAPI&amp;diff=47933"/>
		<updated>2025-03-10T10:28:51Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;''KS webAPI'' je webová služba postavená na technologii ''Windows Communication Foundation''. Umožňuje předávat údaje z databáze ''KS mzdy'' klientské aplikaci nebo ukládat údaje do databáze ''KS mzdy'' zaslané klientskou aplikací.&lt;br /&gt;
&lt;br /&gt;
* '''[[Správa (KS webAPI)|Správa]]'''&lt;br /&gt;
* '''[[Klient (KS webAPI)|Klient]]'''&lt;br /&gt;
* '''[[Rest API(KS webAPI)|Rest API]]'''&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
* [[Systémová příručka]]&lt;br /&gt;
* [[Logování (Aplikační server KS)]]&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=KS_webAPI&amp;diff=47932</id>
		<title>KS webAPI</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=KS_webAPI&amp;diff=47932"/>
		<updated>2025-03-10T10:28:42Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;''KS webAPI'' je webová služba postavená na technologii ''Windows Communication Foundation''. Umožňuje předávat údaje z databáze ''KS mzdy'' klientské aplikaci nebo ukládat údaje do databáze ''KS mzdy'' zaslané klientskou aplikací.&lt;br /&gt;
&lt;br /&gt;
* '''[[Správa (KS webAPI)|Správa]]'''&lt;br /&gt;
* '''[[Klient (KS webAPI)|Klient]]'''&lt;br /&gt;
* '''[[Rest API (KS webAPI)|Rest API]]'''&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
* [[Systémová příručka]]&lt;br /&gt;
* [[Logování (Aplikační server KS)]]&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Protokol_REST_(KS_webAPI)&amp;diff=47931</id>
		<title>Protokol REST (KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Protokol_REST_(KS_webAPI)&amp;diff=47931"/>
		<updated>2025-03-10T10:28:16Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;        &amp;lt;h1&amp;gt;KS REST WebAPI&amp;lt;/h1&amp;gt;&lt;br /&gt;
        &amp;lt;h2&amp;gt;Základní informace&amp;lt;/h2&amp;gt;&lt;br /&gt;
Komplexní API pro správu dat souhrnů údajů, zaměstnanců a autentizaci uživatelů.&lt;br /&gt;
Umožňuje vkládání, aktualizaci, výběr a mazání dat v různých souhrnech údajů na základě&lt;br /&gt;
specifikovaných kritérií a operací prováděných prostřednictvím HTTP metod.&lt;br /&gt;
        &amp;lt;!-- AUTENTIZACE --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;access&amp;quot;&amp;gt;Autentizace k API KS Program&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Zabezpečení protokolu&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Všechny dotazy na API musí být zasílány prostřednictvím zabezpečeného protokolu HTTPS.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Přístupová oprávnění&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;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.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Autentizace&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Pro autentizaci je třeba odeslat na adresu &amp;lt;i&amp;gt;.../KSAsServer/WebService/WebAPI/rest/users/authenticate&amp;lt;/i&amp;gt; JSON body s údaji &amp;lt;i&amp;gt;&amp;quot;Username&amp;quot;&amp;lt;/i&amp;gt; a &amp;lt;i&amp;gt;&amp;quot;Password&amp;quot;&amp;lt;/i&amp;gt;. Pokud jsou tyto údaje správné, obdržíte &amp;lt;strong&amp;gt;token&amp;lt;/strong&amp;gt;, který je nutný pro používání API po určitou dobu. Token i jeho platnost jsou vráceny v těle odpovědi.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Použití tokenu&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Při každém volání API ,mimo autentizaci, je třeba zaslat platný token jedním ze dvou způsobů:&amp;lt;/p&amp;gt;&lt;br /&gt;
               &lt;br /&gt;
                &amp;lt;ul class=&amp;quot;ulAktualizace&amp;quot;&amp;gt;&lt;br /&gt;
                    &amp;lt;li&amp;gt;&lt;br /&gt;
                        V HEADER&lt;br /&gt;
                        &amp;lt;p&amp;gt;&lt;br /&gt;
                            Plain:  &amp;lt;pre&amp;gt;Authorization -   eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
                            Bearer: &amp;lt;pre&amp;gt;Authorization -   Bearer eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
                        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
                    &amp;lt;/li&amp;gt;&lt;br /&gt;
                   &amp;lt;li&amp;gt;&lt;br /&gt;
                       V URI&lt;br /&gt;
                          &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/Jmeno/Karel?token=eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
                   &amp;lt;/li&amp;gt;&lt;br /&gt;
                &amp;lt;/ul&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Způsob HEADER je preferován před URI.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ol&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
POST /KSAsServer/WebService/WebAPI/rest/user/authenticate&lt;br /&gt;
&lt;br /&gt;
body:&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Username&amp;quot;: &amp;quot;jmeno&amp;quot;,&lt;br /&gt;
    &amp;quot;Password&amp;quot;: &amp;quot;heslo&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
        &amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Created&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720705997339+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: 201,&lt;br /&gt;
    &amp;quot;Token&amp;quot;: &amp;quot;jkdsjflsdfjsdfklsjdflskdfjs.6tQew&amp;quot;,&lt;br /&gt;
    &amp;quot;ValidTo&amp;quot;: &amp;quot;/Date(1720715997000+0200)/&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;!-- METODY --&amp;gt;&lt;br /&gt;
        &amp;lt;h1 id=&amp;quot;methods&amp;quot;&amp;gt;Metody&amp;lt;/h1&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Veškerá dokumentakce k metodám: [[Metody (KS webAPI)|Metody]].&amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- PARAMTERY --&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Parametry&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;ul&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Request header&amp;lt;/b&amp;gt;&lt;br /&gt;
&amp;lt;p&amp;gt;Content-Type -   application/raw&amp;lt;/p&amp;gt;&lt;br /&gt;
&amp;lt;p&amp;gt;Accept -         application/json&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Items&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;&lt;br /&gt;
                    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í.&lt;br /&gt;
                    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&lt;br /&gt;
                    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&lt;br /&gt;
                    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í.&lt;br /&gt;
                &amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;[[JsonSearchCriteria]]&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;[[JsonOptions]]&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;Token&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ul&amp;gt;&lt;br /&gt;
        &amp;lt;!-- CESTY --&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Proměnné cesty&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;ul&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;aItemGroup&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;&lt;br /&gt;
                    (Required)&lt;br /&gt;
                    Název souhrnu údajů. Parametr {aItemGroup} je nutno zaměnit za reálný souhrn údajů.&lt;br /&gt;
                    Předává se název skupiny údajů (entity) v KS mzdy (např. 'KmenoveUdaje').&lt;br /&gt;
                &amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ul&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-SOUHRN METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-method&amp;quot;&amp;gt;GET - Vrací data souhrnu údajů podle zadaného názvu souhrnu.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, aItemGroup.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde OsCislo &amp;lt;= 100.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/?token=12asd16a5sda1s32d&amp;amp;Item=Jmeno,Prijmeni,OsCislo,RodneCislo&amp;amp;JsonSearchCriteria=[{ 'Item': 'OsCislo', 'Operator': '&amp;lt;=', 'Value': 100 }]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:36,\&amp;quot;Titul\&amp;quot;:null,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Miroslav\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Nový\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;123456789\&amp;quot;...}],&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720696754982+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-ZAMĚSTNANEC METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-zamestnanec&amp;quot;&amp;gt;GET - Vyhledá zaměstnance ze skupiny údajů 'KmenoveUdaje' podle zadaného osobního čísla.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, aItemGroup, aOsCislo.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde OsCislo = 1. Vrátí sloupce OsCislo, Titul, Jmeno, Primeni, RodneCislo&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/1?token=eyJ0eXAiOIiwi7_GcdkwUuTTLDL4&amp;amp;items=OsCislo, Titul, Jmeno, Prijmeni, RodneCislo&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:1,\&amp;quot;Titul\&amp;quot;:\&amp;quot;Ing.\&amp;quot;,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Hovorka\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;581227411\&amp;quot;}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720766282434+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-ITEM METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-item&amp;quot;&amp;gt;GET - Vrací data, kde údaj 'aItem' má hodnotu 'aValue' v rámci zadaného souhrnu údajů 'aItemGroup'.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, aItemGroup, aItem, aValue.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde Jmeno = Pavel.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/Jmeno/Pavel?token=eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:1,\&amp;quot;Titul\&amp;quot;:\&amp;quot;Ing.\&amp;quot;,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Hovorka\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;581227411\&amp;quot;},&lt;br /&gt;
            {\&amp;quot;OsCislo\&amp;quot;:18,\&amp;quot;Titul\&amp;quot;:null,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;...}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720766630099+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- POST METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;post-method&amp;quot;&amp;gt;POST - Vkládá data do zadaného souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            Metoda InsertData zapisuje data do databáze KS mzdy.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, aItemGroup, JsonChangeData (data v těle požadavku).&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vloží data z body požadavku do souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
POST /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje?token=eyJ0eXAiOiJKV1QtL2BDA7_GcdkwUuTTLDL4&amp;amp;&lt;br /&gt;
&lt;br /&gt;
Body:&lt;br /&gt;
[&lt;br /&gt;
    {&lt;br /&gt;
        &amp;quot;IdPodniku&amp;quot;: &amp;quot;1&amp;quot;,&lt;br /&gt;
        &amp;quot;Jmeno&amp;quot;: &amp;quot;Karel&amp;quot;,&lt;br /&gt;
        &amp;quot;Prijmeni&amp;quot;: &amp;quot;Nový&amp;quot;,&lt;br /&gt;
        &amp;quot;RodneCislo&amp;quot;: &amp;quot;9710085892&amp;quot;,&lt;br /&gt;
        &amp;quot;MistoNarozeni&amp;quot;: &amp;quot;Vsetín&amp;quot;,&lt;br /&gt;
        &amp;quot;StatNar&amp;quot;: &amp;quot;CZ&amp;quot;,&lt;br /&gt;
        &amp;quot;StPrisl&amp;quot;: &amp;quot;203&amp;quot;,&lt;br /&gt;
        &amp;quot;RodinStav&amp;quot;: &amp;quot;2&amp;quot;,&lt;br /&gt;
        &amp;quot;TrCislo&amp;quot;: &amp;quot;100&amp;quot;,&lt;br /&gt;
        &amp;quot;PscTrv&amp;quot;: &amp;quot;75501&amp;quot;,&lt;br /&gt;
        &amp;quot;MistoTrv&amp;quot;: &amp;quot;Vsetín&amp;quot;,&lt;br /&gt;
        &amp;quot;KmenStr&amp;quot;: &amp;quot;1&amp;quot;,&lt;br /&gt;
        &amp;quot;DatumNastupu&amp;quot;: &amp;quot;2019-01-01&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;: 95967,\&amp;quot;IdPodniku\&amp;quot;: 1,\&amp;quot;Jmeno\&amp;quot;: \&amp;quot;Karel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;: \&amp;quot;Nový\&amp;quot;&amp;quot;...}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla vložena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720767043837+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;201&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- PUT METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;put-method&amp;quot;&amp;gt;PUT / UPDATE - Aktualizuje data do zadaného souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, aItemGroup, JsonChangeData (data v těle požadavku), JsonSearchCriteria.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Aktualizuje data v souhrnu údajů &amp;quot;Kontakty&amp;quot;, kde Hodnota = 222 222 222, na Hodnota = 111 111 111. &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
PUT /KSAsServer/WebService/WebAPI/rest/Kontakty?token=eyJ0eXAiOiJKV1QiLaW_GcdkwUuTTLDL4&amp;amp;JsonSearchCriteria=[{ &amp;quot;Item&amp;quot;: &amp;quot;Hodnota&amp;quot;, &amp;quot;Operator&amp;quot;: &amp;quot;=&amp;quot;, &amp;quot;Value&amp;quot;: &amp;quot;222 222 222&amp;quot;}]&lt;br /&gt;
&lt;br /&gt;
Body:&lt;br /&gt;
[&lt;br /&gt;
    {&lt;br /&gt;
        &amp;quot;Hodnota&amp;quot;: &amp;quot;111 111 111&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla aktualizována.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1721030337638+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;204&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- DELETE METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;delete-method&amp;quot;&amp;gt;DELETE - Smaže data v zadaném souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            Metoda DELETE smaže data v databázi KS mzdy.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, aItemGroup, JsonSearchCriteria.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Smaže data v souhrnu údajů &amp;quot;Kontakty&amp;quot;, kde Hodnota = 111 111 111&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
DELETE KSAsServer/WebService/WebAPI/rest/Kontakty?token=eyJ0eXAiOiJKV1QiLCk&amp;amp;JsonSearchCriteria=[{ &amp;quot;Item&amp;quot;: &amp;quot;Hodnota&amp;quot;, &amp;quot;Operator&amp;quot;: &amp;quot;=&amp;quot;, &amp;quot;Value&amp;quot;: &amp;quot;111 111 111&amp;quot;}]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla smazána.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1721030823993+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;204&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
    &amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
* [[KS webAPI]]&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Protokol_REST_(KS_webAPI)&amp;diff=47930</id>
		<title>Protokol REST (KS webAPI)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Protokol_REST_(KS_webAPI)&amp;diff=47930"/>
		<updated>2025-03-10T10:27:21Z</updated>

		<summary type="html">&lt;p&gt;Pavelm: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;        &amp;lt;h1&amp;gt;KS REST WebAPI&amp;lt;/h1&amp;gt;&lt;br /&gt;
        &amp;lt;h2&amp;gt;Základní informace&amp;lt;/h2&amp;gt;&lt;br /&gt;
Komplexní API pro správu dat souhrnů údajů, zaměstnanců a autentizaci uživatelů.&lt;br /&gt;
Umožňuje vkládání, aktualizaci, výběr a mazání dat v různých souhrnech údajů na základě&lt;br /&gt;
specifikovaných kritérií a operací prováděných prostřednictvím HTTP metod.&lt;br /&gt;
        &amp;lt;!-- AUTENTIZACE --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;access&amp;quot;&amp;gt;Autentizace k API KS Program&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;ol&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Zabezpečení protokolu&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Všechny dotazy na API musí být zasílány prostřednictvím zabezpečeného protokolu HTTPS.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Přístupová oprávnění&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;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.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Autentizace&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Pro autentizaci je třeba odeslat na adresu &amp;lt;i&amp;gt;.../KSAsServer/WebService/WebAPI/rest/users/authenticate&amp;lt;/i&amp;gt; JSON body s údaji &amp;lt;i&amp;gt;&amp;quot;Username&amp;quot;&amp;lt;/i&amp;gt; a &amp;lt;i&amp;gt;&amp;quot;Password&amp;quot;&amp;lt;/i&amp;gt;. Pokud jsou tyto údaje správné, obdržíte &amp;lt;strong&amp;gt;token&amp;lt;/strong&amp;gt;, který je nutný pro používání API po určitou dobu. Token i jeho platnost jsou vráceny v těle odpovědi.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Použití tokenu&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Při každém volání API ,mimo autentizaci, je třeba zaslat platný token jedním ze dvou způsobů:&amp;lt;/p&amp;gt;&lt;br /&gt;
               &lt;br /&gt;
                &amp;lt;ul class=&amp;quot;ulAktualizace&amp;quot;&amp;gt;&lt;br /&gt;
                    &amp;lt;li&amp;gt;&lt;br /&gt;
                        V HEADER&lt;br /&gt;
                        &amp;lt;p&amp;gt;&lt;br /&gt;
                            Plain:  &amp;lt;pre&amp;gt;Authorization -   eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
                            Bearer: &amp;lt;pre&amp;gt;Authorization -   Bearer eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
                        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
                    &amp;lt;/li&amp;gt;&lt;br /&gt;
                   &amp;lt;li&amp;gt;&lt;br /&gt;
                       V URI&lt;br /&gt;
                          &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/Jmeno/Karel?token=eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
                   &amp;lt;/li&amp;gt;&lt;br /&gt;
                &amp;lt;/ul&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;Způsob HEADER je preferován před URI.&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ol&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
POST /KSAsServer/WebService/WebAPI/rest/user/authenticate&lt;br /&gt;
&lt;br /&gt;
body:&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Username&amp;quot;: &amp;quot;jmeno&amp;quot;,&lt;br /&gt;
    &amp;quot;Password&amp;quot;: &amp;quot;heslo&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
        &amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Created&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720705997339+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: 201,&lt;br /&gt;
    &amp;quot;Token&amp;quot;: &amp;quot;jkdsjflsdfjsdfklsjdflskdfjs.6tQew&amp;quot;,&lt;br /&gt;
    &amp;quot;ValidTo&amp;quot;: &amp;quot;/Date(1720715997000+0200)/&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;!-- METODY --&amp;gt;&lt;br /&gt;
        &amp;lt;h1 id=&amp;quot;methods&amp;quot;&amp;gt;Metody&amp;lt;/h1&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Veškerá dokumentakce k metodám: [[Metody (KS webAPI)|Metody]].&amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- PARAMTERY --&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Parametry&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;ul&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Request header&amp;lt;/b&amp;gt;&lt;br /&gt;
&amp;lt;p&amp;gt;Content-Type -   application/raw&amp;lt;/p&amp;gt;&lt;br /&gt;
&amp;lt;p&amp;gt;Accept -         application/json&amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;Items&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;&lt;br /&gt;
                    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í.&lt;br /&gt;
                    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&lt;br /&gt;
                    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&lt;br /&gt;
                    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í.&lt;br /&gt;
                &amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;[[JsonSearchCriteria]]&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;[[JsonOptions]]&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
&lt;br /&gt;
            &amp;lt;li&amp;gt;&amp;lt;b&amp;gt;Token&amp;lt;/b&amp;gt;&amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ul&amp;gt;&lt;br /&gt;
        &amp;lt;!-- CESTY --&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Proměnné cesty&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;ul&amp;gt;&lt;br /&gt;
            &amp;lt;li&amp;gt;&lt;br /&gt;
                &amp;lt;b&amp;gt;aItemGroup&amp;lt;/b&amp;gt;&lt;br /&gt;
                &amp;lt;p&amp;gt;&lt;br /&gt;
                    (Required)&lt;br /&gt;
                    Název souhrnu údajů. Parametr {aItemGroup} je nutno zaměnit za reálný souhrn údajů.&lt;br /&gt;
                    Předává se název skupiny údajů (entity) v KS mzdy (např. 'KmenoveUdaje').&lt;br /&gt;
                &amp;lt;/p&amp;gt;&lt;br /&gt;
            &amp;lt;/li&amp;gt;&lt;br /&gt;
        &amp;lt;/ul&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-SOUHRN METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-method&amp;quot;&amp;gt;GET - Vrací data souhrnu údajů podle zadaného názvu souhrnu.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, aItemGroup.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde OsCislo &amp;lt;= 100.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/?token=12asd16a5sda1s32d&amp;amp;Item=Jmeno,Prijmeni,OsCislo,RodneCislo&amp;amp;JsonSearchCriteria=[{ 'Item': 'OsCislo', 'Operator': '&amp;lt;=', 'Value': 100 }]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:36,\&amp;quot;Titul\&amp;quot;:null,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Miroslav\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Nový\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;123456789\&amp;quot;...}],&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720696754982+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-ZAMĚSTNANEC METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-zamestnanec&amp;quot;&amp;gt;GET - Vyhledá zaměstnance ze skupiny údajů 'KmenoveUdaje' podle zadaného osobního čísla.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, aItemGroup, aOsCislo.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde OsCislo = 1. Vrátí sloupce OsCislo, Titul, Jmeno, Primeni, RodneCislo&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/1?token=eyJ0eXAiOIiwi7_GcdkwUuTTLDL4&amp;amp;items=OsCislo, Titul, Jmeno, Prijmeni, RodneCislo&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:1,\&amp;quot;Titul\&amp;quot;:\&amp;quot;Ing.\&amp;quot;,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Hovorka\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;581227411\&amp;quot;}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720766282434+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- GET-ITEM METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;get-item&amp;quot;&amp;gt;GET - Vrací data, kde údaj 'aItem' má hodnotu 'aValue' v rámci zadaného souhrnu údajů 'aItemGroup'.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, aItemGroup, aItem, aValue.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Volitelné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            JsonSearchCriteria, Items, JsonOptions.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vrátí data ze souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;, kde Jmeno = Pavel.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;GET /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje/Jmeno/Pavel?token=eyJ0eXAwibmFtZSI6InBhdmVIuMDGtBE1GxcdkwUuTTLDL4&amp;amp;&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;:1,\&amp;quot;Titul\&amp;quot;:\&amp;quot;Ing.\&amp;quot;,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;:\&amp;quot;Hovorka\&amp;quot;,\&amp;quot;RodneCislo\&amp;quot;:\&amp;quot;581227411\&amp;quot;},&lt;br /&gt;
            {\&amp;quot;OsCislo\&amp;quot;:18,\&amp;quot;Titul\&amp;quot;:null,\&amp;quot;Jmeno\&amp;quot;:\&amp;quot;Pavel\&amp;quot;...}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Data nalezena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720766630099+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;200&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- POST METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;post-method&amp;quot;&amp;gt;POST - Vkládá data do zadaného souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            Metoda InsertData zapisuje data do databáze KS mzdy.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, aItemGroup, JsonChangeData (data v těle požadavku).&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Vloží data z body požadavku do souhrnu údajů &amp;quot;KmenoveUdaje&amp;quot;.&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
POST /KSAsServer/WebService/WebAPI/rest/KmenoveUdaje?token=eyJ0eXAiOiJKV1QtL2BDA7_GcdkwUuTTLDL4&amp;amp;&lt;br /&gt;
&lt;br /&gt;
Body:&lt;br /&gt;
[&lt;br /&gt;
    {&lt;br /&gt;
        &amp;quot;IdPodniku&amp;quot;: &amp;quot;1&amp;quot;,&lt;br /&gt;
        &amp;quot;Jmeno&amp;quot;: &amp;quot;Karel&amp;quot;,&lt;br /&gt;
        &amp;quot;Prijmeni&amp;quot;: &amp;quot;Nový&amp;quot;,&lt;br /&gt;
        &amp;quot;RodneCislo&amp;quot;: &amp;quot;9710085892&amp;quot;,&lt;br /&gt;
        &amp;quot;MistoNarozeni&amp;quot;: &amp;quot;Vsetín&amp;quot;,&lt;br /&gt;
        &amp;quot;StatNar&amp;quot;: &amp;quot;CZ&amp;quot;,&lt;br /&gt;
        &amp;quot;StPrisl&amp;quot;: &amp;quot;203&amp;quot;,&lt;br /&gt;
        &amp;quot;RodinStav&amp;quot;: &amp;quot;2&amp;quot;,&lt;br /&gt;
        &amp;quot;TrCislo&amp;quot;: &amp;quot;100&amp;quot;,&lt;br /&gt;
        &amp;quot;PscTrv&amp;quot;: &amp;quot;75501&amp;quot;,&lt;br /&gt;
        &amp;quot;MistoTrv&amp;quot;: &amp;quot;Vsetín&amp;quot;,&lt;br /&gt;
        &amp;quot;KmenStr&amp;quot;: &amp;quot;1&amp;quot;,&lt;br /&gt;
        &amp;quot;DatumNastupu&amp;quot;: &amp;quot;2019-01-01&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;[{\&amp;quot;OsCislo\&amp;quot;: 95967,\&amp;quot;IdPodniku\&amp;quot;: 1,\&amp;quot;Jmeno\&amp;quot;: \&amp;quot;Karel\&amp;quot;,\&amp;quot;Prijmeni\&amp;quot;: \&amp;quot;Nový\&amp;quot;&amp;quot;...}]&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla vložena.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1720767043837+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;201&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- PUT METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;put-method&amp;quot;&amp;gt;PUT / UPDATE - Aktualizuje data do zadaného souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, aItemGroup, JsonChangeData (data v těle požadavku), JsonSearchCriteria.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Aktualizuje data v souhrnu údajů &amp;quot;Kontakty&amp;quot;, kde Hodnota = 222 222 222, na Hodnota = 111 111 111. &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
PUT /KSAsServer/WebService/WebAPI/rest/Kontakty?token=eyJ0eXAiOiJKV1QiLaW_GcdkwUuTTLDL4&amp;amp;JsonSearchCriteria=[{ &amp;quot;Item&amp;quot;: &amp;quot;Hodnota&amp;quot;, &amp;quot;Operator&amp;quot;: &amp;quot;=&amp;quot;, &amp;quot;Value&amp;quot;: &amp;quot;222 222 222&amp;quot;}]&lt;br /&gt;
&lt;br /&gt;
Body:&lt;br /&gt;
[&lt;br /&gt;
    {&lt;br /&gt;
        &amp;quot;Hodnota&amp;quot;: &amp;quot;111 111 111&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla aktualizována.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1721030337638+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;204&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
        &amp;lt;!-- DELETE METHOD --&amp;gt;&lt;br /&gt;
        &amp;lt;h2 id=&amp;quot;delete-method&amp;quot;&amp;gt;DELETE - Smaže data v zadaném souhrnu údajů.&amp;lt;/h2&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            Metoda DELETE smaže data v databázi KS mzdy.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&lt;br /&gt;
            &amp;lt;b&amp;gt;Povinné parametry:&amp;lt;/b&amp;gt;&lt;br /&gt;
            Token, aItemGroup, JsonSearchCriteria.&lt;br /&gt;
        &amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;h3&amp;gt;Příklad:&amp;lt;/h3&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;Smaže data v souhrnu údajů &amp;quot;Kontakty&amp;quot;, kde Hodnota = 111 111 111&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Požadavek&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
DELETE KSAsServer/WebService/WebAPI/rest/Kontakty?token=eyJ0eXAiOiJKV1QiLCk&amp;amp;JsonSearchCriteria=[{ &amp;quot;Item&amp;quot;: &amp;quot;Hodnota&amp;quot;, &amp;quot;Operator&amp;quot;: &amp;quot;=&amp;quot;, &amp;quot;Value&amp;quot;: &amp;quot;111 111 111&amp;quot;}]&amp;lt;/pre&amp;gt;&lt;br /&gt;
        &amp;lt;p&amp;gt;&amp;lt;b&amp;gt;Odpověď&amp;lt;/b&amp;gt;&amp;lt;/p&amp;gt;&lt;br /&gt;
        &amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
    &amp;quot;Data&amp;quot;: &amp;quot;&amp;quot;,&lt;br /&gt;
    &amp;quot;ErrorCode&amp;quot;: 0,&lt;br /&gt;
    &amp;quot;ErrorMessage&amp;quot;: null,&lt;br /&gt;
    &amp;quot;ErrorText&amp;quot;: null,&lt;br /&gt;
    &amp;quot;IsError&amp;quot;: false,&lt;br /&gt;
    &amp;quot;Message&amp;quot;: &amp;quot;Vybraná data byla smazána.&amp;quot;,&lt;br /&gt;
    &amp;quot;ResponseDatetime&amp;quot;: &amp;quot;/Date(1721030823993+0200)/&amp;quot;,&lt;br /&gt;
    &amp;quot;StatusCode&amp;quot;: &amp;quot;204&amp;quot;&lt;br /&gt;
}&amp;lt;/pre&amp;gt;&lt;br /&gt;
    &amp;lt;/div&amp;gt;&lt;/div&gt;</summary>
		<author><name>Pavelm</name></author>
	</entry>
</feed>