7 błędów konwersji PDF do XML KSeF

KSeF nie przyjmuje zwykłego pliku PDF jako faktury ustrukturyzowanej. Do wysyłki potrzebny jest poprawny plik XML zgodny ze strukturą FA(3), a PDF może być tylko źródłem danych lub wizualizacją dokumentu.

Najczęstsze błędy konwersji PDF do XML KSeF wynikają z niepełnego odczytu danych, złego rozpoznania NIP, dat, stawek VAT, sum kontrolnych oraz pól wymaganych przez strukturę FA(3).

Dobry proces konwersji powinien łączyć odczyt danych z PDF, mapowanie do pól FA(3), walidację techniczną XML i kontrolę biznesową przed wysyłką do KSeF.

Ten wpis nie jest rankingiem konwerterów. To lista błędów i testów kontrolnych, które warto wykonać po konwersji, zanim dokument trafi do programu księgowego albo do systemu KSeF.

Błędy konwersji PDF do XML KSeF są problemem praktycznym, a nie tylko technicznym. PDF wygląda jak faktura, ale KSeF pracuje na danych strukturalnych zapisanych w XML. Jeżeli dane z PDF zostaną źle odczytane lub przypisane do niewłaściwych pól FA(3), system może odrzucić dokument albo firma wyśle fakturę z błędną treścią.

Według oficjalnych materiałów KSeF faktura ustrukturyzowana ma format XML zgodny ze strukturą logiczną opublikowaną dla e-Faktury, a od 1 lutego 2026 r. obowiązującym wzorem jest FA(3). Sam wygląd dokumentu nie wystarcza. Znaczenie ma to, czy XML zawiera wymagane pola, właściwe typy danych i spójne wartości.

Najbardziej kosztowne skutki to: odrzucenie pliku przez walidację techniczną, konieczność ponownego przygotowania faktury, opóźnienie wysyłki do KSeF, błędne dane kontrahenta, niezgodność kwot netto, VAT i brutto oraz trudniejsza kontrola księgowa.

Jeżeli dopiero wybierasz narzędzie do zamiany PDF na XML, zacznij od poradnika darmowy konwerter PDF do XML KSeF, a następnie wróć do tej listy błędów jako praktycznej listy kontrolnej.

1. Czego KSeF oczekuje od pliku XML

2. PDF traktowany jak faktura KSeF

3. Wynik konwersji bez porównania z PDF

4. Błędnie rozpoznany kontrahent

5. Źle zmapowane stawki VAT i pozycje

6. Daty w niewłaściwych polach

7. Niespójna waluta i sumy

8. Brak walidacji XML przed wysyłką

9. Jak diagnozować wynik konwersji

10. Jak KSeFGPT pomaga ograniczyć błędy

11. Najczęściej zadawane pytania

Poniższa tabela pokazuje, które problemy najczęściej pojawiają się przy konwersji PDF do XML KSeF i jak je ograniczyć przed wysyłką dokumentu.

KSeF przyjmuje faktury ustrukturyzowane jako pliki XML zgodne z aktualną strukturą logiczną e-Faktury. W praktyce oznacza to, że dokument musi spełniać dwa warunki: być technicznie zgodny ze strukturą oraz zawierać dane biznesowe poprawne dla danej transakcji.

To rozróżnienie jest ważne, ponieważ faktura może wyglądać poprawnie w PDF, ale po konwersji do XML zawierać braki lub błędne mapowanie. Problem pojawia się szczególnie przy PDF-ach skanowanych, fakturach z nietypowym układem tabeli, wielu stawkach VAT, rabatach, zaliczkach i pozycjach z długimi opisami.

Co trzeba sprawdzić: numer faktury, datę wystawienia, datę sprzedaży, NIP sprzedawcy i nabywcy, adresy, kody kraju, walutę, stawki VAT, wartości netto, wartości VAT, wartości brutto, oznaczenia wymagane dla danego przypadku oraz kompletność pozycji faktury.

Jeżeli nie masz pewności, czym różni się XML od podglądu faktury, przeczytaj także XML i format FA(3) w KSeF. Ten temat jest podstawą do zrozumienia, dlaczego konwersja z PDF nie może polegać tylko na skopiowaniu tekstu.

Pierwszy błąd polega na założeniu, że skoro firma ma PDF faktury, to może wysłać go bezpośrednio do KSeF. To nie działa. PDF nie jest fakturą ustrukturyzowaną w rozumieniu KSeF. Do systemu trafia XML, a PDF może być tylko dokumentem źródłowym, załącznikiem roboczym lub wizualnym podglądem danych.

