KSeF — środowisko testowe i produkcyjne

W środowisku testowym Aplikacji Podatnika KSeF 2.0 można używać fikcyjnych danych zarówno na fakturach, jak i podczas logowania.¹
Przed rozpoczęciem prób warto ustalić, do którego systemu trafiają dane. KSeF 2.0 ma trzy odrębne środowiska: testowe, przedprodukcyjne (Demo) i produkcyjne².

Czym jest środowisko testowe i przedprodukcyjne KSeF?

Środowisko testowe oraz środowisko przedprodukcyjne KSeF 2.0 służą do prób przed rozpoczęciem pracy w produkcji. Podstawowa różnica dotyczy uwierzytelniania użytkownika.
Przedprodukcyjne Demo dla Aplikacji Podatnika udostępniono 15 listopada 2025 r.^1,3

Tabela zestawia sposoby uwierzytelniania: środowisko testowe dopuszcza dane fikcyjne, natomiast Demo wymaga rzeczywistych danych uwierzytelniających i właściwych uprawnień³.

Dane w tabeli: 1,4

W Demo do logowania potrzebne są prawdziwe dane uwierzytelniające, ale na fakturach należy wpisywać dane fikcyjne.¹
Profil Zaufany pozwala potwierdzić rzeczywistą tożsamość użytkownika. Nie zmienia to zasady dotyczącej treści próbnej faktury: jej dane nadal powinny być fikcyjne⁵.

Jak działa demo KSeF w środowisku przedprodukcyjnym?

Demo KSeF pozwala przedsiębiorcy lub integratorowi przećwiczyć obsługę Aplikacji Podatnika bez wystawiania faktur na rzeczywistych kontrahentów. Jeśli na próbnej fakturze wpisujesz polski NIP nabywcy, wybierz fikcyjny numer złożony z 10 cyfr⁶.

• Wejście do Demo wymaga wybrania środowiska przedprodukcyjnego zamiast produkcyjnego.
• Logowanie do Demo odbywa się metodą uwierzytelnienia właściwą dla podatnika.
• Próba wystawienia faktury powinna opierać się na przykładowych danych sprzedawcy i nabywcy.

Demo pozwala ćwiczyć obsługę KSeF bez pracy na rzeczywistych danych faktur. Art. 112aa ust. 1 ustawy o VAT przewiduje przechowywanie faktur w KSeF przez 10 lat. Dane Demo są okresowo usuwane, więc nie tworzą takiego archiwum⁷.

Czym są testy Aplikacji Podatnika i API KSeF 2.0?

Testy Aplikacji Podatnika i API KSeF 2.0 pozwalają sprawdzić obsługę faktur oraz połączenie zewnętrznego programu z systemem. Testowa Aplikacja Podatnika jest połączona ze środowiskiem testowym API, czyli interfejsu komunikacji między systemami.⁸
Wersję testową aplikacji udostępniono 3 listopada 2025 r.⁹

Czym jest środowisko przedprodukcyjne Aplikacji Podatnika KSeF 2.0?

Środowisko przedprodukcyjne Aplikacji Podatnika to Demo, w którym można przećwiczyć obsługę przed pracą w produkcji. Produkcyjną Aplikację Podatnika KSeF 2.0 uruchomiono 1 lutego 2026 r.⁸
Wybranie Demo oddziela takie próby od bieżącego fakturowania¹⁰.

Co oznaczają otwarte testy API KSeF 2.0 dla firm?

Otwarte testy API KSeF 2.0 dają firmie możliwość sprawdzenia integracji programu do faktur lub księgowości. Uruchomiono je 30 września 2025 r.¹¹
API KSeF 1.0 nie jest kompatybilne z API KSeF 2.0. Integrację z nowszą wersją trzeba więc sprawdzić w jej własnym środowisku testowym^11,12.

Jak wystawić fakturę w wersji demo KSeF?

Wystawienie faktury w Demo KSeF zaczyna się od przygotowania dokumentu w Aplikacji Podatnika. Środowisko przedprodukcyjne pozwala sprawdzić wystawianie, odbieranie i przeglądanie faktur zgodnych ze strukturą logiczną FA(3)³.

• Wybór środowiska Demo oddziela próbę od wystawiania faktur w produkcji.
• Przygotowanie dokumentu polega na sporządzeniu faktury w strukturze logicznej FA(3), która określa układ jej danych. Testowa aplikacja pozwala wystawiać, odbierać i przeglądać takie faktury oraz korekty.⁸
• Kontrola dokumentu obejmuje jego wyszukanie i pobranie w formacie XML, HTML lub PDF.⁸

Po zakończeniu próby można jeszcze przejrzeć zawartość dokumentu w aplikacji.

Środowisko testowe KSeF a produkcja: skutki wysyłki faktur i typowe błędy

Środowisko testowe KSeF nie zastępuje produkcyjnego. Czynności w testowej Aplikacji Podatnika KSeF 2.0 nie wywołują skutków prawnych, a wprowadzone dane są okresowo usuwane.⁸
Potwierdzenie próbnej wysyłki nie oznacza zatem, że faktura została wystawiona w obrocie gospodarczym. Zgodnie z art. 106na ust. 1 ustawy o VAT datą wystawienia jest co do zasady dzień przesłania faktury do KSeF. Wysyłka testowa nie jest wysyłką produkcyjną¹³.

Jak wysłać fakturę testową i sprawdzić odpowiedź KSeF?

Fakturę testową kieruj wyłącznie do środowiska testowego. Odpowiedź sprawdź w tym samym środowisku. Tabela podaje adresy bazowe API dla każdego z nich¹⁴.

• Kontrola przed wysyłką wymaga sprawdzenia, czy aplikacja lub program łączy się ze środowiskiem testowym, a nie produkcyjnym.
• Kontrola po wysyłce polega na odczytaniu statusu operacji oraz komunikatu o przyjęciu lub odrzuceniu dokumentu.
• Postępowanie przy odrzuceniu zaczyna się od poprawienia przyczyny wskazanej w odpowiedzi. Potem można ponowić próbę w środowisku testowym.¹⁵

Otrzymana odpowiedź dotyczy próby testowej. Nie jest produkcyjnym Urzędowym Poświadczeniem Odbioru (UPO).

Jak rozpoznać błędy logowania, połączenia i walidacji w środowisku testowym?

Błędy w środowisku testowym KSeF najłatwiej rozpoznać po etapie, na którym operacja się zatrzymuje. Tabela wskazuje, co skontrolować przy logowaniu, połączeniu i walidacji. W odpowiedziach API kod 401 oznacza nieprawidłowe uwierzytelnienie, a 403 może wskazywać brak uprawnień do danej operacji¹⁶.

Czym różniły się środowisko testowe i fakultatywna wersja produkcyjna KSeF 1.0?

Środowisko testowe KSeF 1.0 służyło do prób, a fakultatywna wersja produkcyjna – do rzeczywistego korzystania z systemu. O różnicy decydowały punkt dostępu i cel wysyłki, nie wygląd faktury.
Przed wysłaniem dokumentu należało więc ustalić, z którym środowiskiem łączy się aplikacja. Dobrowolne korzystanie z produkcyjnego KSeF rozpoczęło się 1 stycznia 2022 r.¹⁷

Jak skonfigurować i przeprowadzić bezpieczne testy KSeF?

Testy KSeF 2.0 prowadź na danych przeznaczonych do prób. Najpierw wybierz właściwe środowisko w aplikacji lub programie do faktur. Konfigurację testową oddziel od produkcyjnej, żeby próbne operacje nie trafiły do bieżącego fakturowania.
Adresy obu konfiguracji znajdziesz w tabeli w sekcji o wysyłce; w programie ustaw je osobno¹⁴.

Co sprawdzić podczas testowania platformy KSeF?

Podczas testowania platformy KSeF sprawdź uprawnienia, certyfikaty i struktury organizacyjne używane przez firmę. Certyfikaty KSeF mają dwa zastosowania: uwierzytelnianie użytkownika oraz oznaczanie faktur wystawianych w trybie offline¹⁸.

