Numer KSeF: co to jest, z czego się składa i gdzie go znaleźć

Numer KSeF to unikalny numer, który identyfikuje fakturę w Krajowym Systemie e-Faktur. System nadaje go automatycznie po przyjęciu dokumentu. Zwraca go UPO.

Nie nadaje go Twój program do faktur. Nie jest też elementem pliku XML tej samej faktury, którą wysyłasz.

To rozróżnienie odpowiada na najczęstsze pytanie przy obsłudze zamówień: skąd wiem, że faktura naprawdę przeszła?

W tym poradniku sprawdzisz, gdzie znaleźć numer KSeF, czym różni się od trzech innych identyfikatorów, co potwierdza UPO i co zrobić, gdy numeru nie ma.

Czym jest numer KSeF i czego nie zastępuje

Numer KSeF identyfikuje fakturę w systemie państwowym. Powstaje dopiero w momencie przyjęcia dokumentu, więc jego obecność jest dowodem przyjęcia.

Twoja własna numeracja działa dalej bez zmian. Numer, który nadaje sprzedawca, zapisywany jest w polu P_2 i to on identyfikuje dokument w Twoich księgach.

Ministerstwo Finansów opisuje te dwa numery wprost jako dwa różne numery. Numer KSeF nie stanowi elementu faktury.

W praktyce oznacza to jedną zasadę operacyjną: przechowuj oba numery razem, przy zamówieniu. Wtedy pytanie klienta albo księgowości da się rozstrzygnąć w kilka sekund.

Numer referencyjny to nie numer KSeF

Przy wysyłce integracja otrzymuje numery referencyjne sesji i faktury. Służą do prześledzenia konkretnej próby, nie do zidentyfikowania przyjętego dokumentu.

Jeśli księgowość prosi o numer KSeF, przesłanie referencji sesji nie odpowiada na jej pytanie. To dwie różne informacje o dwóch różnych etapach.

UPO to dokument, nie numer

UPO, czyli Urzędowe Poświadczenie Odbioru, jest osobnym plikiem XML. Potwierdza odbiór faktury przez KSeF i zawiera nadany numer.

Numer mówi, że dokument jest w systemie. UPO jest tym, czym to udowodnisz.

Z czego składa się numer KSeF?

Tu trzeba uważać, bo w internecie krąży odpowiedź dotycząca innego identyfikatora. Ministerstwo publikuje układ 35 znaków dla identyfikatora zbiorczego, a nie dla numeru KSeF.

Identyfikator zbiorczy jest numerem agregującym. Nadaje się go dla co najmniej dwóch faktur ustrukturyzowanych jednego sprzedawcy.

Powstaje po zadeklarowaniu listy numerów KSeF. Wygenerować go może zarówno wystawca, jak i odbiorca faktur.

Do czego służy identyfikator zbiorczy

Pozwala podać w tytule płatności jeden numer dla wielu opłacanych faktur. Da się go też rozkodować w obie strony.

Można sprawdzić, jakie numery KSeF obejmuje dany identyfikator. Można również ustalić, w jakich identyfikatorach zbiorczych znalazł się konkretny numer KSeF.

Gdzie sprawdzić numer KSeF?

Numer znajdziesz w wyniku przetwarzania i w UPO. W praktyce zaglądasz w jedno z dwóch miejsc: do własnego systemu albo do Aplikacji Podatnika.

W easySales

Otwórz zamówienie i przejdź do listy wysyłek. Zobaczysz tam status, referencje próby i — po przyjęciu — nadany numer KSeF wraz z zapisanym UPO.

Zacznij od konkretnego dokumentu. Jedno zamówienie może mieć fakturę pierwotną i korektę, więc dopasuj poświadczenie do dokumentu, o który pyta klient.

Zakres integracji opisuje strona integracji z KSeF, a szerszy kontekst — przewodnik po fakturach ustrukturyzowanych.

W Aplikacji Podatnika KSeF

Po zalogowaniu we właściwym kontekście otwórz historię sesji. Wybierz sesję, przejdź do szczegółów wysyłki i odszukaj fakturę.

Przy dokumencie znajdziesz jego numer KSeF i status, a z menu pobierzesz UPO. Dla zakończonej sesji dostępne jest też poświadczenie zbiorcze. Ścieżkę opisuje instrukcja Aplikacji Podatnika.

Weryfikacja numeru: wyszukiwarka, nie generator

Ministerstwo udostępnia anonimową wyszukiwarkę faktur. Sprawdzisz w niej dokument, którego numer już masz.

Generatora numerów KSeF nie ma i być nie może. Numer powstaje po stronie systemu, więc żadne narzędzie nie wyliczy go z góry.

Wyszukiwarka oczekuje trzech danych: NIP-u sprzedawcy, daty wystawienia i skrótu faktury. Dokładnie te trzy wartości tworzą link zapisany w kodzie QR na wizualizacji.

Numer KSeF na fakturze i w przelewie

Ponieważ numer nie jest elementem XML wysyłanej faktury, na wizualizacji pojawia się dopiero po przyjęciu. Wtedy PDF przekazywany poza systemem nosi kod QR z tym numerem.

Nasza integracja składa ten link z NIP-u sprzedawcy, daty wystawienia i skrótu faktury, a następnie umieszcza go w kodzie QR na PDF-ie.

Numer wraca też w dwóch miejscach, o których łatwo zapomnieć przy konfiguracji.

• W treści faktury — schemat FA(3) przewiduje podanie numeru KSeF faktury zaliczkowej w fakturze rozliczającej oraz numeru faktury pierwotnej w korekcie.
• W ewidencji JPK_VAT — nowa wersja struktury przewiduje wykazywanie numeru KSeF w części ewidencyjnej, po stronie sprzedaży i zakupu.

Ministerstwo publikuje również zasady podawania numeru KSeF lub identyfikatora zbiorczego w tytule płatności między podatnikami czynnymi. Terminy i zakres tego obowiązku znajdziesz w materiale Ministerstwa.

Kiedy faktura jest naprawdę wystawiona?

W trybie online datą wystawienia jest data skutecznego przesłania do KSeF, jeśli zgadza się z datą w polu P_1, a dokument zostanie przyjęty.

Samo kliknięcie przycisku w Twoim programie nie jest dowodem tej daty. Liczy się moment zarejestrowany po stronie systemu.

Pobranie UPO nie ustala nowej daty wystawienia. To osobne zdarzenie, które tylko dokumentuje odbiór.

Co zmienia tryb offline24

W offline24 datą wystawienia jest data wpisana w P_1. Fakturę przesyła się do systemu później, w terminie, który opisuje strona Ministerstwa o trybie offline24.

Dlatego przy braku numeru zapytaj najpierw o tryb wystawienia. Faktura offline może być już wystawiona, choć wciąż czeka na przesłanie i numer.

Pięć zdarzeń, które mieszczą się w słowach „faktura wystawiona”

Przy obsłudze zamówienia łatwo połączyć kilka różnych momentów w jeden. Do kontroli wysyłki potrzebujesz dokładniejszego podziału.

Weryfikacja w KSeF jest asynchroniczna. System najpierw przyjmuje żądanie, a wynik ustala później — więc potwierdzenie, że plik poszedł, nie kończy procesu.

Ten podział przydaje się też przy przekazywaniu sprawy między działami. Zamiast „faktura nie działa” możesz powiedzieć: znamy referencję wysyłki, ale nie znamy jeszcze wyniku.

Nie ma numeru KSeF? Rozpoznaj sytuację

Trzy stany wyglądają w panelu podobnie, a wymagają trzech różnych działań. Rozróżnienie ich jest tańsze niż naprawianie skutków pomyłki.

Wynik pozostaje nieustalony

Wysyłka poszła, odpowiedzi nie ma. Ustal wynik istniejącej próby, korzystając z jej referencji.

