Faktura ustrukturyzowana odrzucona przez KSeF — 8 powodów

Faktura ustrukturyzowana to faktura wystawiana w KSeF w formacie XML, zgodnym z obowiązującą strukturą logiczną FA. Po pozytywnej weryfikacji system nadaje jej numer KSeF. Jeżeli weryfikacja się nie powiedzie, dokument wraca z komunikatem — a kiedy przejrzy się takie przypadki z prawdziwego ruchu, okazuje się, że nie są przypadkowe. Układają się w kilka powtarzalnych wzorców.

Jedno zastrzeżenie na start: przesłanie dokumentu i jego przyjęcie to nie ten sam moment. Po wysyłce dokument bywa jeszcze przetwarzany i dopiero status końcowy przesądza, czy został przyjęty, czy odrzucony. Numer KSeF i UPO pojawiają się po pozytywnej weryfikacji. Czym dokładnie jest faktura ustrukturyzowana i jak działa w KSeF, opisujemy w przewodniku o KSeF.

Przeanalizowaliśmy 1 190 nieudanych wysyłek do KSeF przetworzonych przez easySales oraz 6 132 dokumenty przyjęte z nadanym numerem KSeF. Piszemy „nieudane wysyłki”, a nie „odrzucone faktury”, bo to nie to samo: część przypadków to błąd walidacji dokumentu, a część — nieudane nawiązanie sesji, przy którym KSeF w ogóle nie zobaczył treści faktury.

Najważniejszy wniosek: dwie przyczyny odpowiadają za 90% wszystkich nieudanych wysyłek — nieprawidłowa stawka VAT (858) i nieotwarta sesja (218). Pozostałe sześć wzorców to razem 114 przypadków.

Jedna rzecz rzuca się w oczy od razu: prawie żaden z tych błędów nie jest błędem księgowym. To błędy danych — i biorą się stąd, że faktura powstała automatycznie z zamówienia z marketplace, a nie została wypełniona ręcznie przez człowieka. Dlatego poradniki pisane dla biur rachunkowych ich nie opisują.

1. Stawka VAT spoza polskiej listy

858 przypadków — zdecydowanie najczęstsza przyczyna, blisko cztery razy częstsza niż kolejna.

Schemat FA dopuszcza w polu stawki podatku wyłącznie wartości stosowane w Polsce. Jeżeli pozycja faktury niesie stawkę 19, 20, 21 albo 27, dokument nie przechodzi walidacji schematu — zanim ktokolwiek spojrzy na jego treść.

Skąd na fakturze polskiego sprzedawcy biorą się takie stawki? Z zamówień transgranicznych. Sprzedaż na zagranicznych platformach albo wysyłka do kupujących z innych krajów UE potrafi przynieść w zamówieniu stawkę obowiązującą tam, a nie w Polsce. System fakturujący przepisuje ją na dokument, dokument trafia do KSeF i nie przechodzi walidacji.

Co z tym zrobić: ustal, które zamówienia generują stawki inne niż polskie, i nie wysyłaj tych faktur do KSeF tym samym przepływem. W easySales służy do tego warunek Oprogramowanie do fakturowania w automatyzacji, który zawęża, które faktury w ogóle trafiają do wysyłki. To decyzja o zakresie wysyłki, a nie obejście walidacji. Jak traktować konkretną transakcję transgraniczną — to pytanie do Twojego księgowego; tutaj opisujemy wyłącznie to, co robi walidacja schematu.

2. Sesja nie została otwarta

218 przypadków.

To jedyna pozycja na tej liście, która nie jest odrzuceniem faktury. Wysyłka nie jest pojedynczym żądaniem: najpierw otwierana jest sesja, dopiero w niej wędruje dokument, a potem odpytujemy o wynik. Jeżeli sesja się nie otworzy, KSeF nie zobaczy treści dokumentu — nie ma czego walidować.

Najczęstsza przyczyna leży po stronie uprawnień tokena. Token musi mieć zarówno prawo wystawiania faktur, jak i prawo odczytu statusu — bo o werdykt trzeba dopytać. Token z samym prawem wystawiania wygląda na poprawny w momencie zapisu i przestaje działać w chwili, gdy potrzebny jest wynik.

Co z tym zrobić: sprawdź zakres uprawnień tokena, zanim zaczniesz szukać błędu w danych faktury. Ten błąd nie mówi nic o treści dokumentu.

3. W polu NIP jest coś, co nie jest numerem NIP

72 przypadki.

Dwa warianty, oba pochodzą wprost z danych wpisanych przez kupującego. Pierwszy: kupujący wpisuje w formularzu NIP: 1234567890 zamiast samego numeru — i przedrostek jedzie razem z numerem. Drugi: kupujący z Czech lub Słowacji wpisuje IČO albo DIČ, czyli poprawny identyfikator, tylko nie polski NIP.

Na marketplace to pole wypełnia klient, nie sprzedawca. Nikt go nie waliduje po drodze.

Co z tym zrobić: oczyść dane identyfikacyjne po stronie przetwarzania zamówienia, zanim powstanie faktura — usuń przedrostki i odrzuć numery, które nie mają formatu polskiego NIP-u. Poprawianie tego na gotowym dokumencie jest znacznie droższe.

4. Niekompletne dane identyfikacyjne kupującego

15 przypadków.

Blok danych identyfikacyjnych nabywcy wymaga kompletu i to jego brak zatrzymuje dokument na walidacji. Nie należy tego mylić z pustą nazwą nabywcy: fakturę dla osoby prywatnej bez numeru identyfikacyjnego KSeF przyjmuje i rejestruje, tylko bez nazwy — to osobna sprawa i nie jest powodem odrzucenia. Tutaj chodzi o niekompletny blok identyfikacyjny, przy którym dokument wyglądający w panelu poprawnie nie przechodzi walidacji.

Co z tym zrobić: to jeden z niewielu przypadków, w których warto zajrzeć w konkretne zamówienie, a nie w ustawienia. Zwykle brakuje danych już na wejściu, w samym zamówieniu.

5. Pole kontaktowe z danymi innego typu

8 przypadków.

Zdarza się, że w polu telefonu ląduje nazwa firmy. Brzmi jak sytuacja jednostkowa i taka jest w liczbach, ale pokazuje regułę: pola faktury dziedziczą dokładnie to, co przyszło w zamówieniu, razem z bałaganem.

6. Numer faktury zgłoszony jako duplikat

5 przypadków.

KSeF pilnuje unikalności numeru dokumentu i zgłasza kolizję kodem 440, wskazując numer KSeF dokumentu, który już jest zarejestrowany. Sama kolizja nie zawsze oznacza błąd: jeżeli wskazany dokument to ta sama faktura, easySales przyjmuje jej numer KSeF i UPO i nie wysyła jej po raz drugi. Odrzucenie następuje wtedy, gdy pod tym samym numerem zarejestrowana jest inna faktura — wtedy dokument nie zostaje zarejestrowany.

Co z tym zrobić: zadbaj, żeby numeracja wysyłana do KSeF była wspólna dla wszystkich kanałów i systemów wystawiających dokumenty dla danego sprzedawcy. Osobne, resetujące się serie prowadzą właśnie do takiej kolizji.

7. Data wystawienia późniejsza niż data przyjęcia

5 przypadków.

Dokument nie może zostać przyjęty „wstecz z przyszłości" — data wystawienia nie może wyprzedzać momentu przyjęcia do systemu. Pojawia się to przy datowaniu z wyprzedzeniem i przy różnicach stref czasowych.

8. Pozostałe

9 przypadków rozłożonych na pojedyncze, niepowtarzalne sytuacje — między innymi błędny numer VAT UE, brak faktury do wysłania i przekroczony limit żądań. W praktyce oznacza to, że siedem wzorców powyżej wyjaśnia niemal wszystko, co widzimy.

Co to znaczy dla faktur ustrukturyzowanych z marketplace

Uszereguj te liczby jeszcze raz: 858 to stawka VAT, 218 to uprawnienia tokena, 114 to jakość danych z zamówienia. Ani jeden z tych powodów nie dotyczy tego, czy fakturę wystawiono poprawnie w sensie księgowym.

To jest różnica między sprzedażą na marketplace a fakturowaniem, o którym piszą poradniki podatkowe. Tam fakturę wypełnia człowiek, który zna kontrahenta. Tutaj faktura powstaje z zamówienia, które przyszło z platformy, z danymi wpisanymi przez kupującego, czasem w innym kraju i w innej stawce. Walidacja schematu tego nie wybacza — i nie ma powodu, żeby wybaczała.

Dobra wiadomość jest taka, że wszystkie te przypadki są powtarzalne, więc dają się załatwić raz: zakresem przepływu, uprawnieniami tokena i czyszczeniem danych na wejściu. Jak to ustawić krok po kroku, opisujemy w przewodniku: KSeF i faktury ustrukturyzowane. Jeśli chcesz zobaczyć samo połączenie, jest tutaj: integracja z KSeF.

Metodologia

Dane obejmują wysyłki faktur do KSeF przetworzone przez easySales od 15 maja 2026 do 4 września 2026, ze środowiska produkcyjnego. Liczymy wysyłki, nie komunikaty błędów: jedna nieudana wysyłka bywa ponawiana i zapisuje wtedy kilka komunikatów, więc zliczanie komunikatów zawyżyłoby zwłaszcza pozycję „sesja nie została otwarta”. Każda wysyłka jest przypisana do jednej przyczyny — tej, na której zakończyła się ostatecznie. Z zestawienia wyłączone są wysyłki pominięte dlatego, że faktura była już zarejestrowana w KSeF, oraz dokumenty wciąż przetwarzane.