e-Faktura format — co musisz wiedzieć o schemacie FA(3) w KSeF?

Co to jest faktura ustrukturyzowana?

Dokument XML jest przygotowany według wzoru udostępnionego przez Ministerstwo Finansów i Centralne Repozytorium Wzorów Dokumentów Elektronicznych, a jego wartość prawna odpowiada fakturze papierowej na mocy ustawy o VAT. Zawiera wszystkie wymagane przepisami dane — m.in. informacje o stronach transakcji:

• NIP,
• nazwa,
• adres.

Oraz szczegóły rozliczeniowe:

• pozycje,
• ceny jednostkowe,
• wartości netto i brutto,
• stawki podatku, np. 23%, 8% i 5%.

Istotne są też daty, takie jak data wystawienia oraz data otrzymania. Plik ma format XML zgodny ze schematem e‑faktury VAT i trafia do Krajowego Systemu e‑Faktur (KSeF). Po przesłaniu system nadaje mu unikatowy numer KSeF, który jednocześnie rejestruje dokument w centralnym repozytorium. KSeF działa w modelu centralnym (clearance), dlatego faktura nie wymaga dodatkowej akceptacji odbiorcy — uważa się ją za wystawioną w dniu przesłania do systemu, a za otrzymaną w dniu przydzielenia numeru.

System umożliwia generowanie, udostępnianie i długoterminową archiwizację dokumentów — faktury przechowywane są przez 10 lat. Ustrukturyzowana faktura elektroniczna upraszcza obieg dokumentów, zapewnia jednolity format XML i jednoznaczne identyfikatory, co ułatwia ich przetwarzanie i kontrolę.

Jakie korzyści daje obowiązkowe stosowanie e-faktur?

Automatyzacja fakturowania przez integrację z API Krajowego Systemu e‑Faktur znacznie skraca czas księgowania i eliminuje konieczność ręcznego wprowadzania danych. Połączenie z systemem księgowym umożliwia bezpośrednie przesyłanie i pobieranie dokumentów, a jednoczesna walidacja schematu XML ogranicza błędy formalne.

Szybszy zwrot VAT i przyspieszony obieg dokumentów poprawiają płynność finansową firmy, skracając cały cykl wystawiania i rozliczania faktur, co z kolei wpływa na lepszą ściągalność należności.

Przeczytaj teżE-faktury — co to jest i jak przygotować firmę do KSeF?

Centralne przetwarzanie, kwalifikowane mechanizmy podpisu oraz certyfikat KSeF gwarantują integralność treści i autentyczność pochodzenia dokumentów, podnosząc bezpieczeństwo komunikacji B2B.

Cyfryzacja fakturowania redukuje koszty związane z przechowywaniem i obsługą dokumentów — znika papier i ręczna archiwizacja. Mniej formalnych korekt oraz automatyczne kontrole zmniejszają ryzyko sankcji podatkowych i ułatwiają przeprowadzanie kontroli.

Dzięki integracji z KSeF i standardami takimi jak API, Peppol czy schemat XML procesy łatwiej się skalują, co przyspiesza wdrażanie automatyzacji w różnych branżach i poprawia wizerunek firmy poprzez spójny, szybki obieg dokumentów.

Jaki jest format e-faktury (schemat FA(3) w KSeF)?

Od 1 lutego 2026 roku obowiązywać będzie nowy wzór e-faktury w KSeF — struktura logiczna FA(3). To ustandaryzowany schemat XML opublikowany w Centralnym Repozytorium Wzorów Dokumentów Elektronicznych, zawierający wszystkie elementy niezbędne do wystawiania różnych typów faktur:

• zaliczkowych,
• korygujących,
• not korygujących,
• pro forma.

W FA(3) uwzględniono dane wymagane przez ustawę o VAT, takie jak identyfikacja dokumentu, informacje o stronach transakcji, kwoty netto i brutto, stawki podatkowe oraz odpowiednie daty. Dokumentacja techniczna opisuje specyfikacje XML, przewodniki implementacyjne i wymagania dotyczące walidacji — m.in. nazwy elementów, typy danych oraz obowiązkowość poszczególnych pól. Dzięki zastosowaniu formatu XML możliwa jest automatyczna kontrola poprawności plików i ich transformacja do postaci wizualnej, np. za pomocą XSLT.

Przeczytaj teżCzy można wystawiać faktury ręcznie w 2022? Zasady i wymogi

Integracja odbywa się przez API KSeF oraz standardy takie jak Peppol, co ułatwia mapowanie pól z systemów księgowych i poprawia interoperacyjność. W repozytorium znajdziesz też środowisko testowe KSeF oraz przykładowe zbiory testowe, przydatne przy weryfikacji implementacji. Dodatkowo dokumentacja zawiera informacje o certyfikacie KSeF i zasadach nadawania uprawnień dostępowych. Schemat FA(3) ma na celu usprawnienie automatyzacji przetwarzania dokumentów, poprawę walidacji danych oraz zapewnienie sprawnej wymiany informacji między systemami.

