Faktury KSeFZapisz się

Poradnik KSeF

KSeF demo i wersja testowa: jak przetestować KSeF bez skutków prawnych

Zanim wyślesz pierwszą prawdziwą fakturę, możesz przećwiczyć KSeF w dwóch bezpłatnych środowiskach Ministerstwa Finansów: testowym i przedprodukcyjnym (demo). Faktury wystawione tam nie mają skutków prawnych ani podatkowych. Poniżej, czym się różnią, jak się do nich zalogować i jak testować bezpiecznie.

Aktualizacja: 4 min czytaniaStan prawny na 15 października 2026, na podstawie 5 źródeł Ministerstwa Finansów

W skrócie

  • Środowisko testowe (TE): dowolne, fikcyjne dane i logowanie testowe bez Profilu Zaufanego. Aplikacja Podatnika: ap-test.ksef.mf.gov.pl.
  • Środowisko przedprodukcyjne (demo): fikcyjne faktury, ale prawdziwe logowanie (np. przez login.gov.pl) i prawdziwe uprawnienia. Aplikacja Podatnika: ap-demo.ksef.mf.gov.pl.
  • Środowisko produkcyjne: ap.ksef.mf.gov.pl. Każda wysłana tu faktura jest dokumentem w obiegu prawnym.
  • Dane w wersjach testowej i demo są okresowo usuwane. Uprawnienia i certyfikaty z wersji produkcyjnej tam nie działają.

Trzy środowiska KSeF

KSeF demo i wersja testowa: testowe ap-test.ksef.mf.gov.pl z logowaniem testowym, demo ap-demo.ksef.mf.gov.pl z prawdziwym logowaniem, produkcja ap.ksef.mf.gov.pl
Trzy środowiska Aplikacji Podatnika KSeF 2.0. W testowym i demo faktury nie mają skutków prawnych.
Testowe (TE)Przedprodukcyjne (demo)Produkcyjne
Aplikacja Podatnikaap-test.ksef.mf.gov.plap-demo.ksef.mf.gov.plap.ksef.mf.gov.pl
API (dla programów)api-test.ksef.mf.gov.plapi-demo.ksef.mf.gov.plapi.ksef.mf.gov.pl
LogowanieUwierzytelnienie testowe z dowolnym NIP; Profil Zaufany niedostępnyPrawdziwe dane: login.gov.pl, podpis lub pieczęć kwalifikowanaPrawdziwe dane
Dane na fakturachFikcyjneFikcyjnePrawdziwe
Skutki prawne i podatkoweBrakBrakTak
Dla kogoNauka obsługi, testy integracji programówPróba „na sucho” na własnych uprawnieniach, końcowe testy integracjiCodzienna praca
Adresy według komunikatu MF „Zmiana adresów środowisk KSeF” (obowiązują od stycznia 2026 r.) i dokumentacji API KSeF 2.0.

Jak zalogować się do wersji testowej

Na środowisku testowym nie potrzebujesz Profilu Zaufanego ani podpisu. MF przygotowało tam logowanie testowe, w którym system sam podpisuje żądanie certyfikatem testowym. Kroki według instrukcji MF:

  1. Wejdź na ap-test.ksef.mf.gov.pl i wybierz „Uwierzytelnij się w Krajowym Systemie e-Faktur”.
  2. Wybierz „Zaloguj uwierzytelnieniem testowym”.
  3. Na ekranie „Wprowadź kontekst logowania” wybierz rodzaj identyfikatora (zwykle NIP) i wpisz NIP firmy, w imieniu której chcesz działać.
  4. W sekcji „Podpisz testowe żądanie autoryzacyjne” wybierz typ identyfikatora i wpisz NIP lub PESEL, którym ma być „podpisane” logowanie.
  5. Kliknij „Uwierzytelnij do aplikacji testowej”. Aplikacja otworzy się w wybranym kontekście.

Używaj losowych, fikcyjnych numerów NIP, nie swojego. Środowisko testowe jest otwarte dla wszystkich, a MF zaznacza w dokumentacji API, że dane w nim nie są odizolowane i mogą je widzieć inni użytkownicy.

Jak zalogować się do wersji demo

Wersja przedprodukcyjna (demo) działa jak produkcja, tylko bez skutków prawnych. Logujesz się prawdziwymi danymi zgodnymi z rejestrem informacji o właścicielach firm: przez login.gov.pl, np. Profilem Zaufanym (na NIP firmy powiązanej z Twoim PESEL), podpisem kwalifikowanym albo pieczęcią. Logowania testowego tu nie ma.

  • Na fakturach wpisuj wyłącznie fikcyjne dane kontrahentów i kwoty.
  • Uprawnienia i certyfikaty nadane w produkcji nie są dostępne w demo, i odwrotnie. To, co zrobisz w demo, nie zmienia niczego w Twoim prawdziwym KSeF.
  • Wystawienie faktury w demo nie ma skutków podatkowych.

