Przejdź do treści

Codzienna Obsługa i Procesy Fakturowania5 min czytania

Obsługa załączników handlowych - protokoły i specyfikacje a KSeF: co się zmieni w 2026 roku

Obsługa załączników handlowych w Krajowym Systemie e-Faktur to zbiór reguł określających, w jaki sposób do faktury ustrukturyzowanej można dołączyć dodatkowe dane podatkowe w formacie XML zgodnie ze schematem FA(3), bez możliwości przesłania plików PDF czy protokołów papierowych. Nowe zasady wchodzą w życie z dniem 1 lutego 2026 r. dla dużych przedsiębiorców oraz 1 kwietnia 2026 r. dla pozostałych podatników VAT. Maksymalny rozmiar całej wiadomości XML zawierającej fakturę wraz z załącznikiem wynosi 3 MB. Mechanizm ten staje się standardem rynkowym, wymuszając na podmiotach gospodarczych dostosowanie systemów ERP do nowej struktury logicznej dokumentów elektronicznych.

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?
Nie. System KSeF nie akceptuje plików graficznych ani formatów binarnych takich jak PDF. Wszystkie dane z protokołu, które mają znaczenie podatkowe, należy przepisać do ustrukturyzowanej tabeli XML wewnątrz węzła Załącznik lub przesłać skan dokumentu kanałem zewnętrznym (np. e-mail).
Kontrahent nie chce klikać w linki. Co robić?
W takiej sytuacji należy skorzystać z tradycyjnej wymiany EDI lub przesłać załącznik w wiadomości e-mail opatrzonej podpisem kwalifikowanym. Zapewnia to autentyczność pochodzenia i integralność treści dokumentu, co daje równoważny skutek prawny w zakresie dokumentowania zdarzeń gospodarczych.
Czy faktura korygująca może mieć własny załącznik?
Tak, faktura korygująca może posiadać własny węzeł Załącznik. Musi on jednak zawierać wyłącznie dane bezpośrednio korygujące podstawę opodatkowania oraz kwotę podatku VAT, zgodnie ze specyfikacją przewidzianą dla dokumentów korygujących w systemie KSeF.

Redakcja · wszystkie artykuły