W easySales taka wysyłka ma status Oczekujące. Po pięciu sprawdzeniach bez końcowej odpowiedzi zmienia się on na Wysłanie nie powiodło się.

Ten status nie znaczy, że KSeF odrzucił dokument. Znaczy, że nasz system przestał pytać — a to zupełnie inna informacja.

KSeF zwrócił konkretne odrzucenie

Przeczytaj kod i opis błędu, zanim cokolwiek zmienisz. Zależnie od komunikatu sprawdzisz strukturę dokumentu, daty, identyfikatory albo uprawnienia.

Odrzucona próba online nie prowadzi do wystawienia faktury w KSeF. Po usunięciu przyczyny potrzebna jest skuteczna wysyłka.

Przy błędzie danych popraw dane na samej fakturze. Po użyciu ponownej wysyłki dokument odbudowywany jest z zapisanej treści faktury, więc zmiana wyłącznie na zamówieniu może do niej nie trafić.

Komunikat mówi o duplikacie

Najpierw odnajdź istniejący dokument i porównaj go z wysyłanym. Dopiero to rozstrzyga, czy wcześniejsza próba się powiodła, czy doszło do kolizji numeracji.

Nasza integracja rozdziela te dwa przypadki automatycznie. Gdy zarejestrowany dokument okazuje się tą samą fakturą, przyjmujemy jej pierwotny numer KSeF i pobieramy dla niego UPO.

Gdy pod tym numerem stoi inna faktura, wysyłka kończy się błędem z wyraźną informacją, że dokument nie został zarejestrowany. Sama zmiana numeru, by komunikat zniknął, zamaskowałaby przyczynę.

Co UPO potwierdza, a czego nie

UPO potwierdza odbiór dokumentu przez KSeF. Nie jest oceną prawidłowości całego rozliczenia.

Ministerstwo wskazuje wprost, że system nie weryfikuje obliczeń matematycznych na fakturze. Pozytywny wynik walidacji nie potwierdza więc poprawności podatkowej.

Utrzymuj zatem dwie osobne kontrole: czy dokument został przyjęty oraz czy opisuje właściwą sprzedaż, nabywcę i kwoty.

Przy weryfikacji poświadczenia szukaj przede wszystkim numeru KSeF i numeru faktury, NIP-u sprzedawcy, daty z P_1, daty przesłania oraz trybu wysyłki.

Otwórz plik i najpierw dopasuj numer faktury oraz sprzedawcę. Dopiero potem sprawdzaj daty — sama obecność pliku o nazwie „UPO” nie zapewnia, że dotyczy tego dokumentu.

Co widać w naszych danych

Do tej pory opisywaliśmy, jak proces powinien wyglądać. Poniżej to, co widzimy we własnym systemie.

Nasza integracja nadaje wysyłce status końcowy dopiero po zapisaniu UPO. To decyzja projektowa, a nie efekt uboczny.

Trzy środkowe liczby są identyczne i to jest tu cała treść. Przyjęte, z nadanym numerem i z zapisanym poświadczeniem to u nas dokładnie ten sam zbiór faktur.

Dlatego status „Wysłano” w naszym panelu mówi więcej, niż sugeruje słowo. Nie oznacza, że plik wyszedł — oznacza, że wrócił numer i poświadczenie.

Pierwsza przyjęta faktura pochodzi z 15 maja 2026 r. Liczby rosną codziennie, więc traktuj je jako migawkę, nie stałą.

Od czego zacząć u siebie

Wybierz jedną fakturę i odtwórz całą jej ścieżkę: od dokumentu, przez wysyłkę, do numeru i poświadczenia.

Jeśli potrafisz to zrobić w kilka minut, masz proces. Jeśli nie, wiesz już, którego zdarzenia nie zapisujesz.

Ustal też jedną osobę odpowiedzialną za wysyłki bez rozstrzygniętego wyniku. Dokument z nieustalonym statusem nie powinien krążyć między obsługą klienta a księgowością.

Chcesz zobaczyć te statusy przy własnych zamówieniach? Sprawdź integrację easySales z KSeF.