Konfiguracja KSeF

Konfiguracja KSeF

Ustawienia połączenia z Krajowym Systemem e-Faktur należą do programu KSeF Client, instalowanego razem z Fakturą VAT 2027. Faktura VAT z nich korzysta, ale ich nie zmienia.

Osobno, w samej Fakturze VAT (Konfiguracja → KSeF), ustawiamy to, jak program ma się zachowywać przy wysyłce i odbiorze — patrz niżej.

Co trzeba ustawić

Ustawienie	Znaczenie
NIP firmy	podmiot, w którego imieniu wysyłane są faktury
Token autoryzacyjny	klucz wygenerowany w systemie KSeF; upoważnia program do wysyłki
Środowisko	produkcyjne (faktury o skutkach prawnych) albo testowe
Tryb KSeF	włącznik obsługi — przy wyłączonym synchronizacja nic nie wysyła

Zakładka Główna

Pole	Znaczenie
Środowisko	produkcyjne albo testowe (api-test.ksef.mf.gov.pl)
NIP	podmiot, w którego imieniu wysyłamy faktury
Token KSeF	klucz autoryzacyjny; ikona oka pokazuje wpisaną wartość

Poniżej cztery przełączniki:

• Tryb KSeF (blokada edycji i usuwania faktur) — po wysłaniu do KSeF dokumentu nie można już zmienić ani skasować, bo widnieje w rejestrze Ministerstwa,
• Pobierz UPO po wysłaniu — automatycznie ściąga urzędowe poświadczenie odbioru,
• Pomiń eksport faktur do KSeF i Pomiń pobieranie faktur z KSeF — wyłączają jeden kierunek wymiany, gdy chcemy tylko wysyłać albo tylko odbierać.

Przycisk Uwierzytelnij loguje do systemu wybraną metodą. Pasek na dole okna pokazuje stan: Uwierzytelnienie aktywne wraz z numerem NIP oraz osobno Sesja KSeF.

Zakładka Dodatkowa

Trzy foldery wymiany danych, zakładane osobno dla każdego NIP-u:

Folder	Zawiera
sync (\in)	faktury pobrane z KSeF
batch (\out)	dokumenty przygotowane do wysyłki
UPO (\upo)	poświadczenia odbioru

Do tego opcje wysyłki: faktury zagraniczne, faktury do osób prywatnych, zakres dni od kiedy wysyłać i pobierać (domyślnie 30) oraz automatyczna synchronizacja w tle z zadanym odstępem w minutach.

Zakładka Inne

• Ogranicz długość nazwy towaru/usługi do limitu KSeF (256 znaków) — dłuższe nazwy są przycinane, zamiast powodować odrzucenie faktury,
• Wycisz komunikaty o błędach — program nie przerywa pracy okienkami; pominięte faktury traktuje tak, jak przy odpowiedzi „NIE”, a ślad zostaje w logach.

Ustawienia w Fakturze VAT (Konfiguracja → KSeF)

Trzy przełączniki decydują o tym, czy program pyta przed wysyłką i przed importem. Wszystkie są domyślnie włączone — nic nie wchodzi do ewidencji i nic nie wychodzi do KSeF bez Twojej wiedzy. Wyłączenie przywraca działanie sprzed tej zmiany.

Opcja	Co robi
Pokazuj listę faktur przed wysyłką do KSeF	przed wysłaniem pokazuje listę faktur do wysłania z podglądem i sumą
Zatwierdzaj faktury zakupowe przed importem	pobrane faktury zakupowe czekają w buforze na Twoją zgodę
Powiadamiaj o nowych fakturach pobranych z KSeF	okienko w prawym dolnym rogu, gdy klient pobierze coś w tle

Przy wyłączaniu zatwierdzania zakupowych program ostrzeże, jeśli w buforze czekają jeszcze niezatwierdzone faktury — po wyłączeniu wejdą do ewidencji same.

Metoda logowania

Zakładka Uwierzytelnianie w KSeF Client daje cztery sposoby zalogowania do systemu:

Metoda	Na czym polega
Token KSeF	klucz wklejany ręcznie, wygenerowany na portalu Ministerstwa Finansów
Certyfikat kwalifikowany / pieczęć	certyfikat z magazynu Windows — ten sam, którym podpisujemy dokumenty
Certyfikat z pliku PFX	certyfikat wskazany jako plik na dysku
Certyfikat wewnętrzny KSeF	certyfikat wydany przez sam KSeF, zamawiany prosto z programu

Logowanie certyfikatem jest wygodniejsze od tokenu: nie trzeba niczego przepisywać ani pilnować terminu ważności klucza wklejonego do ustawień. W wersji 2026 dostępny był wyłącznie token.

Certyfikat wewnętrzny KSeF

W dolnej części zakładki jest lista certyfikatów z ich nazwą, typem, statusem i datą ważności. Przyciski Odśwież, Zamów… i Unieważnij obsługują pełny cykl: wniosek o certyfikat składamy z programu, a po wydaniu pojawia się on na liście.

Obok listy widać limit przyznanych certyfikatów.

Token autoryzacyjny

Token generuje się w systemie KSeF — na stronie Ministerstwa Finansów, po zalogowaniu profilem zaufanym, podpisem kwalifikowanym albo pieczęcią. Token wkleja się do ustawień KSeF Client.

Token jest jak hasło — daje prawo wystawiania faktur w imieniu firmy. Nie przesyłaj go mailem i nie zapisuj w miejscach dostępnych dla osób postronnych.

Środowisko testowe

Przed pierwszą wysyłką produkcyjną warto wypróbować obieg na środowisku testowym. Faktury wysłane testowo nie wywołują skutków prawnych i nie trafiają do kontrahentów.

Gdzie znajdziesz ustawienia

Menu aplikacji → KSeF → Ustawienia klienta. Program otwiera wtedy okno KSeF Client.

Katalog wymiany danych

Oba programy wymieniają się plikami w katalogu C:\RAFSOFT\KSEF2027\. Znajdują się tam między innymi faktury przygotowane do wysyłki, potwierdzenia, pobrane faktury zakupowe i kody QR. Katalogu nie trzeba obsługiwać ręcznie — warto jednak wiedzieć, że istnieje, przy diagnozowaniu problemów.