Płatnik zgłasza Value cannot be null. Parameter name: uri? Zapisz pełny komunikat i czynność, przy której się pojawia. Sam parametr uri nie wskazuje jeszcze, czy problem dotyczy połączenia z ZUS, aktualizacji czy składników stanowiska Windows.

Ta instrukcja służy zawężeniu błędu przy uruchamianiu Płatnika, pobieraniu aktualizacji lub komunikacji z ZUS.

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, traktuj to ś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ź składniki Windows, gdy błąd pojawia się przy połączeniu

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 sprawdź, czy nie brakuje wymaganych składników .NET Framework lub obsługi protokołu TLS. Sam komunikat nie potwierdza tej przyczyny. Kolejność:

  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. Powtórz czynność, która wywołała błąd.

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ę.

Porównanie stanowisk często szybciej wskazuje 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

Błąd może mieć różne przyczyny zależne od systemu. Najpierw ustal, czy pojawia się przy aktualizacji danych płatnika, wysyłce dokumentów czy starcie programu.

Sprawdzaj: