Komunikat “Value cannot be null” z parametrem uri albo str oznacza, że jeden ze składników programu próbuje użyć pustego adresu, ścieżki lub ustawienia. W Płatniku taki błąd może pojawić się przy problemach z komunikacją, aktualizacją komponentów, protokołem TLS albo niekompletnymi składnikami .NET Framework.

Dla kogo jest ten poradnik

Poradnik jest dla użytkowników, którzy widzą techniczny komunikat w języku angielskim podczas uruchamiania Płatnika, pobierania aktualizacji, komunikacji z ZUS albo pracy z komponentami wymagającymi połączenia sieciowego.

Przed rozpoczęciem

Przygotuj:

  • pełną treść komunikatu błędu,
  • wersję Windows,
  • wersję programu i metrykę,
  • informację, czy problem pojawił się po aktualizacji systemu,
  • dostęp administratora do instalacji składników Windows.

Jeżeli używasz Windows 7, potraktuj środowisko jako szczególnie ryzykowne. Starsze systemy mają więcej problemów z nowymi wymaganiami TLS, certyfikatami i obsługą komunikacji.

Procedura krok po kroku

1. Ustal moment wystąpienia błędu

Zapisz, kiedy pojawia się komunikat:

  • przy starcie programu,
  • przy pobieraniu aktualizacji,
  • przy wysyłce dokumentów,
  • przy weryfikacji certyfikatu,
  • po zmianie systemu lub sieci.

Jeżeli błąd pojawia się tylko przy komunikacji z ZUS, najpierw sprawdź certyfikaty i sieć. Jeżeli przy starcie programu, sprawdź składniki systemowe i konfigurację aplikacji.

2. Sprawdź .NET Framework 4.8 i TLS

Przy aktualizacji danych płatnika albo wysyłce dokumentów błąd może pojawić się w formie Błąd wykonania funkcji SprawdzAktualnoscDanych. Value cannot be null. Parameter name: uri. W starszych środowiskach Windows warto wtedy sprawdzić instalację .NET Framework 4.8, szczególnie gdy problem występuje po aktualizacji programu lub składników komunikacji.

W starszych środowiskach przyczyną może być brak nowszych składników .NET Framework albo nieobsługiwany protokół TLS. Minimalna checklista:

  1. Wykonaj aktualizacje Windows.
  2. Sprawdź, czy zainstalowano .NET Framework 4.8 albo nowszy składnik wymagany w danym środowisku.
  3. Upewnij się, że system obsługuje aktualne protokoły TLS.
  4. Zrestartuj komputer po instalacji składników.
  5. Uruchom Płatnika jako administrator i powtórz operację.

Nie pobieraj nieoficjalnych paczek .NET ani bibliotek z przypadkowych stron. Korzystaj z Windows Update lub oficjalnych źródeł Microsoft.

3. Sprawdź konfigurację komunikacji

Jeżeli problem dotyczy pobierania danych lub wysyłki:

  • sprawdź internet,
  • wyłącz testowo proxy tylko w uzgodnieniu z administratorem,
  • sprawdź certyfikat ZUS,
  • sprawdź listy TSL,
  • zweryfikuj datę i godzinę systemową.

Przy błędach TSL zobacz poradnik Błąd pobierania list TSL i weryfikacji certyfikatu w Płatniku.

4. Porównaj z innym stanowiskiem

Jeżeli w firmie działa drugie stanowisko Płatnika, porównaj:

  • wersję Windows,
  • wersję .NET Framework,
  • ustawienia TLS,
  • konfigurację proxy,
  • wersję programu i metrykę.

Różnice między stanowiskami często szybciej wskazują przyczynę niż ponowna instalacja Płatnika.

Najczęstsze błędy

Najczęstszy błąd to traktowanie komunikatu uri jako problemu z konkretnym dokumentem. Często chodzi o puste lub niedostępne ustawienie techniczne, np. adres usługi, konfigurację aktualizacji albo komponent odpowiedzialny za połączenie.

Uważaj też na:

  • pracę na niewspieranym Windows,
  • brak aktualizacji .NET,
  • blokadę połączeń przez proxy,
  • nieaktualny certyfikat,
  • naprawę bez zapisania dokładnej treści komunikatu.

Aktualność i weryfikacja

Ponieważ błąd może mieć różne przyczyny zależne od systemu, traktuj ten poradnik jako procedurę zawężania problemu. Najważniejsze jest ustalenie, czy komunikat pojawia się przy aktualizacji danych płatnika, przy wysyłce dokumentów, czy przy starcie programu.

Sprawdzaj: