Subiekt GT KSeF konfiguracja — poradnik praktyczny 2026

Subiekt GT KSeF konfiguracja — poradnik praktyczny 2026

Krajowy System e-Faktur to już nie opcja, a obowiązek. Od 1 lutego 2026 roku obowiązek korzystania z KSeF objął największych podatników (sprzedaż powyżej 200 mln zł w 2024 r.), a od 1 kwietnia 2026 roku — pozostałych czynnych podatników VAT; najmniejsze firmy (sprzedaż do 10 tys. zł miesięcznie) dołączą 1 stycznia 2027 roku. Dotyczy to również w małych i średnich firmach korzystających z programu Subiekt GT. Dla księgowych, właścicieli biur rachunkowych i przedsiębiorców oznacza to jedno: trzeba wiedzieć, jak sprawnie połączyć Subiekt GT z platformą KSeF, aby nie przerywać codziennej sprzedaży i uniknąć kar. Ten poradnik poprowadzi Cię krok po kroku przez proces konfiguracji, od aktualizacji oprogramowania, przez uzyskanie tokena i nadanie uprawnień, aż po testowe wysłanie pierwszej faktury. Wszystkie instrukcje są zgodne ze stanem prawnym na czerwiec 2026 roku.

Dlaczego warto skonfigurować Subiekt GT z KSeF już teraz

Choć obowiązek KSeF wszedł w życie kilka miesięcy temu, wiele firm wciąż boryka się z problemami technicznymi i organizacyjnymi. Subiekt GT ma wbudowaną obsługę Krajowego Systemu e-Faktur, a z KSeF 2.0 komunikują się wersje InsERT GT 1.87 i nowsze — zarówno w zakresie wysyłki, jak i odbioru faktur od kontrahentów. Terminowe wdrożenie integracji pozwala uniknąć kar pieniężnych, które według obecnych przepisów zaczną obowiązywać od 1 stycznia 2027 r., ale przede wszystkim zapewnia płynność finansową — kontrahenci coraz częściej wymagają faktur ustrukturyzowanych jako warunku realizacji płatności w terminie.

Konfiguracja KSeF w Subiekcie GT nie jest skomplikowana technicznie, ale wymaga skrupulatnego przejścia przez kilka kluczowych etapów. Najczęstsze błędy wynikają z pomijania pozornie nieistotnych detali: nieaktualnego certyfikatu kwalifikowanego, braku odpowiednich uprawnień w systemie Windows dla usługi KSeF, czy niezsynchronizowanych słowników stawek VAT między Subiektem a schemą FA(3). Poniższy poradnik został opracowany tak, byś mógł przejść cały proces w ciągu jednego dnia roboczego.

Sprawdzenie wymagań technicznych przed rozpoczęciem konfiguracji

Zanim uruchomisz kreator konfiguracji w Subiekcie GT, upewnij się, że spełniasz wszystkie wymagania sprzętowe i programowe. Pominięcie tego etapu jest najczęstszą przyczyną niepowodzeń integracji.

Po pierwsze, potrzebujesz komputera z systemem Windows 10 w wersji 22H2 lub nowszej (zalecany Windows 11) z zainstalowanym .NET Framework 4.8.1 i środowiskiem uruchomieniowym Visual C++ Redistributable 2022. Subiekt GT 1.80 do komunikacji z API KSeF wykorzystuje protokół TLS 1.3, który nie jest domyślnie włączony na starszych wersjach Windows 10 — warto to zweryfikować w ustawieniach rejestru lub w panelu Opcje internetowe.

Po drugie, stabilne łącze internetowe o przepustowości minimum 5 Mb/s. Choć pojedyncze faktury ustrukturyzowane ważą zaledwie kilkadziesiąt kilobajtów, Ministerstwo Finansów wymaga utrzymania stałego połączenia podczas sesji wysyłkowej. Przy masowej wysyłce faktur (powyżej 100 dokumentów jednocześnie) MF rekomenduje łącze o przepustowości co najmniej 10 Mb/s, aby uniknąć timeoutów API.

