Problemy z wysyłką dokumentów z Płatnika nie zawsze oznaczają błąd deklaracji. Często dotyczą warstwy komunikacyjnej: certyfikatu ZUS, podpisu kwalifikowanego, list TSL, ustawień przekazu elektronicznego, sieci albo czasowej niedostępności po stronie ZUS.

Dla kogo jest ten poradnik

Ten poradnik jest dla osób, które przy wysyłce dokumentów, pobieraniu danych albo weryfikacji podpisu widzą błędy komunikacji z ZUS. Zakłada, że program Płatnik uruchamia się poprawnie i baza jest dostępna, ale problem pojawia się przy przekazie elektronicznym.

Jeżeli komunikat dotyczy wyłącznie certyfikatu ZUS, zacznij od poradnika Certyfikat ZUS w programie Płatnik. Jeżeli pojawia się błąd list TSL, zobacz też błąd pobierania list TSL i weryfikacji certyfikatu.

Przed rozpoczęciem

Przygotuj:

  • dokładną treść komunikatu z Płatnika,
  • informację, czy problem dotyczy jednego stanowiska czy wielu,
  • aktualną wersję programu i metrykę,
  • informację, jakiego podpisu używa użytkownik,
  • dostęp do ustawień przekazu elektronicznego,
  • możliwość sprawdzenia komunikatów technicznych ZUS.

Nie zmieniaj kilku elementów naraz. Przy komunikacji elektronicznej łatwo ukryć prawdziwą przyczynę, jeśli jednocześnie zmienisz certyfikat, adres przekazu, sterownik podpisu i ustawienia sieci.

Procedura krok po kroku

1. Ustal, w którym miejscu zatrzymuje się proces

Najpierw określ moment awarii:

  • pobieranie danych z ZUS,
  • weryfikacja dokumentów,
  • podpisywanie zestawu,
  • wysyłka zestawu,
  • odbiór potwierdzenia,
  • pobieranie list TSL albo weryfikacja certyfikatu.

To ważne, bo każda z tych sytuacji ma inne przyczyny. Błąd przy podpisywaniu zwykle prowadzi do certyfikatu kwalifikowanego albo sterownika. Błąd przy pobieraniu danych może wynikać z certyfikatu ZUS, ustawień przekazu, przerwy technicznej albo sieci.

2. Sprawdź certyfikat ZUS

W styczniu 2026 r. ZUS opublikował komunikat o nowym certyfikacie używanym w Płatniku i oprogramowaniu interfejsowym. Jeżeli środowisko nie ma aktualnego certyfikatu, komunikacja z ZUS może przestać działać mimo poprawnej bazy i poprawnych dokumentów.

W Płatniku sprawdź:

  • czy w ustawieniach przekazu widnieje aktualny certyfikat ZUS,
  • czy certyfikat został pobrany po zmianie wskazanej przez ZUS,
  • czy problem dotyczy jednego profilu użytkownika czy całego stanowiska,
  • czy na kilku komputerach w firmie certyfikat wygląda tak samo.

Nie zakładaj, że aktualizacja programu zawsze odświeżyła certyfikat. W niektórych środowiskach trzeba wykonać kontrolę ręcznie.

3. Sprawdź podpis kwalifikowany i TSL

Jeżeli błąd pojawia się przy podpisywaniu albo weryfikacji certyfikatu użytkownika, sprawdź:

  • ważność certyfikatu kwalifikowanego,
  • oprogramowanie dostawcy podpisu,
  • sterownik czytnika lub tokena,
  • datę i godzinę systemową,
  • dostęp do listy TSL,
  • czy problem dotyczy wszystkich certyfikatów, czy tylko jednego.

Publiczna polska lista TSL jest dostępna pod adresem:

https://www.nccert.pl/tsl/PL_TSL.xml

Jeżeli firmowa sieć, proxy albo antywirus blokuje pobieranie tej listy, Płatnik może zgłaszać błąd weryfikacji mimo poprawnego certyfikatu.

4. Sprawdź ustawienia przekazu elektronicznego

ZUS publikuje instrukcję zmiany ustawień przekazu elektronicznego. W praktyce oznacza to, że adres wykorzystywany przez program może mieć znaczenie, zwłaszcza podczas przerw technologicznych albo zmian po stronie węzłów przyjmujących dokumenty.

W programie sprawdź:

  • Przekaz -> Ustawienia przekazu elektronicznego,
  • zakładkę połączeń,
  • wybraną metodę przekazu,
  • zapisane adresy serwerów,
  • czy po zmianie ustawień program został zamknięty i uruchomiony ponownie.

Jeżeli nie administrujesz środowiskiem, nie zmieniaj adresów “na próbę”. Zapisz obecny stan i potwierdź z osobą odpowiedzialną za konfigurację.

5. Sprawdź przerwy i komunikaty ZUS

ZUS publikuje harmonogram przerw technologicznych dla węzłów internetowych przyjmujących dokumenty z Płatnika. W czasie przerwy jeden z ośrodków może być wyłączony, a użytkownik może potrzebować zmiany adresu wysyłki zgodnie z poradnikiem ZUS.

Dodatkowo pojawiają się komunikaty doraźne. 5 czerwca 2026 r. ZUS informował o pracach serwisowych, które mogły ograniczać komunikację elektroniczną z ZUS, w tym pobieranie danych w programie Płatnik.

Jeżeli błąd pojawia się nagle u kilku użytkowników i nie było lokalnej zmiany w firmie, najpierw sprawdź komunikaty ZUS. To szybsze i bezpieczniejsze niż od razu przeinstalowywać Płatnika.

Jak zawęzić przyczynę

Praktyczna kolejność diagnostyki:

  1. Sprawdź, czy problem dotyczy jednego dokumentu, jednego użytkownika czy wszystkich stanowisk.
  2. Zapisz pełny komunikat błędu.
  3. Sprawdź aktualne komunikaty ZUS i harmonogram przerw.
  4. Sprawdź certyfikat ZUS w ustawieniach przekazu.
  5. Sprawdź podpis kwalifikowany i TSL.
  6. Sprawdź sieć, proxy i firewall.
  7. Dopiero potem zmieniaj konfigurację programu.

Jeżeli problem dotyczy tylko jednego dokumentu, wróć do weryfikacji danych i reguł wysyłki. Jeżeli dotyczy wszystkich dokumentów, bardziej prawdopodobna jest warstwa komunikacyjna.

Najczęstsze błędy

Najczęstszy błąd to poprawianie deklaracji, gdy problem dotyczy certyfikatu albo połączenia. Drugi to zmiana ustawień przekazu bez zapisania poprzedniego adresu.

Uważaj na:

  • pozostawienie starego certyfikatu ZUS,
  • nieaktualne oprogramowanie podpisu kwalifikowanego,
  • blokadę list TSL przez proxy albo antywirusa,
  • zmianę kilku ustawień naraz,
  • ignorowanie harmonogramu przerw technologicznych,
  • wysyłkę dokumentów mimo niejednoznacznych błędów walidacji lub podpisu.

Jeżeli błąd brzmi określono nieprawidłowy typ dostawcy, przejdź do osobnego poradnika błąd “określono nieprawidłowy typ dostawcy”.

Aktualność i weryfikacja

Ten poradnik łączy oficjalne komunikaty ZUS, instrukcję przekazu elektronicznego, harmonogram przerw technologicznych oraz sygnały z forów użytkowników dotyczące weryfikacji certyfikatów i list TSL. Fora traktuj jako sygnał objawu, a decyzje produkcyjne opieraj na komunikatach ZUS i lokalnej polityce IT.

Sprawdzaj: