KSeF — środowisko testowe i produkcyjne

Przed uruchomieniem połączenia z produkcyjnym KSeF warto sprawdzić je w środowisku testowym KSeF 2.0. Ministerstwo Finansów udostępniło testowe API 30 września 2025 r.¹
Środowisko przedprodukcyjne KSeF 2.0 (DEMO) udostępniono 15 października 2025 r.²
Te środowiska służą różnym celom; poniżej znajdziesz ich porównanie oraz zasady bezpiecznych prób³.

Czym jest środowisko testowe KSeF i czym różni się od produkcyjnego?

Ministerstwo Finansów wyłączyło wcześniejsze środowisko testowe KSeF 1.0 1 września 2025 r.¹
Obecne środowisko testowe KSeF 2.0 służy do prób, podczas gdy produkcyjne obsługuje rzeczywiste faktury⁴.

Testowa Aplikacja Podatnika KSeF 2.0 jest skierowana przede wszystkim do dostawców oprogramowania. Przedsiębiorcy przygotowujący się do pracy z systemem mogą korzystać z wersji DEMO⁵.
Testową Aplikację Podatnika udostępniono 3 listopada 2025 r., a jej wersję Demo – 15 listopada 2025 r.⁶

Czym różnią się dane, uprawnienia i skutki wysłania faktury w środowisku testowym i produkcyjnym?

Wybrane środowisko decyduje o danych używanych podczas prób, sposobie logowania i skutkach wysłania faktury. W testowym można posługiwać się fikcyjnymi danymi; wykonane tam czynności nie wywołują skutków prawnych⁵.
DEMO wymaga prawdziwych danych uwierzytelniających, ale wystawione w nim faktury nie wywołują skutków podatkowych⁷. KSeF 2.0 obejmuje trzy środowiska: testowe, Demo i produkcyjne. Tylko wysyłka w produkcyjnym wywołuje skutki prawne⁸.

Tabela zestawia środowiska KSeF pod kątem danych używanych przy dostępie oraz skutków wysłania faktury.

Na czym polegają otwarte testy API KSeF 2.0?

Otwarte testy API KSeF 2.0 pozwalają sprawdzić połączenie programu finansowo-księgowego z obowiązkową wersją KSeF⁹. API jest interfejsem, przez który program wymienia dane z systemem.
Próba integracji dotyczy tej wymiany, nie zaś wystawiania faktur w środowisku produkcyjnym¹⁰. Otwarte testy API KSeF 2.0 ruszyły 30 września 2025 r.¹⁰

Co może się stać, gdy pomylisz środowisko testowe z produkcyjnym?

Gdy pomylisz środowisko testowe z produkcyjnym, możesz wysłać próbną fakturę do rzeczywistego obiegu albo pozostawić właściwą fakturę poza nim. Przed wysyłką ustal więc, z którym środowiskiem łączy się aplikacja. DEMO nie zastępuje produkcji.
Zgodnie z art. 106na ust. 1 ustawy o VAT fakturę ustrukturyzowaną uznaje się za wystawioną w dniu przesłania do KSeF¹¹.

Środowisko testowe KSeF przeznaczono do prób, a faktury do rzeczywistego obiegu wysyła się przez środowisko produkcyjne. Zgodnie z art. 112aa ust. 1 ustawy o VAT KSeF przechowuje faktury ustrukturyzowane przez 10 lat od końca roku ich wystawienia¹¹.

Przygotowanie do KSeF 2.0: Demo, integracje i edukacja

Przygotowania do KSeF 2.0 mogą obejmować próby w aplikacji oraz testy integracji. Według Ministerstwa Finansów testowanie Aplikacji Podatnika w środowisku testowym rozpoczęło się 3 listopada 2025 r.¹
W środowisku przedprodukcyjnym aplikację udostępniono 15 listopada 2025 r.¹ Korzystanie z DEMO jest dobrowolne^3,7.

Jakie funkcje można przetestować w środowisku Demo KSeF 2.0?

Środowisko Demo KSeF 2.0 pozwala przećwiczyć obieg faktur, pobieranie dokumentów i zarządzanie dostępem. Lista poniżej porządkuje funkcje oraz procesy dostępne podczas prób.
Aplikację Podatnika w Demo udostępniono 15 listopada 2025 r.; umożliwia ona testowanie obiegu faktur i zarządzania uprawnieniami¹².

• Faktury FA(3) można w DEMO wystawiać, odbierać oraz pobierać jako XML, PDF i HTML. FA(3) oznacza strukturę danych faktury, a XML jest formatem przeznaczonym do odczytu maszynowego⁷.
• Tokeny i certyfikaty można obsługiwać w DEMO. Próby mogą też dotyczyć uprawnień⁷.
• UPO, kody QR i zgodność systemu ERP również mogą wejść w zakres prób w DEMO. UPO oznacza urzędowe poświadczenie odbioru, a ERP służy do zarządzania procesami firmy⁷.

Próby w DEMO dotyczą więc zarówno obsługi faktury, jak i elementów integracji⁸.

Jak sprawdzić, z którym środowiskiem KSeF łączy się program do faktur?

