Source: https://xsdhub.com/pl/jak-sprawdzic-fakture-ksef

Jak sprawdzić fakturę KSeF FA(3)

Sprawdź plik XML przed wysyłką do KSeF i odczytaj wynik kontroli XSD.

Sprawdzenie w przeglądarce

Wyeksportuj XML faktury w formacie FA(3). Sam PDF nie wystarczy.

Otwórz [walidator KSeF](/pl/walidator-ksef), wybierz plik UTF-8 do 10 MB albo wklej XML.

Wyraź zgodę na przetwarzanie na serwerze XSDHub i wybierz „Sprawdź FA(3)”.

Odczytaj pole i numer wiersza błędu. Zacznij od pierwszego problemu, popraw plik w systemie źródłowym i sprawdź go ponownie.

Jak rozumieć wynik

Zielony wynik oznacza zgodność struktury i typów danych z konkretnym XSD. Obliczenia, zastosowanie stawki VAT, sumy kontrolne NIP oraz rzeczywiste przyjęcie w KSeF wymagają innych kontroli. Prawidłowo zapisany, ale błędny rachunkowo P_15 może przejść tę walidację.

API: standard=ksef

Wyślij JSON do POST https://xsdhub.com/api/invoice-validate. Pole xml zawiera pełną treść XML, standard ma wartość ksef, a consent musi mieć wartość logiczną true.

{"xml": "<Faktura xmlns=\"http://crd.gov.pl/wzor/2025/06/25/13775/\">…</Faktura>", "standard": "ksef", "consent": true}

To skrócony przykład struktury żądania; wielokropek nie zastępuje pełnej faktury. Użyj pełnego [testowego XML](/ksef-examples/valid.xml). HTTP 200 oznacza ukończenie żądania; sprawdź także ok, errors i truncated. Wynik z uciętym raportem wymaga ponownej kontroli.

Dotychczasowy klucz API przekazuje się w nagłówku Authorization: Bearer. Obowiązują te same limity faktur i ceny: anonimowo 10 żądań na minutę na adres IP; Pro 250 sprawdzeń faktur na dobę UTC, Team 1000 współdzielonych w zespole. Nieprawidłowy lub unieważniony klucz zwraca 401, wygasły płatny dostęp 402, przekroczony limit 429. Szczegóły: [dokumentacja API (angielski)](/developers).

Prywatność i bezpieczeństwo

XSDHub przetwarza XML po wyrażeniu zgody. Pliki tymczasowe są usuwane po zakończeniu; treść żądań nie jest logowana. DTD, encje zewnętrzne i zdalne schematy podane przez użytkownika są blokowane. Sprawdzenie trwa najwyżej 20 sekund.

Wynik dotyczy wyłącznie struktury i typów danych w XSD. Nie potwierdza poprawności obliczeń, stawek VAT ani sumy kontrolnej NIP. Nie sprawdzamy uprawnień, podpisów, kodów QR, przyjęcia faktury przez KSeF ani UPO. Wynik nie jest certyfikatem.

Źródła i warunki wykorzystania

[Ministerstwo Finansów: FA(3)](https://ksef.podatki.gov.pl/informacje-ogolne-ksef-20/struktura-logiczna-fa-3/) · [CRD 13775](https://crd.gov.pl/wzor/2025/06/25/13775/) · [XSD + manifest + NOTICES](/ksef-sources.tar.gz) · [NOTICES](/ksef-NOTICES.txt)