Czy KSeF zwraca gotowy kod QR?

Nie. KSeF nadaje numer i UPO, ale kod QR (KOD I, a w trybie offline także KOD II) generujesz lokalnie — narzędzie wystawiające liczy go według standardu ISO/IEC 18004:2024 na podstawie danych faktury i numeru KSeF. API KSeF go nie zwraca.

Ile kodów QR ma faktura?

Faktura online ma jeden kod — KOD I, a pod nim numer KSeF. Faktura wystawiona offline lub w trybie offline24 ma dwa kody: KOD I z napisem OFFLINE oraz KOD II z napisem CERTYFIKAT, który potwierdza tożsamość wystawcy i wymaga certyfikatu KSeF typu 2.

Dla kogo kody QR są najważniejsze?

Dla faktur przekazywanych poza systemem KSeF: nabywcom zagranicznym, konsumentom oraz odbiorcom bez NIP. To dla nich kod QR jest drogą do weryfikacji dokumentu.

Kody QR na fakturze KSeF — KOD I, KOD II i tryb offline

Faktura online ma jeden kod QR — KOD I z numerem KSeF. Faktura offline lub offline24 ma dwa: KOD I „OFFLINE" oraz KOD II „CERTYFIKAT", który potwierdza tożsamość wystawcy i wymaga certyfikatu KSeF typu 2. Kody liczy lokalnie narzędzie wystawiające według standardu ISO/IEC 18004:2024 — API KSeF ich nie zwraca.

Częste pytanie po pierwszym złożeniu faktury: „gdzie jest kod QR?". Odpowiedź zaskakuje — KSeF nie zwraca gotowego kodu QR. Generuje go lokalnie narzędzie wystawiające, według standardu ISO/IEC 18004:2024, na podstawie danych faktury i numeru KSeF. API KSeF go nie zwraca.

Faktura online: jeden kod (KOD I)

Gdy wystawiasz fakturę bezpośrednio w KSeF (tryb online), na wizualizacji (PDF przekazywanym nabywcy) umieszczasz jeden kod QR — KOD I, a pod nim numer KSeF. Po zeskanowaniu KOD I odsyła do faktury w systemie i umożliwia weryfikację autentyczności oraz danych dokumentu.

Czym różni się tryb online od trybu offline?

W trybie online faktura dostaje numer KSeF od razu i ma jeden kod — KOD I. W trybie offline (i offline24) dokument trafia do nabywcy przed nadaniem numeru, więc ma dwa kody — KOD I „OFFLINE" oraz KOD II „CERTYFIKAT", który poświadcza tożsamość wystawcy i wymaga certyfikatu KSeF typu 2.

Gdy faktura powstaje poza systemem (tryb offline lub offline24), na wizualizacji umieszczasz dwa kody QR:

KOD I z napisem „OFFLINE" — służy do weryfikacji dostępu i danych faktury.
KOD II z napisem „CERTYFIKAT" — potwierdza tożsamość wystawcy. Jego wygenerowanie wymaga certyfikatu KSeF typu 2.

To podstawowa różnica względem faktury online: tryb offline dokłada drugi kod, bo dokument trafia do nabywcy zanim system nada mu numer KSeF, więc tożsamość wystawcy trzeba poświadczyć certyfikatem.

Tryb offline24

Tryb offline24 wynika z art. 106nda ustawy o VAT i obowiązuje od 1 lutego 2026. Pozwala wystawić fakturę poza KSeF i przesłać ją do systemu najpóźniej w następnym dniu roboczym, by faktura otrzymała numer KSeF. Do czasu przesłania dokument krąży z dwoma kodami QR (KOD I „OFFLINE" + KOD II „CERTYFIKAT"), które pozwalają nabywcy zweryfikować go jeszcze przed nadaniem numeru.

Skąd się biorą kody — liczysz je sam

To kluczowy szczegół wdrożenia: KSeF nadaje numer KSeF i UPO, ale kody QR generujesz samodzielnie na podstawie danych faktury i numeru KSeF. Oznacza to, że:

Twoje narzędzie musi umieć policzyć kod QR (a w trybie offline także KOD II), a nie tylko odebrać go z API.
Kod jest spójny z konkretnym dokumentem — nie da się go „pożyczyć" z innej faktury.

W KSeF Kit kody QR są liczone automatycznie i nanoszone na wizualizację faktury — nie musisz znać wzoru ani liczyć ich ręcznie.

Kiedy kody QR są szczególnie ważne

Kody QR mają największe znaczenie przy fakturach przekazywanych poza systemem, których odbiorca nie ma dostępu do KSeF:

Nabywcy zagraniczni — QR jest ich drogą do weryfikacji. Zobacz fakturę eksportową.
Konsumenci oraz nabywcy bez NIP — dostają PDF, a nie wgląd do systemu.

Najczęstsze nieporozumienia

„QR przyjdzie z API KSeF" — nie; to Ty go liczysz lokalnie.
„Faktura zawsze ma jeden kod" — nie; offline i offline24 mają dwa (KOD I + KOD II).
„QR zastępuje numer KSeF" — nie; to uzupełnienie, droga do weryfikacji.

Nie licz kodów ręcznie

Generowanie KOD I i KOD II bywa źródłem błędów wdrożeniowych. KSeF Kit liczy kody QR za Ciebie i umieszcza je na wizualizacji każdej złożonej faktury. Zobacz czym jest UPO i jak wystawić fakturę.