KSEF28 maja 2026 · aktualizacja 26 października 2026 · 4 min
Środowisko testowe KSeF: TEST, DEMO i produkcja. Jak przetestować integrację przed startem
KSeF ma trzy środowiska: TEST, DEMO i produkcję. Różnice w limitach, certyfikatach i danych oraz jak przetestować sklep, zanim zacznie wysyłać faktury.
Każda faktura wysłana do produkcyjnego KSeF ma skutki prawne, a raz wysłanej nie da się usunąć. Dlatego Ministerstwo Finansów udostępnia dwa środowiska do testów: TEST i DEMO. Wyglądają podobnie, ale służą do czego innego, a pomylenie ich z produkcją to jeden z najczęstszych błędów konfiguracji. Na środowisku TEST limity żądań są dziesięciokrotnie wyższe niż na produkcji, więc test, który tam przechodzi, wcale nie dowodzi, że sklep wytrzyma wyprzedaż.
Trzy środowiska KSeF 2.0
TEST, DEMO i produkcja
Do czego służy
Na co uważać
TEST (Release Candidate)
Pierwsze testy integracji, nowe wersje API
Dane współdzielone między integratorami, limity 10× wyższe
DEMO (przedprodukcyjne)
Końcowa walidacja w warunkach jak na produkcji
Limity takie jak na produkcji
PROD
Faktury z pełną mocą prawną
Każda wysłana faktura zostaje w systemie
Każde środowisko ma własny adres API i własny serwis weryfikacji kodów QR. Linki zwracane przez API zawsze wskazują na to środowisko, do którego wysłano żądanie. Kod QR wygenerowany na środowisku testowym nie zadziała w serwisie produkcyjnym, i odwrotnie.
Środowisko TEST: szybkie próby, wspólne dane
Na TEST można logować się certyfikatami samopodpisanymi. W praktyce wielu integratorów może uwierzytelnić się w kontekście tej samej firmy, więc dane nie są odizolowane. Dokumentacja wprost zaleca używanie losowych NIP-ów i żadnych danych rzeczywistych. TEST przyjmuje też starszą strukturę FA(2) i ma endpointy danych testowych, którymi włączysz np. zgodę na faktury z załącznikiem albo limity produkcyjne. Od października 2025 r. na środowiskach testowych mogą trwać prace serwisowe w godzinach 16:00–18:00.
Środowisko DEMO: generalna próba
DEMO ma konfigurację odpowiadającą produkcji: przyjmuje tylko FA(3) i ma limity replikowane z produkcji dla danego kontekstu. To właściwe miejsce na test obciążenia, np. symulację wysyłki faktur z całego dnia wyprzedaży. Jeśli na DEMO integracja dostaje błąd 429, na produkcji dostanie go na pewno.
Plan testów integracji sklepu z KSeF
1
TEST: scenariusze brzegowe
Korekty, faktury dla firm zagranicznych, duplikaty, odrzucenia z kodem 450.
2
DEMO: wolumen i limity
Wysyłka tylu faktur, ile sklep wystawia w najgorszy dzień, z obsługą Retry-After.
3
Produkcja: pierwsza faktura pod kontrolą
Start od jednej faktury, sprawdzenie numeru KSeF i PDF-u, dopiero potem automat.
Najczęstsze pomyłki ze środowiskami
Token z TEST użyty na produkcji: kończy się błędem uwierzytelnienia, opisanym w tekście o błędzie uwierzytelnienia.
Adres produkcyjny zostawiony w konfiguracji testowej: prawdziwe faktury testowe w KSeF, które trzeba korygować.
Kod QR z adresem środowiska testowego na fakturze produkcyjnej: klient nie zweryfikuje faktury. Więcej w tekście o kodzie QR na fakturze.
Pierwsze kroki na środowisku TEST
1.Wygeneruj certyfikat samopodpisany. Na TEST nie potrzebujesz podpisu kwalifikowanego ani Profilu Zaufanego.
2.Wybierz losowy NIP z poprawną sumą kontrolną, który nie należy do realnej firmy.
3.Zaloguj się, otwórz sesję interaktywną i wyślij jedną prostą fakturę FA(3).
4.Sprawdź status, numer KSeF i UPO, a potem wygeneruj kod QR z adresem środowiska testowego.
5.Dopiero wtedy przechodź do scenariuszy brzegowych: korekt, duplikatów, faktur dla firm zagranicznych, odrzuceń.
Pamiętaj, że dane na TEST są współdzielone. Faktura, którą wysłałeś wczoraj, mogła zostać „uzupełniona” przez innego integratora testującego ten sam NIP. Dlatego testy automatyczne nie powinny zakładać, że w danym kontekście są tylko Twoje faktury.
Lista kontrolna przed przełączeniem na produkcję
Adres API, adres serwisu kodów QR i klucze publiczne KSeF ustawione dla produkcji w jednym miejscu konfiguracji.
Token albo certyfikat produkcyjny wygenerowany przez osobę z właściwymi uprawnieniami.
Test obciążenia na DEMO z wolumenem z najgorszego dnia sprzedaży.
Kolejka faktur i obsługa trybu offline sprawdzona przy wyłączonym połączeniu.
Pierwsza faktura produkcyjna wysłana ręcznie pod kontrolą, z porównaniem PDF-u i pliku XML.
Środowisko DEMO dobrze nadaje się też na próbę generalną z udziałem księgowości, bo jego konfiguracja odpowiada produkcji. Księgowa może tam zobaczyć faktury testowe w takim układzie, w jakim zobaczy je po starcie, i zgłosić uwagi, zanim zmiana obejmie prawdziwych klientów.
Nie. Moc prawną mają tylko faktury z produkcji. Na TEST i DEMO nie wolno też wysyłać prawdziwych faktur ani danych kontrahentów.
›Czym różni się KSeF test od KSeF demo?
TEST służy do rozwoju i ma wyższe limity oraz współdzielone dane. DEMO odpowiada produkcji konfiguracją i limitami, więc nadaje się do końcowych testów.
›Czy aplikacja mobilna MF działa na środowisku testowym?