Program Płatnik nie jest w stanie rozpoznać wersji bazy danych – jak naprawić?

Komunikat „Program Płatnik nie jest w stanie rozpoznać wersji bazy danych” najczęściej pojawia się po niepełnej aktualizacji oprogramowania, uszkodzeniu plików konfiguracyjnych lub problemach z uprawnieniami. Przyczyną jest rozbieżność między strukturą bazy a oczekiwaniami uruchomionej wersji – program nie może bezpiecznie odczytać metadanych. Z tego artykułu dowiesz się, jak krok po kroku przywrócić sprawność środowiska bez ryzyka utraty dokumentów.

Co oznacza ten błąd i dlaczego występuje

Gdy Płatnik zgłasza nierozpoznaną wersję bazy, nie chodzi wyłącznie o chwilową usterkę startową. System sprawdza spójność pomiędzy własnym kodem a fizyczną strukturą przechowującą deklaracje, dane płatników oraz ustawienia konfiguracyjne. Problem ten może wystąpić po instalacji nowszej wersji programu, gdy aktualizacja nie zakończyła się pełną konwersją bazy, lub gdy użytkownik przez pomyłkę uruchomił starszą kopię aplikacji wskazującą na już przekształconą bazę.

Innymi typowymi przyczynami są awarie usługi SQL Server, zmiana nazwy serwera po przeniesieniu komputera, czy też zablokowanie konta używanego przez Płatnika. Nawet pozorna drobnostka, taka jak brak uprawnień administratora do konwersji, potrafi zatrzymać proces logowania. W środowiskach wielostanowiskowych dodatkowym czynnikiem bywa otwarta baza przez innego użytkownika w trakcie aktualizacji.

Dlatego podejście do naprawy musi zaczynać się od ustalenia aktualnego stanu: jaka wersja programu faktycznie jest uruchomiona, gdzie fizycznie znajduje się baza i czy jej struktura została już zmodyfikowana przez wcześniejsze próby naprawcze. Warto też odróżnić sytuację, w której baza jest nowsza od programu (np. po nieudanej reinstalacji) od tej, gdy program jest nowszy od bazy – różne scenariusze wymagają innych działań.

Zabezpieczenie danych przed rozpoczęciem diagnostyki

Pierwszym i bezwzględnym warunkiem jest wykonanie kopii zapasowej bazy. Bez tego żadne ręczne ingerencje nie są bezpieczne – ryzyko trwałej utraty dokumentów jest realne. W przypadku bazy SQL Server kopię powinien utworzyć administrator przy użyciu Management Studio. Dla bazy Access wystarczy skopiować plik .mdb na bezpieczny nośnik, upewniając się jednocześnie, że nie jest to jedynie skrót do katalogu programu. Zanotuj przy tym: datę i godzinę backupu, lokalizację bazy, typ bazy (Access lub SQL Serwer), nazwę instancji SQL (jeśli dotyczy), wersję programu Płatnik oraz pełną treść komunikatu błędu.

Zabezpieczenie danych to nie tylko kopia, ale i świadomość, że każda następna czynność może ją unieważnić. Dlatego po utworzeniu backupu nie instaluj ponownie programu, nie usuwaj katalogów Asseco, nie modyfikuj ręcznie tabel ani nie uruchamiaj żadnych skryptów naprawczych bez ponownego potwierdzenia, że masz aktualną kopię. Działania w pośpiechu prowadzą do sytuacji, w której odzyskanie danych staje się znacznie trudniejsze.

Nie wykonuj reinstalacji, usuwania bazy ani ręcznych zmian w SQL bez aktualnej kopii zapasowej. Takie działania mogą trwale zniszczyć strukturę danych i utrudnić ich późniejsze odtworzenie.

Sprawdzenie wersji i oficjalnych komponentów

Na początku 2026 roku ZUS wdrożył metrykę 320 dla programu Płatnik 10.02.002 i to ta wersja jest obecnie obowiązująca. Należy upewnić się, że instalator został pobrany wyłącznie z oficjalnej strony ZUS i że podczas aktualizacji nie wystąpiły przerwy. Metryka pobierana jest automatycznie, jednak gdy połączenie zostanie zerwane (np. przez firewall lub program antywirusowy), program może uruchomić się z niekompletnym zestawem plików. Dlatego po komunikacie o błędzie dobrze jest zweryfikować, czy w ogóle dysponujemy plikami dla poprawnej metryki.

