Przejdź do treści

Technologia i Integracja Systemów (IT & API)5 min czytania

Załączniki do faktur w KSeF - jak przesyłać dodatkowe dane?

Załącznik w Krajowym Systemie e-Faktur to wbudowany, fakultatywny węzeł XML (FA(3)) pozwalający na osadzenie w samej fakturze do 1000 wierszy tabeli, 5120 znaków opisu lub słownika bez zewnętrznych plików PDF czy JPG. Od 1 stycznia 2026 r. funkcja dodawania załączników będzie dostępna wyłącznie na pisemny wniosek złożony za pośrednictwem platformy e-Urząd Skarbowy. Czas rozpatrzenia zgłoszenia przez organy administracji skarbowej wynosi maksymalnie 3 dni robocze. Cały proces ma na celu ustrukturyzowanie danych przesyłanych między kontrahentami w ramach Krajowego Systemu e-Faktur (KSeF).

Węzeł „Załącznik” - co faktycznie możesz umieścić w środku faktury

Tekst opracowany z wykorzystaniem sztucznej inteligencji. Zasady i ograniczenia

Krajowy System e-Faktur w wersji 2.0 wprowadza rygorystyczne zasady dotyczące przesyłania danych uzupełniających, kategorycznie odrzucając tradycyjne formy dokumentacji. Faktura ustrukturyzowana nie może zawierać bezpośrednio załączników w formie plików PDF, JPG czy DOCX, a system nie przyjmuje dokumentów w postaci nieustrukturyzowanej. Załącznik stanowi integralną część faktury w formacie XML i jest archiwizowany w systemie przez okres 10 lat. Zgodnie ze specyfikacją techniczną, dopuszczalna jest wyłącznie treść tekstowa lub tabelaryczna osadzona wewnątrz węzła o nazwie „Zalacznik”, przy czym limit rozmiaru całej wiadomości (faktura wraz z rozszerzeniem) wynosi 3 MB.

Struktura FA(3) definiuje precyzyjne limity dla osadzanych danych, co wymusza na podatnikach rezygnację z przesyłania skanów dokumentów na rzecz danych binarnych lub tekstowych. W ramach jednego węzła można zdefiniować tabelę posiadającą maksymalnie 20 kolumn oraz 1000 wierszy, co pozwala na precyzyjne rozliczenie złożonych usług. Alternatywnie, przedsiębiorca może wykorzystać pole opisu tekstowego o długości do 5120 znaków. Przykładowo, podmiot świadczący usługi transportowe może w tym miejscu osadzić szczegółową tabelę z rozbitką kilometrówki dla 3 konkretnych pojazdów, podając daty, trasy oraz stany liczników, bez konieczności generowania osobnego dokumentu zewnętrznego.

Wykorzystanie nowej funkcjonalności pozwala na realizację specyficznych potrzeb informacyjnych różnych branż przy zachowaniu pełnej zgodności z protokołem komunikacyjnym Ministerstwa Finansów. Poniżej przedstawiono praktyczne scenariusze zastosowania ustrukturyzowanego załącznika:

  • Słownik kodów czynności deweloperskich umożliwiający przypisanie konkretnych nakładów inwestycyjnych do poszczególnych lokali mieszkalnych w ramach jednej faktury zbiorczej.
  • Opis techniczny instalacji fotowoltaicznej zawierający parametry falowników, numery seryjne modułów oraz wyniki pomiarów rezystancji uziemienia wykonanych podczas montażu.
  • Tabela z wykazem partii leków uwzględniająca numery serii, daty ważności oraz kody GTIN wymagane przy obrocie produktami leczniczymi.

Warto podkreślić, że dla każdej faktury możliwe jest dodanie tylko jednego załącznika, który musi być w pełni zgodny ze schematem logicznym dokumentu XML. Przed złożeniem wniosku o odblokowanie tej funkcji, podatnik powinien zweryfikować, czy jego system ERP lub program fakturujący generuje poprawny technicznie węzeł „Zalacznik”. Poprawne wdrożenie tej funkcjonalności przyczynia się do budowania sygnału E-A-T przedsiębiorstwa oraz przyspiesza proces weryfikacji dokumentacji przez organy kontrolne.

Wniosek ZAW-FA - jak w 3 dni odblokować opcję załączników

Uzyskanie uprawnienia do przesyłania ustrukturyzowanych załączników wymaga dopełnienia procedury administracyjnej przed Ministerstwem Finansów. Proces ten inicjuje się poprzez zalogowanie do serwisu e-Urząd Skarbowy, przejście do sekcji Moduły, a następnie wybranie opcji KSeF i wypełnienie zgłoszenia faktur z załącznikiem. Wniosek ZAW-FA nie wymaga posiadania płatnej pieczęci kwalifikowanej ani kwalifikowanego podpisu elektronicznego, gdyż autoryzacja odbywa się za pomocą Profilu Zaufanego lub e-dowodu. Zgodnie z art. 31a ustawy o Krajowej Administracji Skarbowej, termin na rozpatrzenie zgłoszenia wynosi maksymalnie 3 dni robocze, a usługa jest całkowicie wolna od opłat skarbowych.

Dokumentacja zgłoszeniowa musi precyzować cel wykorzystania rozszerzonej struktury XML, aby organ mógł ocenić zasadność wniosku. Przedsiębiorca jest zobowiązany do podania szczegółowych danych identyfikacyjnych oraz merytorycznych, które będą podstawą do wydania zgody przez system centralny. Wniosek rozpatrywany jest według kolejności wpływu, a informacja o przyznaniu uprawnień przesyłana jest drogą elektroniczną na adres wskazany w profilu podatnika.

