Pomoc

Rozwiązywanie problemów

Typowe blokady w onboardingu, płacach i integracjach — z przyczyną i tym, co zrobić. Jeśli problemu nie ma na liście, napisz do wsparcia Onboardly.

Onboarding i kreator kandydata

Problem	Przyczyna i rozwiązanie
KYC odrzucone	Najczęściej słaba jakość zdjęcia dokumentu lub selfie. Powtórz weryfikację w lepszym świetle, bez odblasków, całym dokumentem w kadrze. Jeśli nadal się nie udaje — poproś pracodawcę o reset KYC (robi to wsparcie Onboardly).
Link onboardingu wygasł	Link ma ograniczoną ważność — po jej upływie prowadzi na stronę „wygasł”. Pracodawca wysyła nowy link z panelu (akcja ponów wysyłkę na onboardingu).
Nie przychodzi kod SMS	Po wysyłce obowiązuje 60 s odstępu przed ponowną próbą. Sprawdź poprawność numeru telefonu w ofercie; po odczekaniu użyj „wyślij ponownie”.
Podpis własny się nie zapisał	Podpis wymaga potwierdzenia kodem SMS. Upewnij się, że kod został wpisany, a przeglądarka jest aktualna. Po błędzie sieci ponów — dokument nie zostanie podpisany podwójnie.
Kreator nie idzie dalej	Blokują go braki: oczekująca legalizacja lub brakujące dokumenty branżowe. Uzupełnij brakujący krok — bramka gotowości odblokuje podpis.

Problem	Przyczyna i rozwiązanie
Pracownik nie może dograć dokumentu	Link „Uzupełnij” jest ważny 7 dni i przyjmuje pliki do 10 MB (PDF/obraz). Po wygaśnięciu wyślij prośbę o dokumenty ponownie z panelu.
Legalizacja utknęła	Jeśli sprawę prowadzi zewnętrzny podmiot, sprawdź Portal partnera — sprawa czeka aż partner dogra dokumenty i ją zamknie. Dopiero wtedy wygenerujesz umowę.

Problem	Przyczyna i rozwiązanie
Eksport ZUS/KEDU zablokowany	Bramka kompletności wymaga: imienia i nazwiska, PESEL (lub dokumentu cudzoziemca), daty urodzenia, adresu zamieszkania, daty rozpoczęcia, NIP płatnika, poprawnego kodu tytułu ubezpieczenia i kodu NFZ. Uzupełnij pozycje z listy blokad i ponów eksport.
Import nie dopasował pracownika	Import dopasowuje po PESEL (fallback: imię + nazwisko + data urodzenia) i działa w trybie zachowawczym — nie tworzy nowych pracowników. Niedopasowanych zakładasz przez onboarding lub import istniejących pracowników.
Kod tytułu ubezpieczenia „niska pewność”	Dla części zleceń kod ma niską pewność — potwierdź go przed złożeniem w ZUS. Zobacz Eksport kadrowy.

Problem	Przyczyna i rozwiązanie
Błąd 401 / 403 z API	401 — brak lub zły klucz; 403 — klucz nie ma wymaganego zakresu. Sprawdź nagłówek i zakresy klucza. Zobacz Uwierzytelnianie API.
Błąd 429 (limit)	Przekroczony limit żądań. Odczekaj do czasu z nagłówka `X-RateLimit-Reset` i ponów (backoff wykładniczy). Zobacz Błędy, limity i paginacja.
Webhook nie dochodzi	Sprawdź URL i sekret w ustawieniach oraz weryfikację podpisu HMAC. Nieudane dostarczenia są ponawiane; zdarzenie można wysłać ponownie. Zobacz Webhooki.

Nie znalazłeś rozwiązania? Napisz do wsparcia Onboardly — część operacji (np. reset KYC) wykonuje zespół obsługi.