Średniozaawansowany15 minWalidacja XML

Walidacja XML faktury przed wysłaniem do KSeF

Jak sprawdzić poprawność pliku XML faktury przed wysłaniem do KSeF aby uniknąć błędów.

12 890 wyświetleń5678 ukończonych5234 pomocne

Przed rozpoczęciem

Podstawowa znajomość struktury XML
Plik XML faktury do walidacji

Potrzebne narzędzia

NaprawKSeF (lub inny walidator)Edytor tekstu/XML

Kroki (6)

Przygotuj plik XML do walidacji

Upewnij się, że masz plik XML faktury w formacie zgodnym ze schematem FA(2). Plik powinien zawierać wszystkie wymagane elementy: dane sprzedawcy, nabywcy, pozycje faktury, sumy i daty.

Oczekiwany rezultatMasz gotowy plik XML do sprawdzenia.

Otwórz NaprawKSeF Walidator

Przejdź na stronę NaprawKSeF i wybierz opcję 'Walidator' z menu głównego. Możesz też użyć bezpośredniego linku do walidatora.

Oczekiwany rezultatWidzisz interfejs walidatora z polem do uploadu pliku.

Załaduj plik XML

Kliknij w pole uploadu lub przeciągnij plik XML na wyznaczony obszar. Walidator automatycznie rozpocznie analizę pliku.

Oczekiwany rezultatPlik został załadowany i widoczny jest postęp walidacji.

Jeśli coś poszło nie takJeśli plik nie ładuje się, sprawdź czy ma rozszerzenie .xml i czy nie jest uszkodzony.

Przeanalizuj wyniki walidacji

Po zakończeniu walidacji zobaczysz listę znalezionych problemów podzieloną na: - Błędy krytyczne (czerwone) - uniemożliwiają wysłanie - Ostrzeżenia (żółte) - mogą powodować problemy - Informacje (niebieskie) - sugestie do poprawy Każdy problem zawiera kod błędu, opis i lokalizację w pliku.

Oczekiwany rezultatWidzisz szczegółową listę problemów z faktury.

Użyj funkcji Auto-naprawa

Dla błędów oznaczonych ikoną naprawy, kliknij przycisk 'Napraw automatycznie'. NaprawKSeF potrafi automatycznie poprawić wiele typowych błędów: - Błędne formaty NIP - Nieprawidłowe formaty dat - Złe kody walut i krajów - Błędy zaokrągleń VAT - I wiele innych

Przykładowe auto-naprawy:
- NIP: 123-456-78-90 → 1234567890
- Data: 2026/01/15 → 2026-01-15
- Waluta: pln → PLN
- Kraj: Polska → PL

Oczekiwany rezultatCzęść błędów została automatycznie naprawiona.

Jeśli coś poszło nie takNiektóre błędy (np. błędna suma kontrolna NIP) wymagają ręcznej weryfikacji - system nie może zgadnąć prawidłowego numeru.

Pobierz poprawiony plik

Po automatycznej naprawie lub ręcznych poprawkach, kliknij 'Pobierz poprawiony XML'. Plik jest gotowy do wysłania do KSeF.

Oczekiwany rezultatMasz poprawiony plik XML bez błędów krytycznych.

Jeśli coś poszło nie takJeśli nadal są błędy, popraw je ręcznie w edytorze XML i ponownie zwaliduj.

Rozwiązuje błędy

XML-001 XML-002 XML-003 XML-004

Ukończyłeś playbook?

Oznacz jako ukończony i podziel się opinią