Jakie pola obowiązkowe ma e-faktura?

Schemat FA(3) obejmuje kilka obowiązkowych elementów, które można pogrupować w następujący sposób:

• identyfikacja dokumentu — numer faktury, identyfikator nadany przez KSeF po rejestracji oraz typ dokumentu (np. faktura, faktura zaliczkowa, faktura korygująca, nota korygująca),
• daty — data wystawienia, data sprzedaży lub wykonania usługi (gdy różni się od daty wystawienia) oraz ewentualna data otrzymania,
• dane podmiotów — sprzedawca i nabywca powinny mieć podane nazwę, NIP lub inny identyfikator oraz adres (ulica, kod pocztowy, miejscowość, kraj),
• pozycje faktury — opisuje się towary lub usługi, podaje ilość i jednostkę miary (np. szt., kg, m2), cenę jednostkową netto, ewentualny rabat i wartość netto każdej pozycji,
• informacje o podatku — stawka VAT przypisana do każdej pozycji (np. 23%, 8%, 5% lub zwolnienie), kwota VAT dla poszczególnych stawek oraz łączna kwota VAT,
• suma i waluta dokumentu — łączna wartość netto, łączna wartość brutto oraz kod waluty według ISO 4217,
• płatności — termin i formę zapłaty, numer rachunku bankowego sprzedawcy oraz informacje o mechanizmach rozliczenia, np. zastosowanie mechanizmu podzielonej płatności (MPP) czy zwolnienie z VAT z podaniem podstawy prawnej,
• pola związane z dokumentami powiązanymi i załącznikami — odniesienie do faktury korygowanej (numer i data), kwoty zaliczek przy fakturze zaliczkowej oraz możliwość dołączenia pliku jako załącznika zgodnie ze specyfikacją FA(3).

Prawidłowe wypełnienie wymaganych pól jest kluczowe — brak wymaganych danych może spowodować odrzucenie dokumentu podczas walidacji w KSeF. Wszystkie wymienione elementy odpowiadają wymaganiom ustawy o VAT i specyfikacji FA(3).

Przeczytaj teżOd kiedy obowiązek KSeF? Terminy i przygotowanie firm

Jak odbywa się weryfikacja poprawności e-faktur?

Proces walidacji w KSeF przebiega automatycznie i obejmuje cztery zasadnicze etapy.

1. Sprawdzenie warstwy technicznej pliku XML — system weryfikuje strukturę dokumentu, nazwy elementów, typy danych, formaty dat oraz obowiązkowe pola zgodnie ze specyfikacją FA(3). W razie błędów strukturalnych dokument jest odrzucany natychmiast, a użytkownik otrzymuje stosowny komunikat.
2. Weryfikacja uprawnień wystawcy — system potwierdza autentyczność konta oraz uprawnienia w KSeF. Uwierzytelnianie może przebiegać przez profil zaufany, certyfikat KSeF albo podpis kwalifikowany; bez prawidłowej autoryzacji rejestracja dokumentu jest niemożliwa.
3. Walidacja merytoryczna — sprawdzane są informacje wymagane przez ustawę o VAT, takie jak identyfikatory stron, stawki VAT, sumy netto/brutto czy dane o MPP; wykryte niezgodności generują komunikaty wskazujące pola do poprawy.
4. Weryfikacja integralności i autentyczności pochodzenia — system weryfikuje obecność mechanizmów zapewniających nienaruszalność dokumentu, np. kwalifikowanej pieczęci elektronicznej, oraz zgodność podpisu lub pieczęci z treścią.

Na koniec KSeF zwraca szczegółowe komunikaty walidacyjne z opisem i identyfikatorem błędu — są one udostępniane przez API, co pozwala na automatyczną analizę i korektę w systemach księgowych. Dokumentacja techniczna i środowisko testowe zawierają listę możliwych komunikatów oraz przykłady scenariuszy, a dzięki integracji przez API i dokładnym kontrolom system ogranicza potrzebę ręcznych potwierdzeń odbioru, upraszczając obsługę dokumentów korygujących i zmniejszając ryzyko formalnych odrzuceń.

Kiedy e-faktura jest uznawana za wystawioną?

Pozytywny komunikat rejestracyjny KSeF zawiera przypisany numer identyfikacyjny (numer KSeF) oraz znacznik czasowy, które razem potwierdzają datę wystawienia i otrzymania faktury ustrukturyzowanej. Data wystawienia to dzień, w którym dokument został zarejestrowany w KSeF — potwierdzeniem jest nadanie numeru w odpowiedzi API. Natomiast data otrzymania przez nabywcę odpowiada dniu przydzielenia tego numeru.

