Kliknij „Generuj”, żeby wylosować dokument testowy.
Dokumenty KSeF · struktura FA(3)
Faktura FA(3) w XML: przykład e-faktury KSeF pole po polu
Od 1 lutego 2026 r. KSeF przyjmuje faktury wyłącznie w strukturze logicznej FA(3). Plik XML ma stałą budowę: nagłówek z kodem formularza, dane sprzedawcy (Podmiot1), nabywcy (Podmiot2), opcjonalnie podmiotów trzecich, część Fa z datami, numerem, podsumowaniem według stawek i wierszami, płatnością oraz warunkami transakcji. Niżej znajdziesz przykład wygenerowany przez nasze narzędzie – z poprawnymi sumami, fikcyjnymi danymi i walidacją według schematu Ministerstwa Finansów – oraz opis, które pola odpowiadają elementom papierowej faktury. Generator wyżej zrobi kolejne przykłady: zmień rodzaj, walutę, pozycje albo wpisz własny NIP jako nabywcę. Pobierz przykładowa faktura VAT FA(3) (dane fikcyjne, przechodzi schemat XSD).
Wszystkie dokumenty są fikcyjne i powstają w Twojej przeglądarce. Pliki przechodzą schemat FA(3), sumy zgadzają się co do grosza, ale firmy, kwoty i numery KSeF są wylosowane – nie dokumentują żadnej transakcji i nie da się ich zweryfikować w KSeF. Nie wysyłamy ich na serwer.
Dokument testowy – numer KSeF fikcyjny, nie weryfikuj w KSeF.
Pokaż XML
Generator dokumentów KSeF Enology · enology.pl
Dokumenty są fikcyjne: zgadzają się schemat, sumy i sumy kontrolne, ale żadna transakcja nie miała miejsca, a numery KSeF nie zostały nadane przez KSeF. Nie wysyłaj ich na środowisko produkcyjne KSeF ani nie księguj poza bazą testową. Regulamin · Jak budujemy dokumenty · Podgląd faktury XML · Generator danych testowych
Budowa pliku FA(3)
| Element | Co zawiera | Odpowiednik na fakturze |
|---|---|---|
| Naglowek | KodFormularza „FA” z kodem systemowym „FA (3)” i wersją schemy 1-0E, WariantFormularza 3, DataWytworzeniaFa, SystemInfo | nazwa programu i data utworzenia pliku |
| Podmiot1 | NIP i nazwa sprzedawcy, adres (KodKraju, AdresL1, AdresL2), e-mail i telefon | dane sprzedawcy |
| Podmiot2 | identyfikator nabywcy (NIP, NrVatUE z KodUE, NrID albo BrakID), nazwa, adres, NrKlienta, znaczniki JST i GV | dane nabywcy |
| Podmiot3 | inne strony transakcji z rolą: faktor, odbiorca, płatnik, dodatkowy nabywca, JST | odbiorca, płatnik |
| Fa | KodWaluty, P_1 (data wystawienia), P_1M (miejsce), P_2 (numer), P_6 (data dostawy) albo OkresFa, sumy P_13_x/P_14_x, P_15, Adnotacje, RodzajFaktury | nagłówek i podsumowanie |
| FaWiersz | NrWierszaFa, P_7 (nazwa), Indeks, GTIN, PKWiU, P_8A (jm), P_8B (ilość), P_9A (cena netto) lub P_9B (brutto), P_11 (wartość netto), P_12 (stawka), GTU | pozycja faktury |
| Platnosc | Zaplacono i DataZaplaty, ZaplataCzesciowa, TerminPlatnosci, FormaPlatnosci (1–7), RachunekBankowy z NrRB | termin i konto |
| WarunkiTransakcji | numery umów i zamówień, numery WZ (także w elemencie WZ w Fa), warunki dostawy, transport | uwagi |
| Stopka, Zalacznik | informacje rejestrowe (KRS, REGON), załącznik z tekstem i tabelami (nowość w FA(3)) | stopka, załączniki |
Podsumowanie według stawek: P_13 i P_14
Każda stawka VAT ma własną parę pól: P_13_1 i P_14_1 to netto i podatek dla stawki podstawowej (23% lub 22%), P_13_2 i P_14_2 dla 8% (7%), P_13_3 i P_14_3 dla 5%. Sprzedaż 0% dzieli się na krajową (P_13_6_1), wewnątrzwspólnotową dostawę (P_13_6_2) i eksport (P_13_6_3); zwolniona trafia do P_13_7, niepodlegająca opodatkowaniu do P_13_8 i P_13_9, odwrotne obciążenie do P_13_10. P_15 to kwota należności ogółem.
W wierszu stawkę zapisuje się w P_12 jedną z wartości słownika: 23, 22, 8, 7, 5, 4, 3, „0 KR”, „0 WDT”, „0 EX”, zw, oo, „np I”, „np II”. Program importujący sprawdza, czy suma wierszy z daną stawką zgadza się z P_13_x co do grosza – dlatego generator liczy wszystko w groszach i zaokrągla na wierszu, tak jak robią to programy fakturujące.
Dla faktury w walucie obcej pola P_14_xW zawierają podatek przeliczony na złote, a kurs przeliczenia jest w pozycjach (KursWaluty w FaWiersz). Pole KursWalutyZ w podsumowaniu dotyczy tylko faktur zaliczkowych. Program księgowy użyje tych kwot do rejestru VAT, nawet jeśli należność pozostaje w euro.
Usługa dla firmy z innego kraju UE (art. 28b ustawy o VAT) to w wierszu „np II” i w podsumowaniu P_13_9, a w adnotacjach P_18 = 1 („odwrotne obciążenie”). „np I” i P_13_8 zostają dla innych przypadków sprzedaży poza terytorium kraju.
Typowe błędy w plikach FA(3)
- Kolejność elementów niezgodna ze schematem – XML jest walidowany sekwencyjnie, więc Platnosc przed FaWiersz kończy się błędem XSD, choć wszystkie dane są poprawne.
- Wartość P_12 „0” albo „np” zamiast „0 KR” czy „np I” – słownik stawek zmienił się między FA(2) a FA(3).
- Suma P_14 niezgodna z wierszami przez zaokrąglanie na końcu zamiast na wierszu; KSeF przyjmie taki plik, ale ERP zatrzyma go do wyjaśnienia.
- NrVatUE z prefiksem kraju („DE123…”) – prefiks idzie do KodUE, a numer bez liter do NrVatUE.
- Znaki sterujące albo niezakodowane „&” w nazwie firmy – parser przerwie odczyt pliku.
- Data wystawienia poza zakresem schematu (2006–2050) albo termin płatności przed 1 lipca 2016 r.
Do czego użyć przykładu
Plik z tej strony i każdy wygenerowany wyżej nadaje się do ćwiczeń z importu: w enova365 przez Handel → KSeF (środowisko testowe) albo import z pliku, w Comarch ERP Optima przez listę faktur z KSeF po pobraniu ze środowiska testowego. Dane są fikcyjne, numery KSeF w nazwach plików także – nie da się ich zweryfikować na ksef.mf.gov.pl.
Programiści integracji użyją przykładów jako wektorów testowych: ten sam XML wczytany do parsera powinien dać te same kwoty, które pokazuje nasz podgląd faktury. Testerzy UAT skorzystają z paczki wielu plików i z wersji celowo błędnych, żeby sprawdzić obsługę odrzuceń.
Dla firm
Wdrażasz KSeF albo integrację EDI?
Konfigurujemy KSeF w enova365 i Comarch ERP Optima, piszemy integracje z KSeF, EDI i systemami klientów, przygotowujemy środowiska testowe z danymi.
Najczęstsze pytania
Czym różni się FA(3) od FA(2)?
FA(3) obowiązuje od 1 lutego 2026 r. i zastępuje FA(2). Zmieniła się przestrzeń nazw i wersja schemy, doszły m.in. załącznik (Zalacznik), rola pracownika w Podmiot3, nowe wartości słowników (np. P_12 „0 KR”, „np I”) oraz pola rozliczeń. Pliki FA(2) są już odrzucane przez KSeF, choć starsze programy nadal je czytają.
Czy przykładowa faktura przejdzie w KSeF?
Strukturalnie tak – plik przechodzi walidację schematu XSD, tego samego, którego używa KSeF. Do wysłania na środowisko testowe potrzebujesz jednak uwierzytelnienia jako sprzedawca o tym NIP-ie; fikcyjny NIP z pliku nie jest Twoim NIP-em, więc wpisz w generatorze własne dane sprzedawcy albo użyj fikcyjnego podmiotu testowego utworzonego w KSeF test.
Skąd się bierze numer KSeF w nazwie pliku?
Numer ma poprawny format (NIP, data, 12 znaków, suma kontrolna), ale jest wylosowany przez generator – KSeF nigdy go nie nadał. Dlatego przy każdym numerze dodajemy notę „numer KSeF fikcyjny” i prosimy, żeby nie weryfikować go na stronie ministerstwa.
Jak otworzyć plik XML w czytelnej postaci?
Wczytaj go do naszego podglądu faktury (przycisk „Otwórz w podglądzie” pod wynikiem albo przeciągnij plik na stronę podglądu). Zobaczysz fakturę w układzie podobnym do wydruku, z kwotami per stawka i kodem QR. Podgląd też działa w przeglądarce.
Inne kalkulatory
- Kalkulator kosztu wdrożenia ERPIle kosztuje wdrożenie i licencja Comarch ERP Optima albo enova365 w twojej firmie i ile potrwa.
- Generator dokumentów KSeFWszystkie rodzaje faktur, paczki ZIP i pliki błędne w jednym miejscu.
- Faktura korygująca w KSeF – przykład XMLJak wygląda korekta w FA(3): DaneFaKorygowanej, PrzyczynaKorekty, TypKorekty, wiersze „stan przed” i „po”. Przykład do pobrania i generator korekt do faktur z paczki.
- Faktura zaliczkowa i rozliczeniowa w KSeFZAL z blokiem Zamowienie i ROZ z odwołaniem do zaliczki: jak FA(3) zapisuje zaliczki i końcowe rozliczenie, z przykładami XML do pobrania.
- Komunikaty ECOD (EDI): INVOICE, ORDER, DESADVTe same faktury testowe jako komunikaty ECOD XML dla Comarch EDI i modułu EDI enova365: faktura, zamówienie i awizo wysyłki. Układ do sprawdzenia na pliku z programu.
- Import testowych faktur do enova365 i Comarch ERP OptimaKrok po kroku: środowisko testowe KSeF, import z pliku, plik XML importu enova365 i Comarch EDI – jak wczytać paczkę z generatora i co sprawdzić po imporcie.
- Kalkulator wynagrodzeńBrutto, netto i koszt firmy: umowa o pracę, zlecenie, dzieło i B2B.
- Kalkulator formy opodatkowaniaSkala, liniowy czy ryczałt – która forma da najniższe podatki i składki.
- Kalkulator leasinguIle leasing kosztuje po podatkach i jak rozłożyć koszty na lata: wpłata, okres, wykup, limity aut.
- Kalkulator biura rachunkowegoDla biur rachunkowych: wycena klienta z ofertą PDF, rentowność klientów z pliku CSV i czas oszczędzony dzięki automatyzacji.
- Kalkulator estońskiego CITCzy ryczałt od dochodów spółek się opłaca: test warunków i porównanie z CIT 9%/19% na 1–4 lata.
- Test NIS2 i KSCCzy firma podlega ustawie o KSC (NIS2): podmiot kluczowy czy ważny, terminy, kary i samoocena gotowości.
- Kalkulator luki płacowejLuka płacowa z pliku listy płac (liczona tylko w przeglądarce): średnia, mediana, kwartyle, kategorie z luką 5%.
- Test: od kiedy KSeF mnie dotyczyTwoje terminy w KSeF, wyjątki do końca 2026 r. i co zrobić przed 1 stycznia 2027 r. Do tego kalkulator kar i podgląd faktury XML.
- Weryfikacja kontrahentówRaport o firmie po NIP, KRS albo REGON: VAT, KRS, sprawozdania z wykresami – i sprawdzanie całej listy NIP-ów naraz.
- Kalkulator podstawy chorobowegoPodstawa wynagrodzenia chorobowego i zasiłku z 12 miesięcy: pracownik, zleceniobiorca i przedsiębiorca, także zasiłek opiekuńczy i po ustaniu ubezpieczenia.
- Generator danych testowychFikcyjne, ale poprawne dane do testów ERP: PESEL, NIP, REGON, numer konta, pracownik, kontrahent i towar demo – liczone w przeglądarce, z eksportem do Excela i szablonami Optimy i enova365.
Kalkulator przygotował zespół Enology. Korzystanie z niego jest bezpłatne i nie wymaga rejestracji – zasady opisuje regulamin, a sposób liczenia strona Jak liczymy. Dokumenty są fikcyjne i służą do testów oprogramowania; numery KSeF nie zostały nadane przez KSeF. Kalkulator się przydał? Oceń nas w Google.