Walidator XRechnung i ZUGFeRD: bezpłatne sprawdzanie e-faktury online
Plik XRechnung lub ZUGFeRD wygląda na gotowy, ale czy jest naprawdę prawidłowy, tego mu nie widać. Właśnie tu wchodzi walidator: sprawdza plik względem normy EN 16931, reguł obliczeniowych i niemieckich reguł szczególnych i mówi Państwu przed wysyłką lub przed zaksięgowaniem, czy przejdzie. Wyszukiwanie haseł „XRechnung Validator”, „ZUGFeRD Validator” lub „XRechnung online prüfen” prowadzi jednak do mylącego wyboru spośród oficjalnych narzędzi Java, internetowych uploaderów i walidatorów przeglądarkowych.
Ten poradnik porządkuje opcje, pokazuje decydującą różnicę w ochronie danych i wyjaśnia, jak naprawdę czytać protokół kontroli, zamiast patrzeć tylko na czerwoną lub zieloną kontrolkę.
> Krótka odpowiedź: Walidator sprawdza plik XRechnung lub ZUGFeRD względem EN 16931, reguł obliczeniowych i niemieckich reguł CIUS. Są trzy drogi: oficjalny walidator KoSIT jako narzędzie Java, dowolny internetowy uploader lub walidator przeglądarkowy, który sprawdza plik lokalnie. Dla większości wystarcza bezpłatny walidator ZUGFeRD i XRechnung: sprawdza XML i PDF ZUGFeRD bezpośrednio w przeglądarce, bez opuszczania faktury z Państwa komputera.
Co walidator w ogóle sprawdza
Walidator przechodzi przez e-fakturę w kilku etapach. Dopiero gdy wszystkie zostaną zaliczone, plik jest uznawany za prawidłowy:
- Składnia: czy XML jest technicznie poprawnie zbudowany?
- Schemat: czy struktura odpowiada oczekiwanemu formatowi (UBL lub CII)?
- Reguły biznesowe (BR): czy są wszystkie pola obowiązkowe?
- Reguły obliczeniowe (BR-CO): czy sumy się zgadzają (netto plus podatek daje brutto)?
- Niemieckie reguły CIUS (BR-DE): czy niemieckie pola szczególne są prawidłowe, na przykład Leitweg-ID?
Jedno naruszenie na którymkolwiek etapie prowadzi do odrzucenia. Dlatego nie wystarczy wygenerować jakikolwiek XML. Mechanikę tych pięciu etapów szczegółowo opisuje instrukcja walidatora KoSIT.
Trzy drogi sprawdzenia e-faktury
| Droga | Instalacja | Ochrona danych | Odpowiednia dla |
|---|---|---|---|
| Oficjalny walidator KoSIT (Java) | potrzebny JRE i konfiguracja | lokalnie, dane zostają w firmie | programiści, integracje |
| Internetowy uploader | brak | plik trafia na obcy serwer | szybka pojedyncza kontrola bez danych wrażliwych |
| Walidator przeglądarkowy | brak | lokalnie w przeglądarce, bez przesyłania | zwykły przypadek dla MŚP |
Oficjalny walidator KoSIT jest wzorcem, ale jako narzędzie Java (java -jar validationtool.jar -s szenarien.xml rechnung.xml) jest zbyt nieporęczny do okazjonalnego użytku. Czysty internetowy uploader jest wygodny, ale przesyła prawdziwe dane faktury z nazwami, kwotami i numerami podatkowymi na obcy serwer. Walidator przeglądarkowy unika obu tych problemów: kontrola odbywa się lokalnie, plik nie opuszcza komputera.
XRechnung czy ZUGFeRD: jakiego pliku oczekuje walidator
Przy sprawdzaniu decydujący jest typ pliku. XRechnung to czysty XML, który przesyłają Państwo bezpośrednio. Plik ZUGFeRD to natomiast PDF z osadzonym XML (załącznik factur-x.xml). Oficjalny walidator KoSIT sprawdza tylko czysty XML, musieliby więc Państwo najpierw wydobyć go z pliku PDF. Dobry walidator przeglądarkowy zdejmuje to z Państwa i automatycznie wyciąga XML z PDF ZUGFeRD.
Jeśli chcą Państwo plik tylko obejrzeć, a nie sprawdzić, właściwym narzędziem jest przeglądarka: przeglądarka XML przedstawia pola w czytelnej formie. Różnicę między otwieraniem, oglądaniem i sprawdzaniem pogłębia artykuł Otwieranie i odczyt ZUGFeRD i XRechnung.
Czytanie protokołu kontroli zamiast patrzenia tylko na kontrolkę
Użyteczny walidator nie wypisuje tylko „prawidłowa” lub „nieprawidłowa”, lecz protokół z konkretnymi kodami. Układają się one w stałe grupy:
| Grupa | Przykładowy kod | Znaczenie |
|---|---|---|
| BR | BR-16 | Faktura nie zawiera żadnej pozycji |
| BR-CO | BR-CO-10 | Suma pozycji nie zgadza się z kwotą łączną netto |
| BR-CO | BR-CO-15 | Netto plus podatek nie daje wykazanej kwoty brutto |
| BR-DE | BR-DE-01 | Brakuje Leitweg-ID (BT-10) przy fakturze dla urzędu |
Ważne jest rozróżnienie między błędem a ostrzeżeniem. Błąd czyni fakturę nieprawidłową i musi zostać usunięty. Ostrzeżenie to wskazówka, która nie uniemożliwia ważności, ale zwraca uwagę na nietypową informację. Jakie trzy błędy w praktyce powodują prawie wszystkie odrzucenia, pokazuje Dlaczego Państwa e-faktura jest odrzucana. Poszczególne kody można sprawdzić w kodach błędów XRechnung.
Prawidłowa nie znaczy automatycznie zaakceptowana
Zielony wynik kontroli potwierdza, że plik technicznie odpowiada EN 16931. Nie gwarantuje, że odbiorca go przyjmie. Urząd może mimo to odrzucić formalnie prawidłową XRechnung, na przykład dlatego, że Leitweg-ID ma wprawdzie właściwy format, ale nie wskazuje żadnego rzeczywistego celu, albo dlatego, że portal wpływu nie obsługuje określonego profilu. Takie przypadki i ich rozwiązania opisuje Powody odrzucenia XRechnung przez urzędy.
Walidacja jest więc pierwszym, koniecznym krokiem. Wyłapuje błędy techniczne, zanim faktura w ogóle zostanie wysłana.
Lepiej sprawdzić przed wysyłką niż poprawiać po fakcie
Największa korzyść z walidatora tkwi w momencie użycia. Odrzucona faktura oznacza dopytywanie, korektę, ponowną wysyłkę i opóźnioną płatność. Kto zamiast tego sprawdza każdy plik przed wysyłką, załatwia to w kilka sekund. Jak na stałe włączyć ten krok do procesu fakturowania, pokazuje Sprawdzanie e-faktury przed wysyłką.
Pragmatyczna droga
Dla większości małych i średnich przedsiębiorstw oficjalny walidator Java jest zbyt kłopotliwy, a internetowy uploader z punktu widzenia ochrony danych nieładny. Pomiędzy nimi znajduje się bezpłatny walidator ZUGFeRD i XRechnung: sprawdza XML XRechnung i PDF ZUGFeRD bezpośrednio w przeglądarce względem wszystkich reguł EN 16931, bez opuszczania pliku z komputera. Do samego sprawdzenia XRechnung istnieje obok niego walidator XRechnung.
Jeśli nie chcą Państwo tylko sprawdzać, lecz z istniejącego pliku PDF w ogóle dopiero wygenerować prawidłową e-fakturę, TaxLayer wyodrębnia dane, spójnie przelicza sumy i automatycznie waliduje wynik względem EN 16931, zanim go Państwo pobiorą. Pierwsze dwie konwersje miesięcznie są bezpłatne. Na pytania odpowiadamy pod adresem info@taxlayer.de.
Najczęściej zadawane pytania
Czym jest walidator XRechnung?
Walidator XRechnung to narzędzie kontrolne, które sprawdza e-fakturę względem europejskiej normy EN 16931, reguł obliczeniowych i niemieckich reguł CIUS dla XRechnung. Zgłasza każde odstępstwo jako kod błędu (na przykład BR-DE-01) i dzięki temu mówi Państwu przed wysyłką, czy plik jest prawidłowy. Walidator TaxLayer sprawdza XRechnung i ZUGFeRD bezpośrednio w przeglądarce.
Czy mogę bezpłatnie sprawdzić XRechnung online?
Tak. Walidator ZUGFeRD & XRechnung sprawdza Państwa plik bezpłatnie pod kątem wszystkich pól obowiązkowych EN 16931, i to bezpośrednio w przeglądarce, bez przesyłania na obcy serwer. Alternatywnie istnieje oficjalny walidator KoSIT jako narzędzie Java do instalacji lokalnej.
Czy walidator potrafi sprawdzać także pliki PDF ZUGFeRD?
Oficjalny walidator KoSIT sprawdza tylko czyste pliki XML. Plik PDF ZUGFeRD musieliby Państwo tam najpierw rozpakować. Walidator TaxLayer automatycznie wyodrębnia osadzony XML z pliku PDF i go sprawdza, dzięki czemu nie muszą Państwo rozbierać pliku ręcznie.
Co oznaczają kody błędów w protokole kontroli?
Kody układają się w stałe grupy: BR oznacza brakujące pola obowiązkowe (na przykład BR-16, brak pozycji), BR-CO błędy obliczeniowe (BR-CO-10 i BR-CO-15, gdy sumy do siebie nie pasują), a BR-DE niemieckie reguły szczególne (BR-DE-01, brak Leitweg-ID). Każdy kod można w razie potrzeby sprawdzić w kodach błędów XRechnung.
Czy prawidłowa e-faktura jest automatycznie akceptowana przez odbiorcę?
Niekoniecznie. Walidator sprawdza techniczną poprawność według EN 16931. Urząd może mimo to odrzucić formalnie prawidłową fakturę, na przykład z powodu błędnego Leitweg-ID lub nieobsługiwanego profilu. Więcej w artykule Powody odrzucenia XRechnung przez urzędy.
Jaka jest różnica między walidatorem a przeglądarką?
Przeglądarka tylko czyni fakturę czytelną, pokazuje pola. Walidator sprawdza dodatkowo, czy plik odpowiada wszystkim regułom. Jeśli chcą Państwo tylko obejrzeć otrzymany plik, proszę użyć przeglądarki XML. Jeśli chcą Państwo wiedzieć, czy jest prawidłowy, proszę użyć walidatora.
Czy muszę walidować każdą XRechnung przed wysyłką?
Ustawowo nie jest to wymagane, ale zdecydowanie zalecane. Nieprawidłowa faktura zostanie odrzucona przez odbiorcę lub ZRE i opóźni płatność. TaxLayer automatycznie waliduje każdy wygenerowany plik względem EN 16931, zanim go Państwo pobiorą.
Darmowe narzędzia
Powiązane artykuły
Konwertuj swoje faktury PDF teraz
Wypróbuj TaxLayer za darmo – 2 konwersje miesięcznie, bez karty kredytowej.
Rozpocznij