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ć
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