Co oznacza status faktury w KSeF?

Najważniejsza zasada jest prosta: faktura jest skutecznie wystawiona w KSeF wtedy, gdy system ją przyjmie i nada jej numer KSeF. Status błędu lub odrzucenia oznacza, że dokument trzeba zweryfikować.

Krajowy System e-Faktur nie działa jak zwykła skrzynka pocztowa, do której wysyłamy dokument i od razu możemy uznać sprawę za zakończoną. Po przesłaniu faktury system musi ją odebrać, zweryfikować i przetworzyć. Dopiero pozytywne zakończenie tego procesu prowadzi do nadania fakturze unikalnego numeru KSeF.

Dlatego w programach do fakturowania można spotkać statusy takie jak „oczekuje na wysłanie”, „wysyłanie”, „przetwarzanie”, „przyjęta przez KSeF” czy „odrzucona”. Nazwy mogą różnić się pomiędzy programami, ale zasadniczy proces pozostaje taki sam.

Czym właściwie jest status faktury w KSeF?

Status faktury to informacja o aktualnym etapie obsługi dokumentu. Pozwala odpowiedzieć przede wszystkim na pytanie: czy faktura została już skutecznie przesłana i zaakceptowana przez KSeF?

Warto rozróżnić status techniczny związany z KSeF od innych oznaczeń używanych w programach księgowych.

Faktura może mieć jednocześnie na przykład:

Są to zupełnie różne informacje.

Status KSeF opisuje przede wszystkim komunikację dokumentu z państwowym systemem e-Faktur. Nie mówi natomiast, czy kontrahent zapłacił fakturę ani czy dokument został już rozliczony w księgowości.

Jak wygląda droga faktury do KSeF?

W typowym scenariuszu faktura przechodzi przez kilka etapów:

utworzenie faktury → przygotowanie pliku XML → wysłanie do KSeF → przetwarzanie → przyjęcie lub odrzucenie → nadanie numeru KSeF i udostępnienie UPO

Najważniejsza jest końcówka tego procesu.

Ministerstwo Finansów wskazuje, że numer KSeF jest unikalnym identyfikatorem faktury nadawanym automatycznie po przesłaniu e-Faktury i jej przyjęciu do systemu. Numer jest również zwracany w UPO.

Najczęstsze statusy faktury w KSeF – co oznaczają?

Nazewnictwo widoczne dla użytkownika zależy częściowo od używanego programu do faktur. Program może tłumaczyć techniczne komunikaty KSeF na prostsze określenia. W praktyce użytkownik spotka najczęściej kilka podstawowych sytuacji.

Najważniejsze jest więc nie samo pojawienie się komunikatu „wysłano”, lecz uzyskanie potwierdzenia prawidłowego przyjęcia dokumentu przez KSeF.

Co oznacza status „wysłana do KSeF”?

To status, który może być mylący.

„Wysłana” może oznaczać jedynie, że program przekazał dokument do KSeF. Nie musi jeszcze oznaczać, że KSeF zakończył jego przetwarzanie i zaakceptował fakturę.

Można to porównać do przesyłki kurierskiej. Nadanie paczki nie oznacza jeszcze jej dostarczenia. Podobnie wysłanie pliku XML nie jest tym samym co jego pozytywne przetworzenie.

Dlatego po wysłaniu faktury program powinien sprawdzić wynik operacji.

Co oznacza „faktura w trakcie przetwarzania”?

Status ten oznacza, że dokument został przekazany do systemu, ale KSeF nie zakończył jeszcze jego obsługi.

Nie należy wtedy od razu wysyłać faktury ponownie.

KSeF działa asynchronicznie – pomiędzy przesłaniem dokumentu a otrzymaniem końcowej informacji może wystąpić pewne opóźnienie. Dokumentacja API KSeF przewiduje techniczny status „trwa przetwarzanie”, a system umożliwia późniejsze sprawdzanie wyniku operacji.

Samo chwilowe oczekiwanie nie oznacza zatem błędu.

Ministerstwo Finansów prowadziło nawet testy środowiska KSeF symulujące sytuację, w której dokumenty są przyjmowane przez API, ale przez pewien czas nie są przetwarzane. Po wznowieniu przetwarzania wcześniej przyjęte dokumenty mogą zostać obsłużone bez konieczności ich ponownego tworzenia.

Co zrobić, gdy status „przetwarzanie” utrzymuje się długo?

W pierwszej kolejności:

