Pro koho a kdy
Seznam je určen nákupnímu a IT oddělení závodu, který má funkční systém KD a chce přidat modul BOZP a RCP. InnerWeb je výrobce softwaru: nevyrábí ani nevyměňuje čtečky, pouze se integruje se stávajícím systémem KD jako nezávislý doplňkový systém vedle KD, RCP, HR a ERP.
Podrobná specifikace integrace karty KD s RCP existuje jako dokument PDF, který se předává externímu dodavateli. Níže uvedené požadavky jsou jejím výtahem pro poptávku.
Požadavek 1: odesílání přiložení webhookem HTTP POST
Dodavatel KD má posílat do InnerWeb požadavek HTTP POST při každém přiložení karty. Je to nejjednodušší forma integrace, protože nevyžaduje změny čteček ani bran. V poptávce je vhodné zapsat, že dodavatel potvrzuje možnost takového odesílání ve stávající verzi softwaru, nikoli jen v budoucí.
Odůvodnění: InnerWeb nabízí API a webhooky pro integraci se systémy závodu, takže na straně KD stačí nastavit jedno volání.
Parametry k zapsání do poptávky
Požadavek 2: ověření tokenem a jeho obnovování
Volání vyžaduje token z přihlašovacího endpointu API. Token má omezenou dobu platnosti a integrace jej obnovuje automaticky. Dodavatel by měl potvrdit, že jeho software umí token automaticky obnovit a opakovat odmítnuté hlášení.
Pokud software KD takové přihlášení nepodporuje, integrace vyžaduje mezivrstvu a její náklady a čas je třeba ocenit v nabídce.
Požadavek 3: úplná sada polí a jednotný pravopis
Hlášení má obsahovat čas události, místo přiložení, jméno a příjmení, název firmy a číslo aktivní karty, volitelně akronym, telefon, e-mail a jazyk. Povinné jsou jméno a příjmení a název firmy.
V poptávce zapište, že název firmy pochází z jednoho číselníku, protože přiložení osoby neznámé systému založí účet a firmu z údajů v hlášení a různé způsoby zápisu vytvoří duplicity.
Požadavek 4: odesílání v reálném čase
Požadavek vůči dodavateli: systém KD odesílá událost v reálném čase, s časem události přečteným z čtečky, směrem (vstup nebo výstup) a identifikátorem události. Po výpadku linky se fronta zpožděných událostí vyprázdní v dohodnutém čase a události si zachovají původní čas. Je vhodné zapsat přípustné zpoždění v minutách jako parametr přijetí.
Požadavek 5: odolnost vůči sériím událostí
V závodě s více agenturami práce může provoz karet přesáhnout 2 000 přiložení za pracovní den. Dodavatel by měl doložit, že jeho odesílání zvládá série událostí na začátku směny a bez potřeby neopakuje hlášení. Díky identifikátoru události opakované odeslání nevytvoří duplicitu a podrobná pravidla odmítání duplicit se určují ve specifikaci s dodavatelem KD.
Požadavek 6: seznam míst přiložení a akceptační test
Dodavatel předá úplný seznam názvů míst přiložení (čteček). Události z místa bez šablony v InnerWeb se zapíší do logu a nespustí školicí poplach, takže úplný seznam je podmínkou účinné kontroly.
Akceptační test má zahrnovat přiložení známé osoby, neznámé osoby a osoby z externí firmy, a to na každém místě ze seznamu.
Požadavek 7: zápis omezení do smlouvy
Samotný webhook bez mapování na vstupy nedává RCP: přiložení viditelné v historii účtu ještě není zápisem v registru vstupů. Smlouva proto má rozdělit rozsah: co dělá dodavatel KD (odesílání událostí s časem, směrem a identifikátorem) a co se nastavuje v InnerWeb (šablony, pravidla párování určená ve specifikaci, modul mRCP zapínaný administrátorem).
Videomateriál
Často kladené otázky
Dodává InnerWeb čtečky pro integraci s KD?
Ne. InnerWeb je výrobce softwaru a integruje se s čtečkami, které už závod má.
Zajišťuje samotný webhook evidenci pracovní doby?
Ne. Je potřeba mapování přiložení na vstupy a zapnutí modulu mRCP administrátorem.
Kdo dodává specifikaci integrace?
InnerWeb předává dodavateli KD dokument specifikace integrace karty s RCP.
Připravujete poptávku pro dodavatele KD?
Ozvěte se InnerWeb a předáme vám specifikaci integrace a pomůžeme formulovat požadavky.
Pojďme si promluvit