Jaki jest adres środowiska testowego KSeF?

Aplikacja podatnika na TEST działa pod https://ap-test.ksef.mf.gov.pl, a API pod https://api-test.ksef.mf.gov.pl/api/v2. Środowisko DEMO to https://ap-demo.ksef.mf.gov.pl, produkcja to https://ap.ksef.mf.gov.pl.

Dlaczego ksef-test.mf.gov.pl nie działa?

Bo to adres KSeF 1.0. We wrześniu 2025 r. Ministerstwo Finansów zamieniło środowiska testowe na KSeF 2.0 i stare hosty wyłączyło. Dziś ksef-test.mf.gov.pl zwraca błąd serwera. Aktualny adres testowy to ap-test.ksef.mf.gov.pl.

Czym różni się TEST od DEMO w KSeF?

Na TEST logujesz się tożsamością fikcyjną: wymyślonym NIP-em, bez podpisu i bez prawdziwych danych, a dane bywają czyszczone. Na DEMO logujesz się prawdziwym NIP-em i prawdziwym podpisem kwalifikowanym albo Profilem Zaufanym, ale środowisko nadal jest nieprodukcyjne. TEST sprawdza kod, DEMO sprawdza uprawnienia i ludzi.

Czy faktura wystawiona w środowisku testowym KSeF jest ważna?

Nie. Faktura złożona na TEST albo DEMO nie ma żadnych skutków prawnych: nie jest fakturą w rozumieniu ustawy o VAT, nie trafia do rozliczenia i nie widzi jej Twój kontrahent. Numer KSeF i UPO, które tam dostajesz, są prawdziwe technicznie, ale bezużyteczne podatkowo.

Czy token z TEST zadziała na produkcji?

Nie. Każde środowisko ma własny rejestr uprawnień, więc token wygenerowany na TEST uwierzytelnia się wyłącznie w TEST. Na produkcji generujesz osobny token albo osobny certyfikat. Ta sama zasada dotyczy DEMO.

Czy dane z TEST przeniosą się na produkcję?

Nie. To trzy osobne kopie systemu. Faktury, numery KSeF, UPO i uprawnienia nadane na TEST zostają na TEST. Na produkcji zaczynasz od zera i pierwszą fakturę składasz od nowa.

KSeF testowy: gdzie jest środowisko testowe i czym różni się od DEMO

Środowisko testowe KSeF 2.0 działa pod adresem https://ap-test.ksef.mf.gov.pl, a jego API pod https://api-test.ksef.mf.gov.pl/api/v2. Stary adres z KSeF 1.0, czyli ksef-test.mf.gov.pl, jest wyłączony i zwraca błąd serwera. Na TEST logujesz się tożsamością fikcyjną i nic nie ma tam skutków prawnych. DEMO to osobne środowisko: prawdziwy NIP i prawdziwy podpis, ale nadal bez skutków prawnych.

KSeF ma trzy środowiska i to nie są trzy tryby jednej aplikacji. To trzy osobne kopie systemu, każda z własnym adresem, własnym rejestrem uprawnień i własnymi danymi. Wybór złego środowiska kosztuje albo dzień szukania, dlaczego token nie działa, albo prawdziwą fakturę w krajowym rejestrze.

Stary adres testowy nie działa i nie wróci

We wrześniu 2025 r. Ministerstwo Finansów zamieniło środowiska testowe z KSeF 1.0 na KSeF 2.0. Stare hosty przestały odpowiadać: https://ksef-test.mf.gov.pl/web/ zwraca dziś błąd serwera, a ksef.mf.gov.pl to adres nieaktualnej wersji 1.0. Nic tam nie naprawisz i nie ma się do czego zalogować.

To najczęstsza przyczyna pytania „nie mogę wejść do KSeF testowego”. Sporo polskich poradników, wpisów na forach i firmowych instrukcji wdrożeniowych wciąż podaje stary adres. Jeśli ktoś kazał Ci założyć konto na ksef-test.mf.gov.pl, ta instrukcja jest po prostu przeterminowana.

Aktualne adresy aplikacji podatnika:

TEST https://ap-test.ksef.mf.gov.pl
DEMO https://ap-demo.ksef.mf.gov.pl
PROD https://ap.ksef.mf.gov.pl

Adresy API, jeśli piszesz integrację, są symetryczne: api-test.ksef.mf.gov.pl/api/v2, api-demo.ksef.mf.gov.pl/api/v2 i api.ksef.mf.gov.pl/api/v2. Kontrakt produkcyjnego API jest zamrożony od 22 grudnia 2025 r., więc nie zmieni Ci się w połowie wdrożenia. Obowiązujący schemat to FA(3), obowiązkowy od 1 lutego 2026 r. FA(2) jest martwe i nie ma sensu na nim niczego opierać.

Po co w ogóle testować

Bo w KSeF nie ma cofnięcia. Faktura przyjęta przez system jest wystawiona, a datą wystawienia jest data wysłania (art. 106na ust. 1 ustawy o VAT), nie data wpisana w dokumencie. Nie skasujesz jej, nie poprawisz w miejscu i nie ukryjesz. Jedyne wyjście to faktura korygująca, która sama jest osobnym dokumentem w rejestrze.

Gorszy scenariusz: sztuczna faktura pod Twoim prawdziwym NIP-em. To art. 108 ustawy o VAT, czyli podatek do zapłaty od dokumentu, który nie opisuje żadnej sprzedaży. Ktoś, kto „na szybko sprawdzi, czy działa” na produkcji, właśnie wystawił sobie zobowiązanie.

Środowisko testowe chroni Cię przed czterema rzeczami naraz:

Błędami w mapowaniu danych. Zła stawka VAT, kod kraju, waluta, brak adresu przy nabywcy z NIP-em.
Błędami w konfiguracji. Token bez właściwego uprawnienia, zły NIP kontekstu, wygasły certyfikat.
Błędami w procesie. Nie wiesz jeszcze, jak wygląda odrzucenie, gdzie leży UPO i co robić, gdy sesja padnie w połowie.
Stresem przy pierwszej prawdziwej fakturze. Ten, kto raz przeszedł całą drogę na TEST, przy pierwszej ostrej wysyłce już wie, co zobaczy.

TEST przydaje się nie tylko na starcie. Wracasz tam, kiedy zmieniasz system do fakturowania, kiedy pierwszy raz wystawiasz dokument innego typu (korektę, eksport usług, odwrotne obciążenie dla klienta z UE), kiedy przechodzisz z tokenu na certyfikat albo kiedy pojawia się nowa wersja schematu. Za każdym razem chodzi o to samo: sprawdzić kształt dokumentu tam, gdzie pomyłka nic nie kosztuje.

Trzy środowiska KSeF: TEST, DEMO i PROD

Środowisko	Uwierzytelnienie	Tożsamość	Trwałość danych	Do czego służy
TEST `ap-test.ksef.mf.gov.pl`	fikcyjne, bez podpisu	wymyślony NIP, dane nieprawdziwe	dane bywają czyszczone, nie licz na nie	pierwszy kontakt, integracja, testy automatyczne
DEMO `ap-demo.ksef.mf.gov.pl`	prawdziwe: podpis kwalifikowany, pieczęć albo Profil Zaufany	Twój prawdziwy NIP	nieprodukcyjne, bez skutków prawnych	próba generalna z prawdziwymi uprawnieniami
PROD `ap.ksef.mf.gov.pl`	prawdziwe	Twój prawdziwy NIP	trwałe, pełne skutki prawne	prawdziwe faktury i nic poza tym

Cała praktyczna różnica siedzi w kolumnie „uwierzytelnienie”. TEST przyjmuje tożsamości wymyślone, więc wchodzisz tam w minutę, z NIP-em o poprawnej sumie kontrolnej i bez żadnego podpisu. DEMO wymaga prawdziwego podpisu kwalifikowanego albo Profilu Zaufanego, dokładnie jak produkcja. Kto pomyli te dwa, traci dni: albo czeka na certyfikat, którego wcale nie potrzebował, albo próbuje wejść na DEMO wymyślonym NIP-em i nie rozumie, czemu odbija.

Jak wejść na TEST

Otwórz https://ap-test.ksef.mf.gov.pl.
Uwierzytelnij się tożsamością testową. Nie podajesz prawdziwych danych firmy i nie potrzebujesz podpisu. Wystarczy NIP o poprawnej strukturze.
W aplikacji podatnika wygeneruj token dla tego środowiska albo zarejestruj certyfikat, jeśli chcesz od razu ćwiczyć docelową metodę.
Wklej go do swojej integracji ustawionej na api-test.ksef.mf.gov.pl/api/v2 i złóż pierwszą fakturę.

Co możesz tam zrobić:

Złożyć fakturę i przejść pełny cykl statusów, aż do numeru KSeF i UPO.
Zobaczyć odrzucenie z prawdziwym kodem błędu i nauczyć się je czytać, zanim zobaczysz je na produkcji.
Wystawić korektę KOR odwołującą się do pierwotnego numeru KSeF.
Przećwiczyć nadawanie uprawnień, na przykład biuru rachunkowemu.
Wygenerować kod QR i sprawdzić, co zobaczy nabywca.
Puścić testy automatyczne integracji tyle razy, ile chcesz. Nic stąd nie wyjdzie na zewnątrz.

Wybór metody uwierzytelnienia opisujemy osobno w tokenie czy certyfikacie, a szczegóły API w KSeF API.

Kiedy lepiej wybrać DEMO

DEMO ma sens wtedy, gdy testujesz nie kod, tylko ludzi i uprawnienia. Typowe przypadki:

Sprawdzasz, czy Twój podpis kwalifikowany albo pieczęć firmowa naprawdę działa w KSeF, zanim ruszysz na produkcję.
Nadajesz uprawnienia biuru rachunkowemu albo pracownikowi i chcesz zobaczyć, co on zobaczy.
Robisz próbę generalną całego procesu wystawiania na prawdziwej strukturze organizacyjnej firmy.

Kosztuje Cię to prawdziwe uwierzytelnienie: podpis kwalifikowany, pieczęć firmową albo Profil Zaufany. Jeśli żadnego z nich jeszcze nie masz, DEMO zaczyna się od załatwienia certyfikatu albo profilu, a nie od pierwszego zapytania do API. Dlatego kolejność, która się broni, jest taka: najpierw TEST, bo wchodzisz tam w minutę i wyłapujesz większość błędów, potem DEMO, jeśli potrzebujesz sprawdzić uprawnienia, a na końcu produkcja.

Jeśli integrujesz się sam i nie masz rozbudowanej struktury uprawnień, DEMO możesz spokojnie pominąć. Wielu jednoosobowych sprzedawców idzie z TEST prosto na PROD i to jest w porządku.

Czego faktura testowa dowodzi, a czego nie

Dowodzi rzeczy konkretnych i wartościowych:

Twój token albo certyfikat uwierzytelnia się poprawnie.
Twój XML przechodzi walidację schematu FA(3).
Klasyfikacja podatkowa dokumentu jest taka, jakiej się spodziewasz.
Cały obieg działa: wysyłka, status, numer KSeF, UPO, korekta.

Czego nie dowodzi, a co ludzie zakładają:

Nie dowodzi niczego wobec urzędu. Faktura z TEST albo DEMO nie jest fakturą w rozumieniu ustawy o VAT. Nie trafia do rozliczenia, nie widzi jej kontrahent, nie liczy się do JPK.
Nie potwierdza uprawnień na produkcji. Uprawnienia są nadawane per środowisko. To, że biuro rachunkowe widzi Twoje faktury na TEST, nie znaczy, że zobaczy je na PROD.
Nie zabezpiecza terminu. Wysyłka testowa nie zatrzymuje żadnego biegu terminu i nie zastępuje obowiązku wystawienia.

