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 (najlepiej w wersji 22H2 lub nowszej) albo Windows 11.

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.

Program w wersji 64-bitowej skanuje przez WIA — ten sam mechanizm, z którego korzysta systemowe „Faksowanie i skanowanie". Wersja 32-bitowa korzysta ze sterowników TWAIN. Nie da się tego odwrócić: menedżer TWAIN dostarczany z Windows jest 32-bitowy i program 64-bitowy go nie widzi.

Jeżeli skanera nie ma na liście:

1. Zaktualizuj program do najnowszej wersji — obsługa skanowania w wersji 64-bitowej była uzupełniana.
2. Sprawdź, czy urządzenie widzi systemowe Faksowanie i skanowanie. Jeżeli nie widzi — brakuje sterownika WIA. U producenta bywa opisany jako „sterownik skanowania", „Scan driver" albo „WIA"; sam sterownik drukarki nie wystarczy.
3. Jeżeli producent daje wyłącznie sterownik TWAIN (typowe przy starszych urządzeniach), użyj 32-bitowej wersji programu — tam skaner będzie widoczny.

O tym, po której stronie ewidencji stoi rejestr VAT, decyduje wyłącznie jego pole Typ — nie nazwa. Rejestr nazwany „Zakupy", któremu ustawiono typ sprzedażowy, nie pojawi się na liście rejestrów zakupu. Lista jest wtedy pusta, a pustej listy nie da się rozwinąć, więc wygląda to na usterkę programu, nie na kwestię ustawień.

Typ każdego rejestru widać przy jego nazwie na liście rejestrów VAT oraz w oknie edycji rejestru.

Zanim zmienisz typ istniejącego rejestru, sprawdź, czy nie ma w nim już dokumentów. Zmiana typu działa wstecz i przenosi je na drugą stronę ewidencji, co zmienia zawartość JPK_V7 za rozliczone już okresy. Program ostrzega o tym przy zapisie. Bezpieczniej jest założyć nowy rejestr z właściwym typem i używać go od bieżącego okresu.

Rejestr VAT za dany miesiąc nie przegląda całej bazy. Zbiera dokumenty z tego miesiąca i z sześciu poprzednich, a następnie filtruje je po dacie VAT. Skutek jest taki, że dokument zaksięgowany w danym miesiącu trafi do rejestru tylko wtedy, gdy jego data VAT mieści się w przedziale od tego miesiąca do sześciu miesięcy w przód.

Poza tym przedziałem dokument nie wchodzi do żadnego rejestru i do żadnej deklaracji, choć koszt lub przychód zostaje w księdze. Dotyczy to zwłaszcza daty VAT wcześniejszej niż miesiąc księgowania oraz daty pustej.

Przesunięcie daty VAT w przód o jeden do sześciu miesięcy jest poprawne i zamierzone — tak rozlicza się metodę kasową. Przesunięcie wstecz nie jest natomiast poprawką nagłówka, tylko przeksięgowaniem dokumentu do innego miesiąca. Program ostrzega przy zapisie dokumentu z datą VAT spoza tego zakresu.

Faktura przyjęta przez KSeF jest zamknięta do edycji i tak ma pozostać — to nie jest usterka. Pola formularza i tabela pozycji działają wtedy jak podgląd. Zmiany treści dokonuje się fakturą korygującą, a nie poprawieniem dokumentu źródłowego.

Przy awarii, po której program znika z ekranu, ślad zostaje w logu tej sesji, która się zamknęła — a zgłoszenie wysyła się już z nowo uruchomionego programu. Log bieżącej sesji opisuje wtedy sam restart i nie zawiera nic o awarii.

Dlatego okno Zgłoś problem proponuje osobną pozycję Log poprzedniego uruchomienia. Prosimy zostawić ją zaznaczoną — to zwykle jedyny materiał, z którego da się ustalić przyczynę. Każdy załącznik można odznaczyć, jeśli nie chce się go wysyłać.