Jak AI odpowiada pracownikom na pytania o urlopy i pilnuje terminów w Personio?

Tak, AI można podłączyć do Personio i zaczyna to realnie odciążać kadrę od pytań, na które odpowiedź siedzi w systemie od dawna. Pracownik dostaje odpowiedź o swoje saldo urlopowe o każdej porze dnia i nocy, a dział HR przestaje co tydzień sprawdzać ręcznie, komu kończy się umowa albo kto ma przeterminowane badanie okresowe. Połączenie działa przez REST API, które Personio udostępnia, i przy odpowiednim ustawieniu uprawnień nie ruszacie konfiguracji systemu co miesiąc.

Co trzyma Personio i dlaczego to dobry punkt startowy dla AI

Personio zbiera dane pracownika w kilku modułach, które różnią się tym, do czego AI ma sensowny dostęp. Kartoteka pracownika to centralny rekord: imię, nazwisko, dział, stanowisko, data zatrudnienia, typ umowy (czas określony, czas nieokreślony, umowa zlecenie), data zakończenia umowy. Do kartoteki można dopisać pola niestandardowe, np. numer legitymacji, kategorię prawa jazdy albo numer identyfikatora firmowego, i te pola też trafiają do API.

Nieobecności to drugi moduł. Personio rozróżnia typy, które firma sama konfiguruje: urlop wypoczynkowy, urlop na żądanie, opieka nad dzieckiem, urlop okolicznościowy, zwolnienie lekarskie. Do każdego wniosku trafia status: Oczekujący, Zatwierdzony albo Odrzucony. W sekcji Nieobecności każdego pracownika widać saldo urlopowe: ile należne w tym roku, ile już wykorzystane, ile zaplanowane. To dokładnie ta liczba, o którą pracownicy pytają kadrę kilka razy w miesiącu.

Czas pracy ląduje w module Obecności, gdzie gromadzą się wejścia i wyjścia razem z rozliczeniami godzin nadliczbowych. Dokumenty mają swoją zakładkę w kartotece z kategoriami: umowa o pracę, zaświadczenia, orzeczenie lekarskie, karta podatkowa PIT-2, świadectwo pracy i dowolne własne. System nie pilnuje, czy dokument jest aktualny, chyba że ustawiono pole daty ważności. Czwarty moduł to onboarding: lista zadań wdrożeniowych z osobą odpowiedzialną, terminem i statusem (Do zrobienia / Zrobione).

Firma, która ma Personio jako jedyne miejsce trzymania danych kadrowych, ma gotową bazę dla AI. Nie potrzebuje dodatkowych arkuszy. Problem, który obserwujemy w praktyce, jest inny: Personio jest świetnie wypełniony w momencie zatrudnienia, a potem część pól się nie aktualizuje, szczególnie daty ważności dokumentów i orzeczeń lekarskich. AI wychodzi temu naprzeciw, bo codziennie sprawdza, co się nie zgadza, i mówi o tym wprost.

Jak fizycznie wygląda podłączenie: REST API Personio

Personio udostępnia REST API pod domeną api.personio.de. To standardowe API w formacie JSON, do którego można się podłączyć z dowolnego systemu lub skryptu. Żeby zacząć, potrzebujecie: planu Personio obejmującego dostęp do API (sprawdźcie to w Ustawieniach, bo plany różnią się zakresem), oraz pary kluczy wygenerowanych w sekcji Ustawienia, następnie Integracje, następnie Dane API. Tam dostajecie Client ID i Client Secret przypisane do konkretnego zakresu danych.

Uwierzytelnienie działa następująco: wysyłacie POST z Client ID i Client Secret na endpoint /auth i dostajecie token Bearer ważny przez kilka godzin. Ten token dołączacie jako nagłówek HTTP Authorization do każdego kolejnego zapytania. Żaden middleware ani zewnętrzna usługa nie jest tu wymagana.

Przez API możecie pobierać:

• Listę pracowników z kartotekami (GET /company/employees), z możliwością filtrowania po dziale, statusie i innych polach
• Szczegóły jednego pracownika (GET /company/employees/{id}) wraz z polami niestandardowymi
• Saldo urlopowe konkretnej osoby z podziałem na typy nieobecności
• Listę nieobecności z filtrami po dacie, typie i statusie (GET /company/absences/periods)
• Zapisy obecności i czas pracy (GET /company/attendances)
• Metadane dokumentów z kartoteki: nazwy, kategorie, daty dodania

Czego standardowe API nie da bez dodatkowej konfiguracji: treści samych plików PDF z zakładki Dokumenty (dostajecie metadane, nie zawartość), danych z modułu płac (to osobny zakres API, dostępny w wyższych planach lub przez osobny token), oraz historycznych danych, jeśli były wpisane poza Personio i nie zostały zaimportowane do systemu.

Personio udostępnia też webhooki. Możecie skonfigurować powiadomienie, gdy pracownik złoży wniosek urlopowy, gdy wniosek zmieni status albo gdy pojawi się nowy pracownik. To ważna rzecz przy budowaniu odpowiedzi w czasie rzeczywistym: zamiast odpytywać API co godzinę, Personio sam mówi "coś się zmieniło". Bez webhooka AI musiałoby regularnie odpytywać API (polling), co jest mniej niezawodne i generuje więcej ruchu.

