UPO w KSeF po sprzedaży marketplace – jak pobierać, archiwizować i łączyć je z zamówieniami

Sprzedaż na marketplace wygląda prosto tylko do momentu, w którym trzeba udowodnić, że konkretna faktura naprawdę trafiła do KSeF i dotyczy konkretnego zamówienia. Platforma ma swój numer transakcji, system księgowy ma własny numer faktury, KSeF nadaje swój numer, a pomiędzy nimi pojawia się UPO, czyli dokument potwierdzający przyjęcie faktury przez system. Jeśli tych elementów nie połączysz od razu, po kilku miesiącach zaczyna się zgadywanie: „które UPO jest od zamówienia z Allegro?”, „czy korekta poszła do właściwej faktury?”, „dlaczego klient widzi inny numer niż księgowość?”.

W praktyce UPO po sprzedaży marketplace nie jest ozdobnikiem do archiwum. To techniczny i dowodowy ślad, który spina zamówienie, fakturę, wysyłkę do KSeF oraz późniejsze korekty. Największy błąd to pobieranie go ręcznie „raz na jakiś czas” i odkładanie do folderu bez powiązania z numerem zamówienia. Taki plik istnieje, ale nie pracuje.

UPO nie powstaje na marketplace, tylko po stronie KSeF

Marketplace może wygenerować zamówienie, przekazać dane kupującego, pobrać płatność, czasem nawet pomóc w wystawieniu dokumentu sprzedaży. Nie oznacza to jednak, że platforma automatycznie zapewnia pełną obsługę Urzędowego Poświadczenia Odbioru. UPO pojawia się dopiero wtedy, gdy faktura ustrukturyzowana zostanie wysłana do KSeF i przyjęta przez system.

To rozróżnienie jest ważne, bo w sprzedaży marketplace łatwo pomylić trzy potwierdzenia:

• potwierdzenie złożenia zamówienia na platformie,
• potwierdzenie wystawienia faktury w systemie sprzedażowym lub księgowym,
• UPO z KSeF, które potwierdza przyjęcie faktury przez administracyjny system e-faktur.

Tylko trzecie potwierdzenie zamyka proces po stronie KSeF. Jeżeli faktura ma numer wewnętrzny, ale nie ma numeru KSeF, trzeba traktować ją jako dokument wymagający sprawdzenia. W sprzedaży masowej, zwłaszcza przy wielu kontach marketplace, automatyczne założenie „skoro faktura jest w systemie, to na pewno jest w KSeF” szybko prowadzi do zaległości.

Najrozsądniejszy proces wygląda tak: po pobraniu zamówienia z platformy system wystawia fakturę, wysyła ją do KSeF, odbiera status, zapisuje numer KSeF, a następnie pobiera albo rejestruje UPO. Dopiero wtedy zamówienie można oznaczyć jako rozliczone od strony e-fakturowania. Nie jako „zapłacone”, nie jako „wysłane”, tylko właśnie jako rozliczone w KSeF.

Warto też rozdzielić tryb pojedynczy i masowy. Przy kilku fakturach dziennie ręczne sprawdzenie statusu jeszcze się broni. Przy setkach zamówień z marketplace już nie. Wtedy potrzebny jest harmonogram, który cyklicznie sprawdza faktury bez numeru KSeF i ponawia pobranie statusu. KSeF może potrzebować chwili na przetworzenie dokumentu, więc brak UPO minutę po wysyłce nie zawsze oznacza błąd. Brak UPO następnego dnia roboczego powinien już uruchomić alert.

Pobieranie i archiwizacja: najpierw status, potem plik, na końcu kontrola braków

Najgorszy model archiwizacji to folder o nazwie „UPO” i pliki pobierane ręcznie przez różne osoby. Bez metadanych, bez jednego schematu nazw, bez informacji, którego konta marketplace dotyczą. Przy kontroli albo reklamacji księgowość nie szuka wtedy dokumentu, tylko rekonstruuje historię.

Dobrze ustawiony proces powinien mieć trzy warstwy.

Pierwsza to status techniczny faktury. System musi wiedzieć, czy faktura została wysłana, odrzucona, przyjęta, czy nadal czeka na przetworzenie. Odrzucenia nie wolno chować pod ogólnym komunikatem „błąd KSeF”. Trzeba zapisać konkretną przyczynę: problem ze strukturą XML, brak wymaganego pola, niezgodność danych, brak uprawnień albo błąd po stronie integracji. Dopiero z takiego opisu da się zrobić kolejkę naprawczą.

Druga warstwa to archiwum UPO. Sam KSeF przechowuje faktury ustrukturyzowane przez 10 lat, ale w sprzedaży marketplace własne archiwum nadal ma sens operacyjny. Nie po to, żeby dublować państwowy system dla zasady, tylko żeby szybko połączyć zamówienie, dokument księgowy, numer KSeF, korektę i reklamację. UPO warto przechowywać w formie, której nie trzeba interpretować od nowa po roku: jako oryginalny plik lub odpowiedź systemową oraz jako czytelny podgląd dla księgowości.

Trzecia warstwa to kontrola braków. To ona odróżnia porządek od pozornego porządku. Raz dziennie system powinien wyłapać:

• zamówienia z fakturą, ale bez numeru KSeF,
• faktury wysłane do KSeF, ale bez potwierdzenia przyjęcia,
• UPO bez przypisanego zamówienia marketplace,
• korekty bez powiązania z fakturą pierwotną,
• duplikaty wynikające z ponownej wysyłki tego samego dokumentu,
• faktury wystawione poza standardowym kontem sprzedażowym.

Nazewnictwo plików też ma znaczenie. Dobre minimum to: data sprzedaży, platforma, ID zamówienia, numer faktury, numer KSeF. Przykład logiczny, niekoniecznie jedyny: 2026-07-09_allegro_123456789_FV-1024-07-2026_KSeF-.... Jeśli firma działa na kilku marketplace’ach, nazwa platformy i identyfikator konta sprzedawcy są obowiązkowe. Bez tego po czasie nie wiadomo, czy zamówienie pochodziło z Allegro, Amazon, EmpikPlace czy z własnego sklepu zsynchronizowanego tym samym modułem.

Archiwizacja powinna być odporna na ludzką kreatywność. Plik UPO nie powinien być edytowany, nadpisywany ani podmieniany przez użytkownika. Sensowne są uprawnienia tylko do odczytu, dziennik pobrania, suma kontrolna pliku i zapis informacji, kto oraz kiedy pobrał dokument. Przy małej skali brzmi to przesadnie. Przy sporze o fakturę, korektę albo datę przyjęcia dokumentu przez KSeF przestaje.

Łączenie UPO z zamówieniem: nie po nazwie klienta, tylko po twardych identyfikatorach

W sprzedaży marketplace dane klienta bywają niewygodne. Kupujący może zmienić adres, użyć innego maila do faktury, kupić jako osoba prywatna, a później poprosić o dokument na firmę, o ile proces i przepisy na to pozwalają. Dlatego łączenie UPO z zamówieniami po nazwisku, e-mailu albo kwocie to proszenie się o bałagan.

Najbezpieczniejszy jest model oparty na twardych identyfikatorach. W bazie zamówień powinny znaleźć się co najmniej:

• ID zamówienia marketplace,
• nazwa platformy i ID konta sprzedawcy,
• numer faktury w systemie sprzedawcy,
• data wystawienia i data sprzedaży,
• NIP nabywcy, jeśli faktura jest wystawiana dla firmy,
• numer KSeF,
• status wysyłki do KSeF,
• identyfikator sesji lub paczki wysyłkowej,
• lokalizacja pliku UPO,
• numer faktury korygowanej i numer KSeF faktury pierwotnej, jeśli występuje korekta.

Priorytet jest prosty: najpierw zapisz numer zamówienia marketplace i numer faktury, potem numer KSeF, a dopiero na końcu ścieżkę do pliku UPO. Jeśli zrobisz odwrotnie i zaczniesz od samego archiwum plików, stworzysz magazyn dokumentów, którego nie da się wygodnie przeszukiwać z poziomu obsługi klienta, księgowości ani reklamacji.

Trzeba też zdecydować, co robić z zamówieniami zbiorczymi i częściowymi. Jeden zakup może prowadzić do jednej faktury, ale w niektórych procesach pojawiają się częściowe wysyłki, dopłaty, anulowania pozycji, zwroty i korekty. Wtedy nie wystarczy relacja „jedno zamówienie — jedna faktura”. Lepszy jest układ: zamówienie jako rekord nadrzędny, a pod nim dokumenty: faktura pierwotna, korekta ilościowa, korekta wartościowa, ewentualnie kolejne dokumenty wynikające z obsługi zwrotu.

Nie warto automatyzować wszystkiego od razu. Pierwszy etap to uszczelnienie najdroższych błędów: faktury bez numeru KSeF, UPO bez zamówienia i korekty bez dokumentu pierwotnego. Dopiero potem ma sens dopracowywanie panelu podglądu, raportów miesięcznych czy automatycznych powiadomień dla działu obsługi. Kolejność ma znaczenie, bo ładny panel z niepełnymi danymi tylko szybciej pokazuje chaos.

Przy wyborze narzędzia do obsługi integracji trzeba sprawdzić nie hasło „obsługujemy KSeF”, ale konkretne funkcje: czy system zapisuje numer KSeF przy zamówieniu, czy przechowuje UPO, czy pokazuje błędy odrzuceń, czy obsługuje korekty, czy pozwala filtrować dokumenty według marketplace i czy da się wyeksportować dane dla księgowości. Dodatkowe informacje na: https://ksefservice.pl

FAQ

Czy UPO trzeba pobierać dla każdej faktury z marketplace?
Pobieranie UPO nie zawsze jest formalnie konieczne, jeśli faktura ma numer KSeF i została prawidłowo przyjęta, ale w sprzedaży marketplace warto je zapisywać. UPO ułatwia kontrolę, reklamacje, audyt i szybkie wyjaśnienie, która faktura została przyjęta przez KSeF.

Czy numer KSeF wystarczy zamiast UPO?
Do bieżącej pracy często wystarcza numer KSeF, bo potwierdza przyjęcie faktury do systemu. UPO daje jednak pełniejszy ślad procesu, dlatego przy większej liczbie zamówień lepiej przechowywać oba elementy: numer KSeF w bazie zamówień i UPO w archiwum.

Jak często sprawdzać brakujące UPO?
Przy sprzedaży codziennej najlepiej robić kontrolę minimum raz dziennie. Alert powinien obejmować faktury wysłane do KSeF, które po zakończeniu cyklu przetwarzania nadal nie mają numeru KSeF albo potwierdzenia przyjęcia.

Czy UPO powinno być dostępne dla obsługi klienta?
Nie zawsze jako plik. Obsługa klienta powinna widzieć status faktury, numer KSeF i informację, czy dokument został przyjęty. Sam plik UPO lepiej zostawić księgowości lub administratorom, żeby ograniczyć przypadkowe pobieranie i przesyłanie dokumentów.

Od czego zacząć porządkowanie UPO po sprzedaży marketplace?
Najpierw zrób raport faktur z ostatnich 30 dni i sprawdź trzy braki: faktury bez numeru KSeF, UPO bez przypisanego zamówienia oraz korekty bez połączenia z fakturą pierwotną. To usuwa najbardziej ryzykowny bałagan szybciej niż przebudowa całego procesu naraz.