30 października 2026 roku ZUS udostępnił nową metrykę 334 dla programu Płatnik w wersji 10.02.002. To nie jest zwykła aktualizacja: przy pierwszym uruchomieniu trzeba utworzyć klucz szyfrowania, zapisać klucz odzyskiwania dostępu i przekonwertować bazę danych. W wielu firmach konwersja kończy się błędem.

Instrukcję przygotowaliśmy na podstawie oficjalnych materiałów ZUS oraz wskazówek i skryptu naprawczego, które otrzymaliśmy od wsparcia technicznego ZUS w ramach zgłoszenia. IM IT nie jest jednostką ZUS ani jego partnerem, a opisane kroki wykonujesz na własnym komputerze i własnej bazie.

W skrócie:

  1. Zrób kopię zapasową bazy Płatnika i zamknij program na wszystkich komputerach.
  2. Jeśli baza jest na serwerze, aktualizuj najpierw serwer, potem pozostałe stanowiska.
  3. Zapisz klucz odzyskiwania dostępu administratora w bezpiecznym miejscu.
  4. Przygotuj nowe hasło administratora: co najmniej 12 znaków, mała i wielka litera, cyfra i znak specjalny.
  5. Przy błędzie „is dependent on column ‘HASLO’” nie powtarzaj konwersji w ciemno, tylko skorzystaj z naprawy opisanej niżej.

Zanim zaczniesz

  • Kopia zapasowa bazy. Po konwersji baza nie zadziała już ze starszą wersją Płatnika, więc kopia sprzed aktualizacji to jedyna droga powrotu. Przy bazie na SQL Server kopię najlepiej zrobić w SQL Server Management Studio.
  • Zamknięty Płatnik na wszystkich komputerach. W czasie konwersji nikt nie może pracować na bazie.
  • Konto administratora Windows. Utworzenie klucza szyfrowania wymaga uprawnień administratora systemu.
  • Miejsce na klucz odzyskiwania. Firmowy menedżer haseł albo zaklejona koperta w sejfie. Nie kartka na monitorze.
  • Czas. Zaplanuj aktualizację poza godzinami wysyłania dokumentów do ZUS.

Pierwsze uruchomienie po aktualizacji: krok po kroku

Uruchom Płatnik jako Administrator programu. Kolejne okna pojawią się w tej kolejności:

  1. Kreator klucza szyfrowania sekretów. Utwórz nowy klucz albo wybierz Wskaż istniejący klucz szyfrowania sekretów, jeśli klucz został już utworzony na innym komputerze. W kroku z listą użytkowników kliknij Dodaj i dodaj konta Windows wszystkich osób, które pracują w Płatniku.
  2. Generowanie nowego klucza odzyskiwania. Program pokaże długi kod. Zapisz go od razu. Bez niego nie odzyskasz dostępu, jeśli zapomnisz hasła administratora. Klucz dotyczy hasła administratora Płatnika, a nie hasła do bazy danych.
  3. Konwersja bazy danych. Program przebuduje bazę do nowej wersji. Nie przerywaj tego kroku.
  4. Zmiana hasła. Jeśli obecne hasło administratora nie spełnia nowej polityki, program wymusi zmianę.

Klucz odzyskiwania zapisz, zanim klikniesz dalej. Po jego użyciu albo ponownym wygenerowaniu program tworzy nowy klucz, a poprzedni przestaje działać.

Domyślnie hasło administratora jest ważne 30 dni, a użytkownika 90 dni. Możesz to zmienić w menu Administracja → Ustawienia polityki haseł.

Baza na serwerze: najpierw serwer, potem stanowiska

Jeśli kilka osób pracuje na wspólnej bazie na serwerze SQL, aktualizację i konwersję trzeba wykonać na serwerze. Sama aktualizacja Płatnika na komputerze księgowej nie wystarczy, a użytkownik, który uruchomi program przed konwersją, zobaczy błąd.

  1. Zaktualizuj Płatnik na serwerze i przeprowadź konwersję jako Administrator programu.
  2. W kreatorze klucza szyfrowania dodaj konta Windows (albo grupę) wszystkich użytkowników Płatnika. Listę zmienisz później w Administracja → Ustawienia klucza szyfrowania.
  3. Dopiero potem zaktualizuj Płatnik na pozostałych komputerach. Jeśli program zapyta o klucz, wybierz Wskaż istniejący klucz szyfrowania sekretów.
  4. Jeśli ktoś po aktualizacji nie może połączyć się z bazą, sprawdź najpierw, czy jego konto Windows jest na liście użytkowników klucza.

Gdy aktualizacja się nie pobiera

ZUS opisał ręczne wczytanie pakietu. Odrzuć automatyczne pobieranie, pobierz pakiet metryki 334 dla wersji 10 ze strony ZUS – Pobierz program Płatnik i rozpakuj go. Potem w Płatniku wybierz Administracja → Aktualizuj komponenty programu – z dysku…, wskaż plik metryki z rozpakowanego folderu i uruchom program ponownie. Na tej samej stronie ZUS udostępnia też narzędzie P2StartFix2.exe, które pomaga, gdy aktualizacja się nie pobiera.

Najczęstsze komunikaty i co oznaczają

