Rozsah integrace a rozdělení odpovědnosti
InnerWeb nevyrábí ani nevyměňuje čtečky kontroly přístupu. Integruje se se stávajícím systémem KD klienta a přijímá události odbití karty přes webhook podle specifikace pro dodavatele KD. Čtečky, karty a kontroléry zůstávají na straně klienta a jeho integrátora.
InnerWeb je nezávislý systém, který doplňuje stávající systémy klienta: KD, RCP, HR a ERP. V této integraci je zdrojem událostí systém KD a příjemcem modul pracovní doby. Proto poznámky níže dělíme na to, co dělá integrátor, a na to, co dělá InnerWeb.
Pole události ve specifikaci integrace
Specifikace integrace předpokládá, že systém KD posílá události v reálném čase a každá událost nese sedm údajů. InnerWeb je přijímá přes ověřený webhook.
- Čas události: okamžik odbití podle hodin čtečky systému KD.
- Místo: brána nebo čtečka, na které bylo odbití provedeno.
- Údaje o osobě: jednoznačné propojení karty se zaměstnancem.
- Firma: zaměstnavatel osoby, což umožňuje odlišit vlastního zaměstnance od zaměstnance externí firmy.
- Číslo aktivní karty v okamžiku odbití.
- Směr: vstup nebo výstup, vyplývající z konfigurace čtečky.
- Identifikátor události: stálý a jedinečný, neměnný při opětovném odeslání.
Pole události: identifikace odbití a úplnost pro evidenci
Směr a identifikátor události: proč jsou povinné
Každý záznam v evidenci musí být vstupem nebo výstupem a směr z čtečky umožní přítomnost otevřít nebo uzavřít. Identifikátor události chrání před započítáním stejného odbití dvakrát, například při opakovaném odeslání po přerušení spojení.
Pravidla párování vstupů a výstupů a odmítání duplicit se stanoví ve specifikaci s dodavatelem KD, spolu s rozsahem prací na obou stranách integrace. Nepovažujeme je za hotovou funkci k zapnutí, ale za součást implementačního projektu.
Co dělá integrátor KD
Nastavuje směr vyplývající z konfigurace čtečky, například čtečku vstupní a výstupní na téže bráně, a přiřazuje událostem stálé, jedinečné identifikátory, neměnné při opětovném odeslání.
Co se ustaví ve specifikaci
Na straně InnerWeb se stanoví přijímání směru a identifikátoru, odmítání duplicit a mapování události na vstup nebo výstup v evidenci. Rozsah a harmonogram plánujeme s klientem a dodavatelem KD.
Ověření a kontinuita odesílání
Webhook je ověřen tokenem s omezenou dobou platnosti, který integrace obnovuje automaticky. Integrátor zpracuje odpověď o odmítnutí bez ztráty událostí. Doporučujeme frontu na straně systému KD s opakovaným odesláním v původním pořadí a s původním časem odbití z čtečky.
Při přerušení spojení trvajícím hodinu se události odesílají s časem odbití, nikoli s časem odeslání. Evidence počítá minuty, proto je čas události z čtečky základem zápisu.
Pořadí zavedení a testů
Doporučujeme tři kroky, každý s vlastním kritériem dokončení.
- Krok 1: zkušební odeslání událostí z jedné brány a kontrola úplnosti sedmi polí.
- Krok 2: test duplicity a test přerušení spojení se směrem a identifikátorem v každé události.
- Krok 3: zapnutí pro testovací skupinu v pilotu modulu pracovní doby a porovnání se záznamy ze skenů QR.
Co závod získá s úplnou událostí
Závod se systémem KD má dva zdroje přítomnosti: karty a skeny QR. Úplné události odbití mohou napájet evidenci a InnerWeb je propojí s kvalifikacemi, oprávněními a přítomností. Zaměstnavatel vede evidenci pracovní doby zaměstnance jako podklad pro určení mzdy a dalších plnění (zákoník práce, čl. 149 odst. 1), takže jeden jednotný zdroj zápisu omezuje ruční sladění.
Před startem se integrátora zeptejte na tři věci: zda jsou vstupní a výstupní čtečky v konfiguraci kontrolérů rozlišeny, zda systém KD přiděluje událostem trvalé identifikátory a jak dlouho uchovává neodeslané události ve frontě na své straně. Odpovědi zapište do protokolu před zavedením, protože na nich závisí rozsah prací na obou stranách integrace.
Videomateriál
Často kladené otázky
Dodává InnerWeb čtečky karet?
Ne. InnerWeb se integruje se stávajícím systémem KD klienta a čtečky zůstávají na straně klienta a jeho integrátora.
Jaká pole musí mít událost odbití?
Čas události z čtečky, místo, údaje o osobě, firmu, číslo aktivní karty, směr vstup nebo výstup a identifikátor události. Pravidla párování a odmítání duplicit se stanoví ve specifikaci s dodavatelem KD.
Jak je webhook ověřován?
Token má omezenou dobu platnosti a integrace ho obnovuje automaticky. Události čekají ve frontě systému KD, pokud odeslání selže.
Zdroje
Předejte specifikaci integrátorovi KD
Připravíme pro vašeho integrátora popis události a plán integrace. Domluvte rozhovor s týmem InnerWeb.
Pojďme si promluvit