InnerWeb
Przejdź do treści

Zapytanie ofertowe na karty i czytniki: wymagania integracyjne KD

Zakupy i IT, które pytają o ceny kart i czytników, często pomijają integrację z RCP, a później płacą za dopisanie jej poza ofertą. Poniżej wymagania, które warto wpisać do zapytania ofertowego, by po wymianie zachować rejestrację czasu pracy i raporty.

12 h
ważność tokenu JWT integracji
Źródło: specyfikacja integracji
13 h
limit parowania wejścia z wyjściem
Źródło: specyfikacja integracji

Po co wymagania integracyjne w zapytaniu

Zapytanie ofertowe na karty i czytniki zwykle opisuje technologię: typ karty, protokół czytnika, liczbę sztuk. Rzadziej opisuje to, co dzieje się z odbiciem po stronie serwera. Jeśli zakład rejestruje czas pracy z odbić, brak tego opisu oznacza ryzyko, że po wymianie raporty przestaną się zgadzać.

InnerWeb jest producentem oprogramowania i nie dostarcza czytników. Przyjmuje zdarzenia odbicia z systemu KD i łączy je z dniami pracy. Wymagania poniżej służą temu, by dostawca KD mógł te zdarzenia przekazać bez dodatkowych negocjacji.

Zalecenie 1: HTTPS POST z serwera KD

Wpisz wymaganie, że przy każdym odbiciu serwer systemu KD wysyła komunikat HTTPS POST do wskazanego adresu. Dzięki temu nie trzeba otwierać portów przychodzących w sieci zakładu: ruch jest wychodzący. Dostawca powinien potwierdzić w ofercie, czy jego serwer taki komunikat wysyła.

Uwierzytelnienie integracji odbywa się kontem technicznym i tokenem JWT ważnym 12 godzin, więc w zapytaniu warto zapisać, że po stronie dostawcy wymagane jest odnawianie tokenu.

Limity techniczne integracji odbić

Limity techniczne integracji odbićWykres poziomy: token ważny 12 godzin, limit parowania 13 godzin051015godzinWażność tokenu JWTWażność tokenu JWT: 12 godzin12Parowanie wejścia z wyjściemParowanie wejścia z wyjściem: 13 godzin13
Źródło: Specyfikacja integracji odbić z systemu KD

Zalecenie 2: zawartość komunikatu

Komunikat powinien zawierać czas odbicia z kontrolera, identyfikator czytnika, osobę, numer karty w postaci kod_obiektu-numer oraz opcjonalnie kierunek i identyfikator zdarzenia. Czas z kontrolera jest ważny, bo kolejka offline przy awarii łącza opóźnia wysyłkę.

Identyfikator zdarzenia (idempotencja) i czas z kontrolera chronią dni pracy przed zniekształceniem przez ponowną wysyłkę. Wpisz ten punkt do zapytania jako wymaganie lub, jeśli dostawca go nie zapewni, jako odstępstwo wymagające uzasadnienia.

Zalecenie 3: kierunek wejścia i wyjścia

Poproś o wskazanie, czy system przekazuje kierunek. Gdy go nie przekazuje, InnerWeb paruje wejście z wyjściem w oprogramowaniu, z limitem 13 godzin między wejściem a wyjściem. Działa to poprawnie, ale wymaga opisu czytników: osobne czytniki na wejście i wyjście zapisujemy w słowniku czytników.

Zalecenie 4: eksport kart i lista czytników

Do ustalenia z dostawcą KD przed integracją: czy jego serwer wysyła HTTPS POST, lista czytników oraz eksport kart (kod obiektu i numer) do numeru kadrowego. Wpisz to jako załącznik do umowy: eksport kart w formacie CSV z kodem obiektu, numerem i numerem kadrowym.

Karty można przypisać do osób importem CSV, więc eksport od dostawcy jest paliwem dla całego procesu. Brak eksportu oznacza przypisywanie ręczne i opóźnienie harmonogramu.

Zalecenie 5: co oferta wyłącza, a co zostaje po stronie zakładu

Zapisz w zapytaniu, że logika KD zostaje bez zmian: dostawca nie przejmuje liczenia dni pracy, grafików, wyjątków ani raportów. Całe przetwarzanie (rozpoznanie wejścia i wyjścia, łączenie w dni pracy, grafiki, wyjątki, raporty) odbywa się po stronie InnerWeb.

Zapisz też koszty poza zakresem oprogramowania: czytnik kodów QR na portierni to rząd 1 000 zł netto za urządzenie, poza ofertą InnerWeb (orientacyjne widełki z wdrożeń 2025–2026; wycena indywidualna). Dostawca powinien podać ceny jednostkowe osobno dla kart i czytników.

Zalecenie 6: nieznane karty i dowód odbioru

Dodaj kryterium odbioru: lista odbić nieznanych kart po wymianie ma być pusta lub wyjaśniona. Odbicie nieznanej karty trafia do kolejki „karta do przypisania”, zamiast zakładać konto z nieznanego odbicia, więc jest ona gotowym miernikiem.

Materiał wideo

Często zadawane pytania

Czy zapytanie musi wymieniać InnerWeb?

Nie. Wystarczy opis wymagań: HTTPS POST, zawartość komunikatu, eksport kart. Dostawca KD zrealizuje je niezależnie od nazwy odbiorcy.

Czy trzeba otwierać porty w sieci zakładu?

Nie. Serwer KD wysyła komunikat HTTPS POST, więc ruch jest wychodzący.

Kto liczy dni pracy?

InnerWeb po stronie oprogramowania. Logika KD zostaje bez zmian.

Źródła

Dołącz wymagania integracyjne do zapytania

Przekażemy specyfikację odbić dla dostawcy KD i sprawdzimy, czy oferta pokrywa potrzeby RCP. Umów rozmowę z InnerWeb.

Porozmawiajmy