Kody QR na fakturach - kiedy są obowiązkowe i jak działają?

1 lutego 2026 - data, od której kod QR staje się obowiązkowy

AITekst opracowany z wykorzystaniem sztucznej inteligencji. Zasady i ograniczenia

Wprowadzenie powszechnego obowiązku stosowania Krajowego Systemu e-Faktur wiąże się z rygorystycznymi wymogami dotyczącymi prezentacji danych. Od 1 lutego 2026 r. kody QR na fakturach stają się standardem dla dużych podmiotów gospodarczych, których obroty przekroczyły próg wartości sprzedaży 200 000 000 zł. Dla pozostałych czynnych podatników VAT termin ten został przesunięty na 1 kwietnia 2026 r., co daje dodatkowy czas na dostosowanie systemów ERP do generowania ustrukturyzowanych dokumentów. Przedsiębiorca wystawia fakturę na poziomie ustrukturyzowanym, co oznacza, że pierwotną formą dokumentu jest plik XML, a kod QR służy jedynie jako pomost do jego cyfrowego oryginału.

Warto obalić powszechny mit, jakoby kody QR na fakturach musiały znajdować się na każdym dokumencie krążącym w obrocie gospodarczym. Zgodnie z art. 106ga ust. 1 ustawy o podatku od towarów i usług, faktura ustrukturyzowana przesyłana bezpośrednio przez interfejs API KSeF do konta nabywcy nie wymaga nanoszenia kodu graficznego. Obowiązek ten powstaje wyłącznie w momencie, gdy podatnik decyduje się na przekazanie wizualizacji faktury nabywcy w sposób inny niż poprzez KSeF - na przykład za pośrednictwem poczty elektronicznej w formacie PDF lub w formie papierowej. Systemy generujące dokumenty w trybach offline, offline24 oraz w sytuacjach awaryjnych muszą każdorazowo implementować ten symbol w celu umożliwienia weryfikacji dokumentu.

• Faktura wysłana przez API KSeF - kod QR niepotrzebny
• Faktura wysłana mailem/PDF - kod QR obowiązkowy
• Faktura konsumencka poza KSeF - kod QR nie wymagany

Istnieją precyzyjne wyłączenia z obowiązku stosowania kodów weryfikujących. Kody te nie są wymagane w przypadku faktur wykorzystywanych wyłącznie do celów wewnętrznych podatnika oraz przy fakturach konsumenckich (B2C), które pozostają poza obligatoryjnym obiegiem ustrukturyzowanym. Należy jednak pamiętać, że w dniach 26-31 stycznia 2026 r. Rząd zaplanował przerwę technologiczną w działaniu systemu, co czyni przygotowanie do procedur offline jeszcze istotniejszym. 31 stycznia 2026 r. to ostateczny termin na przeprowadzenie testów integracyjnych oprogramowania z modułem walidacji kodów graficznych.

Dwa kody QR zamiast jednego - tryb offline KSeF

Faktura offline nie jest od razu potwierdzona przez KSeF, dlatego potrzebuje własnego paszportu w postaci rozszerzonej weryfikacji graficznej. W specyficznych okolicznościach, takich jak brak dostępu do internetu u podatnika (tryb offline) lub ogólnokrajowa awaria systemu (tryb awaryjny), dokument musi zawierać dwa odrębne kody weryfikujące. Taki mechanizm gwarantuje, że nabywca otrzymuje dokument o potwierdzonym pochodzeniu, mimo że informacja o transakcji nie trafiła jeszcze do centralnego rejestru. Podatnik ma obowiązek przesłania faktur wystawionych w tym trybie do systemu KSeF najpóźniej następnego dnia roboczego po ich wystawieniu.

Podwójne oznaczenie składa się z KODU I, będącego bezpośrednim odnośnikiem URL do bazy danych Ministerstwa Finansów, oraz KODU II, który bazuje na zaawansowanym certyfikacie. Kwalifikowana Pieczęć Elektroniczna (QSeal) jest tu elementem niezbędnym do wygenerowania podpisu pod strukturą XML w trybie offline24. Certyfikat typu 2, wymagany od 1 lutego 2026 r., pozwala na zakodowanie w symbolu QR skrótu dokumentu, co uniemożliwia jego sfałszowanie przed synchronizacją z serwerami rządowymi. Poniższa tabela przedstawia parametry techniczne obu kodów stosowanych w procedurach awaryjnych.

Proces pozyskiwania niezbędnych uprawnień cyfrowych warto zainicjować z odpowiednim wyprzedzeniem. Zaleca się założenie QSeal już w listopadzie 2025 r., ponieważ przewidywane kolejki w centrach certyfikacji (MCU) mogą znacząco wydłużyć czas oczekiwania na wydanie kluczy kwalifikowanych. Brak odpowiedniego certyfikatu uniemożliwi poprawne wystawienie faktury w trybie offline, co w świetle art. 106gb ustawy o VAT może skutkować sankcjami za niewłaściwe dokumentowanie zdarzeń gospodarczych. Pamiętajmy, że faktury ustrukturyzowane to fundament KSeF, ale ich przesłanie do odbiorcy nie zawsze jest możliwe w czasie rzeczywistym, co wymusza stosowanie powyższych zabezpieczeń.

Jak wygenerować kod QR zgodnie z XSD FA(3)

Proces generowania kodu QR wymaga ścisłego przestrzegania specyfikacji technicznej zawartej w schemacie FA(3). Logika implementacji opiera się na sekwencji pole-xml→base64→QR, co zapewnia standaryzację odczytu przez dowolne urządzenie mobilne organów kontrolnych. Zgodnie z wytycznymi zawartymi w Podręczniku KSeF 2.0 (rozdział 5.2), bez transformacji danych do formatu base64 nie ma możliwości poprawnego wygenerowania symbolu. Plik XML w nowym standardzie zawiera ponad 400 pól, jednak tylko nieliczne z nich stanowią wsad do algorytmu tworzącego kod graficzny.

1. Pobierz UID z pola <KSeFReferenceNumber> nadanego przez system podczas walidacji pliku.
2. Zakoduj sumę kontrolną SHA-256 oraz dane nagłówkowe w formacie base64, aby zachować integralność ciągu znaków.
3. Umieść wygenerowany ciąg w technicznym elemencie <VisualisationCode> wewnątrz oprogramowania finansowo-księgowego.
4. Wygeneruj ostateczny symbol QR o wymiarach minimum 400×400 px, stosując poziom korekcji błędów ECC level M.

Zastosowanie poziomu korekcji ECC M (Medium) jest kluczowe dla praktycznego wykorzystania dokumentu, gdyż pozwala na poprawne odczytanie danych nawet przy 15 % uszkodzeń powierzchni kodu, co jest częste w przypadku faktur drukowanych. Maksymalny rozmiar danych zaszytych w kodzie nie powinien przekraczać 3 kB, aby zapewnić szybkość skanowania. Deweloperzy systemów IT powinni przeprowadzać testy na środowisku sandbox-api.mf.gov.pl, gdzie każdy wygenerowany kod QR jest walidowany automatycznie pod kątem zgodności z sumą kontrolną XML. Prawidłowo przygotowane oprogramowanie generujące XML FA(3) musi dynamicznie nanosić ten symbol na wizualizację PDF w sposób niezakłócający czytelności pozostałych danych transakcyjnych.