KSeF test: środowisko testowe i demo do ćwiczeń
Wybierz, co chcesz zrobić. Narzędzie wskaże właściwe środowisko, jego adres i to, czy wystawione tam faktury mają jakiekolwiek skutki.
Użyj środowiska
Środowisko testowe (TE)
Faktury bez skutków prawnych; dozwolone certyfikaty samopodpisane. Nie wpisuj prawdziwych danych.
| Adres API | https://api-test.ksef.mf.gov.pl |
| Kody QR | https://qr-test.ksef.mf.gov.pl |
| Prace serwisowe (test i demo) | od 16:00 do 18:00 |
Środowisko testowe KSeF 1.0 zamknięto 1 września 2025; API 2.0 w testach otwartych od 30 września 2025 (dokumentacja API KSeF 2.0, srodowiska.md).
Przygotowuje Radif Partners · Metoda · ustawa o VAT, rozporządzenia i komunikaty MF sprawdzone 25 października 2026
Ministerstwo Finansów udostępnia trzy środowiska KSeF 2.0. Środowisko testowe działa od 30 września 2025 i służy do nauki oraz podłączania programów: faktury nie mają skutków prawnych, można używać fikcyjnych danych i certyfikatów samopodpisanych, a dane bywają czyszczone. Środowisko przedprodukcyjne, nazywane demo, działa od 15 listopada 2025: wymaga prawdziwego uwierzytelnienia i uprawnień jak w produkcji, ale faktury też nie mają skutków podatkowych, więc pozwala sprawdzić gotowość firmy na jej rzeczywistych ustawieniach. Produkcja działa od 1 lutego 2026 i tylko tam faktura dostaje numer KSeF wiążący prawnie. Środowiska testowe mają codzienne przerwy serwisowe od 16:00 do 18:00. Każde środowisko ma własny adres API i własny serwer kodów QR, więc kod z faktury testowej prowadzi do qr-test.ksef.mf.gov.pl, a nie do serwera produkcyjnego. Stare środowisko testowe KSeF 1.0 zamknięto 1 września 2025.
Trzy środowiska obok siebie
| Test | Demo | Produkcja | |
|---|---|---|---|
| skutki prawne | brak | brak | tak |
| dane | fikcyjne | prawdziwe dane firmy | prawdziwe |
| uwierzytelnianie | także samopodpisane certyfikaty | jak w produkcji | pełne |
| adres API | api-test.ksef.mf.gov.pl | api-demo.ksef.mf.gov.pl | api.ksef.mf.gov.pl |
| kody QR | qr-test.ksef.mf.gov.pl | qr-demo.ksef.mf.gov.pl | qr.ksef.mf.gov.pl |
| przerwy | 16:00 do 18:00 | 16:00 do 18:00 | ogłaszane w BIP |
Adresy i zasady pochodzą z dokumentacji API KSeF 2.0. Zmianę środowisk z wersji 1,0 na 2,0 ministerstwo ogłosiło w komunikacie z 29 sierpnia 2025 r., a uruchomienie demo w komunikacie z 15 listopada 2025 r..
Plan ćwiczeń dla małej firmy
- W środowisku testowym wystaw fakturę z fikcyjnym nabywcą i pobierz ją jako XML.
- Otwórz plik w czytniku FA(3) i sprawdź sumy.
- Policz skrót i zbuduj link w narzędziu do kodu QR; zobaczysz, że prowadzi do serwera testowego.
- W demo zaloguj się prawdziwie i nadaj próbne uprawnienie biuru rachunkowemu, opisane w tokenach i uprawnieniach.
Zanim zaczniesz, sprawdź, czy Twój przypadek to jeszcze ćwiczenie, czy już prawdziwa faktura:
Użyj środowiska
Użyj środowiska
Środowisko przedprodukcyjne (Demo)
| Adres API | https://api-demo.ksef.mf.gov.pl |
| Kody QR | https://qr-demo.ksef.mf.gov.pl |
| Prace serwisowe (test i demo) | od 16:00 do 18:00 |
Ogólny opis systemu znajdziesz na stronie ministerstwa, a różnice między wersjami w KSeF 2.0.
Czego środowisko testowe nie sprawdzi
Test pokazuje, czy plik jest poprawny i czy program umie go wysłać, ale nie powie, czy faktura jest właściwa podatkowo. Wystawienie faktury testowej ze złą stawką skończy się sukcesem, bo system nie ocenia treści. Środowisko testowe nie zastąpi też sprawdzenia uprawnień: tam możesz nadać sobie dowolne role, a w produkcji uprawnienia muszą wynikać z prawdziwego logowania właściciela lub osoby wskazanej w zawiadomieniu.
Pamiętaj o przerwach serwisowych. Codziennie po południu środowiska testowe bywają niedostępne, więc automatyczne testy programu warto planować na inną porę. Dane w teście mogą zostać usunięte bez uprzedzenia, dlatego nie traktuj go jak archiwum. Gdy wszystko działa, przejście do produkcji polega na zmianie adresu i danych logowania, a nie na przebudowie pliku faktury.
Ćwiczenie w środowisku testowym warto spokojnie powtórzyć po każdej większej zmianie w firmie: nowej wersji programu, nowym biurze rachunkowym czy pierwszej fakturze w trybie offline. Kilka minut w środowisku bez skutków prawnych oszczędza żmudnego poprawiania prawdziwych faktur wystawionych dla klientów, których po nadaniu numeru KSeF nie da się już usunąć z systemu.