Przeczytaj to, zanim oprzesz się na wyniku z SprawdźKSeF. Najważniejsze zasady są w czterech zdaniach, a dalej tłumaczymy je krok po kroku.
- Podgląd faktury i PDF z naszej aplikacji pokazują zawartość pliku XML i nie są odrębną fakturą.
- Kod QR na PDF-ie jest liczony z wczytanego pliku XML. Jeśli nie podasz numeru KSeF, PDF jest oznaczony jako podgląd roboczy.
- Zgodność kodu QR z plikiem nie potwierdza, że faktura jest w KSeF.
- Wynik sprawdzenia nie gwarantuje przyjęcia faktury przez KSeF. SprawdźKSeF to darmowe narzędzie informacyjne, a nie produkt Ministerstwa Finansów ani porada prawna, podatkowa czy księgowa.
1. Podgląd i PDF nie są odrębną fakturą
Faktura ustrukturyzowana to plik XML wystawiony w KSeF z przydzielonym numerem KSeF.1 Wyświetlony przez nas widok i PDF to wizualizacja tego pliku. Zgodnie z wytycznymi Ministerstwa Finansów wizualizacja ma być spójna z plikiem XML, czytelna i niesprzeczna z plikiem przyjętym przez system.2 Dlatego na PDF-ie zapisujemy: „Wizualizacja pliku XML FA(3) · wygenerowano {data} w SprawdźKSeF · nie jest odrębną fakturą”. W stopce podajemy też odcisk pliku (skrót SHA-256, czyli cyfrowy odcisk treści pliku, który zmienia się przy każdej zmianie pliku), żeby można go było porównać z plikiem źródłowym.
2. Kod QR na PDF-ie i napis pod nim
Przepisy wymagają oznaczenia kodem faktury użytej poza KSeF albo udostępnianej nabywcy poza systemem. Obowiązek ten ma podatnik, a w przypadku użycia faktury ustrukturyzowanej poza KSeF także podmiot inny niż podatnik.3 Nie rozstrzygamy, czy samo oglądanie wizualizacji jest „użyciem poza KSeF”. Dlatego w PDF-ie zawsze umieszczamy kod QR, jeśli da się go wiarygodnie policzyć.
Kod powstaje z wczytanego pliku XML według opisu Ministerstwa: zawiera adres strony MF, datę wystawienia, NIP sprzedawcy i skrót pliku.4 Pod kodem umieszczamy:
- numer KSeF, jeśli go znamy (wpisałeś go, odczytaliśmy z nazwy pliku albo z metadanych paczki);
- napis „OFFLINE”, ale tylko wtedy, gdy sam zaznaczysz, że faktura jeszcze nie została wysłana do KSeF;5
- nic, jeśli nie znamy numeru. PDF dostaje wtedy znak „PODGLĄD ROBOCZY: uzupełnij numer KSeF przed użyciem poza KSeF”.
Ten PDF nie wystawia faktury. Fakturę wystawia się, wysyłając plik XML do KSeF. Kodu „OFFLINE” użyj tylko wtedy, gdy faktura rzeczywiście jest wystawiana w trybie offline i zostanie wysłana do KSeF w terminie. Kod typu II (z napisem „CERTYFIKAT”), wymagany przy fakturach offline dla odbiorców z art. 106gb ust. 4, wygeneruje Twój program do fakturowania; w tej wersji my go nie tworzymy.5
Jeśli wkleisz tekst faktury zamiast pliku, albo plik nie jest zgodny z formatem, nie umiemy policzyć kodu wiarygodnie. PDF nie dostaje wtedy kodu, tylko znak „PODGLĄD ROBOCZY: brak oryginalnego pliku”. Skrót z wklejonego tekstu nie jest bowiem skrótem pliku.
3. Zgodność kodu QR z plikiem to nie potwierdzenie w KSeF
Możemy porównać plik XML z kodem QR z PDF-a: NIP, datę i odcisk pliku. Zgodność oznacza tylko, że kod pochodzi z tego pliku. Nie oznacza, że faktura jest w KSeF. Według dokumentacji MF kod typu I zawiera adres, datę, NIP i skrót pliku, a podpis cyfrowy występuje dopiero w kodzie typu II (faktury offline).4 Link w poprawnym formacie można więc zbudować do dowolnego pliku.
Jedynymi sposobami stwierdzenia, czy faktura jest w systemie, są strona Ministerstwa Finansów otwierana z kodu QR i wyszukiwanie w Aplikacji Podatnika.6 Dlatego pierwszą akcją po wczytaniu faktury jest u nas „Sprawdź w KSeF”.
4. Wynik sprawdzenia nie gwarantuje przyjęcia faktury
Sprawdzamy budowę pliku i część zależności (np. sumy). KSeF stosuje własne kontrole: weryfikuje zgodność pliku ze strukturą FA(3) i uprawnienia wysyłającego.7 My nie znamy wszystkich reguł systemu i nie sprawdzamy uprawnień. Plik uznany u nas za zgodny ze schematem może zostać odrzucony przez KSeF, a ostrzeżenie o sumach nie oznacza jeszcze błędu. Sam KSeF nie weryfikuje obliczeń, więc błąd rachunkowy w pliku może przejść niezauważony.7
5. Dopasowanie PDF do XML i duplikaty to pomoc, nie rozstrzygnięcie
Z PDF-a odczytujemy tekst i kody QR. Skan bez tekstu i bez kodu jest „nie do odczytu”. Pole odczytane z PDF-a może być błędne, zwłaszcza przy nietypowym układzie. Gdy kilka faktur ma te same dane, piszemy „możliwy duplikat”, a nie „błąd”. Rozbieżność lub duplikat to powód, żeby sprawdzić dokumenty, a nie dowód nieprawidłowości. Nie rozstrzygamy, która wersja jest właściwa do rozliczeń.
6. Treść faktur pochodzi od ich wystawców
Wyświetlamy wszystko, co jest w pliku, w tym nazwy, opisy i adresy wpisane przez sprzedawcę. Traktujemy to jako zwykły tekst, a linki z faktury nie są aktywne. Mimo to zachowaj ostrożność wobec plików z nieznanych źródeł i numerów rachunków, które różnią się od danych płatności. Jeśli w treści faktury znajdziemy inny numer konta niż w danych płatności, ostrzeżemy Cię.
7. Formaty i wersje
Obsługujemy faktury w strukturze FA(3), obowiązującej od 1 lutego 2026 r.1 Starszy format FA(2) pokazujemy w uproszczonej postaci z opisem. Inne dokumenty (np. UPO, faktury RR) rozpoznajemy, ale ich podglądu jeszcze nie ma. Wyjaśnienia przepisów na naszych stronach są datowane i mogą się zdezaktualizować.
8. Darmowe narzędzie, nie porada
SprawdźKSeF to darmowe narzędzie informacyjne, udostępniane „tak jak jest”, bez gwarancji. Nie jest poradą prawną, podatkową ani księgową, a jego treści (także strony wiedzy, komunikaty w aplikacji i polityka prywatności) nie były konsultowane z prawnikiem ani doradcą podatkowym. W sprawach wiążących zapytaj doradcę podatkowego lub księgowego albo sprawdź oficjalne źródła Ministerstwa Finansów i KSeF (np. infolinię Krajowej Administracji Skarbowej).
9. Niezależne narzędzie
SprawdźKSeF to niezależne narzędzie. Nie jest produktem Ministerstwa Finansów i nie jest związane z Ministerstwem ani z właścicielami znaków towarowych zawierających oznaczenie „KSeF”. „KSeF” to skrót nazwy Krajowego Systemu e-Faktur, prowadzonego przez Ministerstwo Finansów.8 Używamy go informacyjnie, żeby wskazać, z jakim systemem pracują nasze narzędzia.
10. Odpowiedzialność
W zakresie dopuszczalnym przez prawo nie odpowiadamy za skutki decyzji podjętych na podstawie wyników narzędzia.
Licencja
Treść tej strony: licencja CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/deed.pl), autor: SprawdźKSeF (sprawdzksef.pl).
Źródła
-
MF, Podręcznik KSeF 2.0, cz. II (wersja z 6.08.2026), rozdz. 1.1: faktura ustrukturyzowana „jest wystawiona przy użyciu KSeF wraz z przydzielonym numerem”, „od 1 lutego 2026 r. jest wystawiana przy użyciu struktury logicznej FA(3)”. https://ksef.podatki.gov.pl/media/rronoxyt/podrecznik-ksef-20-cz-ii-wystawianie-i-otrzymywanie-faktur-w-ksef-06082026.pdf (dostęp 2026-10-28). wróć, 2
-
MF, Podręcznik KSeF 2.0, cz. II, rozdz. 1.6.5 („Zawartość faktury przekazywanej odbiorcom poza KSeF”): spójność z XML, czytelność, brak sprzeczności z plikiem przyjętym przez system. Adres jak wyżej (dostęp 2026-10-28). wróć
-
Ustawa z 11.03.2004 r. o podatku od towarów i usług, art. 106gb ust. 5 (w brzmieniu z ustawy z 16.06.2023 r., Dz.U. 2023 poz. 1598, https://api.sejm.gov.pl/eli/acts/DU/2023/1598/text.pdf) i ust. 5a (dodany przez art. 2 pkt 1 lit. d ustawy z 5.08.2025 r., Dz.U. 2025 poz. 1203, który zmienia art. 1 pkt 12 ustawy z 16.06.2023 r.; https://api.sejm.gov.pl/eli/acts/DU/2025/1203/text.pdf), dostęp 2026-10-28. Przeczytano teksty ustaw zmieniających; tekstu jednolitego nie sprawdzano. Ust. 5a: „Do oznaczania faktury ustrukturyzowanej kodem […] jest obowiązany również podmiot inny niż podatnik, w przypadku użycia tej faktury poza Krajowym Systemem e-Faktur”. wróć
-
MF, repozytorium dokumentacji API KSeF (CIRFMF/ksef-docs), „Kody weryfikujące QR” (21.08.2025): KOD I (adres, data wystawienia, NIP sprzedawcy, skrót SHA-256 pliku), KOD II (tylko faktury offline, z podpisem certyfikatem). https://github.com/CIRFMF/ksef-docs/blob/main/kody-qr.md (dostęp 2026-10-28). wróć, 2
-
MF, Podręcznik KSeF 2.0, cz. II, rozdz. 5.4.1: pod kodem numer KSeF, a dla faktury offline jeszcze nieprzesłanej do KSeF napis „OFFLINE”. Adres jak wyżej (dostęp 2026-10-28). wróć, 2
-
MF, Podręcznik KSeF 2.0, cz. II, rozdz. 5.5 (strona MF po zeskanowaniu kodu pokazuje, czy faktura jest w KSeF) oraz Aplikacja Podatnika KSeF 2.0, podręcznik użytkownika v. 2.3 (kwiecień 2026), rozdz. 4.2.1 (anonimowe wyszukiwanie faktury), https://ksef.podatki.gov.pl/media/i1ubiukl/aplikacja-podatnika-ksef-20-podrecznik-uzytkownika_25042026.pdf (dostęp 2026-10-28). wróć
-
MF, Podręcznik KSeF 2.0, cz. II, rozdz. 1.6.1–1.6.2: KSeF weryfikuje zgodność pliku XML z wzorem struktury i uprawnienia wysyłającego; „KSeF nie dokonuje weryfikacji obliczeń matematycznych”. Adres jak wyżej (dostęp 2026-10-28). wróć, 2
-
MF, portal „KSeF (Krajowy System e-Faktur)”. https://ksef.podatki.gov.pl/ (dostęp 2026-10-28). wróć