InnerWeb
Przejdź do treści

Odbicia kart z KD do RCP bez nowych czytników: przypadek zakładu produkcyjnego

Zakład produkcyjny miał działający system kontroli dostępu i chciał, aby ewidencja czasu pracy korzystała z tych samych odbić kart. Nie kupowano nowych czytników. Zamiast tego dostawca KD dostał specyfikację zdarzenia odbicia, a InnerWeb przyjął je jako wejście do RCP i do pozostałych funkcji.

12 godzin
ważność tokenu JWT konta technicznego
Źródło: specyfikacja integracji odbić kart
6 grup
podział osób na liście ewakuacyjnej
Źródło: opis funkcji listy ewakuacyjnej

Punkt wyjścia: karty już są, czytników nie zmieniamy

Producent opakowań z tektury falistej, z zakładem w Polsce i centralą za granicą, używał kart w systemie kontroli dostępu. Dział IT nie chciał wymieniać czytników ani dokładać drugiego zestawu do rejestracji czasu pracy. Pytanie brzmiało: czy da się użyć zdarzeń, które KD już zbiera?

InnerWeb jest producentem oprogramowania i nie produkuje ani nie wymienia czytników kontroli dostępu. Integruje się z istniejącym systemem KD klienta. To założenie uprościło rozmowę: nie ma wyboru sprzętu, jest wyłącznie uzgodnienie formatu danych między dwoma systemami.

Specyfikacja dla dostawcy KD: co ma wysłać kontroler

Dostawca KD otrzymał specyfikację zdarzenia odbicia. To on konfiguruje po swojej stronie wysyłkę, bo zna swoje kontrolery i zasady nazewnictwa czytników. Po stronie InnerWeb zdarzenie przyjmuje webhook z uwierzytelnieniem kontem technicznym.

Specyfikacja obejmuje te pola i zasady:

  • token JWT ważny 12 godzin, wystawiany dla konta technicznego,
  • czas odbicia zgłoszony przez kontroler,
  • identyfikator czytnika i osoba, której dotyczy odbicie,
  • numer karty w postaci kod_obiektu-numer,
  • opcjonalnie kierunek przejścia i identyfikator zdarzenia.

Liczba pól zdarzenia odbicia: wymagane i opcjonalne

Liczba pól zdarzenia odbicia: wymagane i opcjonalneZdarzenie odbicia ma cztery pola wymagane i dwa opcjonalne.01234pólWymagane (czas, czytnik,osoba, numer karty)Wymagane (czas, czytnik, osoba, numer karty): 4 pól4Opcjonalne (kierunek,identyfikator zdarzenia)Opcjonalne (kierunek, identyfikator zdarzenia): 2 pól2
Źródło: Specyfikacja zdarzenia odbicia karty z systemu KD

Idempotencja: dlaczego identyfikator zdarzenia ma znaczenie

Kontrolery KD wysyłają zdarzenia ponownie, gdy łączność zawiedzie lub potwierdzenie nie dotrze. Bez identyfikatora zdarzenia każda retransmisja stałaby się kolejnym odbiciem, a ewidencja pokazałaby podwójne wejście o tej samej godzinie. Opcjonalny identyfikator zdarzenia pozwala odrzucić powtórkę bez skutków ubocznych.

Dlatego w uzgodnieniach z dostawcą KD warto wpisać identyfikator zdarzenia jako pole zalecane, nawet jeśli specyfikacja traktuje go jako opcjonalne. Koszt po stronie dostawcy jest niski, a oszczędza się godzin porządkowania danych po miesiącu pracy.

Co RCP robi z odbiciem karty

Skany z bramy, używane także do listy ewakuacyjnej, tworzą ewidencję czasu pracy. Widoki dzienne, miesięczne i roczne, kolejki wyjątków, zamykanie okresu i telefony przypominające o niezeskanowanym wyjściu działają na tych samych danych. Moduł ewidencji jest domyślnie wyłączony i włącza się go świadomie, po uzgodnieniu zasad z działem kadr.

Lista ewakuacyjna powstaje ze skanów na bramie, odświeża się co 13 sekund i dzieli osoby na sześć grup: goście, kurierzy, dostawcy, pracownicy zakładu, firmy zewnętrzne i niepewne. Jedno odbicie służy więc dwóm celom: czasowi pracy i bezpieczeństwu.

Pozostałe elementy wzorca wdrożenia

Integracja odbić była jednym z elementów szerszego wzorca. Zakład wdrożył też rejestrację gości telefonem, oświadczenie zdrowotne przy wejściu (wymóg BRCGS), instruktaż wideo BHP w wersjach językowych i zlecenie druku etykiet QR. Karty pracowników obsługuje KD, a goście wchodzą z kodem QR.

Taki podział ma praktyczną zaletę: wymiana lub rozbudowa KD nie zatrzymuje rejestracji gości, a zmiana procesu gościnnego nie wymaga ingerencji w kontrolery.

Wnioski dla działu IT

Po pierwsze, zacznij od specyfikacji, nie od sprzętu: jedno krótkie zdarzenie z sześcioma polami wystarcza na start. Po drugie, uzgodnij z dostawcą KD, kto monitoruje wysyłkę i co się dzieje przy awarii łącza. Po trzecie, przetestuj retransmisję: wyślij to samo zdarzenie dwa razy i sprawdź, że ewidencja pokazuje jedno odbicie.

Zakres integracji najlepiej zamknąć w pilotażu na jednej bramie lub hali, a dopiero potem rozszerzać na kolejne czytniki.

Materiał wideo

Często zadawane pytania

Czy InnerWeb wymienia czytniki w systemie KD?

Nie. InnerWeb nie produkuje ani nie wymienia czytników. Integruje się z istniejącym KD, a dostawca KD otrzymuje specyfikację zdarzenia odbicia.

Jak uwierzytelnia się wysyłka z KD?

Kontem technicznym i tokenem JWT ważnym 12 godzin. Dostawca KD odnawia token zgodnie ze specyfikacją.

Co z powtórzonymi zdarzeniami?

Gdy zdarzenie ma identyfikator, powtórka jest rozpoznawana i nie tworzy drugiego odbicia. Dlatego zalecamy wysyłanie identyfikatora zawsze.

Czy moduł RCP jest włączony od razu?

Nie. Moduł ewidencji czasu pracy jest domyślnie wyłączony i włącza się go po uzgodnieniu zasad z kadrami.

Masz KD i chcesz RCP bez nowych czytników?

Przygotujemy specyfikację odbić dla Twojego dostawcy KD. Umów krótką rozmowę z działem IT.

Porozmawiajmy