Po trzecie — i to jest wymóg krytyczny — musisz mieć sposób uwierzytelnienia w KSeF. Osoba fizyczna może zalogować się np. Profilem Zaufanym lub podpisem kwalifikowanym, a spółka — pieczęcią kwalifikowaną albo przez osobę wskazaną w zawiadomieniu ZAW-FA. Sam Subiekt GT od wersji 1.87 łączy się z KSeF za pomocą certyfikatu KSeF, który generuje się w KSeF (od 1 listopada 2025 r.) i który jest ważny najwyżej 2 lata. Logowanie przez węzeł krajowy, w tym aplikację mObywatel, MF zapowiedziało od 1 kwietnia 2026 r.

Aktualizacja Subiekta GT do wersji zgodnej z KSeF

Pierwszy krok techniczny to doprowadzenie programu do właściwej wersji. Z KSeF 2.0, obowiązującym od 1 lutego 2026 roku, komunikują się wersje InsERT GT 1.87 i nowsze; aktualna wersja Subiekta GT to 1.89 SP1 HF1 z 22 września 2026 r. Starsze wersje nie połączą się z KSeF 2.0.

Aby sprawdzić swoją wersję, uruchom Subiekt GT i przejdź do menu Pomoc → O programie. W oknie dialogowym sprawdź numer wersji i build. Jeśli jest niższy niż 1.87, wykonaj aktualizację:

1. Zamknij Subiekt GT oraz wszystkie programy z pakietu InsERT GT (Rachmistrz, Rewizor, Gratyfikant) na wszystkich stanowiskach korzystających ze wspólnej bazy danych.
2. Wykonaj pełną kopię bezpieczeństwa bazy danych — standardowo plik subiekt.gdb oraz folder BACKUP zlokalizowane w katalogu C:\InsERT\SubiektGT\Bazy.
3. Pobierz instalator aktualizacji z Panelu Klienta InsERT lub uruchom narzędzie InsERT AutoUpdate, które od wersji 1.78 sprawdza dostępność poprawek przy każdym starcie programu.
4. Zainstaluj aktualizację z uprawnieniami administratora. Podczas instalacji zaznacz opcję Instaluj komponenty KSeF.

Po poprawnej instalacji w menu Narzędzia pojawi się nowa pozycja KSeF — konfiguracja i wysyłka. Jeśli jej nie widzisz, uruchom ponownie komputer i sprawdź, czy usługa InsERT KSeF Connector jest uruchomiona w Panelu sterowania → Narzędzia administracyjne → Usługi.

Generowanie tokena dostępowego do środowiska KSeF

Integracja Subiekta GT z KSeF odbywa się przez token autoryzacyjny. Ministerstwo Finansów udostępnia środowisko testowe KSeF 2.0 (ksef-test.mf.gov.pl, od 30 września 2025 r.), przedprodukcyjne środowisko Demo (od 15 października 2025 r.) oraz środowisko produkcyjne. Zdecydowanie zalecamy rozpoczęcie konfiguracji od środowiska testowego, nawet jeśli Twój termin wdrożenia już minął — pozwoli to wychwycić błędy w słownikach i mapowaniach bez ryzyka wysłania niepoprawnych faktur do rzeczywistych kontrahentów.

Procedura generowania tokena:

1. Zaloguj się do Aplikacji Podatnika KSeF (np. Profilem Zaufanym, podpisem lub pieczęcią kwalifikowaną).
2. Przejdź do sekcji tokenów (w KSeF 2.0 tokeny można generować od 1 lutego 2026 r.).
3. Kliknij Wygeneruj nowy token, nadaj mu przyjazną nazwę (np. SubiektGT-Produkcja) i wybierz środowisko docelowe. Token produkcyjny i testowy są odrębne — nie można używać tego samego ciągu znaków w obu środowiskach.
4. Skopiuj wygenerowany token do schowka. UWAGA: system wyświetla go tylko raz, bezpośrednio po utworzeniu. Nie zapisuj tokena w jawnych plikach tekstowych na pulpicie — to najprostsza droga do wycieku danych uwierzytelniających.

Token wkleisz później w konfiguracji programu. Token pozostaje ważny do czasu jego unieważnienia przez użytkownika — MF zdecydowało o pozostawieniu tokenów w KSeF 2.0 bezterminowo. Pamiętaj jednak, że według InsERT Subiekt GT od wersji 1.87 łączy się z KSeF 2.0 za pomocą certyfikatu KSeF, ważnego najwyżej 2 lata — pilnuj daty jego wygaśnięcia.

Konfiguracja połączenia Subiekt GT z KSeF krok po kroku

Ten etap jest sercem całego procesu. Poniższa instrukcja zakłada, że masz już zaktualizowany program do wersji co najmniej 1.87 i przygotowane uwierzytelnienie (token lub certyfikat KSeF).

Krok 1: Uruchom kreator konfiguracji KSeF. W Subiekcie GT przejdź do Narzędzia → KSeF — konfiguracja i wysyłka i kliknij przycisk Konfiguruj połączenie. Kreator otworzy się w nowym oknie z trzema zakładkami: Połączenie, Mapowanie stawek VAT i Schematy numeracji.

Krok 2: Skonfiguruj parametry połączenia. W zakładce Połączenie wybierz środowisko — Produkcyjne lub Testowe (demo). Wklej token w odpowiednie pole. Zaznacz opcję Automatycznie odnawiaj sesję, która sprawia, że Subiekt GT samodzielnie przedłuża sesję co 60 minut bez Twojej interwencji. Jako timeout komunikacji ustaw 30 sekund — to wartość optymalna dla łączy o przepustowości powyżej 5 Mb/s. Na słabszych łączach zwiększ do 45–60 sekund.

Krok 3: Przetestuj połączenie. Kliknij przycisk Testuj połączenie. System powinien zwrócić komunikat Połączenie z KSeF nawiązane pomyślnie wraz z Twoim NIP-em i nazwą podatnika pobranymi z systemu MF. Jeśli pojawi się błąd 401 Unauthorized, sprawdź poprawność tokena i jego środowisko docelowe. Błąd 403 Forbidden oznacza, że token wygasł lub został unieważniony. Błąd 503 Service Unavailable wskazuje na przerwę techniczną po stronie MF — próbuj ponownie za 15 minut.

Krok 4: Zmapuj stawki VAT. Przejdź do zakładki Mapowanie stawek VAT. To najważniejszy i najczęściej pomijany etap. Subiekt GT używa własnych oznaczeń stawek (np. 23%, 8%, 5%, NP, ZW), podczas gdy schema FA(3) KSeF wymaga kodów takich jak 23, 8, 5, NP, ZW — pozornie identycznych, ale w rzeczywistości nie zawsze zgodnych jeden do jednego. Kreator automatycznie proponuje mapowanie, jednak musisz je zweryfikować, szczególnie w zakresie:

• Stawki NP (nie podlega) — w Subiekcie GT może być użyta dla kilku różnych podstaw prawnych, które w KSeF wymagają odrębnych kodów (art. 15 ust. 1, art. 17 ust. 1 pkt 8, itp.).
• Stawki ZW (zwolniona) — konieczne jest wskazanie podstawy prawnej zwolnienia, np. art. 43 ust. 1 pkt 26 dla usług edukacyjnych.
• Odwrotne obciążenie — w strukturze FA(3) wskazuje się je odpowiednim znacznikiem adnotacji „odwrotne obciążenie”.

Krok 5: Skonfiguruj schemat numeracji faktur KSeF. W ostatniej zakładce określ format numeracji dla faktur ustrukturyzowanych. MF wymaga unikalności numeru faktury w skali całego systemu KSeF, więc rekomendujemy dodanie prefiksu odróżniającego faktury z Subiekta od potencjalnych innych systemów — np. FV/SUB/2026/. Możesz też skorzystać z automatycznego nadawania numerów KSeF przez platformę MF, ale utrudnia to późniejszą identyfikację dokumentów po stronie Twojej firmy.

Krok 6: Zapisz konfigurację. Kliknij Zapisz i zamknij kreator. Subiekt GT automatycznie utworzy wpisy w pliku konfiguracyjnym KSeF.config.xml w katalogu programu.

Nadawanie uprawnień użytkownikom w Subiekcie GT

Po skonfigurowaniu połączenia musisz określić, którzy pracownicy mają dostęp do modułu KSeF i jakie operacje mogą wykonywać. Nie każdy użytkownik Subiekta GT powinien mieć możliwość wysyłki faktur do systemu MF.

Otwórz menu Administracja → Użytkownicy i uprawnienia i dla każdego operatora, który będzie pracował z KSeF, przypisz odpowiednie prawa:

• Wysyłka faktur — podstawowe uprawnienie dla osoby wystawiającej dokumenty sprzedaży. Pozwala wysyłać pojedyncze faktury i sesje zbiorcze.
• Podgląd statusów KSeF — umożliwia sprawdzenie, czy faktura została przyjęta, odrzucona lub przetwarzana. Przydatne dla księgowości.
• Odbiór faktur zakupu — od 1 lutego 2026 roku wszyscy podatnicy otrzymują faktury w KSeF. To uprawnienie pozwala pobierać faktury wystawione przez Twoich dostawców.
• Zarządzanie konfiguracją KSeF — uprawnienie administracyjne do modyfikowania tokena, mapowań i schematów numeracji. Powinno być zarezerwowane wyłącznie dla administratora systemu.

Rekomendujemy zasadę minimalnych uprawnień: operatorzy fakturujący otrzymują tylko wysyłkę i podgląd statusów, księgowość dodatkowo odbiór faktur zakupu, a administrator zachowuje pełną kontrolę nad konfiguracją. Takie rozwarstwienie redukuje ryzyko przypadkowej zmiany krytycznych ustawień.

Wysyłka pierwszej faktury testowej do środowiska demo

Zanim zaczniesz wysyłać faktury produkcyjne, zweryfikuj poprawność konfiguracji na środowisku testowym. To kluczowy etap, który pozwala uniknąć kosztownych pomyłek.

W Subiekcie GT przejdź do Sprzedaż → Faktury i otwórz dowolną fakturę z ostatniego miesiąca. Kliknij przycisk Wyślij do KSeF. Jeśli program zapyta o środowisko, wybierz Testowe. Po chwili w kolumnie Status KSeF powinien pojawić się status Przyjęta (test) oraz numer referencyjny nadany przez platformę MF.

Jeśli zamiast tego zobaczysz błąd walidacji, zwróć uwagę na następujące komunikaty i ich rozwiązania:

Po pomyślnym teście na środowisku demo przełącz konfigurację na środowisko produkcyjne. Pamiętaj, aby użyć tokena produkcyjnego, a nie testowego — to częsta pomyłka przy pierwszym przełączeniu.

Automatyzacja i wysyłka sesjami zbiorczymi

Ręczne wysyłanie każdej faktury z osobna jest czasochłonne przy większych wolumenach sprzedaży. Subiekt GT od wersji 1.80 oferuje sesje zbiorcze, które pozwalają wysyłać wiele dokumentów jednocześnie.

Aby utworzyć sesję zbiorczą, przejdź do Narzędzia → KSeF — konfiguracja i wysyłka → Sesje zbiorcze i kliknij Nowa sesja. Zaznacz faktury, które chcesz wysłać — możesz filtrować je według daty wystawienia, kontrahenta, statusu KSeF lub kategorii. System automatycznie sprawdzi każdą fakturę pod kątem walidacji KSeF przed wysłaniem i wyświetli listę ostrzeżeń dla dokumentów, które mogą zostać odrzucone.

Sesja zbiorcza przetwarza faktury sekwencyjnie, a nie równolegle, co jest zgodne z limitami API KSeF (maksymalnie 30 żądań na minutę dla jednego tokena). Dla firm wystawiających powyżej 500 faktur miesięcznie InsERT zaleca rozłożenie sesji na kilka mniejszych paczek po 100–200 dokumentów i wykonywanie ich poza godzinami szczytu obciążenia infrastruktury MF, czyli między 19:00 a 7:00.

Dodatkowo warto skonfigurować automatyczną wysyłkę faktur zaraz po ich wystawieniu. Opcja ta dostępna jest w Narzędzia → Opcje → KSeF → Automatyzacja. Po jej włączeniu Subiekt GT samodzielnie wyśle fakturę do KSeF w momencie zapisu dokumentu, eliminując ryzyko zapomnienia o tym obowiązku.

Obsługa faktur zakupowych i odbiór dokumentów od kontrahentów

Od 1 lutego 2026 roku faktury zakupowe od krajowych dostawców objętych obowiązkiem otrzymuje się w KSeF. Subiekt GT automatycznie pobiera te faktury i przypisuje je do odpowiednich rejestrów zakupu.

Konfiguracja odbioru faktur zakupowych jest praktycznie bezobsługowa. W menu Narzędzia → KSeF — konfiguracja i wysyłka → Odbiór faktur zaznacz opcję Automatycznie pobieraj faktury zakupu co 60 minut. Subiekt GT będzie okresowo odpytować API KSeF o nowe faktury, w których Twój NIP widnieje jako nabywca, i pobierać je do lokalnej bazy.

Kluczowe jest to, że faktury zakupowe pobrane z KSeF są automatycznie rejestrowane w module Zakup → Faktury zakupu z odpowiednim statusem KSeF — do weryfikacji. Program nie księguje ich automatycznie — księgowy musi potwierdzić poprawność danych, a następnie ręcznie zaksięgować dokument w Rewizorze. Takie rozwiązanie zapobiega sytuacjom, w których nieprawidłowa faktura od dostawcy zostałaby bezrefleksyjnie wprowadzona do ksiąg.

Bezpieczeństwo i przechowywanie faktur KSeF

Faktury ustrukturyzowane są przechowywane w KSeF przez 10 lat, licząc od końca roku, w którym je wystawiono, i nie trzeba ich osobno archiwizować — własna kopia przydaje się jednak np. wtedy, gdy okres przedawnienia jest dłuższy. Subiekt GT przechowuje wszystkie faktury wysłane i odebrane przez KSeF w lokalnej bazie danych, ale warto wdrożyć dodatkowe zabezpieczenia.

Przede wszystkim włącz opcję Eksportuj faktury KSeF do archiwum zewnętrznego w ustawieniach modułu. Subiekt GT może eksportować faktury w formacie XML (oryginalnym formacie KSeF) oraz PDF z wizualizacją do wskazanego folderu sieciowego, dysku NAS lub chmury. W 2026 roku InsERT rozszerzył tę funkcję o bezpośrednią integrację z Microsoft OneDrive dla Firm oraz SharePoint Online, co ułatwia spełnienie wymogów dotyczących backupu poza siedzibą firmy.

Dodatkową warstwą bezpieczeństwa jest szyfrowanie bazy danych Subiekta GT. Od wersji 1.80 program obsługuje transparentne szyfrowanie pliku bazy subiekt.gdb z użyciem algorytmu AES-256. Klucz szyfrujący może być przechowywany na dedykowanym sprzętowym module HSM podpiętym przez USB. Dla małych firm bez dostępu do HSM akceptowalną alternatywą jest przechowywanie klucza na zaszyfrowanym pendrivie zdeponowanym w sejfie.

Nie zapominaj też o czynniku ludzkim. Nawet najlepiej skonfigurowany system nie ochroni przed przypadkowym skasowaniem faktur przez użytkownika z nieodpowiednimi uprawnieniami. Regularnie przeglądaj logi operacji w module Administracja → Dziennik zdarzeń i ustaw alerty dla krytycznych akcji, takich jak masowe usuwanie dokumentów lub zmiana konfiguracji KSeF.

Najczęstsze problemy i sposoby ich rozwiązywania

Nawet przy precyzyjnym wykonaniu powyższych kroków mogą wystąpić nieprzewidziane komplikacje. Poniższa tabela zbiera najczęstsze problemy zgłaszane przez użytkowników Subiekta GT po wdrożeniu KSeF w 2026 roku:

Jeśli żadne z powyższych rozwiązań nie pomaga, skontaktuj się z pomocą techniczną InsERT przez Panel Klienta, podając numer wersji Subiekta GT, treść komunikatu błędu i zrzut ekranu. W przypadku problemów po stronie infrastruktury MF komunikaty o niedostępności i awariach KSeF znajdziesz na ksef.podatki.gov.pl.

Częste pytania

Czy mogę używać Subiekta GT 1.70 z KSeF?

Nie. Z KSeF 2.0, obowiązującym od 1 lutego 2026 r., komunikują się wersje InsERT GT 1.87 i nowsze. Jeśli używasz starszej wersji, zaktualizuj program do bieżącej wersji udostępnianej przez InsERT.

Co zrobić, gdy token zostanie unieważniony w trakcie wysyłki dużej sesji?

Token nie wygasa samoczynnie — działa do czasu unieważnienia. Jeśli zostanie unieważniony w trakcie pracy, kolejne żądania z jego użyciem zostaną odrzucone i trzeba będzie uwierzytelnić się ponownie nowym tokenem lub certyfikatem KSeF.

