E-faktury w Polsce: KSeF FA(3) i zakres kontroli
Zanim wyślesz fakturę do KSeF, sprawdź jej strukturę i poznaj granice tego wyniku. Zebraliśmy format, zastosowany schemat oraz odsyłacze do wyjaśnień błędów.
Formaty i składnia
FA(3) jest polską strukturą logiczną faktury opublikowaną przez Ministerstwo Finansów. Oficjalny wzór znajduje się w repozytorium CRD pod numerem 13775. To odrębny format XML, a nie wariant UBL lub CII. Zmiana nazwy korzenia dokumentu nie przenosi znaczenia pól pomiędzy tymi strukturami. Dokumentacja ministerstwa opisuje elementy, ich kolejność i przykładowe dokumenty, z którymi można porównać eksport z programu księgowego.
Reguły stosowane przez XSDHub
XSDHub stosuje FA(3) 1-0E z CRD 13775 i walidację XSD 1.0. Sprawdzane są ograniczenia struktury, typy danych oraz wartości zapisane w schemacie. Narzędzie nie oblicza podatku, nie potwierdza rachunkowej poprawności faktury i nie odtwarza reguł przyjęcia dokumentu przez KSeF. Poprawny wynik dotyczy wyłącznie tej warstwy technicznej. Nie stanowi certyfikatu ani potwierdzenia uprawnień osoby wysyłającej.
Kogo to dotyczy?
W relacji B2B przedsiębiorca wystawia fakturę innemu przedsiębiorcy. KAS opisuje etapy obowiązku korzystania z KSeF oraz wyjątki dotyczące części podatników. B2G oznacza odbiorcę z sektora publicznego, lecz sama etykieta nie rozstrzyga wszystkich wymagań. Zakres dla konkretnej transakcji sprawdź w urzędowym objaśnieniu. Uprawnienia, sposób przesłania i potwierdzenie odbioru wymagają czynności poza lokalną kontrolą struktury XML.
Typowe błędy do sprawdzenia
- Przestrzeń nazw FA(3) — Porównaj namespace z bieżącym wzorem FA(3), zamiast pozostawiać wartość z FA(2).
- Kolejność elementów — Umieść pola zgodnie z sekwencją schematu, także wtedy, gdy pole jest opcjonalne.
- Typ danych — Sprawdź zapis daty i liczby przed szukaniem przyczyny w obliczeniu podatku.
| Kontrola | Zakres XSDHub |
|---|---|
| Struktura XML i stałe reguły | KSeF FA(3) 1-0E / CRD 13775; XSD 1.0 only |
| Certyfikacja i akceptacja prawna | Poza zakresem |
| Wysyłka do portalu urzędowego | Poza zakresem |
| Peppol | Jeszcze nieobsługiwany |
Praca z wynikiem
Zachowaj oryginalny plik i zanotuj wybraną wersję schematu. Zacznij od pierwszego błędu strukturalnego, ponieważ nieprawidłowy element nadrzędny może wywołać następne komunikaty. Po korekcie wyeksportuj fakturę ponownie. Pozytywny raport XSD pozostawia jeszcze sprawdzenia biznesowe i oficjalną procedurę KSeF. Wybrane poradniki przedstawiają praktyczne przypadki, a nie statystykę błędów użytkowników. Plany i dokumentacja integracji zachowują istniejący cennik.