Pobieranie i instalacja programu
Opublikowano aktualizacja
Instalacja programu
Po pobraniu instalatora prosimy go uruchomić "jako administrator" i postępować według wyświetlanych instrukcji.
Wymagania systemowe
Wymagany system operacyjny: Windows 10 (64-bit, najlepiej 22H2 lub nowszy) albo Windows 11. Wersje 32-bit oraz starsze systemy (Windows 8.1, 8, 7, Vista, XP) nie są wspierane — Windows 7/8 nie obsługują w pełni TLS 1.2 wymaganego przez bramki MF (e-Deklaracje, JPK, KSeF), aktywacja licencji jest tam niemożliwa.
Do sprawnej pracy komputer powinien mieć minimum 4 GB RAM (zalecane 8 GB+ przy biurze rachunkowym z wieloma firmami) oraz dysk SSD (przy bazach z 1000+ dokumentów miesięcznie różnica względem HDD jest dramatyczna).
Pełen opis wymagań sprzętowych i programowych: Częste przyczyny problemów → Przestarzały system operacyjny.
Funkcje programu wymagające dostępu do internetu
Funkcje, które nie będą działać w przypadku braku połączenia z internetem: automatyczna aktualizacja, dostęp do Bazy Internetowej REGON, e-Deklaracje, wysyłka JPK (w tym JPK_V7), weryfikacja, scalanie i import JPK, podpisywanie JPK przez EPUAP, wysyłka e-faktur (KSeF), pobieranie kursów walut NBP, wysyłka wiadomości e-mail, kopie w chmurze, weryfikacja podatników VAT na białej liście.
Problemy powodowane przez antywirusy
Programy antywirusowe i zapory sieciowe są jedną z najczęstszych przyczyn problemów z TaxMachine — mogą blokować pobieranie i instalację, aktualizację, połączenie z bazą danych MySQL/MariaDB, wysyłkę JPK i e-deklaracji, podpis elektroniczny czy drukowanie. Mechanizm jest zazwyczaj prosty: heurystyki antywirusów blokują "nieznane" lub często aktualizujące się aplikacje, generując false-positive. Programy napisane w Delphi (tak jak TaxMachine) były w przeszłości szczególnie podatne na fałszywe alarmy (dyskusja na forum Embarcadero, Stack Exchange).
Jeśli widzisz problemy z instalacją lub uruchamianiem programu mimo że nic z TaxMachine się nie zmieniło — z dużym prawdopodobieństwem winny jest antywirus. Co zrobić:
- Dodaj wszystkie katalogi programu do listy wykluczonych ze skanowania w swoim antywirusie (sposób opisany w dokumentacji każdego antywirusa).
- Wyłącz heurystyki "behavior shield" / "Sonar" które blokują często aktualizujące się aplikacje.
- Odblokuj TaxMachine w zaporze sieciowej — wymagany dostęp do internetu dla aktualizacji, e-Deklaracji, JPK, KSeF.
- Zgłoś fałszywy alarm producentowi antywirusa — niemal wszyscy mają do tego dedykowane formularze. Pełna lista linków: Problemy powodowane przez antywirusy →.
Jeśli nie chcesz konfigurować wyjątków ręcznie, najprostszym rozwiązaniem jest antywirus wbudowany w Windows 10/11 (Microsoft Defender) — respektuje on podpisy producenta i nie wszczyna fałszywych alarmów na TaxMachine.
Gdy instalator zgłasza błąd (brak dostępu do plików albo brak plików)
Jeśli podczas instalacji instalator przerywa pracę z komunikatem o braku dostępu do plików albo o braku / nieobecności pliku, przyczyna jest niemal zawsze jedna z dwóch — uprawnienia albo antywirus. Objaw wygląda groźnie, ale rozwiązanie jest proste.
„Brak dostępu do plików" / „odmowa dostępu"
Instalator musi zapisać pliki programu (domyślnie w C:\Program Files) oraz wpisy w rejestrze systemu — do tego potrzebuje uprawnień administratora. Jeśli został uruchomiony zwykłym dwukliknięciem, może zgłosić „odmowa dostępu", „access denied" albo „nie można zapisać / utworzyć pliku".
- Zamknij instalator, kliknij jego plik prawym przyciskiem myszy → Uruchom jako administrator i powtórz instalację.
- Instaluj w domyślnej lokalizacji proponowanej przez instalator — nie zmieniaj jej na katalog, do którego nie masz praw (np. cudzy profil użytkownika czy chroniony udział sieciowy).
- Szerzej o uprawnieniach do plików i katalogów: Problemy wynikające z braku uprawnień.
„Brak pliku" / „nie można odnaleźć pliku"
Komunikat o brakującym pliku w trakcie instalacji to najczęściej ślad po antywirusie, który w tle skasował albo przeniósł do kwarantanny plik instalatora lub plik rozpakowany do katalogu tymczasowego (fałszywy alarm — patrz sekcja wyżej). Instalator „widzi", że pliku nagle nie ma, i przerywa.
- Na czas instalacji wyłącz ochronę antywirusa (albo dodaj plik instalatora i katalog instalacji do wyjątków), po czym zainstaluj ponownie.
- Jeśli sam plik instalatora zniknął po pobraniu — pobierz go ponownie (linki w tabeli wyżej) i od razu uruchom jako administrator.
- Zajrzyj do kwarantanny antywirusa — czasem wystarczy przywrócić zablokowany plik i dodać go do wyjątków.
- Pełny opis i formularze zgłaszania fałszywych alarmów: Problemy powodowane przez antywirusy.
Te same objawy (brak dostępu, znikające pliki) mogą wystąpić przy aktualizacji już zainstalowanego programu — wtedy zobacz Problemy z automatyczną aktualizacją oraz Program nie startuje po aktualizacji.

