Zakres integracji i podział odpowiedzialności
InnerWeb nie produkuje ani nie wymienia czytników kontroli dostępu. Integruje się z istniejącym systemem KD klienta i przyjmuje zdarzenia odbicia karty przez webhook, według specyfikacji dla dostawcy KD. Czytniki, karty i kontrolery zostają po stronie klienta i jego integratora.
InnerWeb jest niezależnym systemem uzupełniającym istniejące systemy klienta: KD, RCP, HR i ERP. W tej integracji to system KD jest źródłem zdarzeń, a moduł czasu pracy ich odbiorcą. Dlatego uwagi poniżej dzielimy na to, co robi integrator, i to, co robi InnerWeb.
Pola zdarzenia w specyfikacji integracji
Specyfikacja integracji zakłada, że system KD wysyła zdarzenia w czasie rzeczywistym, w każdym zdarzeniu z siedmioma informacjami. InnerWeb przyjmuje je przez uwierzytelniony webhook.
- Czas zdarzenia: moment odbicia według zegara czytnika systemu KD.
- Miejsce: bramka lub czytnik, na którym wykonano odbicie.
- Dane osoby: jednoznaczne powiązanie karty z pracownikiem.
- Firma: pracodawca osoby, co pozwala odróżnić pracownika własnego od firmy zewnętrznej.
- Numer aktywnej karty w chwili odbicia.
- Kierunek: wejście albo wyjście, wynikające z konfiguracji czytnika.
- Identyfikator zdarzenia: stały i unikalny, niezmienny przy ponownej wysyłce.
Pola zdarzenia: identyfikacja odbicia i komplet dla ewidencji
Kierunek i identyfikator zdarzenia: dlaczego są wymagane
Dla ewidencji każdy zapis musi być wejściem albo wyjściem, a kierunek z czytnika pozwala otworzyć lub zamknąć obecność. Identyfikator zdarzenia chroni przed policzeniem tego samego odbicia dwa razy, na przykład przy ponownej wysyłce po przerwie w łączu.
Zasady parowania wejść i wyjść oraz odrzucania duplikatów ustala się w specyfikacji z dostawcą KD, razem z zakresem prac po obu stronach integracji. Nie traktujemy ich jako gotowej funkcji do włączenia, tylko jako element projektu wdrożeniowego.
Co robi integrator KD
Konfiguruje kierunek wynikający z ustawienia czytnika, na przykład czytnik wejściowy i wyjściowy na tej samej bramie, oraz nadaje zdarzeniom stałe, unikalne identyfikatory, niezmienne przy ponownej wysyłce.
Co ustala się w specyfikacji
Po stronie InnerWeb ustala się przyjmowanie kierunku i identyfikatora, odrzucanie duplikatów oraz mapowanie zdarzenia na wejście lub wyjście w ewidencji. Zakres i harmonogram planujemy z klientem i dostawcą KD.
Uwierzytelnienie i ciągłość wysyłki
Webhook jest uwierzytelniony tokenem o ograniczonym czasie ważności, odnawianym automatycznie przez integrację. Integrator obsługuje odpowiedź odmowną bez gubienia zdarzeń. Rekomendujemy kolejkę po stronie systemu KD, z ponowną wysyłką w oryginalnej kolejności i z oryginalnym czasem odbicia z czytnika.
Przy przerwie w łączu trwającej godzinę zdarzenia wysyła się z czasem odbicia, a nie z czasem wysyłki. Ewidencja liczy minuty, więc czas zdarzenia z czytnika jest podstawą zapisu.
Kolejność wdrożenia i testów
Rekomendujemy trzy kroki, każdy z odrębnym kryterium zakończenia.
- Krok 1: wysyłka próbna zdarzeń z jednej bramki, sprawdzenie kompletności siedmiu pól.
- Krok 2: test duplikatu i test przerwy w łączu z kierunkiem i identyfikatorem w każdym zdarzeniu.
- Krok 3: włączenie dla grupy testowej w pilocie modułu czasu pracy i porównanie z zapisami ze skanów QR.
Co zyskuje zakład z kompletnym zdarzeniem
Zakład z systemem KD ma dwa źródła obecności: karty i skany QR. Kompletne zdarzenia odbicia mogą zasilać ewidencję, a InnerWeb łączy je z kwalifikacjami, zezwoleniami i obecnością. Pracodawca prowadzi ewidencję czasu pracy pracownika jako podstawę ustalenia wynagrodzenia i innych świadczeń (Kodeks pracy art. 149 § 1), więc jedno spójne źródło zapisu ogranicza ręczne uzgadnianie.
Przed startem zapytajcie integratora o trzy rzeczy: czy czytniki wejściowe i wyjściowe są rozróżnione w konfiguracji kontrolerów, czy system KD nadaje zdarzeniom trwałe identyfikatory oraz jak długo przechowuje nieodebrane zdarzenia po stronie kolejki. Odpowiedzi warto zapisać w protokole przedwdrożeniowym, bo od nich zależy zakres prac po obu stronach integracji.
Materiał wideo
Często zadawane pytania
Czy InnerWeb dostarcza czytniki kart?
Nie. InnerWeb integruje się z istniejącym systemem KD klienta, a czytniki pozostają po stronie klienta i jego integratora.
Jakie pola musi mieć zdarzenie odbicia?
Czas zdarzenia z czytnika, miejsce, dane osoby, firmę, numer aktywnej karty, kierunek wejście lub wyjście oraz identyfikator zdarzenia. Zasady parowania i odrzucania duplikatów ustala się w specyfikacji z dostawcą KD.
Jak uwierzytelniany jest webhook?
Token ma ograniczony czas ważności i jest odnawiany automatycznie przez integrację, a zdarzenia czekają w kolejce systemu KD, jeśli wysyłka się nie powiedzie.
Źródła
Przekaż specyfikację integratorowi KD
Przygotujemy dla Waszego integratora opis zdarzenia i plan wdrożenia integracji. Umów rozmowę z zespołem InnerWeb.
Porozmawiajmy