28 najważniejszych pojęć Krajowego Systemu e-Faktur — z definicjami 2-4 zdaniowymi. Szybka referencja dla księgowych, przedsiębiorców i deweloperów integrujących się z KSeF.
Ostatnia aktualizacja: 19 kwietnia 2026. Źródło definicji: dokumentacja KSeF Ministerstwa Finansów + własne doświadczenie operacyjne.
Krajowy System e-Faktur — centralna platforma Ministerstwa Finansów RP, przez którą przedsiębiorcy wystawiają, odbierają i archiwizują faktury elektroniczne w ustrukturyzowanym formacie XML. System jest obligatoryjny dla czynnych podatników VAT od 1 lutego 2026 (duzi podatnicy) i 1 kwietnia 2026 (MŚP). Dostęp przez portal webowy, aplikacje księgowe lub bezpośrednio przez API.
Aktualna wersja oficjalnego schematu XML (XSD) dla faktur ustrukturyzowanych w KSeF, wdrożona w 2025 roku. Każda faktura przesyłana do systemu musi być zgodna z tą specyfikacją, inaczej KSeF ją odrzuci. FA(3) rozszerzyła poprzednią wersję FA(2) m.in. o pole NumerRejestracyjnyPojazdu i pola dla branż regulowanych.
Unikalny 35-znakowy identyfikator nadawany każdej fakturze przez system KSeF w momencie jej zaakceptowania. Format: NNNNNNNNNN-YYYYMMDD-XXXXXXXX-YY, gdzie NNNNNNNNNN to NIP sprzedawcy, YYYYMMDD data przydzielenia, reszta to hash. Jest to oficjalny „stempel" KSeF zastępujący wewnętrzną numerację podatnika na poziomie rejestrów VAT.
Plik .p12 / .pfx zawierający klucz prywatny i publiczny używany do autoryzacji podatnika wobec API KSeF. Można go wygenerować w portalu KSeF po zalogowaniu się profilem zaufanym lub kwalifikowanym podpisem elektronicznym. Certyfikat jest ważny 24 miesiące, a jego kradzież umożliwia osobie postronnej podszywanie się pod podatnika — dlatego KSeF Import szyfruje go AES-256-GCM z kluczem pochodnym per-użytkownik.
Krótkotrwały token zwracany przez KSeF po pomyślnej autoryzacji certyfikatem. Używany w nagłówku Authorization każdego kolejnego requestu API w ramach sesji. Standardowo wygasa po 60 minutach i wymaga odnowienia — aplikacje integrujące się z KSeF (jak KSeF Import) odświeżają go proaktywnie co 10 minut, żeby uniknąć błędów 401 w trakcie długich synchronizacji.
KSeF udostępnia dwa tryby komunikacji. Sesja interaktywna obsługuje pojedyncze faktury w czasie rzeczywistym (wystawienie, odczyt, pobranie). Sesja wsadowa (batch) pozwala przesłać lub pobrać paczkę do kilku tysięcy faktur jednym requestem z asynchronicznym odbiorem wyniku — preferowana przy masowym eksporcie historii. KSeF Import używa sesji wsadowej dla zakresów powyżej 100 faktur.
Faktura sprzedażowa (wystawiona) to ta, którą podatnik wystawia swoim klientom — identyfikowana przez NIP sprzedawcy zgodny z NIP podatnika. Faktura kosztowa (otrzymana) to ta, którą podatnik otrzymuje od swoich dostawców. Przy filtrowaniu z API KSeF używa się parametrów podmiotSprzedawca i podmiotNabywca, aby rozróżnić oba typy.
Elektroniczne pokwitowanie wygenerowane przez KSeF po przyjęciu faktury, potwierdzające jej otrzymanie przez system i ważność formalną. Zawiera numer KSeF, sygnaturę czasową i cyfrowy podpis Ministerstwa Finansów. UPO jest dowodem w razie sporu — analogicznie do potwierdzenia nadania listu poleconego. Dla wystawcy UPO oznacza przeniesienie ryzyka reklamacji formalnej na KSeF.
Faktura po wysłaniu do KSeF przechodzi przez stany: W trakcie przetwarzania (kolejka walidacji), Zaakceptowana (UPO wygenerowane, numer KSeF nadany), Odrzucona (błąd walidacji XSD lub biznesowy — trzeba poprawić i wysłać ponownie). Faktura raz zaakceptowana nie może zostać anulowana — jedyną drogą jest faktura korygująca do zera.
Na każdej fakturze elektronicznej są dwie daty: data wystawienia podana przez sprzedawcę (data sprzedaży/dostawy) oraz data przyjęcia przez KSeF — moment zaakceptowania przez system. Dla celów VAT i JPK_V7 liczy się data wystawienia, ale dla rozliczenia księgowego (data dokumentu w systemie) przydatna jest data KSeF. Różnica może wynosić od sekund do kilku dni, jeśli sprzedawca wystawił fakturę, ale wysłał do KSeF z opóźnieniem.
Dokument zmieniający dane faktury pierwotnej — najczęściej kwotę, stawkę VAT, dane nabywcy lub treść pozycji. Korekta wystawiana w KSeF odwołuje się do numeru KSeF faktury pierwotnej w polu NrFKSeF. System automatycznie linkuje oba dokumenty, dzięki czemu przy pobieraniu historii dostajesz spójny łańcuch zdarzeń. Korekta „do zera" jest jedynym legalnym sposobem anulowania faktury.
Dokument wystawiany przez nabywcę (nie sprzedawcę) w celu poprawy drobnych błędów formalnych — np. nieprawidłowego adresu, daty, nazwy usługi. Nota korygująca NIE zmienia kwot, stawek VAT ani danych identyfikacyjnych (NIP). Od wprowadzenia obowiązkowego KSeF rola not korygujących znacząco zmalała — większość korekt wymaga pełnej faktury korygującej wystawionej przez sprzedawcę.
JPK_V7 to miesięczny plik XML z rejestrami VAT (sprzedaży i zakupu), wysyłany do MF osobno niż faktury w KSeF. Po pełnym wejściu KSeF, faktury w JPK_V7 identyfikuje się przez numer KSeF (pole KSEF_nr). Księgowe powinny uzgadniać oba źródła — KSeF pokazuje co faktycznie wystawiono/otrzymano, a JPK pokazuje co zaraportowano. Rozbieżność = błąd w deklaracji.
Mechanizm Podzielonej Płatności — obowiązkowy przy fakturach o wartości brutto ≥ 15 000 zł zawierających towary lub usługi z załącznika nr 15 do ustawy VAT (m.in. paliwa, elektronika, stal, odpady). W KSeF faktura objęta MPP ma w polu MPP wartość true. Nabywca musi zapłacić VAT na specjalny rachunek VAT sprzedawcy, a nie na rachunek bieżący.
Kody oznaczające wrażliwe kategorie towarów i usług w JPK_V7 i KSeF, od GTU_01 (alkohol) przez GTU_03 (olej opałowy), GTU_05 (odpady), aż do GTU_13 (usługi transportowe). Każda pozycja faktury może mieć przypisane jedno lub więcej oznaczeń GTU. Brak właściwego GTU przy obrocie objętym obowiązkiem = potencjalna kara przy kontroli.
Harmonogram obowiązkowego KSeF dla czynnych podatników VAT: 1 lutego 2026 — dla podatników o obrotach powyżej 200 mln zł rocznie; 1 kwietnia 2026 — dla wszystkich pozostałych czynnych podatników VAT. Mikroprzedsiębiorcy (obrót do 2 mln zł) mają odroczenie do końca 2026. Od tych dat każda faktura B2B musi być wystawiona przez KSeF — pod rygorem kary finansowej.
Fazie „miękkiego startu" między 1 lutego a 31 grudnia 2026 nie grożą kary za błędy techniczne (np. niepoprawny XML, opóźnienie przesłania). System działa obligatoryjnie, ale Krajowa Administracja Skarbowa nie nakłada grzywien za naruszenia formalne — daje podatnikom czas na dostosowanie. Od 1 stycznia 2027 pełny reżim sankcyjny.
Nie wszystkie faktury muszą być w KSeF. Poza systemem zostają: faktury B2C (dla osoby fizycznej nieprowadzącej działalności), faktury od rolników ryczałtowych, faktury od podatników zwolnionych z VAT, faktury z kasy fiskalnej (paragony) i faktury uproszczone do 450 zł. Także transakcje wewnątrzunijne i eksport do krajów trzecich mają odrębne reżimy.
Od 1 stycznia 2027 podatnik, który nie wystawił faktury przez KSeF mimo obowiązku, może zostać ukarany grzywną do 100% kwoty VAT wykazanego na fakturze. Dodatkowo nabywcy otrzymujący „fakturę papierową" w okresie po obowiązku mogą zostać pozbawieni prawa do odliczenia VAT. W okresie przejściowym (luty-grudzień 2026) kary nie są egzekwowane.
KSeF udostępnia możliwość pobrania faktury bez logowania — wystarczy znać jej numer KSeF i kod skrótowy (QR kod). Przydatne dla kontrahentów zagranicznych, księgowych bez pełnomocnictwa, działów windykacji weryfikujących fakturę. Dostęp anonimowy jest read-only i nie pozwala na wystawianie ani akceptację — tylko na odczyt.
Mechanizm, dzięki któremu podatnik (mocodawca) upoważnia inny podmiot (np. biuro rachunkowe) do działania w swoim imieniu w KSeF. Pełnomocnictwo w KSeF rejestruje się osobnym formularzem przez portal i jest niezależne od zwykłego pełnomocnictwa do US. Biuro obsługujące 20 klientów musi mieć 20 pełnomocnictw KSeF, co w praktyce staje się operacyjnym wąskim gardłem — dlatego aplikacje takie jak KSeF Import używają certyfikatów klientów bezpośrednio.
W obrębie jednego NIP-u KSeF rozróżnia kilka ról: Właściciel (pełny dostęp), Przedstawiciel prawny (właściciel/członek zarządu), Pełnomocnik (z zakresem uprawnień), Samofakturujący (nabywca wystawiający w imieniu sprzedawcy). Każda rola ma własny zakres dopuszczalnych operacji — np. pełnomocnik może mieć uprawnienie tylko do odczytu, bez wystawiania.
Mechanizm, w którym nabywca wystawia fakturę w imieniu sprzedawcy (najczęściej przy skupie surowców od rolników, sprzedaży komisowej, wewnątrzfirmowym rozliczaniu w grupach kapitałowych). W KSeF samofakturujący ma oddzielną rolę i specjalny znacznik na fakturze. Wymaga pisemnej zgody sprzedawcy i jest uwzględniany w rejestrach obu stron.
Oficjalne limity liczby zapytań do API KSeF na NIP i adres IP, chroniące system przed przeciążeniem. Dla odczytu metadanych faktur: 8 req/s, 16 req/min, 20 req/h; dla eksportu paczek: 4 req/s, 8 req/min, 20 req/h; dla pobierania pojedynczych faktur: 10 req/s, 60 req/min, 600 req/h. Przekroczenie zwraca HTTP 429 z nagłówkiem Retry-After. Aplikacje integracyjne muszą stosować exponential backoff.
KSeF udostępnia trzy środowiska. Testowe (api-test.ksef.mf.gov.pl) — dla deweloperów, pełna swoboda eksperymentów, faktury nie mają skutków prawnych. Demo — do pokazów klientom, częściowo wypełnione danymi. Produkcyjne (ksef.mf.gov.pl) — faktyczne faktury objęte rygorem prawnym. Certyfikaty, numery KSeF i dane z trybu testowego NIE są ważne na produkcji.
Pole NumerRejestracyjnyPojazdu w schemacie FA(3) — obowiązkowe przy sprzedaży paliw do przedsiębiorców. Wypełnia je stacja paliwowa przy każdej transakcji B2B. Dzięki temu firmy transportowe i logistyczne dostają w KSeF faktury z „gotową" alokacją do konkretnej ciężarówki — bez ręcznego opisywania paragonów. Patrz też: KSeF dla transportu TSL.
Zestaw informacji opisujących fakturę bez samego XML — numer KSeF, NIP sprzedawcy/nabywcy, data wystawienia, data przyjęcia, kwota brutto, status, typ (VAT / korekta / zaliczkowa). Metadane pobiera się przez endpoint /invoices/query/metadata i są one kilkadziesiąt razy mniejsze niż pełny XML — idealnie nadają się do listowania i filtrowania zanim pobierze się wybrane faktury w pełni.
System KSeF weryfikuje NIP sprzedawcy i nabywcy wobec Krajowej Administracji Skarbowej, ale NIE sprawdza statusu VAT-UE w bazie VIES. Przy transakcjach wewnątrzwspólnotowych weryfikację VIES trzeba przeprowadzić osobno (przez ec.europa.eu/vies lub komercyjne API). KSeF akceptuje fakturę formalnie poprawną nawet jeśli kontrahent jest nieaktywny — to obowiązek podatnika zweryfikować kontrahenta przed fakturowaniem.
Zacznij od darmowego 7-dniowego okresu próbnego. Bez karty kredytowej.
Wypróbuj za darmo