XSDHub

Jak sprawdzić fakturę KSeF FA(3)

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

Sprawdzenie w przeglądarce

  1. Wyeksportuj XML faktury w formacie FA(3). Sam PDF nie wystarczy.
  2. Otwórz walidator KSeF, wybierz plik UTF-8 do 10 MB albo wklej XML.
  3. Wyraź zgodę na przetwarzanie na serwerze XSDHub i wybierz „Sprawdź FA(3)”.
  4. 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. 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).

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) · CRD 13775 · XSD + manifest + NOTICES · NOTICES