Częste przyczyny problemów

Należy odinstalować program i zainstalować ponownie z aktualnego instalatora, instalator należy uruchomić „jako administrator".

Możliwe przyczyny problemów pojawiających się podczas korzystania z systemów rządowych są opisane na tej stronie.

Błędy podczas automatycznej aktualizacji związane są najczęściej z zablokowaniem pobierania i uruchamiania plików przez antywirusy lub zapory, problemy mogą także pojawić się w przypadku braku pełnych uprawnień użytkownika do przeprowadzenia instalacji lub błędnej konfiguracji zabezpieczeń w systemie.

Najlepszym rozwiązaniem problemu jest odblokowanie programu i/lub połączenia, jeżeli nie jest to możliwe — należy pobrać najnowszy pełny lub częściowy (aktualizacyjny) instalator. Aktualizacyjny instalator zawiera tylko pliki wykonywalne i niektóre inne pliki programu, nie zawiera plików definicji formularzy. Ten sam instalator jest pobierany przez TaxMachine podczas automatycznej aktualizacji.

Poniżej linki do aktualnych instalatorów (zawsze najnowsza wersja):

Instalator należy uruchomić „jako administrator" (prawym myszki na pliku → Uruchom jako administrator).

Więcej na temat problemów z aktualizacją →

Aby usunąć przyczynę należy zresetować ustawienia programu naciskając Ctrl + Alt + R, przed resetowaniem program najlepiej uruchomić ponownie, po resecie także wymagane jest ponowne uruchomienie programu. Innym sposobem na usunięcie uszkodzonych plików jest odinstalowanie i ponowna instalacja programu z aktualnego instalatora. Pliki ustawień można też usunąć ręcznie — skasować wszystko poza bazami danych (.db, ale cfg.db należy skasować) i kopiami (katalog Kopie) z C:\Users\Public\Documents\TaxMachine oraz katalog C:\Users\<Nazwa użytkownika>\AppData\Roaming\TaxMachine.

Antywirusy są jedną z najczęstszych przyczyn problemów z aktualizacją, rejestracją, aktywacją licencji, wysyłką e-dokumentów, ale też z uruchamianiem programu i wczytywaniem wzorców dokumentów. Mechanizm zwykle to false-positive lub heurystyka blokująca często aktualizujące się aplikacje. Aby zweryfikować czy antywirus/zapora powoduje problemy należy ją wyłączyć i sprawdzić działanie programu. Konieczna może być reinstalacja programu, jeżeli jego pliki zostały usunięte.

Jak sobie z tym poradzić: skonfiguruj antywirusa tak, aby nie blokował programu — dodaj wszystkie katalogi TaxMachine do listy wykluczonych ze skanowania, wyłącz heurystyki typu "behavior shield" / "Sonar" i zgłoś fałszywy alarm producentowi antywirusa. Najprostsze rozwiązanie to korzystanie z antywirusa wbudowanego w Windows 10 i 11 (Microsoft Defender), który respektuje podpisy producenta i nie wszczyna fałszywych alarmów. Pełna instrukcja i linki do zgłaszania fałszywych alarmów: Problemy powodowane przez antywirusy →

Należy uruchomić program „jako administrator" i sprawdzić czy problem ustąpił. Jeżeli tak — należy skorygować uprawnienia, ewentualnie przeinstalować program (instalator też uruchomić jako administrator).

Rzadko zdarza się, że dostawca internetu blokuje połączenia na poziomie adresów IP lub na podstawie innych sobie tylko znanych kryteriów. Niemożliwe wówczas staje się pobieranie aktualizacji, aktywowanie licencji czy jej automatyczne reaktywowanie. Aby sprawdzić czy jest to przyczyną problemu należy tymczasowo przełączyć się na inne połączenie, np. komórkowe. Jeżeli problem ustępuje — kontaktuj się w tej sprawie z dostawcą internetu.

Wspierane systemy

Program wymaga Windows 10 (64-bit, najlepiej w wersji 22H2 lub nowszej) albo Windows 11. Wersje 32-bit nie są wspierane.

Inne wymagania sprzętowe i programowe

• Procesor: x64 dwurdzeniowy 2 GHz+ (Intel/AMD z 2014 r. lub nowszy dla komfortowej pracy)
• Pamięć RAM: minimum 4 GB, zalecane 8 GB+ (przy biurze rachunkowym z wieloma firmami)
• Dysk: SSD zalecany (HDD da się, ale przy 1000+ dokumentach miesięcznie różnica jest dramatyczna). Wolne miejsce: ~500 MB na sam program + miejsce na bazę danych (typowo 100 MB–2 GB).
• Rozdzielczość ekranu: minimum 1366×768, zalecane 1920×1080 lub większa
• Połączenie z Internetem: wymagane do: aktualizacji, e-Deklaracji, JPK, KSeF, weryfikacji statusu VAT, kursów NBP. Po instalacji wystarczy skroplenie online raz dziennie — księgowanie offline działa.
• .NET / runtime'y: instalator dorzuca wymagane biblioteki automatycznie. W szczególnych przypadkach (Windows N / KN bez Media Pack) niektóre komponenty trzeba doinstalować ręcznie.
• Konto z prawami administratora — wymagane przy instalacji, aktualizacji i pierwszym uruchomieniu (rejestracja jako serwis, rejestracja w bazie certyfikatów).

Praca wielostanowiskowa — dodatkowe wymagania

Przy korzystaniu z serwera MariaDB / MySQL: Instalacja MariaDB → (opisuje wymagania serwera bazy + firewalla + backup).

Sprawdzenie wersji systemu

Naciśnij Windows + R, wpisz winver i Enter — pojawi się okienko z dokładną wersją:

Pełne info systemu (architektura, RAM, procesor): Windows + Pause/Break albo Ustawienia → System → Informacje.

Program nie będzie działał prawidłowo w trybie zgodności — należy go wyłączyć. Aby sprawdzić czy tryb zgodności jest włączony, kliknij prawym przyciskiem na skrócie do programu lub pliku tmxp.exe, Właściwości, zakładka Zgodność, pole „Uruchom w trybie zgodności z:" musi być odznaczone.

Zobacz też osobną stronę na ten temat →

W przypadku pracy wielostanowiskowej problem może leżeć po stronie serwera MariaDB (zalecane) lub MySQL. Sprawdź czy serwer został zainstalowany i skonfigurowany zgodnie z naszą instrukcją: Praca wielostanowiskowa →.

Najczęstszy problem to za mały parametr max_allowed_packet (domyślnie 16 MB — przy KSeF i dużych załącznikach należy zwiększyć do 200 MB): MariaDB max_allowed_packet →.

Praca wielostanowiskowa (równoczesna praca na tej samej bazie danych z wielu stanowisk) nie jest możliwa z bazą SQLite udostępnianą na udziale sieciowym.

Błędy podczas podpisywania dokumentów podpisem kwalifikowanym często są powodowane przez błędne uprawnienia lub przestarzałe oprogramowanie obsługujące kartę kryptograficzną. Należy przeinstalować program obsługujący kartę, pobrać najnowszą wersję oprogramowania ze strony dostawcy certyfikatu i zainstalować „jako administrator". Ewentualnie zainstalować ponownie certyfikat w magazynie certyfikatów osobistych.

W przypadku komunikatu o braku klucza prywatnego (np. „zestaw kluczy nie istnieje", „nie można znaleźć certyfikatu") sprawdź czy wskazano prawidłowy certyfikat oraz czy karta kryptograficzna lub inny nośnik klucza prywatnego jest podłączony do komputera.