Kontrolę połączenia programu do faktur z KSeF zacznij od ustawień integracji. Odczytaj nazwę środowiska i adres usługi, z którą komunikuje się program. Przed wysyłką porównaj je z ustawieniami połączenia produkcyjnego.
Ustal z dostawcą programu, które połączenie jest aktywne, gdy to on zajmuje się konfiguracją. Środowiska testowe, Demo i produkcyjne mają trzy odrębne adresy API¹³.

Po kontroli powinno być jasne, czy aktywne połączenie prowadzi do testów, DEMO czy produkcji.

Gdzie szukać materiałów edukacyjnych o KSeF?

Testowa Aplikacja Podatnika pozwala poznawać funkcje KSeF bez ograniczeń i zgłaszać błędy⁵. Pomoc techniczna API KSeF 2.0 działa w dni robocze w godzinach 7:00–19:00⁹.
Aplikacja służy do ćwiczenia obsługi systemu, a zespół techniczny odpowiada na pytania dotyczące API. Zespół API KSeF 2.0 pracuje w dni robocze od 7:00 do 19:00, czyli przez 12 godzin dziennie¹⁰.

Jak bezpiecznie testować wysyłanie i odbieranie faktur w środowisku testowym KSeF?

Do próby wysyłania i odbierania faktur w testowym KSeF przygotuj fikcyjne dane. Opis testowej Aplikacji Podatnika wskazuje, że można zalogować się na dowolny NIP, a wpisane dane mogą zobaczyć inni¹⁴.
Nie używaj więc danych rzeczywistego podatnika ani kontrahenta. Fikcyjny identyfikator NIP wykorzystany w teście powinien mieć 10 cyfr¹⁵.

Lista przedstawia kolejne kroki bezpiecznej próby obiegu faktury.

• Przygotowanie danych wymaga użycia informacji fikcyjnych lub zanonimizowanych. Trafią one do faktury ustrukturyzowanej, czyli dokumentu zapisanego w wymaganym formacie danych.
• Wysyłka faktury odbywa się w środowisku testowym. Zanotuj wynik tej próby.
• Odbiór faktury przeprowadź w tym samym środowisku. Porównaj odebrany dokument z wysłanym.

Zapisane poza aplikacją wyniki pozwolą później wrócić do przebiegu próby.

Testowa Aplikacja Podatnika KSeF okresowo usuwa zapisane dane, dlatego zachowaj wyniki w innym miejscu⁵. Bezpieczna próba opiera się na fikcyjnych danych i kończy zapisem wyniku wysyłki oraz odbioru.

Testowanie uprawnień i certyfikatów w KSeF krok po kroku

Przed testowaniem uprawnień i certyfikatów w KSeF 2.0 określ metodę uwierzytelnienia użytkownika oraz planowaną czynność. Według informacji o DEMO w początkowym okresie prób zdarzały się problemy z uwierzytelnianiem pieczęcią kwalifikowaną².
O certyfikaty KSeF 2.0 można było wnioskować w Module Certyfikatów i Uprawnień od 1 listopada 2025 r.¹⁶

Lista pomaga uporządkować kontrolę dostępu przed wykonaniem czynności w KSeF.

• Ustalenie uprawnień użytkownika wymaga sprawdzenia ich w odpowiednim środowisku KSeF 2.0. Następnie porównaj je z planowaną czynnością; nie odsyłaj do MCU jako działającego modułu⁶.
• Rozróżnienie poświadczeń polega na zapisaniu rodzaju użytego w próbie: certyfikatu testowego, certyfikatu kwalifikowanego lub pieczęci kwalifikowanej. Te nazwy nie są zamienne.
• Test uwierzytelnienia wymaga zapisania metody i wyniku. Pozwoli to odróżnić kłopot z logowaniem od odmowy wykonania czynności.

Wynik próby powinien osobno wskazywać metodę uwierzytelnienia i zakres uprawnień¹⁷.

Najczęściej zadawane pytania

Czy środowisko testowe KSeF 1.0 nadal działa?

Nie. Ministerstwo Finansów wyłączyło je 1 września 2025 r.; obecnie udostępnione jest środowisko testowe KSeF 2.0.

Czy inni użytkownicy mogą zobaczyć dane wpisane w testowej Aplikacji Podatnika?

Tak, dlatego do prób używaj danych fikcyjnych lub zanonimizowanych, a nie danych rzeczywistego podatnika ani kontrahenta.

Czy dane zapisane w testowej Aplikacji Podatnika pozostają tam na stałe?

Nie, aplikacja okresowo usuwa zapisane dane. Zachowaj wyniki prób poza aplikacją.

Czy w testowej Aplikacji Podatnika można zgłaszać błędy?

Tak. Aplikacja pozwala poznawać funkcje KSeF i zgłaszać błędy.

Dla kogo przeznaczono testową Aplikację Podatnika?

Przede wszystkim dla dostawców oprogramowania. Przedsiębiorcy przygotowujący się do pracy z KSeF mogą korzystać z wersji DEMO.

Stan prawny na: październik 2026.