fbpx

KSeF struktura logiczna FA(3) – co się zmienia?

2026-04-04
ksef FA3
Spis treści:
0
(0)

Od 1 lutego 2026 roku jedynym obowiązującym formatem faktury ustrukturyzowanej w Krajowym Systemie e-Faktur jest struktura logiczna FA(3). Zastąpiła ona FA(2), w której działał system od września 2023 roku. Zmiana nie jest kosmetyczna – FA(3) to gruntowna przebudowa schematu XML, uwzględniająca kilkadziesiąt postulatów zgłoszonych przez przedsiębiorców, biura rachunkowe, biegłych rewidentów i dostawców oprogramowania podczas konsultacji Ministerstwa Finansów. Dla branży budowlanej i deweloperskiej, gdzie faktury bywają złożone – dokumentują etapy robót, zaliczki, retencje, samofakturowanie i podzieloną płatność jednocześnie – zrozumienie nowej architektury pliku XML to warunek bezbłędnego fakturowania.

Czym jest struktura logiczna FA(3) i jak zbudowany jest plik XML?

Struktura logiczna to schemat XSD (XML Schema Definition) opublikowany przez Ministerstwo Finansów na stronie ksef.podatki.gov.pl. Definiuje ona, w jakiej kolejności i w jakim formacie muszą być zapisane poszczególne dane w pliku XML faktury ustrukturyzowanej. KSeF nie przyjmuje plików PDF ani żadnych formatów wizualnych – wyłącznie plik XML zgodny z aktualną schemą. Gdy plik nie przejdzie walidacji technicznej względem schematu, system odrzuca fakturę natychmiast, bez nadania numeru KSeF.

Schemat FA(3) zbudowany jest z ośmiu elementów nadrzędnych. Nagłówek (Naglowek) zawiera dane techniczne dotyczące wytworzenia pliku, w tym jego wersję i datę. Podmiot1 to sprzedawca, Podmiot2 – nabywca. Kolejne sekcje to dane faktury (Fa), poszczególne pozycje (FaWiersz), podsumowanie (Podsumowanie), element fakultatywnych opisów dodatkowych (DodatkowyOpis), stopka (Stopka) oraz ewentualne załączniki. Każde pole w strukturze ma przypisany poziom wymagalności: obligatoryjne (brak = odrzucenie faktury), opcjonalne (wymagane warunkowo – zależnie od rodzaju transakcji) lub fakultatywne (niezobowiązujące, ale dostępne dla wzbogacenia dokumentu o dodatkowe informacje). Błędne rozumienie tej hierarchii jest źródłem większości problemów przy pierwszym wdrożeniu.

Najważniejsze zmiany FA(3) względem FA(2)

Przejście z FA(2) na FA(3) to nie tylko przenumerowanie wersji. Ministerstwo Finansów wprowadziło kilka zmian o realnym znaczeniu operacyjnym.

512 znaków dla nazwy towaru lub usługi

W FA(2) pole nazwy towaru lub usługi (element FaWiersz) było ograniczone do 256 znaków. W FA(3) limit wzrósł do 512 znaków. Dla branży budowlanej to zmiana, na którą czekano od dawna. Opis pozycji „Wykonanie robót żelbetowych w zakresie fundamentów bezpośrednich zgodnie z projektem budowlanym nr XYZ, etap I, poz. kosztorysowa 1.2.4" – który w FA(2) często trzeba było skracać lub rozdzielać na dwie pozycje – teraz mieści się w jednym polu. Firmy budowlane, które przyzwyczaiły się do kompromisów w opisach pozycji, mogą w FA(3) stosować pełną nomenklaturę zgodną z kosztorysem i umową.

Załączniki do faktury

FA(3) wprowadza możliwość dołączenia załącznika do faktury ustrukturyzowanej. Maksymalny rozmiar pliku faktury z załącznikami to 3 MB (bez załączników – 1 MB). To zmiana jakościowa dla całego obiegu dokumentów – w FA(2) faktura w KSeF była dokumentem izolowanym, pozbawionym możliwości dołączenia czegokolwiek. Specyfikacje, protokoły odbioru, zestawienia robót, harmonogramy – wszystkie te dokumenty musiały krążyć kanałami pozasystemowymi. FA(3) pozwala umieścić załącznik bezpośrednio w pliku faktury, tworząc kompletny pakiet dokumentacyjny.

Ograniczenie 3 MB wymaga jednak rozsądku przy wyborze, co dołączać. Skany protokołów odbioru w wysokiej rozdzielczości mogą szybko przekroczyć limit – warto stosować kompresję lub wybierać dokumenty w formacie PDF/A o ograniczonej objętości.

Nowy typ kontrahenta: pracownik

FA(3) wprowadza nową kategorię podmiotu w sekcji podmiotów transakcji: pracownik. Wcześniej schemat rozpoznawał sprzedawcę, nabywcę i podmiot upoważniony (np. przy samofakturowaniu). Możliwość wskazania pracownika jako podmiotu powiązanego z fakturą otwiera nową ścieżkę dla dokumentowania wydatków służbowych i rozliczeń pracowniczych – obszar, który w poprzednich wersjach wymagał niestandardowych obejść.

Rozbudowane opcje terminów płatności

W FA(2) termin płatności był prosty: data w formacie RRRR-MM-DD. FA(3) wprowadza możliwość definiowania terminu jako liczby dni od zdarzenia początkowego (np. od daty wystawienia faktury lub daty odbioru). To rozwiązanie znacznie lepiej oddaje rzeczywistość kontraktową w budownictwie, gdzie terminy płatności są często wyrażone jako „30 dni od daty protokołu odbioru etapu" lub „14 dni od daty dostarczenia faktury". Nowy mechanizm pozwala na precyzyjne odzwierciedlenie warunków kontraktu bezpośrednio w strukturze XML, co ułatwia automatyczne monitorowanie terminów płatności po stronie zarówno wystawcy, jak i nabywcy.

Identyfikator płatności KSeF

FA(3) dodaje pole umożliwiające podanie identyfikatora płatności generowanego przez operatora płatniczego. Pozwala to na bezpośrednie powiązanie przelewu z konkretną fakturą w KSeF – bez konieczności ręcznego dopasowywania płatności do dokumentów. Dla firm budowlanych z dużą liczbą faktur i płatności w split payment rozwiązanie to ma potencjał do znacznej automatyzacji procesu rozliczeniowego.

Rozszerzenie formatu rachunku bankowego

Format numeru rachunku bankowego w FA(3) obsługuje do 34 znaków, zgodnie z międzynarodowym standardem IBAN. W FA(2) limit był węższy, co powodowało trudności przy transakcjach z kontrahentami zagranicznymi lub przy rachunkach z niestandardową strukturą. Dla deweloperów realizujących projekty z udziałem zagranicznych inwestorów lub finansowanych przez zagraniczne instytucje to zmiana o realnym znaczeniu operacyjnym.

Stopka faktury

FA(3) wprowadza sekcję Stopka (StopkaFaktury), która może wystąpić maksymalnie trzy razy na jednej fakturze, z limitem 3 500 znaków każda. W stopce można umieszczać informacje rejestrowe firmy (numer KRS, REGON, kapitał zakładowy), dane kontaktowe, informacje o oddziałach czy dodatkowe klauzule handlowe. Dla firm budowlanych i deweloperskich, które w standardowych stopkach faktur umieszczały informacje o rachunku powierniczym, warunkach gwarancji lub referencjach do umowy ramowej, ta sekcja zastępuje adnotacje, które wcześniej musiały trafiać do pola opisowego lub pozostawać poza plikiem XML.

Pola kluczowe dla branży budowlanej – na co zwrócić szczególną uwagę?

Kilka węzłów struktury FA(3) jest szczególnie istotnych przy konfiguracji systemu ERP dla firmy budowlanej lub deweloperskiej. RodzajFaktury determinuje typ dokumentu: VAT (standardowa), KOR (korygująca), ZAL (zaliczkowa), ROZ (rozliczeniowa), UPR (uproszczona), KOR_ZAL (korekta zaliczkowej), KOR_ROZ (korekta rozliczeniowej). Błędne ustawienie tego pola powoduje odrzucenie faktury lub – co gorsze – jej rejestrację jako błędnego typu, co generuje problemy przy ewidencji JPK. Pole P_17 w sekcji Adnotacje przyjmuje wartość „1" przy samofakturowaniu – konieczne przy relacjach GW–podwykonawca w modelu self-billing. Sekcja TerminPlatnosci obsługuje teraz wiele wpisów, co pozwala uwzględnić retencję jako odrębny termin w ramach tej samej faktury. KodTowaruUslugi w FaWiersz przyjmuje kod PKWiU lub CN dla każdej pozycji, stanowiąc podstawę do prawidłowego mapowania GTU w ewidencji JPK.

Walidacja i testowanie – zanim faktura trafi do produkcji