Dopiero gdy system lub używane oprogramowanie jednoznacznie wskaże błąd, należy podejmować działania naprawcze.

Co oznacza status „przyjęta przez KSeF”?

To jeden z najważniejszych statusów.

Oznacza, że dokument przeszedł weryfikację KSeF i został zaakceptowany przez system. Fakturze zostaje nadany unikalny numer KSeF.

Numer KSeF nie jest tym samym co numer faktury nadawany przez przedsiębiorcę.

Przykładowo przedsiębiorca może wystawić dokument:

FV/125/08/2026

Jest to numer faktury w jego własnym systemie numeracji.

KSeF nada dokumentowi dodatkowo własny, unikalny identyfikator. Ministerstwo Finansów wyraźnie wskazuje, że numer KSeF i numer faktury nadawany w ramach firmowej serii to dwa różne numery.

Jak upewnić się, że faktura została przyjęta?

Najlepszym potwierdzeniem jest możliwość ustalenia:

UPO jest formalnym potwierdzeniem przyjęcia dokumentu przez KSeF. Jednocześnie nie ma obowiązku pobierania i samodzielnego archiwizowania UPO KSeF.

Co oznacza status „odrzucona przez KSeF”?

To status wymagający reakcji.

Jeżeli dokument nie przejdzie weryfikacji, KSeF go odrzuci. W takim przypadku nie zostaje mu nadany numer KSeF.

Ministerstwo Finansów wskazuje wprost, że jeżeli przesłany XML zawiera błędy – na przykład nie zostały wypełnione pola wymagane przez strukturę logiczną – dokument zostaje odrzucony. Przy negatywnej weryfikacji system nie nadaje numeru KSeF i należy poprawić dane oraz ponowić wysyłkę.

To bardzo istotne:

odrzucona faktura nie powinna być traktowana tak samo jak prawidłowo przyjęta faktura posiadająca numer KSeF.

Dlaczego KSeF może odrzucić fakturę?

Przyczyn może być wiele. Część błędów powinna zostać wykryta przez dobry program do fakturowania jeszcze przed rozpoczęciem wysyłki.

Do typowych problemów należą:

Od 1 lutego 2026 r. dla e-Faktur stosowana jest struktura logiczna FA(3). KSeF weryfikuje zgodność przesyłanych dokumentów z wymaganiami systemu.

Czy KSeF może wykryć duplikat faktury?

Tak.

KSeF 2.0 posiada mechanizmy weryfikujące ponowne przesłanie tej samej faktury. Ministerstwo Finansów wskazuje, że system nie powinien przyjąć po raz drugi tego samego dokumentu.

Dokumentacja techniczna KSeF przewiduje między innymi komunikat dotyczący duplikatu faktury wraz z możliwością wskazania numeru KSeF dokumentu, który został wcześniej prawidłowo przesłany.

Jest to jeden z powodów, dla których nie należy ponawiać wysyłki tylko dlatego, że na wynik pierwszej operacji trzeba chwilę poczekać.

Czy odrzuconą fakturę trzeba korygować?

Nie należy automatycznie zakładać, że konieczna jest faktura korygująca.

Jeżeli dokument został odrzucony na etapie weryfikacji i nie został skutecznie przyjęty do KSeF, należy przede wszystkim poprawić przyczynę błędu i ponowić prawidłową wysyłkę.

Inaczej wygląda sytuacja, gdy faktura została już skutecznie przyjęta i otrzymała numer KSeF.

Takiego dokumentu nie można po prostu edytować lub usunąć z KSeF. Jeśli dane wymagają zmiany, co do zasady należy wystawić odpowiednią fakturę korygującą. Ministerstwo Finansów wskazuje, że po przesłaniu e-Faktury do KSeF i nadaniu jej numeru identyfikującego nie jest możliwe jej zwykłe edytowanie ani anulowanie w systemie.

Co oznacza numer KSeF?

Numer KSeF jest unikalnym identyfikatorem nadawanym dokumentowi przez Krajowy System e-Faktur.

Nie należy go mylić z:

To szczególnie ważne przy diagnozowaniu problemów.

Program do fakturowania może najpierw otrzymać numer referencyjny pozwalający śledzić operację, a dopiero po pozytywnym zakończeniu procesu – numer KSeF właściwej faktury.

Numer referencyjny nie jest więc dowodem, że dokument został już zaakceptowany.

Co to jest UPO w KSeF?

