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 wszyscy czynni podatnicy VAT muszą wystawiać faktury ustrukturyzowane wyłącznie przez KSeF — 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 w wersji 1.80, wydanej w grudniu 2025 roku, otrzymał pełne wsparcie dla Krajowego Systemu e-Faktur — zarówno w zakresie wysyłki, jak i odbioru faktur od kontrahentów. Terminowe wdrożenie integracji pozwala uniknąć nie tylko sankcji administracyjnych sięgających nawet 5000 zł za każdy miesiąc zwłoki, 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 absolutnie krytyczny — musisz posiadać ważny kwalifikowany podpis elektroniczny lub kwalifikowaną pieczęć elektroniczną wydaną przez jednego z dostawców akredytowanych przez Narodowe Centrum Certyfikacji. Od stycznia 2026 roku KSeF akceptuje również profil zaufany ePUAP z drugim składnikiem uwierzytelnienia (aplikacja mObywatel 3.0 lub klucz U2F), ale tylko dla mikroprzedsiębiorców zatrudniających do 9 osób. Dla pozostałych podmiotów podpis kwalifikowany pozostaje jedyną ścieżką.

Aktualizacja Subiekta GT do wersji zgodnej z KSeF

Pierwszy krok techniczny to doprowadzenie programu do właściwej wersji. W dniu 1 grudnia 2025 roku firma InsERT wydała aktualizację Subiekt GT 1.80 (build 1.80.0.128), która zawiera moduł integracji z KSeF. Jeśli korzystasz ze starszej wersji, nie zobaczysz w programie żadnych opcji związanych z e-Fakturami.

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.80.0.128, 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. W 2026 roku Ministerstwo Finansów udostępnia dwa środowiska: testowe (demo) oraz 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 Portalu Podatkowego MF (bramka ksef.mf.gov.pl) za pomocą podpisu kwalifikowanego lub profilu zaufanego.
2. W panelu głównym wybierz zakładkę KSeF → Moje tokeny.
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 kreatorze konfiguracyjnym Subiekta GT. Każdy token ma okres ważności 365 dni, a na 30 dni przed wygaśnięciem MF wysyła powiadomienie na adres e-mail przypisany do konta w Portalu Podatkowym. Subiekt GT od wersji 1.80.0.135 wyświetla również własne ostrzeżenie przy logowaniu.

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 1.80 i wygenerowany token dostępowy.

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 — od 2026 roku schemat KSeF wymaga osobnego oznaczenia Procedura z wartością 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 lipca 2026 roku KSeF jest również obowiązkowy dla faktur zakupowych. 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 lipca 2026 roku KSeF obsługuje nie tylko faktury sprzedażowe, ale również wszystkie faktury zakupowe — czyli dokumenty, które Twoi dostawcy wystawiają dla Twojej firmy. 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

Choć Ministerstwo Finansów przechowuje faktury ustrukturyzowane przez 10 lat od daty wystawienia, przepisy nakładają na podatnika obowiązek posiadania własnego archiwum. 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 status usług możesz sprawdzić na stronie https://status.mf.gov.pl.

Częste pytania

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

Nie. Wsparcie dla KSeF zostało wprowadzone dopiero w wersji 1.80 (grudzień 2025). Starsze wersje nie posiadają modułu integracji i nie ma możliwości dogrania go jako osobnej łatki. Jeśli używasz wersji 1.70 lub niższej, musisz wykupić aktualizację w Panelu Klienta InsERT.

Co zrobić, gdy token wygaśnie w trakcie wysyłki dużej sesji?

Sesja nie zostanie przerwana — token jest sprawdzany tylko przy inicjowaniu połączenia. Jeśli sesja już trwa, wygaśnięcie tokena w jej trakcie nie powoduje przerwania wysyłki. Jednak kolejna próba użycia tego samego tokena zakończy się błędem 403.

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. Od wersji 1.80.0.135 Subiekt GT 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?

Za każdą fakturę niewysłaną do KSeF w terminie (standardowo do następnego dnia roboczego po wystawieniu) grozi kara administracyjna do 5000 zł. 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 Subiekt GT 1.80, 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 — poradnik praktyczny 2026
• Subiekt Insert — poradnik praktyczny 2026

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