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)
  • Stan prawny na
  • Aktualizacja:

KOD I i KOD II

KOD IKOD II
Do czegodostęp do faktury w KSeF i weryfikacja jej danychpotwierdzenie autentyczności wystawcy i integralności faktury
Gdziena każdej wizualizacji fakturytylko na fakturach offline przekazanych przed wysłaniem do KSeF
Podpis pod kodemnumer KSeF albo „OFFLINE”„CERTYFIKAT”
Co zawieraadres API, datę wystawienia (P_1), NIP sprzedawcy i wyróżnik fakturydane 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

  1. Kody weryfikujące QRMinisterstwo Finansów, ksef.podatki.gov.pl
  2. 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.