TaxLayer
Zaloguj sięRozpocznij za darmo
Techniczny2025-04-055 min czytaniaprzez TaxLayer Team

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:

  1. Kontrola składni: Czy XML jest poprawnie sformowany?
  2. Kontrola schematu: Czy struktura jest zgodna ze schematem UBL 2.1 lub CII?
  3. Reguły biznesowe (BR): Czy wszystkie pola obowiązkowe są obecne? (BR-01 do BR-65)
  4. Reguły obliczeniowe (BR-CO): Czy sumy się zgadzają? (Netto + Podatek = Brutto)
  5. 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:

  1. Zainstaluj Java Runtime (JRE 11+)
  2. Pobierz plik ZIP Walidatora
  3. Załaduj konfigurację (Scenarios) dla XRechnung lub ZUGFeRD
  4. 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łądPrzyczynaRozwiązanie
BR-02Brak daty fakturyDodaj BT-2 (IssueDate)
BR-06Brak nazwy sprzedawcyDodaj BT-27 (SellerName)
BR-16Brak pozycjiDodaj co najmniej jedną InvoiceLine
BR-CO-10Nieprawidłowa sumaSprawdź sumy pozycji
BR-DE-01Brak [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.

Konwertuj swoje faktury PDF teraz

Wypróbuj TaxLayer za darmo — 2 konwersje miesięcznie, bez karty kredytowej.

Rozpocznij