Faktura „wisi" w KSeF — jak sprawdzić status i co zrobić

ten artykuł pokazuje, jak rozpoznać, czy faktura faktycznie dotarła do KSeF, czy tylko „poszła" z Twojego programu. Wyjaśniamy różnicę między numerem referencyjnym a numerem KSeF, opisujemy trzy stany, w których może być dokument, pokazujemy, gdzie sprawdzić status (w programie i w darmowej Aplikacji Podatnika KSeF) i — co najważniejsze — kiedy ponowić wysyłkę, a kiedy tego nie robić, żeby nie narobić bałaganu.

7 min czytania 102 wyświetleń
Faktura „wisi" w KSeF — jak sprawdzić status i co zrobić

Znasz ten moment: klikasz „Wyślij", program pokazuje „wysłano", a obok nie ma numeru KSeF. Faktura wisi. Klient czeka, Ty nie wiesz, czy dokument jest już w systemie, czy utknął gdzieś po drodze — i czy bezpiecznie jest go wysłać jeszcze raz.

Od 2026 r. to już nie jest pytanie teoretyczne. KSeF jest obowiązkowy, a od 1 stycznia 2027 r. wchodzą sankcje za niewystawienie faktury w systemie (art. 106ni ustawy o VAT). „Czy ta faktura na pewno weszła do KSeF?" przestaje być kwestią spokoju, a staje się kwestią rozliczeń.

Poniżej pokażę, jak sprawdzić status faktury w KSeF krok po kroku, jak odczytać, na jakim etapie utknął dokument, i jak podjąć decyzję zamiast nerwowo klikać „Wyślij ponownie".

Wysłana to nie to samo co przyjęta

Największe nieporozumienie w całym temacie: wysłanie pliku ≠ przyjęcie faktury. To dwa różne zdarzenia i często mylą je nawet osoby, które pracują w KSeF od miesięcy.

Kiedy wysyłasz dokument, system nadaje numer referencyjny — identyfikator samej wysyłki (sesji online lub paczki wsadowej). Pozwala on śledzić status i pobrać potwierdzenie, ale nie jest numerem KSeF faktury.

Numer KSeF pojawia się dopiero po weryfikacji i przyjęciu pliku. System sprawdza uprawnienia osoby wysyłającej oraz kompletność pól wymaganych przez schemat FA(3); jeśli wszystko się zgadza — faktura zostaje przyjęta i automatycznie dostaje unikalny numer identyfikujący ją w systemie. Dopiero faktura z numerem KSeF jest uznana za wystawioną w rozumieniu przepisów.

Druga rzecz, o której łatwo zapomnieć: KSeF nie wysyła powiadomień. To Twój program musi regularnie sprawdzać status. Jeśli więc widzisz „wysłano" i ciszę — to nie znaczy, że coś się zepsuło. To znaczy, że ktoś (Ty albo Twoje narzędzie) musi dopytać system o wynik.

Trzy stany, w których może być Twoja faktura

Kiedy faktura „wisi", w praktyce jest w jednym z trzech stanów:

Stan Co widzisz Co to znaczy W trakcie przetwarzania Numer referencyjny jest, numeru KSeF nie ma Wysyłka dotarła, system jeszcze jej nie domknął. Najczęściej kwestia sekund, przy obciążeniu — dłużej Przyjęta Jest numer KSeF, dostępne UPO Sukces. Dokument jest w obiegu prawnym, można go zaksięgować Odrzucona Brak numeru KSeF, jest komunikat o błędzie Walidacja się nie powiodła. Faktura formalnie nie istnieje — trzeba poprawić błąd i wysłać ponownie

Czwarta sytuacja jest ukryta: czasem nie ma nawet numeru referencyjnego. Wtedy wysyłka w ogóle nie doszła do KSeF (np. sesja wygasła albo zerwało połączenie) i dokument trzeba po prostu wysłać od nowa.

Klucz brzmi: dopóki nie odczytasz, w którym z tych stanów jest faktura, nie wiesz, co robić. Dlatego pierwszy krok to zawsze sprawdzenie statusu, a nie ponowna wysyłka.

Jak sprawdzić, czy faktura jest w KSeF

1. W swoim programie do fakturowania

Najpierw najprostsza droga. W większości programów numer KSeF ląduje w polu typu „Numer KSeF", „ID KSeF" albo w historii zdarzeń dokumentu. Jeśli widzisz tam numer i status „zaakceptowano" — sprawa zamknięta, możesz pobrać UPO.

