Dla kogo i kiedy
Lista jest dla działu zakupów i IT zakładu, który ma działający system KD, a chce dołożyć moduł BHP i RCP. InnerWeb jest producentem oprogramowania: nie produkuje ani nie wymienia czytników, tylko integruje się z istniejącym systemem KD jako niezależny system uzupełniający obok KD, RCP, HR i ERP.
Szczegółowa specyfikacja integracji karty KD z RCP istnieje jako dokument PDF przekazywany dostawcy zewnętrznemu. Poniższe wymagania są jej skrótem do zapytania ofertowego.
Wymaganie 1: wysyłka odbić webhookiem HTTP POST
Dostawca KD ma wysyłać do InnerWeb żądanie HTTP POST przy każdym odbiciu karty. To najprostsza forma integracji, bo nie wymaga zmian w czytnikach ani w bramach. W zapytaniu warto zapisać, że dostawca potwierdza możliwość takiej wysyłki w obecnej wersji oprogramowania, a nie tylko w przyszłej.
Uzasadnienie: InnerWeb udostępnia API i webhooki do integracji z systemami zakładu, więc po stronie KD wystarczy skonfigurowanie jednego wywołania.
Parametry do wpisania w zapytaniu
Wymaganie 2: uwierzytelnienie tokenem i jego odnawianie
Wywołanie wymaga tokenu z endpointu logowania API. Token ma ograniczony czas ważności i jest odnawiany automatycznie przez integrację. Dostawca powinien potwierdzić, że jego oprogramowanie potrafi automatycznie odnawiać token i ponawiać odrzucone zgłoszenia.
Jeśli oprogramowanie KD nie obsługuje takiego logowania, integracja wymaga warstwy pośredniej, a jej koszt i czas trzeba wycenić w ofercie.
Wymaganie 3: komplet pól i jednolita pisownia
Zgłoszenie powinno zawierać czas zdarzenia, miejsce odbicia, imię i nazwisko, nazwę firmy i numer aktywnej karty, a opcjonalnie akronim, telefon, e-mail i język. Wymagane są imię i nazwisko oraz nazwa firmy.
Zapisz w zapytaniu, że nazwa firmy pochodzi z jednego słownika, bo odbicie osoby nieznanej systemowi zakłada konto i firmę z danych zgłoszenia, a różne pisownie tworzą duplikaty.
Wymaganie 4: wysyłka w czasie rzeczywistym
Wymaganie wobec dostawcy: system KD wysyła zdarzenie w czasie rzeczywistym, z czasem zdarzenia odczytanym z czytnika, kierunkiem (wejście lub wyjście) i identyfikatorem zdarzenia. Po awarii łącza kolejka zaległych zdarzeń jest opróżniana w ustalonym czasie, a zdarzenia zachowują swój pierwotny czas. Warto wpisać dopuszczalne opóźnienie w minutach jako parametr akceptacji.
Wymaganie 5: odporność na serie zdarzeń
W zakładzie z wieloma agencjami pracy ruch kartowy może przekraczać 2 000 odbić na dobę roboczą. Dostawca powinien udokumentować, że jego wysyłka radzi sobie z seriami zdarzeń na początku zmiany i nie powtarza zgłoszeń bez potrzeby. Dzięki identyfikatorowi zdarzenia ponowienie wysyłki nie tworzy duplikatu, a szczegółowe zasady odrzucania duplikatów ustala się w specyfikacji z dostawcą KD.
Wymaganie 6: lista miejsc odbicia i test akceptacyjny
Dostawca przekazuje pełną listę nazw miejsc odbicia (czytników). Zdarzenia z miejsca bez szablonu w InnerWeb trafiają do logu i nie uruchamiają alarmu szkoleniowego, więc kompletna lista jest warunkiem skutecznej kontroli.
Test akceptacyjny powinien obejmować odbicie osoby znanej, osoby nieznanej i osoby z firmy zewnętrznej, w każdym miejscu z listy.
Wymaganie 7: zapis ograniczeń w umowie
Sam webhook bez mapowania na wejścia nie daje RCP: odbicie widoczne w historii konta to jeszcze nie wpis w rejestrze wejść. Dlatego umowa powinna rozdzielać zakres: co robi dostawca KD (wysyłka zdarzeń z czasem, kierunkiem i identyfikatorem), a co ustawia się w InnerWeb (szablony, reguły parowania ustalone w specyfikacji, moduł mRCP włączany przez administratora).
Materiał wideo
Często zadawane pytania
Czy InnerWeb dostarcza czytniki do integracji z KD?
Nie. InnerWeb jest producentem oprogramowania i integruje się z czytnikami, które zakład już ma.
Czy sam webhook zapewnia ewidencję czasu pracy?
Nie. Potrzebne jest mapowanie odbić na wejścia i włączenie modułu mRCP przez administratora.
Kto dostarcza specyfikację integracji?
InnerWeb przekazuje dostawcy KD dokument specyfikacji integracji karty z RCP.
Przygotowujesz zapytanie do dostawcy KD?
Skontaktuj się z InnerWeb, a przekażemy specyfikację integracji i pomożemy sformułować wymagania.
Porozmawiajmy