„Wysłana” to nie „przyjęta”: trzy stany faktury
W obiegu papierowym proces kończył się na wygenerowaniu PDF. W KSeF trzeba rozróżniać trzy stany dokumentu:
Przygotowana — masz gotowy XML, ale nie wyszedł jeszcze z Twojego systemu.
Wysłana — plik dotarł do bramki KSeF i czeka na weryfikację. Nic jeszcze nie jest przesądzone.
Przyjęta — faktura przeszła walidację, dostała numer KSeF i można pobrać UPO. Dopiero to oznacza, że dokument został wystawiony w systemie.
Najbardziej ryzykowna postawa to założenie „skoro plik wyszedł, to faktura jest”. Trzeci stan trzeba potwierdzić, a nie zakładać.
Numer KSeF: najmocniejszy sygnał, że faktura jest w systemie
Numer KSeF nadaje system automatycznie po pozytywnej weryfikacji pliku. Jego obecność to najprostszy dowód, że faktura została przyjęta. Wygląda mniej więcej tak:
0123456789-20260507-1A2B3C4D5E6F-FF
To NIP wystawcy, data, techniczny identyfikator i suma kontrolna. Ten numer wiąże dokument z KSeF na stałe, a korekty i faktury zaliczkowe odwołują się właśnie do niego.
Uwaga na najczęstsze pomylenie: numer referencyjny sesji to nie numer KSeF. Numer sesji opisuje operację techniczną wysyłki (przy wysyłce wsadowej mówimy o numerze referencyjnym paczki). Numer KSeF identyfikuje konkretną fakturę. Jeżeli w potwierdzeniu widzisz tylko numer sesji, dokument nie ma jeszcze numeru KSeF, czyli nie został jeszcze przyjęty.
Warto też zestawić numer własny faktury z pola P_2 z numeracją używaną w firmie. Numer KSeF i numer P_2 to dwie różne wartości, które muszą pasować do tego samego dokumentu.
UPO: urzędowy dowód przyjęcia
UPO (Urzędowe Poświadczenie Odbioru) to dokument generowany przez KSeF po przyjęciu faktury. To nie jest ogólny komunikat „udało się”. UPO zawiera konkretne dane: numer KSeF, numer faktury z pola P_2, numer referencyjny wysłanego zbioru oraz datę i godzinę przyjęcia dokumentu przez system.
Ta data ma znaczenie prawne. Zgodnie z art. 106na ust. 1 ustawy o VAT datą wystawienia faktury ustrukturyzowanej jest data jej przesłania do KSeF (Podręcznik KSeF 2.0, cz. II). UPO jest więc dowodem, że wysłałeś fakturę w terminie. Pełny opis pól potwierdzenia publikuje MF w dokumencie UPO KSeF.
Pobieranie UPO dla każdej faktury nie jest codziennym obowiązkiem, bo MF przechowuje dokumenty w KSeF przez 10 lat i potwierdzenie można wygenerować ponownie, dopóki faktura ma numer KSeF. Przydaje się jednak zawsze wtedy, gdy trzeba udowodnić termin lub fakt wystawienia, na przykład w razie wątpliwości organu.
Gdzie sprawdzić status krok po kroku
Sposób zależy od tego, czym wysyłasz faktury.
W programie do faktur. Większość narzędzi pokazuje status przy dokumencie, zwykle jako kolorowy znacznik: oczekująca, przyjęta, odrzucona. Dobre programy odpytują KSeF w tle co kilkanaście sekund i same pobierają numer KSeF oraz UPO, gdy tylko się pojawią. Jeżeli faktura wisi jako „oczekująca”, użyj funkcji ponownego sprawdzenia statusu, zamiast wysyłać ją drugi raz.
Przez Rządową Aplikację Podatnika KSeF 2.0. Zaloguj się na ksef.podatki.gov.pl Profilem Zaufanym lub podpisem kwalifikowanym, wyszukaj fakturę i sprawdź, czy ma numer KSeF. Nazwy przycisków bywają aktualizowane, więc zawsze warto porównać ścieżkę z bieżącym ekranem aplikacji.
Sam status opisuje trzycyfrowy kod z bramki:
200 — faktura przyjęta, numer KSeF nadany.
100–150 — dokument nadal jest przetwarzany. Poczekaj i sprawdź ponownie.
400 i wyżej — odrzucenie. Faktura nie dostanie numeru KSeF ani UPO.
Co zrobić, gdy UPO nie ma
Brak UPO nie ma jednej przyczyny. Dokument może być nadal przetwarzany, sesja może nie być zamknięta, potwierdzenie może jeszcze się nie pobrać albo faktura mogła zostać odrzucona. Pierwsza reakcja to zawsze sprawdzenie statusu, a nie ponowna wysyłka.
Automatyczne wysłanie tego samego pliku drugi raz bez sprawdzenia statusu grozi utworzeniem duplikatu i utrudnia ustalenie, która operacja była pierwotna.
Kolejność jest prosta:
Odśwież status faktury albo sesji.
Jeśli jest numer KSeF, ale nie ma potwierdzenia, pobierz UPO ponownie.
Jeśli status to błąd (kod z grupy 400), odczytaj kod, popraw źródło problemu i dopiero wtedy wyślij poprawny XML.
Jeśli dokument nadal się przetwarza, monitoruj tę samą wysyłkę, nie twórz nowej.
Szybka checklista
Faktura ma nadany numer KSeF (nie mylić z numerem referencyjnym sesji).
Status wysyłki to 200, a nie 100–150 czy 4xx.
UPO jest pobrane albo dostępne do pobrania.
Numer P_2 z faktury zgadza się z numerem w Twoim systemie.
Data przyjęcia jest zapisana (dowód terminowości).
Dokumenty bez UPO trafiają na osobną listę do wyjaśnienia, nie do ponownej wysyłki w ciemno.
Podsumowanie
Faktura jest w KSeF dopiero wtedy, gdy ma numer KSeF i UPO. Wszystko wcześniej to stan przejściowy, a poleganie na samym „wysłano” prędzej czy później kończy się szukaniem dokumentu, który nigdy nie został przyjęty.
W Biurko ten cały cykl dzieje się w tle: po wysyłce system sam odpytuje KSeF o status, pobiera UPO i weryfikuje jego podpis względem certyfikatu Ministerstwa Finansów. Jeśli potwierdzenie nie dojdzie albo podpis się nie zgadza, faktura trafia do statusu „do sprawdzenia”, zamiast fałszywie świecić na zielono. Załóż darmowe konto na biurko.io i przestań zgadywać, czy faktura poszła.
FAQ
Skąd wiem, że faktura na pewno trafiła do KSeF? Po nadanym numerze KSeF i dostępnym UPO. Sam komunikat „wysłano” oznacza tylko, że plik dotarł do bramki. Dopóki nie ma numeru KSeF, faktura nie została przyjęta i nie jest jeszcze wystawiona w systemie.
Czym różni się numer KSeF od numeru referencyjnego sesji? Numer referencyjny sesji (lub paczki) opisuje operację wysyłki. Numer KSeF identyfikuje konkretną fakturę i powstaje dopiero po jej przyjęciu. Do rozliczeń i korekt służy numer KSeF, nie numer sesji.
Wysłałem fakturę, ale nie ma UPO. Wysłać jeszcze raz? Nie od razu. Najpierw sprawdź status. Jeśli dokument się przetwarza (kod 100–150), poczekaj. Jeśli jest błąd (4xx), popraw XML. Ponowna wysyłka bez sprawdzenia statusu grozi duplikatem.
Czy muszę pobierać UPO do każdej faktury? Nie codziennie. MF przechowuje faktury w KSeF przez 10 lat, więc UPO można pobrać ponownie, dopóki faktura ma numer KSeF. Warto je jednak mieć wtedy, gdy trzeba udowodnić termin lub fakt wystawienia.
Gdzie sprawdzić status bez programu do faktur? W Rządowej Aplikacji Podatnika KSeF 2.0 na ksef.podatki.gov.pl, po zalogowaniu Profilem Zaufanym lub podpisem kwalifikowanym. Wyszukujesz fakturę i sprawdzasz, czy ma nadany numer KSeF.