Jeśli status to „oczekuje na przetworzenie" lub „wysłane / nie odebrano UPO", użyj funkcji odświeżenia statusu (różnie nazywanej: „Sprawdź status KSeF", „Odbierz dane z KSeF"). Program odpyta system na podstawie numeru referencyjnego i — jeśli numer KSeF został już nadany — zaciągnie go automatycznie.

2. W Aplikacji Podatnika KSeF (darmowe narzędzie MF)

Ministerstwo Finansów udostępnia bezpłatną Aplikację Podatnika KSeF 2.0 (wersja webowa pod ap.ksef.mf.gov.pl oraz aplikacja mobilna). Po zalogowaniu we własnym kontekście zobaczysz listę faktur wysłanych w ramach Twojej firmy i pobierzesz UPO.

Jest też przydatna opcja anonimowego wyszukiwania faktury — bez logowania, po podaniu numeru KSeF i kilku cech dokumentu. Uwaga: anonimowe wyszukiwanie wymaga, żebyś już miał numer KSeF, więc sprawdzi się raczej do potwierdzenia konkretnej, znanej faktury (np. tej od kontrahenta) niż do odnalezienia tej, która właśnie utknęła bez numeru.

3. Mini-przykład (ilustracyjny — podmień na realne dane, jeśli masz)

Biuro rachunkowe wysyła wsadowo paczkę 40 faktur klienta. Po wysyłce paczka ma numer referencyjny, ale 3 dokumenty nie mają jeszcze numeru KSeF. Zamiast wysyłać te 3 ponownie, księgowa odświeża status paczki: 2 faktury domknęły się po kilkudziesięciu sekundach, a 1 została odrzucona z błędem niepoprawnego NIP nabywcy. Wniosek: tylko ta jedna wymaga poprawy i ponownej wysyłki — pozostałe 39 jest już w KSeF.

Co zrobić, gdy faktura wisi — decyzja zamiast paniki

Najgorsze, co możesz zrobić, to w ciemno kliknąć „Wyślij ponownie" kilka razy. Automatyczne ponawianie bez sprawdzenia statusu zwiększa bałagan i utrudnia później ustalenie, który dokument jest tym właściwym. Zamiast tego:

  1. Sprawdź status (jednym z trzech sposobów powyżej). To zawsze pierwszy ruch.

  2. Jest „w trakcie"? Poczekaj i odśwież po 1–2 minutach. Numer KSeF zwykle pojawia się szybko, ale przy dużym obciążeniu systemu trzeba dać mu chwilę.

  3. Jest numer KSeF? Gotowe. Zapisz numer KSeF, pobierz UPO (albo upewnij się, że program zrobił to automatycznie) i uznaj dokument za domknięty.

  4. Faktura odrzucona? Numer KSeF się nie pojawi — popraw błąd wskazany w komunikacie i wyślij poprawiony dokument. To nie jest duplikat, bo poprzednia wersja nigdy nie weszła do systemu.

  5. Wysłałeś ponownie i dostałeś „Duplikat faktury"? To dobra wiadomość: oznacza, że pierwsza wysyłka jednak dotarła do KSeF. Odszukaj numer KSeF z tego pierwotnego dokumentu i przypisz go do faktury — nie masz dwóch faktur, masz jedną przyjętą.

Ta jedna zasada — najpierw status, potem działanie — oszczędza najwięcej nerwów i porządkuje archiwum.

Jak to wygląda, gdy robi to za Ciebie system

Dobre narzędzie zdejmuje z Ciebie cały ten taniec ze statusami. W Biurko każda wysyłka przechodzi przez automatyczny cykl: QUEUED → SUBMITTED → PROCESSING → ACCEPTED / REJECTED. System sam odpytuje KSeF i tłumaczy surowe kody przetwarzania na ludzki język:

200          → przyjęta, nadano numer KSeF
100–399      → w trakcie (w kolejce / weryfikacja / oczekiwanie na UPO)
400 i więcej → odrzucona (błąd semantyczny, biznesowy lub infrastruktury)
440          → „Duplikat faktury" — dokument już jest w KSeF