Wiele zgłoszeń na forach wskazuje, że winowajcą bywa właśnie nieaktualny komponent NUpdater i związany z nim błąd weryfikacji podpisu metryki. Ściągnięcie pliku P2StartFix.exe i uruchomienie go jako administrator często resetuje mechanizm aktualizacji, pozwalając programowi pobrać właściwe biblioteki. Równocześnie należy sprawdzić, czy na danym stanowisku nie pozostały wpisy rejestru wskazujące na starą wersję – konkretnie wartość DataPobraniaPakiety w kluczu HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Asseco Poland SA\Płatnik\10.02.002\Parametry. Wyczyszczenie tego pola i ponowne uruchomienie Płatnika wymusza świeże pobranie aktualizacji.

Rola P2StartFix

Narzędzie P2StartFix zostało przygotowane właśnie na wypadek zatrzymania procesu aktualizacji. Po jego użyciu Płatnik przy starcie samoczynnie ściąga brakujące komponenty i przeprowadza ewentualną konwersję bazy. W sieciowych środowiskach z SQL Serverem często wystarczy zastosować go na serwerze, a następnie uruchomić program na stacjach roboczych – pod warunkiem że konwersja bazy została już wykonana w całości.

Jeśli jednak po uruchomieniu P2StartFix wciąż pojawia się błąd, warto podejść do problemu od strony czystej instalacji testowej bazy Access i stopniowego przejścia na docelową bazę. Ten sposób został opisany w dalszej części.

Diagnostyka krok po kroku

Zanim przejdziesz do ponownej instalacji, wykonaj sekwencję testów – pojedynczo, obserwując czy objaw ulega zmianie. Pozwala to uniknąć nadpisywania kilku błędów jednocześnie i ułatwia identyfikację faktycznej przyczyny. Oto kolejność zalecana na podstawie udokumentowanych przypadków:

• Wykonaj kopię bazy lub potwierdź jej istnienie.
• Zapisz dokładną treść komunikatu (często zawiera nazwę serwera i instancji).
• Upewnij się, że uruchamiasz właściwy skrót do właściwej instalacji – zwłaszcza po aktualizacji może dojść do zmiany ścieżek.
• Pobierz najnowszą wersję z oficjalnej strony ZUS i porównaj z numerem wersji wyświetlanej w programie (jeśli program w ogóle się uruchamia).
• Uruchom Płatnika jako administrator Windows – prawym przyciskiem myszy na ikonie, wybierz „Uruchom jako administrator”.
• W przypadku SQL Servera sprawdź, czy usługa działa i czy nazwa instancji jest dostępna z danego komputera (można użyć zapytania SELECT name, compatibility_level FROM sys.databases WHERE name = 'PlatnikDB'; w SSMS).
• Dla bazy Access zweryfikuj, czy plik fizycznie istnieje i nie został przeniesiony do innego katalogu.
• Sprawdź, czy inny użytkownik nie ma otwartej bazy – szczególnie istotne podczas aktualizacji.
• Spróbuj ponownie uruchomić aktualizację online z menu narzędzi, pod warunkiem że program pozwoli się zalogować.

Znaczenie uprawnień administratora

Konwersja bazy danych to operacja wymagająca pełnych praw administracyjnych na poziomie systemu operacyjnego i samej bazy. Jeśli logujesz się jako zwykły użytkownik, Płatnik nie będzie mógł zmodyfikować struktury tabel. Z tego powodu w firmach często problem rozwiązuje się, logując się na konto Administratora i z tego poziomu wykonując pierwsze uruchomienie po aktualizacji. Na stacjach roboczych, które łączą się z centralną bazą SQL, wystarczy, że konwersja zostanie przeprowadzona raz na serwerze – pozostałe komputery dostrzegą już zmienioną strukturę.

W przypadku baz Access umieszczonych na udziałach sieciowych, użytkownik wykonujący konwersję musi mieć prawo zapisu do katalogu z plikiem .mdb. Gdy prawa są ograniczone, można czasowo skopiować bazę na lokalny dysk, przeprowadzić konwersję na komputerze z pełnymi uprawnieniami, a następnie podmienić plik na udziale. Oczywiście każdą taką operację należy poprzedzić backupem.

