Wizualizacja faktury w KSeF: jak wygląda, co zawiera i czym różni się od wydruku
Wizualizacja faktury KSeF to czytelna forma prezentacji danych z pliku XML – najczęściej w postaci dokumentu PDF lub HTML – która umożliwia odczytanie zawartości faktury ustrukturyzowanej bez specjalistycznego oprogramowania.
Faktura ustrukturyzowana wystawiona w Krajowym Systemie e-Faktur (KSeF) istnieje wyłącznie jako plik XML zgodny ze strukturą logiczną FA(3). Plik ten nie posiada postaci wizualnej w tradycyjnym rozumieniu – jest technicznym zapisem danych przeznaczonym do przetwarzania maszynowego.
Wizualizacja pełni funkcję pomostu między technicznym formatem XML a codziennymi potrzebami przedsiębiorców: weryfikacją treści faktury, obiegiem dokumentów, komunikacją z kontrahentami zagranicznymi i archiwizacją. Nie jest jednak fakturą w sensie prawnym – faktyczne znaczenie prawne ma wyłącznie plik XML zapisany w systemie KSeF.
Poniżej wyjaśniamy, jak wygląda wizualizacja faktury KSeF, jakie elementy musi zawierać, ile kodów QR jest wymaganych, jak ją wygenerować i czym różni się od wydruku oraz potwierdzenia transakcji.
- Czym jest wizualizacja faktury KSeF?
- Jakie elementy musi zawierać wizualizacja faktury KSeF?
- Ile kodów QR ma wizualizacja? (tryb online vs. offline)
- Jak wygenerować wizualizację faktury z KSeF?
- Kiedy wizualizacja faktury jest obowiązkowa?
- Co wolno, a czego nie wolno dodawać na wizualizacji?
- W jakim języku sporządzić wizualizację faktury KSeF?
- Czym różni się wizualizacja od wydruku i potwierdzenia transakcji?
- Czy wizualizację faktury KSeF trzeba archiwizować?
- Czy wizualizacja faktury KSeF jest dokumentem księgowym?
- Najczęściej popełniane błędy przy wizualizacji faktur w KSeF
Czym jest wizualizacja faktury KSeF?
Wizualizacja faktury KSeF to odzwierciedlenie danych z pliku XML faktury ustrukturyzowanej, przedstawione w formie czytelnej dla człowieka – najczęściej jako dokument PDF, HTML lub wydruk papierowy.
Wizualizację można wygenerować dopiero po nadaniu fakturze numeru KSeF przez system Ministerstwa Finansów. Numer KSeF to 35-znakowy identyfikator alfanumeryczny. Przed nadaniem numeru dokument nie jest uznawany za fakturę i nie może być wizualizowany – jedynym dokumentem, który można wówczas przekazać nabywcy, jest potwierdzenie transakcji.
Ministerstwo Finansów nie wprowadziło oficjalnego, jednolitego wzoru wizualizacji. O wyglądzie dokumentu decyduje oprogramowanie używane przez podatnika – program księgowy, system ERP lub dedykowana aplikacja do obsługi KSeF. Istotne jest jednak, aby wizualizacja spełniała minimalne wymogi określone w rozporządzeniu wykonawczym.
Jakie elementy musi zawierać wizualizacja faktury KSeF?
Wizualizacja faktury KSeF musi odzwierciedlać wszystkie dane z pliku XML, być opatrzona kodem QR i zawierać następujące elementy:
|
Element wymagany |
Uwagi |
|
Numer KSeF (identyfikator 35-znakowy) |
Nadany po walidacji przez system MF |
|
Kod QR |
Umożliwia weryfikację w systemie KSeF (1 lub 2 kody) |
|
Dane sprzedawcy i nabywcy (NIP, nazwa, adres) |
Spójne z XML. NIP obowiązkowy od 1.02.2026 |
|
Szczegóły transakcji (data, opis, ilość, cena, stawka VAT) |
Wszystkie pozycje z pliku XML |
|
Data wystawienia i data sprzedaży |
Obie daty z pliku XML |
|
Kwota netto, VAT i brutto z podziałem na stawki |
Spójne z XML |
|
Oznaczenia specjalne (FP, TP, GTU, MPP) |
Jeśli występują w XML |
Wizualizacja musi odzwierciedlać pełną strukturę danych na fakturze w KSeF określoną schematem FA(3), w tym obowiązkowy NIP i adres. Numer faktury w KSeF - 35-znakowy identyfikator nadawany automatycznie - jest widoczny na wizualizacji w kodzie QR.
Ile kodów QR ma wizualizacja? (tryb online vs. offline)
Wizualizacja faktury wystawionej w trybie online zawiera 1 kod QR, natomiast wizualizacja faktury wystawionej w trybie offline, awarii lub niedostępności KSeF może zawierać 2 kody QR.
|
Tryb wystawienia |
Liczba QR |
QR nr 1 |
QR nr 2 |
|
Online |
1 |
Weryfikacja w KSeF (nr KSeF) |
– |
|
Offline24 |
2 |
Uwierzytelnienie faktury offline |
Weryfikacja po nadaniu nr KSeF |
|
Awaria KSeF |
2 |
Uwierzytelnienie faktury awaryjnej |
Weryfikacja po przywróceniu systemu |
|
Niedostępność KSeF |
2 |
Uwierzytelnienie faktury |
Weryfikacja po nadaniu nr KSeF |
Po zeskanowaniu kodu QR możliwe jest sprawdzenie w systemie KSeF, czy dana faktura znajduje się w bazie i jaki jest jej identyfikator. W przypadku faktur offline drugi kod QR staje się aktywny dopiero po przesłaniu faktury do KSeF i nadaniu numeru.
Jak wygenerować wizualizację faktury z KSeF?
Wizualizację faktury KSeF generuje się za pomocą programu księgowego, systemu ERP lub aplikacji ministerialnej po nadaniu fakturze numeru KSeF – w formacie PDF, HTML lub jako wydruk papierowy.
Procedura obejmuje 3 kroki:
- Krok 1 – Wystawienie faktury i nadanie numeru KSeF. Faktura musi zostać przesłana do KSeF i zaakceptowana przez system. Dopiero po nadaniu numeru KSeF (i otrzymaniu UPO) można wygenerować wizualizację. Do wygenerowania wizualizacji niezbędne jest wcześniejsze logowanie do KSeF Profilem Zaufanym, podpisem kwalifikowanym, tokenem lub certyfikatem KSeF.
- Krok 2 – Wygenerowanie wizualizacji w programie. Program księgowy lub ERP pobiera plik XML z KSeF i generuje jego wizualizację w formacie PDF lub HTML. Wygląd dokumentu zależy od oprogramowania – nie istnieje jednolity wzorzec MF.
- Krok 3 – Weryfikacja spójności i przekazanie. Przed przekazaniem nabywcy należy zweryfikować, czy wizualizacja odzwierciedla wszystkie dane z pliku XML, zawiera kod QR i nie zawiera informacji sprzecznych z treścią faktury ustrukturyzowanej.
Wizualizację można również wygenerować bezpośrednio z poziomu aplikacji ministerialnej (portal KSeF) po zalogowaniu do systemu. W tym przypadku system generuje standardowy widok HTML z kodem QR.
Informacje o dacie wystawienia i otrzymania faktury w KSeF wpływają na moment, od którego wizualizacja może zostać wygenerowana.
Kiedy wizualizacja faktury jest obowiązkowa?
Wizualizacja faktury KSeF może być konieczna w sytuacji, w której nabywca nie może odebrać faktury bezpośrednio z systemu KSeF.
Dotyczy to następujących scenariuszy:
- Kontrahenci zagraniczni bez polskiego NIP – nie są objęci obowiązkiem korzystania z KSeF i nie mają dostępu do systemu. Wizualizacja jest jedynym sposobem przekazania im faktury. Przy fakturach zagranicznych w KSeF sprzedawca musi dodatkowo oznaczyć wizualizację kodem QR i dostarczyć ją w uzgodnionej formie (PDF, wydruk).
- Osoby fizyczne nieprowadzące działalności (konsumenci) – nie mają dostępu do KSeF. Sprzedawca musi przekazać im wizualizację faktury w uzgodnionej formie (PDF, wydruk).
- Nabywcy bez dostępu technicznego do KSeF – podmioty, które nie zintegrowaly swoich systemów z KSeF lub nie posiadają oprogramowania do odczytu XML.
- Sytuacje awaryjne – gdy KSeF nie działa, sprzedawca wystawia fakturę w trybie awaryjnym i może przekazać nabywcy wizualizację z dwoma kodami QR.
W przypadku polskich podatników VAT, którzy mają dostęp do KSeF, wizualizacja nie jest obowiązkowa – faktura jest uznawana za otrzymaną w momencie nadania numeru KSeF. Zasady korzystania z KSeF określają 3 obowiązki wobec systemu: wystawianie, odbieranie i przechowywanie faktur ustrukturyzowanych.
Co wolno, a czego nie wolno dodawać na wizualizacji?
Wizualizacja musi odzwierciedlać dane z pliku XML bez sprzeczności, ale może zawierać niektóre elementy dodatkowe – pod warunkiem, że nie zaburzają czytelności dokumentu.
Dyrektor Krajowej Informacji Skarbowej (KIS) w interpretacji indywidualnej z 3 lipca 2025 r. (nr 0114-KDIP1-3.4012.333.2025.2.AMA) wskazał kluczowe zasady dotyczące treści wizualizacji.
Dozwolone elementy dodatkowe
Na wizualizacji można umieścić elementy graficzne i organizacyjne, które nie dotyczą przedmiotu transakcji.
- Logo firmy sprzedawcy i/lub nabywcy
- Numer wewnętrzny zamówienia, numer umowy lub referencja kontrahenta
- Uwagi wewnętrzne (np. osoba do kontaktu, dział księgowy)
- Informacje o rachunku bankowym (wykraczające poza dane z XML, np. nazwa banku)
- Stopka z danymi firmy (adres strony, REGON, KRS)
Zakaz dodawania informacji o przedmiocie transakcji
Wizualizacja nie może zawierać dodatkowych informacji dotyczących przedmiotu transakcji, które nie zostały zawarte w pliku XML.
Oznacza to, że nie wolno dopisywać na wizualizacji np. rozszerzonych opisów towarów, dodatkowych pozycji fakturowych, informacji o gwarancji czy warunków dostawy, jeśli nie znajdują się one w strukturze XML. Takie działanie mogłoby – według KIS – „wprowadzić w błąd co do przedmiotu transakcji”.
W razie konieczności korekty treści faktury należy wystawić fakturę korygującą w KSeF. Korekta faktury w KSeF wymaga wystawienia nowego dokumentu korygującego w systemie - wizualizacja korekty również musi zawierać kod QR.
W jakim języku sporządzić wizualizację faktury KSeF?
Język wizualizacji faktury KSeF zależy od odbiorcy – obowiązek sporządzenia w języku polskim dotyczy wyłącznie faktur wystawianych na rzecz polskich konsumentów i jednostek prawa publicznego.
Dyrektor KIS w interpretacji z 3 lipca 2025 r. wyjaśnił, że obowiązek używania języka polskiego wynika z ustawy o języku polskim i dotyczy organów publicznych obsługujących KSeF, ale nie przekłada się bezpośrednio na wszystkich podatników.
|
Odbiorca |
Język obowiązkowy? |
Podstawa |
|
Polski konsument (os. fizyczna) |
TAK – język polski |
Ustawa o języku polskim |
|
Organy i instytucje publiczne |
TAK – język polski |
Ustawa o języku polskim |
|
Polskie przedsiębiorstwo (B2B) |
NIE – dowolny język |
Interpretacja KIS 3.07.2025 |
|
Podmiot zagraniczny |
NIE – dowolny język |
Interpretacja KIS 3.07.2025 |
W praktyce oznacza to, że przedsiębiorcy prowadzący handel międzynarodowy mogą sporządzać wizualizacje w języku angielskim lub innym języku uzgodnionym z kontrahentem – pod warunkiem, że dane na wizualizacji pozostają spójne z plikiem XML.
Czym różni się wizualizacja od wydruku i potwierdzenia transakcji?
Wizualizacja to czytelna forma pliku XML dostępna po nadaniu numeru KSeF, wydruk to jej papierowa kopia, a potwierdzenie transakcji to dokument wydawany przed nadaniem numeru.
|
Cecha |
Wizualizacja |
Wydruk |
Potwierdzenie transakcji |
|
Co to jest |
Czytelna forma pliku XML (PDF/HTML) |
Papierowa kopia wizualizacji |
Dokument potwierdzający wystawienie faktury (przed nadaniem nr KSeF) |
|
Kiedy możliwe |
Po nadaniu numeru KSeF |
Po nadaniu numeru KSeF |
Przed nadaniem numeru KSeF (tryb offline24) |
|
Czy jest fakturą? |
NIE – obraz faktury |
NIE – papierowy obraz |
NIE – potwierdzenie, nie faktura |
|
Kod QR |
TAK (1 lub 2) |
TAK (wydrukowany) |
NIE (brak nr KSeF) |
|
Dowód księgowy? |
TAK – pod warunkiem spójności z XML |
TAK – jak wizualizacja |
NIE – wymaga późniejszej weryfikacji |
Rozróżnienie to ma praktyczne znaczenie w trybie offline24: przed nadaniem numeru KSeF sprzedawca nie może przekazać nabywcy wizualizacji faktury (bo ta jeszcze nie istnieje w systemie), ale może przekazać potwierdzenie transakcji. Wizualizacja pojawia się dopiero „po KSeF” – po nadaniu numeru.
Od 1 stycznia 2027 r. płatności za faktury KSeF w mechanizmie podzielonej płatności wymagają podania 35-znakowego numeru KSeF widocznego na wizualizacji w kodzie QR.
Czy wizualizację faktury KSeF trzeba archiwizować?
Obowiązek archiwizacji dotyczy wyłącznie faktury ustrukturyzowanej (pliku XML) zapisanej w systemie KSeF – archiwizacja wizualizacji nie jest prawnie wymagana.
W praktyce jednak archiwizowanie wizualizacji jest rekomendowane. Pliki XML w starszych wersjach struktury FA mogą z czasem wymagać specjalistycznego oprogramowania do odczytu. Dokument PDF jest formatem stabilnym, czytelnym bez dodatkowych narzędzi i łatwym do przeszukiwania.
System KSeF przechowuje faktury przez 10 lat od końca roku, w którym zostały wystawione. Po upływie tego okresu dostęp do pliku XML w systemie ministerialnym może zostać ograniczony. Równoległa archiwizacja wizualizacji w formacie PDF to niewielki koszt dyskowy, ale duża wygoda w przyszłości.
Czy wizualizacja faktury KSeF jest dokumentem księgowym?
Wizualizacja faktury KSeF może pełnić funkcję dowodu księgowego, pod warunkiem że nabywca ma pewność, iż odpowiada ona fakturze zarejestrowanej w KSeF.
W sensie prawnym fakturą jest wyłącznie plik XML zapisany w systemie KSeF. Wizualizacja jest jedynie jego obrazem. W razie rozbieżności między wizualizacją a plikiem XML decydujące znaczenie prawne mają dane zawarte w strukturze XML.
Dla celów dowodowych (np. kontrola podatkowa) wystarczający jest dostęp do faktury w systemie KSeF. Wizualizacja pełni funkcję pomocniczą – ułatwia weryfikację, obieg wewnętrzny i komunikację z kontrahentami, ale nie zastępuje pliku XML.
Najczęściej popełniane błędy przy wizualizacji faktur w KSeF
Najczęstszym błędem jest generowanie wizualizacji przed nadaniem fakturze numeru KSeF – taki dokument nie spełnia wymogów rozporządzenia i nie zawiera kodu QR umożliwiającego weryfikację.
- Wizualizacja przed nadaniem numeru KSeF. Dokument bez numeru KSeF i kodu QR nie jest wizualizacją – to co najwyżej potwierdzenie transakcji.
- Sprzeczności między wizualizacją a plikiem XML. Jakiekolwiek różnice w danych (kwoty, daty, pozycje) mogą być zakwestionowane podczas kontroli.
- Dodawanie informacji o przedmiocie transakcji wykraczających poza XML. Interpretacja KIS zabrania dopisywania dodatkowych opisów towarów nieujętych w strukturze faktury ustrukturyzowanej.
- Brak kodu QR na wydruku papierowym. Wydruk wizualizacji musi zawierać kod QR – bez niego odbiorca nie może zweryfikować autentyczności dokumentu.
- Traktowanie wizualizacji jako oryginału faktury. Wizualizacja to obraz, nie faktura. Oryginałem jest wyłącznie plik XML w systemie KSeF.
Unikanie błędów przy wizualizacji faktur w KSeF wymaga weryfikacji spójności danych z plikiem XML, generowania dokumentu dopiero po nadaniu numeru KSeF oraz znajomości zasad dotyczących elementów dozwolonych i zakazanych na wizualizacji. Błędy w treści faktury koryguje się przez korygowanie faktur w KSeF (faktura korygująca z nowym kodem QR). Numer KSeF widoczny na wizualizacji jest jednocześnie identyfikatorem wymaganym przy płatnościach w KSeF od 1 sierpnia 2026 r.

