Numer KSeF, UPO i kod QR na fakturze: co to jest i do czego służy
Numer KSeF to nie numer faktury, UPO to urzędowe potwierdzenie, a kod QR prowadzi do faktury w KSeF. Jak je czytać, gdzie je wpisać i co widzi klient.
Po wysłaniu faktury do KSeF pojawiają się trzy nowe rzeczy: numer KSeF, UPO i kod QR na PDF-ie. Do czego służy każda z nich, gdzie ją znaleźć i kiedy będzie ci potrzebna? Poniżej wyjaśnienie na podstawie Podręcznika KSeF 2.0 Ministerstwa Finansów (sierpień 2026 r.) i dokumentacji technicznej KSeF.
Numer KSeF: identyfikator faktury w systemie
Numer KSeF nadaje sam system, gdy przyjmie twoją fakturę. Ma zawsze 35 znaków i składa się z czterech części:
- NIP sprzedawcy (10 cyfr),
- data przyjęcia faktury do przetwarzania (rok, miesiąc, dzień),
- część techniczna (12 znaków szesnastkowych),
- suma kontrolna (2 znaki).
Trzy rzeczy, które warto wiedzieć:
- Numer KSeF to nie jest numer faktury. Twój numer, np. „FV/10/2026”, nadal jest na fakturze (pole P_2 w strukturze FA(3)). Numer KSeF nie jest elementem faktury — system zwraca go po przyjęciu.
- Brak numeru KSeF = faktura niewystawiona. Jeśli KSeF odrzuci plik, numeru nie ma, a faktura formalnie nie istnieje. Poprawiasz i wysyłasz jeszcze raz.
- Dzień nadania numeru to dzień otrzymania faktury przez klienta z polskim NIP-em. Klienta bez NIP-u albo z zagranicy dotyczy data faktycznego otrzymania faktury.
Gdzie numer KSeF będzie ci potrzebny
- Faktura korygująca zawiera numer KSeF faktury, którą koryguje. Także wtedy, gdy korygowana faktura była wystawiona w trybie offline i dostała numer później.
- Faktura rozliczająca zaliczki zawiera numery KSeF faktur zaliczkowych.
- Pliki JPK_V7. Od rozliczenia za luty 2026 w części ewidencyjnej podajesz numery KSeF faktur sprzedażowych i zakupowych.
- Przelewy między czynnymi podatnikami VAT i płatności w mechanizmie podzielonej płatności — obowiązek podawania numeru KSeF w tytule przelewu dotyczy płatności od 1 stycznia 2027. Wtedy numer KSeF przyda się też twoim klientom.
UPO: urzędowe potwierdzenie, że KSeF przyjął fakturę
UPO, czyli Urzędowe Poświadczenie Odbioru, to formalne potwierdzenie odbioru dokumentu przez KSeF. To osobny plik XML, który możesz pobrać po przyjęciu faktury. Zawiera m.in.:
- numer KSeF faktury i twój numer faktury (P_2),
- NIP sprzedawcy i datę wystawienia z faktury (P_1),
- datę przesłania pliku do KSeF — przy trybie online to jest data wystawienia,
- datę nadania numeru KSeF, czyli datę otrzymania faktury przez nabywcę,
- skrót (hash) pliku faktury.
Uwaga na jedną pułapkę: numer referencyjny sesji widoczny w UPO nie jest numerem KSeF faktury.
UPO przydaje się, gdy trzeba udowodnić, kiedy faktura trafiła do KSeF — np. przy sporze z klientem o termin. Programy do faktur pobierają je zwykle same.
Kod QR na fakturze
Gdy przekazujesz fakturę poza KSeF — PDF mailem, wydruk dla osoby prywatnej, faktura dla firmy z zagranicy — oznaczasz ją kodem QR. Kod prowadzi do faktury w KSeF. Każdy, kto go zeskanuje, sprawdzi, czy faktura jest w systemie i czy nie została zmieniona.
Faktura wystawiona w KSeF (online) ma jeden kod — KOD I — a pod nim numer KSeF.
Faktura offline (offline24, niedostępność KSeF, awaria) jeszcze nie ma numeru, więc dostaje dwa kody:
- KOD I z napisem „OFFLINE” — do weryfikacji faktury, gdy już trafi do KSeF,
- KOD II z napisem „CERTYFIKAT” — potwierdza tożsamość wystawcy. Do jego wygenerowania potrzebny jest certyfikat KSeF typu offline.
Kod tworzy program do faktur, lokalnie, z danych faktury: adresu KSeF, daty wystawienia, NIP-u sprzedawcy i skrótu pliku. Musi być zgodny z normą ISO/IEC 18004:2024.
Więcej o fakturach offline: Offline24 w KSeF. O certyfikacie do KODU II: Certyfikat KSeF dla JDG.
Co widzi klient po zeskanowaniu kodu
Po zeskanowaniu KODU I klient widzi uproszczone dane faktury i informację, czy jest w KSeF. Żeby pobrać pełny plik XML, musi podać dodatkowe dane — to tzw. dostęp dwuetapowy. Nie musi się logować do KSeF. Dzięki temu osoba prywatna albo firma z zagranicy, która nie ma dostępu do systemu, i tak sprawdzi fakturę.
PDF to wizualizacja, nie faktura
Fakturą w KSeF jest plik XML. PDF, który wysyłasz klientowi, to jej wizualizacja. Według Podręcznika o wyglądzie decyduje wystawca, ale wizualizacja musi być spójna z plikiem XML i czytelna. MF odradza trzymanie danych tylko na PDF-ie (np. rachunku bankowego czy terminu płatności), jeśli nie ma ich w pliku XML — nabywca nie zaczyta ich wtedy automatycznie.
KSeF przechowuje faktury przez 10 lat od końca roku, w którym je wystawiono.
Jak to zrobiłem w Wystaw
W Wystaw numer KSeF pojawia się na fakturze, gdy tylko KSeF ją przyjmie. Oś statusów pokazuje kolejno: wystawiona, wysłana do KSeF, przyjęta w KSeF — z numerem. UPO i plik XML Wystaw pobiera sam i trzyma w archiwum, z którego księgowa pobierze cały miesiąc. Na PDF dla klienta trafia KOD I z numerem KSeF, a przy fakturze offline — oba kody.
Jak przejść przez wysyłkę faktury od początku do końca: Jak wystawić fakturę w KSeF. Pakiet dla księgowej: eksport dla księgowej.
Podsumowanie
- Numer KSeF (35 znaków) nadaje system po przyjęciu faktury. Bez niego faktura nie jest wystawiona. To nie jest twój numer faktury.
- Numer KSeF wpisujesz w korektach, w fakturach rozliczających i w JPK. W przelewach między czynnymi podatnikami VAT — od 1 stycznia 2027.
- UPO to urzędowe potwierdzenie przyjęcia faktury, osobny plik XML.
- PDF przekazywany poza KSeF ma kod QR: online jeden (KOD I z numerem KSeF), offline dwa (KOD I „OFFLINE” i KOD II „CERTYFIKAT”).
Źródła
- Podręcznik KSeF 2.0, cz. II „Wystawianie i otrzymywanie faktur w KSeF” (MF, sierpień 2026, stan prawny na 1 lutego 2026 r.): pkt 1.6.1 (brak numeru KSeF po odrzuceniu), 1.6.3 (przechowywanie 10 lat), 1.6.5 (zawartość faktury poza KSeF), 4.1 (numer KSeF nie jest elementem faktury, P_2), 4.1.1–4.1.6 (numer KSeF w fakturach zaliczkowych, korygujących, MPP, płatnościach między czynnymi podatnikami VAT od 1 stycznia 2027 r., JPK od lutego 2026 r.), 4.2 (UPO i opis jego elementów), 5.1 (data otrzymania), 5.4–5.5 (KOD I i KOD II, dostęp dwuetapowy).
- Dokumentacja KSeF 2.0 MF: faktury/numer-ksef.md (struktura numeru, 35 znaków, CRC-8), kody-qr.md (KOD I i KOD II, ISO/IEC 18004:2024, generowanie lokalne).
- Ustawa o VAT, tekst jednolity (Dz.U. 2026 poz. 1263): art. 106na ust. 3 i 4 (data otrzymania), art. 106gb ust. 4 (faktura przekazywana poza KSeF), art. 108a i 108g (numer KSeF w płatnościach).
Najczęstsze pytania
Czym różni się numer KSeF od numeru faktury?
Numer faktury nadajesz ty i jest on na fakturze (pole P_2). Numer KSeF nadaje system po przyjęciu faktury. Ma 35 znaków: NIP sprzedawcy, datę przyjęcia, część techniczną i sumę kontrolną.
Co to jest UPO w KSeF?
Urzędowe Poświadczenie Odbioru: formalne potwierdzenie, że KSeF przyjął fakturę. To osobny plik XML z numerem KSeF, datą przesłania, datą nadania numeru i skrótem pliku faktury.
Kiedy faktura musi mieć kod QR?
Gdy przekazujesz ją poza KSeF, np. jako PDF dla osoby prywatnej albo firmy z zagranicy. Faktura online ma jeden kod (KOD I) z numerem KSeF, faktura offline dwa: KOD I z napisem OFFLINE i KOD II z napisem CERTYFIKAT.
Od kiedy trzeba podawać numer KSeF w przelewie?
Obowiązek podawania numeru KSeF w płatnościach między czynnymi podatnikami VAT i w mechanizmie podzielonej płatności dotyczy płatności od 1 stycznia 2027 r.