Kod QR KSeF: odczytaj albo zbuduj link weryfikacyjny
Wklej link odczytany z kodu QR albo wczytaj plik XML faktury. Narzędzie rozkłada link na części albo liczy skrót SHA-256 i rysuje KOD I, bez wysyłania pliku.
Link weryfikacyjny
Poprawny
Otwórz go, aby zobaczyć fakturę w KSeF; strona MF pokaże, czy plik się zgadza.
| Środowisko | test |
| NIP sprzedawcy | 1111111111 |
| Data wystawienia | 20 października 2026 |
| Skrót SHA-256 | bUK2MV3bs7nm… |
KOD II (CERTYFIKAT) dla faktur offline podpisuje się kluczem certyfikatu offline z KSeF: robi to program do faktur, nie ta strona.
Przygotowuje Radif Partners · Metoda · ustawa o VAT, rozporządzenia i komunikaty MF sprawdzone 25 października 2026
Kod QR na fakturze z KSeF to zapisany graficznie link, który pozwala każdemu sprawdzić fakturę w systemie bez logowania. Obowiązek wynika z art. 106gb ust. 5 ustawy o VAT: kod umieszczasz, gdy przekazujesz fakturę nabywcy poza KSeF, na przykład konsumentowi albo firmie zagranicznej, oraz gdy używasz faktury poza systemem, choćby drukując ją do dokumentów magazynowych. Pierwszy kod, nazywany KOD I, zawiera adres serwera weryfikacji, NIP sprzedawcy, datę wystawienia w formacie dzień, miesiąc, rok oraz skrót SHA-256 pliku XML zakodowany w Base64URL. Pod kodem drukuje się numer KSeF, a przy fakturze offline napis OFFLINE. Faktura offline przekazana poza systemem ma też drugi kod, KOD II z napisem CERTYFIKAT, podpisany certyfikatem offline, który potwierdza, kto ją wystawił. Narzędzie poniżej odczytuje link z kodu albo buduje go z pliku, dokładnie według dokumentacji API KSeF 2.0.
Budowa linku KOD I
Link z kodu I ma stały układ, opisany w dokumentacji API KSeF 2.0 i na stronie ministerstwa o kodach weryfikujących:
https://qr.ksef.mf.gov.pl/invoice/{NIP}/{DD-MM-RRRR}/{skrót}
| Część | Co zawiera | Przykład |
|---|---|---|
| adres | serwer weryfikacji: produkcja, test lub demo | qr.ksef.mf.gov.pl |
| NIP | NIP sprzedawcy, 10 cyfr | 1111111111 |
| data | data wystawienia z pola P_1 | 20-10-2026 |
| skrót | SHA-256 pliku XML, Base64URL, 43 znaki | bUK2MV3b… |
Przykład w narzędziu to prawdziwa faktura ze środowiska testowego, dlatego możesz go otworzyć i zobaczyć odpowiedź serwera.
Ile kodów i z jakim napisem
Liczba kodów zależy od dwóch rzeczy: trybu wystawienia i drogi do nabywcy. Wynika to z art. 106gb ust. 5 i art. 106nda ust. 6 ustawy o VAT. Sprawdź swój przypadek:
Kody QR na fakturze
Kody QR na fakturze
1
| Podpis pod kodem I | numer KSeF |
| Norma kodu | ISO/IEC 18004:2024 |
KOD II zawiera dane certyfikatu i podpis, dlatego tworzy go program do faktur z certyfikatem offline, opisanym na stronie o certyfikatach KSeF. To narzędzie buduje tylko KOD I, bo do kodu II potrzebny jest Twój klucz prywatny, którego nie wolno wpisywać na żadnej stronie.
Jak sprawdzić fakturę z kodu
Zeskanuj kod telefonem i otwórz link. Strona weryfikacji ministerstwa pokaże, czy faktura o tym skrócie istnieje w KSeF. Jeśli masz plik XML, możesz też policzyć skrót tutaj i porównać go z tym z kodu: wynik musi być identyczny co do znaku. Fakturę samą w sobie otworzysz w czytniku FA(3), a numer spod kodu sprawdzisz w walidatorze numeru. Zasady faktur wystawianych bez połączenia opisuje strona o trybie offline.
Kod QR na wydruku i w PDF
Kod umieszcza się na wizualizacji faktury, czyli na wydruku albo w pliku PDF, w miejscu, gdzie da się go wygodnie zeskanować telefonem. Pod kodem drukuje się numer KSeF albo napis OFFLINE, żeby osoba bez czytnika mogła odczytać numer. Kod musi być na tyle duży, by aparat go rozpoznał; zbyt mały lub rozmyty kod na wydruku z drukarki termicznej to częsty problem w magazynach.