Przed aktualizacją lub zgłoszeniem błędu zapisz numer wersji Płatnika i stan metryki. Numer instalatora nie mówi, jakie aktualizacje pobrał działający program; te informacje sprawdzaj na stanowisku, którego dotyczy problem.

Jeżeli planujesz aktualizację, najpierw wykonaj kopię bazy Płatnika.

Procedura krok po kroku

1. Odczytaj wersję programu

Wersję programu sprawdzaj zawsze w samym Płatniku, a nie na podstawie nazwy starego pliku instalacyjnego. Zapisz dokładny numer wersji, bo to on pozwala porównać środowisko z publikacjami ZUS.

Zanotuj:

  • numer wersji programu,
  • datę sprawdzenia,
  • nazwę stanowiska lub serwera,
  • typ bazy danych,
  • osobę wykonującą weryfikację.

2. Sprawdź metrykę i komponenty

Sama wersja programu nie wystarcza do diagnostyki. ZUS publikuje też komunikaty o wdrożeniu nowych metryk. W oknie sprawdzonym dla tego artykułu ZUS informował między innymi o:

  • metryce 320 z 23 stycznia 2026 r., powiązanej z nowym certyfikatem ZUS,
  • metryce 321 wdrażanej 30 stycznia 2026 r., która aktualizowała parametry składki zdrowotnej dla 2026 roku,
  • wdrożeniu z 24 kwietnia 2026 r., które wymagało konwersji bazy danych i dodawało pola do rocznego rozliczenia składki zdrowotnej w dokumentach ZUS DRA i ZUS RCA,
  • metryce 325 z 4 maja 2026 r., która rozwiązuje problem części płatników używających podpisu osobistego (e-dowód) przy pobieraniu aktualizacji danych z ZUS,
  • problemach z pobraniem pakietu 325 zgłoszonych 5 maja 2026 r. oraz pliku naprawczym Fix2 udostępnionym 6 maja 2026 r.,
  • metryce 326 wdrażanej 8 maja 2026 r., która zmienia słownik schematów podlegania ubezpieczeniom dla kodu tytułu ubezpieczenia 24 00 00,
  • metryce 327 wdrożonej 26 czerwca 2026 r., która zmienia weryfikację kodów PKD 2025 wykazywanych w dokumencie ZUS IWA.

Dlatego po sprawdzeniu wersji od razu zanotuj także:

  • numer albo datę ostatniej metryki,
  • informację, czy aktualizacja przebiegła automatycznie,
  • czy po zmianie działa komunikacja elektroniczna,
  • czy w tym samym czasie był aktualizowany certyfikat ZUS,
  • czy po aktualizacji była wymagana konwersja bazy,
  • czy środowisko korzysta z podpisu osobistego (e-dowód).

Jeżeli masz kilka stanowisk, porównaj wyniki między nimi. Rozbieżność wersji albo metryki często tłumaczy, dlaczego problem występuje tylko na jednym komputerze.

3. Zapisz dane potrzebne do zgłoszenia lub aktualizacji

Zapisz w krótkiej notatce administracyjnej:

  • wersję programu,
  • wersję lub stan metryki,
  • system operacyjny,
  • typ bazy: Access albo SQL Server,
  • datę ostatniego backupu,
  • informację, czy certyfikat ZUS był ostatnio odświeżany.

Jeżeli zmieniasz środowisko, przejdź do poradników aktualizacji Płatnika albo przeniesienia na nowy komputer.

Jeżeli na stanowisku używasz e-dowodu i problem dotyczy pobierania aktualizacji danych z ZUS, porównaj datę wystąpienia błędu z komunikatem o metryce 325 z 4 maja 2026 r. oraz późniejszym komunikatem o pliku Fix2. Wtedy sama informacja “mam wersję 10.02.002” nie wystarczy.

Jeżeli obsługujesz dokumenty z kodem tytułu ubezpieczenia 24 00 00, sprawdź dodatkowo, czy środowisko pobrało metrykę 326 wdrażaną 8 maja 2026 r. ZUS wskazał, że ta metryka dotyczy słownika schematów podlegania ubezpieczeniom dla tego kodu.

Jeżeli przygotowujesz dokument ZUS IWA, upewnij się, że środowisko pobrało metrykę 327. ZUS wskazał, że aktualizacja dotyczy weryfikacji kodów PKD 2025 wykazywanych w tym dokumencie. Sam numer metryki nie rozstrzyga jednak, której klasyfikacji należy użyć dla konkretnego okresu sprawozdawczego. Przed uzupełnieniem dokumentu sprawdź aktualną instrukcję ZUS właściwą dla składanego roku.

Najczęstsze błędy

Przy diagnostyce unikaj:

  • sprawdzanie wersji tylko na podstawie archiwalnego instalatora,
  • brak porównania między stanowiskami,
  • pomijanie metryki jako elementu diagnostyki,
  • brak zapisu daty i osoby wykonującej kontrolę,
  • mieszanie problemów wersji z problemami certyfikatu.

Jeżeli środowisko ma poprawną wersję, a mimo to występują błędy wysyłki, następnym krokiem powinien być poradnik o certyfikacie ZUS w programie Płatnik.

Aktualność i weryfikacja

Powyższe przykłady dotyczą komunikatów ZUS od 23 stycznia do 25 czerwca 2026 r. Ostatni z nich opisuje metrykę 327 dla wersji 10.02.002. Według weryfikacji z 13 sierpnia 2026 r. strona pobierania ZUS udostępniała również plik metryka.xml w wersji 327. Te dane opisują stan historyczny; przed aktualizacją sprawdź nowsze publikacje ZUS.

Sprawdzaj: