Wprowadzenie
Nagłówek to pierwsza wymagana sekcja każdej faktury FA(3). Identyfikuje wersję formularza i zapisuje dokładny moment wygenerowania dokumentu XML. Składa się z czterech pól: KodFormularza, WariantFormularza, DataWytworzeniaFa i opcjonalnego SystemInfo.
Cztery pola nagłówka
KodFormularza to symbol formularza i zawsze ma wartość FA, z dwoma stałymi atrybutami: kodSystemowy="FA (3)" oraz wersjaSchemy="1-0E". To nie są wartości do wyboru — muszą wystąpić dokładnie w takiej postaci, żeby dokument przeszedł walidację względem schematu FA(3). WariantFormularza w strukturze FA(3) zawsze wynosi 3; nie zmieniaj go.
DataWytworzeniaFa to data i godzina wygenerowania faktury, w formacie znacznika czasu ISO 8601 z przyrostkiem Z oznaczającym UTC, na przykład 2026-10-12T07:23:07Z. Schemat ogranicza ją do przedziału od 1 września 2025 do 1 stycznia 2050. To nie to samo, co biznesowa data wystawienia P_1, która leży w sekcji Fa.
SystemInfo to opcjonalne pole tekstowe o długości do 256 znaków, podające nazwę systemu teleinformatycznego, który utworzył fakturę. Notaly wpisuje tu "einvoice-api".
Dlaczego nagłówek ma znaczenie
Nagłówek mówi KSeF, której wersji schematu używa dokument. Błędny KodFormularza albo wersjaSchemy sprawia, że cały dokument nie przechodzi walidacji, zanim system w ogóle przeczyta dane transakcyjne. Ponieważ te wartości są stałe, nagłówek jest najłatwiejszą częścią faktury do poprawnego wypełnienia — ale też najłatwiejszą do zepsucia przy ręcznej edycji.
Uwaga na strefę czasową: DataWytworzeniaFa to czas UTC (przyrostek Z), a nie czas lokalny wystawcy. Jeśli wygenerujesz fakturę tuż po północy czasu polskiego, data UTC może wskazywać jeszcze poprzedni dzień — to normalne i nie wpływa na biznesową datę wystawienia P_1. Najczęstszy powód odrzucenia nagłówka to ręczna zmiana KodFormularza albo wersji schematu na własną, dlatego nie edytuj tych wartości.
Gdzie leży w dokumencie
Nagłówek znajduje się przed Podmiot1 (sprzedawcą) i Podmiot2 (nabywcą). To metadane o dokumencie, a nie o transakcji; daty transakcyjne leżą w sekcji Fa — P_1 to data wystawienia, a P_6 to opcjonalna data dostawy.
Jeśli wysyłasz faktury przez API Notaly, nie musisz samodzielnie tworzyć nagłówka — serwer wypełnia wszystkie cztery pola przy każdym wywołaniu POST /invoices, więc nagłówek zawsze jest zgodny ze schematem. Warto jednak rozumieć jego zawartość, zwłaszcza gdy weryfikujesz wygenerowany XML lub porównujesz go z dokumentem utworzonym ręcznie.
Kompletny, poprawny przykład FA(3) z wypełnionym nagłówkiem znajdziesz poniżej.
<Faktura xmlns="http://crd.gov.pl/wzor/2025/06/25/13775/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Naglowek>
<KodFormularza kodSystemowy="FA (3)" wersjaSchemy="1-0E">FA</KodFormularza>
<WariantFormularza>3</WariantFormularza>
<DataWytworzeniaFa>2026-10-12T07:23:07Z</DataWytworzeniaFa>
<SystemInfo>einvoice-api</SystemInfo>
</Naglowek>
<Podmiot1>
<DaneIdentyfikacyjne><NIP>2745013933</NIP><Nazwa>Example Sp. z o.o. (FICTIONAL)</Nazwa></DaneIdentyfikacyjne>
<Adres><KodKraju>PL</KodKraju><AdresL1>ul. Testowa 1, 00-001 Warszawa</AdresL1></Adres>
</Podmiot1>
<Podmiot2>
<DaneIdentyfikacyjne><NIP>1234563218</NIP><Nazwa>Test Customer S.A. (FICTIONAL)</Nazwa></DaneIdentyfikacyjne>
<Adres><KodKraju>PL</KodKraju><AdresL1>ul. Probna 2, 30-001 Kraków</AdresL1></Adres>
<JST>2</JST>
<GV>2</GV>
</Podmiot2>
<Fa>
<KodWaluty>PLN</KodWaluty>
<P_1>2026-10-12</P_1>
<P_2>FV/2026/10/001</P_2>
<P_13_1>1000.00</P_13_1><P_14_1>230.00</P_14_1>
<P_13_2>301.00</P_13_2><P_14_2>24.08</P_14_2>
<P_15>1555.08</P_15>
<Adnotacje>
<P_16>2</P_16><P_17>2</P_17><P_18>2</P_18><P_18A>2</P_18A>
<Zwolnienie><P_19N>1</P_19N></Zwolnienie>
<NoweSrodkiTransportu><P_22N>1</P_22N></NoweSrodkiTransportu>
<P_23>2</P_23>
<PMarzy><P_PMarzyN>1</P_PMarzyN></PMarzy>
</Adnotacje>
<RodzajFaktury>VAT</RodzajFaktury>
<FaWiersz>
<NrWierszaFa>1</NrWierszaFa>
<P_7>SaaS subscription - October</P_7>
<P_8A>pcs.</P_8A>
<P_8B>1</P_8B>
<P_9A>1000.00</P_9A>
<P_11>1000.00</P_11>
<P_12>23</P_12>
</FaWiersz>
<FaWiersz>
<NrWierszaFa>2</NrWierszaFa>
<P_7>Support</P_7>
<P_8A>hrs.</P_8A>
<P_8B>2</P_8B>
<P_9A>150.50</P_9A>
<P_11>301.00</P_11>
<P_12>8</P_12>
</FaWiersz>
</Fa>
</Faktura>Źródła
Źródło: crd.gov.pl