UPO, czyli Urzędowe Poświadczenie Odbioru, potwierdza przyjęcie dokumentu przez system.

Może zawierać między innymi:

Dokumentacja Ministerstwa Finansów wskazuje również, że data przyjęcia jest związana z datą nadania numeru KSeF.

Dla użytkownika programu do fakturowania oznacza to, że nie powinien być zmuszony do ręcznego analizowania technicznych komunikatów API. Oprogramowanie może automatycznie pobierać status i prezentować prostą informację, np. „Przyjęta przez KSeF”.

Czy status KSeF oznacza, że klient otrzymał fakturę?

W przypadku faktur przekazywanych nabywcy za pośrednictwem KSeF przydzielenie numeru KSeF ma znaczenie również dla momentu ich otrzymania.

Ministerstwo Finansów wskazuje, że faktura przyjęta do systemu i posiadająca numer KSeF jest automatycznie dostępna po stronie nabywcy, jeżeli w dokumencie znajduje się jego NIP. Co do zasady faktura ustrukturyzowana jest uznawana za otrzymaną przy użyciu KSeF w dniu przydzielenia jej numeru KSeF.

Istnieją jednak wyjątki, między innymi dotyczące faktur udostępnianych określonym nabywcom poza KSeF, dlatego nie należy sprowadzać wszystkich przypadków do jednej zasady.

Status KSeF a status płatności – to nie jest to samo

To jedna z najczęstszych rzeczy, które mogą wprowadzać przedsiębiorców w błąd.

KSeF nie stwierdza, że faktura została opłacona tylko dlatego, że ją przyjął.

Przykładowo:

Faktura może więc mieć status „przyjęta w KSeF”, a jednocześnie pozostawać nieopłacona przez 30 dni.

To nie jest sprzeczność.

Co z fakturą wystawianą w trybie offline24?

KSeF przewiduje również szczególne tryby wystawiania faktur.

Jednym z nich jest offline24, z którego podatnik może skorzystać między innymi w przypadku problemów z dostępem do Internetu, ale rozwiązanie nie jest ograniczone wyłącznie do sytuacji awaryjnych.

W takim przypadku faktura powstaje w odpowiedniej postaci elektronicznej poza bieżącą komunikacją online z KSeF, a następnie powinna zostać przesłana do systemu – zasadniczo nie później niż w następnym dniu roboczym po jej wystawieniu.

Dlatego status typu:

„offline – oczekuje na wysłanie do KSeF”

nie musi oznaczać błędu. Informuje raczej, że proces obsługi dokumentu nie został jeszcze zakończony i faktura powinna zostać dosłana do systemu zgodnie z zasadami właściwymi dla danego trybu.

KSeF rozróżnia tryb online oraz techniczny tryb offline, obejmujący między innymi offline24, okres niedostępności systemu oraz tryb awaryjny.

Czy faktura w KSeF może długo nie mieć numeru KSeF?

Może wystąpić okres pomiędzy wysłaniem dokumentu a jego ostatecznym przetworzeniem.

Dlatego brak numeru KSeF bezpośrednio po kliknięciu „Wyślij” nie musi oznaczać problemu.

Jeżeli jednak dokument przez dłuższy czas pozostaje w statusie przejściowym, warto sprawdzić:

Dobry system do faktur powinien wykonywać te czynności automatycznie i pokazywać użytkownikowi przede wszystkim rezultat, a nie zmuszać go do interpretowania kodów technicznych.

Czy faktura z numerem KSeF może zostać później odrzucona?

Jeżeli faktura została prawidłowo przyjęta i nadano jej numer KSeF, mamy do czynienia z dokumentem znajdującym się już w systemie.

Nie należy mylić tego z sytuacją, w której program posiada jedynie numer referencyjny operacji i nadal oczekuje na zakończenie przetwarzania.

Właśnie dlatego przy integracji programów księgowych z KSeF warto przechowywać oddzielnie:

Jak program do fakturowania powinien prezentować status KSeF?

Z punktu widzenia przedsiębiorcy komunikaty powinny być przede wszystkim zrozumiałe.

Zamiast wyświetlać wyłącznie kod techniczny, program może pokazać na przykład:

Przyjęta przez KSeF
Faktura została prawidłowo przyjęta. Numer KSeF: …

albo:

KSeF przetwarza fakturę
Dokument został wysłany. Oczekujemy na potwierdzenie przyjęcia. Nie wysyłaj go ponownie.

W przypadku błędu:

Faktura odrzucona przez KSeF
Dokument nie został przyjęty. Sprawdź wskazany błąd, popraw dane i ponów wysyłkę.

Takie komunikaty są znacznie bardziej użyteczne niż sam kod odpowiedzi API.

Jakich statusów warto pilnować?

W codziennej pracy najważniejsze są trzy sytuacje.

1. Faktura czeka na przetworzenie

Nie należy jej od razu wysyłać ponownie. Najpierw trzeba sprawdzić rezultat pierwszej wysyłki.

2. Faktura została przyjęta

Powinna otrzymać numer KSeF. Dokument został skutecznie obsłużony przez system.

3. Faktura została odrzucona

Trzeba poznać przyczynę błędu, poprawić dokument lub problem techniczny i wykonać właściwą operację ponownie.

W praktyce właśnie takie uproszczenie jest najbardziej użyteczne dla przedsiębiorcy.

Najważniejsza zasada: szukaj numeru KSeF, nie tylko statusu „wysłano”

W KSeF warto przyjąć jedną prostą zasadę:

„Wysłana” nie musi jeszcze oznaczać „przyjęta”.

Dopiero pozytywne przetworzenie dokumentu i nadanie numeru KSeF daje jasną informację, że system przyjął e-Fakturę.

Jeżeli faktura została odrzucona, należy ustalić przyczynę problemu. Jeżeli nadal jest przetwarzana – najczęściej należy poczekać. Jeżeli ma numer KSeF – dokument został przyjęty do systemu.

Takie rozróżnienie pozwala uniknąć zarówno przeoczenia błędnej faktury, jak i przypadkowego wielokrotnego wysyłania tego samego dokumentu.

FAQ – status faktury w KSeF

Czy status „wysłana do KSeF” oznacza, że faktura została wystawiona?

Nie należy utożsamiać samego wysłania pliku z jego pozytywnym przyjęciem przez KSeF. Po wysłaniu dokument jest jeszcze przetwarzany. Kluczowe jest uzyskanie informacji o jego przyjęciu i nadaniu numeru KSeF.

Co oznacza status „przetwarzanie w KSeF”?

KSeF otrzymał dokument, ale nie zakończył jeszcze jego obsługi. Zwykle należy poczekać na wynik, zamiast ponownie wysyłać tę samą fakturę.

Co oznacza status „przyjęta przez KSeF”?

Dokument został zaakceptowany przez system i otrzymał numer KSeF. Numer ten jednoznacznie identyfikuje fakturę w Krajowym Systemie e-Faktur.

Co oznacza status „odrzucona”?

KSeF nie zaakceptował dokumentu. W przypadku negatywnej weryfikacji numer KSeF nie jest nadawany. Należy sprawdzić komunikat błędu, poprawić przyczynę problemu i odpowiednio ponowić wysyłkę.

Czy odrzucona faktura ma numer KSeF?

Nie. Numer KSeF jest nadawany po przyjęciu faktury przez system.

Czy numer referencyjny jest numerem KSeF?

Nie. Numer referencyjny służy do identyfikacji określonej operacji lub wysyłki. Numer KSeF identyfikuje konkretną przyjętą fakturę.

Czy UPO trzeba przechowywać?

Ministerstwo Finansów wskazuje, że nie ma obowiązku pobierania i archiwizowania UPO KSeF.

Czy przyjętą fakturę można usunąć z KSeF?

Nie można po prostu usunąć lub edytować prawidłowo wystawionej e-Faktury, która została przyjęta do systemu i otrzymała numer KSeF. Jeżeli wymaga zmiany, stosuje się odpowiednie zasady korygowania dokumentów.

Czy KSeF sprawdza, czy faktura została opłacona?

Status przyjęcia dokumentu przez KSeF nie jest statusem płatności. Informację o rozliczeniu należności prowadzi program księgowy, system do fakturowania lub inny system przedsiębiorcy.

Czy KSeF może odrzucić ponownie wysłaną tę samą fakturę?

Tak. KSeF 2.0 posiada mechanizmy wykrywania duplikatów, dlatego przy przedłużającym się przetwarzaniu nie należy automatycznie wysyłać dokumentu drugi raz.

Jaki status faktury jest najważniejszy dla przedsiębiorcy?

Najważniejsza jest informacja, że dokument został przyjęty przez KSeF i otrzymał numer KSeF. Sam status „wysłano” oznacza jedynie wcześniejszy etap całego procesu.