Jeżeli nie masz uprawnień administratora, zatrzymaj się na zebraniu informacji. Próba naprawy bez dostępu administracyjnego często kończy się dodatkowymi zmianami, których później nikt nie potrafi odtworzyć.

Metoda z nową bazą Access i aktualizacją z pliku

To rozwiązanie wielokrotnie potwierdzane przez użytkowników forów polega na odbudowaniu środowiska od zera na testowej bazie Access, a później przełączeniu się na właściwą bazę. Działa zwłaszcza wtedy, gdy inne metody (P2StartFix, czyszczenie rejestru) nie przyniosły skutku. Poniżej szczegółowa instrukcja:

1. Odinstaluj Płatnika i zrestartuj komputer.
2. Usuń ręcznie pozostałości katalogów Asseco w Program Files i ProgramData (ten drugi jest domyślnie ukryty).
3. Pobierz oficjalny instalator Płatnika 10.02.002 oraz plik P2StartFix.exe.
4. Uruchom instalację jako administrator. Podczas wyboru typu bazy danych zaznacz Access i koniecznie wybierz opcję Utwórz nową bazę.
5. Po zakończeniu instalacji nie uruchamiaj programu – zamiast tego odpal P2StartFix.
6. Uruchom Płatnika (bez pobierania nowej wersji online) i zaloguj się do nowej, pustej bazy Access. Załóż fikcyjnego płatnika (wprowadź dowolny NIP, dane adresowe), zweryfikuj go i wybierz do kontekstu.
7. Przejdź do menu Narzędzia → Instalacja nowej wersji z pliku. Wskaż wcześniej pobrany i rozpakowany plik metryka.xml.
8. Po instalacji aktualizacji z pliku uruchom program ponownie i pozwól mu zaktualizować bazę testową do bieżącej struktury.
9. Następnie uruchom aktualizację online (Narzędzia → Aktualizacja) – tym razem program pobierze najnowsze komponenty.
10. Gdy wszystko przejdzie pomyślnie, poprzez menu Administracja → Ustawienia bazy danych zmień bazę na właściwą (SQL lub Access). Program powinien ją rozpoznać i ewentualnie przeprowadzić konwersję.

Wielu użytkowników pomija kroki z aktualizacją z pliku (punkty 7–8) i od razu próbuje przełączyć się na starą bazę – to ryzykowne, bo nie gwarantuje, że aktualna struktura programu pasuje do tej bazy. Dlatego warto przejść całą ścieżkę, nawet jeśli wydaje się czasochłonna.

Jeśli w trakcie instalacji nowej wersji z pliku wyskakuje błąd „Błąd weryfikacji metryki”, może to oznaczać, że data systemowa została zmieniona ręcznie lub plik metryki jest niekompletny. W takim przypadku przywróć aktualną datę systemową i pobierz komponenty słownikowe bezpośrednio z serwera ZUS.

Postępowanie z bazą SQL Server

W środowiskach korzystających z SQL Servera po udanej aktualizacji na serwerze może zdarzyć się, że niektóre stacje robocze nie widzą poprawnej struktury bazy. Przyczyną zazwyczaj jest lokalny rejestr, który wciąż przechowuje starą datę pobrania pakietów. Na tych komputerach należy wyczyścić wartość DataPobraniaPakiety – ręcznie przez regedit lub uruchamiając skrypt .reg odpowiadający bitowości systemu – a następnie uruchomić Płatnika jako administrator. Po wymuszeniu aktualizacji stacja odczyta już bazę prawidłowo.

Czasami problem dotyczy bezpośrednio poziomu zgodności bazy w SQL Serverze – szczególnie po migracji między różnymi wersjami silnika. W Management Studio można podejrzeć aktualny poziom zapytaniem SELECT name, compatibility_level FROM sys.databases WHERE name = 'PlatnikDB';. Jeśli administrator po analizie stwierdzi konieczność zmiany, może wykonać polecenie ALTER DATABASE PlatnikDB SET COMPATIBILITY_LEVEL = 150; dla SQL Server 2019, uprzednio robiąc backup. Nie jest to jednak pierwszy krok – przed takim działaniem trzeba ustalić, czy to rzeczywiście poziom zgodności blokuje rozpoznanie bazy.