Do dokumentu można uzyskać dostęp bez dodatkowej akceptacji, bezpośrednio przez KSeF. Status faktury ustrukturyzowanej uzyskuje wyłącznie plik XML zgodny ze schematem FA(3) i przesłany do KSeF; wysłanie PDF-a mailem nie nadaje takiego statusu. Jeśli KSeF odrzuci plik podczas walidacji technicznej lub merytorycznej, dokument nie jest traktowany ani jako wystawiony, ani jako otrzymany — sytuacja ta trwa do czasu ponownego, poprawnego przesłania i rejestracji.

Przeczytaj teżFaktury papierowe w 2020 roku — co musisz wiedzieć o ich przyszłości?

Nadanie numeru w modelu clearance stanowi dowód w ewidencjach VAT, deklaracjach i przy rozliczeniach podatkowych, a data wynikająca z rejestracji obowiązuje niezależnie od tego, czy dokument przesłał sprzedawca osobiście, czy zrobił to przez integratora systemu księgowego.

Jak wdrożyć e-fakturę w systemie księgowym?

Proces wdrożenia składa się z siedmiu etapów:

1. Analiza wymagań i dokumentacji. Przejrzyj specyfikację schematu FA(3), przewodniki implementacyjne oraz listę pól obowiązkowych. Sporządź mapowanie między ERP a FA(3) — np. NIP → Party/TaxId, cena jednostkowa → InvoiceLine/UnitPrice. Zidentyfikuj dodatkowe elementy: załączniki, kwoty zaliczek, referencje do faktur korygujących. Sprawdź wymagania JPK_FA i dopasuj identyfikatory do nowego schematu.
2. Przygotowanie systemu księgowego. Dostosuj schemat bazy danych, dodając pola zgodne z FA(3) oraz obsługę kodów ISO 4217. Wdroż generator XML z walidacją XSD i regułami biznesowymi (sumy, stawki VAT 23/8/5/zw). Zaimplementuj obsługę korekt, faktur zaliczkowych oraz mechanizmu MPP. Dodaj moduł logów i przechowywania request/response dla audytu i diagnostyki.
3. Integracja z KSeF przez API. Utwórz klienta API z autoryzacją (profil zaufany, podpis kwalifikowany lub certyfikat KSeF). Zapewnij TLS, rotację certyfikatów i bezpieczne składowanie kluczy. Obsłuż kody odpowiedzi KSeF, retry z backoff i rejestrację identyfikatorów transakcji. Jeśli potrzebny jest cross-border, rozważ pośrednika typu platforma e-fakturowania lub Peppol.
4. Testy w środowisku testowym KSeF. Waliduj pliki XML względem XSD i przykładowych zbiorów testowych. Uruchom scenariusze pozytywne i negatywne — brak pola obowiązkowego, niezgodność sum, błędny NIP itp. Sprawdź integrację z JPK_FA oraz spójność danych między raportami. Przetestuj obsługę załączników i transformacje XSLT do formy czytelnej dla użytkownika.
5. Szkolenie użytkowników i aktualizacja procedur. Opracuj procedury wystawiania, korekt, archiwizacji i nadawania uprawnień; zdefiniuj role (administrator, księgowy, audytor). Przeprowadź praktyczne sesje pokazujące obsługę błędów zwracanych przez API KSeF. Określ SLA na reakcję na odrzucenia i czas na wprowadzenie korekt.
6. Migracja i archiwizacja. Przygotuj plan migracji dokumentów historycznych; przy skanach zastosuj OCR do konwersji na XML. Stwórz mapę migracji pól legacy → FA(3) i ustal politykę uzupełniania brakujących danych. Zachowaj archiwum operacyjne oraz kopie zapasowe — KSeF przechowuje dokumenty przez 10 lat, a lokalne kopie wspierają proces audytu.
7. Uruchomienie produkcyjne i monitoring. Wdróż monitoring kluczowych metryk: liczba odrzuceń, czas odpowiedzi API, odsetek pomyślnych rejestracji. Automatyzuj powiadomienia i eskalacje dla błędów krytycznych. Zaplanuj proces aktualizacji schematu FA(3) i procedur reagowania na zmiany przepisów.

Kontrola jakości i dokumentacja techniczna. Prowadź repozytorium testów i przykładowych XML-i. Zapisuj komunikaty walidacyjne z KSeF i mapuj błędy na działania naprawcze. Dokumentuj konfigurację integracji API, uprawnienia KSeF oraz listę używanych certyfikatów.

Przeczytaj teżFaktura elektroniczna a rozporządzenie KSeF — co musisz wiedzieć?

Lista kontrolna wdrożenia (skrót):

1. Mapowanie pól FA(3) przygotowane.
2. Generator XML z walidacją XSD uruchomiony.
3. Klient API z autoryzacją i zabezpieczeniami wdrożony.
4. Testy w środowisku KSeF przeszły pomyślnie.
5. Procedury i szkolenia zrealizowane.
6. Plan migracji z użyciem OCR przygotowany.
7. Monitoring i backup włączone.

Integracja z KSeF i automatyzacja fakturowania skracają czas obsługi i zmniejszają liczbę błędów wynikających z ręcznego wprowadzania danych.