InnerWeb
Przejdź do treści

Odbicia kart z KD do RCP: wymagane pola zdarzenia i uwagi wdrożeniowe

Do ewidencji czasu pracy potrzeba od systemu KD siedmiu informacji w każdym zdarzeniu odbicia karty, w tym kierunku wejście lub wyjście i identyfikatora zdarzenia. Ten materiał jest przeznaczony dla integratora systemu KD i opisuje wymagania specyfikacji, podział zadań i kolejność wdrażania.

7
pól zdarzenia w specyfikacji integracji
Źródło: specyfikacja integracji
3
kroki wdrożenia i testów
Źródło: plan wdrożenia InnerWeb

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

Pola zdarzenia: identyfikacja odbicia i komplet dla ewidencjiWykres: 5 pól identyfikujących odbicie i 7 pól kompletu dla ewidencji czasu pracy.02468polaIdentyfikacja odbiciaIdentyfikacja odbicia: 5 pola5Komplet dla ewidencjiKomplet dla ewidencji: 7 pola7
Źródło: Specyfikacja zdarzenia odbicia; różnica to kierunek i identyfikator zdarzenia

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