KSeF testowy i demo: jak bezpiecznie przetestować faktury sklepu
W skrócie: KSeF testowy to bezpłatne środowisko MF, w którym wystawiasz faktury bez skutków prawnych. Są dwa środowiska do prób: testowe, gdzie logujesz się fikcyjnymi danymi na dowolny NIP, i przedprodukcyjne (Demo), gdzie logujesz się prawdziwymi danymi, ale nadal wystawiasz faktury z fikcyjną treścią. Certyfikaty i uprawnienia z produkcji tam nie działają, więc do testów generujesz osobne.
KSeF testowy, demo i produkcja: różnice
MF udostępnia trzy publiczne środowiska KSeF 2.0. Każde ma własną Aplikację Podatnika i własne API.
| Testowe (TE) | Przedprodukcyjne (Demo) | Produkcyjne | |
|---|---|---|---|
| Aplikacja Podatnika | ap-test.ksef.mf.gov.pl | ap-demo.ksef.mf.gov.pl | ap.ksef.mf.gov.pl |
| API | api-test.ksef.mf.gov.pl | api-demo.ksef.mf.gov.pl | api.ksef.mf.gov.pl |
| Logowanie | Fikcyjne dane, dowolny NIP („uwierzytelnienie testowe”) | Prawdziwe dane (np. Profil Zaufany), zgodne z rejestrami | Prawdziwe dane |
| Dane na fakturach | Wyłącznie fikcyjne | Wyłącznie fikcyjne | Prawdziwe |
| Skutki prawne | Brak | Brak | Faktura w obiegu prawnym |
| Limity zapytań API | Domyślnie 10 razy wyższe niż na produkcji | Takie jak na produkcji | Produkcyjne |
| Dane są usuwane | Okresowo | Okresowo | Nie, 10 lat archiwum |
Źródła: strony wersji testowej i przedprodukcyjnej Aplikacji Podatnika KSeF 2.0 oraz dokumentacja API KSeF 2.0 („Środowiska”, „Limity żądań API”). MF opisuje różnicę tak: w wersji testowej „możliwa jest symulacja poświadczeń”, czyli logowanie w kontekście dowolnego NIP, a w Demo poświadczenia działają tak jak na produkcji (FAQ MF, kategoria „Zagadnienia techniczne”, pyt. 7).
Na środowiskach testowych codziennie od 16:00 do 18:00 mogą trwać prace serwisowe, więc nie planuj testów na ten czas.
Które środowisko wybrać
- Testowe, jeśli chcesz zobaczyć, jak działa KSeF, przećwiczyć wystawianie i korekty albo sprawdzić integrację bez żadnych formalności. Nie potrzebujesz Profilu Zaufanego ani uprawnień.
- Demo, jeśli chcesz przejść całą drogę tak jak na produkcji: logowanie przez login.gov.pl (np. Profilem Zaufanym) w kontekście NIP firmy, wygenerowanie certyfikatu, nadanie uprawnień księgowej. To dobra próba generalna przed pierwszą prawdziwą fakturą.
Testowy NIP i logowanie
Na środowisku testowym wybierz w Aplikacji Podatnika „Zaloguj uwierzytelnieniem testowym”, wpisz kontekst, czyli NIP, w imieniu którego chcesz działać, i kliknij „Uwierzytelnij do aplikacji testowej”. Aplikacja sama podpisze żądanie testowym certyfikatem. Profil Zaufany na środowisku testowym nie działa (Instrukcja uwierzytelnienia w Aplikacji Podatnika KSeF 2.0, wersja testowa, rozdz. 1.1-1.2).
Jaki NIP wpisać? Fikcyjny. Trzy zasady:
- Nie używaj danych prawdziwej firmy, także swojej. MF przypomina, że w środowisku testowym nie należy używać rzeczywistych danych (FAQ MF, kategoria „Zagadnienia techniczne”, pyt. 6).
- Uważaj na losowe NIP. Jeśli losowy NIP należy do istniejącej firmy, ona potencjalnie ma dostęp do danych z takiej faktury (to samo pytanie 6). Wpisuj na fakturach fikcyjne nazwy, adresy i kwoty.
- Pamiętaj, że środowisko jest wspólne. Na TE wielu integratorów może zalogować się w kontekście tej samej firmy, więc dane nie są odizolowane (dokumentacja API KSeF 2.0, „Środowiska”).
Na środowisku Demo logujesz się prawdziwymi danymi, więc NIP jest Twój, ale treść faktur nadal ma być fikcyjna.
Testowy certyfikat i token
Certyfikaty i uprawnienia z produkcji nie działają na środowiskach testowych, i odwrotnie. MF pisze, że działania w wersji przedprodukcyjnej nie wpływają na uprawnienia i certyfikaty z produkcji, a te z produkcji nie są dostępne w Demo. Dlatego:
- Zaloguj się do Aplikacji Podatnika w wybranym środowisku (test albo Demo).
- Wygeneruj certyfikat KSeF tak jak na produkcji: „Wnioskuj o certyfikat”, nazwa, hasło, przeznaczenie „Uwierzytelnienie w systemie KSeF”, pobranie pliku. Dokładne kroki opisujemy w artykule jak wygenerować certyfikat KSeF.
- Albo wygeneruj token w menu „Generuj token”.
- Wgraj certyfikat lub token do programu ustawionego na to samo środowisko.
Najczęstszy błąd: certyfikat z Demo wgrany do programu, który łączy się z produkcją (albo na odwrót). Połączenie się nie uda, bo każde środowisko ma własne certyfikaty.
Co przetestować w sklepie
Przejdź scenariusze, które naprawdę zdarzają się w Twoim sklepie. Lista kontrolna:
- Zwykłe zamówienie z NIP, opłacone kartą: faktura trafia do KSeF, wraca numer KSeF, PDF ma kod QR z numerem.
- Kilka stawek VAT w jednym zamówieniu, na przykład 23% i 8%, plus koszt wysyłki.
- Rabat i kod promocyjny: czy kwoty na fakturze zgadzają się z zamówieniem co do grosza.
- Zamówienie w euro: kwoty w walucie, VAT w złotych, kurs i data kursu na fakturze.
- Zwrot części towaru: faktura korygująca z odwołaniem do numeru KSeF faktury pierwotnej.
- Pełny zwrot: korekta do zera.
- Błędny NIP: jak sklep reaguje, zanim faktura wyjdzie, i jak wygląda korekta do zera.
- Duplikat numeru faktury: KSeF odrzuca drugi plik z tym samym numerem u tego samego sprzedawcy.
- Zamówienie osoby prywatnej: czy sklep nie wystawia faktury w KSeF tam, gdzie nie powinien.
- Kod QR: zeskanuj go telefonem i sprawdź, czy otwiera fakturę w środowisku testowym (adresy qr-test.ksef.mf.gov.pl lub qr-demo.ksef.mf.gov.pl).
- Uprawnienia: na Demo nadaj księgowej uprawnienie do przeglądania faktur i sprawdź, czy je widzi.
Jeśli faktura zostanie odrzucona, przeczytaj kod błędu i popraw dane. Typowe przyczyny opisujemy w artykule o odrzuconej fakturze, a pełną listę przygotowań w checkliście KSeF dla sklepu.
Czego test nie pokaże
Test na środowisku testowym daje dużo, ale nie wszystko:
- Skutków prawnych i podatkowych. Faktura testowa nie jest fakturą. Nie sprawdzisz na niej, czy dobrze dobrałeś stawkę VAT albo kurs waluty. To nadal zadanie dla księgowej.
- Walidacji NIP. Sprawdzenie sumy kontrolnej NIP sprzedawcy i nabywcy działa tylko na produkcji (dokumentacja API KSeF 2.0, „Weryfikacja faktury”). Faktura z błędnym NIP może przejść test, a na produkcji zostać odrzucona.
- Wydajności. Na TE limity zapytań są domyślnie dziesięciokrotnie wyższe niż na produkcji. Duży sklep powinien sprawdzić wysyłkę na Demo, gdzie limity są takie jak na produkcji.
- Prawdziwego nabywcy. Klient nie zobaczy testowej faktury w swoim KSeF.
- Stałości danych. Dane w wersji testowej i Demo są okresowo usuwane, więc nie traktuj ich jak archiwum.
Przejście na produkcję
- Na produkcji (ap.ksef.mf.gov.pl) wygeneruj nowy certyfikat KSeF albo token. Testowe pliki usuń z programu.
- Przełącz program albo aplikację sklepu na środowisko produkcyjne.
- Usuń testowe ustawienia: fikcyjny NIP sprzedawcy, testowe serie numeracji.
- Wystaw pierwszą prawdziwą fakturę i sprawdź w Aplikacji Podatnika, że jest w KSeF z numerem.
- Pamiętaj, że od tej chwili każda faktura „wprowadzona jest do obiegu prawnego”, jak ostrzega MF. Pomyłkę naprawiasz już korektą.
Aplikację KSeF Faktury dla Shopify testujemy na środowisku testowym KSeF 2.0 MF. O tym, jak sklep łączy się z KSeF i gdzie test ma największy sens, piszemy w artykule o integracji sklepu z KSeF.
Pytania i odpowiedzi
Czy faktura wystawiona w KSeF testowym jest ważna?
Nie. Faktury w wersji testowej i przedprodukcyjnej nie wywołują skutków prawnych (FAQ MF, kategoria „Zagadnienia techniczne”, pyt. 6 i 7).
Czy KSeF testowy jest płatny?
Nie. Wersje testowa i przedprodukcyjna Aplikacji Podatnika są bezpłatne, tak jak produkcyjna.
Czy mogę zalogować się do KSeF testowego Profilem Zaufanym?
Nie. Na środowisku testowym logujesz się uwierzytelnieniem testowym. Profil Zaufany działa na Demo i produkcji.
Wygenerowałem certyfikat w Demo. Czy zadziała w prawdziwym KSeF?
Nie. Certyfikaty i uprawnienia z Demo działają tylko w Demo. Na produkcji generujesz nowe.
Źródła
- Aplikacja Podatnika KSeF 2.0: wersja testowa, MF
- Aplikacja Podatnika KSeF 2.0: wersja przedprodukcyjna (Demo), MF
- Instrukcja uwierzytelnienia w Aplikacji Podatnika KSeF 2.0, wersja testowa, MF, listopad 2025, rozdz. 1.1-1.2
- Pytania i odpowiedzi KSeF 2.0: kategoria „Zagadnienia techniczne”, pyt. 6 i 7
- Dokumentacja API KSeF 2.0, MF: „Środowiska”, „Limity żądań API”, „Weryfikacja faktury”, „Kody QR”
- Podręcznik KSeF 2.0, cz. I (06.08.2026), krok 7 „Testowanie KSeF 2.0”
- Aplikacja Podatnika KSeF 2.0, MF
Stan prawny na 19 października 2026 r.
Artykuł ma charakter ogólnej informacji i nie jest poradą podatkową.