KSEF-XSD-FORM: KodFormularza: kodSystemowy
KodFormularza opisuje formularz za pomocą treści elementu i jego atrybutów. Treść ma wartość FA, natomiast atrybut kodSystemowy ma stałą wartość FA (3). Nie należy wpisywać FA (3) zamiast treści FA ani używać wartości FA (2) przy przestrzeni nazw nowego wzoru. Deklaracja typu TNaglowek wiąże KodFormularza z typem TKodFormularza i rozszerza go o wymagane atrybuty. Ograniczenie fixed dotyczy dokładnej wartości atrybutu, łącznie ze spacją i nawiasami. W testowej parze zmieniono tylko kodSystemowy, pozostawiając wersjaSchemy i WariantFormularza bez zmian. Dlatego komunikat wskazuje ograniczenie stałej wartości, a nie brak elementu. Popraw to pole w generatorze nagłówka, zamiast zmieniać numer faktury lub datę. Stała identyfikuje techniczny formularz; nie jest numerem nadawanym fakturze przez KSeF i nie potwierdza przesłania dokumentu do systemu.
Deklaracja XSD i ograniczenia
Deklaracja KodFormularza: typ lokalny, wystąpienia 1..1. Ograniczenia: base=xsd:string. Liczba wartości w pokazanych wyliczeniach: 1.
<xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="KodFormularza">
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="tns:TKodFormularza">
<xsd:attribute name="kodSystemowy" type="xsd:string" use="required" fixed="FA (3)" />
<xsd:attribute name="wersjaSchemy" type="xsd:string" use="required" fixed="1-0E" />
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element><xsd:simpleType xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="TKodFormularza">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="FA" />
</xsd:restriction>
</xsd:simpleType>Kontrolowana para przykładów
Własna para syntetyczna KSEF-XSD-FORM: błędny pełny XML nie przechodzi kontroli, a poprawiony dokument przechodzi ten sam schemat FA(3) 1-0E. Zmienione pole: Naglowek/KodFormularza/@kodSystemowy.
Błędny fragment
<ns0:KodFormularza xmlns:ns0="http://crd.gov.pl/wzor/2025/06/25/13775/" kodSystemowy="FA (2)" wersjaSchemy="1-0E">FA</ns0:KodFormularza>
Poprawny fragment
<ns0:KodFormularza xmlns:ns0="http://crd.gov.pl/wzor/2025/06/25/13775/" kodSystemowy="FA (3)" wersjaSchemy="1-0E">FA</ns0:KodFormularza>
Powiązane pola i objaśnienia
Komunikat i miejsce w raporcie
Element '{http://crd.gov.pl/wzor/2025/06/25/13775/}KodFormularza', attribute 'kodSystemowy': The value 'FA (2)' does not match the fixed value constraint 'FA (3)'.Raport JSON: errors[].code wskazuje KSEF-XSD-FORM, errors[].message zachowuje angielski tekst, a errors[].line podaje wiersz, jeżeli silnik go udostępnia. Interfejs pokazuje komunikat w sekcji wyników kontroli XSD.