API/attendanceIntervalsBulk POST

Dosys 5.1.3.17

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

Přehled

Endpoint slouží pro hromadné vytvoření přerušení.

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.

Údaj	Typ	Povinné	Popis
Employee	string		Identifikátor zaměstnance. Musí být zadán právě jeden z údajů Employee a EmployeeNumber.
EmployeeNumber	string		Osobní číslo zaměstnance. Musí být zadán právě jeden z údajů Employee a EmployeeNumber.
PassType	string	•	Typ průchodu. Prázdný řetězec znamená pracovní dobu.
Date	date	•	Datum záznamu ve formátu YYYY-MM-DD.
TimeFrom	?time		Nepovinný začátek práce ve formátu HH:MM:SS.
TimeTo	?time		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		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.

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í.

Ú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

Údaj	Typ	Popis
Index	int	Index chybné položky v rámci vstupního pole, číslováno od 0.
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.

Chybová odpověď

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

Ú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

[
  {
    "Employee": "NOVAK",
    "PassType": "",
    "Date": "2026-03-27",
    "TimeFrom": "08:00:00",
    "Length": "08:00:00"
  },
  {
    "EmployeeNumber": "1234",
    "PassType": "VAC",
    "Date": "2026-03-27"
  }
]

Příklad úspěšné odpovědi

{
  "Total": 2,
  "Processed": 1,
  "Errors": [
    {
      "Index": 1,
      "Message": "Employee not found."
    }
  ]
}

Odkazy

API - přehled

Domovská stránka