Jedno ograniczenie warte uwagi: uprawnienia API działają na poziomie całego konta, nie na poziomie konkretnego pracownika. Oznacza to, że jeśli AI ma dostęp do API, widzi wszystkich pracowników. Warstwa aplikacyjna, czyli narzędzie łączące AI z Personio, sama musi pilnować, kto pyta i o kogo ma prawo pytać. To jeden z powodów, dla których nie podpina się AI bezpośrednio do API bez warstwy pośredniej.

AI odpowiada pracownikom: pytania o urlop przestają trafiać do kadrowej

Typowy scenariusz wygląda tak. Pracownik pisze o 19:00 do firmowego czatu: "Ile mam jeszcze urlopu na ten rok?". Bez AI: albo pisze maila do kadr i czeka do rana, albo sam szuka w Personio, gdzie nie każdy wie, gdzie sprawdzić saldo. Z AI: czat w ciągu kilku sekund odpytuje API, pobiera saldo tej osoby i odpowiada: "Masz 8 dni urlopu wypoczynkowego do wykorzystania do końca roku. Zaplanowany urlop w grudniu, 3 dni, jest już uwzględniony w tym saldzie."

U jednego z klientów z branży logistycznej z kilkudziesięcioosobowym zespołem rozsiany po kilku lokalizacjach kadrowa spędzała dużą część każdego tygodnia na odpowiadaniu właśnie na te pytania. Wpływały przez Teams, przez maile, przez telefon, o różnych porach. Po podłączeniu AI do Personio te pytania praktycznie przestały trafiać do działu kadr. Kadrowa dostała czas na rzeczy, których AI nie zastąpi.

Co AI może odpowiedzieć na podstawie danych z Personio:

• Aktualne saldo urlopu wypoczynkowego i urlopu na żądanie
• Ile dni urlopu zostało do końca roku rozliczeniowego
• Status złożonego wniosku urlopowego: Oczekujący, Zatwierdzony lub Odrzucony
• Zaplanowane nieobecności w danym miesiącu lub kwartale
• Kto z działu jest nieobecny w konkretnym tygodniu, dla menedżerów planujących pracę zespołu
• Czy złożony wniosek na konkretny termin koliduje z nieobecnościami innych osób z działu

Jedno zastrzeżenie: AI odpowiada na podstawie danych w Personio. Jeśli kadrowa nie wpisała czegoś na czas albo saldo jest liczone poza systemem w Excelu, AI poda nieaktualne dane. Integracja pokazuje przy okazji, gdzie w procesach kadrowych są luki, które warto zasypać.

Pilnowanie terminów: badania, umowy, okresy próbne

To ten obszar, gdzie AI przynosi najwięcej spokoju. Dział kadr w większości firm pilnuje terminów przez Excela albo przez ręczne przypomnienia wpisane w kalendarzu. Oboje to systemy, które zawodzą, gdy odpowiedzialna osoba jest na urlopie albo gdy firma się rozrośnie powyżej kilkunastu pracowników.

W kartotece pracownika w Personio możecie trzymać:

• Datę zakończenia umowy na czas określony lub umowy zlecenie
• Koniec okresu próbnego
• Datę ważności orzeczenia lekarskiego z badania wstępnego lub bieżącego, o ile pole zostało skonfigurowane
• Daty szkoleń obowiązkowych, np. BHP, w polach niestandardowych ustawionych przez administratora Personio

AI codziennie odpytuje API, przegląda te pola dla wszystkich aktywnych pracowników i wyłapuje tych, którym zbliża się termin. Wynik trafia rano do kadrowej albo do menedżerów konkretnych działów: nie lista wszystkich pracowników, tylko tych wymagających działania w najbliższych 30, 60 lub 90 dniach. Konkretne imiona, konkretne daty, konkretne działanie do podjęcia.

Przykład: firmy zatrudniające pracowników na kontraktach sezonowych albo na zastępstwo często nieumyślnie przekształcają umowy na czas określony w umowy na czas nieokreślony przez zbyt późne działanie po przekroczeniu limitu trzech następujących po sobie umów. AI patrzy na te daty systematycznie, bez wakacji i bez przegapionych przypomnień. Gdy data końca umowy zbliża się, menedżer dostaje konkretną informację z imieniem, stanowiskiem i datą, do której musi podjąć decyzję.

Okres próbny to szczególny przypadek. Kończy się zazwyczaj po jednym lub trzech miesiącach i wymaga decyzji: przedłużyć, zakończyć, zatrudnić na stałe. W ferworze codziennej pracy ta data łatwo ucieka. AI ją obserwuje i mówi z tygodniowym wyprzedzeniem, kiedy termin się zbliża.

Braki w dokumentach i gotowość do kontroli

