Jak zamienić XML KSeF na czytelną fakturę PDF?

Plik XML z KSeF zawiera dane faktury w strukturze FA(3), ale nie jest wygodny do czytania jak tradycyjny dokument. Konwerter może ułożyć te dane w czytelny PDF z informacjami o sprzedawcy, nabywcy, pozycjach, podatku i podsumowaniu.

Wygenerowanie PDF nie zmienia dokumentu źródłowego, nie naprawia błędów i nie potwierdza przyjęcia faktury przez KSeF. Do pełnej kontroli nadal potrzebujesz XML, walidacji oraz danych systemowych, takich jak status, numer KSeF i UPO.

Po konwersji porównaj z XML-em dane stron, numer faktury, daty, walutę, liczbę pozycji, stawki VAT i kwoty. Jeśli PDF ma być przekazany kontrahentowi albo używany poza KSeF, sprawdź również, czy w danym przypadku wymaga właściwego kodu weryfikującego QR.

Otrzymujesz plik z rozszerzeniem XML i zamiast czytelnej faktury widzisz znaczniki, techniczne nazwy pól oraz długi ciąg danych. To normalne. Faktura ustrukturyzowana jest przygotowana przede wszystkim do automatycznego odczytu przez KSeF i programy księgowe, a nie do przeglądania jak dokument tekstowy.

PDF rozwiązuje problem czytelności, ale tylko na jednym poziomie. Pokazuje dane człowiekowi. Nie odpowiada samodzielnie na pytanie, czy struktura jest zgodna z FA(3), czy faktura została przyjęta przez KSeF ani czy rozliczenie podatkowe jest prawidłowe.

1. Co dzieje się podczas konwersji XML do PDF

2. Jak zamienić XML KSeF na PDF krok po kroku

3. Co sprawdzić na wizualizacji przed pobraniem PDF

4. Czego PDF nie potwierdza

5. Kiedy wizualizacja potrzebuje kodu QR

6. Perspektywa ekspercka

7. Najczęściej zadawane pytania

Poniższa tabela pokazuje, które elementy procesu trzeba rozdzielić, aby odróżnić roboczy podgląd danych od wizualizacji faktury obsłużonej już w KSeF.

Struktura FA(3) zapisuje dane w uporządkowanych obszarach. Nagłówek zawiera informacje techniczne, części dotyczące podmiotów opisują sprzedawcę, nabywcę i inne strony, a sekcja faktury obejmuje między innymi numer dokumentu, daty, walutę, pozycje, stawki VAT i podsumowania.

Konwerter odczytuje te pola i układa je w formę przypominającą tradycyjną fakturę. Nie wykonuje OCR, ponieważ dane są już zapisane w pliku. Jego zadaniem jest mapowanie struktury XML na nagłówki, tabele i podsumowania czytelne dla człowieka.

Strony transakcji: sprawdź nazwę, identyfikator i adres sprzedawcy oraz nabywcy.

Dokument: porównaj numer faktury, daty, walutę i dane o płatności.

Pozycje i podsumowanie: sprawdź opisy, ilości, ceny, stawki VAT oraz wartości netto, VAT i brutto.

Konwersja zmienia sposób prezentacji, a nie treść faktury. Skoro wiadomo już, co robi generator, można bezpiecznie przejść do samego procesu.

W konwerterze XML do PDF KSeF możesz wkleić treść faktury albo wgrać plik z dysku. Narzędzie jest przeznaczone przede wszystkim dla faktur w aktualnej strukturze FA(3).

W obecnej wersji narzędzia treść XML jest odczytywana i przetwarzana w przeglądarce. Serwer sprawdza limit użycia, natomiast sam PDF powstaje po stronie urządzenia użytkownika. Przed pobraniem wyniku trzeba podać adres email. Darmowy limit wynosi 3 użycia w ciągu 24 godzin.

Przygotowanie: zachowaj oryginalny XML w niezmienionej postaci i pracuj na jego kopii.

Wczytanie: otwórz konwerter, wklej treść albo wybierz plik z dysku.

Generowanie i pobranie: uruchom proces, podaj email i pobierz przygotowany PDF.

Kontrola: porównaj wizualizację z danymi źródłowymi przed przekazaniem jej dalej.

Narzędzie przyjmuje pliki do 5 MB. Jeżeli plik jest większy, nietypowy albo zawiera rozbudowane dane dodatkowe, sprawdź go osobno i nie zakładaj, że brak pełnej wizualizacji oznacza błąd samej faktury.

Najlepsza kontrola nie polega na przeczytaniu PDF-a od góry do dołu. Najpierw wybierz pola, których pomylenie zmienia znaczenie dokumentu, a następnie porównaj je z XML-em, zamówieniem, umową albo danymi w systemie księgowym.

Strony: porównaj nazwę, NIP lub inny identyfikator oraz adres sprzedawcy i nabywcy.