Demo przydaje się szczególnie spółkom: osoba wskazana w ZAW-FA może przećwiczyć nadawanie uprawnień i generowanie tokena lub certyfikatu KSeF, zanim zrobi to na produkcji.

Co można przetestować

Według MF wersje testowa i demo Aplikacji Podatnika KSeF 2.0 pozwalają m.in.:

  • wystawiać, odbierać i przeglądać faktury oraz korekty w strukturze FA(3),
  • wyszukiwać i pobierać faktury jako XML, HTML lub PDF,
  • pobierać UPO dla jednej lub wielu faktur i przeglądać historię sesji,
  • sprawdzać kody QR i dostęp do faktury przez kod oraz dostęp anonimowy,
  • zarządzać uprawnieniami, generować tokeny i wnioskować o certyfikaty KSeF,
  • obsługiwać faktury wystawione offline i faktury PEF.

Dobry scenariusz na pierwszą próbę: wystaw fakturę z jednego fikcyjnego NIP na drugi, zaloguj się w kontekście nabywcy i pobierz ją, sprawdź jej wizualizację z kodem QR, a na koniec wystaw do niej korektę.

Na co uważać

  • Nie wysyłaj na testowe ani demo prawdziwych faktur. Prawdziwa faktura trafia do obiegu prawnego tylko w produkcji.
  • Nie wpisuj na środowisku testowym prawdziwych danych firm i osób. To środowisko jest współdzielone.
  • Dane w wersjach testowej i demo są okresowo usuwane. Nie traktuj ich jak archiwum.
  • Od 1 października 2025 r. MF może prowadzić na środowiskach testowych codzienne prace serwisowe między 16:00 a 18:00. Utrudnienia w tych godzinach nie oznaczają awarii produkcji.
  • Wersje testowe mogą różnić się od produkcji. Zmiany wpływające na integrację MF publikuje w changelogu API.

Problemy na produkcji opisujemy osobno, w poradniku KSeF nie działa.

Pytania i odpowiedzi

Czy jest wersja demo KSeF?

Tak. MF udostępnia bezpłatnie dwa środowiska do ćwiczeń: testowe (ap-test.ksef.mf.gov.pl) z fikcyjnym logowaniem i przedprodukcyjne demo (ap-demo.ksef.mf.gov.pl) z prawdziwym logowaniem i fikcyjnymi fakturami.

Czym różni się KSeF test od KSeF demo?

Na testowym logujesz się fikcyjnymi danymi, bez Profilu Zaufanego. W demo logujesz się prawdziwymi danymi i działasz na swoich uprawnieniach. W obu na fakturach używa się fikcyjnych danych.

Czy faktura wystawiona w KSeF demo jest ważna?

Nie. Faktury w wersjach testowej i demo nie mają skutków prawnych ani podatkowych i są okresowo usuwane.

Dlaczego nie mogę zalogować się do wersji testowej Profilem Zaufanym?

Na środowisku testowym logowanie Profilem Zaufanym nie jest dostępne. Użyj logowania testowego albo przejdź do wersji demo.

Czy uprawnienia nadane w demo działają w prawdziwym KSeF?

Nie. Uprawnienia i certyfikaty w demo są niezależne od produkcji.

Źródła

Fakty w tym poradniku sprawdziliśmy 15 października 2026 w oficjalnych materiałach Ministerstwa Finansów. Przepisy o KSeF się zmieniają, więc przed decyzją sprawdź aktualną wersję źródła.

  1. Aplikacja Podatnika KSeF 2.0 – wersja testowaksef.podatki.gov.pl, zmodyfikowano 16.01.2026
  2. Aplikacja Podatnika KSeF 2.0 – wersja przedprodukcyjna (Demo)ksef.podatki.gov.pl, zmodyfikowano 16.01.2026
  3. Zmiana adresów środowisk KSeF – komunikat dla integratorówksef.podatki.gov.pl, 11.12.2025
  4. Środowiska KSeF API 2.0Ministerstwo Finansów, repozytorium CIRFMF/ksef-docs, 16.03.2026
  5. Instrukcja uwierzytelnienia w Aplikacji Podatnika KSeF 2.0Ministerstwo Finansów, PDF

Poradnik ma charakter informacyjny i nie jest poradą podatkową. Opracowanie: Ship AI Solutions LLC, wydawca aplikacji Faktury KSeF.