Kartoteka pracownika powinna zawierać zestaw obowiązkowych dokumentów. W polskich realiach to co najmniej: umowa o pracę, aktualny PIT-2, orzeczenie lekarskie z badania wstępnego lub bieżącego, zaświadczenie o ukończeniu szkolenia BHP i, zależnie od stanowiska, inne wymagane dokumenty: np. uprawnienia do wózków widłowych, karta kwalifikacyjna kierowcy czy zaświadczenie sanepidowskie.

AI może raz w tygodniu przejrzeć wszystkie kartoteki i sprawdzić, które kategorie dokumentów są puste. Personio przechowuje metadane dokumentów: nazwa kategorii, data dodania. API odpowie, czy dokument w kategorii "Orzeczenie lekarskie" jest wgrany, czy brakuje go całkowicie. Nie sprawdzi, czy treść dokumentu jest poprawna ani czy orzeczenie wystawił właściwy lekarz medycyny pracy, ale brak pliku albo minięta data ważności wystarczy, żeby podnieść flagę kadrowej.

Raport braków to coś, co przed kontrolą Państwowej Inspekcji Pracy albo podczas wewnętrznego audytu kadrowego zajmuje godziny ręcznego sprawdzania. AI skraca to do minut: przechodzi przez wszystkich aktywnych pracowników i daje kadrowej tabelę z kolumnami: pracownik, dział, brakujące dokumenty, data ostatniej aktualizacji kartoteki. Zamiast przeglądać kilkadziesiąt kartotek po kolei.

Zestawienia dla kadr i menedżerów bez ręcznego eksportu

Poza odpowiadaniem na pytania pracowników i pilnowaniem terminów AI może przygotowywać zestawienia, których Personio sam z siebie nie wygeneruje, bo wymagają złożenia danych z kilku modułów albo własnych reguł firmy.

Przykłady zestawień, które warto zbudować:

• Nieobecności w dziale w danym kwartale: ile dni łącznie, rozkład na typy (urlop, zwolnienie lekarskie, opieka nad dzieckiem), porównanie między działami
• Zaległe urlopy do 31 marca: lista pracowników, którym urlop z poprzedniego roku przepadnie, z liczbą zaległych dni. Taki raport pomaga w planowaniu przed szczytem sezonu urlopowego
• Rotacja kontraktów na najbliższe trzy miesiące: ile umów na czas określony kończy się w kolejnym kwartale, podzielone na działy i menedżerów odpowiedzialnych
• Status onboardingu nowych pracowników: ile zadań wdrożeniowych zostało wykonanych dla pracowników przyjętych w ostatnim miesiącu, kto jest odpowiedzialny za przeterminowane punkty
• Absencje powyżej progu: pracownicy, którzy w ciągu kwartału mieli więcej dni zwolnień lekarskich niż zadany próg, do weryfikacji przez menedżera lub HR

Takie zestawienia możecie generować na żądanie przez czat ("pokaż nieobecności w dziale sprzedaży w listopadzie") albo jako raport cykliczny lądujący co poniedziałek w skrzynce kierownika. AI składa zapytanie do API, przetwarza dane i formatuje wynik jako czytelną tabelę albo krótkie podsumowanie. Bez eksportowania do Excela, bez ręcznego liczenia, bez czekania na kadrową.

Od czego zaczniecie i na co uważać

Zanim cokolwiek podłączycie, sprawdźcie trzy rzeczy po stronie Personio. Pierwszy: który macie plan i czy obejmuje dostęp do API. Drugi: kto w firmie jest administratorem portalu Personio i może wygenerować klucze API w sekcji Integracje. Trzeci: czy pola, których AI ma używać, są w ogóle uzupełniane przez kadrę na bieżąco. Data ważności badania okresowego w polu niestandardowym jest bezużyteczna, jeśli nikt jej nie wpisał po ostatnim badaniu pracownika.

Dobry punkt startowy to jeden, wąski przypadek użycia: odpowiadanie pracownikom na pytania o saldo urlopów. Małe, sprawdzalne, widoczne. Uruchamiacie, sprawdzacie przez miesiąc, czy dane się zgadzają z tym, co widzi kadrowa, i dopiero potem rozszerzacie o monitoring terminów i raporty dla HR.

Kwestia RODO jest tu konkretna. Kartoteka pracownika to dane osobowe objęte Artykułem 88 RODO w kontekście zatrudnienia. Integracja AI powinna być opisana w rejestrze czynności przetwarzania, a pracownicy poinformowani, że system AI ma dostęp do ich kartoteki. Warto też określić zakres: które pola trafiają do modelu AI, kto może pytać o kogo i przez jaki kanał. To nie jest powód, żeby się nie wdrażać, ale powód, żeby wdrożyć to z głową, z klauzulą informacyjną i z dokumentacją, zanim ktoś zapyta podczas kontroli.

Czy Wasza firma pracuje z Personio i chcecie zobaczyć, jak taka integracja wygląda krok po kroku? 15 minut rozmowy wystarczy, żeby ocenić, co ma sens jako pierwsze. Możecie też zajrzeć najpierw na realne wdrożenia, żeby zobaczyć, co inni z podobnych firm już uruchomili.