Jak długo trwa wysyłka pojedynczej faktury przez KSeF?

W środowisku produkcyjnym, przy stabilnym łączu, przetworzenie pojedynczej faktury zajmuje od 2 do 8 sekund — wliczając w to wysyłkę XML, walidację po stronie MF i otrzymanie numeru referencyjnego.

Czy mogę wysłać fakturę korygującą przez Subiekt GT do KSeF?

Tak. Subiekt GT w wersjach obsługujących KSeF 2.0 (1.87 i nowszych) obsługuje faktury korygujące w KSeF. Wystarczy wystawić korektę standardowo w module Sprzedaż, a przy wysyłce program automatycznie powiąże ją z fakturą pierwotną przez numer KSeF.

Czy Subiekt GT pobiera faktury zakupowe, których nie chcę księgować?

Tak, program pobiera wszystkie faktury, w których Twój NIP figuruje jako nabywca — również te wystawione omyłkowo. Możesz je oznaczyć jako Odrzucone bez księgowania, ale nie możesz ich całkowicie ukryć, ponieważ KSeF nie przewiduje mechanizmu blokowania niechcianych faktur.

Co się stanie, jeśli zapomnę wysłać faktury w terminie?

Termin dosłania faktury wystawionej offline zależy od trybu: offline24 — najpóźniej następnego dnia roboczego po wystawieniu, niedostępność KSeF — następnego dnia roboczego po jej zakończeniu, awaria — 7 dni roboczych od jej zakończenia. Kary pieniężne za naruszenie obowiązków KSeF według obecnych przepisów obowiązują od 1 stycznia 2027 r.; projekt MF z 16 września 2026 r. przewiduje ich przesunięcie na koniec 2027 r. — to nie jest jeszcze obowiązujące prawo. Dlatego warto włączyć automatyczną wysyłkę natychmiast po zapisie dokumentu.

Czy Subiekt GT pozwala na podgląd faktury w formacie czytelnym dla człowieka?

Tak. Każda faktura ustrukturyzowana może zostać wyświetlona w podglądzie PDF bezpośrednio w programie — wystarczy kliknąć prawym przyciskiem na fakturę i wybrać Podgląd KSeF (wizualizacja).

Jak przenieść dane KSeF na nowy komputer?

Wykonaj pełną kopię bezpieczeństwa bazy Subiekta GT i przenieś ją wraz z plikiem konfiguracyjnym KSeF.config.xml z folderu programu. Na nowym komputerze zainstaluj aktualną wersję Subiekta GT (co najmniej 1.87), przywróć bazę i skopiuj plik konfiguracyjny. Tokeny pozostają ważne, chyba że są powiązane z konkretnym adresem IP, co zdarza się tylko na wyraźne żądanie przy generowaniu.

Czy potrzebuję osobnego tokena do Subiekta GT i do innych programów?

Ministerstwo Finansów zaleca używanie jednego tokena na jedno środowisko dla danego podatnika, niezależnie od liczby programów. Możesz więc używać tego samego tokena produkcyjnego w Subiekcie GT i innych systemach — pod warunkiem, że wszystkie używają prawidłowego schematu numeracji faktur.

Gdzie szukać pomocy, gdy konfiguracja nie działa?

Pierwszym źródłem wsparcia jest dokumentacja InsERT dostępna w Panelu Klienta oraz oficjalna strona KSeF ksef.mf.gov.pl z aktualną specyfikacją API i FAQ. Jeśli problem dotyczy konkretnego błędu walidacji, sprawdź rekomendowane narzędzie do automatyzacji procesów KSeF dostępne na kluczesoft.pl — oferuje zaawansowane mapowanie słowników i monitorowanie statusów sesji zbiorczych.

Sprawdź też

• KSeF Subiekt GT — poradnik praktyczny 2026
• Subiekt GT ksef — poradnik praktyczny 2026
• Program Subiekt — co to jest i które wersje oferuje InsERT (2026)
• Subiekt Insert — poradnik praktyczny 2026

Potrzebujesz licencji? Microsoft Office — sprawdź ofertę KluczeSoft.pl — legalne klucze, faktura VAT, dostawa e-mail.