Krajowy System e-Faktur (KSeF) to obowiązkowe narzędzie dla podatników VAT.
Od 1 lutego 2026 roku wszystkie e-faktury muszą być przesyłane w formacie XML bezpośrednio do centralnego repozytorium Ministerstwa Finansów.
Programy InsERT – Subiekt GT, Subiekt nexo (w tym nexo PRO) oraz Subiekt 123 – oferują pełną integrację z KSeF, umożliwiając wystawianie, wysyłanie, odbieranie i sprawne zarządzanie e-fakturami.
W tym przewodniku krok po kroku pokazujemy konfigurację każdego z systemów, w tym generowanie i dodawanie certyfikatów uwierzytelniających – kluczowego elementu integracji.
Wstęp do KSeF i roli systemów InsERT
KSeF eliminuje tradycyjne faktury papierowe i PDF, wprowadzając jednolity, elektroniczny obieg z unikalnym numerem referencyjnym KSeF.
Dokumenty wysłane do KSeF otrzymują UPO (Urzędowe Poświadczenie Odbioru), co potwierdza ich moc prawną.
W programach InsERT konfiguracja obejmuje aktywację modułu KSeF, podłączenie konta, dodanie certyfikatów oraz wybór sposobu wysyłki (automatycznie, ręcznie lub okresowo).
Zalety integracji w rodzinie InsERT
Najważniejsze korzyści integracji z KSeF w produktach InsERT to:
- automatyczna zgodność z wzorami MF – system waliduje strukturę e-faktur według obowiązujących schematów Ministerstwa Finansów;
- pobieranie e-faktur zakupu – możliwość odbioru dokumentów bezpośrednio z KSeF i ich łatwej rejestracji w systemie;
- zarządzanie uprawnieniami – przypisywanie ról (np. administrator, użytkownik z ograniczeniami) oraz kontrola dostępu do operacji KSeF;
- statusy i śledzenie – czytelne etapy obiegu dokumentu (np. „Wysyłanie”, „Zarejestrowano”) z informacją o numerze KSeF i UPO.
Przed konfiguracją przygotuj niezbędne elementy:
- konto w e-Urząd Skarbowy (e-US) do logowania w KSeF,
- certyfikat uwierzytelniający (online lub – zalecany – certyfikat offline),
- klucz prywatny powiązany z certyfikatem.
Konfiguracja Subiekt GT z KSeF
Subiekt GT to rozbudowany system dla większych firm, w którym konfiguracja KSeF odbywa się w module Administracja.
Krok 1 – aktywacja parametrów KSeF
Aby włączyć obsługę KSeF w Subiekcie GT, wykonaj kolejno:
- przejdź do Administracja > Parametry,
- odszukaj i uruchom sekcję KSeF > Podstawowe,
- w części Komunikacja on-line wybierz odpowiednie środowisko.
Poniżej znajdziesz krótkie porównanie dostępnych środowisk:
| Środowisko | Opis | Wymagania |
|---|---|---|
| Produkcyjne | Oficjalny tryb; dokumenty mają skutki prawne i nie podlegają edycji po wysłaniu. | konto InsERT + certyfikat. |
| Testowe | Tryb do prób; bez skutków prawnych. | certyfikat nie jest wymagany. |
Krok 2 – połączenie z KSeF i certyfikaty
Po wybraniu środowiska nawiąż połączenie i dodaj certyfikaty:
- w sekcji Komunikacja on-line kliknij Połącz,
- podaj login i hasło do e-US,
- wgraj certyfikat uwierzytelniający (.crt) oraz klucz prywatny (.key) i wpisz hasło,
- po pozytywnej weryfikacji zaakceptuj komunikat i zamknij okno.
Krok 3 – ustawienia wysyłki i importu
Skonfiguruj sposób wysyłania oraz odbioru e-faktur:
- włącz automatyczną wysyłkę po zatwierdzeniu dokumentu (lub wybierz tryb ręczny/okresowy),
- aktywuj pobieranie e-faktur zakupu z KSeF,
- zaznacz parametry zgodności ze schematami MF i nadawanie numerów KSeF.
Po poprawnym nadaniu numeru KSeF status dokumentu zmienia się na „Zarejestrowano”.
Konfiguracja Subiekt nexo (w tym nexo PRO) z KSeF
Subiekt nexo i nexo PRO świetnie sprawdzają się w firmach z autonomiczną księgowością i umożliwiają elastyczne scenariusze wysyłki.
Krok 1 – aktywacja i konfiguracja KSeF
W menu aplikacji przejdź do Parametry > KSeF > Skonfiguruj, a następnie wybierz preferowany sposób wysyłki:
- automatyczna – dokument trafia do KSeF natychmiast po zatwierdzeniu;
- ręczna – wysyłasz e-fakturę na żądanie, z poziomu listy lub formularza;
- okresowa – np. codziennie o określonej godzinie, w paczkach.
Na tym etapie ustaw także środowisko produkcyjne lub testowe, zgodnie z potrzebami wdrożenia.
Krok 2 – integracja certyfikatów
Aby uwierzytelnić połączenie i wgrać certyfikaty, wykonaj:
- kliknij ikonę KSeF w pasku aplikacji,
- otwórz Konfiguracja > Połączenie z KSeF i wybierz Połącz,
- wgraj certyfikat offline (.crt) oraz klucz prywatny (.key), podając hasło,
- zweryfikuj połączenie – program wyświetli potwierdzenie sukcesu.
Krok 3 – współpraca z innymi systemami
Gdy Subiekt nexo działa równolegle z zewnętrzną księgowością, generuj e-faktury w nexo, eksportuj je do księgowości oraz pobieraj e-faktury zakupu bezpośrednio do nexo; w nexo PRO dodatkowo zarządzaj magazynem e-faktur i uprawnieniami użytkowników.
Konfiguracja Subiekt 123 z KSeF
Subiekt 123 to prosty, chmurowy system – integrację z KSeF uruchomisz z poziomu intuicyjnej ikony.
Krok 1 – dostęp do konfiguracji
Kliknij ikonę KSeF w prawym górnym rogu i przejdź do zakładki Konfiguracja.
Krok 2 – połączenie i certyfikaty
Aby nawiązać połączenie i dodać certyfikat, wykonaj następujące czynności:
- kliknij Połącz przy opcji Połączenie z KSeF,
- zaloguj się danymi e-US,
- przygotuj pliki uwierzytelniające (.crt i .key) wraz z hasłem,
- po weryfikacji zatwierdź komunikat – połączenie będzie aktywne.
Aby dodać certyfikat i klucz prywatny, postępuj tak:
- dodaj plik .crt (certyfikat uwierzytelniający),
- dodaj plik .key (klucz prywatny),
- wpisz hasło do klucza i zatwierdź.
Krok 3 – funkcje operacyjne
Po połączeniu z KSeF w Subiekcie 123 zyskujesz następujące możliwości:
- wystawianie – po zatwierdzeniu dokument otrzymuje status „Wysyłanie”, a po nadaniu numeru KSeF zmienia się na „Zarejestrowano”;
- pobieranie – automatyczne pobranie UPO, aktualizacja daty otrzymania/odliczenia i weryfikacja rachunku kontrahenta;
- role – administrator ma pełny dostęp, a użytkownik pracuje w zakresie wybranych uprawnień (moduł użytkownik+).
Generowanie certyfikatu uwierzytelniającego – wspólny proces
Certyfikat uwierzytelniający jest niezbędny do komunikacji z KSeF; wygenerujesz go w Aplikacji KSeF Ministerstwa Finansów (po zalogowaniu przez e-US).
- zaloguj się do Aplikacji KSeF danymi e-US,
- wybierz Wnioskuj o certyfikat, nadaj nazwę (np. „Certyfikat Subiekt”), ustaw hasło i kliknij Generuj,
- pobierz certyfikat offline (.crt) oraz klucz prywatny (.key),
- wgraj pliki do wybranego programu InsERT zgodnie z instrukcjami powyżej.
Uwaga: przechowuj certyfikat i klucz w bezpiecznym miejscu; hasło do klucza jest jednorazowe.
Najczęstsze problemy i wskazówki
Jeśli napotkasz trudności, sprawdź poniższe podpowiedzi:
- błąd wgrywania certyfikatu – zweryfikuj rozszerzenia (.crt przed .key) oraz poprawność hasła;
- brak połączenia – upewnij się, że wybrane jest właściwe środowisko (produkcyjne wymaga konta InsERT);
- współpraca z księgowością – w nexo/GT eksportuj e-faktury do zewnętrznych baz księgowych zgodnie z przyjętym obiegiem;
- testowanie – przed startem w trybie produkcyjnym skorzystaj ze środowiska testowego.