Każdy plik XML wysyłany do KSeF przechodzi automatyczną walidację techniczną względem schematu XSD. Błąd w strukturze – brakujące pole obowiązkowe, zły format daty, przekroczenie limitu znaków – skutkuje natychmiastowym odrzuceniem bez nadania numeru KSeF. Oprogramowanie integrujące się z KSeF powinno walidować plik wewnętrznie, jeszcze przed wysyłką, aby wyeliminować tego rodzaju błędy na etapie wystawienia faktury, a nie dopiero po próbie rejestracji w systemie.

Ministerstwo Finansów udostępnia środowisko testowe (przedprodukcyjne) KSeF, w którym można weryfikować poprawność generowanych plików XML bez ryzyka tworzenia rzeczywistych dokumentów podatkowych. Przed uruchomieniem pełnej integracji warto przetestować tam przynajmniej reprezentatywny zestaw faktur: standardową, korygującą, zaliczkową i rozliczeniową – w wariantach typowych dla konkretnej działalności.

Jak FA(3) obsługuje specyficzne scenariusze branży budowlanej – zaliczki z rachunków powierniczych, samofakturowanie i dokumentowanie etapów kontraktów wieloletnich? Odpowiedzi na te pytania znajdziesz na szkoleniach KSeF dla branży budowlanej. Program KSeF Develogic obsługuje pełną schemę FA(3), w tym pola specyficzne dla deweloperów i generalnych wykonawców, z automatyczną walidacją przed wysyłką. Chcesz sprawdzić, czy Twoje faktury przejdą przez KSeF bez błędów? Umów bezpłatne demo.

FAQ – struktura logiczna FA(3)

Czy faktury korygujące wystawiane po 1 lutego 2026 roku muszą być w FA(3), jeśli faktura pierwotna była w FA(2)?

Tak. Wszystkie faktury korygujące wystawiane od 1 lutego 2026 roku muszą być w strukturze FA(3), niezależnie od tego, w jakiej wersji schematu wystawiono fakturę pierwotną. Dotyczy to również korekt faktur wystawionych przed wejściem w życie FA(3) – FA(1) czy FA(2). W polu odniesienia do faktury korygowanej podaje się numer KSeF faktury pierwotnej lub, jeśli pierwotna była wystawiona poza KSeF – jej numer wewnętrzny z odpowiednim oznaczeniem.

Jaki jest maksymalny rozmiar pliku faktury w FA(3) i czy każda faktura może mieć załącznik?

Maksymalny rozmiar pliku faktury bez załącznika to 1 MB. Z załącznikiem – łącznie 3 MB. Możliwość dołączenia załącznika nie jest obowiązkowa, lecz fakultatywna. Jeśli firma decyduje się na dołączenie protokołu odbioru lub specyfikacji, powinna upewnić się, że łączny rozmiar pliku nie przekracza limitu. Warto stosować kompresję PDF i ograniczać rozdzielczość skanów, aby zmieścić się w ograniczeniu.

Czy FA(3) jest zgodna z europejską normą e-fakturowania EN 16931?

Nie w pełni. FA(3) przybliża polski standard do wymagań unijnych, jednak nadal nie osiąga pełnej zgodności z normą EN 16931, która definiuje europejski standard semantyczny faktury elektronicznej. Ministerstwo Finansów prowadziło prace w tym kierunku, ale priorytetem przy projektowaniu FA(3) była zgodność z krajowymi przepisami VAT i postulatami polskich przedsiębiorców, a nie pełna harmonizacja z europejską normą.

Co się stanie, jeśli oprogramowanie firmy nie zostało zaktualizowane do FA(3) i nadal generuje pliki FA(2)?

KSeF odrzuci taki plik podczas walidacji technicznej – faktura nie otrzyma numeru KSeF i nie zostanie uznana za wystawioną. Dla podatnika objętego obowiązkiem KSeF oznacza to brak ważnej faktury, co może skutkować problemami z rozliczeniem VAT i ryzykiem sankcji po zakończeniu okresu przejściowego. Aktualizacja oprogramowania do obsługi FA(3) była obowiązkowym wymogiem dla każdej firmy objętej KSeF od 1 lutego lub 1 kwietnia 2026 roku.

Czy ten wpis był dla Ciebie przydatny?

Kliknij w gwiazdkę aby dodać ocenę!

Średnia ocena 0 / 5. Ilość głosów: 0

Jeszcze nikt nie ocenił tego wpisu. Bądź pierwszy!


Biuro Obsługi Klienta
+48 61 639 42 98
rejestracja@ksefdlabudownictwa.pl
Adres: ul. Górnicza 2/143, 60-107 Poznań
design: Duind™