Status wysyłki i UPO

Widok Status wysyłki pozwala sprawdzić stan przetwarzania faktur wysłanych do KSeF oraz pobrać UPO (Urzędowe Poświadczenie Odbioru) dla pomyślnie przetworzonych faktur.

Dostęp do widoku

Przejdź do strony Status wysyłki z menu bocznego. Strona zawiera dwie główne sekcje:

1. Sprawdź status wysyłki — zapytanie do KSeF o status konkretnej wysyłki
2. Pobierz UPO — pobranie urzędowego poświadczenia dla przetworzonej faktury

Sprawdzanie statusu wysyłki

Aby sprawdzić status wysyłki faktury:

1. Wprowadź Numer referencyjny — jest to numer referencyjny sesji zwrócony podczas wysyłania faktury
2. Wybierz Typ wysyłki:
   • Online — dla pojedynczych faktur wysłanych bezpośrednio
   • Paczka (batch) — dla paczek faktur offline
3. Kliknij Sprawdź status

Odpowiedź zawiera:

• Kod przetwarzania — informuje czy KSeF zakończył przetwarzanie (200 = zakończone)
• Opis przetwarzania — czytelny komunikat statusu
• Lista faktur — wszystkie faktury w sesji z numerami KSeF, oryginalnymi numerami faktur i znacznikami czasu przyjęcia

Dlaczego lista faktur może być pusta?

Jeśli kod przetwarzania nie jest jeszcze 200, KSeF wciąż przetwarza wysyłkę. Spróbuj ponownie po chwili.

Pobieranie UPO

Po przetworzeniu faktury możesz pobrać jej UPO:

1. Wprowadź Numer referencyjny sesji oraz Numer KSeF faktury
2. Wybierz format dokumentu:
   • XML — oficjalne UPO w formacie XML
   • PDF — wersja UPO do wydruku w formacie PDF
3. Kliknij Pobierz

Plik UPO zostanie pobrany na Twoje urządzenie.

Czym jest UPO?

UPO (Urzędowe Poświadczenie Odbioru) to oficjalne potwierdzenie z KSeF, że faktura została odebrana i zarejestrowana. Stanowi prawny dowód, że faktura została pomyślnie przesłana do krajowego systemu e-faktur.

Synchronizacja referencji sesji

Synchronizowanie danych sesji

Gdy zaczynasz korzystać z aplikacji, nie wszystkie dane są od razu zsynchronizowane. Faktury wysłane przed wdrożeniem śledzenia sesji (lub przed rozpoczęciem korzystania z aplikacji) mogą nie mieć przypisanego numeru referencyjnego sesji (session_reference_number) w lokalnej bazie danych.

Checkbox „Synchronizuj info o sesji (uzupełnij referencję sesji w lokalnej bazie)" dostępny w formularzu sprawdzania statusu pozwala uzupełnić powiązanie pomiędzy fakturami a sesją wysyłania w lokalnej bazie. Po zaznaczeniu:

• Faktury online (synced_invoices) — wiersze z pasującym numerem KSeF, które nie mają referencji sesji, zostaną zaktualizowane
• Faktury paczki (offline_invoices) — wiersze pasujące do numeru referencyjnego paczki zostaną zaktualizowane

Takie powiązanie wspiera wydajność prezentacji danych w serwisie, ponieważ system może szybko ustalić, do której sesji należy dana faktura, bez ponownego odpytywania KSeF.