−30%Promocja enova365: rabat na licencje przy zmianie systemu ERP, zamówienia do 11 grudnia 2026 przy zmianie ERPSprawdź warunki
Enology
Panel klienta – zgłoszenia serwisowe (otworzy się w nowej karcie)Pomoc zdalnaNapisz do nas

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).

Enology
Dokumenty testowe KSeF – fikcyjne

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.

Ustawienia faktury

Sprzedawca

Nabywca

NazwaJmIlośćCena nettoRabat %StawkaUsuń

Zmiany w polach od razu przeliczają fakturę. „Generuj” losuje wszystko od nowa z ziarna; link „Udostępnij wynik” odtwarza wylosowane dane i ustawienia (bez ręcznych poprawek i bez Twojego NIP-u).

Kliknij „Generuj”, żeby wylosować dokument testowy.

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

Enology

Wdrożenia KSeF, integracje KSeF i EDI, środowiska testowe enova365 oraz Comarch ERP Optima
Enology sp. z o.o. · al. Armii Krajowej 4A/142, 35-307 Rzeszów · tel. 17 200 07 99 · biuro@enology.pl · enology.pl

Dokumenty fikcyjne do testów oprogramowania. Numery KSeF nie zostały nadane przez KSeF. Zasady obliczeń: enology.pl/generator-dokumentow-ksef/metodologia/

Oceń nas w Google
Kalkulator online

Budowa pliku FA(3)

ElementCo zawieraOdpowiednik na fakturze
NaglowekKodFormularza „FA” z kodem systemowym „FA (3)” i wersją schemy 1-0E, WariantFormularza 3, DataWytworzeniaFa, SystemInfonazwa programu i data utworzenia pliku
Podmiot1NIP i nazwa sprzedawcy, adres (KodKraju, AdresL1, AdresL2), e-mail i telefondane sprzedawcy
Podmiot2identyfikator nabywcy (NIP, NrVatUE z KodUE, NrID albo BrakID), nazwa, adres, NrKlienta, znaczniki JST i GVdane nabywcy
Podmiot3inne strony transakcji z rolą: faktor, odbiorca, płatnik, dodatkowy nabywca, JSTodbiorca, płatnik
FaKodWaluty, 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, RodzajFakturynagłówek i podsumowanie
FaWierszNrWierszaFa, 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), GTUpozycja faktury
PlatnoscZaplacono i DataZaplaty, ZaplataCzesciowa, TerminPlatnosci, FormaPlatnosci (1–7), RachunekBankowy z NrRBtermin i konto
WarunkiTransakcjinumery umów i zamówień, numery WZ (także w elemencie WZ w Fa), warunki dostawy, transportuwagi
Stopka, Zalacznikinformacje 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 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.

Pomoc zdalna Enology

Pobieranie rozpoczęte

  1. Otwórz pobrany plik Enology_Pomoc_Zdalna.exe – znajdziesz go w pobranych plikach przeglądarki. Nie trzeba go instalować.
  2. Podaj nam numer ID, który zobaczysz w oknie programu.
  3. Kłopot z połączeniem? Zadzwoń do serwisu: 17 200 07 99.

Po zakończonej pomocy: jak ci się z nami pracuje? Napisz szczerą opinię w Google – to pomaga nam pracować lepiej, a innym firmom wybrać partnera IT.

Napisz opinię w Google (otworzy się w nowej karcie)

Program działa na komputerze z Windows. Jesteś na telefonie? Zadzwoń, pomożemy inną drogą.

Często szukane