Jak działa numer KSeF? Wszystko, co warto wiedzieć

Po wysłaniu faktury do Krajowego Systemu e-Faktur dokument otrzymuje długi ciąg cyfr i znaków.

Po wysłaniu faktury do Krajowego Systemu e-Faktur dokument otrzymuje długi ciąg cyfr i znaków. To właśnie numer KSeF.

Na pierwszy rzut oka może wyglądać jak przypadkowy kod techniczny. W rzeczywistości jest cyfrowym identyfikatorem, który pozwala jednoznacznie odnaleźć konkretną fakturę w systemie.

Najprościej wyobrazić go sobie jako numer przesyłki kurierskiej. Faktura ma własną treść i numer nadany przez sprzedawcę, ale po przekazaniu jej do KSeF otrzymuje dodatkowy identyfikator, dzięki któremu system może ją rozpoznać.

Warto zapamiętać jedną prostą zasadę: Numer faktury nadaje sprzedawca. Numer KSeF nadaje system.

To dwa różne numery i oba pełnią inne funkcje.

Co to jest numer KSeF?

Numer KSeF to unikalny identyfikator faktury znajdującej się w Krajowym Systemie e-Faktur. Jest nadawany automatycznie po przesłaniu dokumentu i jego skutecznym przyjęciu przez system.

Każda przyjęta faktura otrzymuje własny numer. Nie ma więc dwóch różnych faktur oznaczonych tym samym numerem KSeF.

Nadanie numeru jest jednocześnie potwierdzeniem, że dokument został prawidłowo dostarczony do systemu. Numer jest zwracany między innymi w Urzędowym Poświadczeniu Odbioru, czyli UPO. Nie jest natomiast częścią źródłowego pliku XML faktury.

Z czego składa się numer KSeF?

Oficjalny schemat numeru wygląda następująco: 9999999999-RRRRMMDD-FFFFFFFFFFFF-FF

Choć zapis wydaje się skomplikowany, można łatwo podzielić go na cztery części:
1. NIP sprzedawcy
Pierwsze 10 cyfr to numer NIP podmiotu, który wystawił fakturę.
Dzięki temu już sam początek numeru wskazuje, z jakim sprzedawcą powiązany jest dokument.

2. Data przesłania faktury do KSeF
Kolejnych osiem cyfr oznacza datę przekazania dokumentu do systemu w formacie: rok – miesiąc – dzień

3. Część techniczna
Następny fragment składa się z 12 znaków generowanych automatycznie przez KSeF.
To techniczna część identyfikatora, dzięki której system może odróżnić faktury przesłane przez tego samego sprzedawcę, również tego samego dnia.

4. Suma kontrolna
Ostatnie dwa znaki stanowią sumę kontrolną.
Jej zadaniem jest między innymi ułatwienie wykrycia błędu podczas przepisywania lub przetwarzania numeru. Wartość ta również jest wyliczana automatycznie przez system.

Jak numer KSeF jest nadawany?

Cały proces odbywa się automatycznie.

- Sprzedawca przygotowuje fakturę w programie do fakturowania.
- Dokument zostaje zapisany jako plik XML zgodny z obowiązującą strukturą e-Faktury.
- Program przesyła plik do KSeF.
- System sprawdza zgodność dokumentu ze strukturą oraz uprawnienia osoby lub podmiotu wysyłającego.
- Jeżeli dokument zostanie przyjęty, KSeF nadaje mu unikalny numer.
- Numer wraca do programu wraz z informacją o skutecznym przyjęciu faktury.

Użytkownik nie powinien tworzyć numeru KSeF samodzielnie. Nie wybiera również jego kolejności ani formatu.

W programie Faktury.co zintegrowanym z KSeF cały proces odbywa się w tle. Użytkownik wystawia fakturę, a aplikacja odpowiada za jej przesłanie, odebranie statusu i zapisanie numeru nadanego przez system.

Numer KSeF a numer faktury — najważniejsza różnica

To zagadnienie często powoduje nieporozumienia.

Tradycyjny numer faktury, na przykład: FV/45/08/2026 jest nadawany przez przedsiębiorcę zgodnie z przyjętym sposobem numeracji dokumentów.

Numer KSeF może natomiast wyglądać tak: 9999999999-20260803-FFFFFFFFFFFF-FF

Numer nadany przez sprzedawcę nadal pozostaje na fakturze. KSeF nie zastępuje firmowej numeracji i nie zwalnia przedsiębiorcy z zachowania jej ciągłości.

Oznacza to, że jedna faktura może mieć jednocześnie:
- numer handlowy nadany przez sprzedawcę,
- numer KSeF nadany przez system.