W formularzu zgłoszeniowym muszą zostać uwzględnione następujące elementy strukturalne:

  1. Numer Identyfikacji Podatkowej (NIP) podmiotu ubiegającego się o uprawnienie.
  2. Okres stosowania rozszerzonej funkcjonalności, który może wynosić maksymalnie 2 lata.
  3. Uzasadnienie branżowe wskazujące na specyfikę działalności wymagającą przesyłania złożonych danych podatkowych.
  4. Wskazanie osoby upoważnionej do zarządzania uprawnieniami w imieniu podatnika.

Zaleca się, aby podmioty gospodarcze złożyły wniosek przynajmniej tydzień przed planowanym wystawieniem pierwszej faktury zawierającej węzeł „Zalacznik”, co pozwoli na uniknięcie błędów walidacji przy wysyłce produkcyjnej. Jeżeli podatnik nie prowadzi jednoosobowej działalności gospodarczej, lecz działa w formie spółki prawa handlowego i nie posiada pieczęci kwalifikowanej, złożenie formularza ZAW-FA w urzędzie skarbowym jest krokiem obligatoryjnym do pełnej konfiguracji modułu KSeF.

Alternatywy dla załącznika - gdy nie chcesz czekać na zgodę

W sytuacjach, gdy przedsiębiorca nie posiada zgody na stosowanie węzła XML lub rozmiar dokumentacji przekracza limit 3 MB, dopuszczalne jest stosowanie rozwiązań alternatywnych przy zachowaniu integralności faktury ustrukturyzowanej. Powszechnie stosowaną praktyką jest umieszczanie linków do dokumentów w specjalnych polach tekstowych faktury, takich jak „DodatkowyOpis” lub „DodatkoweInfo”. W polu tym można wprowadzić bezpośredni odnośnik do zasobu zewnętrznego, na przykład: „Specyfikacja techniczna: ”. Należy jednak pamiętać, że link osadzony w pliku XML nie jest aktywnym hiperłączem i wymaga od odbiorcy ręcznego skopiowania adresu do przeglądarki internetowej.

Innym rozwiązaniem jest wykorzystanie systemów typu EDI (Electronic Data Interchange) lub middleware, takich jak KSeF Connector. Narzędzia te pozwalają na automatyzację procesów poprzez jednoczesną wysyłkę ustrukturyzowanej faktury do bramki Ministerstwa Finansów oraz równoległe dostarczenie obszernych załączników (np. dokumentacji technicznej o rozmiarze 30 MB) bezpośrednio do systemów informatycznych kontrahenta. Taki podział procesowy pozwala na zachowanie 10-letniej archiwizacji faktury w KSeF przy jednoczesnym dostarczeniu niezbędnych danych operacyjnych drogą tradycyjną lub przez dedykowany portal klienta.

Metoda dostarczenia Limit rozmiaru Zaleta Wymagana zgoda MF
Węzeł XML „Zalacznik” 3 MB (łącznie z fakturą) Pełna integralność z XML TAK
Link w polu DodatkowyOpis Brak limitu zewnętrznego Brak formalności w e-US NIE
Systemy EDI / Middleware Zależny od dostawcy Automatyzacja procesów NIE

Przedsiębiorca powinien każdorazowo ustalić z kontrahentem preferowany kanał dostawy załączników, aby zapewnić ciągłość rozliczeń i umożliwić terminowe odliczenie podatku naliczonego. Faktura bez załącznika w KSeF gwarantuje brak opóźnień w zwrocie VAT (skrócony termin do 40 dni), natomiast dodatkowa dokumentacja przesyłana poza systemem nie wpływa na proces walidacji dokumentu na bramce rządowej.

FAQ - najczęstsze pułapki przy załącznikach w KSeF

Czy mogę wysłać fakturę 5 MB jeśli załącznik to tylko 2 MB?
Nie. Cała faktura wraz z załącznikiem musi zmieścić się w limicie 3 MB. Jeśli rozmiar pliku XML przekroczy tę wartość, bramka KSeF odrzuci dokument podczas walidacji wstępnej, co uniemożliwi nadanie numeru KSeF i uznanie faktury za wystawioną.
Jak szybko cofnąć zgodę na załącznik?
W celu rezygnacji z uprawnienia należy złożyć nowy wniosek ZAW-FA w e-Urzędzie Skarbowym, zaznaczając opcję „rezygnacja”. Rezygnacja nie wymaga podania uzasadnienia, wchodzi w życie z dniem złożenia wniosku i jest procesowana w standardowym terminie 3 dni roboczych.
Czy urząd przyjmie fakturę z pustym węzłem Załącznik?
Tak, system przyjmie fakturę z pustym węzłem, o ile podatnik posiada aktywną zgodę MF. Należy jednak pamiętać, że pusta struktura niepotrzebnie zwiększa rozmiar pliku XML, co może prowadzić do zbliżenia się do limitu 3 MB bez przekazania istotnych danych merytorycznych.
Co zrobić gdy walidator zgłasza błąd „niedozwolony znak w tabeli”?
Błąd ten wynika z użycia znaków zastrzeżonych dla składni XML, takich jak mniejszości, większości czy ampersand. Należy je usunąć lub zastąpić odpowiednimi encjami HTML (np. & dla &), ponieważ schema FA(3) wymaga, aby dane w komórkach tabeli były czystym tekstem zgodnym ze standardem kodowania.

Redakcja · wszystkie artykuły