Sprawdzanie uprawnień konta SQL

Zdarza się, że konto używane przez Płatnika do łączenia z bazą straciło uprawnienia po reinstalacji lub po zmianach w domenie. Aby to zweryfikować, można w SSMS uruchomić diagnostyczne zapytanie:

SELECT dp.name, dp.type_desc, dpr.permission_name FROM sys.database_principals dp JOIN sys.database_permissions dpr ON dp.principal_id = dpr.grantee_principal_id WHERE dp.name = 'platnik_user’;

Jeśli wynik wskazuje na brak uprawnień do tworzenia tabel w docelowej bazie, administrator może nadać je jawnie, przypisując konto do roli db_owner: ALTER ROLE db_owner ADD MEMBER platnik_user;. Oczywiście przed taką modyfikacją trzeba potwierdzić, że konto faktycznie dotyczy danej instalacji i że baza jest produkcyjna.

Unikaj ręcznych zmian w strukturze bazy

Modyfikacje tabel, kolumn, poziomu zgodności czy plików danych bez pełnej wiedzy o środowisku są niebezpieczne. Dotyczy to zwłaszcza poleceń wykonywanych w SQL Server Management Studio, które mogą trwale zmienić relacje między obiektami. Jeżeli nie rozumiesz, jak odtworzyć backup i nie masz zgody właściciela danych, nie podejmuj się ręcznego poprawiania struktury. Priorytetem na etapie błędu jest zachowanie danych – szybkie usunięcie komunikatu może prowadzić do większych problemów przy kolejnej aktualizacji.

Wszelkie działania ręczne (ALTER DATABASE, kasowanie tabel, odtwarzanie backupu RESTORE) zostaw na koniec i tylko dla osoby, która udokumentuje każdy krok. Bezpieczne odtworzenie bazy wymaga znajomości ścieżek i nazw plików backupu, a te mogą się różnić w zależności od konfiguracji serwera.

Jeżeli baza zawiera realne dane płatnika i ubezpieczonych, priorytetem jest zachowanie danych, a nie szybkie usunięcie komunikatu.

Dodatkowe elementy do sprawdzenia

Oprócz samego Płatnika, na poprawne działanie wpływają również komponenty systemowe. Po reinstalacji systemu Windows 10 lub 11 warto zweryfikować obecność Microsoft .NET Framework w wersji co najmniej 4.7.2, a także pakietu redystrybucyjnego Microsoft Visual C++ 2010 SP1. Obydwa składniki są niezbędne do działania bibliotek Płatnika i ich brak może powodować subtelne błędy uniemożliwiające aktualizację. Ponadto parser XML 6.0 powinien być zainstalowany w wersji zgodnej z architekturą systemu (x86 lub x64).

Nie bez znaczenia jest też konfiguracja firewalla i oprogramowania antywirusowego. Podczas testów warto je tymczasowo wyłączyć, aby wykluczyć blokowanie ruchu do serwerów ZUS. Wiele przypadków, gdzie po reinstalacji program nie mógł pobrać metryki, zostało rozwiązanych właśnie przez dodanie plików Płatnika do wyjątków zabezpieczeń.

Oficjalne źródła i pobieranie

Wszelkie pliki instalacyjne i narzędzia naprawcze pobieraj wyłącznie z witryny ZUS: https://www.zus.pl/firmy/program-platnik/. Znajdziesz tam aktualną wersję 10.02.002 oraz narzędzie P2StartFix. Metryka i słowniki dostępne są także na serwerze ftp1.zus.gda.pl w katalogu dystrybucja/slowniki. Bezpośredni link do poprawki: https://pobierz2.zus.pl/dystrybucja/a1_10_02_002/dodatki/P2StartFix.exe. Pamiętaj, że rozpakowany plik metryki musi pochodzić z tej samej wersji co program – w przeciwnym razie aktualizacja z pliku zakończy się błędem weryfikacji.

Jeśli podczas pobierania aktualizacji z poziomu programu pojawia się „błąd pobierania”, często pomaga właśnie P2StartFix lub ręczne wyczyszczenie daty w rejestrze. W skrajnych przypadkach, gdy serwer aktualizacyjny ZUS jest przeciążony, można zmienić tymczasowo datę systemową na wcześniejszą, pobrać metrykę, a później przywrócić właściwą datę.