Jak czytać plik XML faktury ustrukturyzowanej? Poradnik dla nieinformatyków

Czym jest faktura ustrukturyzowana i dlaczego to nie PDF?

AITekst opracowany z wykorzystaniem sztucznej inteligencji. Zasady i ograniczenia

Faktura ustrukturyzowana to dokument elektroniczny wystawiony przy użyciu Krajowego Systemu e-Faktur, zdefiniowany w Ustawie z dnia 9 listopada 2018 r. o elektronicznym fakturowaniu w zamówieniach publicznych, koncesjach na roboty budowlane lub usługi oraz najmie. Zasadnicza różnica między powszechnie stosowanym formatem PDF a strukturą XML polega na sposobie zapisu danych: PDF stanowi statyczny obraz dokumentu, podczas gdy XML funkcjonuje jako ustrukturyzowana baza danych. Zgodnie z art. 106n ustawy o VAT, format XML umożliwia automatyzację procesów księgowych, gdyż każda informacja ma przypisane stałe, unikalne miejsce w kodzie dokumentu.

W strukturze logicznej FA(2) konkretne dane odnajdziemy w ściśle zdefiniowanych polach, co eliminuje ryzyko błędnej interpretacji przez systemy finansowo-księgowe. Przykładowo, data sprzedaży zawsze znajduje się w polu <P_6>, natomiast Identyfikator Podatkowy NIP nabywcy jest przypisany do tagu <P_14>. Faktura ustrukturyzowana, mimo braku tradycyjnej warstwy wizualnej znanej z papierowych odpowiedników, zawiera identyczny zestaw pól merytorycznych, które są niezbędne do prawidłowego rozliczenia podatku od towarów i usług.

• Czytelny dla maszyn - format pozwala na bezpośredni import danych do rejestrów VAT bez konieczności ręcznego przepisywania wartości.
• Zawiera ponad 400 pól - struktura FA(2) przewiduje miejsca na szczegółowe informacje, od danych podstawowych po zaawansowane procedury podatkowe.
• Można go otworzyć w Notatniku - plik XML jest plikiem tekstowym, co umożliwia wgląd w jego treść przy użyciu dowolnego edytora systemowego.

Warto zaznaczyć, że faktura ustrukturyzowana nie oznacza automatycznie, iż dokument jest rzetelny i niewadliwy. Krajowy System e-Faktur nie dokonuje merytorycznej ani rachunkowej weryfikacji zawartości, w tym poprawności stawek VAT czy numerów identyfikacyjnych. Za niewadliwość i rzetelność dokumentu odpowiada wyłącznie wystawca, a nabywca powinien zweryfikować zgodność danych z rzeczywistym zdarzeniem gospodarczym przed ujęciem faktury w ewidencji. Przed użyciem profesjonalnych narzędzi do wizualizacji, rekomenduje się otwarcie przykładowego pliku XML w prostym edytorze tekstu w celu oswojenia się z hierarchiczną budową znaczników.

Jak otworzyć plik XML faktury bez informatyka?

Przeglądanie zawartości pliku XML nie wymaga specjalistycznego oprogramowania programistycznego. Najprostszym sposobem na szybki podgląd struktury jest wykorzystanie standardowej przeglądarki internetowej, takiej jak Google Chrome lub Microsoft Edge. Po przeciągnięciu pliku do okna przeglądarki, system wyświetli drzewiastą strukturę dokumentu, gdzie poszczególne sekcje można rozwijać i zwijać. Procedura ta nie wymaga logowania do systemu KSeF i jest w pełni bezpieczna dla integralności danych, gdyż przeglądarka działa jedynie jako czytnik tekstu sformatowanego.

Dla użytkowników wymagających bardziej przejrzystej formy, Ministerstwo Finansów udostępnia bezpłatne narzędzia na portalu ksef.podatki.gov.pl. Umożliwiają one wczytanie pliku XML i przekształcenie go w formę graficzną przypominającą tradycyjną fakturę. Należy jednak pamiętać, że wizualizacja jest jedynie pochodną pliku źródłowego i nie stanowi oryginału faktury - w obrocie prawnym wiążący pozostaje wyłącznie plik w formacie XML, któremu nadano numer identyfikujący w systemie KSeF.

Proces wizualizacji w systemie ministerialnym przebiega według schematu: zalogowanie na ksef.podatki.gov.pl, przejście do sekcji "Faktury", a następnie wybranie opcji "Wizualizuj XML". Wystawcy mogą również korzystać z rozwiązań komercyjnych, takich jak systemy oferowane przez itBCG, które integrują się z API KSeF i pozwalają na automatyczne generowanie czytelnych podglądów faktur. Znajomość schematu FA(2) dostępnego w repozytorium CRWDE (Centralne Repozytorium Wzorów Dokumentów Elektronicznych) znacznie ułatwia interpretację nazw poszczególnych pól podczas ręcznej weryfikacji.