„Wersja bazy danych jest niezgodna z aktualną wersją programu”

Baza nie została jeszcze przekonwertowana, a program uruchomił zwykły użytkownik. Zaloguj się jako Administrator Płatnika i przeprowadź konwersję (przy bazie na serwerze: na serwerze).

„Nie znaleziono aktywnego klucza odzyskiwania dostępu administratora programu”

To nie błąd, tylko normalny krok przy pierwszym uruchomieniu. Program wygeneruje klucz. Zapisz go.

„The object ‘PK__HISTORIA__…’ is dependent on column ‘HASLO’”

Konwersja zatrzymuje się na tabeli z historią haseł. Przyczyną jest nazwa klucza głównego tej tabeli: na części instalacji SQL Server nadał jej automatyczną nazwę, której konwerter się nie spodziewa. Często towarzyszy temu ogólny komunikat „Podczas pracy kreatora wystąpił błąd!”. Naprawę opisujemy w następnej sekcji.

„Wersja bazy danych nie została rozpoznana przez funkcję konwersji”

To inny problem niż powyżej i skrypt z tej instrukcji go nie rozwiązuje. Nie próbuj kolejnych poprawek znalezionych w sieci. Przywróć kopię sprzed aktualizacji i skontaktuj się z ZUS albo z nami.

Naprawa błędu „PK__HISTORIA… is dependent on column ‘HASLO’”

W sieci krąży wiele samodzielnych poprawek tego błędu. Nie zawsze wiadomo, czy nie spowodują kolejnych problemów przy następnych aktualizacjach. Poniżej opisujemy skrypt, który otrzymaliśmy od wsparcia technicznego ZUS w odpowiedzi na nasze zgłoszenie.

Co robi skrypt: odczytuje nazwę klucza głównego tabeli HISTORIA, usuwa go i zakłada ponownie pod nazwą HIST_PK na tych samych kolumnach. Dodatkowo poszerza kolumnę WARTOSC1 w tabeli PARAM_KONF. Jeśli tabela HISTORIA nie ma klucza głównego, skrypt niczego nie zmienia.

Kiedy go użyć: tylko wtedy, gdy konwersja zatrzymała się dokładnie na komunikacie „The object ‘PK__HISTORIA__…’ is dependent on column ‘HASLO’”. Przy innych błędach go nie uruchamiaj.

Jak przeprowadzić naprawę:

  1. Zamknij Płatnik na wszystkich komputerach.
  2. Zrób pełną kopię zapasową bazy Płatnika w SQL Server Management Studio.
  3. Zaloguj się do SQL Server kontem z uprawnieniami administratora.
  4. Otwórz nowe okno zapytania i na liście baz wybierz bazę Płatnika (domyślnie PLATNIK). Skrypt nie wybiera bazy sam.
  5. Wklej skrypt i uruchom go (F5). W wynikach zobaczysz starą nazwę klucza i wykonane polecenie.
  6. Uruchom Płatnik jako Administrator i ponownie przeprowadź konwersję bazy.
DECLARE @PKName NVARCHAR(255);
DECLARE @SQLString NVARCHAR(500);

SELECT TOP 1 @PKName = kc.name
FROM sys.key_constraints kc
WHERE kc.parent_object_id = OBJECT_ID(N'[dbo].[HISTORIA]')
AND kc.type = 'PK';

select @PKName;

IF @PKName IS NOT NULL
BEGIN
    SET @SQLString = N'ALTER TABLE dbo.HISTORIA DROP CONSTRAINT ' + @PKName;

    select @SQLString;

    EXECUTE sp_executesql
        @SQLString;

    ALTER TABLE dbo.HISTORIA ADD CONSTRAINT HIST_PK PRIMARY KEY (ID_UZYTKOWNIK, HASLO);
    ALTER TABLE dbo.PARAM_KONF ALTER COLUMN WARTOSC1 VARCHAR(255);
END;

Nie zmieniaj skryptu i nie łącz go z innymi poprawkami z internetu. Jeśli po jego uruchomieniu konwersja nadal się nie udaje, przywróć kopię zapasową i skontaktuj się z ZUS albo z nami.

Wolisz, żebyśmy zrobili to za Ciebie?

Gdy wszystko idzie dobrze, aktualizacja Płatnika z konwersją bazy nie zajmuje dużo czasu. Gdy coś pójdzie źle, w księgowości staje wysyłka dokumentów do ZUS.

Naprawę błędów konwersji bazy danych Płatnika przeprowadzimy zdalnie od 325 zł netto za bazę. W ramach usługi:

  • robimy kopię zapasową bazy przed zmianami,
  • diagnozujemy błąd konwersji na serwerze,
  • naprawiamy bazę i przeprowadzamy konwersję do nowej wersji,
  • sprawdzamy, czy Płatnik łączy się z przekonwertowaną bazą.

Aktualizację Płatnika na pozostałych komputerach i konfigurację klucza szyfrowania dla użytkowników możemy wykonać dodatkowo, po indywidualnej wycenie.

Korzystamy z pomocy zdalnej, więc nie musisz czekać na technika na miejscu. Napisz do nas lub zadzwoń: 22 188 13 62.

Źródła

Może Cię zainteresować: