KSeF — pytania i odpowiedzi: programy, integracje i środowiska

Faktury ustrukturyzowane wystawia się i otrzymuje przy użyciu Krajowego Systemu e-Faktur za pomocą oprogramowania interfejsowego (art. 106gb ust. 1 ustawy o VAT) — w praktyce przez program zintegrowany z API KSeF albo bezpłatne narzędzie Ministerstwa Finansów. Poniżej zebrano pytania, które przedsiębiorcy i biura rachunkowe zadają przy wyborze i konfiguracji takiego rozwiązania. Zagadnienia ściśle programistyczne — specyfikacja API KSeF 2.0, schematy XSD, szyfrowanie przesyłanych danych — dotyczą dostawców oprogramowania i zostały pominięte.

Wybór sposobu korzystania z KSeF

Jakimi narzędziami można wystawiać i odbierać faktury w KSeF?

Każdym programem finansowo-księgowym lub fakturowym zintegrowanym z API KSeF 2.0 albo jednym z bezpłatnych narzędzi Ministerstwa Finansów: Aplikacją Podatnika KSeF działającą w przeglądarce (ap.ksef.mf.gov.pl), Aplikacją Mobilną KSeF na telefony z systemem Android lub iOS oraz aplikacją e-mikrofirma w e-Urzędzie Skarbowym. Dostawca oprogramowania nie zawiera w tym celu umowy z Ministerstwem Finansów — wystarczy, że program spełnia opublikowaną specyfikację. Oba sposoby można łączyć, np. wystawiać faktury w programie, a uprawnieniami zarządzać w Aplikacji Podatnika. Narzędzia ministerstwa opisuje artykuł Bezpłatne narzędzia KSeF.

Kiedy wystarczą bezpłatne narzędzia, a kiedy potrzebny jest program zintegrowany z KSeF?

Bezpłatne narzędzia sprawdzają się przy niewielkiej liczbie faktur wystawianych pojedynczo, ręcznie. Program zintegrowany z KSeF jest uzasadniony, gdy faktur jest dużo, gdy dane sprzedaży pochodzą z innego systemu (sklep internetowy, gospodarka magazynowa, system rozliczeń z odbiorcami) albo gdy faktury zakupowe mają trafiać bez przepisywania do ewidencji VAT i ksiąg. Od rozliczeń za luty 2026 r. ewidencja w plikach JPK_V7M i JPK_V7K zawiera numer identyfikujący fakturę w KSeF (o ile został nadany do dnia przesłania ewidencji), więc automatyczne pobieranie tych numerów ogranicza ryzyko pomyłek. Bezpłatne narzędzia Ministerstwa Finansów nie obsługują faktur z załącznikiem; wystawia się je w programie zintegrowanym z API KSeF, który tę funkcję zapewnia, po zgłoszeniu w e-Urzędzie Skarbowym i otrzymaniu potwierdzenia możliwości ich wystawiania (art. 106gba ust. 2, 3 i 7 ustawy o VAT).

Jakie ograniczenia mają Aplikacja Mobilna KSeF i e-mikrofirma?

Aplikacja Mobilna KSeF służy do wystawiania faktur podstawowych i ich korekt w transakcjach krajowych w złotych; korygować można tylko faktury wystawione w tej aplikacji, a pozostałe faktury podatnika są w niej dostępne do podglądu i pobrania. Z aplikacji zainstalowanej na danym urządzeniu korzysta jedna osoba, uwierzytelniająca się przez węzeł krajowy (np. profilem zaufanym lub w aplikacji mObywatel). e-mikrofirma jest przeznaczona dla osób fizycznych prowadzących jednoosobową działalność gospodarczą — obsługuje faktury krajowe bez procedur szczególnych i na ich podstawie tworzy ewidencję VAT oraz plik JPK_VAT. Żadne z bezpłatnych narzędzi nie pozwala wystawić faktury z załącznikiem; otrzymaną fakturę z załącznikiem można odczytać w Aplikacji Podatnika i w e-mikrofirmie, a Aplikacja Mobilna wyświetla ją bez załącznika, informując o jego istnieniu.

Na co zwrócić uwagę, sprawdzając przygotowanie programu do KSeF?

Program musi korzystać z API KSeF 2.0 i wystawiać faktury w strukturze FA(3) — integracje i tokeny z pierwszej wersji systemu nie działają w KSeF 2.0. U dostawcy warto potwierdzić, czy program:

• obsługuje, obok trybu online, tryb offline24 i tryby awaryjne, w tym oznaczanie faktur kodami QR z użyciem certyfikatu KSeF,
• pobiera faktury zakupowe i zapisuje ich numery KSeF,
• przechowuje numery referencyjne sesji i UPO,
• przenosi numery KSeF do ewidencji VAT i pliku JPK_V7,
• umożliwia eksport plików XML faktur do archiwum poza KSeF.

W jaki sposób program uzyskuje dostęp do KSeF?

Program działa w imieniu uwierzytelnionej osoby lub podmiotu i wyłącznie w granicach uprawnień nadanych przez podatnika. Uwierzytelnienie wymaga środka identyfikacji elektronicznej z węzła krajowego, kwalifikowanego podpisu lub kwalifikowanej pieczęci elektronicznej albo certyfikatu KSeF (§ 6 ust. 1 rozporządzenia w sprawie korzystania z KSeF); programy posługują się zwykle certyfikatem KSeF albo tokenem (ciągiem znaków alfanumerycznych) wygenerowanym przez osobę uprawnioną. Certyfikat KSeF jest ważny nie dłużej niż 2 lata od wytworzenia albo od wskazanej przez podatnika daty początkowej i może być odnowiony w okresie ważności (§ 6 ust. 2). Token może służyć do uwierzytelniania do 31 grudnia 2026 r. (§ 13 ust. 1 pkt 1 rozporządzenia); po tym terminie do uwierzytelniania służą wyłącznie środki wymienione w § 6 ust. 1. Nadawanie uprawnień omawia strona KSeF — pytania i odpowiedzi: uprawnienia i certyfikaty.

Jak biuro rachunkowe otrzymuje faktury klienta z KSeF?

Podatnik nadaje biuru, jako podmiotowi identyfikowanemu numerem NIP, uprawnienie do dostępu do faktur, a w razie potrzeby także do ich wystawiania; biuro wskazuje następnie swoich pracowników, którzy z tego uprawnienia korzystają (§ 3 ust. 3 rozporządzenia). Program biura pobiera wtedy faktury zakupowe i sprzedażowe klienta bezpośrednio z KSeF — klient nie przekazuje ich odrębnie. Podatnik zachowuje własny dostęp do systemu i może odebrać uprawnienie w każdej chwili. Zakres obsługi faktur przez biuro przedstawia strona VAT, JPK i KSeF.

Środowiska KSeF

Do czego służą środowiska testowe, przedprodukcyjne i produkcyjne?

KSeF działa w trzech odrębnych środowiskach. Środowisko testowe jest ogólnodostępne i służy przede wszystkim dostawcom oprogramowania do sprawdzania integracji; można się w nim uwierzytelnić w kontekście dowolnego NIP, także samodzielnie wygenerowanym certyfikatem, dlatego nie wprowadza się do niego rzeczywistych danych firmy. Środowisko przedprodukcyjne (demo) wymaga rzeczywistego uwierzytelnienia i uprawnień, jak system docelowy, i nadaje się do przećwiczenia obiegu faktur w firmie oraz między firmą a biurem. Dokumenty przesłane do obu tych środowisk nie są fakturami i nie wywołują skutków prawnych — skutki takie ma wyłącznie środowisko produkcyjne, działające od 1 lutego 2026 r.

Co zrobić, gdy faktura testowa trafi do środowiska produkcyjnego?

Dokument przyjęty w środowisku produkcyjnym i oznaczony numerem KSeF jest wystawioną fakturą ustrukturyzowaną (art. 2 pkt 32a ustawy o VAT), nawet jeżeli nie dokumentuje żadnej transakcji. Jeżeli wykazano w nim kwotę podatku, podlega ona zapłacie na podstawie art. 108 ust. 1 ustawy o VAT; Ministerstwo Finansów wskazuje, że należy wówczas niezwłocznie wystawić fakturę korygującą „do zera”. Przyczyną bywa pozostawienie w programie ustawień środowiska produkcyjnego na czas testów — przed pierwszą wysyłką należy sprawdzić, z którym środowiskiem program się łączy. Również w środowisku testowym ostrożność jest wskazana: podmiot o numerze NIP wpisanym na fakturze testowej może uzyskać dostęp do jej treści.

Struktura FA(3)

Czym jest struktura FA(3) i z jakich części się składa?

FA(3) to wzór faktury ustrukturyzowanej udostępniony przez ministra właściwego do spraw finansów publicznych na platformie ePUAP (art. 106gb ust. 8 ustawy o VAT). Od 1 lutego 2026 r. stosuje się go do wszystkich faktur ustrukturyzowanych, także do korekt faktur wystawionych wcześniej w strukturze FA(2). Plik XML faktury obejmuje nagłówek, dane sprzedawcy (Podmiot1) i nabywcy (Podmiot2), dane ewentualnych podmiotów trzecich — np. odbiorcy, podmiotu dokonującego płatności lub pracownika, którego dotyczy wydatek (Podmiot3) — oraz podmiotu upoważnionego; dalej następuje część Fa (daty, numer, kwoty, adnotacje, wiersze, rozliczenie, płatność, warunki transakcji), a po niej stopka i opcjonalny załącznik. Pola wypełnia program, ale od ich poprawności zależy przyjęcie faktury przez system. Poszczególne części omawia artykuł Struktura e-faktury FA(3).

Czy trzeba wypełniać wszystkie pola struktury i gdzie umieścić dodatkowe dane handlowe?

Obowiązkowe są elementy wymagane przepisami art. 106a–106q ustawy o VAT oraz pola, które struktura oznacza jako wymagane. Znaczna część pól ma charakter dobrowolny — wprowadzono je z uwagi na praktykę obrotu, a program nie jest obowiązany przenosić na fakturę wszystkich danych, którymi dysponuje. Części fakultatywne, takie jak rozliczenie, płatność, warunki transakcji, stopka czy załącznik, mogą nie występować; jeżeli jednak program wypełni taką część, musi uzupełnić wszystkie jej pola obowiązkowe, w przeciwnym razie faktura zostanie odrzucona. Dane, dla których struktura nie przewiduje odrębnych pól — np. numer zamówienia nadany przez nabywcę, seria i termin ważności produktu — umieszcza się w polu dodatkowego opisu, odnoszącym się do całej faktury albo do wiersza; stopka faktury mieści do 3500 znaków.

Wysyłka faktur

Czym jest sesja i numer referencyjny sesji?

Faktury trafiają do KSeF w ramach sesji: interaktywnej, w której pliki XML przesyła się pojedynczo (tak działają bezpłatne narzędzia ministerstwa), albo wsadowej, w której program przesyła naraz paczkę faktur w skompresowanym archiwum (domyślnie ZIP). Każda wysyłka otrzymuje numer referencyjny — w sesji interaktywnej numer referencyjny sesji, w wysyłce wsadowej numer referencyjny paczki — który służy do sprawdzenia statusu przetworzenia i pobrania Urzędowego Poświadczenia Odbioru (UPO). Numer referencyjny nie jest numerem KSeF: ten przydziela się odrębnie każdej przyjętej fakturze i to on identyfikuje fakturę w obrocie. W Aplikacji Podatnika historia sesji pokazuje liczbę faktur wysłanych i odrzuconych w danej sesji oraz pozwala pobrać zbiorcze UPO w formacie XML albo PDF. Więcej w artykule Numer KSeF i UPO.

Jakie limity obowiązują przy wysyłce i pobieraniu faktur?

Według dokumentacji technicznej API KSeF 2.0 (stan na 2 października 2026 r.) plik XML faktury może mieć domyślnie najwyżej 1 MB (faktury z załącznikiem — 3 MB), a w jednej sesji można przesłać do 10 000 faktur; paczkę w wysyłce wsadowej dzieli się na nie więcej niż 50 części po najwyżej 100 MB każda (przed zaszyfrowaniem). Faktury z załącznikiem przesyła się wyłącznie w sesji wsadowej (z wyjątkiem korekty technicznej takiej faktury). Niezależnie od tego system ogranicza liczbę zapytań w ciągu sekundy, minuty i godziny, liczoną odrębnie dla każdej pary: kontekst (np. NIP) i adres IP. Po przekroczeniu limitu KSeF czasowo odmawia obsługi, a program powinien ponowić operację po wskazanym czasie; przy powtarzających się przekroczeniach blokada się wydłuża. Podwyższenie limitów w środowisku produkcyjnym jest możliwe na uzasadniony wniosek składany przez formularz kontaktowy na stronie ksef.podatki.gov.pl.

Co oznacza odrzucenie faktury lub części paczki przez KSeF?

Faktura odrzucona nie otrzymuje numeru KSeF, a więc nie zostaje wystawiona — nie koryguje się jej, lecz poprawia dane i przesyła ponownie. Przyczyny odrzucenia to m.in. niezgodność pliku ze strukturą FA(3), brak uprawnień osoby wysyłającej oraz duplikat: system odrzuca plik, jeżeli faktura o tym samym NIP sprzedawcy, numerze i rodzaju została już przyjęta w ciągu ostatnich 10 lat. Wysyłka wsadowa nie jest niepodzielna — każdy plik w paczce przetwarza się osobno, więc błędne faktury są odrzucane, a pozostałe otrzymują numery KSeF. Jeżeli poprawiona faktura trafi do KSeF w dniu późniejszym niż data wystawienia wskazana w pliku, uznaje się ją za wystawioną w trybie offline24 z tą datą, a przesłać ją należy najpóźniej w następnym dniu roboczym po dniu wystawienia (art. 106nda ust. 2, 10 i 16 ustawy o VAT).

Czy KSeF działa całą dobę i skąd wiadomo o jego niedostępności?

Według Ministerstwa Finansów KSeF działa przez całą dobę, we wszystkie dni roku, z wyjątkiem okresów ogłoszonej niedostępności (zwykle planowych prac serwisowych) i awarii. Informację o okresie niedostępności minister właściwy do spraw finansów publicznych zamieszcza w Biuletynie Informacji Publicznej (art. 106ne ust. 4 ustawy o VAT), a komunikaty o wystąpieniu i zakończeniu awarii — w Biuletynie Informacji Publicznej oraz za pośrednictwem oprogramowania interfejsowego (art. 106ne ust. 1); gdy nie można ich zamieścić w Biuletynie, ogłasza je w środkach społecznego przekazu (art. 106ne ust. 3). Informacje techniczne publikowane są ponadto na stronie ksef.podatki.gov.pl. Od rodzaju komunikatu zależy sposób wystawiania faktur i termin ich przesłania do KSeF: po zakończeniu niedostępności — następny dzień roboczy (art. 106nh ust. 2), po zakończeniu awarii — 7 dni roboczych (art. 106nf ust. 4), chyba że w czasie awarii albo w tym terminie ogłoszono awarię całkowitą (art. 106nf ust. 7); faktur wystawionych w czasie awarii całkowitej, ogłoszonej w środkach społecznego przekazu (art. 106ng), według MF do KSeF się nie przesyła. Szczegóły zawiera artykuł Tryby wystawiania faktur.

Pobieranie faktur

Czy KSeF powiadamia o otrzymaniu nowej faktury?

Nie. Faktura staje się dostępna dla nabywcy w chwili przydzielenia jej numeru KSeF i w tym dniu uznaje się ją za otrzymaną (art. 106na ust. 3 ustawy o VAT), ale system nie wysyła o tym powiadomień. O nowych fakturach informuje program, który cyklicznie odpytuje KSeF, albo przegląd listy faktur zakupowych w Aplikacji Podatnika. Sprzedawca nie otrzymuje z KSeF informacji, czy i kiedy nabywca pobrał fakturę. Zasady odbioru opisuje artykuł Odbieranie faktur w KSeF.

Jak program pobiera faktury z KSeF i w jakim formacie?

Program pobiera pojedyncze faktury według numeru KSeF albo zleca eksport paczki: KSeF przygotowuje zaszyfrowane archiwum (domyślnie ZIP) z plikami XML, podzielone na części, które program pobiera, odszyfrowuje i rozpakowuje. Pobieranie odbywa się przyrostowo, według daty trwałego zapisu faktury w KSeF, co zapobiega pominięciu faktur przetworzonych z opóźnieniem. Liczba eksportów w ciągu godziny jest ograniczona, dlatego program synchronizuje dane w odstępach (według dokumentacji API KSeF 2.0, stan na 2 października 2026 r., cykliczne odpytywanie nie powinno następować częściej niż co 15 minut), a nie w chwili wystawienia faktury przez kontrahenta. Masowo faktury pobiera się wyłącznie jako pliki XML; postać PDF jest wizualizacją, którą tworzy program albo — dla wybranych faktur, do 10 w jednej operacji — Aplikacja Podatnika.

Przechowywanie faktur

Jak długo faktury są przechowywane w KSeF i czy trzeba je archiwizować samodzielnie?

Faktury ustrukturyzowane, a także faktury wystawione w trybie offline24 oraz w czasie niedostępności lub awarii KSeF — po ich przesłaniu do systemu — są przechowywane w KSeF przez 10 lat, licząc od końca roku, w którym zostały wystawione (art. 112aa ust. 1 ustawy o VAT). Przez ten czas nie stosuje się art. 112 i art. 112a, więc na gruncie ustawy o VAT podatnik nie ma obowiązku przechowywania tych faktur we własnym zakresie. Przykładowo faktura wystawiona w 2026 r. pozostaje w KSeF do 31 grudnia 2036 r. Jeżeli do tego dnia nie upłynie termin przedawnienia zobowiązania podatkowego — np. wskutek jego zawieszenia lub przerwania — fakturę należy wcześniej pobrać i przechowywać poza KSeF do upływu tego terminu, na zasadach art. 112 i art. 112a (art. 112aa ust. 2). W ustawie o rachunkowości art. 73a wyłącza stosowanie art. 71 ust. 1 oraz art. 73 ust. 1, 2 i 4 do dowodów księgowych przechowywanych w KSeF; jeżeli okres ich przechowywania w KSeF upłynie przed terminami z art. 74 ust. 2 pkt 3, 4, 6 lub 8 tej ustawy, dowody księgowe przechowuje się w jednostce do czasu upływu tych terminów.

Wyłączenie art. 112 i art. 112a dotyczy wyłącznie ustawy o VAT. Podatnicy obowiązani do prowadzenia ksiąg podatkowych, w tym podatkowej księgi przychodów i rozchodów oraz ewidencji przychodów, przechowują księgi i związane z ich prowadzeniem dokumenty do czasu upływu okresu przedawnienia zobowiązania podatkowego, chyba że ustawy podatkowe stanowią inaczej (art. 3 pkt 4 i art. 86 § 1 Ordynacji podatkowej). Według MF (FAQ „KSeF w Jednostkach Samorządu Terytorialnego”, pyt. 82) faktury dotyczącej środka trwałego, którego okres amortyzacji jest krótszy niż 10-letni okres przechowywania faktur w KSeF, nie trzeba przechowywać poza KSeF, a przy dłuższym okresie amortyzacji podatnik powinien przechowywać ją poza KSeF do czasu przedawnienia zobowiązań podatkowych.

Które dokumenty nadal przechowuje się poza KSeF?

Poza systemem pozostają faktury wystawione i otrzymane bez użycia KSeF, np. faktury otrzymane od kontrahentów zagranicznych, faktury wystawiane poza KSeF na podstawie art. 106ga ust. 2–3 (m.in. na rzecz osób fizycznych nieprowadzących działalności gospodarczej), faktury wystawione przed 1 lutego 2026 r., faktury elektroniczne i papierowe wystawiane do 31 grudnia 2026 r. w okresie przejściowym (art. 145l–145n) oraz — według MF — faktury wystawione w czasie awarii całkowitej (art. 106ng). Stosuje się do nich ogólne zasady przechowywania z art. 112 i art. 112a ustawy o VAT. Według Ministerstwa Finansów przepisy podatkowe nie zobowiązują do przechowywania UPO, które osoby uprawnione mogą pobrać w dowolnym czasie (np. w Aplikacji Podatnika KSeF); program zwykle zapisuje je wraz z numerem KSeF, co ułatwia wykazanie daty przesłania faktury. Kopia plików XML w programie przydaje się również wtedy, gdy KSeF jest chwilowo niedostępny.

Problemy z wysyłką

Co zrobić, gdy program nie wysyła faktur do KSeF?

Postępowanie zależy od przyczyny:

1. Ogłoszona niedostępność lub awaria KSeF — faktury wystawia się w trybie przewidzianym dla danej sytuacji i przesyła do systemu w terminie liczonym od zakończenia niedostępności albo awarii.
2. Problem po stronie podatnika (program, łącze internetowe, unieważniony token, wygasły certyfikat, brak uprawnień) — fakturę można wystawić w trybie offline24, w strukturze FA(3), i przesłać do KSeF najpóźniej w następnym dniu roboczym (art. 106nda ust. 1 i 2 ustawy o VAT). Nabywca inny niż wymieniony w art. 106gb ust. 4 (np. krajowy podatnik) otrzymuje taką fakturę w KSeF dopiero po jej przesłaniu i przydzieleniu numeru (art. 106nda ust. 3 i 11); nabywcy z art. 106gb ust. 4 (m.in. zagranicznemu i będącemu osobą fizyczną nieprowadzącą działalności) fakturę udostępnia się w sposób uzgodniony, a udostępnioną poza KSeF oznacza się kodami z art. 106nda ust. 6 (kody QR).
3. Rozwiązanie doraźne — plik XML zgodny ze strukturą FA(3), wyeksportowany z programu, można wczytać i przesłać w Aplikacji Podatnika KSeF albo wystawić fakturę bezpośrednio w tej aplikacji.

Przed ponowną wysyłką należy sprawdzić w historii sesji i na liście faktur, czy faktura nie została już przyjęta, a program jedynie nie odebrał potwierdzenia. Ponowne przesłanie tego samego pliku zostanie odrzucone jako duplikat, lecz wystawienie tej samej sprzedaży pod innym numerem oznaczałoby dwie faktury w obrocie. Kody QR i tryby szczególne omawia strona KSeF — pytania i odpowiedzi: tryby offline i kody QR.

Podstawa prawna

• art. 2 pkt 32a, art. 106a–106q, art. 106ga ust. 2–3, art. 106gb ust. 1, 4 i 8, art. 106gba ust. 2, 3 i 7, art. 106na ust. 3, art. 106nda, art. 106ne, art. 106nf ust. 4 i 7, art. 106ng, art. 106nh ust. 2, art. 108 ust. 1, art. 112, art. 112a, art. 112aa i art. 145l–145n ustawy z dnia 11 marca 2004 r. o podatku od towarów i usług (Dz. U. z 2026 r. poz. 1263, z późn. zm.),
• § 3, § 6 i § 13 rozporządzenia Ministra Finansów i Gospodarki z dnia 12 grudnia 2025 r. w sprawie korzystania z Krajowego Systemu e-Faktur (Dz. U. z 2025 r. poz. 1815 oraz z 2026 r. poz. 169),
• część II pkt 14 załącznika do rozporządzenia Ministra Finansów, Inwestycji i Rozwoju z dnia 15 października 2019 r. w sprawie szczegółowego zakresu danych zawartych w deklaracjach podatkowych i w ewidencji w zakresie podatku od towarów i usług (Dz. U. z 2019 r. poz. 1988, z późn. zm.), w brzmieniu nadanym rozporządzeniem Ministra Finansów z dnia 29 grudnia 2023 r. (Dz. U. z 2024 r. poz. 13 i 947 oraz z 2025 r. poz. 1800),
• art. 73a i art. 74 ust. 2 ustawy z dnia 29 września 1994 r. o rachunkowości (Dz. U. z 2026 r. poz. 522, z późn. zm.),
• art. 3 pkt 4 i art. 86 § 1 ustawy z dnia 29 sierpnia 1997 r. — Ordynacja podatkowa (Dz. U. z 2026 r. poz. 622, z późn. zm.).

Pozostałe pytania o KSeF omawiają strony: obowiązek i terminy, wystawianie i odbieranie faktur, uprawnienia i certyfikaty oraz tryby offline i kody QR; numer KSeF faktury można zweryfikować narzędziem Krajowy System e-Faktur.