Kluczowe pola XML - co musisz sprawdzić na pierwszy rzut oka?

Identyfikacja najważniejszych danych w gąszczu znaczników XML jest kluczowa dla zapewnienia bezpieczeństwa podatkowego. Najważniejszym elementem jest Numer KSeF, który znajduje się w tagu <FaNrKSeF>. Jest to unikalny, 35-znakowy identyfikator nadawany przez system w momencie przyjęcia faktury. Zgodnie z art. 106na ust. 1 ustawy o VAT, faktura uznawana jest za wystawioną w dniu jej przesłania do KSeF, a data ta jest integralną częścią numeru identyfikującego (sekwencja 8 cyfr po NIP-ie sprzedawcy).

1. Znajdź znacznik <FaNrKSeF> w górnej sekcji pliku.
2. Skopiuj pełny ciąg znaków, upewniając się, że nie pominąłeś żadnej cyfry.
3. Wklej numer do tytułu przelewu bankowego, co będzie obligatoryjne przy płatnościach za faktury ustrukturyzowane w celu umożliwienia odliczenia podatku naliczonego.

Kolejnym etapem weryfikacji jest sprawdzenie Identyfikatora Podatkowego NIP stron transakcji. Sprzedawca identyfikowany jest w polu <P_13>, natomiast nabywca w polu <P_14>. Warto skorzystać z funkcji wyszukiwania (Ctrl+F) w przeglądarce, aby błyskawicznie potwierdzić, czy dokument został wystawiony na właściwy podmiot. Pamiętajmy, że Biała lista podatników prowadzona przez Szefa KAS od września 2019 roku nadal stanowi podstawowe narzędzie weryfikacji rachunków bankowych kontrahentów, a KSeF nie zastępuje tej procedury.

W zakresie danych finansowych należy skupić się na trójce tagów: <P_15> (łączna wartość netto), <P_23> (kwota podatku VAT) oraz <P_24> (kwota brutto). Przykładowo, jeżeli w polu <P_15> widnieje wartość 1000.00, a stawka VAT wynosi 23%, to w polu <P_23> powinna znaleźć się kwota 230.00, co sumarycznie w <P_24> musi dać 1230.00. Wszelkie rozbieżności rachunkowe mogą świadczyć o błędzie w systemie sprzedawcy, gdyż KSeF akceptuje pliki poprawne pod względem struktury, a niekoniecznie pod względem matematycznym. Dla usprawnienia pracy warto przygotować sobie zrzut ekranu z oznaczonymi tagami, który posłuży jako podręczna ściągawka.

Co zrobić, gdy XML wyświetla błędy?

Błąd o treści "Niezgodność ze schematem FA(2)" oznacza, że plik nie przeszedł walidacji strukturalnej i nie został przyjęty przez system KSeF. Schemat logiczny pełni rolę mapy, która definiuje, jakie pola są obowiązkowe, a jakie opcjonalne. Najczęstszą przyczyną odrzucenia dokumentu jest brak obligatoryjnego tagu, na przykład <P_6> (data sprzedaży) lub błędne określenie stawki podatkowej w polu <P_22>. Dokument, który nie otrzymał numeru KSeF, w świetle prawa nie istnieje jako faktura ustrukturyzowana i nie wywołuje skutków podatkowych.

W przypadku konieczności dokonania szybkiej autokorekty pliku, który nie został jeszcze wysłany do systemu, można skorzystać z darmowych edytorów takich jak XML Grid Editor lub Notepad++ z zainstalowaną wtyczką XML Tools. Narzędzia te pozwalają na edycję tekstu przy jednoczesnym zachowaniu poprawnej składni znaczników. Należy jednak zachować szczególną ostrożność, aby nie naruszyć hierarchii tagów, co mogłoby spowodować całkowitą nieczytelność pliku dla systemów informatycznych. Przed każdą próbą modyfikacji zaleca się wykonanie kopii zapasowej oryginalnego pliku XML.

Skuteczne zarządzanie fakturami ustrukturyzowanymi wymaga nie tylko znajomości technicznych aspektów plików XML, ale przede wszystkim wdrożenia odpowiednich procedur wewnątrz przedsiębiorstwa. Wykorzystanie zaawansowanych systemów, takich jak aplikacja KBiP w połączeniu z repozytorium ViDok, pozwala na pełną automatyzację odbioru i wczytywania dokumentów z Platformy Elektronicznego Fakturowania (PEF). Bieżące monitorowanie komunikatów Ministerstwa Finansów oraz podnoszenie kwalifikacji w zakresie nowych przepisów podatkowych jest niezbędne dla zachowania płynności operacyjnej w erze cyfrowej administracji skarbowej.