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 NIP-u sprzedawcy, daty wystawienia i skrótu SHA-256 pliku XML faktury.

Ile kodów QR ma faktura?

Faktura online ma jeden kod, czyli 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

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

W trybie online faktura dostaje numer KSeF od razu i ma jeden kod QR, czyli 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”. Tryb offline24 wynika z art. 106nda ustawy o VAT i pozwala przesłać fakturę do KSeF najpóźniej w następnym dniu roboczym.

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.

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 służy do weryfikacji 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 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.

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”), dzięki którym nabywca zweryfikuje go jeszcze przed nadaniem numeru.

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

To oznacza dwie rzeczy:

Twoje narzędzie musi umieć policzyć kod QR (a w trybie offline także KOD II), bo z API go nie dostanie.
Kod jest związany z konkretnym dokumentem, więc nie da się go „pożyczyć” z innej faktury.

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, liczysz go 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 i droga do weryfikacji.

Nie licz kodów ręcznie

KSeF Kit liczy KOD I za Ciebie i trzyma link weryfikacyjny przy złożonej fakturze eksportowej, więc nie musisz znać wzoru. Samej wizualizacji nie tworzymy: obraz kodu umieszczasz na wydruku po swojej stronie. Zobacz czym jest UPO i jak wystawić fakturę.