
Aktualizacja Płatnika do metryki 334 potrafi zamienić jedno kliknięcie „Tak” w całe popołudnie walki. U mnie skończyło się na sześciu różnych błędach, a wszystko w piątek przed terminem DRA.
Poniżej opisuję, co się sypało, dlaczego i co pomagało. Jeśli dopiero masz aktualizację przed sobą, zacznij od checklisty. Jeśli już utknąłeś, przewiń do swojego komunikatu błędu.
Co zmienia metryka 334
ZUS wdrożył metrykę 334 dla Płatnika 10.02.002 pod koniec października 2026 r. To przede wszystkim zmiany w bezpieczeństwie. Przy pierwszym uruchomieniu Administrator Płatnika przechodzi przez:
- Kreator klucza szyfrowania sekretów. Klucz jest przypisany do kont Windows, a nie do kont w Płatniku. To najważniejsze zdanie w całym wpisie.
- Klucz odzyskiwania dostępu administratora. Jedyny ratunek, gdy zapomnisz hasła admina.
- Konwersję bazy danych. Jest nieodwracalna, więc bez kopii nie ma odwrotu.
- Zmianę hasła, jeśli obecne nie spełnia nowej polityki: domyślnie minimum 12 znaków, mała i wielka litera, cyfra i znak specjalny.
Szczegóły są w dokumencie ZUS o metryce 334.
Zanim klikniesz „Tak”
Pięć minut przygotowań oszczędzi Ci kilku godzin. Ja ich nie zrobiłem, więc wiem, o czym piszę.
- Kopia bazy. Przy bazie SQL zrób backup w SSMS (prawy klik na bazie → Tasks → Back Up) i zapisz plik
.bakpoza tym komputerem. - Zamknij Płatnika na pozostałych stanowiskach, jeśli pracujecie na wspólnej bazie.
- Sprawdź, na jakim koncie Windows pracujesz:
Win + R→cmd→whoami. Zapisz wynik, przyda się w kreatorze. - Przygotuj miejsce na klucz odzyskiwania: menedżer haseł albo wydruk w sejfie. Nie plik na pulpicie tego samego komputera.
- Pobierz z góry paczkę metryki 334 (plik „metryka.xml v.334 (zip)” ze strony pobierania Płatnika). Gdy automat się zawiesi, będzie pod ręką.
- Nie rób tego w dniu terminu. Zostaw sobie zapas na eZUS, gdyby coś poszło nie tak.
Problemy i rozwiązania
Każdy problem poniżej to komunikat, który naprawdę zobaczyłem na ekranie, w kolejności, w jakiej przychodziły.
1. Automatyczna aktualizacja wisi albo trwa wieki
ZUS sam to przyznał w komunikacie z 2 listopada. Rozwiązaniem jest ręczna instalacja metryki:
- Gdy Płatnik zaproponuje pobranie aktualizacji, kliknij Nie.
- Rozpakuj paczkę metryki 334 do dowolnego folderu.
- Wybierz Administracja → Aktualizuj komponenty programu – z dysku… → Pobierz aktualizację i wskaż
metryka_X.xml. - Uruchom Płatnika ponownie.
2. Kreator klucza szyfrowania wraca przy każdym uruchomieniu
Przyczyna: kreator przeszedł na koncie administratora Windows, a pracujesz na innym koncie. Twoje konto nie ma dostępu do klucza, więc Płatnik uznaje, że klucza nie ma, i zaczyna od nowa.
- Uruchom Płatnika jako administrator Windows (ten jeden raz celowo).
- W kroku 2/3 kreatora dodaj konto, na którym faktycznie pracujesz, czyli to z
whoami. - Konto domenowe? W oknie wyboru kliknij „Lokalizacje…” i wybierz domenę, nie nazwę komputera.
KOMPUTER\janiFIRMA\janto dla Windows dwie różne osoby. - Przy kilku użytkownikach wygodniej dodać grupę domenową, np. „Płatnik-Użytkownicy”. „Domain Users” też zadziała, ale wtedy klucz widzi cała firma.
3. „Nie znaleziono certyfikatów” przy wyborze podpisu kwalifikowanego
Magazyn certyfikatów Windows jest osobny dla każdego konta. Gdy Płatnik działa przez „Uruchom jako administrator”, zagląda do magazynu konta administratora, a Twój certyfikat siedzi w magazynie Twojego konta.
- Uruchom
certmgr.msc(zwykłym kliknięciem) i zajrzyj do Osobisty → Certyfikaty. - Certyfikatu nie ma → problem jest w oprogramowaniu do karty. Zarejestruj certyfikat w systemie z programu wystawcy albo zaloguj się ponownie w SimplySign Desktop.
- Certyfikat jest → uruchom Płatnika normalnie, bez „jako administrator”. Sprawdź też, czy certyfikat ma klucz prywatny i nie wygasł.
4. „Program Płatnik nie jest w stanie rozpoznać wersji bazy danych”
To pojawiło się u mnie po reinstalacji. Instalator wrzuca wersję podstawową, a baza jest już przekonwertowana do 334, więc program jest starszy niż baza. Płatnik aktualizuje się dopiero po podłączeniu do bazy, więc robi się błędne koło.
Wyjście przez bazę tymczasową:
- Nie twórz nowej bazy o nazwie swojej właściwej bazy i niczego nie nadpisuj.
- W kreatorze połączenia utwórz nową, tymczasową bazę Access w osobnym folderze, np.
C:\PlatnikTemp. - Na bazie tymczasowej wgraj metrykę 334 z dysku (patrz problem 1).
- Przejdź kreator klucza i podłącz z powrotem swoją bazę SQL.
Kartoteka w bazie tymczasowej wymaga prawdziwego NIP i REGON, bo Płatnik sprawdza sumy kontrolne. Z tej bazy niczego nie wysyłaj do ZUS. Alternatywą jest mały program naprawczy P2StartFix.exe ze strony ZUS, który wymusza aktualizację.
5. „[DBNETLIB] Serwer SQL nie istnieje lub odmówiono do niego dostępu”
Płatnik w ogóle nie dochodzi do serwera SQL.
- Sprawdź usługę:
sc query MSSQL$SQLEXPRESSma pokazaćRUNNING. - Sprawdź nazwę serwera w kreatorze:
.\SQLEXPRESSdla SQL na tym komputerze,SERWER\SQLEXPRESSdla zdalnego. - Sprawdź, czy Twoje konto ma login w SQL:
sqlcmd -S .\SQLEXPRESS -E -Q "SELECT name FROM sys.databases".
6. „Nastąpił problem przy wołaniu funkcji WerDok … Nie odnaleziono metody ASSECO.LOGOWANIE.LOG”
Pomieszane wersje plików programu: jedna biblioteka DLL woła funkcję, której druga w tej wersji nie ma. U mnie wyskoczyło przy weryfikacji kartoteki po reinstalacji „na wierzch”.
- Zainstaluj Visual Studio 2010 Tools for Office Runtime (
vstor_redist.exeze strony Microsoftu). - W folderze Płatnika uruchom jako administrator
ASSECO.ASSEMBLY.COM.REG.bat, który rejestruje biblioteki. - Nie pomogło? Czysta reinstalacja: odinstaluj, przenieś pozostały folder programu w bezpieczne miejsce, sprawdź, czy w Panelu sterowania nie został drugi wpis Płatnika, uruchom ponownie komputer i zainstaluj od zera.
Gdy Płatnik nie wstaje, a termin się zbliża, dokumenty rozliczeniowe możesz wysłać przez eZUS → ePłatnik z profilem zaufanym albo podpisem kwalifikowanym. Dane w bazie Płatnika nigdzie nie uciekną. Infolinia ZUS dla Płatnika: 22 560 16 00. Podaj im dokładny komunikat błędu i numer metryki.
Co zrobiłbym inaczej
- Nie reinstalowałbym na ślepo. Reinstalacja zamieniła mi jeden problem w trzy kolejne. Najpierw diagnoza, potem młotek.
- Nie uruchamiałbym Płatnika „jako administrator” na co dzień. Klucz szyfrowania i certyfikaty są przypisane do konkretnego konta Windows, więc po przełączeniu się na inne konto Płatnik ich „nie widzi”.
- Kopię bazy robiłbym przed pierwszym kliknięciem, a nie w trakcie pożaru.
- Aktualizację robiłbym na spokojnie, nie w piątek przed terminem DRA.
Zakończenie
Żeby wykluczyć problem z samym programem, sprawdziłem całą procedurę na osobnym komputerze, podłączonym do innej sieci. Tam aktualizacja do metryki 334 przeszła bez większych przygód. To podpowiedź, gdzie szukać: nie tylko w Płatniku, ale też w sieci, przez którą się aktualizuje.
Restrykcyjnie ustawiony firewall może po cichu ograniczać aktualizacje. Filtrowanie stron, inspekcja ruchu HTTPS albo blokowanie pobierania plików potrafią przerwać lub uszkodzić paczkę ściąganą z serwerów ZUS, a Płatnik nie zawsze powie, co naprawdę poszło nie tak. Jeśli aktualizacja wisi albo kończy się dziwnymi błędami, sprawdź logi firewalla i na czas aktualizacji dodaj wyjątek dla serwerów ZUS, zamiast wyłączać całą ochronę.