KSeF FA(3) XSD rules and errors
Check XML structure against the official FA(3) schema, version 1-0E, CRD form 13775.
KSEF-XSD-* identifiers are assigned by XSDHub for XSD explanations. They are not official KSeF rejection codes. The first ten topics are editorial priorities, not measured error frequencies. Detailed correction guides are in Polish.
- KSEF-XSD-NAMESPACE — Faktura/@xmlns (Polski)
- KSEF-XSD-FORM — Naglowek/KodFormularza/@kodSystemowy (Polski)
- KSEF-XSD-SCHEMA — Naglowek/KodFormularza/@wersjaSchemy (Polski)
- KSEF-XSD-VARIANT — Naglowek/WariantFormularza (Polski)
- KSEF-XSD-CREATED — Naglowek/DataWytworzeniaFa (Polski)
- KSEF-XSD-NIP — Podmiot1/DaneIdentyfikacyjne/NIP (Polski)
- KSEF-XSD-CURRENCY — Fa/KodWaluty (Polski)
- KSEF-XSD-DATE — Fa/P_1 (Polski)
- KSEF-XSD-NUMBER — Fa/P_2 (Polski)
- KSEF-XSD-TOTAL — Fa/P_15 (Polski)
- KSEF-XSD-KIND — Fa/RodzajFaktury (Polski)
- KSEF-XSD-JST — Podmiot2/JST (Polski)
- KSEF-XSD-GV — Podmiot2/GV (Polski)
- KSEF-XSD-VAT — Fa/FaWiersz/P_12 (Polski)
- KSEF-XSD-ANNOTATION — Fa/Adnotacje/P_18 (Polski)
- KSEF-XSD-STRUCTURE — Naglowek/WariantFormularza (Polski)
The result covers XSD structure and data types only. Arithmetic, VAT treatment, NIP checksums, permissions, signatures, QR codes, KSeF acceptance and UPO are not checked. A pass is not certification.
FA(3) schema fields
Element declaration index from the official XSD. Occurrence limits apply to each declaration; choices and optional parent sections affect whether a field is required.
KodFormularza—locally defined type, 1..1WariantFormularza—locally defined type, 1..1DataWytworzeniaFa—locally defined type, 1..1SystemInfo—tns:TZnakowy, 0..1KodKraju—etd:TKodKraju, 1..1AdresL1—tns:TZnakowy512, 1..1AdresL2—tns:TZnakowy512, 0..1GLN—tns:TGLN, 0..1NrWiersza—tns:TNaturalny, 0..1Klucz—tns:TZnakowy, 1..1Wartosc—tns:TZnakowy, 1..1NrRB—tns:TNrRB, 1..1SWIFT—tns:SWIFT_Type, 0..1RachunekWlasnyBanku—tns:TRachunekWlasnyBanku, 0..1NazwaBanku—tns:TZnakowy, 0..1OpisRachunku—tns:TZnakowy, 0..1NIP—etd:TNrNIP, 1..1Nazwa—tns:TZnakowy512, 1..1NIP—etd:TNrNIP, 1..1KodUE—tns:TKodyKrajowUE, 1..1NrVatUE—tns:TNrVatUE, 1..1KodKraju—etd:TKodKraju, 0..1NrID—locally defined type, 1..1BrakID—etd:TWybor1, 1..1Nazwa—tns:TZnakowy512, 1..1NIP—etd:TNrNIP, 1..1IDWew—tns:TNIPIdWew, 1..1KodUE—tns:TKodyKrajowUE, 1..1NrVatUE—tns:TNrVatUE, 1..1KodKraju—etd:TKodKraju, 0..1NrID—locally defined type, 1..1BrakID—etd:TWybor1, 1..1Nazwa—tns:TZnakowy512, 1..1Faktura—locally defined type, 1..1Naglowek—tns:TNaglowek, 1..1Podmiot1—locally defined type, 1..1PrefiksPodatnika—tns:TKodyKrajowUE, 0..1NrEORI—tns:TZnakowy, 0..1DaneIdentyfikacyjne—tns:TPodmiot1, 1..1Adres—tns:TAdres, 1..1AdresKoresp—locally defined type, 0..1DaneKontaktowe—locally defined type, 0..3Email—etd:TAdresEmail, 0..1Telefon—tns:TNumerTelefonu, 0..1StatusInfoPodatnika—tns:TStatusInfoPodatnika, 0..1Podmiot2—locally defined type, 1..1NrEORI—tns:TZnakowy, 0..1DaneIdentyfikacyjne—tns:TPodmiot2, 1..1Adres—tns:TAdres, 0..1AdresKoresp—tns:TAdres, 0..1DaneKontaktowe—locally defined type, 0..3Email—etd:TAdresEmail, 0..1Telefon—tns:TNumerTelefonu, 0..1NrKlienta—tns:TZnakowy, 0..1IDNabywcy—locally defined type, 0..1JST—locally defined type, 1..1GV—locally defined type, 1..1Podmiot3—locally defined type, 0..100IDNabywcy—locally defined type, 0..1NrEORI—tns:TZnakowy, 0..1DaneIdentyfikacyjne—tns:TPodmiot3, 1..1Adres—tns:TAdres, 0..1AdresKoresp—tns:TAdres, 0..1DaneKontaktowe—locally defined type, 0..3Email—etd:TAdresEmail, 0..1Telefon—tns:TNumerTelefonu, 0..1Rola—tns:TRolaPodmiotu3, 1..1RolaInna—etd:TWybor1, 1..1OpisRoli—tns:TZnakowy, 1..1Udzial—tns:TProcentowy, 0..1NrKlienta—tns:TZnakowy, 0..1PodmiotUpowazniony—locally defined type, 0..1NrEORI—tns:TZnakowy, 0..1DaneIdentyfikacyjne—tns:TPodmiot1, 1..1Adres—tns:TAdres, 1..1AdresKoresp—tns:TAdres, 0..1DaneKontaktowe—locally defined type, 0..3EmailPU—etd:TAdresEmail, 0..1TelefonPU—tns:TNumerTelefonu, 0..1RolaPU—tns:TRolaPodmiotuUpowaznionego, 1..1Fa—locally defined type, 1..1KodWaluty—tns:TKodWaluty, 1..1P_1—tns:TDataT, 1..1P_1M—tns:TZnakowy, 0..1P_2—tns:TZnakowy, 1..1WZ—tns:TZnakowy, 0..1000P_6—tns:TDataT, 1..1OkresFa—locally defined type, 1..1P_6_Od—tns:TDataT, 1..1P_6_Do—tns:TDataT, 1..1P_13_1—tns:TKwotowy, 1..1P_14_1—tns:TKwotowy, 1..1P_14_1W—tns:TKwotowy, 0..1P_13_2—tns:TKwotowy, 1..1P_14_2—tns:TKwotowy, 1..1P_14_2W—tns:TKwotowy, 0..1P_13_3—tns:TKwotowy, 1..1P_14_3—tns:TKwotowy, 1..1P_14_3W—tns:TKwotowy, 0..1P_13_4—tns:TKwotowy, 1..1P_14_4—tns:TKwotowy, 1..1P_14_4W—tns:TKwotowy, 0..1P_13_5—tns:TKwotowy, 1..1P_14_5—tns:TKwotowy, 0..1P_13_6_1—tns:TKwotowy, 0..1P_13_6_2—tns:TKwotowy, 0..1P_13_6_3—tns:TKwotowy, 0..1P_13_7—tns:TKwotowy, 0..1P_13_8—tns:TKwotowy, 0..1P_13_9—tns:TKwotowy, 0..1P_13_10—tns:TKwotowy, 0..1P_13_11—tns:TKwotowy, 0..1P_15—tns:TKwotowy, 1..1KursWalutyZ—tns:TIlosci, 0..1Adnotacje—locally defined type, 1..1P_16—etd:TWybor1_2, 1..1P_17—etd:TWybor1_2, 1..1P_18—etd:TWybor1_2, 1..1P_18A—etd:TWybor1_2, 1..1Zwolnienie—locally defined type, 1..1P_19—etd:TWybor1, 1..1P_19A—tns:TZnakowy, 1..1P_19B—tns:TZnakowy, 1..1P_19C—tns:TZnakowy, 1..1P_19N—etd:TWybor1, 1..1NoweSrodkiTransportu—locally defined type, 1..1P_22—etd:TWybor1, 1..1P_42_5—etd:TWybor1_2, 1..1NowySrodekTransportu—locally defined type, 1..10000P_22A—tns:TDataT, 1..1P_NrWierszaNST—tns:TNaturalny, 1..1P_22BMK—tns:TZnakowy, 0..1P_22BMD—tns:TZnakowy, 0..1P_22BK—tns:TZnakowy, 0..1P_22BNR—tns:TZnakowy, 0..1P_22BRP—tns:TZnakowy, 0..1P_22B—tns:TZnakowy, 1..1P_22B1—tns:TZnakowy, 0..1P_22B2—tns:TZnakowy, 0..1P_22B3—tns:TZnakowy, 0..1P_22B4—tns:TZnakowy, 0..1P_22BT—tns:TZnakowy, 0..1P_22C—tns:TZnakowy, 1..1P_22C1—tns:TZnakowy, 0..1P_22D—tns:TZnakowy, 1..1P_22D1—tns:TZnakowy, 0..1P_22N—etd:TWybor1, 1..1P_23—etd:TWybor1_2, 1..1PMarzy—locally defined type, 1..1P_PMarzy—etd:TWybor1, 1..1P_PMarzy_2—etd:TWybor1, 1..1P_PMarzy_3_1—etd:TWybor1, 1..1P_PMarzy_3_2—etd:TWybor1, 1..1P_PMarzy_3_3—etd:TWybor1, 1..1P_PMarzyN—etd:TWybor1, 1..1RodzajFaktury—tns:TRodzajFaktury, 1..1PrzyczynaKorekty—tns:TZnakowy, 0..1TypKorekty—tns:TTypKorekty, 0..1DaneFaKorygowanej—locally defined type, 1..50000DataWystFaKorygowanej—tns:TDataT, 1..1NrFaKorygowanej—tns:TZnakowy, 1..1NrKSeF—etd:TWybor1, 1..1NrKSeFFaKorygowanej—tns:TNumerKSeF, 1..1NrKSeFN—etd:TWybor1, 1..1OkresFaKorygowanej—tns:TZnakowy, 0..1NrFaKorygowany—tns:TZnakowy, 0..1Podmiot1K—locally defined type, 0..1PrefiksPodatnika—tns:TKodyKrajowUE, 0..1DaneIdentyfikacyjne—tns:TPodmiot1, 1..1Adres—tns:TAdres, 1..1Podmiot2K—locally defined type, 0..101DaneIdentyfikacyjne—tns:TPodmiot2, 1..1Adres—tns:TAdres, 0..1IDNabywcy—locally defined type, 0..1P_15ZK—tns:TKwotowy, 1..1KursWalutyZK—tns:TIlosci, 0..1ZaliczkaCzesciowa—locally defined type, 0..31P_6Z—tns:TDataT, 1..1P_15Z—tns:TKwotowy, 1..1KursWalutyZW—tns:TIlosci, 0..1FP—etd:TWybor1, 0..1TP—etd:TWybor1, 0..1DodatkowyOpis—tns:TKluczWartosc, 0..10000FakturaZaliczkowa—locally defined type, 0..100NrKSeFZN—etd:TWybor1, 1..1NrFaZaliczkowej—tns:TZnakowy, 1..1NrKSeFFaZaliczkowej—tns:TNumerKSeF, 1..1ZwrotAkcyzy—etd:TWybor1, 0..1FaWiersz—locally defined type, 0..10000NrWierszaFa—tns:TNaturalny, 1..1UU_ID—tns:TZnakowy50, 0..1P_6A—tns:TDataT, 0..1P_7—tns:TZnakowy512, 0..1Indeks—tns:TZnakowy50, 0..1GTIN—tns:TZnakowy20, 0..1PKWiU—tns:TZnakowy50, 0..1CN—tns:TZnakowy50, 0..1PKOB—tns:TZnakowy50, 0..1P_8A—tns:TZnakowy, 0..1P_8B—tns:TIlosci, 0..1P_9A—tns:TKwotowy2, 0..1P_9B—tns:TKwotowy2, 0..1P_10—tns:TKwotowy2, 0..1P_11—tns:TKwotowy, 0..1P_11A—tns:TKwotowy, 0..1P_11Vat—tns:TKwotowy, 0..1P_12—tns:TStawkaPodatku, 0..1P_12_XII—tns:TProcentowy, 0..1P_12_Zal_15—etd:TWybor1, 0..1KwotaAkcyzy—tns:TKwotowy, 0..1GTU—tns:TGTU, 0..1Procedura—tns:TOznaczenieProcedury, 0..1KursWaluty—tns:TIlosci, 0..1StanPrzed—etd:TWybor1, 0..1Rozliczenie—locally defined type, 0..1Obciazenia—locally defined type, 0..100Kwota—tns:TKwotowy, 1..1Powod—tns:TZnakowy, 1..1SumaObciazen—tns:TKwotowy, 0..1Odliczenia—locally defined type, 0..100Kwota—tns:TKwotowy, 1..1Powod—tns:TZnakowy, 1..1SumaOdliczen—tns:TKwotowy, 0..1DoZaplaty—tns:TKwotowy, 1..1DoRozliczenia—tns:TKwotowy, 1..1Platnosc—locally defined type, 0..1Zaplacono—etd:TWybor1, 1..1DataZaplaty—tns:TData, 1..1ZnacznikZaplatyCzesciowej—etd:TWybor1_2, 1..1ZaplataCzesciowa—locally defined type, 1..100KwotaZaplatyCzesciowej—tns:TKwotowy, 1..1DataZaplatyCzesciowej—tns:TData, 1..1FormaPlatnosci—tns:TFormaPlatnosci, 1..1PlatnoscInna—etd:TWybor1, 1..1OpisPlatnosci—tns:TZnakowy, 1..1TerminPlatnosci—locally defined type, 0..100Termin—tns:TData, 0..1TerminOpis—locally defined type, 0..1Ilosc—xsd:integer, 1..1Jednostka—tns:TZnakowy50, 1..1ZdarzeniePoczatkowe—tns:TZnakowy, 1..1FormaPlatnosci—tns:TFormaPlatnosci, 1..1PlatnoscInna—etd:TWybor1, 1..1OpisPlatnosci—tns:TZnakowy, 1..1RachunekBankowy—tns:TRachunekBankowy, 0..100RachunekBankowyFaktora—tns:TRachunekBankowy, 0..20Skonto—locally defined type, 0..1WarunkiSkonta—tns:TZnakowy, 1..1WysokoscSkonta—tns:TZnakowy, 1..1LinkDoPlatnosci—locally defined type, 0..1IPKSeF—locally defined type, 0..1WarunkiTransakcji—locally defined type, 0..1Umowy—locally defined type, 0..100DataUmowy—tns:TDataU, 0..1NrUmowy—tns:TZnakowy, 0..1Zamowienia—locally defined type, 0..100DataZamowienia—tns:TDataU, 0..1NrZamowienia—tns:TZnakowy, 0..1NrPartiiTowaru—tns:TZnakowy, 0..1000WarunkiDostawy—tns:TZnakowy, 0..1KursUmowny—tns:TIlosci, 1..1WalutaUmowna—tns:TKodWaluty, 1..1Transport—locally defined type, 0..20RodzajTransportu—tns:TRodzajTransportu, 1..1TransportInny—etd:TWybor1, 1..1OpisInnegoTransportu—tns:TZnakowy50, 1..1Przewoznik—locally defined type, 0..1DaneIdentyfikacyjne—tns:TPodmiot2, 1..1AdresPrzewoznika—tns:TAdres, 1..1NrZleceniaTransportu—tns:TZnakowy, 0..1OpisLadunku—tns:TLadunek, 1..1LadunekInny—etd:TWybor1, 1..1OpisInnegoLadunku—tns:TZnakowy50, 1..1JednostkaOpakowania—tns:TZnakowy, 0..1DataGodzRozpTransportu—tns:TDataCzas, 0..1DataGodzZakTransportu—tns:TDataCzas, 0..1WysylkaZ—tns:TAdres, 0..1WysylkaPrzez—tns:TAdres, 0..20WysylkaDo—tns:TAdres, 0..1PodmiotPosredniczacy—etd:TWybor1, 0..1Zamowienie—locally defined type, 0..1WartoscZamowienia—tns:TKwotowy, 1..1ZamowienieWiersz—locally defined type, 1..10000NrWierszaZam—tns:TNaturalny, 1..1UU_IDZ—tns:TZnakowy50, 0..1P_7Z—tns:TZnakowy512, 0..1IndeksZ—tns:TZnakowy50, 0..1GTINZ—tns:TZnakowy20, 0..1PKWiUZ—tns:TZnakowy50, 0..1CNZ—tns:TZnakowy50, 0..1PKOBZ—tns:TZnakowy50, 0..1P_8AZ—tns:TZnakowy, 0..1P_8BZ—tns:TIlosci, 0..1P_9AZ—tns:TKwotowy2, 0..1P_11NettoZ—tns:TKwotowy, 0..1P_11VatZ—tns:TKwotowy, 0..1P_12Z—tns:TStawkaPodatku, 0..1P_12Z_XII—tns:TProcentowy, 0..1P_12Z_Zal_15—etd:TWybor1, 0..1GTUZ—tns:TGTU, 0..1ProceduraZ—tns:TOznaczenieProceduryZ, 0..1KwotaAkcyzyZ—tns:TKwotowy, 0..1StanPrzedZ—etd:TWybor1, 0..1Stopka—locally defined type, 0..1Informacje—locally defined type, 0..3StopkaFaktury—etd:TTekstowy, 0..1Rejestry—locally defined type, 0..100PelnaNazwa—tns:TZnakowy, 0..1KRS—etd:TNrKRS, 0..1REGON—etd:TNrREGON, 0..1BDO—locally defined type, 0..1Zalacznik—locally defined type, 0..1BlokDanych—locally defined type, 1..1000ZNaglowek—tns:TZnakowy512, 0..1MetaDane—locally defined type, 1..1000ZKlucz—tns:TZnakowy, 1..1ZWartosc—tns:TZnakowy, 1..1Tekst—locally defined type, 0..1Akapit—tns:TZnakowy512, 1..10Tabela—locally defined type, 0..1000TMetaDane—locally defined type, 0..1000TKlucz—tns:TZnakowy, 1..1TWartosc—tns:TZnakowy, 1..1Opis—tns:TZnakowy512, 0..1TNaglowek—locally defined type, 1..1Kol—locally defined type, 1..20NKom—locally defined type, 1..1Wiersz—locally defined type, 1..1000WKom—tns:TZnakowy2, 1..20Suma—locally defined type, 0..1SKom—tns:TZnakowy2, 1..20
Sources and reuse conditions
Ministerstwo Finansów: FA(3) · CRD 13775 · XSD + manifest + NOTICES · NOTICES