Wystawianie faktur

KSeF test i demo: środowisko testowe, przedprodukcyjne i produkcyjne

W skrócie

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
  1. Jakie są środowiska KSeF?
  2. Do czego służy KSeF test, a do czego demo?
  3. Czy faktury wystawione na środowisku testowym są ważne?
  4. Czy dane na środowisku testowym są usuwane?
  5. Jak zalogować się do KSeF test?
  6. Czy limity API na TEST są takie same jak na produkcji?
  7. Jak przetestować program do faktur? Checklista
  8. 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:

  1. Otwórz stronę ap-test.ksef.mf.gov.pl i wybierz kafel „Uwierzytelnij się w Krajowym Systemie e-Faktur”.
  2. Kliknij „Zaloguj uwierzytelnieniem testowym”.
  3. Wybierz rodzaj kontekstu – zwykle NIP – i wpisz fikcyjny numer firmy.
  4. 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

  1. Zacznij na TEST z losowym NIP i przygotuj podmiot przez /testdata albo logowanie testowe.
  2. Wyślij każdy rodzaj faktury, który wystawiasz: zwykłą, korygującą, zaliczkową, walutową, z Podmiot3.
  3. Sprawdź, czy program wysyła FA(3) – TEST przyjmuje też FA(2), produkcja już nie (schemat XSD FA(3)).
  4. Wywołaj błędy celowo: duplikat numeru, datę z przyszłości, brak uprawnień – i zobacz, jak program reaguje (kody błędów KSeF).
  5. Upewnij się, że program zapisuje numer KSeF i UPO przy każdej fakturze.
  6. Przetestuj odbiór: z drugiego testowego NIP pobierz faktury zakupowe tak, jak zrobi to twoja księgowość.
  7. Jeśli wystawiasz offline: certyfikat offline, oba kody QR, późniejsza wysyłka faktury i korekta techniczna.
  8. Przejdź na DEMO z prawdziwym logowaniem i limitami jak na produkcji.
  9. 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

  1. Podręcznik KSeF 2.0 cz. II (MF, 06.08.2026), pkt 3.1 i 3.2.1–3.2.3
  2. Pytania i odpowiedzi KSeF 2.0 (MF) – sekcja „Zagadnienia techniczne”, pyt. 6 i 7
  3. MF, „Aplikacja Podatnika KSeF 2.0 – wersja testowa” (03.11.2025, zmodyfikowana 16.01.2026)
  4. MF, „Aplikacja Podatnika KSeF 2.0 – wersja przedprodukcyjna (Demo)” (15.11.2025, zmodyfikowana 16.01.2026)
  5. MF, Instrukcja uwierzytelnienia w Aplikacji Podatnika KSeF 2.0 – wersja testowa (v1.0, listopad 2025), rozdz. 1–1.3
  6. 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.

Przeczytaj też