Walidator KoSIT: jak walidować pliki ZUGFeRD i XRechnung
Walidator KoSIT (Koordinierungsstelle fuer IT-Standards -- Urząd Koordynacji Standardów IT) to oficjalne narzędzie niemieckiej administracji do walidacji e-faktur. Każdy, kto wysyła pliki ZUGFeRD lub XRechnung, powinien je wcześniej zwalidować -- odrzucona faktura opóźnia płatność i powoduje niepotrzebną dodatkową pracę.
> Krótka odpowiedź: Walidator KoSIT sprawdza e-faktury pod kątem schematów XSD, reguł biznesowych i niemieckich reguł CIUS. Możesz go używać jako lokalne narzędzie Java lub alternatywnie skorzystać z bezpłatnego Walidatora ZUGFeRD i XRechnung bezpośrednio w przeglądarce.
Co dokładnie sprawdza Walidator KoSIT?
Walidator wykonuje pięć sekwencyjnych kontroli:
- Kontrola składni: Czy XML jest poprawnie sformowany?
- Kontrola schematu: Czy struktura jest zgodna ze schematem UBL 2.1 lub CII?
- Reguły biznesowe (BR): Czy wszystkie pola obowiązkowe są obecne? (BR-01 do BR-65)
- Reguły obliczeniowe (BR-CO): Czy sumy się zgadzają? (Netto + Podatek = Brutto)
- Reguły CIUS: Niemieckie reguły specyficzne dla XRechnung (BR-DE-01 do BR-DE-25)
Tylko gdy wszystkie pięć poziomów przejdzie pomyślnie, e-faktura jest uznawana za prawidłową. Pojedynczy błąd na dowolnym poziomie skutkuje odrzuceniem.
Jak mogę korzystać z Walidatora KoSIT?
Opcja 1: Walidator online
Różni dostawcy oferują Walidator KoSIT jako narzędzie online. Przesyłasz plik XML i natychmiast otrzymujesz wynik walidacji. Wadą jest to, że dane faktury są przesyłane na zewnętrzny serwer.
Opcja 2: Wiersz poleceń (Java)
Oficjalny Walidator to program Java:
- Zainstaluj Java Runtime (JRE 11+)
- Pobierz plik ZIP Walidatora
- Załaduj konfigurację (Scenarios) dla XRechnung lub ZUGFeRD
- Uruchom polecenie:
java -jar validationtool.jar -s scenarios.xml plik.xml
Opcja 3: Bezpłatny walidator w przeglądarce
Walidator ZUGFeRD i XRechnung na naszej stronie sprawdza plik XML bezpośrednio w przeglądarce pod kątem wszystkich wymaganych pól EN 16931. Bez instalacji, bez przesyłania -- plik nigdy nie opuszcza komputera.
Jakie są najczęstsze błędy walidacji?
| Błąd | Przyczyna | Rozwiązanie |
|---|---|---|
| BR-02 | Brak daty faktury | Dodaj BT-2 (IssueDate) |
| BR-06 | Brak nazwy sprzedawcy | Dodaj BT-27 (SellerName) |
| BR-16 | Brak pozycji | Dodaj co najmniej jedną InvoiceLine |
| BR-CO-10 | Nieprawidłowa suma | Sprawdź sumy pozycji |
| BR-DE-01 | Brak [Leitweg-ID](/blog/leitweg-id-wyjasnienie) | Dodaj BT-10 dla XRechnung |
Pełny przegląd pól obowiązkowych znajdziesz w artykule EN 16931: wszystkie pola obowiązkowe.
Dlaczego warto walidować przed wysłaniem?
Nieprawidłowa e-faktura jest natychmiast odrzucana przez instytucje rządowe za pośrednictwem ZRE. Firmy z zautomatyzowanymi systemami odbioru faktur również odrzucają wadliwe pliki. Rezultat: opóźnione płatności i niepotrzebny wysiłek korygujący.
Zwaliduj każdą e-fakturę przed wysłaniem za pomocą bezpłatnego Walidatora ZUGFeRD i XRechnung -- bezpośrednio w przeglądarce, bez przesyłania na serwer. Alternatywnie możesz utworzyć XRechnung za pomocą formularza Generator XRechnung -- walidacja jest wbudowana.
Jak TaxLayer waliduje automatycznie?
TaxLayer automatycznie waliduje każdą wygenerowaną e-fakturę pod kątem wszystkich wymaganych pól EN 16931, zanim plik będzie dostępny do pobrania. W ten sposób unikasz odrzuceń przez odbiorcę -- bez ręcznego etapu walidacji. Pierwsze dwie konwersje miesięcznie są bezpłatne.
Najczęściej zadawane pytania
Czym jest Walidator KoSIT?
Walidator KoSIT to oficjalne narzędzie Urzędu Koordynacji Standardów IT (Koordinierungsstelle fuer IT-Standards) do walidacji e-faktur. Waliduje pliki XML pod kątem schematów XSD, reguł Schematron i niemieckich reguł CIUS dla XRechnung.
Jakie kontrole wykonuje Walidator KoSIT?
Wykonuje pięć poziomów kontroli: kontrolę składni (poprawny XML), kontrolę schematu (struktura UBL/CII), reguły biznesowe (BR-01 do BR-65), reguły obliczeniowe (netto + podatek = brutto) i reguły CIUS (BR-DE-01 do BR-DE-25).
Czy istnieje bezpłatna alternatywa online dla Walidatora KoSIT?
Tak. Walidator ZUGFeRD i XRechnung od TaxLayer sprawdza plik bezpośrednio w przeglądarce pod kątem wszystkich wymaganych pól EN 16931 -- bez instalacji, bez przesyłania na serwer.
Co oznacza błąd BR-DE-01?
BR-DE-01 oznacza, że brakuje Leitweg-ID (BT-10). Ten błąd występuje w XRechnung, ponieważ Leitweg-ID jest tam polem obowiązkowym. Więcej szczegółów w artykule Leitweg-ID -- wyjaśnienie.
Czy mogę walidować pliki ZUGFeRD PDF za pomocą Walidatora?
Oficjalny Walidator KoSIT sprawdza tylko pliki XML. Walidator TaxLayer może również sprawdzać pliki ZUGFeRD PDF bezpośrednio w przeglądarce -- automatycznie wyodrębnia osadzony XML.
Czy muszę walidować każdą e-fakturę przed wysłaniem?
Nie jest to prawnie wymagane, ale zdecydowanie zalecane. Nieprawidłowa e-faktura zostanie odrzucona przez odbiorcę, opóźniając płatność. TaxLayer automatycznie waliduje zgodność z EN 16931 przed wygenerowaniem pliku.
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