Protokół serwisowy PDF: generowanie z aplikacji, wysyłka do klienta i archiwum, którego nie da się podmienić

PDF z formularza to plik, w który człowiek wpisuje tekst. Nawet jeśli ma pola, to system nie wie, że „12,4” w polu obok „ciśnienie” to pomiar w barach z normą od 1,0 do 2,0. PDF z danych powstaje odwrotnie: najpierw aplikacja zbiera dane w polach o znanym typie — pomiar z jednostką i zakresem, część z ilością, czynność z checklisty, zdjęcie z datą, podpis z nazwiskiem — a potem renderuje z nich dokument. Plik jest tylko widokiem danych, które nadal żyją w systemie.

Konsekwencje są praktyczne: z danych da się policzyć, ile razy pomiar w tym urządzeniu był poza normą, zdjąć części ze stanu magazynu, dodać czas pracy do rozliczenia i wysłać dokument bez udziału biura. Z pliku PDF wypełnionego ręcznie nie da się nic — poza otwarciem go i przeczytaniem.

Wydruk ma być czytelny dla osoby, która nigdy nie widziała aplikacji: klienta, jego księgowej, biegłego w sporze. Kolejność i zawartość sekcji powinny być zawsze takie same, niezależnie od typu protokołu.

Suma kontrolna to ciąg 64 znaków liczony z całej zawartości pliku funkcją skrótu SHA-256. Zmiana jednego bajtu w PDF — przecinka w uwagach, cyfry w pomiarze — daje zupełnie inną sumę. Jeśli aplikacja liczy sumę w chwili podpisu i zapisuje ją w bazie razem z protokołem, to każdy, kto ma plik, może policzyć jego sumę i porównać z zapisaną. Zgodność oznacza, że plik jest dokładnie tym, który podpisał klient; niezgodność oznacza, że ktoś go zmienił po podpisie.

Sumę liczy się na urządzeniu technika, w momencie podpisu, także bez zasięgu — dzięki temu późniejsza synchronizacja nie ma wpływu na dokument. Warto ją drukować w stopce PDF i pokazywać w publicznym podglądzie protokołu, żeby klient widział, że dokument jest zabezpieczony. Suma kontrolna nie zastępuje podpisu kwalifikowanego ani znacznika czasu od dostawcy kwalifikowanego, ale w sporze o treść protokołu z wizyty robi dokładnie to, co potrzebne: pokazuje, czy strony spierają się o ten sam dokument.

Najgorszy sposób wysyłki protokołu to ten najczęstszy: technik robi zdjęcie kartki albo eksportuje PDF i wysyła z prywatnego telefonu na WhatsAppie lub mailem. Dokument wychodzi poza system, nie ma śladu wysyłki, a po odejściu technika firma nie ma dostępu do korespondencji. Wysyłka powinna iść z systemu, automatycznie, po zapisaniu protokołu.

Trzy kanały, które się uzupełniają: publiczny link z unikalnym tokenem, który otwiera się w przeglądarce bez logowania i nie da się go zgadnąć; wiadomość e-mail z systemu do osoby decyzyjnej u klienta z tym linkiem; portal klienta, w którym klient widzi wszystkie protokoły przy swoich urządzeniach i może je pobrać. W Serwis Pro protokół dostaje link i wiadomość automatycznie po zapisaniu, a w portalu klienta pojawia się przy zleceniu i urządzeniu.

Archiwum w folderze „Protokoły 2026” działa do momentu, w którym trzeba znaleźć wszystkie wizyty przy konkretnym agregacie z ostatnich trzech lat. Wtedy okazuje się, że pliki nazywały się różnie, część jest w mailach, a część w telefonie technika, który już nie pracuje. Archiwum ma sens, gdy protokół jest przypięty do urządzenia i klienta w kartotece: kolejny technik otwiera urządzenie i widzi historię pomiarów, wymienionych części i zaleceń przed wejściem na obiekt.

Okres przechowywania powinien wynikać z terminów przedawnienia roszczeń z umowy i gwarancji oraz z wymagań branżowych, a nie z pojemności dysku. Przy zmianie systemu ważny jest eksport: protokoły jako PDF z sumami kontrolnymi i dane jako tabela, żeby historia urządzeń nie została u poprzedniego dostawcy.

Jeśli firma nie ma jeszcze aplikacji, a potrzebuje porządnego protokołu w PDF, punktem wyjścia jest dobry wzór z polami właściwymi dla branży. Bezpłatne generatory na serwis-pro.app tworzą gotowy dokument PDF z pomiarami i miejscem na podpis dla przeglądu klimatyzacji, pompy ciepła i kotła, pomiarów elektrycznych, próby szczelności, odbioru instalacji fotowoltaicznej i stolarki, serwisu maszyn, automatów i urządzeń gastronomicznych, przeglądu technicznego budynku oraz montażu monitoringu i instalacji internetu.

Wzór to dobry pierwszy krok, ale nadal dokument wypełniany ręcznie. Kolejnym krokiem jest przeniesienie tego samego układu pól do szablonu w aplikacji, żeby protokół powstawał z danych, a nie z klawiatury.