Faktura testowa w KSeF: wyślij ją przed startem

Wyślesz fakturę z fikcyjnymi danymi do środowiska testowego KSeF i odbierzesz UPO, czyli Urzędowe Poświadczenie Odbioru. Potem sprawdzisz po stronie nabywcy, że faktura dotarła. Całość zajmuje około 15 minut.

Zanim zaczniesz

Potrzebujesz:

Programu do fakturowania z integracją KSeF 2.0 albo bezpłatnej Aplikacji Podatnika od Ministerstwa Finansów (działa w przeglądarce, nie wymaga instalacji).
Profilu Zaufanego, e-Dowodu lub certyfikatu kwalifikowanego do zalogowania się w KSeF. Profil Zaufany to najprostsza opcja, a jeśli go nie masz, załóż go przez bankowość elektroniczną.
NIP-u swojej firmy. Logujesz się na swój prawdziwy NIP, nawet w środowisku testowym.

Krok 1: Zaloguj się do środowiska testowego KSeF

Wejdź na ap-test.ksef.mf.gov.pl, oficjalne środowisko testowe KSeF 2.0.

Kliknij „Zaloguj się”.
Wybierz metodę uwierzytelnienia: Profil Zaufany, e-Dowód lub certyfikat kwalifikowany.
Podaj NIP swojej firmy.
Po zalogowaniu zobaczysz panel z dwiema zakładkami: skrzynka wychodząca (faktury, które wysłałeś) i skrzynka odbiorcza (faktury wysłane do Ciebie).

Jeśli logujesz się po raz pierwszy, obie skrzynki będą puste. To normalne.

Dane w środowisku testowym nie mają mocy prawnej i nic z nich nie trafia do urzędu skarbowego. Upewnij się tylko, że logujesz się do testowego (ap-test.ksef.mf.gov.pl), a nie produkcyjnego: faktury wysłane do produkcyjnego mają skutki prawne.

Krok 2: Wystaw fakturę testową

Otwórz swój program do fakturowania (lub Aplikację Podatnika) i utwórz nową fakturę. Nie musi być prawdziwa.

Wpisz fikcyjne dane: dowolna nazwa usługi, kwota, data.
Jako NIP nabywcy wpisz NIP znajomego przedsiębiorcy, który też chce przetestować KSeF. W kroku 5 sprawdzicie, czy faktura dotarła na jego konto. Jeśli testujesz solo, wpisz dowolny poprawny NIP (np. NIP Ministerstwa Finansów: 5260250274).
Dodaj jedną pozycję: wystarczy „Usługa testowa”, 100 zł netto, stawka 23%.
Sprawdź, czy program jest połączony ze środowiskiem testowym. Większość programów pozwala przełączyć się między środowiskiem produkcyjnym a testowym w ustawieniach integracji KSeF.
Kliknij „Wyślij do KSeF” (lub odpowiednik w Twoim programie).

Program wygeneruje plik XML i prześle go do środowiska testowego. Ty nie musisz dotykać tego pliku.

W Aplikacji Podatnika MF tworzysz fakturę bezpośrednio w formularzu, w sekcji „Wystaw fakturę” po zalogowaniu. Nie potrzebujesz żadnego zewnętrznego oprogramowania.

Krok 3: Odczytaj UPO

Po wysłaniu faktury KSeF zwraca UPO, oficjalny dowód, że system przyjął Twoją fakturę. Bez UPO nie masz tego potwierdzenia. Jeśli zamiast niego widzisz komunikat o błędzie, faktura została odrzucona: sprawdź status i przejdź do sekcji „Co zrobić jeśli wysyłka się nie powiodła”.

UPO zawiera:

Numer KSeF, unikalny identyfikator Twojej faktury w systemie.
Datę i godzinę przyjęcia. Od tego momentu faktura formalnie istnieje w KSeF.
Skrót pliku i podpis cyfrowy systemu, czyli potwierdzenie, że dokument nie został zmieniony po drodze.

Znajdź UPO w swoim programie. Zwykle pojawia się obok faktury jako status „Wysłano” lub „Przyjęto przez KSeF”, z możliwością pobrania szczegółów.

Podręcznik KSeF 2.0 cz. II — Wystawianie i otrzymywanie faktur (MF)

Krok 4: Sprawdź numer KSeF

Każda faktura przyjęta przez KSeF otrzymuje 35-znakowy numer KSeF, czyli długi ciąg cyfr i liter, zupełnie inny niż Twój numer faktury (np. FV/001/04/2026).

Sprawdź, czy jest widoczny:

W programie: powinien pojawić się przy fakturze, obok lub pod numerem dokumentu.
Na wydruku / PDF: jeśli generujesz wizualizację faktury, numer KSeF powinien się na niej pojawić jako „Numer KSeF” lub „Numer identyfikujący fakturę w KSeF”.

Numer KSeF to identyfikator w systemie rządowym, a numer faktury to Twoja wewnętrzna numeracja. Oba są wymagane, ale pełnią różne role.

Krok 5: Potwierdź odbiór po stronie nabywcy

Zobaczysz, jak faktura wygląda z perspektywy Twojego klienta. KSeF dostarcza ją bezpośrednio na konto powiązane z NIP-em nabywcy, więc nie trzeba jej wysyłać mailem. Obie strony mają do niej dostęp w systemie.

Jeśli w kroku 2 użyłeś NIP-u znajomego przedsiębiorcy:

Poproś go, żeby zalogował się do środowiska testowego na ap-test.ksef.mf.gov.pl, na swój NIP.
Niech otworzy skrzynkę odbiorczą.
Twoja testowa faktura powinna tam być, z numerem KSeF, kwotami i Twoim NIP-em jako wystawcy.

Testujesz solo i nie masz drugiego NIP-u? UPO z kroku 3 wystarcza jako dowód, że KSeF przyjął fakturę. Odbiór po stronie nabywcy możesz zweryfikować przy okazji, np. z księgowym, który obsługuje Twojego klienta.

Co zrobić jeśli wysyłka się nie powiodła

Trzy najczęstsze przyczyny:

1. Błędna autoryzacja lub wygasła sesja

Sesja w KSeF wygasa po określonym czasie. Jeśli program wyświetla błąd uwierzytelnienia:

Odśwież połączenie z KSeF w ustawieniach programu.
Zaloguj się ponownie.
Spróbuj wysłać fakturę jeszcze raz.

2. Błędny NIP nabywcy

KSeF sprawdza poprawność formatu NIP-u. Jeśli wpisałeś ciąg cyfr, który nie jest prawidłowym NIP-em:

Sprawdź NIP na biznes.gov.pl.
Popraw NIP w fakturze i wyślij ponownie.

3. Błąd w strukturze pliku

To rzadkość przy dobrym oprogramowaniu, bo program powinien generować poprawny plik automatycznie. Jeśli jednak widzisz surowy komunikat o błędzie:

Wklej plik na ksefuj.to. Zobaczysz czytelny opis każdego problemu, po polsku, a Twoje dane nie opuszczają przeglądarki.
Napraw wskazane błędy w programie i wyślij ponownie.

Pierwsza prawdziwa faktura

Przełącz program na środowisko produkcyjne KSeF, sprawdź NIP, nazwę i adres nabywcy, a resztę zrób tak jak w teście. Bez programu fakturującego wystawisz ją za darmo w Aplikacji Podatnika: pierwsza prawdziwa faktura krok po kroku. Kontekst obowiązku dla jednoosobowej działalności opisuje KSeF dla JDG, a tryby pracy, wyłączenia i terminy znajdziesz w FAQ.

FAQ MF — KSeF 2.0 Środowisko testowe KSeF 2.0