Przejdź do treści

Techniczne Aspekty KSeF i Struktura FA(3)6 min czytania

Kod QR na fakturze KSeF - kiedy jest obowiązkowy i co zawiera?

Kod QR na fakturze KSeF to kwadratowy symbol zawierający unikalny ciąg znaków, który weryfikuje autentyczność dokumentu i łączy jego wizualizację z zapisem w Krajowym Systemie e-Faktur. Obowiązek oznaczania dokumentów tym symbolem wchodzi w życie 1 lutego 2026 r. i dotyczy faktur ustrukturyzowanych przekazywanych nabywcy poza systemem teleinformatycznym KSeF. Procedura ta ma na celu zapewnienie integralności treści oraz umożliwienie szybkiej weryfikacji dokumentu w rządowej bazie danych. Od kiedy kod QR jest obowiązkowy na fakturze KSeF? Wprowadzenie powszechnego obowiązku stosowania kodów QR jest ściśle skorelowane z harmonogramem wdrażania Krajowego Systemu e-Faktur.

Od kiedy kod QR jest obowiązkowy na fakturze KSeF?

Tekst opracowany z wykorzystaniem sztucznej inteligencji. Zasady i ograniczenia

Wprowadzenie powszechnego obowiązku stosowania kodów QR jest ściśle skorelowane z harmonogramem wdrażania Krajowego Systemu e-Faktur. Od 1 lutego 2026 r. duże podmioty gospodarcze, których wartość sprzedaży przekroczyła 200 000 000 zł w roku poprzednim, zostaną zobligowane do generowania kodów weryfikujących na każdej fakturze ustrukturyzowanej udostępnianej poza systemem. Pozostali podatnicy VAT czynni muszą dostosować swoje systemy informatyczne do 1 kwietnia 2026 r., natomiast jednostki wykluczone cyfrowo oraz mikroprzedsiębiorcy korzystający ze zwolnienia podmiotowego mają czas na wdrożenie odpowiednich rozwiązań do 1 stycznia 2027 r. Faktura ustrukturyzowana wystawiona w formacie XML FA(3) staje się pełnoprawnym dokumentem obrotu prawnego dopiero po nadaniu jej numeru identyfikacyjnego w KSeF lub opatrzeniu odpowiednim kodem w trybie offline.

Podmiot zobowiązany do wystawiania dokumentów w KSeF musi uwzględnić, że kod QR jest niezbędny w każdej sytuacji, gdy nabywca otrzymuje fakturę w formie wizualizacji (np. plik PDF lub wydruk papierowy). Ministerstwo Finansów w oficjalnych komunikatach wskazuje, że wydruk faktury z poprawnie naniesionym kodem weryfikującym powinien być honorowany na równi z dotychczasową fakturą VAT w procedurach cywilnoprawnych i administracyjnych. Brak kodu QR na dokumencie przekazanym poza systemem po upływie ustawowych terminów może skutkować sankcjami przewidzianymi w ustawie o podatku od towarów i usług.

Stosowanie oznaczeń graficznych różni się w zależności od dostępności systemu. W standardowym trybie online na wizualizacji umieszcza się pojedynczy kod QR (KOD I), który generowany jest po nadaniu fakturze unikalnego numeru przez serwer Ministerstwa Finansów. Jednakże w sytuacjach awaryjnych lub w trybie offline, podatnik musi wygenerować dwa kody QR przed przekazaniem dokumentu nabywcy. Pierwszy z nich służy weryfikacji przyszłego wpisu w systemie, drugi natomiast stanowi potwierdzenie tożsamości wystawcy poprzez certyfikat KSeF lub pieczęć elektroniczną.

Zgodnie z art. 106ma ustawy o VAT, istnieją precyzyjnie określone przypadki, w których generowanie kodu QR nie jest obligatoryjne dla wystawcy. Katalog wyłączeń obejmuje przede wszystkim specyficzne relacje biznesowe oraz typy dokumentów wewnętrznych.

  • Faktury wystawiane na rzecz konsumentów (B2C), które są przekazywane poza systemem KSeF, o ile odrębne przepisy nie stanowią inaczej.
  • Dokumenty dokumentujące transakcje wewnętrzne, które nie podlegają obowiązkowi przesyłania do bazy KSeF.
  • Faktury ustrukturyzowane odbierane przez nabywcę bezpośrednio w systemie KSeF za pomocą oprogramowania interfejsowego.
  • Dokumenty wystawiane w procedurach OSS (One Stop Shop) oraz IOSS, gdzie obowiązują odrębne zasady dokumentowania sprzedaży.

Co dokładnie zawiera kod QR na fakturze KSeF?

Struktura techniczna kodu QR opiera się na międzynarodowej normie ISO/IEC 18004:2015, co gwarantuje jego czytelność dla powszechnie dostępnych skanerów oraz dedykowanych aplikacji mobilnych Ministerstwa Finansów. Kluczowym elementem zaszyfrowanym w znaku graficznym jest unikalny identyfikator faktury (UUID), przykładowo w formacie 123e4567-e89b-12d3-a456-426614174000. Identyfikator ten jest przypisywany przez system w momencie skutecznej walidacji dokumentu XML i stanowi niezmienny punkt odniesienia w archiwum KSeF, które przechowuje faktury przez okres 10 lat od końca roku ich wystawienia.

Oprócz identyfikatora, kod QR zawiera skrót (hash) SHA2, który zabezpiecza integralność danych zawartych na fakturze. Oznacza to, że jakakolwiek próba modyfikacji wartości netto, stawki podatku lub danych kontrahenta na wizualizacji PDF spowoduje niezgodność z danymi zakodowanymi w symbolu graficznym. Dodatkowo w kodzie zaszyty jest adres endpoint API KSeF 2.0, który kieruje narzędzie skanujące bezpośrednio do zasobu na serwerach rządowych. Ważne jest, aby oprogramowanie generujące dokumenty stosowało certyfikat KSeF typu 2, który uwierzytelnia proces tworzenia kodu i zapewnia jego zgodność ze specyfikacją techniczną MF.

Weryfikacja faktury poprzez kod QR jest procesem zautomatyzowanym, który znacząco podnosi bezpieczeństwo obrotu gospodarczego. Po zeskanowaniu symbolu, użytkownik zostaje przekierowany do bezpiecznego interfejsu systemu KSeF, gdzie wyświetlane są kluczowe dane z faktury ustrukturyzowanej. Mechanizm ten pozwala nabywcy na natychmiastowe potwierdzenie, że otrzymany dokument został rzeczywiście zarejestrowany w systemie i posiada moc prawną, co jest istotne w kontekście skróconego do 40 dni terminu zwrotu VAT.

Czy kod QR zastępuje podpis elektroniczny?

Nie, kod QR nie zastępuje kwalifikowanego podpisu elektronicznego ani pieczęci elektronicznej. Jego funkcją jest potwierdzenie autentyczności wizualizacji faktury oraz zapewnienie szybkiego dostępu do danych źródłowych w systemie KSeF. Podczas gdy podpis elektroniczny służy do uwierzytelnienia całego pliku XML, kod QR jest jedynie instrumentem pomocniczym umożliwiającym weryfikację dokumentu przez podmioty nieposiadające w danej chwili bezpośredniego wglądu w system teleinformatyczny.

Dwa kody QR - kiedy stosuje się KOD I i KOD II?

Zgodnie z wymogami techniczno-prawnymi, faktura offline to dokument wystawiony bez jednoczesnego połączenia z KSeF, ale przekazany do systemu nie później niż następnego dnia roboczego (lub w terminach określonych dla trybu awaryjnego). W takim scenariuszu wystawca nie posiada jeszcze numeru identyfikacyjnego nadanego przez system, dlatego musi zastosować rozszerzony mechanizm zabezpieczeń graficznych. Brak łączności z infrastrukturą centralną w momencie wystawienia dokumentu wymusza na podatniku oznaczenie wizualizacji dwoma odrębnymi kodami weryfikującymi, co ma na celu zapobieganie nadużyciom i duplikowaniu dokumentacji.

Rozróżnienie między kodami opiera się na ich funkcji w procesie walidacji. KOD I pełni rolę referencyjną, zawierając dane, które pozwolą na odszukanie faktury po jej późniejszym przesłaniu do KSeF. KOD II natomiast stanowi tzw. pieczęć kwalifikowaną wizualizacji, potwierdzającą autentyczność pochodzenia dokumentu bezpośrednio od wystawcy. Do wygenerowania drugiego kodu niezbędny jest Kwalifikowany Podpis Elektroniczny lub pieczęć elektroniczna, a system fakturujący musi posiadać dostęp do klucza prywatnego certyfikatu KSeF typu 2, aby poprawnie podpisać dane binarne zawarte w symbolu graficznym.

Typ kodu Zawartość Moment nadania
KOD I (Online/Offline) Link do faktury, UUID, parametry weryfikacyjne Po rejestracji w KSeF (online) lub w momencie wystawienia (offline)
KOD II (Tryb Offline) Podpis elektroniczny wystawcy, certyfikat typu 2 Zawsze w momencie wystawiania dokumentu bez dostępu do sieci

Praktyczne wdrożenie - jak przygotować system do generowania kodów QR?

Przygotowanie infrastruktury IT do obsługi kodów QR wymaga weryfikacji kompatybilności oprogramowania z najnowszą specyfikacją API KSeF 2.0. Systemy klasy ERP, takie jak Comarch ERP XL, SAP FI czy Dynamics 365, muszą zostać zaktualizowane o moduły obsługujące algorytmy skrótu SHA2 oraz standard wizualizacji zgodny z wytycznymi Ministerstwa Finansów z września 2025 r. Podatnik musi upewnić się, że jego system potrafi nie tylko generować strukturę XML FA(3), ale również nanosić dynamicznie wygenerowane znaki graficzne na generowane pliki PDF w sposób czytelny i zgodny z parametrami technicznymi.

Proces technicznego wdrożenia powinien przebiegać zgodnie z usystematyzowanym harmonogramem, minimalizującym ryzyko przestojów w fakturowaniu:

  1. Aktualizacja modułu fakturującego do wersji wspierającej protokoły komunikacyjne KSeF 2.0.
  2. Instalacja i konfiguracja certyfikatu kwalifikowanego lub pieczęci elektronicznej w Module Certyfikatów i Uprawnień (MCU).
  3. Przeprowadzenie testów integracyjnych w środowisku demonstracyjnym Ministerstwa Finansów pod adresem ksef-test.mf.gov.pl.
  4. Weryfikacja poprawności generowania kodów QR dla faktur wystawianych w trybie awaryjnym (testowanie dwóch kodów).

Kluczowym etapem są testy end-to-end, które powinny obejmować pełną ścieżkę obiegu dokumentu - od wystawienia faktury offline, przez jej wydruk z kodami QR, aż po weryfikację za pomocą oficjalnej aplikacji MF. Po zeskanowaniu kodu aplikacja MF powinna wyświetlić status „Faktura znajduje się w KSeF” w czasie krótszym niż 2 sekundy, co potwierdza poprawność synchronizacji danych. Należy pamiętać, że każda faktura przekazywana poza system po 1 lutego 2026 r. bez wymaganych oznaczeń graficznych będzie traktowana jako dokument wadliwy, co może wpłynąć na prawo nabywcy do odliczenia podatku naliczonego.

Faktura ustrukturyzowana to nie PDF, lecz zestaw danych, który musi być zgodny z wymogami. Kod QR jest kluczowym elementem oznaczania faktur, umożliwiającym potwierdzenie ich pochodzenia, integralności treści oraz dostęp do pełnych danych w KSeF.

Podatnicy powinni również uwzględnić konieczność archiwizacji wizualizacji faktur wraz z kodami QR, szczególnie w przypadku dokumentów przekazywanych nabywcom nieposiadającym dostępu do systemu. Mimo że system KSeF przechowuje dane przez dekadę, posiadanie kopii zapasowej poprawnie wygenerowanego kodu QR stanowi istotny dowód w trakcie czynności sprawdzających prowadzonych przez organy Krajowej Administracji Skarbowej. Warto również monitorować komunikaty o planowanych przerwach technicznych (np. zapowiadana przerwa 26-31 stycznia 2026 r.), aby zapewnić ciągłość pracy w trybie offline z wykorzystaniem podwójnego kodowania.

Redakcja · wszystkie artykuły