Wystawianie faktur

UPO w KSeF: co to jest, co zawiera i gdzie je pobrać

W skrócie

UPO (Urzędowe Poświadczenie Odbioru) to plik XML podpisany przez Ministerstwo Finansów, który KSeF udostępnia po przyjęciu faktury i nadaniu jej numeru KSeF. Pobiera je ten, kto wysłał fakturę – w Aplikacji Podatnika w menu Historia sesji albo w programie przez API – dla jednej faktury lub zbiorczo dla całej sesji. Przepisy nie każą go przechowywać, ale przy fakturach offline warto, bo pokazuje dzień wysłania do KSeF.

Spis treści
  1. Co potwierdza UPO?
  2. Co zawiera UPO?
  3. UPO pojedynczej faktury czy UPO zbiorcze?
  4. Jak pobrać UPO w Aplikacji Podatnika KSeF?
  5. Jak sprawdzić, czy faktura została wysłana do KSeF?
  6. Jak program pobiera UPO przez API?
  7. Czy nabywca dostaje UPO?
  8. Czy UPO trzeba przechowywać?
  9. Czym UPO różni się od numeru KSeF, kodu QR i potwierdzenia transakcji?

UPO, czyli Urzędowe Poświadczenie Odbioru, to plik XML, który KSeF udostępnia, gdy przyjmie fakturę i nada jej numer KSeF – potwierdza, że system odebrał dokument, i podaje m.in. ten numer oraz datę jego nadania. Pobiera je wysyłający fakturę: w Aplikacji Podatnika KSeF w menu „Historia sesji” albo w programie przez API, dla jednej faktury lub zbiorczo dla całej sesji.

Co potwierdza UPO?

Gdy wyślesz do KSeF poprawny plik XML, a masz do tego uprawnienia, status wysyłki to „200”, faktura ma już numer KSeF, a w systemie czeka na ciebie UPO. Według cz. II Podręcznika KSeF 2.0 (pkt 4.2) UPO formalnie poświadcza, że KSeF odebrał dokument elektroniczny. To osobny plik XML, a nie część faktury.

Z tego wynikają trzy praktyczne wnioski:

  • Jest UPO – faktura jest wystawiona. Rozdział podręcznika, w którym MF omawia UPO, nosi tytuł „Potwierdzenie skutecznego wystawienia faktury w KSeF”. Jeśli szukasz „potwierdzenia wystawienia faktury w KSeF”, to właśnie UPO (razem z numerem KSeF).
  • Plik odrzucony – nie ma ani numeru, ani UPO. Przy wysyłce online (np. po błędzie 450) MF podkreśla, że faktura nie została wtedy wystawiona. Co zrobić: kody błędów KSeF.
  • UPO nie jest akceptacją nabywcy. Potwierdza tylko, że system przyjął plik. Nabywca niczego nie zatwierdza.

Faktura wystawiona offline dostaje UPO dopiero po wysłaniu do KSeF i nadaniu numeru.

Co zawiera UPO?

Elementy UPO MF opisuje na grafice „Opis elementów składowych UPO_KSeF” (numery 1–11). Część dotyczy całej wysyłki, część – każdej faktury z osobna.

Nr Element na wizualizacji Element XML (UPO v4-3) Co oznacza
1 Numer referencyjny sesji NumerReferencyjnySesji numer sesji interaktywnej albo paczki przy wysyłce wsadowej
2–3 Typ i identyfikator kontekstu IdKontekstu np. NIP 1111111111 lub identyfikator wewnętrzny, w którym nastąpiło logowanie
4 Numer identyfikujący fakturę w KSeF NumerKSeFDokumentu numer KSeF nadany po weryfikacji pliku
5 Numer faktury NumerFaktury twój numer z pola P_2
6 NIP sprzedawcy NipSprzedawcy NIP z Podmiot1
7 Data wystawienia faktury DataWystawieniaFaktury data z P_1 – w trybach offline to data wystawienia
8 Data przesłania do KSeF DataPrzeslaniaDokumentu w trybie online to data wystawienia, jeśli jest taka sama jak w P_1
9 Data nadania numeru KSeF DataNadaniaNumeruKSeF co do zasady data otrzymania faktury przez nabywcę
10 Wartość funkcji skrótu SkrotDokumentu 256-bitowy skrót pliku faktury (rodzina SHA-2)
11 Tryb wysyłki TrybWysylki online albo offline

