Faktura wystawiona w Krajowym Systemie e-Faktur ma dwie postaci: plik XML i jego wizualizację, na przykład wydruk albo PDF. Na wizualizacji umieszcza się kod QR, który prowadzi do faktury w KSeF. Ten kod, nazywany KOD I, jest zapisem linku, a link składa się z adresu usługi, daty wystawienia faktury (pole P_1), NIP sprzedawcy i skrótu SHA-256 pliku faktury. Narzędzie liczy ten skrót w przeglądarce, buduje link i rysuje kod QR, który można pobrać albo umieścić na PDF. (English: build, place and check the KSeF verification QR code, KOD I.)
Narzędzie nie prosi o klucze prywatne i nie obsługuje KOD II (certyfikat), więc nic poufnego nie jest potrzebne. Plik faktury nie jest wysyłany, a narzędzie nie łączy się z KSeF.
Loading the tool…
Overview
About KSeF QR Code Generator & Checker
Jak wygląda link. Zgodnie z dokumentacją Ministerstwa Finansów link ma postać https://qr.ksef.mf.gov.pl/invoice/{NIP}/{DD-MM-RRRR}/{skrót}. Adres środowiska produkcyjnego to qr.ksef.mf.gov.pl, demonstracyjnego qr-demo.ksef.mf.gov.pl, a testowego qr-test.ksef.mf.gov.pl. Data to wartość pola P_1 faktury zapisana jako dzień-miesiąc-rok, NIP to numer sprzedawcy (10 cyfr, ze sprawdzeniem cyfry kontrolnej), a skrót to SHA-256 liczony z bajtów pliku faktury i zapisany w Base64URL bez znaków dopełnienia (43 znaki).
Podpis pod kodem. Pod kodem QR umieszcza się numer KSeF faktury. Gdy numer nie jest jeszcze znany, na przykład przy fakturze wystawionej w trybie offline, pod kodem drukuje się napis OFFLINE. Narzędzie pozwala wpisać numer albo zostawić pole puste.
Generator. Wczytaj plik faktury FA(3): NIP i datę odczyta program, a skrót policzy z dokładnie tych bajtów. Można też wpisać NIP, datę i skrót ręcznie. Wynik to link, podgląd kodu, plik SVG lub PNG oraz umieszczenie kodu z podpisem na wybranej stronie wizualizacji PDF, z przeciąganiem, podpowiedzią wolnego miejsca i ostrzeżeniem, gdy moduły są za małe do skanowania.
Sprawdzanie. Wczytaj PDF albo obraz z kodem (albo wklej link). Program dekoduje kod, sprawdza host (jeden z trzech adresów KSeF), format ścieżki, NIP, datę i skrót. Jeśli dodasz plik XML, porówna NIP z wartością w fakturze, datę z polem P_1 i skrót kodu ze skrótem pliku. Różnica skrótu zwykle oznacza, że XML nie jest dokładnie tym plikiem, który wysłano do KSeF, na przykład został zapisany ponownie.
Compatibility
Supported Formats
Wejście: plik XML faktury FA(3) do 5 MB, PDF do 50 MB, obrazy PNG, JPEG i WebP do 30 MB. Wyjście: link, SVG, PNG oraz PDF z dodanym kodem. Nie ma obsługi KOD II (certyfikat) ani kodów w innych formatach.
Guide
How to Use KSeF QR Code Generator & Checker
- Aby utworzyć kod: wybierz środowisko, wczytaj plik XML faktury FA(3) albo wpisz NIP, datę i skrót, wpisz numer KSeF (lub zostaw puste dla OFFLINE).
- Pobierz kod jako SVG lub PNG, albo wczytaj PDF wizualizacji i przeciągnij kod w wolne miejsce na stronie.
- Aby sprawdzić kod: przejdź do trybu sprawdzania, wczytaj PDF lub obraz z kodem i opcjonalnie plik XML do porównania.
- Otwórz link tylko jeśli ufasz źródłu faktury. Narzędzie nie łączy się z KSeF.
Highlights
Features
- Link KOD I z pliku XML NIP i data z faktury, skrót SHA-256 w Base64URL liczony w przeglądarce.
- Kod z podpisem na PDF Przeciągnij kod w wolne miejsce wizualizacji; podpis to numer KSeF lub OFFLINE.
- Odczyt kodu z obrazu i PDF Sprawdza host, ścieżkę, NIP, datę i skrót.
- Porównanie z plikiem XML Pokazuje różnice w NIP, dacie i skrócie.
- Bez kluczy prywatnych KOD II nie jest obsługiwany, nic poufnego nie jest potrzebne.
Applications
Use Cases
- Dodanie kodu QR do wizualizacji faktury przygotowanej poza programem do fakturowania
- Sprawdzenie, czy kod na otrzymanym PDF prowadzi do tego samego NIP i daty co plik XML
- Policzenie skrótu SHA-256 faktury w formacie Base64URL
- Sprawdzenie, czy link z kodu wskazuje na adres KSeF, a nie na podobnie wyglądającą stronę
- Przygotowanie przykładów kodów w środowisku testowym lub demonstracyjnym
Good to Know
Limitations
To nie jest oficjalne narzędzie Ministerstwa Finansów ani oprogramowanie certyfikowane lub zatwierdzone przez KSeF, a kod z tego narzędzia nie daje gwarancji akceptacji. Skrót ma sens tylko dla dokładnie tych bajtów, które wysłano do KSeF; po zmianie albo ponownym zapisie pliku skrót się zmienia. Specyfikację kodów QR zweryfikowano w dokumentacji MF w dniu 6 października 2026; przepisy i dokumentację KSeF 2.0 należy sprawdzać na stronach ksef.podatki.gov.pl.
Narzędzie nie sprawdza, czy faktura istnieje w KSeF, nie liczy numeru KSeF ani jego sumy kontrolnej (sprawdza tylko kształt numeru) i nie obsługuje KOD II. Dodanie kodu do PDF zapisuje plik ponownie, więc podpis cyfrowy oryginału przestaje być ważny.
This tool runs entirely in your browser — your file is never uploaded to our servers. See our Privacy Policy for full details.
Support
Frequently Asked Questions
Czy plik faktury jest wysyłany na serwer?
Nie. Skrót SHA-256 liczy przeglądarka, a kod i PDF powstają na Twoim urządzeniu. Plik XML nie jest wysyłany ani zapisywany.
Co to jest KOD I, a co KOD II?
KOD I potwierdza dane faktury (NIP sprzedawcy, datę i skrót pliku) i jest na każdej wizualizacji. KOD II służy do potwierdzenia tożsamości wystawcy certyfikatem i dotyczy faktur w trybie offline. To narzędzie obsługuje wyłącznie KOD I i nie przyjmuje kluczy prywatnych.
Dlaczego skrót w kodzie nie zgadza się z moim plikiem?
Skrót dotyczy dokładnych bajtów pliku wysłanego do KSeF. Jeśli XML został zapisany ponownie, zmieniono w nim spacje, kodowanie lub kolejność, skrót będzie inny.
Co mam wydrukować pod kodem QR?
Numer KSeF faktury. Gdy numeru jeszcze nie ma, napis OFFLINE. Narzędzie wyświetla właściwy podpis.
Czy to jest oficjalny walidator KSeF?
Nie. Narzędzie buduje i sprawdza strukturę linku zgodnie z dokumentacją, ale nie łączy się z KSeF i nie potwierdza, że faktura jest w systemie.
Can I use it for the test environment?
Yes. Choose the demo or test environment and the link uses qr-demo.ksef.mf.gov.pl or qr-test.ksef.mf.gov.pl.
Keep Going
Related Tools
- KSeF FA(3) XML Viewer Open a Polish KSeF structured invoice (FA(3)) and read it as a table. Checks the XML against the official schema. Runs in your browser.
- E-Invoice Format Detector Find out what an XML or PDF e-invoice file is: ZUGFeRD, Factur-X, XRechnung, KSeF FA(3), Peppol BIS or plain UBL, from fixed signals you can see.
- PDF Attachments Extractor List every file embedded in a PDF, see what each one really is, and download one or all of them. The PDF stays in your browser.
- VeriFactu QR Code Reader & Checker Verificar QR VeriFactu: lee el código QR de una factura (imagen o PDF), muestra NIF, número, fecha e importe, comprueba su estructura y enlaza a la comprobación oficial de la AEAT. En el navegador.
- GST e-Invoice QR Code Decoder & Checker Decode the signed QR code on an Indian GST e-invoice from an image or PDF: GSTIN, invoice number, date, value, IRN and more, with format checks. Signature check only with a key you supply. In your browser.
- ZATCA E-Invoice QR Decoder & Checker ZATCA QR code decoder: read the Base64 TLV QR code on a Saudi e-invoice from an image or PDF and see seller, VAT number, time, totals and Phase 2 tags. Structural check only. In your browser.