InnerWeb
Przejdź do treści

Integracja odbić kart KD z RCP: specyfikacja

InnerWeb nie dostarcza czytników ani kart. Odbicia kart przyjmuje z systemu KD klienta przez webhook i łączy z czasem pracy oraz listą ewakuacyjną. Poniżej wskazujemy, co dostawca KD ma przekazać i co przed startem sprawdzi dział IT.

13 s
odświeżanie listy ewakuacyjnej
6
grup na liście ewakuacyjnej

Zakres integracji i jej granice

InnerWeb nie dostarcza czytników ani kart kontroli dostępu. Odbicia kart przyjmuje z systemu KD klienta (webhook) i łączy je z kwalifikacjami, zezwoleniami, obecnością i rejestracją czasu pracy, a dostawcy KD przekazuje specyfikację integracji. Klient nie wymienia więc czytników ani kart, a istniejąca infrastruktura zostaje na miejscu.

Granica odpowiedzialności jest prosta. Dostawca KD odpowiada za czytniki, karty i wysyłkę zdarzenia, a InnerWeb za odbiór, dopasowanie osoby i zapis w ewidencji. Kto ma problem z brakiem odbicia, najpierw sprawdza, czy zdarzenie opuściło system KD.

Co dostawca KD ma przekazać

Specyfikacja dla dostawcy KD opisuje minimalny zestaw danych zdarzenia. Zdarzenie musi jednoznacznie wskazywać osobę, moment odbicia i kierunek przejścia, bo na tej podstawie powstaje wejście i wyjście w ewidencji. Dokładny format pól jest ustalany ze specyfikacji integracji, a poniżej opisujemy logikę, którą IT powinien sprawdzić.

Zdarzenia wysyłane są po webhooku, więc dostawca KD musi zapewnić ponawianie wysyłki przy niedostępności odbiorcy oraz stałą identyfikację osoby, na przykład numerem ewidencyjnym zgodnym z kontem w InnerWeb.

  • Identyfikator osoby zgodny z numerem ewidencyjnym konta.
  • Moment odbicia z jednoznaczną strefą czasową.
  • Kierunek przejścia: wejście albo wyjście.
  • Identyfikator bramki lub strefy, jeśli ma wpływać na listę ewakuacyjną.
  • Ponawianie wysyłki przy braku odpowiedzi odbiorcy.

Co robi InnerWeb z odbiciem

Skany z bramy, używane też do listy ewakuacyjnej, tworzą ewidencję czasu pracy w module mRCP: widoki dzienne, miesięczne i roczne, konsolę zespołu dla przełożonego, kolejki wyjątków, zamykanie okresu i karty czasu w PDF. Moduł jest domyślnie wyłączony i włączany ustawieniem, więc integracja odbić jest osobną decyzją od uruchomienia samego modułu.

Lista ewakuacyjna odświeża się co 13 sekund, powstaje ze skanów na bramie i dzieli osoby na sześć grup: goście, kurierzy, dostawcy, pracownicy zakładu, firmy zewnętrzne z zakładkami per firma oraz grupa niepewna. Wydruk to jedna strona na grupę, aby dowódca rozdał kartki koordynatorom w punkcie zbiórki.

Asymetria błędu na liście ewakuacyjnej

Lista jest projektowana pod asymetrię błędu: osoba wpisana mimo wyjścia kosztuje zbędne poszukiwanie, a osoba pominięta to ktoś, kogo nikt nie szuka. W razie wątpliwości lista pokazuje więcej osób, nie mniej. Dla integracji oznacza to, że brakujące odbicie wyjścia nie usuwa osoby z listy, więc dostawca KD powinien dbać o kompletność zdarzeń wyjścia, żeby lista nie rosła niepotrzebnie.

Co sprawdzi dział IT przed startem

Dział IT powinien zweryfikować pięć rzeczy: osiągalność adresu odbiorcy z sieci KD, zgodność identyfikatorów osób, strefę czasową zdarzeń, zachowanie przy ponawianiu oraz kompletność wyjść. Każdą z nich da się sprawdzić na próbnej grupie osób przed włączeniem integracji dla całego zakładu.

Test warto prowadzić na kilku osobach z różnych grup i przejść pełen cykl: wejście, wyjście, wejście bez wyjścia i próba duplikatu zdarzenia. Wynik porównuje się z widokiem dziennym ewidencji i z listą ewakuacyjną.

Pułapki i rozdział odpowiedzialności

Pierwsza pułapka: różnica stref czasowych. Zdarzenie zapisane w UTC i odczytane jako czas lokalny przesuwa wejście o godzinę lub dwie i fałszuje czas pracy. Druga: identyfikator osoby w KD inny niż w InnerWeb, co kończy się grupą niepewną. Trzecia: brak ponawiania, przez który zdarzenia z okresu niedostępności odbiorcy giną.

Wszystkie trzy da się wykryć testem przed startem. Dostawca KD powinien dostać listę kontrolną jako załącznik do specyfikacji, a zakład powinien zapisać wyniki testu w dokumentacji wdrożenia.

Lista kontrolna

Materiał wideo

Często zadawane pytania

Czy trzeba wymieniać czytniki KD?

Nie. InnerWeb nie dostarcza czytników ani kart, a odbicia przyjmuje z istniejącego systemu KD klienta.

Co z osobą, której nie ma wyjścia w KD?

Lista ewakuacyjna jest projektowana pod asymetrię błędu: w razie wątpliwości pokazuje więcej osób, nie mniej.

Czy mRCP włącza się samo?

Nie. Moduł jest domyślnie wyłączony i włączany ustawieniem.

Porozmawiajmy o integracji z Waszym KD

Przekażemy dostawcy systemu KD specyfikację integracji i przejdziemy z działem IT przez test przed startem. Umów rozmowę z zespołem InnerWeb.

Porozmawiajmy