W nagłówku UPO są też m.in. skrót dokumentu uwierzytelniającego, nazwa schematu XSD i kod formularza (np. FA (3)) oraz numeracja stron. Tak wygląda uproszczony fragment dla jednej faktury, z wartościami z przykładowego UPO MF:

<Dokument>
  <NipSprzedawcy>1111111111</NipSprzedawcy>
  <NumerKSeFDokumentu>1111111111-20251021-0100405CA640-10</NumerKSeFDokumentu>
  <NumerFaktury>238975623</NumerFaktury>
  <DataWystawieniaFaktury>2025-10-21</DataWystawieniaFaktury>
  <DataPrzeslaniaDokumentu>2025-10-21T11:24:54</DataPrzeslaniaDokumentu>
  <DataNadaniaNumeruKSeF>2025-10-21T11:24:55</DataNadaniaNumeruKSeF>
  <SkrotDokumentu>3XxYDqWALt/c4+EFIFmhFg1sVfLyIV1SIVcDF2TWFWU=</SkrotDokumentu>
  <TrybWysylki>Online</TrybWysylki>
</Dokument>

Data z elementu 9 to dla nabywcy z NIP data otrzymania faktury. Wyjątki, m.in. dla trybu awaryjnego i nabywców z art. 106gb ust. 4, omawiamy w tekście data otrzymania faktury w KSeF.

UPO pojedynczej faktury czy UPO zbiorcze?

UPO faktury UPO zbiorcze (sesji)
Kiedy dostępne po przetworzeniu pliku i nadaniu numeru – także w trakcie otwartej sesji po zamknięciu sesji, gdy wszystkie pliki są przetworzone i co najmniej jeden dostał numer
Co obejmuje jedną fakturę wszystkie poprawnie przyjęte faktury z sesji
Rozmiar jedna pozycja maks. 10 000 faktur na stronie UPO; większe sesje mają kilka stron

Oba rodzaje mają ten sam schemat XML (UPO v4-3, domyślny od 22 grudnia 2025 r.). Sesja interaktywna to wysyłka pojedynczych plików, np. z Aplikacji Podatnika; sesja wsadowa – paczka ZIP z programu.

Jak pobrać UPO w Aplikacji Podatnika KSeF?

  1. Zaloguj się w kontekście firmy, która wysłała faktury.
  2. Otwórz menu „Historia sesji”. Listę zawęzisz filtrami: data nawiązania sesji, numer referencyjny, status, data zamknięcia i typ sesji.
  3. Kliknij wiersz sesji. Zobaczysz „Szczegóły wysyłki” z kolumnami: Nr KSeF, Nr faktury, Data przesłania, Status faktury.
  4. UPO jednej faktury: rozwiń menu kontekstowe przy fakturze i wybierz format pliku.
  5. UPO zbiorcze: rozwiń listę „Pobierz UPO zbiorcze” i wybierz XML albo PDF. Działa tylko dla sesji zakończonej – trwającą zaznaczysz na liście i zamkniesz przyciskiem „Zakończ sesję”.

Według dokumentacji API osoba z samym uprawnieniem do wystawiania faktur widzi tylko sesje, które sama otworzyła. Żeby przeglądać wszystkie sesje firmy – np. gdy księgowa sprawdza wysyłki pracowników – potrzebne jest uprawnienie „przeglądanie historii sesji (generowania UPO)”. Jak je nadać: uprawnienia w KSeF. Podręcznik Aplikacji Mobilnej KSeF (wersja 2.4.0) nie opisuje pobierania UPO, więc po poświadczenie sięgnij do Aplikacji Podatnika. Więcej o samej aplikacji: Aplikacja Podatnika KSeF.

Jak sprawdzić, czy faktura została wysłana do KSeF?

Faktura dotarła do KSeF i jest wystawiona, gdy ma numer KSeF – UPO jest urzędowym potwierdzeniem tego faktu. Do upewnienia się wystarczy sam numer, a UPO przyda się, gdy potrzebujesz dowodu w pliku.

Gdzie sprawdzasz Sukces Problem
Aplikacja Podatnika, ekran po wysyłce komunikat z numerem KSeF i przyciskiem „Kopiuj” informacja o nieudanej wysyłce i przycisk „Popraw fakturę”
Aplikacja Podatnika, „Lista faktur” → „Faktury sprzedażowe” faktura z numerem w kolumnie „Nr KSeF” brak faktury – sprawdź filtr dat (domyślnie 30 dni) i NIP, w którego kontekście się logujesz
Aplikacja Podatnika, „Historia sesji” faktura z numerem KSeF w szczegółach wysyłki liczba większa od zera w kolumnie „Faktury odrzucone”
program połączony z API status faktury 200 i numer KSeF 100 lub 150 – trwa przetwarzanie; inny kod – faktura nie została przyjęta (kody błędów KSeF)
bez logowania: wyszukiwarka w Aplikacji Podatnika albo kod QR faktura do pobrania brak wyniku – faktury nie ma w KSeF albo wpisane dane się nie zgadzają

Anonimowe wyszukiwanie wymaga numeru KSeF, numeru faktury, identyfikatora i nazwy nabywcy oraz kwoty należności ogółem (podręcznik AP, pkt 4.2.1). Plik odrzucony nie jest fakturą – poprawiasz go i wysyłasz ponownie (FAQ, „Wystawianie i otrzymywanie faktur”, pyt. 16).

Nabywca sprawdza, czy kontrahent wysłał fakturę, w zakładce „Faktury zakupowe” – KSeF nie wysyła powiadomień (pyt. 38). W drugą stronę system nie działa: sprzedawca nie dowie się z KSeF, czy nabywca pobrał fakturę (pyt. 39), ale też nie musi – faktura jest otrzymana w dniu nadania numeru.

Jak program pobiera UPO przez API?

Program może pobrać UPO faktury po numerze KSeF (GET /sessions/{referenceNumber}/invoices/ksef/{ksefNumber}/upo) albo po numerze referencyjnym faktury. W odpowiedzi o status faktury KSeF zwraca też link upoDownloadUrl:

  • działa bez tokenu dostępowego i nie podlega limitom API,
  • wygasa w chwili podanej w upoDownloadUrlExpirationDate, ale przy każdym kolejnym sprawdzeniu statusu powstaje nowy,
  • w nagłówku x-ms-meta-hash zwraca skrót SHA-256 pliku UPO.

UPO zbiorcze program pobiera po zamknięciu sesji z listy upo.pages[] w statusie sesji. Plik XML jest podpisany przez Ministerstwo Finansów w formacie XAdES. PDF to jego czytelna wizualizacja – wygeneruje ją Aplikacja Podatnika albo otwarta biblioteka MF ksef-pdf-generator z GitHuba (CIRFMF).

Czy nabywca dostaje UPO?

Nie w KSeF. UPO jest przypisane do sesji wysyłającego, a dokumentacja API wymaga do jego pobrania uprawnień po stronie wystawcy: do wystawiania faktur (InvoiceWrite), do przeglądania historii sesji (Introspection), do wysyłki faktur PEF lub do czynności egzekucyjnych. Nabywca ich w kontekście sprzedawcy nie ma – to nasz wniosek z dokumentacji, MF nie pisze o tym wprost.

Nabywcy UPO nie jest jednak potrzebne. W liście faktur zakupowych widzi numer KSeF i datę otrzymania, a po zeskanowaniu kodu QR – datę nadania numeru. Gdy nabywca mimo to poprosi o UPO, sprzedawca może mu je przesłać np. mailem – przepisy tego nie regulują.

Kto „wysyła”, ten dostaje UPO – także gdy nie jest sprzedawcą. Przy samofakturowaniu fakturę wysyła nabywca, więc to on pobierze UPO (nasza interpretacja). Gdy faktury wysyła biuro rachunkowe w imieniu klienta, w UPO zobaczysz kontekst klienta, czyli jego NIP.

Czy UPO trzeba przechowywać?

Nie. W odpowiedziach na pytania o KSeF 2.0 (sekcja o JST, pyt. 81) MF pisze, że przepisy nie wymagają przechowywania UPO, a pobierzesz je w dowolnym momencie, jeśli masz uprawnienia. W pyt. 41 dodaje, że nadanie numeru KSeF oznacza prawidłowe przetworzenie faktury, więc archiwizowanie UPO nie jest konieczne. Osobnego okresu dostępności UPO MF nie podaje. Same faktury KSeF przechowuje przez 10 lat od końca roku wystawienia (art. 112aa ustawy o VAT) – co to oznacza dla archiwum i wydruków, piszemy w tekście czy faktury z KSeF trzeba drukować.

Czym UPO różni się od numeru KSeF, kodu QR i potwierdzenia transakcji?

Co Kto tworzy Kiedy Do czego służy
UPO KSeF, podpis MF po przyjęciu faktury dowód odbioru: numer KSeF, daty, skrót pliku
Numer KSeF KSeF w chwili przyjęcia faktury identyfikator faktury w korektach, JPK, a od 2027 r. w przelewie
Kod QR program wystawcy na wydruku lub PDF faktury przekazywanej poza KSeF sprawdzenie i pobranie faktury z KSeF bez logowania
Potwierdzenie transakcji sprzedawca, dobrowolnie zanim faktura dostanie numer informacja dla nabywcy, bez znaczenia podatkowego

Kody QR omawiamy w tekście awaria KSeF i tryb offline, a dokument wydawany przy kasie – w artykule potwierdzenie transakcji w KSeF.

Najczęstsze pytania

Co to jest UPO w KSeF?

Urzędowe Poświadczenie Odbioru – plik XML podpisany przez MF, który potwierdza, że KSeF odebrał fakturę i nadał jej numer. Zawiera m.in. numer KSeF, numer faktury, NIP sprzedawcy, datę przesłania pliku i datę nadania numeru.

Czy nabywca dostaje UPO?

Nie. UPO pobiera ten, kto wysłał fakturę do KSeF, zwykle sprzedawca. Nabywca widzi w swojej liście faktur zakupowych fakturę z numerem KSeF i datą otrzymania, a UPO może dostać od sprzedawcy poza systemem.

Czy UPO trzeba przechowywać?

Nie. Przepisy tego nie wymagają, a UPO możesz pobrać w dowolnym momencie, jeśli masz odpowiednie uprawnienia. Przy fakturach offline warto je jednak zachować jako dowód dnia wysłania do KSeF.

Dlaczego nie mogę pobrać UPO zbiorczego w Aplikacji Podatnika?

UPO zbiorcze jest dostępne tylko dla zakończonej sesji. Zaznacz sesję w Historii sesji i kliknij Zakończ sesję albo pobierz UPO pojedynczej faktury z menu przy tej fakturze.

Jak sprawdzić, czy faktura została wysłana do KSeF?

Sprawdź, czy ma numer KSeF. W Aplikacji Podatnika zobaczysz go zaraz po wysyłce, na liście faktur sprzedażowych i w Historii sesji, a w programie – przy statusie faktury 200. Plik odrzucony, bez numeru KSeF, nie jest fakturą i trzeba go wysłać ponownie.

Źródła

  1. Podręcznik KSeF 2.0 cz. II (MF, 06.08.2026), pkt 3.3, 4.2 (przykład 9 i opis elementów UPO) oraz 5.1
  2. MF, grafika „Opis elementów składowych UPO_KSeF” (wersja 01.2026), elementy 1–11
  3. Podręcznik użytkownika Aplikacji Podatnika KSeF 2.0 (sierpień 2026), pkt 4.2.1 (anonimowe wyszukiwanie), 5.2.1, 5.3.1 i 5.4 (Historia sesji, tabele 17–19)
  4. CIRFMF/ksef-api, „Sesja – sprawdzenie stanu i pobranie UPO” (20.04.2026), pkt 5 i 7
  5. CIRFMF/ksef-api, schemat XSD UPO v4-3 (element Dokument)
  6. MF, Pytania i odpowiedzi KSeF 2.0 – sekcja „Wystawianie i otrzymywanie faktur”, pyt. 16, 38 i 39; sekcja „KSeF w Jednostkach Samorządu Terytorialnego”, pyt. 41 i 81

Artykuł ma charakter informacyjny i nie stanowi porady podatkowej. W konkretnej sprawie skonsultuj się z księgowym lub doradcą podatkowym.

Przeczytaj też