KSeF test i demo: środowisko testowe, przedprodukcyjne i produkcyjne
KSeF działa w trzech środowiskach: testowym (TEST), przedprodukcyjnym (DEMO) i produkcyjnym (PROD). Na TEST i DEMO wystawisz próbne faktury bez skutków prawnych – na TEST z fikcyjnymi danymi i logowaniem testowym, na DEMO z prawdziwym logowaniem, ale nadal fikcyjnymi danymi na fakturach. Faktura przyjęta na produkcji jest prawdziwa, nawet jeśli miała być testem.
Spis treści
- Jakie są środowiska KSeF?
- Do czego służy KSeF test, a do czego demo?
- Czy faktury wystawione na środowisku testowym są ważne?
- Czy dane na środowisku testowym są usuwane?
- Jak zalogować się do KSeF test?
- Czy limity API na TEST są takie same jak na produkcji?
- Jak przetestować program do faktur? Checklista
- Faktura testowa wysłana na produkcję – co teraz?
KSeF test to publiczne środowisko testowe Krajowego Systemu e-Faktur, w którym ćwiczysz wystawianie faktur bez skutków prawnych – w testowej Aplikacji Podatnika (ap-test.ksef.mf.gov.pl) albo przez testowe API. Obok działa wersja demo (przedprodukcyjna) z prawdziwym logowaniem. Prawdziwe faktury powstają wyłącznie na produkcji.
Z wersji testowej korzystają dwie grupy: przedsiębiorcy, którzy chcą przed pierwszą fakturą zobaczyć, jak działa Aplikacja Podatnika, oraz firmy sprawdzające program połączony z API. Dla obu obowiązuje ta sama zasada: na środowiskach testowych używasz zmyślonych danych (Podręcznik KSeF 2.0 cz. II, pkt 3.2).
Jakie są środowiska KSeF?
Każde środowisko ma własne adresy. Specyfikację API znajdziesz pod adresem serwera z dopiskiem /docs/v2.
| Środowisko | Aplikacja Podatnika | Serwer API | Weryfikacja kodu QR |
|---|---|---|---|
| TEST | ap-test.ksef.mf.gov.pl | api-test.ksef.mf.gov.pl | qr-test.ksef.mf.gov.pl |
| DEMO | ap-demo.ksef.mf.gov.pl | api-demo.ksef.mf.gov.pl | qr-demo.ksef.mf.gov.pl |
| PROD | ap.ksef.mf.gov.pl | api.ksef.mf.gov.pl | qr.ksef.mf.gov.pl |
Najważniejsze różnice w zasadach:
| TEST (testowe) | DEMO (przedprodukcyjne) | PROD (produkcyjne) | |
|---|---|---|---|
| Logowanie | testowe, dowolny NIP, certyfikat samopodpisany | prawdziwe dane i uprawnienia | prawdziwe dane i uprawnienia |
| Dane na fakturach | fikcyjne, zanonimizowane | fikcyjne | prawdziwe |
| Skutki prawne | brak | brak | pełnoprawne faktury |
| Przyjmowane struktury | FA(2), FA(3), PEF | FA(3), PEF | FA(3), PEF |
| Dostępne od | API 30.09.2025, aplikacja 3.11.2025 | API październik 2025, aplikacja 15.11.2025 | 1.02.2026 |
Struktury podajemy za zestawieniem środowisk MF z 16 marca 2026 r. Nowe wersje API trafiają najpierw na TEST, potem na DEMO i na końcu na produkcję. Na przykład wersja 2.10.0 z nowymi tokenami działa od 16 listopada 2026 r. tylko na środowisku testowym (changelog API). Adresy zwracane przez API, np. do pobrania paczki faktur, zawsze wskazują środowisko, z którym się łączysz.
Do czego służy KSeF test, a do czego demo?
Środowisko testowe służy do sprawdzania funkcji API i do nauki. Testowa Aplikacja Podatnika pozwala na to samo co produkcyjna, m.in. na wystawianie, odbieranie i przeglądanie faktur FA(3) oraz korekt, pobieranie plików XML, HTML i PDF, UPO, kody QR, tokeny, uprawnienia i certyfikaty KSeF. MF zaprasza do testowania jej bez ograniczeń. TEST jest otwarty dla wszystkich i pozwala zalogować się w kontekście dowolnego NIP. Dlatego dane w nim nie są odizolowane – inni testujący mogą pracować na tym samym NIP i widzieć twoje dokumenty (dokumentacja API MF, zestawienie środowisk).
Demo odwzorowuje konfigurację produkcji i służy do ostatniej próby przed startem. Logujesz się tak jak na produkcji, np. Profilem Zaufanym albo podpisem kwalifikowanym, i potrzebujesz faktycznych uprawnień do NIP. Dlatego MF pisze, że testowanie na demo nie jest dostępne publicznie – wejdziesz tylko na NIP, do którego masz realne prawa (cz. II, pkt 3.2.2). Dane na fakturach nadal mają być fikcyjne. Na demo dobrze jest przećwiczyć z kontrahentem wymianę faktur – oboje logujecie się swoimi danymi – to nasza propozycja.
Uprawnienia i certyfikaty na demo żyją osobno. Według strony MF te nadane w MCU nie są tam dostępne, a operacje na demo nie zmieniają niczego na produkcji. Strona nie mówi wprost o uprawnieniach nadanych w produkcyjnej Aplikacji Podatnika po 1 lutego 2026 r. – naszym zdaniem bezpieczniej założyć, że na demo nadajesz je od nowa. e-mikrofirma nie ma ani wersji testowej, ani demo – MF udostępnia tylko jej wersję produkcyjną.
Czy faktury wystawione na środowisku testowym są ważne?
Nie. Dokumenty z TEST i DEMO nie są fakturami ani dokumentami księgowymi i nie wywołują skutków prawnych (cz. II, pkt 3.2.1–3.2.2; FAQ KSeF 2.0, „Zagadnienia techniczne”, pyt. 6 i 7). Testowy dokument rozpoznasz po dwóch rzeczach:
- w UPO, w polu z nazwą podmiotu przyjmującego, po słowach „Ministerstwo Finansów” jest dopisek „środowisko testowe (TE)” albo „środowisko przedprodukcyjne (TR)”,
- kod QR prowadzi do qr-test albo qr-demo, więc na produkcyjnej stronie weryfikacji takiej faktury nie znajdziesz (kod QR w KSeF).
Brak skutków prawnych nie oznacza prywatności. MF ostrzega, że nawet przy losowo wygenerowanym NIP podmiot o tym numerze może mieć dostęp do danych z faktury (FAQ, „Zagadnienia techniczne”, pyt. 6). Nie łącz prawdziwych NIP lub PESEL z prawdziwymi nazwami, imionami i nazwiskami (cz. II, pkt 3.2.1).
Czy dane na środowisku testowym są usuwane?
Tak. Strony MF o wersji testowej i demo Aplikacji Podatnika zapowiadają, że dane będą okresowo usuwane, ale nie podają harmonogramu. Od 1 października 2025 r. na środowiskach testowych mogą też trwać cykliczne prace serwisowe w godz. 16:00–18:00. Nie traktuj więc TEST jak archiwum: pliki XML i wyniki testów trzymaj u siebie.
Jak zalogować się do KSeF test?
W testowej Aplikacji Podatnika:
- Otwórz stronę ap-test.ksef.mf.gov.pl i wybierz kafel „Uwierzytelnij się w Krajowym Systemie e-Faktur”.
- Kliknij „Zaloguj uwierzytelnieniem testowym”.
- Wybierz rodzaj kontekstu – zwykle NIP – i wpisz fikcyjny numer firmy.
- Wskaż, czy certyfikat ma zawierać NIP czy PESEL, wpisz ten identyfikator i kliknij „Uwierzytelnij do aplikacji testowej”.
Podpis certyfikatem testowym system składa za ciebie, po stronie serwera. Logowanie z identyfikatorem innym niż NIP kontekstu (PESEL albo inny NIP) wymaga wcześniej nadanych uprawnień. Według instrukcji MF z listopada 2025 r. Profil Zaufany na TEST nie działa – tylko na demo i produkcji. Podpis kwalifikowany zadziała, ale MF odradza używanie na TEST podpisów i pieczęci z prawdziwymi danymi.
W API zalogujesz się na TEST certyfikatem samopodpisanym – na innych środowiskach jest to niedopuszczalne. MF udostępnia przykładową aplikację KSeF.Client.Tests.CertTestApp w bibliotece ksef-client-csharp, która generuje taki certyfikat i pobiera tokeny dostępowe. Dane testowe przygotujesz endpointami z grupy /testdata: /testdata/person tworzy np. JDG z uprawnieniami właścicielskimi, /testdata/subject – grupę VAT lub JST, /testdata/permissions nadaje uprawnienia, a /testdata/attachment włącza wysyłkę faktur z załącznikami. Walidację numerów NIP na fakturach włączysz na TEST nagłówkiem X-KSeF-Feature: subject-identifier-validation.
Czy limity API na TEST są takie same jak na produkcji?
Na DEMO tak – limity są kopiowane z produkcji. Co do TEST dokumentacja MF się rozjeżdża: strona „Limity żądań API” mówi o wartościach dziesięciokrotnie wyższych niż na produkcji, a changelog wersji 2.5.0 (maj 2026 r.) – o zrównaniu ich z produkcyjnymi. Aktualne wartości zwróci GET /rate-limits, a POST /testdata/rate-limits/production włącza na TEST limity produkcyjne. Szczegóły: limity KSeF.
Jak przetestować program do faktur? Checklista
- Zacznij na TEST z losowym NIP i przygotuj podmiot przez
/testdataalbo logowanie testowe. - Wyślij każdy rodzaj faktury, który wystawiasz: zwykłą, korygującą, zaliczkową, walutową, z
Podmiot3. - Sprawdź, czy program wysyła FA(3) – TEST przyjmuje też FA(2), produkcja już nie (schemat XSD FA(3)).
- Wywołaj błędy celowo: duplikat numeru, datę z przyszłości, brak uprawnień – i zobacz, jak program reaguje (kody błędów KSeF).
- Upewnij się, że program zapisuje numer KSeF i UPO przy każdej fakturze.
- Przetestuj odbiór: z drugiego testowego NIP pobierz faktury zakupowe tak, jak zrobi to twoja księgowość.
- Jeśli wystawiasz offline: certyfikat offline, oba kody QR, późniejsza wysyłka faktury i korekta techniczna.
- Przejdź na DEMO z prawdziwym logowaniem i limitami jak na produkcji.
- Przed startem zmień adresy na produkcyjne (API i kody QR), a token lub certyfikat KSeF uzyskaj na produkcji.
Faktura testowa wysłana na produkcję – co teraz?
Jeśli produkcyjny KSeF odrzucił plik, nic się nie stało – faktura nie powstała. Jeśli nadał numer KSeF, wystawiłeś pełnoprawną fakturę, choć nie dokumentuje żadnej sprzedaży.
Najbardziej ryzykowny jest moment przełączenia programu z testów na produkcję: w ustawieniach może zostać testowy NIP nabywcy albo zaplanowana wysyłka próbnych faktur. Dlatego po przełączeniu wyczyść dane testowe, pierwszą prawdziwą fakturę wyślij pojedynczo i sprawdź ją w produkcyjnej Aplikacji Podatnika. Jak przebiega zwykłe wystawianie, opisujemy w tekstach jak wystawić fakturę w KSeF i Aplikacja Podatnika KSeF.
Najczęstsze pytania
Czy faktury wystawione w KSeF test są ważne?
Nie. Dokumenty wystawione na środowisku testowym i przedprodukcyjnym (demo) nie są fakturami i nie wywołują skutków prawnych. Pełnoprawne faktury powstają tylko na produkcji.
Jak zalogować się do testowej wersji KSeF?
Otwórz ap-test.ksef.mf.gov.pl i wybierz „Zaloguj uwierzytelnieniem testowym”. Wpisujesz fikcyjny NIP, a system sam podpisuje żądanie certyfikatem testowym. Według instrukcji MF z listopada 2025 r. Profil Zaufany działa tylko na demo i produkcji.
Czym różni się KSeF demo od wersji testowej?
Do demo logujesz się prawdziwymi danymi i potrzebujesz faktycznych uprawnień do NIP, a limity API są takie jak na produkcji. Na wersji testowej wszystko jest fikcyjne, także logowanie. W obu dane na fakturach mają być zmyślone.
Czy na środowisku testowym mogę wpisać prawdziwe dane firmy?
Nie. Środowisko testowe jest publiczne, a dane w nim nie są odizolowane. MF zakazuje łączenia prawdziwych NIP lub PESEL z prawdziwymi nazwami i nazwiskami. Nawet przy losowym NIP podmiot o tym numerze może zobaczyć treść faktury.
Co zrobić, gdy testowa faktura trafiła na produkcję?
Jeśli KSeF nadał jej numer, jest to pełnoprawna faktura i może z niej wyniknąć obowiązek zapłaty VAT. MF każe niezwłocznie wystawić do niej korektę do zera.
Źródła
- Podręcznik KSeF 2.0 cz. II (MF, 06.08.2026), pkt 3.1 i 3.2.1–3.2.3
- Pytania i odpowiedzi KSeF 2.0 (MF) – sekcja „Zagadnienia techniczne”, pyt. 6 i 7
- MF, „Aplikacja Podatnika KSeF 2.0 – wersja testowa” (03.11.2025, zmodyfikowana 16.01.2026)
- MF, „Aplikacja Podatnika KSeF 2.0 – wersja przedprodukcyjna (Demo)” (15.11.2025, zmodyfikowana 16.01.2026)
- MF, Instrukcja uwierzytelnienia w Aplikacji Podatnika KSeF 2.0 – wersja testowa (v1.0, listopad 2025), rozdz. 1–1.3
- Dokumentacja API KSeF 2.0 (MF, CIRFMF/ksef-api): srodowiska.md (16.03.2026), dane-testowe-scenariusze.md, limity/limity-api.md, kody-qr.md, api-changelog.md (wersje 2.0.0 RC6.0, 2.5.0, 2.8.0, 2.10.0)
Artykuł ma charakter informacyjny i nie stanowi porady podatkowej. W konkretnej sprawie skonsultuj się z księgowym lub doradcą podatkowym.