QR KOD I - Weryfikacja i pobieranie faktury z KSeF

Wpis #301 z dnia: 26-09-2025

Każdy rodzaj faktury przekazany odbiorcy poza systemem KSeF (np. w formacie PDF) musi zawierać graficzny Kod QR, lub dwa kody dla trybu offline.

Kod QR I występuje zawsze i służy do :

  • sprawdzenia, czy dana faktura rzeczywiście znajduje się w systemie KSeF i czy nie została zmodyfikowana,
  • pobrania wersji ustrukturyzowanej (plik XML) bez potrzeby kontaktu z wystawcą,

Po dodaniu faktury do bazy SQL KSeF-link, program automatycznie generuje kod QR I oraz link, który ten kod prezentuje. Dla Integratorów, dane zapisane są w tabeli:

  • ksef_invoices.QR1 - postać graficzna kodu
  • ksef_invoices.Url1 - adres Url prowadzący do serwisu API w celu weryfikacji faktury

Podpis tekstowy pod kodem może mieć dwie formy (automatycznie dodany do grafiki) :

  • napis: OFFLINE (jeżeli faktura nie ma jeszcze numeru referencyjnego KSeF)
  • pełny kod z numerem referencyjnym KSeF, dla faktur już przetworzonych.

Widok kodu QR w trybie OFFLINE

Na zdjęciu powyżej widzimy wygenerowany Kod QR dla nowej faktury dodanej do systemu (odpowiednia ikona w kolumnie [Status]). Ponieważ faktura nie została jeszcze wysłana, po kodem mamy napis OFFLINE. Adres URL w stopce podglądu QR jest już właściwy, ale nie wyświetli jeszcze faktury w systemie MF, ponieważ faktura nie została wysłana. Jeżeli otworzymy Kod QR po wysłaniu i przetworzeniu faktury, system będzie posiadał nadany numer referencyjny faktury, to podpis pod kodem QR będzie zawierał odpowiedni numer KSeF.

Widok kodu QR w trybie ONLINE

Fakturę można zweryfikować otwierając stronę internetową MF:

  • bezpośrednio z okna podglądu skanując kod QR smartfonem
  • poprzez naciśnięcie przycisku [Otwórz Url]