Pierwszy pomaga organizować dokumenty w firmie. Drugi identyfikuje fakturę w państwowym systemie.

Gdzie można znaleźć numer KSeF?

Numer może być dostępny w kilku miejscach:
- w programie do fakturowania zintegrowanym z KSeF,
- w Urzędowym Poświadczeniu Odbioru,
- na wizualizacji faktury, na przykład w pliku PDF,
- pod kodem QR umieszczonym na dokumencie używanym poza KSeF.

Warto przy tym pamiętać, że numer nie znajduje się wewnątrz pierwotnego pliku XML faktury. Jest nadawany dopiero przez KSeF po przesłaniu i przyjęciu dokumentu.

Co oznacza brak numeru KSeF?

Brak numeru może oznaczać, że dokument:
- nie został jeszcze wysłany,
- czeka na przetworzenie,
- został odrzucony przez KSeF,
- został wystawiony w jednym z przewidzianych trybów offline i nie trafił jeszcze do systemu.

Jeżeli plik przesłany w trybie online zawiera błędy lub został wysłany przez osobę bez odpowiednich uprawnień, KSeF go odrzuci. Taki dokument nie otrzyma numeru KSeF.

Nie wystawia się wtedy faktury korygującej. Należy poprawić przyczynę odrzucenia i ponownie wysłać prawidłowy dokument.

Czy numer KSeF trzeba umieszczać na fakturze?

Numer KSeF nie jest elementem pliku XML wysyłanego do systemu, ponieważ w momencie przygotowywania dokumentu jeszcze nie istnieje.

Może jednak pojawić się na późniejszej wizualizacji faktury, na przykład na wygenerowanym pliku PDF lub wydruku. Przy używaniu faktury poza KSeF dokument może być oznaczony kodem QR, a numer KSeF znajduje się bezpośrednio pod nim.

Kod pozwala zweryfikować dokument i uzyskać dostęp do faktury znajdującej się w systemie.

Numer KSeF podczas płatności

Numer KSeF będzie miał również znaczenie przy rozliczeniach między przedsiębiorcami.

Od 1 stycznia 2027 roku czynny podatnik VAT dokonujący przelewu za fakturę ustrukturyzowaną na rzecz innego czynnego podatnika VAT będzie co do zasady zobowiązany podać w tytule płatności:
- numer KSeF — przy płatności za jedną fakturę,
- zbiorczy identyfikator — przy płatności za kilka faktur.

Zbiorczy identyfikator pozwoli połączyć wiele numerów KSeF w jeden kod przeznaczony do wykorzystania podczas płatności.

Czy numer KSeF można zmienić?

Nie. Numer jest przypisany do konkretnej faktury i nie może zostać zmieniony.

Faktury przyjętej przez KSeF nie można również edytować ani usunąć. Jeżeli zawiera błąd, należy wystawić fakturę korygującą.

Korekta jest osobnym dokumentem, dlatego po wysłaniu do systemu otrzyma własny numer KSeF.

Najczęstsze pytania

Czy numer KSeF zastępuje numer faktury?
Nie. Numer faktury nadal nadaje sprzedawca. Numer KSeF jest dodatkowym identyfikatorem wykorzystywanym przez Krajowy System e-Faktur.

Czy mogę samodzielnie wygenerować numer KSeF?
Nie. Numer jest tworzony wyłącznie przez KSeF po skutecznym przyjęciu dokumentu.

Czy każda faktura otrzymuje numer KSeF?
Numer otrzymuje dokument przyjęty przez KSeF. Plik odrzucony przez system nie otrzyma numeru.

Czy numer KSeF znajduje się w pliku XML?
Nie. Jest generowany dopiero po przesłaniu pliku i zwracany między innymi w UPO.

Czy faktura korygująca ma osobny numer KSeF?
Tak. Faktura korygująca jest oddzielnym dokumentem i otrzymuje własny numer identyfikacyjny.

Numer KSeF bez technicznego stresu

Długi identyfikator może wyglądać skomplikowanie, ale przedsiębiorca nie musi go ręcznie tworzyć ani analizować przy każdym dokumencie.

Najważniejsze są trzy zasady: Ty nadajesz numer swojej fakturze. KSeF nadaje jej numer systemowy. Przyjęty dokument ma jeden unikalny numer KSeF.

Resztą zajmie się Faktury.co – program do fakturowania.

Faktury.co jest zintegrowane z Krajowym Systemem e-Faktur, dzięki czemu techniczna obsługa wysyłki dokumentów, ich statusów oraz numerów KSeF może odbywać się w jednym miejscu — bez ręcznego przepisywania długich identyfikatorów.