Kody QR na fakturach KSeF
Kody QR na fakturach KSeF to kody weryfikujące umieszczane na wizualizacji faktury, np. wydruku albo PDF-ie. KOD I pozwala sprawdzić fakturę w KSeF i ma pod sobą numer KSeF albo napis OFFLINE. KOD II, z napisem CERTYFIKAT, potwierdza tożsamość wystawcy i występuje tylko na fakturach offline przekazanych przed wysłaniem do KSeF.
- Inaczej
- KOD I, KOD II, kod weryfikujący QR, kod QR KSeF, QR OFFLINE, QR CERTYFIKAT
- Podstawa prawna
- art. 106gb ust. 4 ustawy o VAT; rozporządzenie w sprawie korzystania z KSeF (Dz.U. 2025 poz. 1815)
KOD I i KOD II
| KOD I | KOD II | |
|---|---|---|
| Do czego | dostęp do faktury w KSeF i weryfikacja jej danych | potwierdzenie autentyczności wystawcy i integralności faktury |
| Gdzie | na każdej wizualizacji faktury | tylko na fakturach offline przekazanych przed wysłaniem do KSeF |
| Podpis pod kodem | numer KSeF albo „OFFLINE” | „CERTYFIKAT” |
| Co zawiera | adres API, datę wystawienia (P_1), NIP sprzedawcy i wyróżnik faktury | dane pozwalające sprawdzić certyfikat KSeF wystawcy |
| Co jest potrzebne | - | certyfikat KSeF typu 2 |
Ile kodów ma faktura
- Faktura online - jeden KOD I z numerem KSeF.
- Faktura offline przed wysłaniem do KSeF - dwa kody: „OFFLINE” i „CERTYFIKAT”.
- Faktura offline po nadaniu numeru KSeF - jeden KOD I z numerem KSeF.
- Faktura z awarii całkowitej - bez kodów QR.
Gdy na dokumencie nie da się umieścić grafiki, wystawca przekazuje link albo tekst z odpowiednimi danymi.
Przykład
Klient stacji paliw prosi o fakturę na firmę, ale na stacji akurat nie działa internet. Kasa wystawia fakturę w trybie offline24 i drukuje ją z dwoma kodami. Klient skanuje pierwszy i widzi, że faktura nie trafiła jeszcze do KSeF; drugi potwierdza, że wystawił ją właściciel stacji. Gdy faktura dotrze do KSeF, ten sam kod I pokaże ją już z numerem KSeF.
Powiązane pojęcia
Numer KSeF
Numer KSeF to unikalny, 35-znakowy identyfikator, który Krajowy System e-Faktur automatycznie nadaje każdej przyjętej fakturze. Składa się z NIP-u sprzedawcy, daty przyjęcia faktury przez KSeF, 12-znakowej części technicznej i sumy kontrolnej. To inny numer niż numer faktury nadany przez sprzedawcę.
Tryb offline w KSeF
Tryb offline to wystawienie faktury elektronicznej w strukturze FA(3) poza KSeF i wysłanie jej do systemu później. Ma dwa warianty: offline24, z którego każdy podatnik może skorzystać z dowolnego powodu (termin: następny dzień roboczy po wystawieniu), oraz tryb niedostępności KSeF ogłoszonej przez Ministerstwo Finansów (termin: następny dzień roboczy po jej zakończeniu).
Certyfikat KSeF
Certyfikat KSeF to certyfikat cyfrowy wydawany przez KSeF, który służy do uwierzytelniania się w systemie (typ 1) albo do oznaczania faktur wystawionych w trybie offline kodem QR potwierdzającym tożsamość wystawcy (typ 2). Jest ważny najwyżej 2 lata. W odróżnieniu od tokenu sam nie niesie żadnych uprawnień.
Potwierdzenie transakcji
Potwierdzenie transakcji to dobrowolny dokument, który sprzedawca może wydać nabywcy, zanim faktura dostanie numer KSeF, np. przy kasie w sklepie albo na stacji paliw. Zawiera podstawowe dane stron, numer faktury, kwotę należności i dwa kody QR do sprawdzenia faktury i jej wystawcy. Nie jest fakturą.
Faktura ustrukturyzowana
Faktura ustrukturyzowana to faktura wystawiona przy użyciu Krajowego Systemu e-Faktur, której system przydzielił numer KSeF. Ma postać pliku XML zgodnego ze strukturą logiczną FA(3), a nie dokumentu PDF ani papierowego. PDF czy wydruk takiej faktury to tylko jej wizualizacja.
Najczęstsze pytania
Kiedy faktura musi mieć kod QR?
Gdy jest przekazywana albo używana poza KSeF, np. jako wydruk dla konsumenta, kontrahenta zagranicznego czy kierowcy z towarem. Program, który pokazuje wizualizację faktury z KSeF, powinien umieszczać na niej kod QR.
Co widać po zeskanowaniu kodu QR?
Podstawowe dane identyfikujące fakturę i informację, czy jest w KSeF. Pobranie całej faktury wymaga dodatkowych danych dostępowych.
Skąd wziąć drugi kod QR (CERTYFIKAT)?
Generuje go program do fakturowania przy użyciu certyfikatu KSeF typu 2. Bez tego certyfikatu nie da się prawidłowo oznaczyć faktury offline przekazanej nabywcy przed wysłaniem do KSeF.
Źródła
- Kody weryfikujące QRMinisterstwo Finansów, ksef.podatki.gov.pl
- Kody QR (dokumentacja KSeF API 2.0)Ministerstwo Finansów, repozytorium CIRFMF/ksef-docs
Treść sprawdzona ze źródłami: . Przepisy o KSeF często się zmieniają, więc przed decyzją podatkową sprawdź aktualny stan w źródłach.
Widzisz błąd albo nieaktualną informację? Daj nam znać, a poprawimy.