Dokument: sprawdź numer własny faktury, daty i walutę.

Pozycje: porównaj liczbę wierszy, jednostki miary, ilości, ceny i rabaty.

Podatek i płatność: sprawdź stawki VAT, wartości netto, VAT i brutto oraz termin i rachunek płatności.

Przykład z biura rachunkowego: klient przesyła fakturę kosztową w XML. Księgowa generuje PDF, żeby szybko ocenić strony, pozycje i kwoty, ale do dokumentacji zachowuje również niezmieniony XML. Przed zaksięgowaniem uruchamia walidację, a jeżeli faktura pochodzi z KSeF, porównuje także numer KSeF i status dokumentu.

Taki proces jest wolniejszy od bezrefleksyjnego pobrania PDF-a o kilkadziesiąt sekund, ale ogranicza ryzyko zaksięgowania czytelnego dokumentu z błędnymi danymi. Po kontroli wizualizacji trzeba jeszcze ustalić, czego sam PDF nie może dowieść.

PDF może wyglądać poprawnie nawet wtedy, gdy plik XML nie przechodzi walidacji albo zawiera dane wymagające wyjaśnienia. Generator odpowiada za prezentację. Walidator odpowiada za zgodność techniczną. KSeF odpowiada za status przetwarzania i nadanie numeru systemowego.

Struktura: PDF nie potwierdza zgodności z pełnym schematem FA(3) ani uzupełnienia wszystkich wymaganych pól.

Status: PDF nie dowodzi przyjęcia przez KSeF, nadania numeru KSeF ani dostępności UPO.

Podatek: czytelna wizualizacja nie potwierdza prawidłowej stawki VAT ani kwalifikacji transakcji.

Jeżeli chcesz sprawdzić strukturę, skorzystaj z poradnika Walidacja i przetwarzanie XML w KSeF. Gdy problemem jest samo rozpoznanie pól i numerów, pomocny będzie artykuł Jak odczytać XML z KSeF.

Rozdzielenie tych warstw pozwala ocenić ostatnią ważną kwestię: czy wygenerowany PDF może zostać bez dodatkowych działań przekazany kontrahentowi.

PDF przygotowany wyłącznie do wewnętrznego podglądu nie jest automatycznie tym samym dokumentem, którym firma posługuje się poza KSeF. Portal MF wskazuje, że w określonych ustawowo sytuacjach faktura udostępniana nabywcy lub używana poza KSeF musi zostać oznaczona odpowiednim kodem weryfikującym.

Kod pozwala uzyskać dostęp do faktury i sprawdzić dane zapisane w KSeF. Dla faktury online używanej poza systemem jest to kod powiązany z numerem KSeF. W trybach offline liczba i oznaczenia kodów zależą między innymi od tego, czy faktura została już przesłana do systemu.

Cel: czy dokument służy tylko do wewnętrznej kontroli, czy będzie przekazywany odbiorcy?

Status: czy faktura znajduje się już w KSeF i ma numer systemowy?

Oznaczenie: czy wizualizacja zawiera kod właściwy dla sposobu wystawienia i udostępnienia?

Darmowy konwerter pomaga uzyskać czytelny dokument, ale nie należy automatycznie zakładać, że każdy pobrany z niego PDF jest kompletną wizualizacją do użycia w każdym scenariuszu KSeF. Jeśli dokument ma trafić poza firmę, zweryfikuj QR i status faktury.

Najczęstsza pomyłka polega na utożsamieniu czytelności z poprawnością. Gdy dokument ma tabelę pozycji i prawidłowo wyglądające podsumowanie, łatwo uznać, że cały proces został zakończony. Tymczasem generator mógł tylko poprawnie pokazać wartości, które otrzymał w XML-u.

Bezpieczny zestaw roboczy składa się z kilku warstw. XML przechowuje dane faktury. Walidacja odpowiada na pytania techniczne. Numer KSeF, status i UPO dokumentują przebieg po stronie systemu. PDF pozwala człowiekowi szybko przeczytać oraz porównać dokument.

W małej firmie może to być prosty proces wykonywany ręcznie. W biurze rachunkowym albo organizacji przetwarzającej wiele faktur warto go ustandaryzować: zachowywać oryginalny XML, generować podgląd, kontrolować ustalony zestaw pól i dopiero potem przekazywać dokument do dalszej akceptacji lub księgowania.

Jeśli chcesz najpierw zrozumieć strukturę pliku, przeczytaj Jak odczytać XML z KSeF. Szerszy opis pól i schemy znajdziesz w artykule XML i format FA(3) w KSeF.

Przed użyciem dokumentu w księgowości sprawdź także Walidację i przetwarzanie XML w KSeF. Jeśli zaczynasz od dokumentu PDF i potrzebujesz odwrotnego procesu, zobacz Czy PDF można wysłać do KSeF?.