InnerWeb
Přejít na obsah

Poptávka na karty a čtečky: integrační požadavky KD

Nákup a IT, které se ptají na ceny karet a čteček, často opomenou integraci s RCP a později platí za její doplnění mimo nabídku. Níže jsou požadavky, které stojí za zápis do poptávky, aby se po výměně zachovala evidence pracovní doby a reporty.

12 h
platnost tokenu JWT integrace
Zdroj: specifikace integrace
13 h
limit párování vstupu s výstupem
Zdroj: specifikace integrace

Proč integrační požadavky do poptávky

Poptávka na karty a čtečky obvykle popisuje technologii: typ karty, protokol čtečky, počet kusů. Méně často popisuje, co se děje s odbitím na straně serveru. Pokud závod eviduje pracovní dobu z odbití, chybějící popis znamená riziko, že se po výměně přestanou reporty shodovat.

InnerWeb je výrobcem softwaru a čtečky nedodává. Přijímá události odbití ze systému KD a spojuje je s dny práce. Níže uvedené požadavky slouží tomu, aby dodavatel KD mohl tyto události předávat bez dalších jednání.

Doporučení 1: HTTPS POST ze serveru KD

Zapište požadavek, aby server systému KD při každém odbití odeslal zprávu HTTPS POST na určenou adresu. Díky tomu není nutné otevírat příchozí porty v síti závodu, protože provoz je odchozí. Dodavatel by měl v nabídce potvrdit, zda jeho server takovou zprávu odesílá.

Autentizace integrace probíhá technickým účtem a tokenem JWT platným 12 hodin, proto je v poptávce vhodné uvést, že na straně dodavatele je třeba token obnovovat.

Technické limity integrace odbití

Technické limity integrace odbitíVodorovný graf: token platný 12 hodin, limit párování 13 hodin051015hodinPlatnost tokenu JWTPlatnost tokenu JWT: 12 hodin12Párování vstupu s výstupemPárování vstupu s výstupem: 13 hodin13
Zdroj: Specifikace integrace odbití ze systému KD

Doporučení 2: obsah zprávy

Zpráva má obsahovat čas odbití z kontroléru, identifikátor čtečky, osobu, číslo karty ve tvaru kód_objektu-číslo a volitelně směr a identifikátor události. Čas z kontroléru je důležitý, protože fronta při výpadku spojení zpoždění odeslání.

Identifikátor události (idempotence) a čas z kontroléru chrání dny práce před zkreslením opakovaným odesláním. Zapište tento bod do poptávky jako požadavek, nebo jako odchylku vyžadující zdůvodnění, pokud ji dodavatel nezajistí.

Doporučení 3: směr vstupu a výstupu

Požádejte o uvedení, zda systém směr předává. Pokud ho nepředává, InnerWeb paruje vstup s výstupem v softwaru s limitem 13 hodin mezi vstupem a výstupem. Funguje to správně, ale vyžaduje popis čteček: samostatné čtečky pro vstup a výstup zapisujeme do slovníku čteček.

Doporučení 4: export karet a seznam čteček

K ujasnění s dodavatelem KD před integrací: zda jeho server posílá HTTPS POST, seznam čteček a export karet (kód objektu a číslo) k osobnímu číslu. Zapište to jako přílohu smlouvy: export karet ve formátu CSV s kódem objektu, číslem a osobním číslem.

Karty lze přiřadit k osobám importem CSV, takže export od dodavatele je palivem celého procesu. Bez exportu znamená přiřazování ruční práci a zpoždění harmonogramu.

Doporučení 5: co nabídka vylučuje a co zůstává na straně závodu

Zapište do poptávky, že logika KD zůstává beze změny: dodavatel nepřebírá počítání dnů práce, směnové plány, výjimky ani reporty. Veškeré zpracování (rozpoznání vstupu a výstupu, sdružování do dnů práce, směny, výjimky, reporty) probíhá na straně InnerWeb.

Zapište také náklady mimo rozsah softwaru: čtečka QR kódů na portýrně stojí řádově tisíce korun netto za zařízení a je mimo nabídku InnerWeb (orientační rozpětí z realizací 2025–2026; individuální ocenění). Dodavatel by měl uvést jednotkové ceny karet a čteček zvlášť.

Doporučení 6: neznámé karty a důkaz přejímky

Přidejte kritérium přejímky: seznam odbití neznámých karet po výměně má být prázdný nebo vysvětlený. Odbití neznámé karty končí ve frontě „karta k přiřazení“, místo aby se zakládal účet z neznámého odbití, a je tak hotovým měřítkem.

Videomateriál

Často kladené otázky

Musí poptávka uvádět InnerWeb?

Ne. Stačí popis požadavků: HTTPS POST, obsah zprávy, export karet. Dodavatel KD je splní bez ohledu na jméno příjemce.

Je nutné otevírat porty v síti závodu?

Ne. Server KD odesílá zprávu HTTPS POST, takže provoz je odchozí.

Kdo počítá dny práce?

InnerWeb na straně softwaru. Logika KD zůstává beze změny.

Zdroje

Doplňte integrační požadavky do poptávky

Předáme specifikaci odbití pro dodavatele KD a ověříme, zda nabídka pokrývá potřeby RCP. Domluvte si schůzku s InnerWeb.

Pojďme si promluvit