Numer KSeF i UPO są pobierane automatycznie (UPO bywa dostępne kilka sekund po przyjęciu — Biurko ponawia próby), a faktury, które wymagają uwagi — np. odrzucone albo z nietypowym wynikiem — lądują w osobnym koszyku „do sprawdzenia", zamiast wisieć bez wyjaśnienia. Zamiast pytać „czy ta faktura weszła?", widzisz odpowiedź od razu. To, co wyżej trzeba robić ręcznie, dzieje się w tle.

Checklist: faktura wisi — co zrobić

  • Nie ponawiaj wysyłki w ciemno. Najpierw sprawdź status.

  • Odróżnij numer referencyjny od numeru KSeF. Pierwszy dotyczy wysyłki, drugi — faktury.

  • Odśwież status w programie albo zaloguj się do Aplikacji Podatnika KSeF i sprawdź dokument.

  • „W trakcie"? Poczekaj 1–2 min i sprawdź ponownie.

  • Jest numer KSeF? Zapisz go i pobierz UPO — dopiero teraz dokument jest domknięty.

  • Odrzucona? Popraw błąd z komunikatu i wyślij ponownie (to nie duplikat).

  • „Duplikat" po ponowieniu? Pierwsza wysyłka się udała — odzyskaj numer KSeF z oryginału.

Podsumowanie

Faktura, która „wisi", to prawie zawsze jeden z trzech stanów: jest przetwarzana, została przyjęta albo została odrzucona. Cała sztuka polega na tym, żeby odczytać który — zamiast zgadywać i wysyłać dokument po raz piąty. Numer KSeF i UPO to Twoje twarde potwierdzenia; numer referencyjny to dopiero ślad wysyłki.

W Biurko status każdej faktury jest widoczny od razu, kody KSeF tłumaczymy na zrozumiałe komunikaty, a UPO pobiera się samo. Sprawdź 14-dniowy darmowy okres próbny na biurko.io i przestań zgadywać, czy faktura dotarła.


FAQ

Skąd wiem, że faktura na pewno weszła do KSeF? Po nadanym numerze KSeF i dostępnym UPO. Numer KSeF to unikalny identyfikator nadawany fakturze dopiero po jej przyjęciu i weryfikacji. Sam status „wysłano" lub numer referencyjny tego nie potwierdzają — to dopiero ślad wysyłki, nie dowód przyjęcia.

Czy faktura bez numeru KSeF jest ważna? Nie. Dopóki faktura nie dostanie numeru KSeF, w świetle przepisów nie została wystawiona. Jeśli numer się nie pojawia, dokument jest albo wciąż przetwarzany, albo został odrzucony — w drugim przypadku trzeba poprawić błąd i wysłać go ponownie.

Faktura wisi w KSeF od kilku minut — wysyłać ponownie? Najpierw odśwież status. Numer KSeF zwykle pojawia się szybko, ale przy dużym obciążeniu systemu może to chwilę potrwać. Ponowna wysyłka w ciemno tworzy ryzyko bałaganu; jeśli pierwotna wysyłka się udała, druga zwróci komunikat o duplikacie.

Co oznacza „Duplikat faktury" przy wysyłce do KSeF? Że ta faktura już jest w systemie — najpewniej z wcześniejszej, udanej wysyłki, o której nie wiedziałeś. To nie błąd do naprawienia: wystarczy odszukać numer KSeF tego pierwotnego dokumentu i przypisać go do faktury. Nie masz dwóch faktur, tylko jedną przyjętą.

Gdzie sprawdzić status faktury, jeśli nie ufam swojemu programowi? W darmowej Aplikacji Podatnika KSeF 2.0 (wersja webowa lub mobilna) udostępnianej przez Ministerstwo Finansów. Po zalogowaniu zobaczysz faktury wystawione w ramach Twojej firmy i pobierzesz UPO. Dostępne jest też anonimowe wyszukiwanie faktury po numerze KSeF.

Tagi

#KSeF
Udostępnij

Poprzedni artykuł

Okres przejściowy KSeF: obowiązek już jest, kary od 2027

Następny artykuł

5 mitów o KSeF, w które wciąż wierzą przedsiębiorcy w 2026 roku

Bądź na bieżąco

Otrzymuj powiadomienia o nowych artykułach. Bez spamu, rezygnacja w każdej chwili.

Szanujemy Twoją prywatność. Możesz zrezygnować w dowolnym momencie.

Pliki cookies

Używamy plików cookies, aby zapewnić działanie usługi i — za Twoją zgodą — usprawnić ją. Możesz zaakceptować wszystkie, odrzucić opcjonalne lub dostosować wybór. Polityka cookies