Numer KSeF i uwierzytelnianie - jak działa identyfikacja faktur

Numer KSeF a numer Twojej faktury

W Krajowym Systemie e-Faktur funkcjonują dwa różne numery, które łatwo pomylić. Pierwszy to numer faktury z Twojej własnej numeracji sprzedaży, na przykład FV/2026/06/001. Drugi to numer KSeF, który system nadaje automatycznie w chwili przyjęcia dokumentu.

Numer KSeF jest unikalny w skali całego kraju. Zawiera NIP wystawcy, datę oraz ciąg znaków kontrolnych. To on jednoznacznie identyfikuje fakturę w systemie i służy do jej odszukania, pobrania oraz powiązania z korektami.

Dopóki faktura nie otrzyma numeru KSeF, traktuje się ją jak dokument, który nie został jeszcze skutecznie wprowadzony do systemu. Dlatego w sklepie internetowym kluczowe jest, aby proces wysyłki kończył się odebraniem numeru KSeF, a nie tylko przygotowaniem pliku.

Jak nadawany jest numer KSeF

Sekwencja wygląda podobnie niezależnie od tego, czy fakturę wysyła człowiek, czy system fakturowy w tle:

• Wystawca tworzy fakturę w ustrukturyzowanym formacie XML zgodnym ze schemą.
• Plik trafia do KSeF przez interfejs systemu fakturowego lub aplikacji KSeF.
• System weryfikuje strukturę i poprawność danych.
• Po pozytywnej weryfikacji faktura otrzymuje numer KSeF.
• System zwraca UPO, czyli potwierdzenie przyjęcia.

Jeśli weryfikacja się nie powiedzie, faktura nie dostaje numeru KSeF i wraca informacja o błędzie. To dlatego poprawność danych nabywcy i zgodność ze strukturą pliku są tak istotne. Więcej o budowie pliku znajdziesz w artykule o strukturze e-faktury FA(3).

UPO, czyli dowód przyjęcia faktury

UPO (Urzędowe Poświadczenie Odbioru) to elektroniczne potwierdzenie, że faktura została przyjęta i otrzymała numer KSeF. Pełni rolę dowodu, że dokument skutecznie trafił do systemu w danym dniu i o danej godzinie.

W praktyce warto archiwizować UPO razem z fakturą, podobnie jak kiedyś przechowywało się potwierdzenia nadania. Jeśli kontrahent lub urząd zapyta, czy faktura jest w systemie, UPO i numer KSeF są najprostszą odpowiedzią.

Przy dużej liczbie zamówień ręczne pilnowanie UPO przestaje być realne. Dlatego dobrze, gdy proces fakturowania jest zautomatyzowany, a status wysyłki KSeF razem z numerem i UPO wraca do Twojego systemu sprzedaży.

Metody uwierzytelnienia w KSeF

Żeby wysłać fakturę do KSeF, trzeba potwierdzić tożsamość i uprawnienia. System dopuszcza kilka metod:

• Podpis kwalifikowany - elektroniczny podpis przypisany do osoby fizycznej, najczęściej do logowania przez człowieka.
• Profil Zaufany - wygodny dla jednoosobowej działalności i logowania w przeglądarce.
• Pieczęć kwalifikowana - przypisana do firmy, dobrze sprawdza się w procesach automatycznych.
• Token autoryzacyjny - klucz wygenerowany w aplikacji KSeF, używany przez systemy w tle.

Dla sklepu internetowego, który wystawia faktury masowo, najpraktyczniejsze są token oraz pieczęć. Pozwalają wysyłać faktury bez udziału człowieka przy każdym dokumencie, co jest niezbędne przy dziesiątkach zamówień dziennie.

Token KSeF w automatycznym fakturowaniu

Token to ciąg znaków, który generujesz raz w aplikacji KSeF i nadajesz mu konkretne uprawnienia, na przykład tylko wystawianie faktur. System fakturowy używa tokena w tle, więc nie musisz logować się ręcznie przy każdej sprzedaży.

Token warto traktować jak hasło. Trzymaj go w bezpiecznym miejscu, ogranicz uprawnienia do minimum i rotuj, jeśli istnieje podejrzenie, że wyciekł. Dobra praktyka to osobny token dla każdego procesu, żeby w razie problemu unieważnić tylko jeden.

W konfiguracji, w której zamówienia łączą się z systemem fakturowym, token pozwala domknąć całą ścieżkę. Zamówienie generuje fakturę, system wysyła ją do KSeF tokenem, a w odpowiedzi wraca numer KSeF i UPO.

Co zrobić, gdy wysyłka się nie powiedzie

Czasem faktura nie otrzyma numeru KSeF, bo system odrzuci plik albo wystąpi czasowa niedostępność. Warto mieć wtedy plan działania:

• Sprawdź komunikat błędu i popraw dane lub strukturę faktury.
• Ponów wysyłkę po korekcie i odbierz numer KSeF oraz UPO.
• Przy niedostępności systemu skorzystaj z procedury awaryjnej, którą opisujemy w tekście o trybie offline i awarii KSeF.
• Monitoruj kolejkę nieudanych wysyłek, żeby żadna faktura nie utknęła bez numeru.

Mechanizm monitoringu i ponawiania jest szczególnie ważny w e-commerce, gdzie klient oczekuje faktury szybko, a liczba dokumentów jest duża. Cały temat wdrożenia KSeF od strony sklepu opisujemy szerzej w przewodniku po e-fakturach w e-commerce.

Najważniejsze wnioski

Numer KSeF to identyfikator nadawany przez system, a nie Twój numer faktury z numeracji sprzedaży. UPO potwierdza, że faktura została przyjęta. Do wysyłki potrzebne jest uwierzytelnienie, a w automatycznym fakturowaniu najlepiej sprawdzają się token i pieczęć kwalifikowana.

Jeśli połączysz sprzedaż z systemem fakturowym, który obsługuje KSeF, numer KSeF i UPO będą wracać do Twojego systemu automatycznie, bez ręcznego logowania przy każdym zamówieniu.

Ten artykuł ma charakter informacyjny i nie stanowi porady podatkowej ani prawnej. Szczegóły rozliczeń i konfiguracji KSeF skonsultuj ze swoim księgowym lub doradcą podatkowym.

Najczesciej zadawane pytania