Objaw jest prosty: proces kończy się na pliku PDF, a firma nie ma pliku XML zgodnego z FA(3), numeru KSeF ani UPO. To nie jest błąd samego konwertera, tylko błąd w projekcie procesu.

Jak ograniczyć ryzyko: nie wysyłaj PDF do KSeF jako docelowej faktury, zawsze generuj XML, zapisuj wynik walidacji i jasno rozdziel etap konwersji od etapu formalnej wysyłki do KSeF.

Drugi błąd to automatyczne zaufanie do wyniku konwersji. Narzędzie może poprawnie rozpoznać tekst, ale błędnie przypisać go do pól. Przykład: numer rachunku bankowego może zostać odczytany jako fragment opisu, data sprzedaży jako data wystawienia, a NIP nabywcy jako NIP sprzedawcy.

Ten błąd często nie pojawia się jako czerwony komunikat walidatora. XML może być technicznie poprawny, ale biznesowo błędny, bo zawiera dane z niewłaściwego miejsca faktury.

Praktyczny test: wybierz 20 typowych faktur PDF z ostatniego miesiąca, przekonwertuj je do XML, sprawdź ręcznie dane identyfikacyjne i kwoty, a następnie zapisz, które pola najczęściej wymagają korekty. Taki test pokaże, czy problemem jest jakość PDF, szablon faktury, czy mapowanie danych.

Trzeci częsty błąd dotyczy danych kontrahenta. W PDF-ach z wieloma numerami identyfikacyjnymi narzędzie może pomylić NIP sprzedawcy, NIP nabywcy, numer zamówienia albo numer rachunku. W XML taka pomyłka ma większe znaczenie niż w zwykłym podglądzie, ponieważ dane trafiają do konkretnych pól struktury.

Najczęściej problem widać przy dokumentach, które mają kilka bloków adresowych: sprzedawcę, nabywcę, odbiorcę, płatnika, oddział albo dane bankowe. Konwerter może odczytać tekst poprawnie, ale nadać mu złą rolę.

Jeżeli firma odbiera wiele faktur od kontrahentów i chce porządkować ich dane, pomocny może być temat baza kontrahentów z KSeF, bo błędnie rozpoznany kontrahent szybko staje się problemem powtarzalnym.

Czwarty błąd dotyczy stawek VAT i pozycji faktury. Problemy pojawiają się przy kilku stawkach na jednej fakturze, pozycjach zwolnionych, historycznych opisach odwrotnego obciążenia w starych wzorach dokumentów, rabatach i zaokrągleniach. Konwersja może odczytać wartości poprawnie, ale przypisać je do złej stawki lub złej pozycji.

Objawem jest różnica między tabelą pozycji a podsumowaniem faktury. Na PDF-ie człowiek widzi, że pozycja należy do stawki 23%, 8%, 0% albo zwolnienia, ale po konwersji suma może trafić do innej grupy.

Co sprawdzić w pierwszej kolejności: liczbę pozycji, stawkę VAT przy każdej pozycji, sumę netto dla każdej stawki, łączną kwotę VAT, rabaty, zaliczki oraz pozycje z ilością ułamkową.

Piąty błąd to pomylenie dat. Na fakturze mogą występować data wystawienia, data sprzedaży, data wykonania usługi, termin płatności, data zamówienia i data dostawy. PDF jest czytelny dla człowieka, ale konwerter może odczytać pierwszą znalezioną datę i przypisać ją do niewłaściwego pola.

Najbardziej ryzykowna jest sytuacja, w której XML zawiera datę w poprawnym formacie, ale jest to nie ta data, której oczekuje księgowość. Walidator techniczny może nie wykryć, że termin płatności został użyty jako data wystawienia.

Dobre narzędzie powinno pokazać daty w podglądzie i pozwolić porównać je z etykietami na PDF-ie. Przy fakturach zagranicznych dodatkowo sprawdzaj formaty typu dzień-miesiąc-rok oraz miesiąc-dzień-rok.

Szósty błąd to niespójność kwot. Najczęstsze źródła problemu to zaokrąglenia, różne waluty, rabaty, pozycje z ilością ułamkową, groszowe różnice między sumą pozycji a podsumowaniem oraz błędne rozpoznanie separatora dziesiętnego.

W XML takie rozbieżności mogą uniemożliwić prawidłową walidację albo wymagać wyjaśnienia księgowego. Część błędów jest widoczna dopiero po porównaniu sum według stawek VAT, a nie tylko kwoty brutto z końca faktury.

Lista kontrolna kwot: sprawdź walutę, separator dziesiętny, liczbę miejsc po przecinku, sumę netto pozycji, sumę VAT według stawek, kwotę brutto, rabaty, zaliczki oraz zgodność podsumowania z pozycjami.

