InnerWeb
Przejdź do treści

Webhook odbicia karty: pola zgłoszenia z KD

Dostawca systemu kontroli dostępu, który wysyła odbicia do InnerWeb, powinien w każdym zgłoszeniu przekazać czas zdarzenia, miejsce odbicia oraz dane osoby i firmy. Dwa pola są wymagane, a pozostałe decydują o jakości powiązania karty z kontem. Poniżej siedem zaleceń dla integratora, każde z uzasadnieniem.

2
pola wymagane: imię i nazwisko oraz nazwa firmy
3
cechy każdego zdarzenia: czas z czytnika, kierunek, identyfikator
Źródło: specyfikacja integracji

Dla kogo jest ta lista

Lista jest przeznaczona dla integratora albo administratora systemu KD, który buduje wysyłkę odbić do InnerWeb. Zakłada, że czytniki zostają bez zmian, a zmiana dotyczy wyłącznie tego, co system KD wysyła po każdym odbiciu karty.

InnerWeb nie produkuje czytników i nie wymienia ich, więc cała jakość integracji zależy od danych w zgłoszeniu. Zalecenia poniżej wynikają z wymagań specyfikacji integracji, w której InnerWeb przyjmuje i łączy zdarzenia z KD.

Zalecenie 1: zawsze wysyłaj numer aktywnej karty

Numer aktywnej karty jest identyfikatorem, po którym InnerWeb łączy odbicie z kontem osoby. Bez niego system musi opierać się na imieniu i nazwisku, co zwiększa ryzyko pomyłki przy osobach o tych samych danych.

Uzasadnienie dla zakupów i IT: pole numeru karty jest kluczem do sprawdzenia szkolenia BHP zanim brama przepuści osobę. Karta zezwolenia, kwalifikacje i szkolenia są powiązane z kontem osoby, a numer karty z KD staje się kluczem do tego konta.

Pola zgłoszenia według kategorii

Pola zgłoszenia według kategoriiPodział pól zgłoszenia: 2 wymagane, 3 identyfikacyjne i kontekstowe, 3 kontaktowe i językowe.Wymagane: 2 pola (25%)Identyfikacja i kontekst: 3 pola (37,5%)Kontakt i język: 3 pola (37,5%)8polaWymagane2 pola (25%)Identyfikacja i kontekst3 pola (37,5%)Kontakt i język3 pola (37,5%)
Źródło: czas, miejsce, imię i nazwisko, nazwa firmy (wymagane), akronim, numer karty, telefon, e-mail, język

Zalecenie 2: imię i nazwisko jako pole wymagane

Imię i nazwisko jest w zgłoszeniu wymagane. Zgłoszenie bez niego nie może założyć konta ani przypisać odbicia nowej osobie. Dostawca powinien więc wysyłać je w tej samej formie, w jakiej występuje w kartotece KD, bez skrótów i bez dopisków typu nazwa agencji.

Zalecane jest także pole akronimu, jeśli kartoteka KD takie prowadzi. Pomaga ono rozróżnić osoby o tych samych danych.

Zalecenie 3: nazwa firmy w jednolitej pisowni

Nazwa firmy jest wymagana, a firma zewnętrzna jest przypisywana na podstawie nazwy ze zgłoszenia. Odbicie karty przez osobę, której system nie zna, zakłada konto i firmę z danych zgłoszenia, więc dwie pisownie tej samej firmy dadzą dwie firmy.

Zalecenie dla integratora: wysyłać nazwę firmy z jednego pola słownikowego KD, nie z pola tekstu swobodnego. Jeśli takiego pola nie ma, trzeba ustalić z administratorem KD jedną obowiązującą pisownię.

Zalecenie 4: miejsce odbicia z ustalonego słownika

Pole miejsca odbicia rozróżnia lokalizacje czytników. Zdarzenia z miejsca, które nie ma szablonu w InnerWeb, trafiają do logu i nie uruchamiają alarmu szkoleniowego. Integrator powinien więc przekazać listę wszystkich nazw miejsc z KD, a zespół BHP przypisze im szablony.

Nazwa miejsca musi być stabilna. Zmiana nazwy czytnika w KD, bez informacji dla InnerWeb, powoduje, że zdarzenia znów trafiają do miejsca bez szablonu.

Zalecenie 5: czas zdarzenia i wysyłka w czasie rzeczywistym

Specyfikacja integracji wymaga, aby system KD wysyłał zdarzenia w czasie rzeczywistym, z czasem zdarzenia odczytanym z czytnika, a nie z chwili wysyłki. Dzięki temu ewidencja wejść odpowiada temu, co faktycznie wydarzyło się przy bramie.

Kolejka zdarzeń po awarii łącza powinna być opróżniana jak najszybciej, z zachowaniem oryginalnych czasów zdarzeń, a integrator powinien udokumentować, jakie opóźnienie jest w jego systemie akceptowalne.

Przy wyborze pól warto też spisać, które z nich kartoteka KD wypełnia automatycznie, a które wymagają ręcznego uzupełnienia przez administratora. Takie zestawienie skraca rozmowę z dostawcą i pozwala od razu wykryć pola, których system KD w ogóle nie prowadzi.

Zalecenie 6: telefon, e-mail i język tylko gdy są pewne

Telefon, e-mail i język są w zgłoszeniu polami dodatkowymi. Wysyłaj je tylko wtedy, gdy kartoteka KD je zawiera i są aktualne, ponieważ błędne dane kontaktowe wprowadzone na nowe konto trudno później wyłapać. Szczególnie pole języka warto wypełniać dla osób zagranicznych, bo wpływa na wersję szkolenia.

Zalecenie 7: uwierzytelnienie i obsługa wygaśnięcia tokenu

Wywołanie webhooka wymaga tokenu z endpointu logowania API. Token ma ograniczony czas ważności i jest odnawiany automatycznie przez integrację. Integrator powinien ponawiać logowanie i powtarzać odrzucone zgłoszenie, a nie gubić je.

Zgłoszenie powinno zawierać kierunek (wejście lub wyjście) oraz identyfikator zdarzenia. Zasady parowania wejść i wyjść oraz odrzucania duplikatów ustala się w specyfikacji z dostawcą KD, dlatego dublowanie wysyłek jest niewskazane.

Materiał wideo

Często zadawane pytania

Które pola są wymagane w zgłoszeniu odbicia?

Imię i nazwisko oraz nazwa firmy. Pozostałe pola, w tym numer aktywnej karty, poprawiają jakość powiązania odbicia z kontem.

Czy InnerWeb używa czasu z czytnika?

Tak, specyfikacja zakłada czas zdarzenia z czytnika oraz wysyłkę w czasie rzeczywistym, wraz z kierunkiem i identyfikatorem zdarzenia.

Co się stanie, gdy nazwa firmy będzie pisana różnie?

System założy odrębne firmy dla każdej pisowni. Nazwę najlepiej brać z jednego słownika w KD.

Jesteś integratorem KD?

Skontaktuj się, a przekażemy specyfikację webhooka odbicia karty i ustalimy zakres pól dla Twojego systemu.

Porozmawiajmy