• Środowisko połączenia ustaw jako testowe, zanim rozpoczniesz próby w aplikacji lub programie do faktur.
• Jednostki zależne i identyfikatory złożone możesz przetestować w Aplikacji Podatnika. Aplikacja pozwala również wnioskować o certyfikaty i je pobierać.⁸
• Uprawnienia i certyfikaty testowe traktuj oddzielnie od produkcyjnego Modułu Certyfikatów i Uprawnień (MCU). Działania w środowisku testowym nie zmieniają zapisów w tym module.⁹
• Błąd Aplikacji Podatnika opisz i przekaż przez formularz zgłoszeniowy KSeF.⁸

Na koniec oceń działanie konfiguracji testowej. Próby nie powinny zmieniać produkcyjnych uprawnień ani certyfikatów.

Środowisko testowe KSeF (TE): co sprawdzić technicznie

Środowisko testowe KSeF (TE) pozwala sprawdzić faktury wystawione offline, dostęp do dokumentów i pobieranie poświadczeń. Obsługę tokenów w testowej Aplikacji Podatnika KSeF 2.0 przewidziano do 31 grudnia 2026 r.^8,9

• Tryb offline dotyczy faktury wystawionej bez bieżącego połączenia z systemem. Testowa aplikacja obsługuje takie dokumenty.⁸
• Kody QR i dostęp anonimowy pozwalają sprawdzić dostęp do faktury. Obie funkcje są dostępne w testowej aplikacji.⁸
• Urzędowe Poświadczenie Odbioru (UPO) można pobrać w testowej aplikacji i skontrolować jako wynik próbnej operacji.⁸

Kontrola techniczna obejmuje całą drogę faktury: od przygotowania dokumentu po dostęp do niego i poświadczenia.

KSeF w praktyce: podstawy działania i korzyści

KSeF służy do wystawiania i odbierania faktur w systemie elektronicznym. Aplikacja Podatnika KSeF 2.0 to bezpłatne oprogramowanie resortu finansów do wystawiania i otrzymywania faktur.⁸
Firma może pracować w tej aplikacji albo połączyć z KSeF własny program do fakturowania.

Jak działa KSeF?

KSeF przyjmuje fakturę przesłaną przez uprawnionego użytkownika lub połączony program. Następnie udostępnia ją do odbioru.

• Użytkownik KSeF przygotowuje fakturę w aplikacji lub połączonym programie.
• System KSeF przetwarza przesłany dokument i zwraca informację o wyniku operacji.
• Odbiorca faktury uzyskuje dostęp do dokumentu w systemie.

Jeśli system przyjmie dokument, faktura staje się dostępna do odbioru.

Jakie korzyści może przynieść korzystanie z KSeF?

KSeF skupia wystawianie i odbieranie faktur w jednym systemie. Firma może pracować bezpośrednio w Aplikacji Podatnika albo korzystać z połączonego programu. Tabela zestawia oba sposoby.

Najczęściej zadawane pytania

Jak stworzyć token testowy KSeF?

Artykuł nie opisuje kroków tworzenia tokenu. Podaje jedynie, że testowa Aplikacja Podatnika obsługuje tokeny do 31 grudnia 2026 r.

Czy testowe faktury KSeF są dostępne?

Tak. W testowej Aplikacji Podatnika można wystawiać, odbierać i przeglądać faktury oraz korekty. Do prób używaj fikcyjnych danych.

Czy testową fakturę można pobrać w różnych formatach?

Tak. Dokument można pobrać w formacie XML, HTML lub PDF.

Czy testowe faktury mogą zawierać rzeczywisty NIP nabywcy?

W próbnym dokumencie należy używać danych fikcyjnych. Jeśli wpisujesz polski NIP, wybierz fikcyjny numer złożony z 10 cyfr.

Czy dane z Demo są przechowywane tak długo jak faktury produkcyjne?

Nie. Dane Demo są okresowo usuwane, więc nie tworzą archiwum przechowywanego przez 10 lat.

Gdzie zgłosić błąd Aplikacji Podatnika?

Błąd można opisać i przekazać przez formularz zgłoszeniowy KSeF.