Oficjalna treść reguły
[PODMIOT3_ROLE_MISSING] When Podmiot3 has no Rola, both RolaInna and OpisRoli must be present. When RolaInna = '1', OpisRoli is mandatory (§7.3)
Dlaczego pojawia się ten błąd
KSeF sprawdza XML FA(3) w dwóch etapach: schemat XSD (struktura, kolejność elementów, typy danych, wzorce jak NIP czy daty) oraz reguły semantyczne z broszury informacyjnej Ministerstwa Finansów (spójność kwot, adnotacje P_16 do P_23, role Podmiot2/Podmiot3, format rachunku bankowego, kursy walut).
Jak to naprawić
Popraw element wskazany w komunikacie. Przy błędach XSD porównaj kolejność elementów i wzorzec wartości ze schematem FA(3); przy błędach semantycznych zastosuj przyczyny i wskazówki z tej strony. Zwaliduj ponownie przed wysyłką: odrzucona faktura nie otrzymuje numeru KSeF i nie jest wystawiona.
Co sprawdza walidator
Typowe przyczyny
- Missing role definition for Podmiot3
- RolaInna = 1 but OpisRoli not provided
Sprawdź swoją fakturę
Upuść plik XML lub PDF w walidatorze; każda naruszona reguła ma link do swojej strony tutaj. Bezpłatnie, bez konta, plik nie jest zapisywany.
To samo sprawdzenie przez API:
curl -F file=@invoice.xml https://einvoicechecker.com/v1/validatePowiązane reguły
ADNOTACJE_NST_MISSINGElement NoweSrodkiTransportu jest obowiązkowy w Adnotacje (§9.6)ADNOTACJE_P16_MISSINGElement P_16 jest obowiązkowy w Adnotacje (§9.6)ADNOTACJE_P17_MISSINGElement P_17 jest obowiązkowy w Adnotacje (§9.6)ADNOTACJE_P18_MISSINGElement P_18 jest obowiązkowy w Adnotacje (§9.6)ADNOTACJE_P18A_MISSINGElement P_18A jest obowiązkowy w Adnotacje (§9.6)ADNOTACJE_P23_MISSINGElement P_23 jest obowiązkowy w Adnotacje (§9.6)ADNOTACJE_PMARZY_MISSINGElement PMarzy jest obowiązkowy w Adnotacje (§9.6)ADNOTACJE_ZWOLNIENIE_MISSINGElement Zwolnienie jest obowiązkowy w Adnotacje (§9.6)
Najczęstsze pytania
Co oznacza PODMIOT3_ROLE_MISSING?
PODMIOT3_ROLE_MISSING to reguła ksef fa(3): When Podmiot3 has no Rola, both RolaInna and OpisRoli must be present. When RolaInna = '1', OpisRoli is mandatory (§7.3)
Czy moja faktura zostanie odrzucona z powodu PODMIOT3_ROLE_MISSING?
Tak. PODMIOT3_ROLE_MISSING ma status „krytyczny”; walidatory (KSeF, punkty dostępowe Peppol, KoSIT) odrzucają fakturę do czasu poprawienia błędu.
Jakich formatów dotyczy PODMIOT3_ROLE_MISSING?
Faktury ustrukturyzowane (schemat FA(3)) przesyłane do KSeF. Kody XSD pochodzą ze schematu, kody semantyczne z broszury informacyjnej Ministerstwa Finansów; KSeF odrzuca fakturę przy błędzie. Składnia: FA3.
Źródło: KSeF FA(3) schema 1-0E + semantic rules (@ksefuj/validator 0.4). Katalog wygenerowany z oficjalnych zestawów reguł dnia 2026-10-15.