Konfiguracja KSeF

Konfiguracja KSeF

Konfiguracja KSeF - Faktura VAT 2027
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 programu → KSeF), ustawiamy to, jak program ma się zachowywać przy wysyłce i odbiorze, jak wygląda tytuł przelewu za fakturę z numerem KSeF i czy faktura może wyjść do klienta bez numeru KSeF — patrz niżej.

Gdzie znajdziesz KSeF Client

KSeF Client działa w tle. Jego okno otworzymy z zasobnika systemowego albo z Faktury VAT.

Z zasobnika systemowego. Ikona KSeF Client jest obok zegara. Windows zwykle chowa nowe ikony — wtedy klikamy strzałkę ^ (Pokaż ukryte ikony) i dopiero tam widać ikonę klienta. Okno ustawień otwiera dwuklik ikony albo prawy przycisk myszy → Ustawienia… (w tym samym menu są też Synchronizuj, Sprawdź aktualizacje… i Zakończ).

Pasek zadań: strzałka Pokaż ukryte ikony i ikona KSeF Client wśród ukrytych ikon
Pasek zadań: strzałka Pokaż ukryte ikony i ikona KSeF Client wśród ukrytych ikon
Menu ikony KSeF Client pod prawym przyciskiem myszy: Ustawienia..., Synchronizuj, O programie..., Sprawdź aktualizacje..., Zakończ
Menu ikony KSeF Client pod prawym przyciskiem myszy: Ustawienia..., Synchronizuj, O programie..., Sprawdź aktualizacje..., Zakończ

Z Faktury VAT — na dwa sposoby:

  • menu aplikacji (przycisk w lewym górnym rogu) → KSeF → Ustawienia klienta KSeF,
Menu aplikacji → KSeF → Ustawienia klienta KSeF
Menu aplikacji → KSeF → Ustawienia klienta KSeF
  • Konfiguracja programu → KSeF → Ogólne → przycisk Ustawienia klienta KSeF… (sekcja Klient KSeF).
Konfiguracja programu → KSeF → Ogólne w Fakturze VAT: przycisk Ustawienia klienta KSeF… otwiera okno KSeF Client
Konfiguracja programu → KSeF → Ogólne w Fakturze VAT: przycisk Ustawienia klienta KSeF… otwiera okno KSeF Client

Co trzeba ustawić

UstawienieZnaczenie
NIP firmypodmiot, w którego imieniu wysyłane są faktury
Token autoryzacyjnyklucz wygenerowany w systemie KSeF; upoważnia program do wysyłki
Środowiskoprodukcyjne (faktury o skutkach prawnych) albo testowe
Tryb KSeFwłącznik obsługi — przy wyłączonym synchronizacja nic nie wysyła

Zakładka Główna

KSeF Client, zakładka Główna: środowisko, NIP, token KSeF (ukryty), przycisk Uwierzytelnij i stan połączenia na dole okna
KSeF Client, zakładka Główna: środowisko, NIP, token KSeF (ukryty), przycisk Uwierzytelnij i stan połączenia na dole okna
PoleZnaczenie
Środowiskoprodukcyjne albo testowe (api-test.ksef.mf.gov.pl)
NIPpodmiot, w którego imieniu wysyłamy faktury
Token KSeFklucz autoryzacyjny; ikona oka pokazuje wpisaną wartość

Poniżej cztery przełączniki:

  • Tryb KSeF (blokada edycji i usuwania faktur) — główny włącznik obsługi KSeF. Przy wyłączonym synchronizacja nic nie wysyła i nic nie pobiera, a program proponuje otwarcie ustawień KSeF Client. Przy włączonym dokumentu wysłanego do KSeF 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

KSeF Client, zakładka Dodatkowa: foldery wymiany, faktury zagraniczne i do osób prywatnych, zakres dni, automatyczne pobieranie z KSeF, pobieranie faktur sprzedażowych
KSeF Client, zakładka Dodatkowa: foldery wymiany, faktury zagraniczne i do osób prywatnych, zakres dni, automatyczne pobieranie z KSeF, pobieranie faktur sprzedażowych

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

FolderZawiera
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 (po odznaczeniu faktury z nabywcą spoza Polski nie idą do KSeF, więc nie dostają numeru KSeF ani kodu QR), faktury do osób prywatnych, zakres dni od kiedy wysyłać i pobierać (domyślnie 30) oraz Automatyczne pobieranie z KSeF co 15, 30 lub 60 minut (domyślnie wyłączone). Ta opcja tylko pobiera faktury z KSeF — niczego nie wysyła. O pobranych fakturach Faktura VAT dowiaduje się sama i pokazuje powiadomienie w prawym dolnym rogu okna — niczego przy tym nie importuje bez Twojego kliknięcia (patrz Faktury zakupowe z KSeF i Faktury sprzedażowe z KSeF).

Zakres pobierania ogranicza API KSeF do 3 miesięcy. Jedno zapytanie o faktury może obejmować najwyżej 3 miesiące kalendarzowe — to limit Ministerstwa Finansów, nie programu (dłuższy zakres API odrzuca błędem 21405). Gdy w polu zakresu ustawimy datę starszą, program sam przycina ją do trzech miesięcy wstecz i zapisuje to w logu („Zakres … dni > 3 miesiące – ograniczam DateFrom automatycznie”).

Przykład: zakres od 01.04.2026 przy synchronizacji 15.10.2026 to 197 dni, więc program pobierze faktury od 16.07.2026 — nie od kwietnia.

Jak pobrać starsze faktury. Synchronizujemy etapami, po kwartale: ustawiamy zakres na trzy miesiące, synchronizujemy, potem przesuwamy go na wcześniejszy okres i powtarzamy. Pojedyncze starsze faktury najszybciej pobrać z Aplikacji Podatnika i wczytać do programu.

Uwaga na limit zapytań: /invoices/query/metadata ma limit 20 zapytań na godzinę — najsurowszy w całym API KSeF. Nie klikamy synchronizacji wielokrotnie pod rząd; po przekroczeniu limitu KSeF odmawia na godzinę.

Nowość rocznika 2027: przełącznik Pobieraj też faktury sprzedażowe (wystawione) — przy każdej synchronizacji klient pobiera także faktury sprzedaży wystawione poza programem (np. w Aplikacji Podatnika). Trafiają do poczekalni opisanej w rozdziale Faktury sprzedażowe z KSeF.

Zakładka Inne

KSeF Client, zakładka Inne: limit długości nazwy towaru i wyciszanie komunikatów o błędach
KSeF Client, zakładka Inne: limit długości nazwy towaru i wyciszanie komunikatów o błędach
  • 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 programu → KSeF)

Węzeł KSeF w Konfiguracji programu (F12) jest rozwijany, jak Drukarka fiskalna, i ma trzy strony:

StronaCo ustawiamy
Ogólneklient KSeF, zatwierdzanie faktur zakupowych, wysyłka, powiadomienia i tryb pracy (faktury offline) — opis niżej
Tytuł przelewulista Tytuł przelewu za fakturę z numerem KSeF: — numer KSeF i numer faktury (domyślnie), sam numer KSeF, numer faktury i numer KSeF albo bez numeru KSeF (jak dotąd)
Wydanie fakturylista Faktura sprzedaży bez numeru KSeF (druk, PDF, e-mail): — Nie sprawdzaj, Ostrzegaj (domyślnie) albo Wymagaj numeru KSeF

Ustawienia Tytuł przelewu i Wydanie faktury należą do firmy — zapisują się w jej bazie i obowiązują na wszystkich stanowiskach. Od płatności z 1 stycznia 2027 r. numer KSeF faktury trzeba podawać w tytule przelewu — co dokładnie robi program przy każdej z tych opcji, opisuje rozdział Numer KSeF w przelewach i identyfikator zbiorczy.

Konfiguracja programu → KSeF → Tytuł przelewu
Konfiguracja programu → KSeF → Tytuł przelewu
Konfiguracja programu → KSeF → Wydanie faktury
Konfiguracja programu → KSeF → Wydanie faktury

Strona Ogólne

Cztery przełączniki decydują o tym, czy program pyta przed wysyłką i przed importem oraz czy powiadamia o nowych fakturach. Trzy pierwsze 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. Czwarty, Powiadomienia push na urządzeniach i e-mail, jest domyślnie wyłączony i pokazuje stan z panelu mobilna-faktura.pl (patrz niżej).

OpcjaCo robi
Pokazuj listę faktur przed wysyłką do KSeFprzed wysłaniem pokazuje listę faktur do wysłania z podglądem i sumą
Zatwierdzaj faktury zakupowe przed importempobrane faktury zakupowe czekają w buforze na Twoją zgodę
Powiadamiaj w aplikacji Faktura VAT o nowych fakturach pobranych z KSeFkarta powiadomienia w prawym dolnym rogu okna programu, gdy klient pobierze coś w tle
Powiadomienia push na urządzeniach i e-mailpowiadomienie na telefon lub e-mailem — także wtedy, gdy program i komputer są wyłączone (patrz niżej)

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

Na tej samej stronie jest też grupa KSeF — tryb pracy (faktury offline) z listą Tryb pracy systemu KSeF: i polem Koniec niedostępności / awarii: — opis w rozdziale Tryby offline.

Powiadomienia na telefon i e-mailem (przy wyłączonym programie)

Klient KSeF pobiera faktury zakupowe automatycznie. Przy włączonej opcji Powiadamiaj w aplikacji Faktura VAT o nowych fakturach pobranych z KSeF program daje o tym znać kartą w prawym dolnym rogu okna — na przykład Nowe faktury zakupowe z KSeF: 3 — czekają na zatwierdzenie (patrz Faktury zakupowe z KSeF). Kartę widzimy jednak tylko wtedy, gdy program jest uruchomiony.

Opcja Powiadomienia push na urządzeniach i e-mail pozwala dostać tę samą informację poza programem: na telefon, jako powiadomienie systemowe na komputerze albo e-mailem — także na adres biura rachunkowego. Wysyła ją panel mobilna-faktura.pl ze swojego serwera, więc wiadomość dotrze także po godzinach, gdy program i komputer są wyłączone.