Numer KSeF i UPO z TEST są prawdziwe technicznie i bezużyteczne podatkowo. Wyglądają dokładnie tak samo jak na produkcji i to właśnie myli.

Najczęstsze pomyłki

Stary adres 1.0. Wpisujesz ksef-test.mf.gov.pl, dostajesz błąd i wnioskujesz, że KSeF nie działa. Działa, tylko pod innym adresem.

Token z TEST wysłany na produkcyjne API. Każde środowisko ma własny rejestr uprawnień, więc token uwierzytelnia się tylko tam, gdzie powstał. Objaw jest mylący: to nie wygląda na „zły adres”, tylko na „zły token”. Sprawdź najpierw, czy host i token pochodzą z tego samego środowiska.

Założenie, że dane przejdą. Nic z TEST nie migruje na produkcję. Ani faktury, ani numery, ani uprawnienia. Na produkcji nadajesz uprawnienia od nowa i generujesz nowy token.

Testowanie na produkcji, bo „to tylko jedna faktura”. Nie ma piaskownicy produkcyjnej. Każdy dokument złożony na PROD jest prawdziwy, z pełnymi skutkami, a jedyne sprzątanie to korekta do zera.

Rozjazd między środowiskiem testowym Stripe a produkcją KSeF. Jeśli składasz faktury ze Stripe, trzymaj to w parach: tryb testowy Stripe z KSeF na TEST, tryb live Stripe z KSeF na PROD. Skrzyżowanie tych dwóch osi wysyła dane testowe do prawdziwego rejestru.

Brak pewności, gdzie właściwie jesteś. Sprawdź trzy rzeczy po kolei: adres w konfiguracji (api-test, api-demo czy api), środowisko, w którym wygenerowałeś token, oraz to, co pokazuje Twoje narzędzie do fakturowania. Jeśli któraś z tych odpowiedzi nie zgadza się z pozostałymi, tam jest błąd. W aplikacji podatnika ten sam test robisz przez adres w pasku przeglądarki: ap-test, ap-demo albo ap.

Jak to działa w KSeF Kit

Środowisko jest w KSeF Kit jawnym przełącznikiem konta, a nie ustawieniem w pliku. W kreatorze połączenia TEST jest zaznaczony domyślnie, bo przypadkowe PROD to koszmar, a wybór środowiska jest pierwszym krokiem, nie ostatnim. Dane logowania trzymamy osobno dla każdego środowiska, więc przełączanie TEST i PROD nigdy nie nadpisuje zapisanych tokenów.

Zanim cokolwiek zapiszesz, przycisk „Testuj połączenie” próbuje się uwierzytelnić w wybranym środowisku Twoją metodą i zwraca czyste „działa” albo „nie działa”. Po połączeniu z TEST albo DEMO trafiasz na krok zgłoszenia testowego: wybierasz kształt faktury zbliżony do Twoich (krajowa B2B 23%, klient z UE na odwrotnym obciążeniu, klient spoza UE na eksporcie usług albo po prostu Twoja ostatnia prawdziwa faktura), my składamy ją tą samą ścieżką co produkcyjną i pokazujemy numer KSeF oraz UPO. Możesz też od razu złożyć testową korektę, żeby zobaczyć, co się dzieje przy zwrocie.

Przejście na PROD wymaga osobnych danych logowania do produkcji i jawnego potwierdzenia, a kończy się na ekranie, który mówi wprost, co się właśnie zmieniło. Na produkcji sztucznych próbek nie składamy w ogóle: świeże konto na PROD widzi spokojny komunikat „działasz na żywo”, a pierwsza prawdziwa faktura ze Stripe składa się sama.

Zacznij od TEST, złóż jedno zgłoszenie testowe, zobacz numer i UPO, dopiero potem przełącz na produkcję. Cała droga faktury jest opisana w jak wystawić fakturę ustrukturyzowaną.