Siódmy błąd jest najłatwiejszy do uniknięcia: wysyłka XML bez wcześniejszej walidacji. Konwersja PDF do XML jest tylko etapem przygotowania dokumentu. Przed wysyłką plik powinien przejść walidację techniczną oraz kontrolę biznesową podstawowych danych.

Walidacja techniczna sprawdza zgodność ze strukturą, typami pól i wymaganiami formatu. Kontrola biznesowa odpowiada na inne pytanie: czy dane w pliku mają sens dla tej transakcji. Oba etapy są potrzebne, bo poprawny składniowo XML może nadal zawierać błędnego kontrahenta lub niewłaściwą datę.

Minimalny proces przed wysyłką: wygeneruj XML, uruchom walidację, sprawdź komunikaty błędów, porównaj dane z PDF, popraw źródło problemu, wygeneruj XML ponownie i dopiero wtedy wyślij dokument do KSeF.

Jeżeli chcesz zrozumieć różnicę między walidacją XML a przetwarzaniem danych, zobacz także walidacja i przetwarzanie XML w KSeF.

Najlepsza diagnostyka zaczyna się od objawu, a nie od zgadywania przyczyny. Jeśli walidator pokazuje błąd struktury, najpierw sprawdź brakujące pola i formaty. Jeśli XML przechodzi walidację, ale dane nie zgadzają się z PDF-em, problem leży zwykle w odczycie albo mapowaniu.

Warto rozdzielać trzy rodzaje problemów: błąd odczytu z PDF, błąd mapowania do pól FA(3) i błąd biznesowy faktury. Każdy wymaga innej reakcji. Błąd odczytu poprawia się na danych źródłowych lub w podglądzie. Błąd mapowania wymaga poprawy reguły lub narzędzia. Błąd biznesowy wymaga decyzji księgowej.

Dla większych wolumenów zapisuj powód każdej ręcznej poprawki. Po kilkudziesięciu dokumentach zobaczysz, czy problem powtarza się u jednego dostawcy, w jednym typie PDF, przy jednej walucie albo przy fakturach z wieloma stawkami VAT.

KSeFGPT jest prywatnym narzędziem, które wspiera pracę z fakturami i plikami KSeF. Nie jest usługą rządową i nie zastępuje decyzji księgowej, ale może uporządkować proces konwersji oraz kontroli danych przed wysyłką.

W praktycznym procesie użytkownik może przejść od dokumentu PDF do uporządkowanych danych, sprawdzić wynik konwersji, zweryfikować XML i dopiero potem przygotować dalszą obsługę faktury. To ogranicza ryzyko, że pierwszy błąd zostanie wykryty dopiero na końcu procesu.

Co warto pokazać w wewnętrznym teście: ile faktur przechodzi konwersję bez poprawek, które pola najczęściej wymagają ręcznej kontroli, ile czasu zajmuje poprawa błędów oraz czy problem dotyczy jednego dostawcy, czy wielu różnych wzorów PDF.

KSeFGPT udostępnia konwerter PDF do XML oraz walidator XML. Publiczne narzędzia wymagają podania adresu email przed pobraniem wyniku, a darmowy limit to 3 użycia w 24h.

Największy błąd przy konwersji PDF do XML polega na traktowaniu jej jak operacji technicznej bez wpływu na księgowość. W rzeczywistości konwersja decyduje o tym, jakie dane zostaną zapisane w fakturze ustrukturyzowanej.

Firmy powinny szczególnie uważać na faktury od dostawców, którzy stosują nietypowe układy PDF, skany zamiast PDF-ów tekstowych albo dokumenty wielojęzyczne. Takie faktury mogą wyglądać poprawnie dla człowieka, ale być trudne do jednoznacznego odczytu przez narzędzie automatyczne.

Najbezpieczniejszy model to połączenie automatyzacji i kontroli wyjątków. Powtarzalne, proste faktury można przetwarzać szybciej, ale dokumenty z wieloma stawkami VAT, korektami, zaliczkami lub walutą obcą powinny trafiać do dokładniejszej kontroli.

Wdrożenie konwersji warto zacząć od pomiaru błędów na małej próbce. Dopiero po takim teście można zdecydować, które faktury nadają się do automatyzacji, a które nadal wymagają ręcznego zatwierdzenia.

Jeżeli chcesz pogłębić temat, przeczytaj również:

Darmowy konwerter PDF do XML KSeF

Czy PDF można wysłać do KSeF

XML i format FA(3) w KSeF

Faktura odrzucona przez KSeF