Checkbox w konfiguracji pokazuje stan z panelu — nie jest osobnym ustawieniem programu. Domyślnie jest wyłączony. Po kliknięciu:

  • jeśli nie mamy jeszcze konta w panelu, program zapyta, czy ustawić je teraz, i otworzy okno Połącz konto mobilna-faktura.pl (samo podanie loginu i hasła — bez synchronizacji firm, cennika i dokumentów),
  • jeśli konto jest połączone, program otworzy w przeglądarce ustawienia powiadomień, gdzie wybieramy firmy i kanały.

Pod checkboxem widać, co się dzieje: Włączone, Wyłączone, Wstrzymane (token KSeF stracił ważność) albo informacja, że brakuje konta lub zapamiętanego hasła do panelu. Stan odświeża się przy każdym otwarciu konfiguracji.

Konfiguracja KSeF: powiadomienia push na urządzeniach i e-mail
Konfiguracja KSeF: powiadomienia push na urządzeniach i e-mail

Powiadomienia na telefon wymagają zainstalowania panelu jako aplikacji — szczegóły i wybór kanałów opisuje instrukcja panelu (Ustawienia → KSeF → Powiadomienia).

Metoda logowania

Zakładka Uwierzytelnianie w KSeF Client daje pięć sposobów zalogowania do systemu:

KSeF Client, zakładka Uwierzytelnianie: metoda logowania, przycisk Zaloguj i lista certyfikatów KSeF
KSeF Client, zakładka Uwierzytelnianie: metoda logowania, przycisk Zaloguj i lista certyfikatów KSeF
MetodaNa czym polega
Token KSeFklucz 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 PFXcertyfikat wskazany jako plik na dysku
Certyfikat wewnętrzny KSeFcertyfikat wydany przez sam KSeF i zainstalowany w Windows — np. zamówiony prosto z programu
Certyfikat KSeF z plików .crt/.key (Aplikacja Podatnika)certyfikat KSeF wygenerowany w Aplikacji Podatnika KSeF: plik .crt, plik .key i hasło do klucza

Pod listą metod widać tylko elementy wybranej metody, a krótki opis podpowiada, co zrobić: przy certyfikacie kwalifikowanym i wewnętrznym KSeF — Wybierz… (certyfikat z magazynu Windows), przy PFX — Plik PFX…, przy certyfikacie z plików — Wskaż pliki…. Do tego Zaloguj, który loguje do KSeF podpisem wybranym certyfikatem. Przy metodzie Token KSeF logujemy się jak dotąd — przyciskiem Uwierzytelnij na zakładce Główna.

Logowanie certyfikatem jest wygodniejsze od tokenu: nie trzeba niczego przepisywać. Certyfikaty też mają termin ważności — dla certyfikatu wewnętrznego KSeF widać go w kolumnie Ważny do. W wersji 2026 dostępny był wyłącznie token.

Warto pamiętać:

  • token i certyfikaty są zapamiętywane osobno dla każdego środowiska — certyfikat użyty na środowisku testowym nie zaloguje na produkcyjnym,
  • certyfikat na karcie lub wymagający PIN-u działa tylko przy logowaniu ręcznym; automatyczne pobieranie z KSeF pomija wtedy logowanie, żeby nie otwierać okna PIN po cichu.

Certyfikat KSeF z Aplikacji Podatnika

Certyfikat KSeF wygenerowany w Aplikacji Podatnika KSeF (Moduł Certyfikatów i Uprawnień) to dwa pliki: certyfikat .crt i klucz prywatny .key. Wybieramy metodę Certyfikat KSeF z plików .crt/.key (Aplikacja Podatnika), klikamy Wskaż pliki…, wskazujemy oba pliki i wpisujemy hasło do klucza — to samo, które nadaliśmy przy generowaniu certyfikatu (przy złym haśle program zapyta ponownie). Program zapisuje certyfikat w Windows; hasła nie zapamiętuje i nie będzie go już potrzebował. Na koniec klikamy Zaloguj — od tej chwili program może logować się tym certyfikatem także sam, w tle.

Jeśli przy metodzie Certyfikat wewnętrzny KSeF przyciskiem Wybierz… wskażemy certyfikat kwalifikowany, program ostrzeże, że to nie jest certyfikat KSeF, i podpowie właściwą metodę.

Certyfikat wewnętrzny KSeF

Sekcja Certyfikat KSeF jest aktywna po wybraniu metody certyfikatowej. 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. Zamówienie wymaga wcześniejszego zalogowania do KSeF przyciskiem Zaloguj — wniosek składa się w ramach sesji założonej podpisem. Unieważnienia nie da się cofnąć, dlatego program prosi o potwierdzenie. Po zalogowaniu tokenem lista, zamawianie i unieważnianie certyfikatów nie są dostępne (Ministerstwo Finansów dopuszcza je tylko w sesji założonej podpisem) — program mówi to komunikatem i nie wysyła zapytania do KSeF.

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.

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.

Czy ta strona była pomocna?