Dosys:API/attendanceIntervalsBulk/POST - Historie editací

Petr.decky: /* Odpověď */

2026-04-26T13:28:23Z

Odpověď

← Starší verze		Verze z 26. 4. 2026, 15:28
Řádek 37:		Řádek 37:

	== Odpověď ==		== Odpověď ==
	Při úspěšném zpracování endpoint vrací HTTP kód '''~~200~~''' a JSON objekt s výsledkem zpracování.		Při úspěšném zpracování endpoint vrací HTTP kód '''201''' a JSON objekt s výsledkem zpracování.

	{\| class="wikitable"		{\| class="wikitable"

Petr.decky: /* Položka Errors */

2026-04-26T13:26:48Z

Položka Errors

← Starší verze		Verze z 26. 4. 2026, 15:26
Řádek 55:		Řádek 55:
	\| Index \|\| int \|\| Index chybné položky v rámci vstupního pole, číslováno od 0.		\| Index \|\| int \|\| Index chybné položky v rámci vstupního pole, číslováno od 0.
	\|-		\|-
	\| Code \|\| string \|\| Kód chyby, hodonoty REJECTED ~~(zamítnuto~~- .přístupová práva, zákaz na úrovní pracovní doby), CONFLICT (pro daný den už existuje docházka), ERROR ~~(chybná data)~~		\| Code \|\| string \|\| Kód chyby, hodonoty
			* REJECTED - přístupová práva, zákaz na úrovní pracovní doby
			* CONFLICT - pro daný den už existuje docházka
			* ERROR - jiná chyba
	\|-		\|-
	\| Message \|\| string \|\| Text chyby.		\| Message \|\| string \|\| Text chyby.

Petr.decky: /* Odpověď */

2026-04-26T13:26:04Z

Odpověď

← Starší verze		Verze z 26. 4. 2026, 15:26
Řádek 37:		Řádek 37:

	== Odpověď ==		== Odpověď ==
	Při úspěšném zpracování endpoint vrací HTTP kód '''~~201~~''' a JSON objekt s výsledkem zpracování.		Při úspěšném zpracování endpoint vrací HTTP kód '''200''' a JSON objekt s výsledkem zpracování.

	{\| class="wikitable"		{\| class="wikitable"
Řádek 54:		Řádek 54:
	\|-		\|-
	\| Index \|\| int \|\| Index chybné položky v rámci vstupního pole, číslováno od 0.		\| Index \|\| int \|\| Index chybné položky v rámci vstupního pole, číslováno od 0.
			\|-
			\| Code \|\| string \|\| Kód chyby, hodonoty REJECTED (zamítnuto- .přístupová práva, zákaz na úrovní pracovní doby), CONFLICT (pro daný den už existuje docházka), ERROR (chybná data)
	\|-		\|-
	\| Message \|\| string \|\| Text chyby.		\| Message \|\| string \|\| Text chyby.

Petr.decky: /* Příklad požadavku */

2026-03-27T15:58:43Z

Příklad požadavku

← Starší verze		Verze z 27. 3. 2026, 17:58
Řádek 76:		Řádek 76:
	"PassType": "",		"PassType": "",
	"Date": "2026-03-27",		"Date": "2026-03-27",
	"TimeFrom": ~~28800~~,		"TimeFrom": "08:00:00",
	"Length": ~~28800~~		"Length": "08:00:00"
	},		},
	{		{

Petr.decky: /* Zpracování */

2026-03-27T15:57:55Z

Zpracování

← Starší verze		Verze z 27. 3. 2026, 17:57
Řádek 23:		Řádek 23:
	\| Date \|\| date \|\| align="center" \| • \|\| Datum záznamu ve formátu YYYY-MM-DD.		\| Date \|\| date \|\| align="center" \| • \|\| Datum záznamu ve formátu YYYY-MM-DD.
	\|-		\|-
	\| TimeFrom \|\| ?time \|\| align="center" \| \|\| Nepovinný začátek práce ~~v sekundách~~.		\| TimeFrom \|\| ?time \|\| align="center" \| \|\| Nepovinný začátek práce ve formátu HH:MM:SS.
	\|-		\|-
	\| TimeTo \|\| ?time \|\| align="center" \| \|\| Nepovinný konec práce ~~v sekundách~~. Lze zadat pouze tehdy, je-li zadáno ''TimeFrom'', a zároveň nesmí být zadán údaj ''Length''.		\| TimeTo \|\| ?time \|\| align="center" \| \|\| Nepovinný konec práce ve formátu HH:MM:SS. Lze zadat pouze tehdy, je-li zadáno ''TimeFrom'', a zároveň nesmí být zadán údaj ''Length''.
	\|-		\|-
	\| Length \|\| ?time \|\| align="center" \| \|\| Nepovinná délka práce ~~v sekundách~~. Lze zadat pouze tehdy, je-li zadáno ''TimeFrom'', a zároveň nesmí být zadán údaj ''TimeTo''.		\| Length \|\| ?time \|\| align="center" \| \|\| Nepovinná délka práce ve formátu H:MM:SS. Lze zadat pouze tehdy, je-li zadáno ''TimeFrom'', a zároveň nesmí být zadán údaj ''TimeTo''.
	\|}		\|}

Petr.decky: /* Oprávnění */

2026-03-27T15:56:15Z

Oprávnění

← Starší verze		Verze z 27. 3. 2026, 17:56
Řádek 7:		Řádek 7:
	== Přehled ==		== Přehled ==
	Endpoint slouží pro hromadné vytvoření přerušení.		Endpoint slouží pro hromadné vytvoření přerušení.

	~~== Oprávnění ==~~
	~~Pro volání endpointu je vyžadováno oprávnění pro zápis do API ''api/attendance/intervals''.~~

	== Zpracování ==		== Zpracování ==

Petr.decky: /* Přehled */

2026-03-27T15:55:36Z

Přehled

← Starší verze		Verze z 27. 3. 2026, 17:55
Řádek 6:		Řádek 6:

	== Přehled ==		== Přehled ==
	Endpoint slouží pro hromadné vytvoření ~~intervalů docházky~~.		Endpoint slouží pro hromadné vytvoření přerušení.

	== Oprávnění ==		== Oprávnění ==

Petr.decky: založena nová stránka s textem „{{DISPLAYTITLE:API/attendanceIntervalsBulk POST}} {{VERSIONINFO|Dosys|5.1.3.17}}

 POST [url docházky]?doc=api/attendanceIntervalsBulk

== Přehled == Endpoint slouží pro hromadné vytvoření intervalů docházky. == Oprávnění == Pro volání endpointu je vyžadováno oprávnění pro zápis do API ''api/attendance/intervals''. == Zpracování == Data intervalů se předávají jako tělo zprávy POST ve formátu JSON pole objektů…“

2026-03-27T15:55:00Z

založena nová stránka s textem „{{DISPLAYTITLE:API/attendanceIntervalsBulk POST}} {{VERSIONINFO|Dosys|5.1.3.17}} <pre> POST [url docházky]?doc=api/attendanceIntervalsBulk </pre> == Přehled == Endpoint slouží pro hromadné vytvoření intervalů docházky. == Oprávnění == Pro volání endpointu je vyžadováno oprávnění pro zápis do API ''api/attendance/intervals''. == Zpracování == Data intervalů se předávají jako tělo zprávy POST ve formátu JSON pole objektů…“

Nová stránka

{{DISPLAYTITLE:API/attendanceIntervalsBulk POST}}
{{VERSIONINFO|Dosys|5.1.3.17}}
<pre>
POST [url docházky]?doc=api/attendanceIntervalsBulk
</pre>

== Přehled ==
Endpoint slouží pro hromadné vytvoření intervalů docházky.

== Oprávnění ==
Pro volání endpointu je vyžadováno oprávnění pro zápis do API ''api/attendance/intervals''.

== Zpracování ==
Data intervalů se předávají jako tělo zprávy POST ve formátu JSON pole objektů.
Každá položka pole reprezentuje jeden interval docházky.

{| class="wikitable"
! Údaj !! Typ !! Povinné !! Popis
|-
| Employee || string || align="center" | || Identifikátor zaměstnance. Musí být zadán právě jeden z údajů ''Employee'' a ''EmployeeNumber''.
|-
| EmployeeNumber || string || align="center" | || Osobní číslo zaměstnance. Musí být zadán právě jeden z údajů ''Employee'' a ''EmployeeNumber''.
|-
| PassType || string || align="center" | • || Typ průchodu. Prázdný řetězec znamená pracovní dobu.
|-
| Date || date || align="center" | • || Datum záznamu ve formátu YYYY-MM-DD.
|-
| TimeFrom || ?time || align="center" | || Nepovinný začátek práce v sekundách.
|-
| TimeTo || ?time || align="center" | || Nepovinný konec práce v sekundách. Lze zadat pouze tehdy, je-li zadáno ''TimeFrom'', a zároveň nesmí být zadán údaj ''Length''.
|-
| Length || ?time || align="center" | || Nepovinná délka práce v sekundách. Lze zadat pouze tehdy, je-li zadáno ''TimeFrom'', a zároveň nesmí být zadán údaj ''TimeTo''.
|}

=== Validační pravidla ===
* Musí být zadán právě jeden z údajů ''Employee'' a ''EmployeeNumber''.
* Pokud je zadán údaj ''TimeFrom'', musí být zadán právě jeden z údajů ''TimeTo'' a ''Length''.
* Pokud zaměstnanec podle zadaného identifikátoru neexistuje, položka je vrácena mezi chybami.
* Pokud se pro danou položku nepodaří vygenerovat žádný interval, položka je přeskočena a vrácena mezi chybami.

== Odpověď ==
Při úspěšném zpracování endpoint vrací HTTP kód '''201''' a JSON objekt s výsledkem zpracování.

{| class="wikitable"
! Údaj !! Typ !! Popis
|-
| Total || int || Celkový počet položek v požadavku.
|-
| Processed || int || Počet úspěšně zpracovaných položek.
|-
| Errors || array || Seznam chyb pro nezpracované položky.
|}

=== Položka Errors ===
{| class="wikitable"
! Údaj !! Typ !! Popis
|-
| Index || int || Index chybné položky v rámci vstupního pole, číslováno od 0.
|-
| Message || string || Text chyby.
|}

== Chybová odpověď ==
Při chybě zpracování celého požadavku endpoint vrací HTTP kód '''400''' a JSON objekt:

{| class="wikitable"
! Údaj !! Typ !! Popis
|-
| Message || string || Popis chyby.
|}

Při nedostatečném oprávnění endpoint vrací HTTP kód '''403'''.

== Příklad požadavku ==
<pre>
[
{
"Employee": "NOVAK",
"PassType": "",
"Date": "2026-03-27",
"TimeFrom": 28800,
"Length": 28800
},
{
"EmployeeNumber": "1234",
"PassType": "VAC",
"Date": "2026-03-27"
}
]
</pre>

== Příklad úspěšné odpovědi ==
<pre>
{
"Total": 2,
"Processed": 1,
"Errors": [
{
"Index": 1,
"Message": "Employee not found."
}
]
}
</pre>

== Odkazy ==
[[{{NAMESPACE}}:API|API - přehled]]

[[{{NAMESPACE}}:Domovská stránka|Domovská stránka]]