Załącznik w KSeF - definicja, limity i zakres dopuszczalnych treści
Tekst opracowany z wykorzystaniem sztucznej inteligencji. Zasady i ograniczenia
Węzeł Załącznik w strukturze logicznej FA(3) stanowi integralną część faktury ustrukturyzowanej i nie jest tożsamy z tradycyjnym pojmowaniem załącznika jako odrębnego pliku binarnego. Zgodnie z art. 106e ust. 1 pkt 19 ustawy o podatku od towarów i usług, faktura musi zawierać dane niezbędne do identyfikacji transakcji, a nowy węzeł XML umożliwia doprecyzowanie tych informacji w formie ustrukturyzowanej. W praktyce oznacza to, że informacje, które dotychczas znajdowały się w plikach PDF, JPG czy DOCX, muszą zostać przekonwertowane na słownik, tabelę lub opis tekstowy bezpośrednio wewnątrz pliku XML faktury. Rozwiązanie to wyklucza przesyłanie dokumentów o charakterze niepodatkowym, takich jak skany protokołów odbioru czy dokumentacja techniczna w formatach graficznych.
Limity objętościowe narzucone przez Ministerstwo Finansów wymuszają na podatnikach dużą dyscyplinę w zakresie agregacji danych. Maksymalna liczba kolumn w tabeli została ograniczona do 20, natomiast liczba wierszy nie może przekroczyć 1000 pozycji. W przypadku wykorzystania pola przeznaczonego na opis tekstowy, maksymalna długość ciągu znaków wynosi 5120 znaków. Przekroczenie któregokolwiek z tych parametrów spowoduje odrzucenie dokumentu przez system KSeF jako niezgodnego ze specyfikacją techniczną. Należy przy tym pamiętać, że rozmiar faktury bez załącznika wynosi zazwyczaj do 1 MB, natomiast po implementacji węzła dodatkowego limit ten wzrasta do 3 MB.
| Parametr | Maksymalna wartość |
|---|---|
| Rozmiar całej wiadomości XML | 3 MB |
| Liczba wierszy w tabeli załącznika | 1000 |
| Liczba kolumn w tabeli załącznika | 20 |
| Długość opisu tekstowego | 5120 znaków |
| Liczba wpisów w słowniku | 1000 |
Zakres dopuszczalnych treści wewnątrz załącznika jest ściśle powiązany z funkcją dokumentacyjną faktury dla celów podatkowych. Wprowadzenie tych ograniczeń powoduje konieczność wdrożenia dwukanałowego obiegu dokumentów w relacjach B2B, gdzie dane podatkowe trafiają do KSeF, a dokumentacja techniczna lub handlowa przesyłana jest kanałami alternatywnymi.
- Dozwolone: dane podatkowe w zakresie ceny, miary i ilości, rozbicie zużycia energii według punktów poboru, opłaty telekomunikacyjne przypisane do konkretnych numerów, taryfy, sprzedaż paliwa przypisana do numerów rejestracyjnych pojazdów.
- Zabronione: umowy cywilnoprawne, aneksy, materiały marketingowe, instrukcje obsługi, protokoły odbioru w formie skanów, zdjęcia uszkodzeń towaru.
Procedura uzyskania zgody na wysyłanie faktur z załącznikiem
Zastosowanie węzła załącznika w codziennej praktyce gospodarczej od 1 lutego 2026 r. wymaga uprzedniego zgłoszenia zamiaru korzystania z tej funkcji do Ministerstwa Finansów. Procedura ta jest realizowana za pośrednictwem e-Urzędu Skarbowego lub dedykowanego API systemu KSeF 2.0. W procesie zgłoszeniowym należy podać uzasadnienie potrzeby przesyłania rozszerzonych danych, wskazać szacunkową liczbę faktur z załącznikiem generowanych w skali miesiąca oraz określić średni spodziewany rozmiar pliku XML. Istotne jest również precyzyjne wskazanie typu dokumentowanych czynności, co ma na celu weryfikację zasadności obciążania infrastruktury systemowej większymi pakietami danych.
Terminy procesowania wniosków zostały określone w art. 43a § 1 pkt 4 rozporządzenia w sprawie Krajowego Systemu e-Faktur. Organ podatkowy ma 30 dni na rozpatrzenie złożonego wniosku, przy czym standardowy czas realizacji zgłoszenia technicznego wynosi zazwyczaj 3 dni robocze. Po otrzymaniu pozytywnej weryfikacji, która jest potwierdzana komunikatem systemowym lub wiadomością e-mail, podatnik uzyskuje uprawnienie do wysyłki faktur z węzłem XML przez okres 24 miesięcy. Po upływie tego czasu wymagana jest prolongata zgody poprzez ponowne złożenie stosownej deklaracji w systemie.
Uprawnienie do korzystania z rozszerzonej struktury XML nie jest nadawane bezterminowo i może zostać cofnięte przez organ nadzorczy w określonych sytuacjach. Do najczęstszych przyczyn wygaśnięcia lub odebrania zgody należy przesyłanie wewnątrz węzła treści zabronionych (np. linków do złośliwego oprogramowania lub treści marketingowych), uporczywe przekraczanie limitów wielkości pliku 3 MB oraz brak aktualizacji danych w zgłoszeniu przy istotnej zmianie profilu działalności. Brak aktywnego statusu dla załącznika uniemożliwia skuteczne przejście walidacji faktury w KSeF, co w konsekwencji wymaga ponownej akceptacji całego procesu administracyjnego.
Protokoły odbioru i inne dokumenty towarzyszące - gdzie je przesłać, skoro nie do KSeF?
W obliczu restrykcji technicznych systemu centralnego, przedsiębiorcy zmuszeni są do adaptacji modelu dwukanałowego obiegu dokumentacji. Faktura jako dokument księgowy przesyłana jest przez KSeF, natomiast załączniki o charakterze dowodowym, takie jak protokoły odbioru czy specyfikacje techniczne, muszą być dystrybuowane alternatywnymi drogami. Do najczęściej wykorzystywanych kanałów należą poczta elektroniczna e-mail, systemy elektronicznej wymiany danych (EDI) oraz dedykowane portale klienta. Relacja między tymi kanałami przypomina wysyłkę listu poleconego i paczki - są to dwa niezależne środki przekazu realizujące jeden wspólny cel biznesowy.
Kluczowym wyzwaniem w modelu dwukanałowym jest zapewnienie trwałego i bezpiecznego powiązania faktury z dokumentacją towarzyszącą. Skuteczną techniką jest wykorzystanie pola DodatkoweInfo w strukturze FA(3) do umieszczenia unikalnego identyfikatora dokumentu zewnętrznego lub bezpośredniego linku do zasobu w bezpiecznym repozytorium chmurowym. Zastosowanie funkcji skrótu (hash) pliku w standardzie SHA-256 daje obu stronom transakcji pewność integralności danych - kontrahent może zweryfikować, czy otrzymany poza systemem KSeF plik nie został zmodyfikowany po wystawieniu faktury.
Automatyzacja tego procesu jest możliwa dzięki zastosowaniu rozwiązań typu middleware, takich jak Astrafox. Narzędzia te, działając w paradygmacie API-first, automatycznie pobierają fakturę ustrukturyzowaną z KSeF i na etapie przetwarzania w systemie finansowo-księgowym odbiorcy łączą ją z odpowiednimi załącznikami pobranymi z repozytorium firmowego lub serwera SFTP. Dzięki temu proces dekretacji i akceptacji dokumentów przebiega płynnie, mimo że dane techniczne i podatkowe podróżują różnymi ścieżkami cyfrowymi.
FAQ - najczęstsze pytania o obsługę załączników handlowych w KSeF
Czy mogę dołączyć skan protokołu odbioru jako załącznik?
Kontrahent nie chce klikać w linki. Co robić?
Czy faktura korygująca może mieć własny załącznik?
Redakcja · wszystkie artykuły