Definicje najważniejszych pojęć systemu KSeF: FA(3), numer KSeF, certyfikat, UPO, JPK_V7, split payment i wiele innych. Zwięzła referencja dla księgowych, przedsiębiorców i deweloperów integrujących się z KSeF.
Brak haseł dla „”.
Czym jest Krajowy System e-Faktur, od kiedy obowiązuje i kogo dotyczy.
Krajowy System e-Faktur to centralna platforma Ministerstwa Finansów, przez którą przedsiębiorcy wystawiają, odbierają i archiwizują faktury w ustrukturyzowanym formacie XML. System jest obligatoryjny dla czynnych podatników VAT od 2026 roku. Dostęp odbywa się przez portal webowy, aplikacje księgowe lub bezpośrednio przez API.
Harmonogram dla czynnych podatników VAT: 1 lutego 2026 – podatnicy o obrotach powyżej 200 mln zł rocznie; 1 kwietnia 2026 – wszyscy pozostali czynni podatnicy VAT. Mikroprzedsiębiorcy (obrót do 2 mln zł) mają odroczenie do końca 2026. Od tych dat każda faktura B2B musi przejść przez KSeF.
Faza „miękkiego startu” między 1 lutego a 31 grudnia 2026, w której nie grożą kary za błędy techniczne (niepoprawny XML, opóźnienie przesłania). System działa obligatoryjnie, ale administracja skarbowa nie nakłada grzywien za naruszenia formalne – daje czas na dostosowanie. Pełny reżim sankcyjny startuje 1 stycznia 2027.
Poza systemem zostają faktury B2C (dla osób fizycznych), faktury od rolników ryczałtowych, od podatników zwolnionych z VAT, paragony z kasy fiskalnej oraz faktury uproszczone do 450 zł. 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 z faktury. Nabywcy otrzymujący „fakturę papierową” po obowiązku mogą stracić prawo do odliczenia VAT. W okresie przejściowym (luty–grudzień 2026) kary nie są egzekwowane.
Format faktury, jej numer, poświadczenia i dane opisowe nadawane przez system.
Aktualna wersja oficjalnego schematu XML (XSD) dla faktur ustrukturyzowanych w KSeF, wdrożona w 2025 roku. Każda faktura musi być zgodna z tą specyfikacją – inaczej KSeF ją odrzuci. FA(3) rozszerzyła FA(2) m.in. o pole NumerRejestracyjnyPojazdu oraz pola dla branż regulowanych.
Unikalny 35-znakowy identyfikator nadawany każdej fakturze w momencie zaakceptowania. Format: NIP-RRRRMMDD-XXXXXXXX-YY, gdzie pierwszy człon to NIP sprzedawcy, następnie data przydzielenia i hash. To oficjalny „stempel” KSeF zastępujący wewnętrzną numerację podatnika na poziomie rejestrów VAT.
Elektroniczne pokwitowanie generowane przez KSeF po przyjęciu faktury, potwierdzające jej otrzymanie i ważność formalną. Zawiera numer KSeF, sygnaturę czasową i podpis cyfrowy Ministerstwa Finansów. UPO jest dowodem w razie sporu – analogicznie do potwierdzenia nadania listu poleconego.
Po wysłaniu faktura przechodzi przez stany: W trakcie przetwarzania (kolejka walidacji), Zaakceptowana (UPO wygenerowane, numer KSeF nadany) oraz Odrzucona (błąd walidacji XSD lub biznesowy). Faktura raz zaakceptowana nie może zostać anulowana – jedyną drogą jest korekta do zera.
Każda faktura ma dwie daty: datę wystawienia podaną przez sprzedawcę oraz datę przyjęcia przez KSeF. Dla celów VAT i JPK_V7 liczy się data wystawienia, ale dla rozliczenia księgowego przydatna bywa data KSeF. Różnica może wynosić od sekund do kilku dni przy opóźnionej wysyłce.
Zestaw informacji opisujących fakturę bez pełnego XML – numer KSeF, NIP-y stron, daty, kwota brutto, status i typ dokumentu. Pobiera się je endpointem /invoices/query/metadata; są kilkadziesiąt razy mniejsze niż pełny XML, więc idealnie nadają się do listowania i filtrowania przed pobraniem wybranych faktur.
Typy dokumentów rozpoznawane przez system i sposoby ich korygowania.
Faktura sprzedażowa to ta, którą podatnik wystawia klientom (NIP sprzedawcy = NIP podatnika). Faktura kosztowa to ta otrzymana od dostawców. Przy filtrowaniu z API używa się parametrów podmiotSprzedawca i podmiotNabywca, by rozróżnić oba typy.
Dokument zmieniający dane faktury pierwotnej – kwotę, stawkę VAT, dane nabywcy lub treść pozycji. Korekta odwołuje się do numeru KSeF faktury pierwotnej w polu NrFKSeF, a system automatycznie linkuje oba dokumenty. Korekta „do zera” jest jedynym legalnym sposobem anulowania faktury.
Dokument wystawiany przez nabywcę w celu poprawy drobnych błędów formalnych (np. adresu, daty, nazwy usługi). Nie zmienia kwot, stawek VAT ani NIP-ów. Po wprowadzeniu obowiązkowego KSeF rola not korygujących zmalała – większość korekt wymaga pełnej faktury korygującej od sprzedawcy.
Mechanizm, w którym nabywca wystawia fakturę w imieniu sprzedawcy – np. przy skupie surowców od rolników, sprzedaży komisowej czy rozliczeniach w grupach kapitałowych. W KSeF samofakturujący ma oddzielną rolę i znacznik na fakturze. Wymaga pisemnej zgody sprzedawcy i jest ujmowany w rejestrach obu stron.
Jak uwierzytelnić się wobec systemu i kto może działać w imieniu podatnika.
Plik .p12/.pfx z kluczem prywatnym i publicznym, używany do autoryzacji podatnika wobec API KSeF. Generuje się go w portalu po zalogowaniu profilem zaufanym lub podpisem kwalifikowanym. Certyfikat jest ważny 24 miesiące – jego kradzież umożliwia podszywanie się pod podatnika, dlatego KSeF Import szyfruje go AES-256-GCM z kluczem per-użytkownik.
Krótkotrwały token zwracany po pomyślnej autoryzacji certyfikatem, używany w nagłówku Authorization każdego kolejnego requestu. Standardowo wygasa po 60 minutach. Aplikacje integracyjne odświeżają go proaktywnie (np. co 10 minut), by uniknąć błędów 401 podczas długich synchronizacji.
Tak – wystarczy znać numer KSeF faktury i jej kod skrótowy (QR). Przydatne dla kontrahentów zagranicznych, księgowych bez pełnomocnictwa czy działów windykacji. Dostęp anonimowy jest tylko do odczytu – nie pozwala wystawiać ani akceptować dokumentów.
Mechanizm, w którym podatnik upoważnia inny podmiot (np. biuro rachunkowe) do działania w jego imieniu. Pełnomocnictwo rejestruje się osobnym formularzem i jest niezależne od zwykłego pełnomocnictwa do US. Biuro obsługujące 20 klientów potrzebuje 20 pełnomocnictw – dlatego narzędzia jak KSeF Import używają certyfikatów klientów bezpośrednio.
W obrębie jednego NIP-u KSeF rozróżnia role: Właściciel (pełny dostęp), Przedstawiciel prawny, Pełnomocnik (z zakresem uprawnień) oraz Samofakturujący. Każda rola ma własny zakres operacji – np. pełnomocnik może mieć dostęp tylko do odczytu, bez prawa wystawiania.
Tryby komunikacji, limity techniczne i środowiska udostępniane deweloperom.
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.
Oficjalne limity zapytań na NIP i adres IP chronią system przed przeciążeniem. Dla metadanych: ~8 req/s i ok. 20 req/h; dla paczek wsadowych podobnie; dla pojedynczych faktur znacznie więcej. Przekroczenie zwraca HTTP 429 z nagłówkiem Retry-After – integracje muszą stosować exponential backoff.
Testowe (api-test.ksef.mf.gov.pl) – dla deweloperów, faktury bez skutków prawnych. Demo – do pokazów, częściowo wypełnione danymi. Produkcyjne (ksef.mf.gov.pl) – faktyczne faktury objęte rygorem prawnym. Certyfikaty i numery z trybu testowego nie są ważne na produkcji.
Pole NumerRejestracyjnyPojazdu w schemacie FA(3) – obowiązkowe przy sprzedaży paliw przedsiębiorcom, wypełniane przez stację przy każdej transakcji B2B. Dzięki temu firmy transportowe dostają w KSeF faktury z gotową alokacją do konkretnego pojazdu, bez ręcznego opisywania paragonów.
Jak KSeF łączy się z JPK, podzieloną płatnością, kodami GTU i weryfikacją VAT-UE.
JPK_V7 to miesięczny plik z rejestrami VAT, wysyłany do MF osobno niż faktury w KSeF. Po pełnym wejściu KSeF faktury identyfikuje się w JPK przez numer KSeF (pole KSEF_nr). Księgowi powinni uzgadniać oba źródła: KSeF pokazuje, co faktycznie wystawiono/otrzymano, a JPK – co zaraportowano. Rozbieżność oznacza błąd w deklaracji.
Mechanizm Podzielonej Płatności – obowiązkowy przy fakturach brutto ≥ 15 000 zł z towarami lub usługami z załącznika nr 15 do ustawy VAT (paliwa, elektronika, stal, odpady). W KSeF faktura objęta MPP ma w polu MPP wartość true; nabywca płaci VAT na specjalny rachunek VAT sprzedawcy.
Kody oznaczające wrażliwe kategorie towarów i usług w JPK_V7 i KSeF – od GTU_01 (alkohol) przez GTU_05 (odpady) po GTU_13 (usługi transportowe). Każda pozycja faktury może mieć jedno lub więcej oznaczeń. Brak właściwego GTU przy obrocie objętym obowiązkiem grozi karą przy kontroli.
KSeF weryfikuje NIP stron wobec administracji skarbowej, ale nie sprawdza statusu VAT-UE w bazie VIES. Przy transakcjach wewnątrzwspólnotowych weryfikację VIES trzeba przeprowadzić osobno. KSeF zaakceptuje formalnie poprawną fakturę nawet dla nieaktywnego kontrahenta – obowiązek weryfikacji spoczywa na podatniku.
Zacznij od darmowego 7-dniowego okresu próbnego. Faktury z KSeF spływają wprost do Google Sheets, Excela, CSV i zbiorczego PDF – bez logowania do portalu MF.
